Skip to main content

Troubleshooting

Common issues and how to resolve them.

Nothing happens when I press the hotkey​

  1. Make sure SpokenCode is running. Look for the SpokenCode icon in the system tray (bottom-right area of the Windows taskbar). If it is not there, launch SpokenCode from the Start menu.

  2. Check that your microphone is plugged in and working. Try recording something in another app (like the Windows Voice Recorder) to confirm the microphone is working.

  3. Re-register the hotkey. Open SpokenCode, go to Settings → Keyboard, change the Recording Mode, click Save Settings, then change it back and save again. This refreshes the hotkey registration.

The app is asking me for an API key​

You need a SpokenCode API key to use the app.

  1. Visit spokencode.dev and create a free account
  2. Copy your API key — it is only shown once at registration
  3. Open SpokenCode, go to Settings → SpokenCode API Settings → API Key
  4. Paste the key and click Save Settings
  5. Click Test Connection to verify the key is valid

My transcription is inaccurate​

  • Speak clearly and position your microphone close to your mouth
  • Set your language explicitly in Settings → SpokenCode API Settings → Language instead of using Auto-detect
  • Switch to Whisper Large V3 in Settings → SpokenCode API Settings → Transcription Model for the highest accuracy

My voice command keyword isn't being recognized​

  • The keyword must be at the very beginning of your sentence — saying "I need a javascript function" will not work; say "javascript create a function" instead
  • Check that Settings → Interface Language matches the language you are speaking. Keywords are different for each language (for example, Portuguese uses "comando" instead of "command")
  • Speak at a normal pace — rapid or mumbled speech may be misrecognized

I ran out of credits​

Your credit balance is shown in the top-right corner of the app window. When it reaches 0, transcription and code generation stop working.

Purchase more credits at spokencode.dev.

The floating window is in the way​

Go to Settings → Behavior Settings and uncheck Show Floating Window, then click Save Settings. You can still use all hotkeys normally — the only difference is no visual indicator appears during recording.

The app disappeared and I can't find it​

SpokenCode minimizes to the system tray when you close the window. Look for the SpokenCode icon in the bottom-right area of the Windows taskbar (you may need to click the up-arrow ^ to see hidden tray icons).

Right-click the icon and select Open Interface to bring the window back.

Getting More Help​

If none of the above steps resolve your issue:

  1. Open a bug report at GitHub Issues

When reporting, please include:

  • Your SpokenCode version (visible in the About tab)
  • Your Windows version (e.g. Windows 11 23H2)
  • A description of the issue and what you tried
  • Any error messages visible on screen