# Keyboard Shortcut

Trigger `keyboard`

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: