Recording Modes
Steno supports two recording modes:
- Press-to-talk: hold
Optionto record, release to stop and transcribe. - Hands-free: press the global function key to start, press again to stop.
Both modes run through the same transcription and insertion pipeline once recording ends.
Default Hotkeys
Default recording settings in source:
- Option hold-to-talk: enabled
- Hands-free global key:
F18(key code79)
Hands-free key options in UI:
- Disabled
F13throughF20
Steno suppresses the selected hands-free function key so other apps do not receive that key event.
State Transitions
Steno uses a state machine to prevent overlapping sessions:
idle-> start press-to-talk or hands-free- recording state ->
transcribingwhen stop is triggered transcribingblocks new recordings until done- completion or failure returns to
idle
Examples:
- pressing hands-free while Option recording is active is ignored
- releasing Option while hands-free is active is ignored
This avoids partial captures and conflicting insertion events.
Best Practices
- Keep Option hold-to-talk enabled as your fallback mode.
- Choose a hands-free key not used by your keyboard macros.
- If hotkeys stop responding, refresh permissions and restart Steno.
- Test in your primary editor and terminal after changing key settings.
Permission dependency
Global hotkeys depend on Input Monitoring and Accessibility-related event access on macOS. If either is restricted by policy, registration can fail.