// troubleshooting guide · bettertouchtool

BetterTouchTool Blocks Keyboard and Mouse Clicks

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

RUNBOOK · bettertouchtool/blocks-keyboard-and-mouse4 FIXES

// quick answer

A Tahoe 26.2 report shows mouse clicks and keyboard input frozen until BTT is quit. Quit BTT, update to a newer build and check crash logs in Console.

Most likely fix: Quit BTT to restore input

How to fix it

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

  1. FIX 1Quit BTT to restore input

    1. 01Use Command-Tab or Activity Monitor to quit BTT
    2. 02Input should return immediately
    Did this fix it?
  2. FIX 2Update to the latest build

    1. 01Download the newest release or alpha from folivora.ai
    Did this fix it?
  3. FIX 3Disable Touch Bar items

    1. 01Remove custom Touch Bar items if BTT crashes on launch
    Did this fix it?
  4. FIX 4Send crash logs

    1. 01Open Console.app > User Reports and find BTT crash logs
    2. 02Post them on community.folivora.ai
    Did this fix it?

Symptoms

Cursor moves but clicks and typing do nothing until BTT is terminated.

Why it happens

  • C-01Bug in an older BTT build on a new macOS
  • C-02Conflict with input device drivers
  • C-03Custom Touch Bar items causing crashes

// this guide also covers

  • bettertouchtool keyboard not working
  • bettertouchtool mouse clicks not working
  • bettertouchtool crashing

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

The same problem in other apps

All audio, video & device problems guides →

Other BetterTouchTool errors

All 11 BetterTouchTool errors and fixes →