FixesMac8 min read
Wispr Flow not working on Mac: how to fix it
Wispr Flow not working on Mac? Find out if the shortcut fails or the paste fails, then re-check Microphone and Accessibility after each update.
Published by Optimal Apps, the maker of Petal.
On this page
When you see Wispr Flow not working on Mac, first find out which half fails. Either the shortcut never starts a recording, or Flow records and transcribes but the text never reaches the text field. For both cases, Wispr's official fix is the same first step: quit Flow, turn Wispr Flow off and on in System Settings > Privacy & Security > Microphone, turn on the main Wispr Flow app in Accessibility, and reopen Flow. Do this again after each Flow or macOS update.
This guide covers both failures, the cause of each fix, and a free on-device option if you decide to switch.
Quick-fix checklist
| Symptom | Most likely cause | Fix |
|---|---|---|
| Shortcut does nothing, no recording bar | Microphone or Accessibility grant broke after an update | Re-grant both permissions, then reopen Flow |
| Fn works, Space or Escape does not | Another app holds secure keyboard input | Close that app, or lock and unlock the Mac |
| Flow does not launch at all | Flow runs from the wrong folder | Move Flow to /Applications |
| Flow missing from the permission lists | Broken install | Reinstall Flow |
| Recording works, no text appears | Paste failed, or the field lost focus | Press Control-Command-V (Paste last transcript) |
| "Is your internet connected?" | Network dropped | Restore the connection and retry from History |
| "Microphone disconnected" | Mic removed during dictation | Choose Insert, then select another input |
Step 1: Diagnose Wispr Flow not working on Mac
Do one short test before you change settings.
- Open Notes or TextEdit and click in an empty note.
- Press your Flow shortcut. The default is to hold Fn to talk.
- Say one short sentence and release the key.
Now look at the result:
- No recording bar, no sound, nothing in History. The shortcut or the microphone is the problem. Go to Step 2.
- Flow shows processing, but no text appears. The transcript exists, but the paste failed. Go to Step 5. For more detail, read Wispr Flow not pasting text.
Wispr's own help center states this split clearly: a failed paste does not mean a failed transcription. The text stays on your clipboard.
Step 2: Re-verify Wispr Flow permissions after an update
This is Wispr's official fix for most "it stopped working" reports. macOS stores permission grants per app. After an update, the grant can point to an old copy of the app, or show "on" while it no longer works.
- Click the Wispr Flow icon in the menu bar and choose Quit.
- Open System Settings > Privacy & Security > Microphone.
- Turn Wispr Flow off, then turn it on again.
- Open System Settings > Privacy & Security > Accessibility.
- Turn on the main Wispr Flow app. Do not turn on a helper process instead.
- If Wispr Flow is already on, turn it off and on again. Enter your password if macOS asks.
- Reopen Wispr Flow from Applications or the Dock.
- Repeat the short test in Notes.
Why it works: Microphone lets Flow hear you. Accessibility lets Flow detect the shortcut in other apps and send the paste. If either grant is stale, the shortcut or the paste silently fails.
Screen Recording is not needed for basic dictation, so you do not have to change that permission.
If you keep getting microphone prompts, the grant did not save. Repeat the steps. If Flow shows "Permission request timed out. Please try again or restart the app.", quit Flow and start again from step 1.
For a general walkthrough of these two settings, see Accessibility permission not working on Mac and Mac microphone permission.
Step 3: Fix the Wispr Flow shortcut not working
If the permissions are correct but the shortcut still fails, check these items.
Only some keys work
Wispr's help center lists three default shortcuts on Mac: hold Fn to talk, Space for push-to-talk, and Escape to cancel. If Fn works but Space and Escape do not, another app has turned on secure keyboard input. Password managers, terminals with "Secure Keyboard Entry", and some password fields do this.
- Close the app that has a password field or secure entry active.
- If you closed that app and the keys still fail, lock the Mac (Control-Command-Q) and unlock it.
- If that does not help, log out and log back in.
Why it works: secure input stops all other apps from reading key presses. It ends when the app releases it, or when your login session restarts.
The Fn key opens the emoji picker or Dictation
macOS can assign the Fn (globe) key to its own action. Open System Settings > Keyboard and check the Press globe key to menu. If it opens the Emoji & Symbols viewer or starts Apple Dictation, that action can compete with Flow. Set it to Do Nothing, or pick a different Flow shortcut in Flow's settings (Settings > General > Shortcuts).
The shortcut was changed
Custom Flow shortcuts are saved per device and do not sync between computers. If you set a shortcut on another Mac, this Mac still uses its own. Open Settings > General > Shortcuts in Flow and confirm the key.
Step 4: Fix Wispr Flow not recording
If the shortcut starts Flow but nothing records, the microphone path is the problem.
- Open System Settings > Sound > Input and speak. Confirm the input level moves for the microphone you want.
- In Flow's settings, select that microphone under Microphone, then restart Flow.
- If you use a MacBook with the lid closed, select an external microphone. The built-in mic does not hear you with the lid closed.
- If Flow shows "Microphone disconnected", choose Insert to keep the text captured before the disconnect. Then reconnect the mic or select another input.
- If Flow shows "Flow is having trouble loading" or "Audio system failed to load", choose Restart Flow.
- If nothing helps, restart the Mac. Wispr lists this as the last step for a wrong input.
Why it works: Flow records from the device that it has selected, not always the system default. A Bluetooth headset that sleeps, or a USB mic that you unplugged, leaves Flow with no audio.
For Bluetooth problems in particular, read Bluetooth microphone dictation on Mac.
Step 5: Recover the text when the paste fails
If Flow transcribed but did not paste, do not dictate again. Recover the transcript first.
- Click in an editable text field so the cursor blinks there.
- Press Control-Command-V (Paste last transcript). Press and release all keys. If you hold the modifiers, the shortcut does not fire.
- If no text appears, use Copy last transcript (Control-Command-C) and press Command-V.
- Older dictations are in Transcript history in the Flow Bar context menu. Click a row to copy it.
The full recovery flow, including History retries, is in Wispr Flow not pasting text.
Step 6: Reinstall if Flow is not in the list
If Wispr Flow does not appear under Microphone or Accessibility at all, macOS does not know about the app.
- Quit Flow.
- Drag Wispr Flow from Applications to the Trash.
- Download a fresh copy from wisprflow.ai.
- Drag it into /Applications. Wispr says Flow must launch from /Applications, ~/Applications, or /System/Applications.
- Open Flow and grant Microphone and Accessibility when it asks.
If Flow is still missing from the lists, contact Wispr support (Help > Talk to support) and give your macOS version.
Step 7: Check the internet connection
Wispr's privacy page says "Transcription always happens in the cloud." If your network drops, Flow can show "Is your internet connected?" or an internet notice. Your audio is saved for a retry. Restore the connection, then retry the dictation from History. Recordings older than 14 days cannot be retried.
A VPN, a corporate proxy, or a firewall that blocks the connection has the same effect. For more detail, read Wispr Flow not working offline.
If you still want to switch: Petal for Mac
Most Wispr Flow problems have a fix, and the steps above solve the common ones. If you keep hitting the internet requirement or the word limit of the free plan, or you want your audio to stay on your Mac, Petal is a free option.
Petal for Mac is a free, open-source (MIT) menu bar app from Optimal Apps, the publisher of this site. You press a shortcut, speak, and Petal pastes the text into the front app. The differences that matter here:
- On-device speech. Petal runs the speech model on your Mac through FluidAudio (Core ML), argmax WhisperKit, or MLX. Models include Parakeet, Whisper Large V3 Turbo, Qwen3 ASR, and Apple Speech. After you download a model, dictation works with no network.
- On-device cleanup. Petal W1 is a small cleanup model that runs on your Mac and turns a rambling dictation into a clean message. A cloud model is optional, with your own OpenAI, Anthropic, or OpenRouter key, or a local Ollama or LM Studio server.
- No account and no word cap. The Mac app is free.
- The same two permissions. Petal also needs Microphone and Accessibility. If Accessibility is off, Petal copies the transcript to the clipboard instead of pasting it, and keeps the transcript in History.
Petal needs macOS 26.2 or later. For a side-by-side look, read Petal vs Wispr Flow or the wider Wispr Flow alternative guide.
Summary
- Test in Notes to see if the shortcut or the paste fails.
- Quit Flow, reset Microphone and Accessibility for the main app, and reopen Flow.
- Close apps with secure input if only some keys work.
- Select the correct microphone in Flow and in Sound settings.
- Use Control-Command-V to recover a transcript that did not paste.
- Reinstall into /Applications if Flow is missing from the permission lists.
- Check the network, because Flow transcribes in the cloud.
Questions
Why did Wispr Flow stop working after an update?
macOS can drop or confuse the Microphone and Accessibility grants after an app update. Quit Flow, turn Wispr Flow off and on in Privacy & Security > Microphone, turn on the main Wispr Flow app in Accessibility, then reopen Flow.
Why does the Fn key work but Space and Escape do not?
Wispr says another app can hold secure keyboard input, which blocks those keys. A new permission grant does not fix it. Close that app, or lock and unlock the Mac, or log out and back in.
Wispr Flow is not in the Accessibility list. What do I do?
Reinstall Wispr Flow into the Applications folder. Wispr says Flow must run from /Applications, ~/Applications, or /System/Applications. If it is still missing, contact Wispr support with your macOS version.
Does Wispr Flow need the internet to work?
Yes. Wispr's privacy page says transcription always happens in the cloud, so a dropped connection stops dictation. Petal for Mac is a free alternative that transcribes on your Mac.