Skip to content

kzkr/voysnap

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VoySnap — press the right Command key, speak, and your words are typed for you.

VoySnap

License Platform 100% local

Press. Speak. Done. Your voice belongs on your Mac.

Press the right ⌘ key, speak naturally, press it again, and your words are transcribed on-device and pasted into whatever app you're using.

No cloud. No account. No subscriptions. No word limits.

How it works

1. Press to record — a native CGEventTap catches a quick tap of the right ⌘ key. The menu-bar icon turns red.

2. Speakmalgo captures your mic at 16 kHz, fully on-device.

3. Press againwhisper.cpp transcribes locally with Metal acceleration, over 30× faster than real time.

4. Done — your text is pasted into the active app and copied to your clipboard.

Nothing leaves your Mac. The right ⌘ key still works normally as a modifier in keyboard shortcuts — only a quick standalone tap triggers dictation.

Why VoySnap

🔒 Private by design — every transcription happens on your Mac. Your voice never leaves your device.

💸 Free forever — open source, no subscriptions, no API keys, no limits.

Blazing fast — Metal-accelerated whisper.cpp on Apple Silicon transcribes faster than you can re-read it.

🌍 Multilingual — auto-detects the language you speak and writes it back in that language.

🪶 Invisible — a tiny menu-bar app. Zero onboarding, zero accounts, zero distractions.

Install

curl -fsSL https://raw.githubusercontent.com/kzkr/voysnap/main/install.sh | bash

That's it — no Xcode, no Go, no build step. The installer drops VoySnap.app into /Applications, downloads the speech model (~1.5 GB) on first run, and launches it.

On first launch, macOS asks for two permissions:

  • 🎤 Microphone — to hear you.
  • Accessibility — for the global hotkey and automatic pasting.

That's it.

Build from source

Requires macOS 13+ · Apple Silicon · Homebrew · Go 1.24+ · CMake · Xcode Command Line Tools (xcode-select --install).

git clone git@github.com:kzkr/voysnap.git
cd voysnap
make install

make install builds whisper.cpp, downloads the model, signs the app, and installs it into /Applications. The first build takes a few minutes; after that it's nearly instant.

Usage

  1. Put your cursor where you want to type.
  2. Tap the right ⌘ key — the menu-bar icon turns red.
  3. Speak.
  4. Tap right ⌘ again — your text appears.

Text is pasted exactly as Whisper transcribes it, including punctuation and capitalization. When nothing editable is focused — e.g. on the desktop — VoySnap shows the result in a popup and leaves it on your clipboard instead.

Configuration

VoySnap works out of the box. To customize it, edit ~/Library/Application Support/VoySnap/config.json:

Key Description
language "auto" (default), or a code such as "en" / "fr"
model_path path to a different whisper model
vocabulary custom words, names, or jargon to recognize better
snippets { "spoken phrase": "replacement" } text expansions

All transcription runs locally via whisper.cpp. See CLAUDE.md for architecture and design notes.

License

MIT

About

Press. Speak. Done. Your voice belongs on your Mac.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages