README.md
August 15, 2025 ยท View on GitHub
VoiceTypr
Open Source AI Powered voice to text dictation tool, alternative to superwhisper, whispr flow
Download โข Features โข Installation โข Usage
๐ฏ What is VoiceTypr?
VoiceTypr is an open source AI voice-to-text dictation tool, alternative to Wispr Flow and SuperWhisper. Available for macOS and Windows. Pay once, use forever.
โจ Features
๐๏ธ Instant Voice-to-Text
- System-wide hotkey for quick recording
- Automatic text insertion at cursor position
- Works in any app - cursor, claude code, chatgpt, slack, etc
๐ค Powered by local AI
- 100% offline transcription - your voice never leaves your device
- Multiple model sizes for accuracy vs speed tradeoffs
- Support for 99+ languages out of the box
- Hardware acceleration (Metal on macOS)
๐ Native Performance
- Built with Rust and Tauri for blazing-fast performance
- Optimized for each platform with hardware acceleration
- Minimal resource usage with maximum efficiency
๐ Privacy First
- Complete offline operation - no cloud, no tracking (only trial check)
- Your recordings stay on your device
- Open source for full transparency
๐ค AI Enhancement (NEW)
- Transform your transcriptions with AI (Groq/Gemini)
- Smart presets: Prompts, Email, Commits, Notes
- Secure API key storage
- Requires internet connection for enhancement only
๐จ Clean Design
- Clean, user interface
- Menubar integration for quick access
- Visual feedback during recording
- Auto-updates to keep you on the latest version
๐ฆ Installation
Requirements
macOS
- macOS 13.0 (Ventura) or later
- 3-4 GB free disk space (for AI models)
- Microphone access permission
- Accessibility access permission
Windows
- Windows 10/11 (64-bit)
- 3-4 GB free disk space (for AI models)
- GPU acceleration available (5-10x faster with NVIDIA, AMD, Intel GPUs)
Quick Install
macOS
- Download the latest VoiceTypr.dmg
- Open the DMG and drag VoiceTypr to Applications
- Launch VoiceTypr from Applications
- Follow the onboarding to download your preferred AI model
Note: VoiceTypr is fully signed and notarized by Apple, so you can run it without security warnings.
Windows
- Download the latest VoiceTypr installer
- Run the installer
- Launch VoiceTypr from Start Menu
- Follow the onboarding to download your preferred AI model
GPU Acceleration (5-10x faster)
- VoiceTypr automatically uses your GPU if available
- For best performance, ensure your graphics drivers are up to date:
- Falls back to CPU automatically if GPU unavailable
๐ฎ Usage
Getting Started
- Launch VoiceTypr - Find it in your Applications folder (macOS) or Start Menu (Windows)
- Grant Permissions - Allow microphone access (and accessibility on macOS)
- Download a Model - Choose from tiny to large models based on your needs
- Start Transcribing - Press your hotkey anywhere to record
Tips & Tricks
- ๐ฏ Quick Cancel: Double Press
Escwhile recording to cancel - ๐ Long Recordings: VoiceTypr handles extended recordings seamlessly but shorter recordings are recommended to do.
- ๐ Multiple Languages: Just speak - Whisper auto-detects the language
- โก Instant Insert: Text appears right where your cursor is
Project Structure
voicetypr/
โโโ src/ # React frontend
โ โโโ components/ # UI components
โ โโโ hooks/ # Custom React hooks
โ โโโ types/ # TypeScript types
โโโ src-tauri/ # Rust backend
โ โโโ src/
โ โ โโโ audio/ # Audio recording
โ โ โโโ whisper/ # Whisper integration
โ โ โโโ commands/ # Tauri commands
โ โโโ capabilities/ # Security capabilities
โโโ scripts/ # Build and utility scripts
โโโ tests/ # Test suites
๐ง Troubleshooting
Windows GPU Acceleration
VoiceTypr automatically detects and uses your GPU for faster transcription. If you're experiencing slower performance:
Update your graphics drivers - This is the most common fix:
Note: VoiceTypr always works - it automatically falls back to CPU if GPU acceleration is unavailable
๐ License
VoiceTypr is licensed under the GNU Affero General Public License v3.0.