Troubleshooting mic issues

Mac

Follow these steps in order. Stop as soon as dictation works.

1. Grant microphone permission. If Flow shows a notification, click Allow. If you previously denied access, go to System Settings → Privacy & Security → Microphone and enable Flow. If already enabled, toggle it off and back on, then restart Flow.

2. Select your microphone by name. Click the Flow menu bar icon → Settings → General → Microphone → Change. Choose your specific mic (avoid "Auto-detect"). The volume indicator next to your selection should move when you speak.

3. Test your microphone. Dictate a short phrase, then open Recent activity from the menu bar icon. If an entry appears but shows no text, click it and download the audio file. If you hear your voice clearly, the mic is working — continue to the next step.

4. Restart Flow. Right-click the menu bar icon → Quit Wispr Flow. Reopen Flow and dictate a test phrase. If text appears, you're done.

5. Reset the local database. Click the Flow menu bar icon → Settings → System → Data → Reset & restart. Dictate a test phrase — if text appears, you're done.

Windows

Follow these steps in order. Stop as soon as dictation works.

1. Grant microphone permission. If Flow shows a notification that microphone privacy is disabled, click Open Settings and confirm desktop app access is enabled. If already enabled, toggle it off and back on, then restart Flow.

2. Select your microphone by name. Click the Flow system tray icon → Settings → General → Microphone → Change. Choose your specific mic (avoid "Auto-detect"). The volume indicator next to your selection should move when you speak.

3. Test your microphone. Dictate a short phrase, then open Recent activity from the system tray icon. If an entry appears but shows no text, click it and download the audio file. If you hear your voice clearly, the mic is working — continue to the next step.

4. Restart Flow. Right-click the system tray icon → Quit. Reopen Flow and dictate a test phrase. If text appears, you're done.

5. Reset the local database. Click the Flow system tray icon → Settings → System → Data → Reset & restart. Dictate a test phrase — if text appears, you're done.

iOS

Follow these steps in order. Stop as soon as dictation works.

1. Grant microphone permission. The first time you start a dictation, Flow asks for microphone access — tap Allow. If you previously denied access, Flow shows an alert with an Open Settings button that takes you directly to Flow's settings page. Tap it, then enable Microphone. If permission is already on, toggle it off and back on, then restart Flow. Dictate a short phrase — if text appears, you're done.

2. Use the built-in iPhone microphone. The built-in mic provides the most reliable dictation experience. Dictate a short phrase — if text appears, you're done.

3. Configure a Bluetooth microphone (optional). Open Settings → Bluetooth and pair your device. In the Flow app, tap Settings and toggle off Use Built-In Mic. Dictate a test phrase — if text appears, you're done.

4. Retry failed transcriptions. Tap an empty transcript in history to automatically retry. You can also swipe left on any transcript or long-press it for a Retry option.

Android

Follow these steps in order. Stop as soon as dictation works.

1. Grant microphone permission. If you see a "We can't hear you" card on the home screen, tap Allow Microphone. If permission was previously denied, tap Go to Settings from the prompt and enable the Microphone permission manually. If already enabled, toggle it off and back on, then restart Flow. Dictate a short phrase — if text appears, you're done.

2. Use the built-in mic or a wired headset. Bluetooth microphones add connection delay and may reduce accuracy. Dictate a short phrase — if text appears, you're done.

3. Configure a Bluetooth microphone (optional). Open Settings → Connected devices → Bluetooth and pair your device. Make sure it's connected for calls or audio. Dictate a test phrase — if text appears, you're done.

4. Reconnect a Bluetooth mic that isn't being used. Open Settings → Connected devices and confirm the device is connected. Disconnect and reconnect, or toggle Bluetooth off and back on. Dictate again — if text appears, you're done.

Flow didn't ask for microphone permission on iOS, or didn't appear under iOS Microphone settings

This was caused by Flow not explicitly requesting microphone access at the right time on iOS. In some cases, this also meant Flow never appeared in Settings → Privacy & Security → Microphone. Flow now requests microphone permission the first time you start a dictation. If access is denied, an alert appears with an Open Settings button that takes you directly to Flow's settings page to enable the microphone. Update Flow to the latest version to get this fix.

iOS dictation attempt failed silently during onboarding

When you tried dictation during the "try it yourself" steps in iOS onboarding, Flow previously failed silently if something went wrong. Flow now shows a message at the top of the screen explaining what happened and what to do next:

• Flow didn't hear anything: Flow captured audio but couldn't detect any speech. Move closer to your microphone and tap the mic button to retry.

• Poor connection: Flow couldn't reach the transcription service. Check your internet connection and tap the mic button to retry.

• Microphone in use by another app: Another app (e.g., a video call or voice assistant) is holding the microphone. Close other apps and retry.

• Microphone permission not granted: Flow doesn't have permission to use your microphone. Go to Settings → Privacy & Security → Microphone, enable Flow, and return to the app.

• Something else went wrong: A general fallback for unexpected errors. Tap the mic button to retry.

