Common Issues
Permissions
The two macOS permissions Ultra Whisper needs, and how to set them up.
Ultra Whisper needs exactly two macOS permissions. Most "it doesn't work" reports come down to one of these.
Microphone
Required to record audio. If recording produces nothing, check System Settings → Privacy & Security → Microphone and ensure Ultra Whisper is enabled.
Accessibility
Required for both the global hotkey and pasting:
- The global key/flags monitor only receives events while another app is focused when the app is Accessibility-trusted.
- Pasting uses a synthesized ⌘V via
CGEvent, which won't work without it.
To fix:
- Open System Settings → Privacy & Security → Accessibility.
- Toggle Ultra Whisper off and back on.
- Relaunch Ultra Whisper.
After macOS updates, or after replacing the app with a new build, Accessibility trust can silently drop. If hotkeys or paste stop working, re-toggle it first.
Reviewing permissions in-app
Both states are shown under Settings → Permissions, with a button to jump straight to the relevant System Settings pane.