// troubleshooting guide · bettertouchtool
BetterTouchTool Not Working After macOS Update
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 16, 2026
- reports:
- 4
- Method
- how we research
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
FIX 1Remove and re-add the Accessibility permission
- 01Quit BetterTouchTool from the menu bar icon
- 02Open System Settings > Privacy & Security > Accessibility
- 03Select BetterTouchTool and click the minus button
- 04Relaunch BTT and grant access when prompted, or add it with the plus button
Did this fix it?FIX 2Check Input Monitoring
- 01Open System Settings > Privacy & Security > Input Monitoring
- 02Remove BTT if it is listed in a broken state
- 03Relaunch BTT and approve prompts
Did this fix it?FIX 3Reset BTT permissions from Terminal
- 01Quit BTT
- 02Run: tccutil reset Accessibility com.hegenberg.BetterTouchTool
- 03Restart the Mac, then grant the permission again
- 04Save your work first; some users report freezes during the reset
Did this fix it?FIX 4Update to the latest BTT build
- 01Open BTT > Check for Updates
- 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 usOther BetterTouchTool errors
- BetterTouchTool Accessibility Permission Not Working
- BetterTouchTool Gestures Stop Working After Sleep
- BetterTouchTool Is Currently Disabled Error
- BetterTouchTool High CPU Usage
- BetterTouchTool High Memory Usage
- BetterTouchTool Blocks Keyboard and Mouse Clicks
- BetterTouchTool Window Snapping Not Working
- BetterTouchTool Keyboard Shortcuts Not Working