vvrite

macOS menu bar app that transcribes your voice and pastes the text — powered by on-device AI.

한국어 · 日本語 · 简体中文 · 繁體中文 · Español · Français · Deutsch

1. Press the hotkey (default: Option + Space)
2. Speak — a recording overlay appears on screen
3. Press the hotkey again to stop
4. Your speech is transcribed locally and pasted into the active text field

Prefer hold-to-talk? Switch to push-to-talk mode in Settings and just hold a key — even a single modifier like Right ⌘ — while you speak, then release to transcribe.

Everything runs on-device using MLX. No audio leaves your Mac. The default model also brings strong multilingual ASR support, so supported languages such as Korean, English, Japanese, Chinese, Cantonese, French, German, and Spanish work out of the box.

• On-device transcription — Qwen3-ASR running via mlx-audio, no cloud API needed
• Multilingual-ready — the default Qwen3-ASR model supports language identification and transcription across 30 languages and 22 Chinese dialects, and vvrite does not lock transcription to a single language
• Global hotkey — trigger from any app, configurable in Settings
• Two recording modes — toggle (press to start/stop) or push-to-talk (hold to talk, even a single modifier like Right ⌘), each with its own hotkey
• Menu bar app — lives quietly in your status bar
• Recording overlay — visual feedback with audio level bars and timer
• ESC to cancel — press Escape during recording to dismiss without transcribing
• Auto-paste — transcribed text is pasted directly into the active field
• Guided onboarding — first launch walks you through permissions and model download

vvrite uses mlx-community/Qwen3-ASR-1.7B-8bit, which is an MLX conversion of Qwen/Qwen3-ASR-1.7B. According to the official Qwen model card, Qwen3-ASR-1.7B supports language identification and speech recognition for 30 languages and 22 Chinese dialects.

That includes Korean, English, Japanese, Chinese, Cantonese, Arabic, German, French, Spanish, Portuguese, Indonesian, Italian, Russian, Thai, Vietnamese, Turkish, Hindi, Malay, Dutch, Swedish, Danish, Finnish, Polish, Czech, Filipino, Persian, Greek, Hungarian, Macedonian, and Romanian, plus regional Chinese dialect support. Because vvrite uses that checkpoint directly through mlx-audio and does not force a fixed recognition language, multilingual dictation works well for the model's supported languages.

• macOS 15+ on Apple Silicon for pre-built .app; macOS 13+ when building from source
• ~2 GB disk space for the ASR model
• ffmpeg installed when running from source
• Microphone permission
• Accessibility permission (for global hotkey)

# Clone
git clone https://github.com/shaircast/vvrite.git
cd vvrite

# Install dependencies
pip install -r requirements.txt
brew install ffmpeg

# Run
python -m vvrite

pip install -r requirements.txt
./scripts/prepare_sparkle.sh
vendor/Sparkle/bin/generate_keys --account vvrite
export SPARKLE_PUBLIC_ED_KEY="..."  # SUPublicEDKey from generate_keys
./scripts/build.sh
open dist/vvrite.dmg

./scripts/build.sh is the supported build path. It performs the PyInstaller build, Sparkle framework embedding, code signing, notarization, stapling, and DMG creation. It requires a configured Apple Developer signing identity, notarytool profile, and Sparkle EdDSA public key.

For release publishing, set SPARKLE_GENERATE_APPCAST=1 to copy the final DMG into dist/sparkle-updates/ and generate appcast.xml. The build script signs appcasts with the Keychain item from SPARKLE_KEY_ACCOUNT (vvrite by default). Upload both appcast.xml and the versioned DMG to the GitHub release; the default appcast URL is https://github.com/shaircast/vvrite/releases/latest/download/appcast.xml.

On first launch, the onboarding wizard will guide you through:

1. Granting microphone and accessibility permissions
2. Setting your preferred hotkey
3. Downloading the ASR model (~1.7 GB)

MIT — see LICENSE for details.

This application bundles ffmpeg, which is licensed under the GNU GPL v3. The ffmpeg source code is available at https://ffmpeg.org/download.html. The ASR model Qwen3-ASR-1.7B-8bit is licensed under Apache 2.0.