Troubleshooting
Fixes for the problems people actually hit.
Warble needs Accessibility access to see the key. Open System Settings → Privacy & Security → Accessibility and make sure Warble is on. The menu bar icon shows a lock while it waits for this.
After rebuilding Warble from source, macOS can treat the new build as a different app. If the switch is on but nothing happens, remove Warble from the list with the minus button and add it again.
In System Settings → Keyboard, set Press 🌐 key to to Do Nothing. Or pick another hotkey such as Right Option in Warble’s settings.
Another dictation app is listening to the same key. If you used open-wispr before, quit it (and remove its login item) before using Warble.
The first launch needs an internet connection to fetch Parakeet from Hugging Face. Check the connection and press Try Again in the menu bar panel or in setup.
Warble pastes into whatever has keyboard focus when you release the key. Make sure the cursor is in a text field. Some password fields block pasting on purpose.
Capturing system audio needs Screen & System Audio Recording permission. Grant it in System Settings, then quit and reopen Warble.
Still stuck? Open an issue with the output of warble status.