Skip to content
Petal

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.

  1. Open Notes or TextEdit and click in an empty note.
  2. Press your Flow shortcut. The default is to hold Fn to talk.
  3. 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.

  1. Click the Wispr Flow icon in the menu bar and choose Quit.
  2. Open System Settings > Privacy & Security > Microphone.
  3. Turn Wispr Flow off, then turn it on again.
  4. Open System Settings > Privacy & Security > Accessibility.
  5. Turn on the main Wispr Flow app. Do not turn on a helper process instead.
  6. If Wispr Flow is already on, turn it off and on again. Enter your password if macOS asks.
  7. Reopen Wispr Flow from Applications or the Dock.
  8. 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.

  1. Close the app that has a password field or secure entry active.
  2. If you closed that app and the keys still fail, lock the Mac (Control-Command-Q) and unlock it.
  3. 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.

  1. Open System Settings > Sound > Input and speak. Confirm the input level moves for the microphone you want.
  2. In Flow's settings, select that microphone under Microphone, then restart Flow.
  3. 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.
  4. If Flow shows "Microphone disconnected", choose Insert to keep the text captured before the disconnect. Then reconnect the mic or select another input.
  5. If Flow shows "Flow is having trouble loading" or "Audio system failed to load", choose Restart Flow.
  6. 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.

  1. Click in an editable text field so the cursor blinks there.
  2. Press Control-Command-V (Paste last transcript). Press and release all keys. If you hold the modifiers, the shortcut does not fire.
  3. If no text appears, use Copy last transcript (Control-Command-C) and press Command-V.
  4. 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.

  1. Quit Flow.
  2. Drag Wispr Flow from Applications to the Trash.
  3. Download a fresh copy from wisprflow.ai.
  4. Drag it into /Applications. Wispr says Flow must launch from /Applications, ~/Applications, or /System/Applications.
  5. 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

  1. Test in Notes to see if the shortcut or the paste fails.
  2. Quit Flow, reset Microphone and Accessibility for the main app, and reopen Flow.
  3. Close apps with secure input if only some keys work.
  4. Select the correct microphone in Flow and in Sound settings.
  5. Use Control-Command-V to recover a transcript that did not paste.
  6. Reinstall into /Applications if Flow is missing from the permission lists.
  7. 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.

FixesiPhone

Wispr Flow keyboard not working on iPhone

Wispr Flow keyboard not working on iPhone? Turn on Allow Full Access, grant the mic in the app, stay signed in, and set a longer Disable Flow after time.