// troubleshooting guide · karabiner-elements
Karabiner Hyper Key Not Triggering Keyboard Maestro or BetterTouchTool
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 16, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · karabiner-elements/hyper-key-keyboard-maestro2 FIXES
// quick answer
Forum reports of hyper-key macros failing; one suggested fix is to trigger the macro on key release.
Most likely fix: Trigger on key release
How to fix it
// try these in order, the most common fix is first
FIX 1Trigger on key release
- 01In Keyboard Maestro, set the hotkey trigger to fire on release instead of press
Did this fix it?FIX 2Test in isolation
- 01Disable other remappers while testing
Did this fix it?
Symptoms
Macros assigned to a Karabiner hyper key don't fire reliably.
Why it happens
- C-01Hyper key modifier timing conflicts between tools
// this guide also covers
- karabiner hyper key keyboard maestro
- karabiner hyper key not working
Still not working?
If Karabiner-Elements keeps failing, you're not alone. See every Karabiner-Elements problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usThe same problem in other apps
All audio, video & device problems guides →
BetterTouchTool Blocks Keyboard and Mouse Clicks (BetterTouchTool)
Keyboard Maestro Macros Not Firing (Keyboard Maestro)
Other Karabiner-Elements errors
- Karabiner-Elements Not Working After macOS Update
- Karabiner-Elements Not Working on MacBook Keyboard (macOS Tahoe 26.4+)
- Karabiner-Elements Driver Alert Keeps Showing Up
- Karabiner-Elements Permissions Not Granted (Accessibility, Login Items)
- Karabiner-Elements Caps Lock LED Not Working
- Karabiner-Elements Three Key Combination Not Working
- Karabiner-Elements Control-Eject Shortcut Not Working
- karabiner.json Is Not Owned by a Valid User Error