Help & Documentation
Everything you need to get started with Wispert.
1 Getting Started
Wispert lives in your menu bar and turns speech into text — then types it into any app. Here's how to get set up:
- Grant permissions — Wispert needs Microphone access (to hear you) and Accessibility access (to insert text and register hotkeys). Grant these in System Settings > Privacy & Security.
- Choose a backend — Pick Parakeet (default, on-device), Whisper Local (on-device), or OpenAI / Groq (cloud) in Settings > Transcription.
- Hold your hotkey — By default, hold Right Option to record. Release to transcribe and insert text at the cursor.
2 Permissions
Wispert requires two macOS permissions to function:
- MIC Microphone — Required to capture audio for transcription. Without this, Wispert cannot hear you.
- A11Y Accessibility — Required to insert transcribed text into other apps and to register global hotkeys. Without this, text cannot be typed into other applications.
Grant these in System Settings > Privacy & Security. Wispert will guide you through this during onboarding.
3 Recording Modes
Hold to Talk
Hold the hotkey to record. Release to stop and transcribe. This is the default mode — natural and fast.
Toggle
Press once to start recording. Press again to stop and transcribe. Better for longer dictation sessions.
4 Transcription Backends
Choose from four transcription engines. All auto-detect the spoken language.
| Backend | Speed | Cost | Privacy |
|---|---|---|---|
| Parakeet (Default) | Fast | Free | 100% on-device |
| Whisper (Local) | Varies by model | Free | 100% on-device |
| OpenAI | Fast | Your API key | Audio sent to OpenAI |
| Groq | Very fast | Your API key | Audio sent to Groq |
Whisper models and Parakeet use CoreML for on-device processing. No API key is needed for local engines.
5 Smart Syntax
Wispert understands coding. Over 40 spoken phrases convert to symbols and formatting automatically:
{
]
userName
=>
Smart Syntax mode (OpenAI GPT models) handles inline code symbol conversion with context awareness for Swift, JavaScript, TypeScript, and shell commands.
6 App-Aware Profiles
Wispert automatically switches profiles when you change apps. Built-in profiles include:
Each profile has tailored insertion methods and processing settings. You can customize or create your own profiles.
7 History & Export
Search your transcription history with full-text search. Each record includes metadata:
- Transcription engine and model used
- Recording duration
- Target application context
- Timestamp
Export to Text, CSV, or PDF. History is encrypted at rest with AES-256-GCM and protected by biometric authentication.
History is automatically deleted after 30 days (configurable). Secure erasure is used when deleting records.
8 Hotkeys
Configure your recording trigger:
- Keyboard shortcuts
- Modifier keys (e.g., Right Option — the default)
- Mouse buttons
Configure hotkeys in Settings > Hotkeys. You can set different hotkeys for different recording modes.
9 Custom Dictionary
Create custom spoken-word replacements for technical terms, product names, or formatting shortcuts. Import and export your dictionary to share across setups.
Configure in Settings > Dictionary.
10 Privacy Mode
Enable Privacy Mode for zero data retention: automatic memory clearing, no history saved. When disabled, standard encrypted storage applies.
Toggle in Settings > Privacy & Security.
11 Support
Need help? Contact us:
support@ioi.net.au