// troubleshooting guide · hyperkey
Hyperkey Keyboard Maestro Shortcut Not Recording
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 18, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · hyperkey/keyboard-maestro-shortcut-not-recording1 FIX
// quick answer
Keyboard Maestro does not see the hyper key itself; record the shortcut by pressing all four modifier keys physically.
Most likely fix: Record with physical modifiers
How to fix it
// try these in order, the most common fix is first
FIX 1Record with physical modifiers
- 01Click the hotkey field in Keyboard Maestro
- 02Press Control, Option, Shift and Command together with the target key
- 03Test by holding the hyper key and the same key
Did this fix it?
SANDBOX · hyperkey RUNS IN YOUR BROWSER
Try it: build a workflow, map fields, turn it on and watch the usage meter
A hands-on Hyperkey-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
The recorder shows nothing or the wrong shortcut when you press the hyper key.
Why it happens
- C-01Recorder expects real modifier keys
// this guide also covers
- hyperkey keyboard maestro
- hyper key keyboard maestro not recording
Still not working?
If Hyperkey keeps failing, you're not alone. See every Hyperkey problem users report or the alternatives people switch to.
Done fighting Hyperkey? Our small team builds your own Hyperkey alternative, or any software you need: web, mobile, games, desktop. Price agreed together.
Talk to usThe same problem in other apps
All audio, video & device problems guides →
Karabiner-Elements Not Working on MacBook Keyboard (macOS Tahoe 26.4+) (Karabiner-Elements)
BetterTouchTool Blocks Keyboard and Mouse Clicks (BetterTouchTool)
Keyboard Maestro Macros Not Firing (Keyboard Maestro)