Settings
The Settings tab lets you configure every aspect of SpokenCode. Open it by clicking the Settings tab in the app navigation bar.
Click Save Settings at the bottom when you are done making changes. A confirmation toast will appear. Some settings take effect immediately after saving.
Interface Language
Application Language (dropdown)
Options: English, Português (Brasil), Español.
Changing this setting immediately updates the app's interface language — button labels, status messages, and tooltips. It does not interfere with the language you speak or the language of code generated by voice commands, since SpokenCode will always recognize the language you speak regardless of this setting.
Keyboard
Recording Mode (dropdown)
Controls how the global hotkey behaves.
| Option | How it works | Best for |
|---|---|---|
| Push-to-Talk (default) | Hold the hotkey to record; release to stop and transcribe | Short, quick recordings |
| Toggle | Press once to start; press again to stop | Longer dictation sessions |
"Push-to-Talk is ideal for quick recordings. Hold the keys to record and release to automatically transcribe."
SpokenCode API Settings
API Key
A password field for your SpokenCode API key. The key starts with sk_live_ and is stored locally on your machine — it is never sent anywhere except the SpokenCode API for authentication.
If you need a new key, visit spokencode.dev.
Test Connection
Clicking Test Connection saves your current API key and sends a test request to the SpokenCode API. Your remaining credit balance is shown in the result. Use this whenever you enter or change your API key to confirm it is valid.
Behavior Settings
Show Floating Window
Checkbox — default: on
When enabled, a small floating indicator appears on screen while you are recording, so you always know SpokenCode is listening.
When disabled, you can still use all hotkeys normally — the only difference is that no visual indicator appears on screen during recording.
Launch at Startup
Toggle — default: off
When enabled, SpokenCode automatically launches when your computer starts, minimized to the system tray. The global hotkey is available immediately without you needing to open the app manually.
Voice Commands
Enable Voice Commands
Toggle — default: off
When enabled, SpokenCode listens for the wake word "Okay Code" in the background. Saying "Okay Code" automatically starts a recording — no hotkey needed.
This feature requires Python 3.10+ and the openwakeword package installed on your machine. See the Windows installation guide for setup instructions.
Python 3.7, 3.8, and 3.9 are not supported. If the wake word fails to start, check your Python version by running python --version in a terminal.