Troubleshooting

Hotkey Not Working

macOS

1. Check Accessibility permissions. Go to System Settings > Privacy & Security > Accessibility and make sure WisperCode (or "Wisper Code") is listed and enabled.
2. Restart WisperCode after granting permissions. macOS requires a restart for accessibility changes to take effect.
3. Check for conflicts. Another app might be using the same hotkey. Try changing your hotkey in Settings > Hotkey.

Windows

1. Run as administrator if the hotkey doesn't work in elevated apps.
2. Check for conflicts with other apps that register global hotkeys (Discord, OBS, gaming software).
3. Try a different hotkey in Settings > Hotkey.

No Audio / Microphone Not Detected

1. Check system permissions. Make sure WisperCode has microphone access in your OS settings.
2. Select the correct device. Go to Settings > Audio and choose your microphone from the dropdown.
3. Test your microphone in your system's sound settings to confirm it's working.
4. Close other apps that might be exclusively using the microphone (Zoom, Teams, etc.).

Poor Transcription Accuracy

1. Try a larger model. Switch from tiny or base to small or medium in Settings > Model.
2. Speak clearly and at a normal pace. Whisper handles natural speech well, but mumbling or very fast speech reduces accuracy.
3. Reduce background noise. Use a directional microphone or find a quieter environment.
4. Add vocabulary hints. If Whisper keeps getting specific words wrong, add them to your dictionary in Settings > Dictionary.
5. Check the language setting. Make sure the correct language is selected in Settings > Model.

Text Not Appearing in Target App

macOS

1. Check Accessibility permissions (see "Hotkey Not Working" above). WisperCode needs accessibility access to type into other apps.
2. Some apps block automated input. A few apps (mostly banking or security software) block programmatic text insertion. WisperCode will fall back to clipboard paste in these cases.

Windows

1. Try running WisperCode as administrator if text doesn't appear in elevated applications.
2. Check that the target app is focused when recording stops.

High CPU / Memory Usage

• Large models use more RAM. The large model needs ~10 GB of RAM. If your system is struggling, switch to small or medium.
• GPU acceleration reduces CPU load significantly. If you have a compatible GPU, WisperCode will use it automatically.
• Close the model when not in use. WisperCode keeps the model loaded for fast transcription, but you can unload it from the system tray menu.

App Crashes on Launch

1. Delete the config file at ~/.wisper/config.json and restart. A corrupted config can prevent launch.
2. Check for OS compatibility. WisperCode requires macOS 12+ or Windows 10+.
3. Update your OS to the latest version.
4. Reinstall WisperCode from the Download page.

Still Stuck?

Reach out at hello@wispercode.com with:

• Your operating system and version
• The Whisper model you're using
• Steps to reproduce the issue
• Any error messages you see

We'll get back to you.