Update Flow to the latest version to get this fix.

Flow showed "Listening" then "Transcript failed to load" when the mic wasn't available (Mac, Windows)

This was caused by Flow not detecting microphone access failures early enough — it would show the "Listening" bubble as normal, wait up to 24 seconds, then show a generic error even though the real problem was a microphone issue. Flow now immediately ends the dictation session when it can't access your microphone, and shows a specific notification:

• No microphone detected: Shown when no microphone is connected. Click Open Settings in the notification to open your system microphone settings.

• Selected microphone is unavailable: Shown when the microphone you previously selected is no longer connected. Click Choose Microphone to pick a different one.

• Microphone unavailable: Shown when another app is using your microphone or the audio system needs a reset. Click Troubleshoot for help. This notification only appears if the same issue happens twice within 2 minutes, since it often clears up on its own.

• Microphone error: A general fallback when Flow can't access your microphone for another reason. Click Troubleshoot for help. Like the above, this only appears on a repeated failure within 2 minutes.

Update Flow to the latest version to get this fix.

Flow shows "Microphone is not working" or "No audio received" mid-dictation (Mac, Windows)

This was caused by the microphone stopping mid-dictation — for example, due to a macOS audio system issue or another app setting your system input volume to zero. Flow now alerts you in two stages:

• After 5 seconds of silence: The waveform animation in the status bubble goes flat, so you can see immediately that Flow isn't picking up audio.

• After 15 seconds of silence: A "No audio received" notification appears, followed by a "Microphone is not working" notification with a Select microphone button. Click it to switch to a working input. The notification clears automatically after 60 seconds.

If audio recovers on its own, the waveform resumes and all notifications are dismissed automatically. Update Flow to the latest version to get this fix.

Audio silently stopped capturing while Flow still showed "Listening" (Mac, Windows)

This was caused by audio capture interruptions — for example, after the system woke from sleep or during heavy background activity — while Flow still showed a "Listening" status. Flow now automatically recovers audio capture if it's interrupted during an active recording, and is more resilient to wake-from-sleep events. Update Flow to the latest version to resolve this.

Microphone stayed on after the Flow bubble was hidden (Mac, Windows, Android)

This was caused by the dictation session not ending when the bubble was dismissed, allowing the microphone to keep recording in the background until the session timed out (after 20 minutes on desktop). Hiding the bubble now immediately stops any active dictation session and releases the microphone. Fixed on Android in version 1.6.0. Update Flow to the latest version to resolve this.

Microphone selection dialog was blank after upgrading to v1.4.894 (Windows)

This was caused by an upgrade issue in version 1.4.894 that left the microphone picker empty even though dictation sometimes still worked. The microphone picker now populates correctly after upgrading. Update Flow to the latest version to resolve this.

Flow incorrectly said microphone privacy was disabled (Windows, v1.4.894)

This was caused by Flow reading system settings that didn't reflect the actual microphone permission state — common on machines managed by IT policies, Dell Optimizer, or similar privacy tools. Flow now checks microphone access by actually trying to use it, so this false error no longer appears. The notification still appears correctly when microphone access is genuinely blocked. Update Flow to the latest version to resolve this.

Slow-dictation notifications and service incident banners (Mac, Windows)

Flow now detects service-side incidents and surfaces them so you don't troubleshoot your local setup unnecessarily. If you receive a desktop notification after a slow dictation, check the Flow home page for a colored banner — orange means degraded performance, red means an outage. Click View status in the banner to see the current incident. If a service incident is active, performance will recover once the incident is resolved. Update Flow to the latest version to get this feature.

Error message appeared after canceling or dismissing dictation (Mac, Windows)

This was caused by a cleanup race condition when canceling or dismissing a dictation session, which triggered an unexpected error message even though nothing had gone wrong. Update Flow to the latest version to resolve this.

Activation or keyboard shortcuts stopped working or were delayed (Mac, Windows)

This was caused by Flow's keyboard shortcut processing getting stuck, with delays occasionally lasting 30 seconds or more. It affected dictation shortcuts, transform shortcuts (like Opt+S), and the paste-last-text shortcut. Update Flow to the latest version to resolve this.

Clamshell warning appeared even though the MacBook lid was open (Mac)

This was caused by Flow reading outdated hardware information instead of checking the current state. Flow now checks your laptop's hardware state fresh each time you start dictation. As part of this fix, if a clamshell warning does appear, any follow-up "No Audio" notification is suppressed for 60 seconds to prevent duplicate alerts. Update Flow to the latest version to resolve this.

Other bugs fixed in recent updates

The following issues were fixed in recent versions. Update Flow to resolve them:

• Mic took 8–30 seconds to activate after rapidly canceling and retrying (Mac, Windows): Each retry took progressively longer, and the microphone indicator light didn't turn off right away after canceling.

• Wrong microphone name in notifications during the first Bluetooth ring session (Mac, Windows).

• Right-click menu showed an empty mic list right after launch (Mac, Windows): Opening the menu within the first second after starting Flow could show an empty list or cause an error.

