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:

  1. 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.
  2. Choose a backend — Pick Parakeet (default, on-device), Whisper Local (on-device), or OpenAI / Groq (cloud) in Settings > Transcription.
  3. 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:

Say "open brace" {
Say "close bracket" ]
Say "camel case user name" userName
Say "arrow function" =>

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:

Xcode VS Code Cursor Terminal Safari Chrome Slack Teams WhatsApp Telegram

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