// troubleshooting guide · hyperkey

Hyperkey Not Working on Mac

Status
Ongoing
platforms:
macOS
updated:
November 18, 2026
reports:
3
Method
how we research
Share

RUNBOOK · hyperkey/not-working3 FIXES

// quick answer

Hyperkey usually stops working because another remapper captures Caps Lock, Caps Lock's macOS modifier action was changed, or permissions are missing. Check those first, then update the app.

Most likely fix: Quit other remapping tools

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Quit other remapping tools

    1. 01Quit Karabiner-Elements and BetterTouchTool (or disable their Caps Lock rules)
    2. 02Test Hyperkey again
    Did this fix it?
  2. FIX 2Reset Caps Lock in macOS

    1. 01Open System Settings > Keyboard > Keyboard Shortcuts > Modifier Keys
    2. 02Set Caps Lock Key to Caps Lock
    3. 03Retest
    Did this fix it?
  3. FIX 3Re-grant permissions and update

    1. 01Open System Settings > Privacy & Security and check Accessibility and Input Monitoring for Hyperkey
    2. 02Toggle the permission off and on, then restart Hyperkey
    3. 03Download the latest version from hyperkey.app
    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

Holding Caps Lock does nothing or acts as plain Command; shortcuts bound to the hyper combination do not fire.

Why it happens

  • C-01Another remapper (Karabiner-Elements, BetterTouchTool) is capturing the key
  • C-02Caps Lock's modifier action in macOS was changed
  • C-03Missing Accessibility or Input Monitoring permission
  • C-04Outdated Hyperkey version

// this guide also covers

  • hyperkey not working
  • hyper key mac not working
  • hyperkey stopped working

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