Support
Need help? Check the common issues below or reach out directly.
Common Issues
Microphone not working
TranscribeLocal needs microphone access to record audio. To grant permission:
- Open System Settings
- Go to Privacy & Security > Microphone
- Find TranscribeLocal in the list and toggle it on
- If TranscribeLocal doesn't appear, try running the app again — macOS will prompt you for permission
Text not typing after transcription
TranscribeLocal uses Accessibility permissions to type text into your active window. To grant permission:
- Open System Settings
- Go to Privacy & Security > Accessibility
- Click the + button and add TranscribeLocal (or Terminal if running from the command line)
- If TranscribeLocal is already listed, try removing it and adding it again to force a permission refresh
Model download takes too long or fails
On first launch, TranscribeLocal downloads the Whisper language model (~1.6 GB). This requires a stable internet connection.
- Ensure you have a stable internet connection
- The download happens in the background — the app may appear to hang while downloading
- Check the log file at
~/Library/Logs/Vocal/vocal.logfor download progress - If the download fails, restart the app to retry
"TranscribeLocal requires Apple Silicon" error
TranscribeLocal uses Apple's MLX framework which requires Apple Silicon (M1, M2, M3, or M4 chip). It cannot run on Intel-based Macs.
To check your Mac's chip: click the Apple menu > About This Mac. Look for "Chip" — it should say M1, M2, M3, or M4.
License key not working
If your license key isn't being accepted:
- Check that you're entering the key exactly as it appears in your receipt email (including dashes)
- Ensure you have an internet connection for the initial activation
- If you've lost your license key, email us at mthistle@gmail.com with your purchase email and we'll resend it
System Requirements
- Apple Silicon Mac (M1, M2, M3, or M4)
- 8 GB RAM minimum (16 GB recommended)
- ~3 GB disk space
- macOS 13 Ventura or later