Skip to main content
Most rejected shortcuts fail for one of three reasons: no modifier key, a combination your operating system has already claimed, or another app got there first. OpenWhispr tells you which when it refuses. Set shortcuts under Settings → Hotkeys under App.

​
The rules

The app shows these in a Shortcut Guide next to the hotkey field:
  • Use at least one modifier — Ctrl, Alt, Shift, Cmd, or similar.
  • Three keys maximum. Four-key combinations are rejected.
  • Single keys on their own aren’t allowed. The exception is the macOS Globe key, which is handled separately.
  • Reserved system shortcuts are blocked. Each platform has its own list.
  • Some combinations may still conflict with whatever else you run — those can’t be predicted, only tried.

​
The one principle worth knowing

Pick a combination that types nothing. A hotkey is held down while you talk, sometimes for a minute, in whatever app you’re already typing into. If it ever slips through — a moment before the app grabs it, a window that doesn’t give it up — a combination ending in a letter puts that letter in your document. A combination made only of modifier keys can’t. That single test explains why the defaults are what they are, and it’s a better guide than any list.

​
What to use

In every case the default is the recommendation. If dictation is working, there’s no reason to change it — the reasons to change are a physical conflict with something you use constantly, a keyboard without the key, or wanting the same shortcut across two machines with different layouts.
Modifier-only combinations like Ctrl+Win are fully supported and are what the app ships with. You don’t need a letter on the end.

​
What to avoid

  • Win+H on Windows — that’s Windows’ own voice typing shortcut. Binding it puts two dictation systems on one key.
  • Cmd+Space on macOS — Spotlight, and the default for several popular launchers besides.
  • Anything ending in a common letter with one modifier — Ctrl+S, Cmd+F and their neighbours mean something in nearly every app, and most are blocked outright.
  • Caps Lock. Some dictation tools use it; OpenWhispr doesn’t support it.
On Linux, three combinations shown in the app’s own Shortcut Guide — Super+S, Ctrl+Alt+D and Alt+Space — are on the reserved list and will be refused when you try to set them. Use the table above instead. We’re fixing the in-app list.

​
What the errors mean

When a shortcut is rejected the app offers up to three alternatives inline. They’re a fixed per-platform list rather than a check of what’s free on your machine, so treat them as a starting point and not a guarantee.
If you want a single key with no modifier and you’re on a Mac, the Globe/Fn key is the one designed to work that way — and it’s already your default. Everything else needs a modifier.

​
If it registers but doesn’t do anything

That’s a different problem — the shortcut saved fine and something is intercepting it, or a permission is missing. See my hotkey doesn’t work.