Using VoiceFlow

Shortcuts

Configure the two global shortcuts that drive recording, and understand the rules VoiceFlow enforces on them.

Toggle default

` (backtick)

Hold default

Shift + Space

Max keys

5 per shortcut

Two shortcuts, two behaviors

Toggle shortcut

Press once to start recording, press again to stop. Debounced by 250 ms so a quick double-tap won't cancel itself.

Hold-to-talk shortcut

Records only while held. Releasing any key in the combo stops recording immediately.

Both are matched exactly: the pressed keys must equal the shortcut's keys with nothing extra held down, so the toggle and hold shortcuts never fire at the same time.

Customizing a shortcut

Record a new combo in Settings. While you are editing, the global listener is paused so your keypresses don't trigger a recording. VoiceFlow validates the combo before saving it.

  1. 01Open the shortcut editorIn Settings, focus the toggle or hold shortcut field.
  2. 02Press your comboModifiers are ordered consistently (⌘ ⌃ ⌥ ⇧ Fn) and normalized for storage.
  3. 03SaveIf the combo is valid and available, it registers immediately with the native listener.

Validation rules

  • At least one key, and at most five keys per shortcut.
  • At least one non-modifier key — except a single Fn, which is allowed on its own.
  • The two shortcuts must differ from each other. If they ever collide, the hold shortcut is reset to a safe fallback on launch.
  • Reserved system combos are rejected: ⌘Q, ⌘W, and ⌘Tab.

Left/right keys are treated the same

The listener expands each shortcut into raw key variants, so a shortcut using Control matches either the left or right Control key.