Docs and guides
Everything FreeFlow does, written down. The manual is short because the app is: hold ⌥, talk, let go. The rest of these pages cover what happens around that, and what to do when a Mac gets in the way.
Start here
Getting started
Install FreeFlow from the DMG, allow Microphone and Accessibility, let it download Parakeet V3 (484 MB, once), then put your cursor anywhere you can type, hold ⌥, talk, and let go.
Troubleshooting
Most problems are one of six: the text went to another window, the first take after a break was slow, AirPods recorded nothing, the indicator vanished after a fullscreen app, a quiet take came back as “Didn't catch that”, or a ⌥ shortcut started a recording.
Updates
FreeFlow checks freeflow.audio once a day for a newer version and, if there is one, offers to install it: it downloads the same DMG the website serves, checks that it is signed by FreeFlow, notarized by Apple and exactly the version announced, swaps itself into place and relaunches.
Dictating
Hotkeys
FreeFlow listens for two things by default: ⌥ held alone (talk while holding, release to paste) and ⌥Space pressed once to start and again to stop.
Modes and the dictionary
A mode is a bundle of settings you switch from the menu bar: which speech model, which language, whether to translate, autocapitalise, drop fillers or filter profanity, and — on macOS 26 — a prompt that tidies the take with Apple Intelligence on your Mac.
The dictionary
The dictionary holds two kinds of entry.
The recording indicator
While you hold ⌥, FreeFlow shows an indicator with a live waveform, the mode you are in and the elapsed time, then “Writing it down…” until the text lands.
Read aloud
Select text in any app and press ⌃⌥S.
History, the dashboard and Incognito
Every take is kept on your Mac as a transcript and a WAV in FreeFlow's data folder: searchable in History, playable, and counted on the dashboard (words, streak, average words per minute).
Microphone and ducking
Settings → While dictating picks the microphone: a specific device, or Auto-detect, which follows the system input except that it prefers the built-in mic over a Bluetooth headset so AirPods keep their stereo.
Models and languages
The speech models
FreeFlow ships six on-device speech models.
Languages
Parakeet V3 handles 25 European languages and detects which one you are speaking.
Formatting with Apple Intelligence
On macOS 26 with Apple Intelligence on, any mode can hand its transcript to Apple's on-device language model with a prompt you write: fillers and false starts gone, self-corrections applied, punctuation fixed.
Bring your own model
Models → Add takes any Hugging Face repository laid out in WhisperKit's CoreML format — a fine-tune, a distilled variant, a model that did not exist when FreeFlow shipped — or a model folder already on disk.
Claude Code and coding
Your licence
Dictating into specific apps
Voice dictation in the terminal
FreeFlow pastes into whatever is in front, and a terminal is in front like anything else: hold ⌥ at the prompt, speak, release, and the text is at the cursor without a newline, so nothing runs until you press Enter.
Voice dictation for Cursor
Cursor's chat box, Composer and editor are ordinary text fields, so FreeFlow dictates into all of them: hold ⌥, describe the change, release, and the prompt is at the cursor, transcribed on your Mac.
Voice dictation for VS Code
VS Code's chat panels, editor, Source Control box and integrated terminal are all text fields, so FreeFlow dictates into each: hold ⌥, speak, release.
Voice dictation for ChatGPT, Claude and other AI chat apps
Every AI chat box is a text field, so FreeFlow dictates into all of them: click into ChatGPT, Claude, Gemini or Perplexity, hold ⌥, say the prompt, release, and the text is at the cursor.
Voice dictation for notes
Put the cursor in a note, hold ⌥, talk, let go.
Voice dictation for email
Click into the message body, hold ⌥, say the email, let go.
Voice dictation for Slack and chat
Click into the message box, hold ⌥, say it, let go.
Voice dictation for writers
For long-form, use the toggle: press ⌥Space, talk for as long as the thought lasts, press again.
Dictation for lawyers and confidential work
Cloud dictation sends every word you say to a vendor's server under a retention policy.
Dictation when typing hurts
FreeFlow replaces the typing: a hands-free toggle (⌥Space, or any key you choose) records for as long as you like with no timeout, and the words land in whatever app has the cursor.
Guides
Claude Code's /voice or a system-wide dictation app?
Use /voice if the Claude Code prompt is the only place you type, you sign in with a Claude.ai account, and sending audio to Anthropic is fine.
Voice coding on a Mac: a practical setup
Voice coding now means two different jobs.
Parakeet or Whisper for dictation on a Mac?
For live dictation in English or one of 25 European languages, Parakeet V3 wins: lower word error rate (6.3% against 7.4% to 8%) and several times the speed on the Neural Engine.
The speech models
Parakeet V3
Parakeet V3 is NVIDIA's 600-million-parameter speech model, run on the Mac's Neural Engine as a 484 MB CoreML model.
Whisper Large V3 Turbo
Whisper Large V3 Turbo is OpenAI's Whisper with the decoder cut from 32 layers to 4, which makes it several times faster than the full Large model at a small cost in accuracy (7.8% against 7.4% average English WER).
Cohere Transcribe
Cohere Transcribe is a 2-billion-parameter speech model and the most accurate one FreeFlow ships, at a 5.4% average English word error rate.
Alternatives
Wispr Flow alternatives for Mac
People leave Wispr Flow for one of three reasons: the subscription, the upload, or wanting it on a Mac without an account.
superwhisper alternatives
superwhisper is good, which is why its alternatives are about shape rather than quality: one price instead of $8.49 a month, one behaviour instead of local-or-cloud by mode, or free instead of either.
Voibe alternatives
Voibe is on-device, which rules out the usual privacy argument; its alternatives are about price and polish.
Apple Dictation alternatives
Apple Dictation is free, built in and on-device, and people replace it for two reasons it cannot fix: it ends a session when you pause, and it has no custom vocabulary.
Dragon alternatives for Mac
There is no Dragon for Mac: Nuance discontinued it on 22 October 2018 and only sells Windows versions.
Willow Voice alternatives
Willow Voice is fast cloud dictation with the best free tier in the category, and its alternatives split on the one thing it cannot change: the upload.