BetterTouchTool 3.562 (May, 4, 2021)
BetterTouchTool 3.560 (March, 10, 2021)
BetterTouchTool 3.553 (January, 26, 2021)
BetterTouchTool 3.551 (January, 25, 2021)
BetterTouchTool 3.540 (January, 17 2021)
The release notes are also always available via
BetterTouchTool 3.508 (November, 27, 2020)
BetterTouchTool 3.505 (October, 14, 2020)
BetterTouchTool 3.503 (October, 11, 2020)
BetterTouchTool 3.402 (August, 11, 2020)
BetterTouchTool 3.401 (August, 8, 2020)
BetterTouchTool 3.400 (August, 3, 2020)
BetterTouchTool 3.372 (May, 11, 2020)
BetterTouchTool 3.365 (April, 23 2020)
BetterTouchTool 3.346 (build 1554) (February, 29, 2020)
  • Various bugfixes
  • Breaking change: if you have script widgets that change their attributes (background color, font color, icon) using a regex you now need to provide an alternate icon as well, otherwise it won't show the icon anymore if the regex is activated.
  • Documentation on has been updated.
  • BetterTouchTool 3.335 (build 1543) (February, 19, 2020)
    Fixed a small issue with named triggers and a issue related to action sequences that contain delays.
    BetterTouchTool 3.333 (build 1541) (February, 18, 2020)
    I didn't post many updates about BetterTouchTool during the last few weeks or even months. This was mostly because we had our first baby and I took some time off to enjoy this amazing time. I'm now fully back to work on BTT, so here is the first official update in 2020 🎉.

    Presets now have their own data folder Java Script for scripting BTT
    Floating WebView Upgrade
    • Updated the documentation on:
    • Switched the Floating WebView to the modern Apple WKWebView. This will allow for some cool new things. In general the floating HTML/Webview has received a big upgrade:
      • You can now run Apple Script or Shell Scripts right from within the WebView - and get the results. See for details.
      • The floating webview can now be made resizable & draggable
      • The floating webview now allows to specify custom z-indexes to e.g. make it float above all or behind everything.
      • The floating webview now allows to go fullscreen - this is great if you want to use it as floating Netflix player and the like.
      • The new webview can overlay full-screen apps. So you can watch some series while working fullscreen on something ;-)
      • Files located in the preset data folder can now be accessed using presetfile://
      • Other local files can be accessed via localfile://
      • BTT actions can be triggered using bttweb://
    People have already started to create cool stuff with the new WebView during the alpha phase.
    See e.g. these examples made by user @yw4z on the community forum.
    Predefined Actions Other small features Bugfixes UI
    BetterTouchTool 3.209 (November, 7, 2019)
    BetterTouchTool 3.207 (October, 24, 2019)
    BetterTouchTool 3.205 (October, 09, 2019)
    BetterTouchTool 3.201 (updated again- sorry had to quickly fix a stupid little bug) (September, 12, 2019)
    BetterTouchTool 3.182 (updated) (August, 20, 2019)
    BetterTouchTool 3.170 (updated) (August, 2, 2019)
    BetterTouchTool 3.148 (updated) (July, 16, 2019)
    BetterTouchTool 3.108 (July, 08, 2019)
    BetterTouchTool 3.05 (June, 3, 2019)
    BetterTouchTool 3.04 (May, 28, 2019)
  • Fixes some issues introduced with 3.00/3.01. Especially the broken clipboard manager, which should now be working again (and behave better with Microsoft Office apps :-)). Btw. if you are not using a clipboard manager - definitely have a look at the predefined action "Show Clipboard History". It is one of my most used features in BTT.
  • There might be a few more updates coming the next few days, as the 3.00 release was massive and I'm sure more little issues will be discovered by you all. Sorry about that!
  • BetterTouchTool 3.01 (May, 27, 2019)
    BetterTouchTool 2.814 (April, 29, 2019)
    BetterTouchTool 2.727 (March, 15, 2019)
    BetterTouchTool 2.717 (February, 2, 2019)
    BetterTouchTool 2.697 (January, 15, 2019)
    BetterTouchTool 2.687 (December, 30, 2018)
    BetterTouchTool 2.667 (December, 15, 2018)
    • Fixed an issue with Trial versions that expired too soon.
    • Added a control strip button widget (allows you to add your own custom control strip icon and define what happens on tap)
    • Added some additional Touch Bar visibility controls to the app specific settings
    • Some adjustments for the "Now Playing" Touch Bar widget
    • Some little changes to the action/gesture selector popover in the preferences
    • Added "display order" to the Touch Bar item configuration options. This allows you to define the order in which items will appear if they are merged e.g. from different activation groups.
    • A lot of work on the new UI (it's not yet visible, for more information please follow I hope I'll be able to release it very soon)
    BetterTouchTool 2.660 (November, 6, 2018)
    • This should fix an issue where BTT wouldn't work correctly after waking from long sleep on macOS Mojave.
    • Fun fact: This week BetterTouchTool is 9 years old - crazy! (First release was on November 7, 2009)
    • News: I'm currently spending most of my time implementing a completely new user interface. If you want to join the discussion, have a look at I plan to release the new interface in 4-8 weeks (it will be optional at the beginning).

    BetterTouchTool 2.644 (September, 29, 2018)
    • Some more improvements for macOS Mojave, especially relating to Dark Mode, but also other areas.
    • Added predefined action "Capture & Edit Screenshot or Video", which uses the new macOS Mojave capture tools
    • Improved responsiveness of moving & resizing actions (e.g. when moving windows using modifier keys)
    • Fixed various bugs in the "Normal Mouse Tab"
    • Fixed an issue with Snap Areas

    BetterTouchTool 2.643 (September, 24, 2018)
    • Improved compatibility with macOS Mojave, which was released today.
    • Fixed window snapping issue with Chrome 69
    • Worked a bit on general Touch Bar settings and improved the defaults
    • Added "Small Step" actions for brightness up and down
    • Fixed issues with the "Switch To Preset" action and added an additional "Toggle Enable/Disable Preset" action
    • Trying to fix an issue where the Touch Bar wouldn't appear after sleep. There is an experimental checkbox in the advanced "General Touch Bar settings" that you can try in case you still encounter issues
    • Fixed a few import issues

    BetterTouchTool 2.636 (September, 1, 2018)
    • A small recovery update to fix an issue introduced in BTT 2.618 that could lead to unresponsive shortcuts in some situations.
    • Added a native "Now Playing" widget for the Touch Bar.

    BetterTouchTool 2.618 (August, 23, 2018)
    Summary: This new version is quite powerful, it contains many improvements for the Touch Bar, a new feature called Conditional Activation Groups and various stability & performance improvements. 2.606 is a quick recovery update that includes a fix related to the shell script widgets.

    1.) Touch Bar:
    • Note: to make BTT more flexible it is now using a custom Touch Bar button implementation, unfortunately in some cases this may change the margins you have previously defined. Also this version completely changes the data model for the Touch Bar stuff, in case you run into any issues please report them.
    • New native weather widget. Powered by Dark Sky
    • New native "now playing" widget. (For iTunes, Spotify, Safari and others).
    • Touch Bar haptic feedback can now trigger when touching AND when the action is triggered, which feels much nicer.
    • Option to set corner radius per item and to choose where to apply it
    • Option to set font color and font-size per item
    • You can now right-click a Touch Bar widget and save all associated icons as PNG
    • Time Zone for Date Widget can now be chosen by location name
    • Weather and Time/Date widget can now use "System Defaults" for units and timezone.
    • Animations for opening groups (can be disabled in the general Touch Bar settings)
    • Battery widget can now be hidden while charging
    • Emoji Widget is now just one endless scrolling list that should behave much faster. Most used emoji are sorted first.
    • Emoji Widget now allows you to define your favorites.
    • Touch Bar items are now cached completely after they have been shown once. This slightly increases RAM usage but improves CPU usage and responsiveness.
    • Users have shared some AMAZING Touch Bar presets on
      One of the most complete and powerful is the preset by user GoldenChaos, but there are also many others. I definitely recommend to have a look there and see whether you like any of them!
      Some GoldenChaos screenshots:

    2.) Conditional Activation Groups
    This version adds a very powerful new feature called "Conditional Activation Groups". Until now you could only create global and app-specific settings in BTT. With conditional activation groups you can create settings that apply to groups of apps, to specific window titles and more. This even allows you to create website specific setups by matching the title of a website (this gets easier if you use a browser plugin that appends the host of a website to the window title, like
    3.) Other
    • Fixed DND action on macOS 10.13 and higher
    • Fixed an issue that could cause multiple items in BTT to have the same UUID. This had previously led to very weird behavior in some cases. This version may change the UUID of some of your items to fix this.
    • Fixed some import issues
    • Haptic feedback on Mojave is now the same as on High Sierra again.
    • Predefined Actions: Added "Toggle True Tone" action (only works on supported Macs)
    • Scripting: Fixed persistent variables issue
    • Various little fixes and improvements for macOS Mojave.
    • Added option to match for "executable path" in the new conditional activation groups.
    • Improved first start experience by reducing the number of popups.
    • BTT now uses a separate database file for every new version, so downgrading will be easier in the future.
    • This version of BTT cleans up the BTT folder in ~/Library/Application Support/BetterTouchTool and creates a zip file containing various backups.

    BetterTouchTool 2.536 (July, 26, 2018)
    • Fixed an issue with importing presets
    • Improved memory handling / memory usage
    • Hopefully fixed an issue with recent macOS versions that could lead to random, unpredictable freezes.
    • Touch Bar groups can now be configured to "Keep open while switching between apps"

    BetterTouchTool 2.530 (June, 27, 2018)
    • macOS 10.14 beta compatibility. In case it doesn't start on your machine, go to System Preferences => Security & Privacy => Privacy => Accessibility and delete it using the "-" button. Then add it again to that list./li>
    • New community forum: and connected preset sharing service (beta)
    • This should fix a long standing issue that caused window snapping to behave incorrectly for some apps (e.g. Firefox, Slack) if a screen reader or an app that emulates a screen reader was active.
    • Fixed compatibility with some apps that couldn't be recognized in BTT before. These problematic apps need to be added to the list of BTT's apps by selecting them from the "List of running apps"
    • Added predefined actions "Show HUD Overlay" and "Perform Haptic Feedback"
    • Added variables support to the BTT scripting functions. Documentation is available on The new available functions are:
      • set_persistent_string_variable
      • set_string_variable
      • set_persistent_number_variable
      • set_number_variable
      • get_number_variable
      • get_string_variable
    • Slider widgets now trigger their assigned action when sliding them.
    • Fixed some issues with Apple Scripts triggering other BTT Apple Scripts
    • Fixed encoding issues with integrated webserver
    • Many internal changes and bugfixes.
    • Clipboard Manager can now filter by favorites
    • Fixed an issue with four finger taps on the trackpad
    • Fixed an issue with the floating HTML view
    • Fixed a few issues with scripting BTT.
    • Fixed various import & export related things.

    BetterTouchTool 2.513 (June, 3, 2018)
    • New community forum: and connected preset sharing service (beta)
    • Fixed various import & export related things.
    • Apple Script actions & widgets can now use either standard Apple Script or Java Script for Automation.
    • Apple Script actions & widgets can now run Apple Scripts inputted as source, or Apple Scripts provided using a scpt file
    • Hopefully fixed an issue with keyboard shortcuts when switching between Secure Input mode and normal mode.
    • Improved app-specific Touch Bar showing/hiding behavior.
    • You can now set colors for presets
    • About screen shows how long the registered license will receive free updates.
    • Small bugfixes

    BetterTouchTool 2.503 (May, 9, 2018)
    • Added a message about the new EU data privacy laws and updated the privacy policy on my website. There might be some more updates to the privacy policy during the next few weeks. In that case I'll inform you.
    • Added Touch Bar Gestures: Two Finger Swipes, Three Finger Swipes and Four Finger Swipes. They can easily replace some brightness / volume sliders. Just assign the predefined actions "Volume Up/Down" or "Brightness Up/Down". See the documentation for more info.
    • Added option to repeat assigned actions for Touchpad & Magic Mouse Gestures while there are still fingers touching the trackpad after triggering the gesture (see
    • Added option to trigger another Named Trigger after no fingers are touching the trackpad anymore (after triggering a Touchpad Gesture). For example this allows to trigger a middle-click down when doing a three finger click (with the custom click action) and a middle-mouse-click up when removing all fingers from the trackpad. (see
    • Added a "visible checkbox" to the Touch Bar tab. This allows you to temporarily disable/hide Touch Bar items. It also allows you to hide Touch Bar Groups that you only want to open using the predefined action "Open Touch Bar Group"
    • The JSON Import/Export can now also include all general preferences (optional).
    • Improved the "Other" tab in BTT.
    • Named triggers can now show the overlay HUD
    • Fixed an issue with Dropbox Sync.
    • Fixed an issue where modifier keys may unhide the BTT Touch Bar permanently
    • Fixed an issue where Apple or Shell Scripts assigned to a Touch Bar widget would trigger twice in some cases.

    BetterTouchTool 2.467 (April, 28, 2018)
    • Added the most powerful window resizing action ever. It's called Custom Move/Resize Window and it can basically resize and move your windows to any position on any of your screens. It should allow for almost all use cases and is highly customizable. (e.g. if you want an action to move windows between monitors - that's the one for you). In case it doesn't cover your use case - please let me know and I'll check if I can support it.
    • Improved the Floating HTML Menu/Web View a lot, it's now faster and more powerful. It can now trigger actions without flickering. See the BetterTouchTool documentation for more information on how to set this up. You can now set a custom user agent if needed and it can open URLs in the system browser if wanted. You can also right-click the web-view and select "inspect element" to open the Safari dev tools
  • Added predefined action "Paste specific items from Clipboard Manager", which can be useful in some cases.
  • Fixed issue with very low resolutions.
  • Fixed issue with recording drawing gestures.
  • Fixed an issue where Apple Script execution could freeze BTT
  • You can now set a shared secret that must be passed whenever one of the scripting functions is used. This can be set in the advanced preferences.
  • Added scripting ability for to delete triggers from BTT ("delete_trigger")
  • More preparations for the launch of the "preset sharing platform". I think I now have everything ready, so I aim to launch this platform sometime next week :-)

    BetterTouchTool 2.444 (April, 17 , 2018)
    • This is a pretty powerful update and the first BetterTouchTool version created by my new company folivora.AI GmbH. (folivora are sloth, and the ai is a specific kind of sloth :-)). Our new Website is and we will offer services and improvements around open sourced BetterTouchTool and other apps . If you are a Setapp customer: BetterTouchTool is now also available on Setapp. Andreas Hegenberg (me) keeps the old versions created by heim available via so others can also build on them.
    • Predefined actions: Added new powerful, fully customizable floating WebView/HTML menu. This allows you to create whatever kind of overlay menu you want with HTML+CSS, and it allows you to trigger any BetterTouchTool action you want. Fore more details please see
    • Other Triggers: You can now specify "named triggers" in the other tab in BetterTouchTool. These can be triggered using the predefined action "Trigger Named Trigger".
    • TouchBar: Repeat Rate & Repeat Delay when keeping a button pressed can now be set.
    • TouchBar: The Script widgets can now return either a string result, or a JSON object with the following keys (all optional): {"text":"newTitle", "icon_data":"base64_icon_data", "icon_path":"file_path_to_new_icon", "background_color": "255,85,100,255"}
    • TouchBar: Option to trigger a "named trigger" on long-press of a button or widget.
    • TouchBar: Script Widgets and Buttons can now be updated using Apple Script, Custom URL Schemes or the new integrated Webserver. Please have a look at the documentation for more details as this is a bit complicated.
    • TouchBar: Fixed various "jumping" issues
    • TouchBar: You can now activate "Always run on becoming visible" for Script widgets. This will execute the script everytime the widget becomes visible, otherwise it will only run in the defined interval (unless no value has been received so far, then it will always run on becoming visible)
    • TouchBar: Script Widget Configuration dialogue can now be resized and supports cmd+z
    • General: Release notes are now accessible from the BetterTouchTool menubar icon
    • Predefined actions: The Move mouse to position action is now much more powerful. It e.g. allows you to move the mouse relative to the default button, relative to all window corners or to the active element in a window.
    • Predefined actions: "Run Terminal Command" now has two variants: one that blocks further execution until the command has finished, and one that runs the command asynchronously (as it was before)
    • Predefined actions: Added predefined action "quit application under cursor"
    • Predefined actions: Fixed issue with "Show Menubar in Context Menu"
    • Predefined actions: Fixed issue with "type text" action
    • General: Added integrated Webserver (disabled by default). This allows you to create super customizable HTML based dashboards (e.g. for use on tablets or android phones). Also it is great in combination with the new floating menu action.
    • General: Completely changed the Apple Script runner service to use significantly lower amounts of memory.
    • Other Triggers: Fixed issue with "Double-Click Window Titlebar" trigger.
    • Fixed some other bugs