// 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
Share

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

  1. FIX 1Trigger on key release

    1. 01In Keyboard Maestro, set the hotkey trigger to fire on release instead of press
    Did this fix it?
  2. FIX 2Test in isolation

    1. 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 us

Watch Karabiner-Elements Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All audio, video & device problems guides →

Other Karabiner-Elements errors

All 10 Karabiner-Elements errors and fixes →