Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Failed to load latest commit information.

I love the Touch Bar. That's why I was so upset that Apple just sat on its useless user interface. So, inspired by Vas3k's popular blog post on the subject, and determined to make good on the promise that Apple broke, I've spent a (ridiculous) amount of time reworking the foundations of the Touch Bar into GoldenChaos-BTT: a true general purpose Touch Bar UI with support for tons of apps that's intuitive enough to make you love your Touch Bar again - or, more likely, for the first time.

Want to buy me a coffee? You can donate here:

Thinking about buying BetterTouchTool because of this preset? Use this link and I'll get 40%. 🙂

Latest stable version: GoldenChaos-BTT 3.563

Verified by the BetterTouchTool developer, thoroughly tested by the community.
Download link not working? Try the GitHub mirror.
(May 29 2021 - Release Notes) Option to disable GC-BTT menu bar item; Fixes for settings window rendering issues; New Presets functionality for multi-config management; Support for AirPods Max; Fixes for AirPods battery display issues; Fixes for Battery Percentage display; New dock badges for Boxy Suite and Facebook Messenger

Latest experimental version: None

Newer features, but less tested. Generally stable, but read the release notes first.

How to install

  1. Make sure you're using the latest version of BetterTouchTool.
  2. Follow one of the two release links at the top of this post and click "Direct import to BTT".
  3. Say yes to BTT when it asks if you want to import the preset.
  4. [Upgrades only] Say yes when BTT asks if you want to overwrite your existing GC-BTT.

You're all set! Use the built-in settings window to customize GC-BTT to your liking.

Want to be notified of new versions? Visit the GC-BTT release thread on the BetterTouchTool forums and subscribe to the thread!

Need help? Head over to the GC-BTT Help and Feedback thread!


Home Strip

The default key set when nothing is open. Fullscreen doubles as escape key; tap for escape, long-press for fullscreen.

Open a browser, and browser controls appear in the Home Strip.

Open more apps to reveal a wide range of dynamic controls and widgets. Close apps to dismiss their controls.

Modifier Menus

Hold command, option, or control to access the app switcher, control strip, or window snapping controls.

Dynamic Menu Bar

Dynamic Menu Bar with three size options lets you dedicate as much or as little space to widgets as you like.

Widget Groups

Widget Groups like Emoji Picker, Browser Tabs, and Language Switcher replace the Home Strip, but not the Menu Bar.

Modal Widgets

Access expanded-view Modal Widgets by long-pressing on Weather, Now Playing, Reminders, Calendar, Volume, and more.

Dock Badges

Dock Badges appear on the left side of the Touch Bar and remain sticky.

Built-in Dock Badge support for all of your favorite third party apps; enable or disable them in the GC-BTT Settings menu.

Dock Badges also support handoff!

Convenient Settings Window

The straightforward GC-BTT Settings panel (⌘⌥⇧P) makes it easy to deeply customize your Touch Bar.

Previous Versions

Only install the latest version unless you have a specific troubleshooting reason. If you do need to install an older version for whatever reason, make sure the version of BetterTouchTool you're running is greater than or equal to the GoldenChaos-BTT version you're installing.


  • Versions 3.186 and earlier require icalBuddy (brew install ical-buddy) for the reminders widgets to work.
  • Versions 3.065-4 and earlier require icalBuddy (brew install ical-buddy) for the calendar and reminders widgets to work.
  • Versions 2.543 and earlier require the Python Requests module (pip install requests) and Locateme (brew install locateme) for the weather widget to work.
  • Versions 2.531 and earlier require the calendar widget to first be edited to include the names of the calendars that you wish to display.
  • Versions 2.516 and earlier require Location Helper and JSON Helper for the weather widget to work. Not compatible with macOS Mojave.

Version History:

I make other cool stuff, too, like Zelda Maps for Breath of the Wild! Check out all my other projects at And thank you for trying out GoldenChaos-BTT! 🙂


The complete Touch Bar UI replacement for BetterTouchTool






No releases published

Sponsor this project


No packages published