// troubleshooting guide · bettertouchtool

BetterTouchTool Gestures Stop Working After Sleep

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

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

  1. FIX 1Restart BTT

    1. 01Click the BTT menu bar icon and choose Quit
    2. 02Reopen BTT
    Did this fix it?
  2. FIX 2Try the restart-after-wake option

    1. 01Open BTT Preferences > Advanced
    2. 02Enable restarting BTT after wake from sleep (results vary)
    Did this fix it?
  3. FIX 3Update to the latest alpha

    1. 01Preferences > Advanced > update channel
    2. 02Check for updates and retest
    Did this fix it?
  4. FIX 4Isolate conflicts

    1. 01Quit other input tools such as Logitech Options or Karabiner
    2. 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 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 →