• Microphone stayed active after canceling dictation (v1.5.1): The mic could remain on — with the indicator still visible — even after canceling.

• Waveform animation was unresponsive in the first few seconds of dictation (Android): The waveform did not react when you started speaking, which could appear as if audio wasn't being captured.

• Dictation bubble got stuck in "Listening" (desktop): Quickly pressing and releasing the push-to-talk key — especially with a Bluetooth or slow-initializing microphone — could leave Flow unresponsive.

• Stale or incorrect transcription text in a new dictation (desktop): New dictation starting while a prior session was still cleaning up.

• Microphone test bars stayed grey during onboarding (Windows): Caused by Windows audio driver warmup.

• Microphone test page showed audio levels stuck at 0 after onboarding (desktop).

• Voice dictation was blocked after completing onboarding (desktop): Microphone test page not properly marked as complete.

• Dictation hung or took up to 24 seconds to start (desktop): Caused by a race condition.

• Hotkey press did nothing for 30+ seconds (Mac): Internal hotkey handling issue that delayed dictation after pressing the activation shortcut.

• App crashed when granting microphone permission after returning to home screen (Android).

What does it mean when my transcription is empty?

Flow detected no speech in the recording. For recordings 5 seconds or longer (and less than 14 days old), a clickable Retry link appears. If the recording had an error, you'll see a different message.

What does "Unable to access mic" mean?

This notification appears when your microphone takes more than 8 seconds to respond — most often after your Mac wakes from sleep or is under heavy load. Click Restart App to restart Flow. The notification also disappears on its own after a short time.

What does "Microphone is not working" mean?

This notification appears after 15 seconds of silence during dictation — meaning Flow is running but your microphone isn't delivering any audio. Click Select microphone to switch to a different input. The notification clears on its own after 60 seconds, or sooner if audio recovers automatically.

Why does dictation only produce "You" or short random text?

This happens when the microphone picks up very low audio or only background noise. Check your input volume, speak clearly, and position yourself closer to the microphone.

Why is dictation slow with Bluetooth headphones?

Bluetooth microphones add connection delay. For faster performance, switch to your built-in mic or a wired USB or 3.5mm microphone.

How do I know if slow dictation is a service issue and not a mic problem?

Check the Flow home page for a colored banner — orange means degraded performance, red means an outage affecting your region. You may also receive a desktop notification after a slow dictation when a service issue is detected. Click View status in the banner to see the current incident. If a service incident is active, your local setup is fine and performance will recover once it's resolved.

How do I change which microphone Flow uses?

On desktop, click the Flow menu bar icon (Mac) or system tray icon (Windows) → Settings → General → Microphone → Change. Your selection takes effect immediately. On mobile, Flow uses whatever microphone your operating system reports as active.

What if I'm stuck on the microphone test page during setup?

If the test hangs for over a minute, Flow shows a toast: "Having trouble detecting microphone? Try restarting Flow." Click the toast to restart the app and try setup again.

Audio is recorded but no text appears — what should I do?

Open the entry in history and check if the audio is clear. If so, restart Flow and try again. For empty or error recordings 5 seconds or longer (and less than 14 days old), click Retry. For dismissed transcriptions, click Recover. You can also access Retry and Download audio from the three-dot menu.

Retry, Recover, and Download audio are unavailable for recordings older than 14 days. If your organization has a NeverStore data policy enabled, audio is not saved and these options are unavailable.

Why does dictation return "Transcription by CastingWords"?

When audio contains little or no speech, the recognition model fills in silence with placeholder phrases. This indicates your mic isn't capturing audio properly. Check for hardware mute, verify Flow is using the correct microphone, close conflicting apps (Zoom, Google Meet, FaceTime), and try a wired mic.

Why doesn't dictation work when my MacBook lid is closed?

When your MacBook lid is closed, macOS disables the built-in microphone. Flow shows a "Your laptop lid is closed" notification with a Select microphone button to help you switch to an external mic. To keep dictating, connect an external or Bluetooth microphone and select it in Flow: menu bar icon → Settings → General → Microphone → Change. Clamshell detection requires macOS 12 (Monterey) or later, and the warning only appears if you're using the built-in microphone.

How do I troubleshoot the Bluetooth mic ring?

If you're using a Bluetooth mic ring with Flow and run into connection issues:

• Ring not found during pairing: Make sure the ring is charged and within a few feet of your computer. Open Flow's Internal Settings page, select Scan for devices, and wait a few seconds. If it doesn't show up, restart the ring and try again.

• Pairing fails or gets stuck: Forget the ring from the Internal Settings page, restart both the ring and Flow, then attempt pairing again.

• Ring doesn't reconnect after restarting Flow: Open the Internal Settings page and confirm the ring is still listed as paired. If not, re-pair it. Make sure the ring is powered on and nearby when Flow starts.

• Pressing the ring button does nothing: Confirm the ring is shown as connected in the Internal Settings page. If it shows as disconnected, forget and re-pair the device.