// troubleshooting guide · hyperkey
Hyperkey Conflict With Karabiner or BetterTouchTool
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 18, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · hyperkey/conflict-with-karabiner-bettertouchtool2 FIXES
// quick answer
Do not run two remappers on Caps Lock. Pick one tool, and disable the other tool's Caps Lock or hyper rule.
Most likely fix: Use one remapper
How to fix it
// try these in order, the most common fix is first
FIX 1Use one remapper
- 01Quit BetterTouchTool and Karabiner-Elements and test Hyperkey alone
- 02If it works, remove their Caps Lock rules
Did this fix it?FIX 2Prefer Karabiner for complex workflows
- 01If chained shortcuts are slow, switch back to Karabiner's Caps Lock to Hyper rule
- 02Quit Hyperkey so it does not also remap
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
Hyper key works randomly, is slow, or breaks only when another tool is open.
Why it happens
- C-01Two apps remap Caps Lock
- C-02BTT input monitoring competing for the key
// this guide also covers
- hyperkey bettertouchtool conflict
- hyperkey vs karabiner
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 us