Browse the docs

Installing extensions

Install Things, Home Assistant, OBS, Window and the other gallery extensions, set them up, and get the ones an imported macro needs.

Extensions add steps, triggers and conditions for other apps and services. You find and install them in the Gallery.

Install one #

  1. Choose Window > Extensions (⌘3), then Gallery (⌥⌘1).

  2. Click an extension to see what it adds and what it may touch.

  3. Click Install…. The sheet lists its permissions again. Click Install.

Its steps then show in the block chooser. Installed (⌥⌘2) lists what you have, with a switch to turn each one off, its log, and Remove.

Set it up #

Some extensions need a setting before they work:

  • Home Assistant: its address and a long-lived access token.

  • Linear and Jira: an API key or token, and Jira's site and email.

  • OBS Studio: the server password, only if OBS has authentication on.

  • Sonos: a default speaker address, or name the speaker in each step.

Open the extension in Installed and fill in its Settings box, or use Settings › Extensions. Secrets go to your Keychain. Things and Window need nothing here; Window asks for Accessibility the first time it moves a window. 1Password needs its command-line tool (brew install 1password-cli).

When a macro needs one you don't have #

  • Importing: when a macro you import (File > Import…, or a .switchboard file dragged onto the window) uses an extension you don't have, the review lists it under Needs an extension: what in the import uses it, what it needs set up, and Install…. After it installs, the row says so and offers Open Settings… when it has settings to fill in.

  • In the editor: a step from a missing extension is dimmed with "Install Things to run this" and an Install… link. The link opens the gallery on that extension with its install sheet.

  • Needs Attention: an enabled macro that needs a missing extension is listed there, with an Install… button on its row.

  • The block chooser: a block a macro uses from a missing extension is listed as not installed. Choosing it offers the install.

If the gallery can't be reached, the row says so and offers Retry. If an extension isn't in the gallery, the row says that too; ask whoever shared the macro where it comes from.

More #