// 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
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
FIX 1Quit BTT to restore input
- 01Use Command-Tab or Activity Monitor to quit BTT
- 02Input should return immediately
Did this fix it?FIX 2Update to the latest build
- 01Download the newest release or alpha from folivora.ai
Did this fix it?FIX 3Disable Touch Bar items
- 01Remove custom Touch Bar items if BTT crashes on launch
Did this fix it?FIX 4Send crash logs
- 01Open Console.app > User Reports and find BTT crash logs
- 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 usThe same problem in other apps
All audio, video & device problems guides →
Keyboard Maestro Macros Not Firing (Keyboard Maestro)
Karabiner-Elements Not Working on MacBook Keyboard (macOS Tahoe 26.4+) (Karabiner-Elements)
Other BetterTouchTool errors
- BetterTouchTool Not Working After macOS Update
- 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 Window Snapping Not Working
- BetterTouchTool Keyboard Shortcuts Not Working