Skip to content

t2o2/local-whisper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

25 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

LocalWhisper

Local voice-to-text for macOS
100% offline β€’ Apple Silicon optimized β€’ Menu bar app

CI Latest Release License


A macOS menu bar app for local speech-to-text powered by WhisperKit. Press a hotkey, speak, and text appears in any app β€” no internet required.

Quick Start

Install (Recommended)

  1. Download the latest .dmg from GitHub Releases
  2. Open the DMG and drag LocalWhisper to your Applications folder
  3. Open LocalWhisper from Applications
  4. Grant Microphone and Accessibility permissions when prompted

Note: On first launch, you may see "unidentified developer" warning. Right-click the app and select "Open" to bypass this.

Install from Source

git clone https://github.com/t2o2/local-whisper.git
cd local-whisper
swift build && swift run

Use

  1. Grant Microphone and Accessibility permissions when prompted
  2. Hold your shortcut key (default: Ctrl+Shift+Space) to start recording
  3. Speak while holding the key
  4. Release to stop recording and transcribe

Text is automatically typed into your focused app.

Features

  • 🎀 Global Hotkey β€” Hold to record, release to transcribe (default: Ctrl+Shift+Space)
  • πŸ”’ 100% Offline β€” All processing on-device, no data leaves your Mac
  • ⚑ Fast β€” CoreML + Neural Engine acceleration on Apple Silicon
  • πŸ“ Auto-inject β€” Transcribed text typed directly into focused field
  • πŸ“– Custom Dictionary β€” Add words/names for accurate transcription of technical terms, proper nouns, etc.

Requirements

  • macOS 14.0+ (Sonoma)
  • Apple Silicon (M1/M2/M3/M4)
  • 8GB RAM minimum (16GB+ for large models)

Configuration

Click the menu bar icon to:

  • Change keyboard shortcut
  • Select transcription model (tiny β†’ large-v3)
  • Add custom vocabulary (product names, technical terms, proper nouns)
  • Adjust settings

Custom Dictionary

Add words you want transcribed correctly in Settings β†’ Custom Vocabulary. This helps the model recognize:

  • Product names (e.g., "WhisperKit", "CoreML")
  • Technical terms (e.g., "Kubernetes", "PostgreSQL")
  • Proper nouns (e.g., names of people, places, companies)

Tip: Works best with larger models (small, medium, large-v3). The dictionary provides spelling hints, not instructions.

LocalWhisper Settings

Documentation

  • Model Guide β€” Model comparison, benchmarks, recommendations
  • Architecture β€” Project structure, development guide

Privacy

All transcription happens locally. No audio is sent over the network. No analytics or telemetry.

License

MIT

Acknowledgments

About

πŸŽ™οΈ Local voice-to-text for macOS. 100% offline

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors