Extension Icon

Folder Search

Search for folders on your Mac
AvatarGastro Geek
21,007 Installs
Overview

Folder Search

Search for folders on your Mac

Plugins

You can add your own custom AppleScript plugins to Folder Search. These appear as actions, under the sub-heading 'Plugins' within Folder Search.

The steps are as follows:

  • Configure the Folder Search extension via Raycast

    • Ensure the Plugins Enabled option is checked
    • Populate Plugins Folder (Absolute Path) with a valid absolute path to where you plugins reside
      • e.g: /Users/GastroGeek/Documents/FolderSearchPlugins
  • Create one or more plugins with the following schema (they are just .js files):

e.g. Plugin Path

/Users/GastroGeek/Documents/FolderSearchPlugins/open-alt.js

e.g. Plugin file contents (open-alt.js)

// note the export name!
exports.FolderSearchPlugin = {
  // the title of the action as shown
  // in the Actions Menu in Raycast.
  title: 'Open Alt',

  // the desired keyboard shortcut in the same
  // format as with Raycast's API but with only
  // single braces: `{` and `}`.
  shortcut: { modifiers: ["cmd", "shift"], key: 'a' },

  // the `Icon` name without the Icon enum prefix.
  icon: 'Link',

  // a function which takes the result that was selected at the time of execution and returns a valid AppleScript. This AppleScript is what gets executed.
  appleScript: (result) => {
    return `do shell script "open ${result.path}"`
  }
}

For reference, the result argument passed into the appleScript function is as follows (based on mdfind properties)

{
  path: '/Users/GastroGeek/Music',
  kMDItemDisplayName: 'Music',
  kMDItemFSCreationDate: '2016-04-22T20:42:52.000Z',
  kMDItemFSName: 'Music',
  kMDItemContentModificationDate: '2022-07-08T15:44:01.000Z',
  kMDItemKind: 'Folder',
  kMDItemLastUsedDate: '2022-09-14T10:09:45.000Z'
}

You will likely only need/use the path property.