// troubleshooting guide · bettertouchtool
BetterTouchTool Is Currently Disabled Error
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 16, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · bettertouchtool/currently-disabled3 FIXES
// quick answer
The 'BetterTouchTool is currently disabled' message means the license check failed or the license was blocked. Delete stale .bttlicense files and re-import, or contact the developer.
Most likely fix: Reset the license files
How to fix it
// try these in order, the most common fix is first
FIX 1Reset the license files
- 01Quit BTT
- 02Open ~/Library/Application Support/BetterTouchTool
- 03Delete files ending in .bttlicense
- 04Relaunch and re-import your license
Did this fix it?FIX 2Check trial status
- 01Open BTT Preferences > License
- 02Confirm the license or trial is active
Did this fix it?FIX 3Contact the developer
- 01Email support from folivora.ai with your license details; do not post them publicly
- 02The developer has blocked licenses used on dozens of machines
Did this fix it?
Symptoms
BTT shows a disabled banner and stops responding, sometimes after sleep or after importing a license.
Why it happens
- C-01Old and new license files conflict
- C-02License blocked after use on many machines
- C-03Trial expired
// this guide also covers
- bettertouchtool is currently disabled
- bettertouchtool license not working
- bettertouchtool activation
Still not working?
If BetterTouchTool keeps failing, you're not alone. See every BetterTouchTool problem users report or the alternatives people switch to.
// We build software. Any software.
Paying for apps that don't quite fit? We build exactly what you need.
We're a small team of developers who build custom software fast. Not just tools like BetterTouchTool: web and mobile apps, games, desktop software, AI tools, internal tools: whatever you have in mind. 50+ custom products built for clients so far, and we run our own products too: booking platforms, games, learning apps. See our work
- Web apps & SaaS
- Mobile apps (iOS & Android)
- Games
- Desktop software
- AI tools & automations
- Internal tools & dashboards
- Client portals & booking
- Your own version of any tool
- ✓ Free 15-min call to scope it
- ✓ Price agreed up front
- ✓ Your data, your code
The same problem in other apps
All not loading, error messages & connection guides →
karabiner.json Is Not Owned by a Valid User Error (Karabiner-Elements)
Hammerspoon Cannot Find Application By Name (Hammerspoon)
Other BetterTouchTool errors
- BetterTouchTool Not Working After macOS Update
- BetterTouchTool Accessibility Permission Not Working
- BetterTouchTool Gestures Stop Working After Sleep
- BetterTouchTool High CPU Usage
- BetterTouchTool High Memory Usage
- BetterTouchTool Blocks Keyboard and Mouse Clicks
- BetterTouchTool Window Snapping Not Working
- BetterTouchTool Keyboard Shortcuts Not Working