Troubleshooting
Mic or hotkey not working
Check OS permissions first. Then check hotkey conflicts. The pill tells you which one of the two is failing.
If the pill stays idle when you press the hotkey
- Open Settings β Shortcut. Press your hotkey while looking at the page. If the page doesn't react, another app is intercepting the hotkey.
- Look for system-wide shortcuts that match (Windows: Settings β Keyboard. macOS: System Settings β Keyboard β Shortcuts).
- Look for app-level shortcuts that match (e.g. some games grab Win + Alt for in-game overlays).
- Change Dimmy's hotkey to a different combo: see Change your hotkey.
If the pill goes red right after recording starts
That's a microphone error. Hover the pill to see the exact reason.
- Check the microphone permission in your OS settings (see Permissions).
- Check that the selected microphone is the right one in Settings β Audio. Some laptops default to a HDMI mic when a monitor is plugged in.
- Test the microphone outside Dimmy: macOS QuickTime β New Audio Recording, Windows Voice Recorder, Linux gnome-sound-recorder.
- If the test mic works elsewhere but not in Dimmy, restart Dimmy. The audio device list is cached at launch.
image Β· placeholder
If recording works but transcription is empty
Was this helpful?
In this category
Troubleshooting
Empty, wrong, or slow transcription
Three different problems, three checks: silence in the audio, wrong language detected, model or provider mismatch.
Troubleshooting
Install warnings: macOS Gatekeeper, Windows SmartScreen, Linux AppImage
The OS may warn the first time you run Dimmy. These warnings are expected for indie apps. Here's how to bypass them safely.
Last updated: 2026-05-22