Getting Started

Download and Install

1. Go to the Download page and grab the installer for your platform.
2. macOS: Open the .dmg file and drag WisperCode to your Applications folder.
3. Windows: Run the .exe installer and follow the prompts.

First Launch

When you open WisperCode for the first time, you'll be guided through a short setup:

1. Grant Microphone Access — WisperCode needs to hear you. On macOS, you'll see a system permission dialog. On Windows, allow microphone access in Settings.
2. Grant Accessibility Permissions (macOS only) — This lets WisperCode type into other apps on your behalf.
3. Choose a Whisper Model — Smaller models are faster but less accurate. Start with base or small if you're unsure.
4. Pick Your Hotkey Mode — Choose how you want to trigger recording (hold, toggle, press, or double-press).

Download a Model

WisperCode uses OpenAI's Whisper models for transcription. The first time you use it, you'll need to download a model:

For most users, small or medium offers the best balance.

Your First Dictation

1. Open any app where you type — a text editor, email client, chat app, anything.
2. Click where you want text to appear.
3. Press and hold your hotkey (default: Ctrl+Space on macOS, Ctrl+Space on Windows).
4. Speak naturally.
5. Release the hotkey.
6. Your transcribed text appears at the cursor.

That's it. No account, no internet required.

Next Steps

• Configure WisperCode to match how you work.
• Check Troubleshooting if you run into issues.