// troubleshooting guide · bettertouchtool

BetterTouchTool Not Working After macOS Update

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

RUNBOOK · bettertouchtool/not-working-after-macos-update4 FIXES

// quick answer

After a macOS update BTT often loses its Accessibility permission. Remove it from the Accessibility list, add it again and relaunch; if that fails, reset its permissions with tccutil and restart.

Most likely fix: Remove and re-add the Accessibility permission

How to fix it

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

  1. FIX 1Remove and re-add the Accessibility permission

    1. 01Quit BetterTouchTool from the menu bar icon
    2. 02Open System Settings > Privacy & Security > Accessibility
    3. 03Select BetterTouchTool and click the minus button
    4. 04Relaunch BTT and grant access when prompted, or add it with the plus button
    Did this fix it?
  2. FIX 2Check Input Monitoring

    1. 01Open System Settings > Privacy & Security > Input Monitoring
    2. 02Remove BTT if it is listed in a broken state
    3. 03Relaunch BTT and approve prompts
    Did this fix it?
  3. FIX 3Reset BTT permissions from Terminal

    1. 01Quit BTT
    2. 02Run: tccutil reset Accessibility com.hegenberg.BetterTouchTool
    3. 03Restart the Mac, then grant the permission again
    4. 04Save your work first; some users report freezes during the reset
    Did this fix it?
  4. FIX 4Update to the latest BTT build

    1. 01Open BTT > Check for Updates
    2. 02If the bug persists, try the alpha channel in Preferences > Advanced
    Did this fix it?

Symptoms

Gestures, shortcuts and window snapping do nothing even though BTT is running and shows as allowed in System Settings.

Why it happens

  • C-01macOS dropped or corrupted the Accessibility entry after the update
  • C-02BTT is also listed under Input Monitoring in a broken state
  • C-03Running an old BTT build that does not support the new macOS
  • C-04A stale permission from a previous copy of the app

// this guide also covers

  • bettertouchtool not working after update
  • bettertouchtool stopped working
  • bettertouchtool sequoia
  • bettertouchtool tahoe not working

Still not working?

If BetterTouchTool keeps failing, you're not alone. See every BetterTouchTool 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 BetterTouchTool 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 BetterTouchTool errors

All 11 BetterTouchTool errors and fixes →