Shortery FAQ

The list of shortcuts is empty.
Restart Shortery. If that does not work, please restart your Mac. As a last resort you can try restarting the shortcut events service: Open terminal and execute the following command killall "Shortcuts Events".
Shortery does not run my shortcut.
First check the last run date of the trigger. If the last run date matches your expected execution date, Shortery did run the trigger. If not, please double-check if the configured condition is correct.
Shortery says that it has run my shortcut, but nothing happens.

If Shortery indicates that it has executed your shortcut, you can be sure that it has been executed. There can be many reasons why your shortcut could not do what it was configured to do. Below are the most common reasons, why a shortcut can fail:

Access rights: Shortery calls the shortcuts from outside the shortcuts app. If your shortcut need specific access rights, be sure to configure them correctly before.

Locked Mac: If your Mac is locked, things are different. You may need to grant your shortcut administrator rights to run it. Alternatively, you can delay the execution of the shortcut until your Mac is unlocked again. Each trigger has a checkbox for this setting.

Apple Shortcuts Privacy Settings: Adjust basic privacy settings in Shortcuts on Mac

Apple Shortcuts Advanced Privacy Settings: Advanced Privacy and security settings in Shortcuts on Mac

How do I debug my shortcut?
The easiest (but limited way) is to add alerts in your shortcut to show relevant debug information: Use the Show Alert action in a shortcut on Mac. A more powerful way it to use the Logger App.
How do I properly set up focus triggers?
Setting up focus triggers can be a bit confusing, because the way Apple has designed the focus API for third party developers. However, with Shortery you can trigger shortcuts for all your focus modes (Note that you have to have at least macOS 14.0 installed to use the focus mode trigger):
  • Create a new focus mode trigger with the mode A Specific Focus is Active and assign a shortcut to it.
  • Create a new focus mode trigger with the mode Any Focus, Inactive and assign the same shortcut to it.
  • Open your System Settings > Focus
  • Select a focus > Focus Filters > Add Filter > Shortery
  • Select the first trigger you've created (The A Specific Focus is Active trigger).
  • Focus Name: Enter the name of the currently selected focus (i.e. Sleep).
  • Repeat for all your focus modes
When you now activate a focus or deactivate it, Shortery will pick it up and call your shortcut. The name of the focus is passed to the shortcut or focusOff, if no focus is active. Using the focus name as the input for your shortcut, you can distinguish between different modes in your shortcut.