docs » Seal

List of directories where Seal will look for plugins. Defaults to ~/.hammerspoon/seal_plugins/ and the Seal Spoon directory.

Time between the last keystroke and the start of the recalculation of the choices to display, in seconds.

• Defaults to 0.02s (20ms).

Binds hotkeys for Seal

• mapping - A table containing hotkey modifier/key details for the following (optional) items:
  • show - This will cause Seal's UI to be shown
  • toggle - This will cause Seal's UI to be shown or hidden depending on its current state

• The Seal object

Loads a plugin from a given file

• plugin_name - the name of the plugin, without "seal_" at the beginning or ".lua" at the end
• file - the file where the plugin code is stored.

• The Seal object if the plugin was successfully loaded, nil otherwise

• You should normally use Seal:loadPlugins(). This method allows you to load plugins from non-standard locations and is mostly a development interface.
• Some plugins may immediately begin doing background work (e.g. Spotlight searches)

Loads a list of Seal plugins

• plugins - A list containing the names of plugins to load

• The Seal object

• The plugins live inside the Seal.spoon directory
• The plugin names in the list, should not have seal_ at the start, or .lua at the end
• Some plugins may immediately begin doing background work (e.g. Spotlight searches)

Refresh the list of commands provided by all the currently loaded plugins.

• None

• The Seal object

• Most Seal plugins expose a static list of commands (if any), which are registered at the time the plugin is loaded. This method is used for plugins which expose a dynamic or changing (e.g. depending on configuration) list of commands.

Refresh the list of commands provided by the given plugin.

• plugin_name - the name of the plugin. Should be the name as passed to loadPlugins() or loadPluginFromFile.

• The Seal object

• Most Seal plugins expose a static list of commands (if any), which are registered at the time the plugin is loaded. This method is used for plugins which expose a dynamic or changing (e.g. depending on configuration) list of commands.

Shows the Seal UI

• query - An optional string to pre-populate the query box with

• None

• This may be useful if you wish to show Seal in response to something other than its hotkey

Starts Seal

• None

• The Seal object

Stops Seal

• None

• The Seal object

• Some Seal plugins will continue performing background work even after this call (e.g. Spotlight searches)

Shows or hides the Seal UI

• query - An optional string to pre-populate the query box with

• None