Built with Claude Code - AI-assisted development from concept to completion. 🤖
A lightweight macOS menu bar app for fully offline voice dictation. Hold your recording shortcut, speak, and your words appear at your cursor.
- Offline Transcription - Core speech-to-text runs locally with Parakeet on Apple’s Neural Engine
- System-Wide - Works in any application where you can type
- Customizable Shortcut - Hold Right Command by default, or record your preferred shortcut
- Cancel Anytime - Press Escape while holding to cancel recording
- Private - Audio and transcription stay on your Mac
- Accurate - Powered by NVIDIA's Parakeet TDT 0.6B v2 model
- Native macOS - Built with Swift, optimized for Apple Silicon
- macOS 14.6 or later
- Apple Silicon
- Microphone access permission
Install with Homebrew Cask:
brew install --cask zyuapp/tap/just-speakOr download the latest DMG from the GitHub Releases page and drag Just Speak to Applications. The same signed and notarized DMG is used for Sparkle updates.
# Clone
git clone https://github.com/zyuapp/just-speak.git
cd just-speak
# Build with local development signing
make build
# Install an OTA-disabled Just Speak Dev build in /Applications
make installThe Makefile installs /Applications/Just Speak Dev.app with the
com.zyu.just-speak.dev bundle identifier, leaving the production app intact.
It uses an available Apple signing certificate from the local Keychain so the
dev app's microphone and Accessibility grants survive rebuilds. If no suitable
certificate is available, the build safely uses ad-hoc signing and warns that
macOS may request those permissions again.
Local builds are release-optimized but disable production OTA checks and are
not notarized. Tagged public releases retain com.zyu.just-speak, enable OTA,
and are signed, notarized, and published by GitHub Actions.
- First Launch - Grant microphone permission and wait for the Parakeet model download
- Record - Hold Right Command by default and speak
- Transcribe - Release the shortcut to stop and auto-paste
- Cancel - Press Escape while recording to abort
- Customize - Choose Change Shortcut… from the menu bar app
- Update - Download and restart into new versions from the menu bar
- SwiftUI + AppKit - Menu bar app with NSApplicationDelegateAdaptor
- AVFoundation - Native audio recording (16kHz mono WAV)
- FluidAudio + CoreML - Local Parakeet inference on Apple’s Neural Engine
- Native Integration - Uses macOS microphone and accessibility APIs directly
See CLAUDE.md for architecture details and development guidelines.
Third-party attributions and license texts are bundled with the app under
JustSpeak/ThirdPartyLicenses.
- FluidAudio - CoreML speech recognition runtime
- NVIDIA Parakeet TDT 0.6B v2 - English speech recognition model
0 comments
log in to comment.