Skip to content
This repository has been archived by the owner on Mar 11, 2020. It is now read-only.


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


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
April 5, 2018 15:39
April 29, 2018 22:33
July 14, 2018 12:35
February 26, 2018 11:04
April 5, 2018 14:45
April 10, 2018 21:58
April 5, 2018 15:39
June 3, 2018 20:52
September 15, 2018 22:26
February 26, 2018 11:29
February 26, 2018 11:23
October 13, 2018 13:33

BetterTouchTool Touch Bar Presets

Here we collect cool touch bar presets for BetterTouchTool. Feel free to send your own configs in pull-requests. Do not forget to attach a screenshot (⇧⌘6) and write some description to this README.

upd: Repo closed

Much time has passed since the original article was written. BTT author has added many cool features that you can use instead of our hand-made widgets. The bad news: our presets are mostly not working now. At the beginning we tried to update them for each new version of BTT, but there were so many incompatible changes that we gave up. So, just use this article as a guide and you will be able to create something even cooler. I am very proud that we had such an impact on touchbar customization and BTT itself. Thank you, guys!



After installing BetterTouchTool, you can import/export configurations from the Manage Presets button.



@vas3k: vas3k v2.bttpreset

Screenshot1 Screenshot2


  • Smart Finder: opens a new Finder window in any situation
  • Spotify Now Playing: shows the name of the track currently playing in Spotify
  • VK and YouTube Now Playing
  • Top reminder from
  • Weather widget: temperature in current location (install JSON Helper and Location Helper to make it work)
  • Coffee Break: lock screen button :)
  • Convenient Play button: controls only Spotify and iTunes, not all that shit that macOS High Sierra do

@ad: ad_btt.json


Version 2 (with sliders):



Version 3 (System info group, battery info is moved to the group to reduce the consumption of system resources):


Screenshot Screenshot

@ReDetection: redetection_v1.1.json

Screenshot 1 Screenshot 2


  • Click on VK and YouTube widgets opens their specific tab
  • Geeky weather

@podkovyrin: podkovyr_btt.json

Screenshot 1 Screenshot 2 Screenshot 3


  • Auto-hidden next track button

@toxblh: toxblh.json

Screenshot 1 Version 1: toxblh_v1.json

Screenshot 2



  1. Finder
  2. Bright up/down
  3. What now playing for iTunes, Spotify and VOX. Next by press.
  4. I want a coffee!
  5. Weather - Local the weather
  6. Volume up/down
  7. Play/Pause - Work only with iTunes, Spotify and VOX
  8. Battery status
  9. Time - simple a time

@surpher: xcode-dev.json

Screenshot 1

system-controls.json Screenshot 2


  1. Now playing for iTunes, tap to Next
  2. YouTube playing in Safari
  3. YouTube playing in Chrome


  1. Finder
  2. Xcode
  3. Git-Tower
  4. iTerm2
  5. iTunes/YouTube widget
  6. Coffee time!
  7. Volume down/up
  8. Mute/Unmute
  9. Play/Pause
  10. System Controls button group (preset)

@danruss: danruss_btt.json

Screenshot Widgets:

  1. YouTube playing in Chrome
  2. Now playing in Spotify
  3. Reminders: Last Reminder

Presets Left:

  1. Finder
  2. Terminal
  3. Visual Studio Code

Presets Right:

  1. Coffee - Sleep Computer
  2. Volume Down
  3. Volume Up
  4. Brightness Down
  5. Brightness Up
  6. Weather - Weather Icon + Temp F
  7. Time - H:mm

@gillesdubois: gillesdubois_btt.json

Screenshot Screenshot Screenshot

Presets Left:

  1. Finder
  2. Visual Studio Code
  3. iTunes : Now Playing
  4. VPN Status - Tap to connect / disconnect (Tunnelblick)
  5. Weather - Weather Icon + Temp C°

Presets Right:

  1. Brightness Down
  2. Brightness Up
  3. Volume Down
  4. Volume Up
  5. Play / Pause
  6. Coffee - Sleep Computer
  7. Time - H:mm

@pavopax: touchbar-preset.json @ pavopax/dotfiles



  1. Forklift
  2. TextEdit
  3. Emacs (icons)
  4. Notes

Middle widget:

  1. iTunes song, click to jump to next


  1. Play/Pause
  2. Volume down
  3. Volume up
  4. Coffee - sleep screen (not sleep computer)
  5. Time as h:mm a


  1. Hold Fn key to access expanded control strip or press it to toggle BTT/app controls if available, via hack from - search "You can still access the Control Strip..."

@vladionescu: simple_snake.json

Simple Touchbar Emoji Picker


  1. ESC
  2. Emoji picker

Middle widget:

  1. Spotify now playing, click to jump to next

The next song title appears immediately, it doesn't wait for the now playing script to run on its timer


  1. Brightness down
  2. Brightness slider
  3. Volume down
  4. Volume slider
  5. Mute
  6. Lock screen
  7. Day Month Date
  8. 12 hour clock

The brightness/volume up buttons were omitted from the slider in the interest of saving space, and because I use the slider to adjust and not the buttons. The buttons are effectively just icons to remind what each slider is for.

@goldenchaos: View the GoldenChaos-BTT preset on



The default set of keys if nothing is open; Fullscreen button doubles as escape key and always stays docked to the left

Contextual buttons and widgets populate the scrollable container as you open and close corresponding apps; Tap on any widget to open its parent app

Emoji and app switcher widgets take over the scrollable container

Hold down alt/option for an expanded control strip

Currently supported apps:

  • Finder
  • Safari
  • Chrome
  • Firefox
  • iTunes
  • Spotify
  • YouTube (in Safari and as a Fluid app)
  • Reminders
  • Things 3
  • Carrot Weather
  • Calendar
  • Fantastical 2

