Troubleshooting

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.

Warble is in Hold mode, which records only while the key is down, and the key was tapped. Keep it down until you finish speaking. If you would rather tap once to start and once to stop, switch to Toggle in the menu bar panel or in Settings.

Warble recorded, but only silence. Check Settings → Audio → Listen to: it has to be Microphone (or Microphone + System Audio) for dictation. If it is, pick your microphone explicitly under Microphone and make sure it is not muted. The bars in the pill move with your voice, so if they stay flat, the sound is not reaching Warble.

Warble heard sound but no speech in it: background noise, music, or speech too quiet or too short. Speak a little closer to the microphone and keep the key down until you finish the sentence. If you dictate in one language, pick it in Settings → Dictation → Language instead of Auto-Detect.

Capturing system audio needs Screen & System Audio Recording permission. Grant it in System Settings, then quit and reopen Warble. If the pill says No sound from system audio, check that something was playing while you held the key.