STSora Tanaka
Productivity Writer
|Jan 18, 2026|11 min read|14.7K viewsRemote Control & Widgets Overview
Build a custom remote control for your Mac using BTT Remote on iOS. Create widgets, trigger automations, and design a personalized control surface.
BetterTouchTool is the Swiss Army knife of macOS input — trackpad gestures, window snapping, custom widgets, Touch Bar, and remote control from iOS.
By the end of this 11 min guide, you'll have a working BetterTouchTool setup and practical BetterTouchTool workflows you can use immediately.
- Understand what BetterTouchTool does and why it matters for Productivity
- Install and configure BetterTouchTool for your environment
- Build BetterTouchTool-specific workflows with real examples
- Troubleshoot common BetterTouchTool issues with concrete fixes
BTT Remote App Setup
Install BetterTouchTool:
brew install --cask bettertouchtool
- Productivity environment with appropriate permissions
- No prior BetterTouchTool experience needed
- A terminal with true color support
- Git for version-controlling your config
Tip: Verify the installation with btt --version or btt -V after installing.
Building Custom Widgets
BTT has three main areas: Trackpad (gestures), Window Snapping (drag to edges), and Triggers (keyboard/normal). Configure each in the left sidebar.
Here's a foundational configuration to start with:
-- AppleScript via BTT trigger
tell application "Safari"
activate
end tell
- Begin with this config and make small, incremental changes
- Document each setting with inline comments
- Test changes one at a time to isolate issues
- Keep your config in a Git repo for easy rollback and sharing
iPhone & iPad Trigger Actions
With BetterTouchTool configured, these BetterTouchTool-specific workflows will save you time every day:
- Three-finger swipes to switch spaces
- Window snapping: drag to edges for half/full screen
- Custom trackpad gestures per app
- Named triggers callable from scripts
Pro tip: Don't try to adopt everything at once. Start with Three-finger swipes to switch spaces and add more as it becomes habit.
Widget Design & Layout Tips
Once you're comfortable with BetterTouchTool basics, these advanced techniques will transform your BetterTouchTool workflow:
- Per-app gesture profiles
- Remote control from iPhone/iPad
- Custom widgets in menu bar or Touch Bar
- Chain multiple actions per trigger
Connection & Sync Issues
Here are the most common BetterTouchTool issues and how to fix them:
- Gestures not detected? Check Input Monitoring permission
- Window snap not working? Enable in Settings → Window Snapping
- Wrong app gestures? Set to "Specific App" not "All Apps"
- BTT Remote won't connect? Check same WiFi and firewall
Remote Control Mastery
Congratulations — you now have a solid BetterTouchTool foundation. Here's where to go next:
- Explore the official BetterTouchTool documentation for features not covered here
- Join the BetterTouchTool community (GitHub Discussions, Discord, or Reddit)
- Check the related tutorials below for deeper BetterTouchTool dives
- Build your own BetterTouchTool configuration and share it with the community