Full list of features:

  • Designed to completely replace the stock Touch Bar interface
  • Fullscreen button doubles as esc key, always docked to the left
  • Two finger slide on the Touch Bar to change volume
  • Three finger slide on the Touch Bar to change brightness
  • Hold down Volume Down button to mute
  • Hold Option/Alt to expand the function strip
  • Emoji button toggles scrollable emoji widget
  • App Switcher button toggles scrollable app switcher widget
  • Date and Time widget toggles Fantastical 2 menu bar when pressed (uses Fantastical 2's default keyboard shortcut)
  • Weather widget shows condition emoji + temperature in Fahrenheit, toggles Carrot menu bar when pressed (uses Carrot's default keyboard shortcut)
  • Persistent Show Finder button for easy Finder access
  • Persistent Maximize Left, Center Window, and Maximize Right controls for window management
  • Refresh button appears next to Forward and Back buttons if Safari, Chrome, or Firefox is open
  • Media controls and iTunes/Spotify widgets appear only when iTunes or Spotify is running
  • Now Playing widgets show currently playing track info (with album art for iTunes!) or "Paused" if iTunes/Spotify are paused
  • Due Today widget shows reminders from that are due today, overdue, or without a due date
  • Reminders without a due date persist and automatically show the most recently added reminder
  • Next Thing widget grabs your next reminder from Things 3
  • Next Event widget uses icalBuddy to get just today's upcoming calendar events (requires extra configuration)
  • Tap on any widget to open its parent app

Required helper apps:

Media controls configuration:

High Sierra Media Key Enabler with "Pause if no player is running" enabled is strongly recommended. Appropriate media controls are displayed conditionally based on the following hierarchy:

  1. iTunes
  2. Spotify
  3. Safari (YouTube)

If no media player is running, and Safari is open to a YouTube video, only the Play/Pause button will be shown. In any other case, all media controls are available.

Calendar widget configuration

For the Calendar widget to work properly, it must first be edited to include the names of calendars you wish to display. Replace my personal defaults with yours, and make sure you've installed icalBuddy. You can also configure the widget to display events for additional days, for example for up to a week, by changing "eventsToday" to "eventsToday+7".

@williamli (v1): williamli_btt.v1.json

Screenshot Screenshot Screenshot Screenshot

Presets Left:

  1. (AppleScript) Finder, tell Finder to open in focus, switches Space if it has to.
  2. Terminal
  3. Safari
  4. Firefox Developer Edition
  5. SublimeText
  6. Evernote
  7. Notes


  1. (Widget) Show next todo for "Today" (if any) in Things 3, tap to launch.
  2. (Widget + all) Show the next appointment within next 7 days (if any), tap to launch Fantastical 2, can be reprogrammed to launch Calendar. Require free cli app icalBuddy to access Calendar info. Configured to use "Relative Date".
  3. (Widget) YouTube playing in Safari, tap to focus app / tab.
  4. (Widget) iTunes Now Playing, tap to launch iTunes.
  5. (Widget) Spotify Now Playing, tap to launch Spotify.

Presets Right:

  1. (Folder) Emojis 💩
  2. (Folder) App Switcher
  3. (Folder) Media Controls
  4. Ticking Clock - Week Month Date ⌚ Hour:Minute:Second

Media Controls:

  1. Light / Dark mode toggle for MacOS Mojave and Alfred (Alfred macOS / Alfred macOS Dark)
  2. Screen brightness
  3. System volume
  4. Mute
  5. Play

@claydugo: clay-btt.json

Screenshot 1


  1. App Switcher


  1. Open Finder to home directory (will have to edit to your own home directory)
  2. Open current directory in Sublime Text
  3. Open Better Touch Tool Color Picker
  4. Take screenshot and edit in Better Touch Tool
  5. Coffee Break/Lock Screen
  6. Date/Time Widget (Press to toggle Better Touch tool)


@ canato: CanatoAmazingTouchBar.json


  1. Coffe Break: Lock the Screen;

  2. Gmail Icon: Open my Safari and the Gmail page;

  3. Play/Pause: Stop and Play Music in Spotify and iTunes. If nothing is open, it open the spotify (first click) and play music (second click);

  4. Show Music/Video: Here it display the music Spotify/iTunes or the video on Youtube that you are watching/listening;

  5. Weather: Funny here, because it show the weather with a nice icon, I change click the behavior. Don’t open the weather website but clean the trash can;

  6. Battery: If mouse is connect show mouse battery, if not show computer chargin or on power. On Click: Mute/Unmute;

  7. Hour: Show the “current” time, one of the best feats! But when you click I “made it to” take screenshots

  8. Two Fingers Movement: Change the volume

  9. Three Fingers Movement: Change the Brightness

    Medium post for lazy friends

@ ng-vu: btt.json with a Pomodoro clock

ng-vu's Touchbar ng-vu's Touchbar

  1. App Widget: Quickly switch between apps.
  2. Stop/Switch Pomodoro Mode: Stop or change Pomodoro session between work and break.
  3. Start/Pause Pomodoro Clock: Tap to start/pause the Pomodoro clock (need to setup a background command, see more information).
  4. Sleep: Tap to sleep the computer.
  5. Battery: Display battery status.
  6. Mute: Tap to toggle speaker.
  7. Clock: Display current clock.
  8. Two-fingers swipe left/right to adjust speaker volume down/up.
  9. Three-fingers swipe left/right to adjust display brightness down/up.

Useful links


Licensed under the WTFPL license. Full text of the license can be found in the LICENSE.txt file.  ·  GitHub @vas3k  ·  Twitter @vas3k