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. The words appear at the cursor and your clipboard is put back. That is the entire manual; everything below is detail.
- InstallDownload the DMG, drag FreeFlow to Applications, open it. It is signed and notarized, so there is no Gatekeeper detour. It needs macOS 14 or later on an Apple Silicon Mac.
- Allow Microphone and AccessibilityMicrophone lets it hear you. Accessibility lets it paste into the app in front (a synthesized ⌘V) and copy the selection that read-aloud speaks (a synthesized ⌘C). Those are the only two permissions it asks for, ever.
- Download a modelOnboarding fetches Parakeet V3 from Hugging Face: 484 MB, 25 European languages, the fastest and the default. This is the one time dictation needs the network. Other models are a click away in the Models page in FreeFlow's window.
- DictateClick into any text field. Hold ⌥, speak, release. A small indicator — a pill at the bottom of the screen by default — shows it listening and then “Writing it down…”. The text lands at your cursor.
The two ways to talk
Hold to talk. Hold ⌥ alone and speak; release to transcribe and paste. A tap shorter than 0.3 s is ignored, and pressing any other key while ⌥ is down means you meant a keyboard shortcut, so ⌥-chords like ⌥⌫ or ⌥e never open the microphone. Toggle. Press ⌥Space to start, speak as long as you like with your hands free, press ⌥Space again to stop. Esc cancels either. Both are changeable under Settings → Hotkeys; see hotkeys.
What you will see
- The indicator — a pill, a draggable panel, or a bubble tucked under the notch, your choice in Settings. It shows a live waveform, the mode you are in, and the elapsed time.
- The menu bar mark — FreeFlow lives there, not in a window. Open Settings, switch modes, toggle Incognito, or grab Copy Last Transcript from it. The Dock icon is optional.
- The dashboard — words dictated, your streak, average words per minute, and a searchable history with audio playback. Open it from the menu bar.
Three things worth doing in week one
- Teach the dictionary your words. Names, products, jargon, identifiers. Add each once under the Dictionary page in FreeFlow's window and it is spelled your way from then on.
- Try the Clean Up mode. It drops fillers and, on macOS 26, tidies the take with Apple Intelligence on your Mac. Switch modes from the menu bar; see modes.
- Connect Claude Code, if you use it. Settings → Claude Code → Connect, and its questions start arriving as cards you can answer out loud. See the Claude Code page.
Where everything lives
Recordings, transcripts, history, modes, dictionary and settings are plain files in ~/Library/Application Support/FreeFlow/. Read them, back them up, delete them. A retention setting can trim old history to the Trash for you. The one exception is the optional read-aloud voice, which FluidAudio caches in ~/.cache/fluidaudio/Models/ so other apps built on it can share the download.
Questions people ask
Why does FreeFlow need Accessibility?
To paste. macOS lets an app type into another app only through the Accessibility permission, which FreeFlow uses for a synthesized ⌘V and nothing else. Your clipboard is restored about a second and a half later.
Does it work in every app?
Any app with a blinking cursor: Mail, Slack, a terminal, Cursor, a browser, Notes. Password fields are the exception — macOS blocks pasting there, so FreeFlow leaves the text on the clipboard for 30 seconds instead.
Can I use it with Wi-Fi off?
Yes. After the one-time model download, transcription never needs the network. The four things that ever do are listed on the privacy page, and none of them carries your voice.
Does it replace Apple Dictation?
It runs alongside it. FreeFlow uses its own hotkeys and does not disable Apple's; most people simply stop using the built-in one.