// troubleshooting guide · bettertouchtool
BetterTouchTool Gestures Stop Working After Sleep
- Status
- Ongoing
- platforms:
- macOS
- updated:
- November 16, 2026
- reports:
- 4
- Method
- how we research
RUNBOOK · bettertouchtool/gestures-stop-after-sleep4 FIXES
// quick answer
Trackpad or mouse gestures can stop after sleep or screensaver. Restarting BTT restores them; the restart-after-wake setting helps some users but not all.
Most likely fix: Restart BTT
How to fix it
// try these in order, the most common fix is first
FIX 1Restart BTT
- 01Click the BTT menu bar icon and choose Quit
- 02Reopen BTT
Did this fix it?FIX 2Try the restart-after-wake option
- 01Open BTT Preferences > Advanced
- 02Enable restarting BTT after wake from sleep (results vary)
Did this fix it?FIX 3Update to the latest alpha
- 01Preferences > Advanced > update channel
- 02Check for updates and retest
Did this fix it?FIX 4Isolate conflicts
- 01Quit other input tools such as Logitech Options or Karabiner
- 02Retest after sleep
Did this fix it?
Symptoms
After waking the Mac, gestures or mouse buttons do nothing until BTT is restarted. Logs may show IOHIDDeviceSetReport errors.
Why it happens
- C-01Input devices are re-enumerated on wake and BTT loses the connection
- C-02macOS freezing the app until a user action
- C-03Conflict with other input utilities
// this guide also covers
- bettertouchtool not working after sleep
- btt gestures stop after wake
- bettertouchtool mouse stops 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 Not Working After macOS Update
- BetterTouchTool Accessibility Permission Not Working
- 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