Mouse-side-button voice dictation for macOS. Bind speech‑to‑text to your mouse side buttons—talk, click, code.
Toggle voice recording on and off. Press once to start, press again to stop and transcribe.
Sends Enter (or Ctrl+Enter / Shift+Enter). Submit prompts, confirm dialogs—no keyboard needed.
Stops recording and transcribes your speech. The text is typed into the focused app or copied to clipboard.
Fast, accurate speech recognition running locally on CPU via ONNX Runtime. No GPU required.
Runs as a menu-bar accessory—select input devices, toggle Start at Login, and configure from the icon. No Dock clutter.
Types text directly into the focused app. Falls back to clipboard or paste automatically with reason tracking.
All speech recognition runs on-device. No API keys, no cloud dependencies, no data leaves your Mac.
Download VibeMouse-0.2.0.zip from the latest release, extract it, and move VibeMouse.app to /Applications. Notarized and signed—no Gatekeeper warnings.
git clone https://github.com/madeye/VibeMouse.app.git
cd VibeMouse.app
bash build/build_macos_app.sh
open dist/VibeMouse.appThe build script creates a virtualenv, downloads the SenseVoice ONNX model, and packages everything into a signed .app bundle via PyInstaller.
All settings are environment variables. No config files needed.
| Variable | Default | Purpose |
|---|---|---|
VIBEMOUSE_ENTER_MODE | enter | Rear-button submit: enter, ctrl_enter, shift_enter, none |
VIBEMOUSE_AUTO_PASTE | false | Auto-paste when output falls back to clipboard |
VIBEMOUSE_AUDIO_FEEDBACK | true | Play audio feedback sounds for recording events |
VIBEMOUSE_PREWARM_ON_START | true | Preload ASR model on startup |
VIBEMOUSE_FRONT_BUTTON | x1 | Mouse button for record toggle |
VIBEMOUSE_REAR_BUTTON | x2 | Mouse button for enter / transcribe |
Full reference: vibemouse/config.py