Voxstr Docs

Setup guides, tips, and troubleshooting for Voxstr. Everything you need to get dictating fast - plus a few notes for power users.

Onboarding

Install Voxstr
Download the .dmg, drag to Applications, and pass Gatekeeper on first launch.
Grant permissions
Accessibility, Microphone, and Input Monitoring — what each is for and how to grant.
First-run model download
What downloads on first launch (Parakeet, CTC, Qwen3), why local, and how long it takes.

Getting started

Install Voxstr
Download, grant permissions, and confirm the menu bar icon.
Soon
Your first dictation
Press the hotkey, speak, watch text appear in any app.
Soon
Choosing a hotkey that works for you
Defaults, conflicts with other apps, and how to change it.
Soon

Daily use

Target apps
Where dictated text lands across native apps, browsers, terminals, and chat clients.
Custom vocabulary
Teach Voxstr your acronyms, project names, and domain terms.
Hotkey configuration
Pick a chord, switch between push-to-talk and toggle, dodge system conflicts.

Core features

Custom vocabulary and the teach surface
Add proper nouns, jargon, and names so Voxstr hears them right.
Soon
AI cleanup: what it does and how to tune it
Filler removal, punctuation, and the on-device Qwen3 model.
Soon
Text injection across apps
How Voxstr inserts text into native apps, browsers, and terminals.
Soon

Troubleshooting

Nothing happens when I press the hotkey
Permission gotchas, stuck event taps, and how to reset.
Soon
Transcription is slow or empty
Model download status, ANE warmup, and audio input selection.
Soon
Text lands in the wrong app or not at all
Injection tiers, clipboard fallbacks, and app-specific workarounds.
Soon

Trust & troubleshooting

Privacy and local-first
What stays on your Mac, the four network calls Voxstr makes, and what you can turn off.
Licensing and activation
Trial mechanics, device limits, renewals, cancellation, and refunds.
Troubleshooting common issues
Ten of the most common Voxstr problems with symptom, cause, and fix steps.

Beta program

Redeem your beta promo code
How to claim your $1/mo, $5/yr, or $10 lifetime price as a Wave-1 beta tester.

Reference

Article template
Starting point for new docs articles.

Release notes

All releases
Long-form notes for major Voxstr releases — what shipped and why it matters.
Release cadence (internal)
Author-facing notes on when to write a release article and the publishing workflow.