Home/Docs/Settings reference

Settings reference

Every setting in the app, what it defaults to, and what it actually changes. Grouped as they appear in Dashboard β–Έ Settings.

Dictation

SettingDefaultWhat it does
Hotkeyfn / 🌐 GlobeThe key you hold to talk. Fourteen options β€” see Hotkeys.
Max take length5 minutesSafety cap per dictation (1, 2, 5, or 10 minutes). On reaching it the take is finished and inserted, never discarded.
Paste automaticallyOnInserts text at your cursor. Off means the app transcribes but leaves insertion to you β€” see How text is inserted.
Show words as you speakOnLive partial transcript in the HUD. Costs a little compute; turn off to save battery.
Start when you log inOnRegisters OpenVoiceFlow as a login item. A menu-bar utility that vanishes on reboot reads as broken, so this defaults on.
Show in DockOnOff makes the app menu-bar only. The dashboard is still reachable from the menu bar.

Transcription β€” on this Mac

SettingDefaultWhat it does
Whisper modelChosen during onboardingWhich engine transcribes your speech. Changing it here loads the new model immediately β€” see Whisper models.
LanguageEnglishThe language you dictate in. Eleven options β€” see Languages.

AI cleanup

SettingDefaultWhat it does
Clean up my dictationOffMaster switch. Off means raw on-device transcript and no network request at all.
Providerβ€”Which backend performs cleanup β€” see Choosing a backend.
API keyEmptyStored in the macOS Keychain, per provider β€” see API keys.
Model overrideEmptyUse a specific model instead of the provider default. Empty means the default.

Privacy & updates

SettingDefaultWhat it does
Reveal in Finderβ€”Opens the folder holding your settings, history, and personalization files.
Delete history…—Clears dictation history, with the option to keep your first-ever transcript.
Show what was typed in the HUDOnEchoes the tail of inserted text. Turn off when dictating sensitive material β€” the HUD shows a word count instead.
Automatic updatesOnChecks for signed updates in the background daily and installs them on next launch β€” see Updates.

Permissions

The top card shows the state of each of the three macOS permissions with a button to grant or open System Settings. Full detail in Permissions.

Where settings are stored

~/Library/Application Support/OpenVoiceFlow/settings.json, excluding API keys, which live in the Keychain. The file is written atomically, and an unrecognized or missing field falls back to its default rather than resetting everything β€” so a settings file from an older version keeps working after an update.

Documentation for OpenVoiceFlow 0.5.5 Β· last updated 2026-07-31. Something wrong or missing here? That is a bug β€” tell us at shimoverse@gmail.com.