Keyboard Shortcut
Triggerkeyboard
trigger.keyboard_shortcut
Fires when a keyboard shortcut is pressed. This trigger registers a global hotkey that works even when Watchflows is in the background, letting you launch workflows from anywhere on your Mac.
Use the built-in hotkey recorder to capture your desired key combination. The Consume Key option controls whether the shortcut is passed through to other applications or intercepted by Watchflows.
Ports
| Direction | Name | Data Type | Description |
|---|---|---|---|
| Outlet | Output | Any | Payload emitted when the keyboard shortcut is pressed |
Configuration
| Field | Type | Default | Description |
|---|---|---|---|
| Shortcut | Hotkey Recorder |
— | Click to record the keyboard shortcut to listen for |
| Consume Key | Boolean |
true | Whether to prevent the shortcut from reaching other applications |
| Custom Arguments | Key-Value |
— | Additional key-value pairs included in the output payload |
Output Variables
| Variable | Type | Description |
|---|---|---|
shortcut |
String | Shortcut string (e.g. cmd+shift+4) |
shortcutDisplay |
String | Human-readable key combo (e.g. ⌘⇧4) |
keyCode |
Number | Virtual key code number |
timestamp |
String | ISO 8601 timestamp |
Example
Press Cmd+Shift+B to run a build script: