// troubleshooting guide · hyperkey

Hyperkey Conflict With Karabiner or BetterTouchTool

Status
Workaround available
platforms:
macOS
updated:
November 18, 2026
reports:
2
Method
how we research
Share

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

  1. FIX 1Use one remapper

    1. 01Quit BetterTouchTool and Karabiner-Elements and test Hyperkey alone
    2. 02If it works, remove their Caps Lock rules
    Did this fix it?
  2. FIX 2Prefer Karabiner for complex workflows

    1. 01If chained shortcuts are slow, switch back to Karabiner's Caps Lock to Hyper rule
    2. 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

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

Fixed it? Share this guide

Other Hyperkey errors