A file finder for Zazu.
Switch branches/tags
Nothing to show
Clone or download
blainesch Merge pull request #35 from tinytacoteam/feature/i18n
Change osx app query to be non-language specific.
Latest commit b4b64bd Apr 25, 2017


Zazu File Finder

Travis Build Status AppVeyor Build Status

Find files and applications on your computer easily.


> find readme
> open readme

You can also find applications without a prefix by just typing in part of the name:

> chrome


Add tinytacoteam/zazu-file-finder inside of plugins block of your ~/.zazurc.json file.

  "plugins": [

If you want to overwrite the directories you can.

  • append if you want to keep the original, and just add additonal directories, set this to true
  • directories.filePath set this array for which paths you want FILES to be searched for via open * or find *
  • directories.appPath will be an array of places you wan to find your APPLICATIONS. For example chrome
  "plugins": [
      "name": "tinytacoteam/zazu-file-finder",
      "variables": {
        "append": true,
        "directories": {
          "filePath": [
          "appPath": [
          "excludeName": [
          "excludePath": [



WARNING: If you are on MacOS, you cannot test this plugin where Zazu installs it, since ~/.zazu as a hidden folder is ignored.

Run tests in current system environment:

npm run test

Run tests in Docker, which is helpful for running tests in Linux environment when using other platform such as macOS or Windows.

npm run docker-test