Keyboard Maestro triggers
Keyboard Maestro triggers and their equivalents.
Every Keyboard Maestro trigger and what it becomes.
| Keyboard Maestro trigger | Switchboard | Notes |
|---|---|---|
| Hot Key | Nothing to run (see the note) or built from the action's settings | No key was set for the hot key trigger in Keyboard Maestro. Record the key. This trigger was left out; add one in Switchboard |
| Application | Application event | No application was chosen in Keyboard Maestro for this "while" trigger. Pick the application "While active" runs the macro when the application comes to the front; it isn't stopped when the application quits or goes to the back "While running" runs the macro when the application is running; it isn't stopped when the application quits or goes to the back |
| Time of Day | Nothing to run (see the note) or built from the action's settings | No time was set for the time trigger in Keyboard Maestro. Set the time. This trigger was left out; add one in Switchboard |
| Periodic | Nothing to run (see the note) or built from the action's settings | No repeat interval was set for the time trigger in Keyboard Maestro. Set the interval. This trigger was left out; add one in Switchboard |
| Login | Switchboard starts | |
| Engine Launch | Switchboard starts | |
| Cron | Nothing to run (see the note) or built from the action's settings | No schedule was set for the cron trigger in Keyboard Maestro. Enter the cron schedule. This trigger was left out; add one in Switchboard |
| Idle | Nothing to run (see the note) or built from the action's settings | No idle time was set for the trigger in Keyboard Maestro. Set the time. This trigger was left out; add one in Switchboard |
| Wake | Mac wakes | |
| Sleep | Mac sleeps | |
| Unlock | Screen unlocks | |
| Typed String | Typed text | |
| Status Menu | Nothing to run (see the note) or built from the action's settings | |
| Global Macro Palette | Nothing to run (see the note) or built from the action's settings | |
| Group Status Menu | Nothing to run (see the note) or built from the action's settings | |
| Subroutine | Nothing to run (see the note) or built from the action's settings | |
| Folder | Nothing to run (see the note) or built from the action's settings | No folder was chosen for the folder trigger in Keyboard Maestro. Pick the folder. This trigger was left out; add one in Switchboard |
| Focused Window | Window title change, Window moves or resizes | "Focused window changes" became a window title change: it fires when the front window's title differs from before |
| Clipboard Changed | Clipboard change | |
| Clipboard Filter | Nothing to run (see the note) or built from the action's settings | Clipboard Filter: Switchboard has no clipboard-history filter list. The macro takes the clip as its input "clip" (run it from the palette, the CLI or another macro) |
| Dragged File | Nothing to run (see the note) or built from the action's settings | Dragged File: Switchboard has no drop target for macros. The macro takes the file as its input "file" (run it from the palette, the CLI or another macro) |
| USB Device | Nothing to run (see the note) or built from the action's settings | No device was chosen for the USB trigger in Keyboard Maestro. Pick the device. This trigger was left out; add one in Switchboard |
| USB Device Key | USB device key | USB device key: Switchboard names a key by its HID usage (page:usage in hex, like 07:04 for A); check the key text |
| Wireless Network | Network change | No network name: the trigger fires when the network becomes reachable |
| MIDI | MIDI message | MIDI message "" is kept as written; Switchboard matches hex bytes like 90 3C |
| Gesture | Trackpad gesture | Gesture "" became a 3-finger swipe trackpad gesture; check it |
| Public Web | Webhook | No name was set for the web trigger in Keyboard Maestro. The route is the macro's name; set the trigger name Web trigger became a webhook at /hooks/docs on this Mac, taking GET and POST with a key; open the macro and use Copy URL for the address, and check the route |
| Remote | Webhook | Keyboard Maestro's Remote trigger goes through Stairways' cloud service, which stops working for this macro. It became a webhook at /hooks/docs on this Mac's network (port 48081, GET or POST, with a key; ?value= still arrives as {{triggerValue}}). Open the macro and use Copy URL for the new address to give your phone or service |
| Audio Output Changed | System event | |
| Display Layout Changed | System event | |
| Power Status Changed | System event | |
| Space Changed | System event | |
| Appearance Changed | System event | |
| Mounted Volume | System event | |
| Script (AppleScript / API invocation) | Nothing to run (see the note) or built from the action's settings | |
| URL / keyboardmaestro:// scheme | Webhook | No name was set for the web trigger in Keyboard Maestro. The route is the macro's name; set the trigger name Web trigger became a webhook at /hooks/docs on this Mac, taking GET and POST with a key; open the macro and use Copy URL for the address, and check the route |
| Web Server | Webhook | Web Server trigger became a webhook at /hooks/docs on this Mac (port 48080), taking GET and POST with a key instead of Keyboard Maestro's web server. Open the macro and use Copy URL for the address |
| Trigger File | File or folder change | Trigger File: the macro runs when a file named "docs" (any extension) is created in ~/Library/Application Support/Switchboard/Trigger Files |