Configuration

Hotkey Modes

WisperCode supports four ways to trigger recording:

• Hold — Press and hold your hotkey to record. Release to stop and transcribe. This is the default.
• Toggle — Press once to start recording, press again to stop.
• Press — Single press starts recording. Recording stops automatically after a configurable silence duration.
• Double-press — Double-tap your hotkey to start. Double-tap again to stop.

Change your hotkey and mode in Settings > Hotkey.

Whisper Model Selection

Switch between models at any time in Settings > Model. Larger models are more accurate but slower:

• Use tiny or base for quick notes where speed matters more than accuracy.
• Use small or medium for everyday dictation.
• Use large when accuracy is critical — medical, legal, or technical content.

Models are downloaded once and stored locally. You can have multiple models installed and switch between them.

Text Processing

Filler Word Removal

WisperCode strips common filler words (um, uh, like, you know) from your transcriptions by default. Toggle this in Settings > Text Processing.

Context-Aware Styling

When enabled, WisperCode detects which app is focused and adjusts formatting:

• Chat apps (Slack, Discord, Messages) — casual tone, lowercase
• Email (Gmail, Outlook) — standard capitalization and punctuation
• Code editors (VS Code, IntelliJ) — preserves technical terms

Configure per-app rules in Settings > Styling.

Vocabulary Hints

Add words that Whisper might not recognize on its own:

• Technical terms: Kubernetes, PostgreSQL, Tailwind
• Proper nouns: names of people, companies, products
• Acronyms: API, SDK, CLI

Manage your vocabulary in Settings > Dictionary.

Snippets

Define short trigger phrases that expand into longer text:

Create snippets in Settings > Snippets.

Voice Notes

Every transcription can be saved as a voice note. Browse, search, and export your notes from the Voice Notes tab. Notes are stored locally in a SQLite database — nothing leaves your machine.

Data Storage

All WisperCode data is stored locally:

• Configuration: ~/.wisper/config.json
• Database: ~/.wisper/wisper.db
• Models: ~/.wisper/models/
• Logs: ~/.wisper/logs/

To reset WisperCode, delete the ~/.wisper directory and restart the app.