Error messages
"No voice found" or stuck processing
Fix recordings with no detectable speech, or processing that never ends.
AI formatting didn't run and pasted raw text
You got the raw transcription because the AI step failed. Covers connection, model, and API-key checks.
App won't launch or install
Fix Windows DLL and Vulkan errors, installer problems, and macOS launch failures.
Superwhisper crashes or quits unexpectedly
Find out whether the model, the mode, or the machine causes the crash.
Wrong output
Transcribed in English instead of my language
Set a fixed language or add a hint when Automatic picks English.
Gibberish, repeated, or made-up text
Find the stage that adds words you never said, and reduce it.
AI answers instead of transcribing
A mode’s prompt causes this. Prompting tips help you fix it.
Text not pasting, pasting twice, or pasting old text
Fix paste problems with permissions, clipboard content, and simulate keypresses.
Input and controls
Shortcuts not working or misfiring
Check key conflicts, global and per-mode shortcuts, and push to talk.
Microphone, system audio, or Muffle
Switch inputs, handle Bluetooth headsets, fix empty meeting recordings, and set up Muffle with other audio apps.
Modes not saving or disappearing
Check the Superwhisper folder location when modes will not save.
Slow dictations or heavy memory use
Adjust model choice and voice model load time, then find the slow step.
Other guides
Realtime toggle missing or grayed out
Realtime needs a Pro license and a Nova, Scribe, or Parakeet model.
Context awareness
Learn when each context type is captured and why it can go wrong.
Keyboard doesn't return to your app on iOS 26.4
Swipe back manually after you start dictation on iOS.
Logs, clean uninstall, and reporting bugs
Turn on logging, find your files, uninstall cleanly, and report bugs.

