Development Overview Thread

[Andreas_Hegenberg]

Development Overview

This collects links to posts that describe changes in recent versions.

Scroll To Bottom To See Latest Changes

[Andreas_Hegenberg]

Version 5.487

Floating menus now have a right-click context menu that allows to edit some of the properties. This is a work in progress and only for convenience. The full config will continue to be in the BTT preferences window.

Archived:

Version 5.480

Animationless desktop switch

Found a way to do spaces switches without animation without disabling SIP. I'll add it with the next alpha 5.480. (in a first step I'll only add move space left/right, but I should be able to make it go to a specific space without animation as well) [image] (it's not completely without animation but it's very short)

Floating menus to behave like a normal window + few other observations

I made some changes, however I think I had never implemented window.close(), maybe this worked previously by accident. I think I can add support for it, or you could instead call the hide floating menu action: let menu = { BTTMenuActionMenuID: "TheNameOfTheMenuYouWantToClose" }; let result = await trigger_action({ json: JSON.stringify({ BTTPredefinedActionType: 387, BTTAdditionalActionData: JSON.stringify(menu) }), wait_for_reply: true }); //edit: I have implemented wi…

Version 5.461

BTT Clipboard Manager Development & Wishlist

With 5.460 the showing / hiding should now also make use of the new architecture I have implemented. It should now really be almost instant. Everything is now loaded lazily even if you have tens of thousands of items performance should not be impacted. Memory usage is also reduced signifcantly.

WebView - how to get the floating menu window focused ?

I fixed some focus related things in 5.460 alpha, maybe that also helps in you case!

Version 5.435

Floating menus: Tooltips on buttons

good point. I initially discarded this because the system native tooltips won't work with BTT floating menus due to technical limitations. However with v5.434 I added custom tooltips, you can enable them like this: "Use Identifier As Tooltip" [image]

Webview - Menu item name does not save

Hallo @Andreas_Hegenberg , Describe the bug The Web item menu item name is not saved anymore... Screenshots [Menu item name] Device information: BetterTouchTool version: 5.430 / 5.432

Clicking to edit and delete action bugs

So I'm not sure why it displays the second "ghost" action, but I know what caused the action selection issue (a bug in the latest version related to triggers that have been set up > 1.5 years ago (or copied from an old trigger)) 5.432 should fix this.

Floating menu button layout glitch !!!

Would be great if you could try with 5.430. I have completely rewritten the layout algorithm because the old one < 5.429 was causing incorrect item sizes in some scenarios.

Version 5.400

Set a variable and use it for subsequent "Delay next action" actions

I added something that might help with such stuff in 5.400 alpha. You can now transform any action sequence to a "Run Real Java Script" action by selecting the actions and choosing "Transform to Java Script: To get a number variable you'd use let variableValue = await get_number_variable("variableName")

Move Mouse Cursor to selected items in Finder

In 5.399 I have added an option to the "Trigger Context Menu Item" to use the context menu for the current selection instead of the context menu at the current mouse position: [image]

Version 5.376

New variables screen:

Scripting variables screen

I have added a pin button to the variables with 5.376 [image] Polling the "On demand" variables is disabled by default now because that uses a lot of CPU for some of them.

clipboard manager improvements

BTT Clipboard Manager Development & Wishlist

I think ChatGPT just helped me figure out a potential performance issue and also came up with a better high performance solution. This will also allow for more dynamic search. It will require a bit of refactoring, I'll try to adapt this as soon as possible. For now I have added a hidden max item setting in 5.377 (run while BTT is quit): defaults write com.hegenberg.BetterTouchTool BTTNumberOfItemsToKeepInHistory 1000 Note: items are only deleted on BTT startup (regardless of …

The Snippet Manager could be improved

unfortunately opening more than one of these windows is hard with the current architecture, you can however detach views: [image]

Version 5.356

• Floating Menu Items got a new option "Visible If Variable Is True"
• Floating Menu's can now be placed based on the Dock frame
• Floating Menu Items do now have a "on button press" and "on button release" action categories
• Now Playing info should be returned better again

Version 5.338

Floating menus now support auto-updating variables (on Mac, BTT Mobile will follow next)

Floating Menu item button, flash on click?

In 5.338 alpha I made it so the hover effect is disabled while clicking. This leads to some visual feedback when clicking a button.

Version 5.328

This version significantly changes the action selection / search, hoping to make it easier to find actions.

Siri Remote lacks love

I have added on / off actions in 5.328 alpha. (uploading)

Version 5.326

Change the preview shorcut

this should be resolved in 5.326 alpha (uploading)

Version 5.322

BTT Mobile Testflight Beta

The next build (will be released later today after review has finished) adds basic support for the iOS Shortcuts app. It allows you to trigger named triggers on your Mac or run Apple Script & Java Script on your Mac. [IMG_402B3DFECB38-1] With support for Shortcuts, you can use Siri to trigger BTT functionality or create some buttons on your home screen to trigger functionality on your Mac without opening the BTT Mobile app.

Interesting "Bug" with ChatGPT app

I think that crash should be fixed in 5.322 alpha

Version 5.313

stream deck question

ah I see. Could you check whethe that is fixed with 5.313 alpha? (uploading now)

Find/ Search image on screen & Move Mouse, mixed up options

you are absolutely right, fixed in 5.312 (uploading) (It worked when searching specific windows, but on whole screens it failed because the coordinates are inverted there)

Version 5.309

• Fixed an issue with conditional activation groups while the system's "Secure Input Mode" was active or when BTT was set to "Use old keyboard shortcut implementation".

CAG not working

ah the issue is you have this option enabled: "Always use old keyboard shortcut implementation". Is there a reason for that? It really should only be used in very specific cases where all other options fail. [image] However it's also a bug as this should really work with the old implementation as well. It should be fixed in 5.309 alpha (uploading now)

Version 5.292

BTT Mobile Testflight Beta

Keep in mind: This is a beta. App Store release is planned for End of June - it will be a free companion app to BetterTouchTool. Completely customizable & scriptable dashboards on your iPhone, iPad or VisionPro [mockuuups-iphone-16-mockup-with-laptop-on-black-surface Large] You can join the Testflight beta by opening https://testflight.apple.com/join/hxd3yZXk on your iOS device. There will be at least weekly beta updates until the App Store release. Before using the app have a qui…

Version 5.286

Distributed Notification for change in Focus mode?

5.286 alpha adds a "File or Folder Did Change" trigger to "automations, named & other triggers". I think this one can be pretty useful. It sets these two variables on change: BTTLastChangedFileOrFolder BTTLastChangedFileOrFolderChangedType

Version 5.282

Clipboard Contents Did Change calls forever

5.282 should fix the issue. Also added a predefined action to delete specific items from the clipboard manager, so now you can do something like this: [image] [image] (if transformation happened, delete the second item from the clipboard manager) Example JS: async function doSomething() { let clipboardContentString = await get_clipboard_content({format: "NSPasteboardTypeString"}); if(clipboardContentString.length > 0) { let newContent = clipboardContentString + "something"; s…

Now Playing is no longer working on MacOS 15.4

ah the previous build didn't update the variables golden chaos used correctly, this should be fixed in 5.284 alpha For sharing, either screenshot or right-click the widget => export to file

Version 5.279

Now Playing is no longer working on MacOS 15.4

I have just implemented some workarounds in BTT 5.279 alpha (uploading). Would be great if you could check whether this works for you. It is much more complicated than before and currently doesn't support all apps but I'll add support for more in the next days.

Version 5.275

Disabled Drawing mouse gesture still overrides the trigger systemwide

Should be fixed in 5.276 alpha (uploading now, available in ~10min)

Disabling groups via action

that duplication sounds like a bug, I'll have a look. thanks for all the details! If in doubt, set both BTTEnabled and BTTEnabled2

Straight line gestures

@Mark_K ah yes if you have the NW/SW/SE/NE lines in addition it can still be problematic. I have implemented a "short circuit" for straight line gestures, but it wasn't enabled yet. In 5.274 alpha you can try it by naming your gestures either up, down, left, right, up-left, up-right, down-right, down-left or south, north, east, west, north-west, north-east, south-west, south-east In my tests this has worked well. Maybe I'll add it explicitly to the recording UI. [image]

Version 5.268

BTT Clipboard Manager Development & Wishlist

Ah there was a problem with the search predicate in some situations. Should be better in 5.268

Version 5.267

Floating menu is behaving weird

could you check whether 5.267 helps?

Two Apps on the same combination

the recent alpha versions added a variable called "BTTLastTriggeredKeyboardShortcut. You could create a condition based on that. Best use BTT 5.266 or higher [image] [image] fnR.bttpreset (7.5 KB)

Version 5.265

Passing text item value to a paste custom text

with 5.265 alpha you can copy the UUID of your text field item (right-click it in the BTT configuration UI), then use this in the paste action (with your UUID): (BTT)@variable:4F14398B-E174-479F-8BFE-9EB55347868E(BTT)

Floating menus to behave like a normal window + few other observations

you could add the script after the "copyToClipboard()" call. Moving the window via the standard actions doesn't work because floating menus in general exclude themselves from macOS Accessibility (this is important for menus that don't behave like normal windows). However maybe I can change this for the "floating menu with titlebar" usecase. //edit, 5.265 should not exclude menus from Accessibility if they have a standard titlebar

Save as function fails saving in designated name

Can you check whether this works again in 5.265 alpha? I think there was a small change in a recent version of macOS that broke this. (uploading now)

Version 5.262

Focus issue with the floating window

Could you try v5.261? Also make sure to enable this in the webview settings if you have not already: [image]

Clipboard Manager is not working

ah this is due to the way your Touch Bar preset adds the clipboard widget (it's in a disabled group which is being forced shown). You can workaround it by either adding any other trigger to show the clipboard manager (e.g. a keyboard shortcut) or by upgrading to 5.260 alpha which I'm uploading now

Version 5.258

Would it be possible to remember device's UUID on "Position On Screen" setting?

Yes it should be solved in 5.258, it should now show "Previously Saved Display" with the old saved UUID

Version 5.256

Focused element sometimes not changed in Conditional Activation Group

I think there might have been a potential display issue that caused the variable value display to not update, should be resolved in 5.256

Version 5.253

BTT Clipboard Manager Development & Wishlist

sorry for slow replies, I had caught a really bad flu - took me out for a week ... slowly recovering now I'll look through the things you posted, the animation should be disabled now in 5.253 (uploading)

Floating menu is behaving weird

there were a few more caching related issues, I hope 5.253 resolves them. While some basic caching is still automatically applied, the full menu caching (which also increases memory usage) is now optional. It should only be needed for very large menus: [image]

Version 5.252

Allow 'Show Menu Bar in Context Menu' to be 'filtered' to only certain Menu/Sub-Menu/etc

In 5.252 I added an option for the predefined action "Show Menu Bar In Context Menu" to show a specific submenu: [image]

Version 5.248

Floating menu is behaving weird

Ah I think I missed one spot, can you try again with 5.248? (uploading)

AppleScript: `reveal_element_in_ui` does not accept `shared_secret`

should be resolved in 5.248

Two UI bugs related to the "Groups & Top Level Triggers" search

This is fixed in Version: 5.248 (2025030304) and possible few version before that one.

Version 5.247

Floating menu is behaving weird

I think I accidentally applied the new caching mechanism to submenus in the recent alphas. Could you check whether it works again in 5.247 ? (uploading)

Version 5.246:

Urgen Help needed, open Folder leads to immediate crash

in 5.246 I have added one more sanity check to ignore negative image sizes.

Version 5.243:

Changes on multiple buttons deletes text - and no UNDO?

I did work on this a bit more and was able to change the behavior to something that might be better. With 5.243 if you select multiple items it will show a dummy text like this: [image] You can then change the formatting of that dummy text and it will not change the actual text - only the formatting.

[Andreas_Hegenberg]

Version 6.040:

• new predefined actions: "Start Smooth Scroll", "Stop Smooth Scroll", "Start Smooth Zoom", "Stop Smooth Zoom", "Start Smooth Rotate", "Stop Smooth Rotate"
• fixes for custom move resize action:

"Custom Move / Resize Window" BTT: 6.038 issue

Ah weird, then for some reason BTT identifies the incorrect display with the "1 screen left" option for some reason (maybe because they are the same model), I'll check!

• fixed a timing issue for the "choose from list" action:

Custom search engine

Actually you can use this interface. Here is an example. It makes use of the "Use First Word To Filter & Save Rest Of Input To Variable BTTPromptInput" [image] NOTE unfortunately something recent must have introduced a little timing issue for this function, which is why this example requires BTT 6.037 to work (uploading now). search.bttpreset (1.9 MB) ( this preset imports a keyboard shortcut cmt+opt+ctrl+S that shows the list) [image] [image]

Version 6.034

The Smooth Scroll Modifier now supports trackpad like swipes (e.g. to go back a page in Safari, delete e-mails in Mail or scroll horizontally in Calendar):

Support for Logitech MX Master Mice

@JDDD I think I figured out how to make the calendar & mail scroll work (super complicated). Would be great if you could try 6.034 alpha (uploading now). It requires the "smooth scrolling (like trackpad)" scroll modifier to be active: [image] It basically transforms the scroll events to touch events - Apple made the calendar app to explicitly not allow horizontal scrolling for normal mice so we need to simulate trackpad events, which is very complex.

The trackpad like zoom and rotate scroll modifiers have also been improved slightly

Version 6.023

Scopes For Mouse Gestures / Drawings:

Make It Easier to Trigger Alternate Drawing Flows Based on Mouse Button

#v6.023 alpha adds "scopes" for drawings and for the "start recording drawing" action: For example with this: [image] Only drawings with scope "xxx" would be triggered: [image]

Version 5.780

Support for Logitech MX Master Mice

5.779 adds scroll modifiers. For example there is a "smooth scroll" modifier and "Vertical & Horizontal Scroll Speed Modifier" [image] [image] [image] These are not limited to logitech mice. Multiple modifiers can be added and will automatically be combined. Available modifiers: Smooth Scrolling (like Trackpad) Vertical & Horizontal Scroll Speed Modifier Scroll Modifier Key Condition Scroll Device Type Condition Block Horizontal Scrolling Block Vertical Scrolling Scroll Acceleration Cur…

Support for Logitech MX Master Mice

V5.763 contains the very first implementation of full native Logitech Mouse support that might work. (It might also not, I only tested it with a limited set of mice and configurations). The most important part is the Logitech Configuration Object in BTT's Normal Mouse Section. You need to add one such for every Logitech Mouse you want to use in BTT. Afterwards you should be able to configure your buttons like for other mice. [image] It might currently require a BTT restart after adding and s…

Version 5.600

Buggy Hyperkey functionality after using the MacOS "fn/Globe" key

Ha I think I was actually able to reproduce the issue on my other machine for whatever reason. Could you check whether 5.600 solves the hyperkey after FN issue for you? (uploading now).

Detect current active space number?

In 5.599 alpha I made the active_space and translated_active_space variables observable. This means you can now do this without any scripting (just put it in curly braces - e.g. {translated_active_space}): [image] I also added a new "Active Space Did Change" trigger.

SHIFT SHIFT hungs bettertouchtool in later versions

This should be resolved in 5.598! (uploading now) (was related to a deadlock within the trigger_named_async_without_response call)

Version 5.587

SF Symbol Icon in Finder context menu doesn't comply with dark mode

should be resolved in 5.587, SFSymbols should now adapt correctly to dark mode when used in custom Finder context menu additions!

Issue Saving and Restoring a Window’s Position Using Shortcuts

Hey good point, there actually wee no simple ways to do this for a single window. In 5.579 I added two new actions: Save Focused WIndow Size & Position Restore Saved Size And Position

Type text (insert text by typing) doesn't work with emojis in certain places

It just uses CGEventKeyboardSetUnicodeString for these and let's macOS handle the work of figuring out the internals I think I figured out why some apps like terminal didn't accept emoji. @luisherranz could you check whether 5.585 alpha (uploading now) works in all apps?

Transform & Replace Selection Wtih ChatGPT does't work with "gpt-5" model.

In 5.575 you can now specify extra api parameters. When entering these parameters gpt-5 should become faster: {"reasoning_effort": "low", "verbosity": "low"}

Version 5.566

Force Click Swipe

BTT 5.566 alpha adds a new variable that can be used in trigger conditions "last_trackpad_force". E.g. if you want to have two gestures, a standard click swipe and a force click swipe you'd set up two click swipes. For one you add a condition last_trackpad_force > 500 (for example) and for the other you'd add a condition last_trackpad_force < 500 (the force value is in grams)

Version 5.562

The "Choose From List" action now allows to embed a floating menu at the top

Version 5.513

Crash in latests BTT on macOS 12

I think I found a workaround for now that is integrated in 5.513! However it gets harder and harder to build for macOS 12. (Mostly due to the evolution of Swift & SwiftUI and missing backwards compatibility). BTT already uses some weird tricks to at least be able to build for macOS 12 but I assume I won't be able to do that much longer.

Animationless desktop switch

5.507 should resolve this while still improving the edge cases!

hovered_link variable:

How to open a URL in a specific browser / get hovered link url

This should work (adds a three finger tap that opens the hovered URL via velja): 3_finger_tap_velja.bttpreset (4.1 KB) However requires 5.450 alpha (uploading), because I have just added the hovered_link variable //edit: sorry there was an accidental dot in the preset, should now work

macOS did show notification trigger:

Third-Party Notification Capture

In 5.499 alpha I finally got around and added a native trigger that is monitoring this database based on @fortred2 's code. There is a small delay because the system doesn't immediately write the database to file. [image] This also makes the last shown notifications available as JSON string via variable BTTLastShownMacOSUserNotifications Example of that variable: [ { "app" : "com.apple.ScriptEditor2", "title" : "", "subtitle" : "", "body" : "Zipping app for notarization...…

Help with a shortcut configuration

With 5.511 I implemented the change that should allow for this, here is an example for F1: F1.bttpreset (15.7 KB) They key changes are: 1.) You can now have multiple shortcuts with minimum hold times > 0 [image] [image] 2.) The "Execute Action Sequence After Timeout" action got an option to immediately continue executing the remaining actions in the original action sequence. (This was how it was originally intended but some refactoring a long time ago changed this behavior) [image]

[Andreas_Hegenberg]

Version 6.041

allows to record & recognize two button clicks in the "normal mouse" section. For example pressing button 4 while holding button 1 or button 1 while holding button 4 to trigger actions. If you still want to assign functions to the single button presses, best make these trigger on mouse-up.

Button + scroll also works:

[Andreas_Hegenberg]

Version 6.042

1.) Some new action categories for mouse buttons:

• click (this is what we currently have and will continue to allow further customization for short or long presses and down/up trigger)
• press button & drag down (discrete)
• press button & drag up (discrete)
• press button & drag left (discrete)
• press button & drag right (discrete)
• press button & drag down (continuous)
• press button & drag up (continuous)
• press button & drag left (continuous)
• press button & drag right (continuous)

These are independent of BTT's mouse gestures and specifically optimized for straight lines. Also they won't show any UI when dragging (for now). The discrete ones are for triggering standard actions like cmd+w, the continuous ones are if you want to do something like change volume by dragging a button up/down or zooming in / out.

If you choose the continuous drag action category you can also assign the predefined actions "Start Smooth Zoom", "Start Smooth Scroll" or "Start Smooth Rotate" to zoom, scroll or rotate by dragging up/down.

The continuous category also sets these variables for usage in scripts: BTTDragValue (0-100), BTTDragDeltaX, BTTDragDeltaY, BTTDragButtonNumber, BTTDragUpValue, BTTDragDownValue, BTTDragLeftValue, BTTDragRightValue

[Andreas_Hegenberg]

Version 6.043

adds some more action categories for different click types. All these have been possible before but required fiddling with the advanced click settings:

• Actions Executed On Click Down
• Actions Executed On Long Hold Down
• Actions Executed on Quick Click Release
• Actions Executed On Click Release After Long Hold

If further customization is required, the advanced settings can still be used instead.

[Andreas_Hegenberg]

Version 6.052

Note: Requires macOS 26: I have added a first version of this action "Start / Stop Dictation / Recognizing / Transcribing Speech" that uses Apple's offline SpeechAnalyzer API

You can e.g. configure it to start recording on key down (or mouse down) and end recording on key up so it records while you hold a shortcut/key and pastes once you release the key.

[Andreas_Hegenberg]

With 6.063 the action / trigger categories are displayed differently. Instead of filtering the action list, it now shows all configured action categories and lets you configure new ones with the button on the bottom:

There is currently too much whitespace, I'll make it a bit cleaner with the next alphas.

[Andreas_Hegenberg]

With 6.080 keyboard shortcuts also got support for action categories - this is a huge change so let's hope it doesn't break anything:

@Frank1 might also be interesting for you (although your setups probably require non-standard timing stuff )

[Andreas_Hegenberg]

6.087

Added "Save As Template" feature for floating menus:

[Andreas_Hegenberg]

BTT 6.106

6.106 comes with a completely new implementation of the Stream Deck plugin mode. No more restarting of the Stream Deck software when using plugin mode! It is much more complex now but should also be much more stable.

Other improvements:

• You can now assign the "Start Smooth Space Switch" action to continuous drag actions on normal mouse buttons. This also works for "Start Smooth Scroll", "Start Smooth Zoom" and "Start Smooth Rotate"

[Andreas_Hegenberg]

~v6.150

In the recent versions I was mainly doing invisible work, migrating from old UI technologies (Storyboards) to completely code based UI. This was done out of necessity because the current Xcode builds completely broke storyboard support for me. However it also brings a lot of benefits and will allow me to iterate on the UI faster.

With the migration it was also possible to add the Tahoe styling.

This was a big task with a shitload of code added, there might still be some issues but most things seem to work fine now:

[Andreas_Hegenberg]

v6.173

• Save / Restore Window Layout action can launch apps now - I think I will improve this further soon:
  Can Save/Restore Window Layout also open the app that were part of the layout? - #2 by Andreas_Hegenberg

• The predefined action "Access / Interact With / Click Specific UI Element" can now save the value or description of a specified element to a variable.

• The Stream Deck MK2 with Scissor Keys is now supported

• Floating menu templates can now also be used with specific apps / CAGs and won't be always added to "All Apps" anymore.

• Fixed issue when dragging folders between apps

• Fixed an issue with the "Specific App Did Create Window" and "Specific App Did Destroy Window" trigger. This works also with system apps, e.g. you can use com.apple.notificationcenterui to trigger this whenever notification centers shows a new notification.

• Fixed an issue with native Stream Deck Plugins (GitHub - folivoraAI/BetterTouchToolPlugins: Development of BetterTouchTool Plugins) not triggering action categories like "On Button Release" or long press

[Andreas_Hegenberg]

6.194 adds a new action trigger category for keyboard shortcuts:

"Actions Executed After All Modifier Keys Released"

This is different from the "Actions Executed On Key Release" - which already triggers if the main key involved is released.

So with the following example the "down" HUD would be shown when pressing cmd+shift+a. The "a released" HUD would show when a is released and the "all modifier keys released" would show once a AND cmd and shift all have been released

[Andreas_Hegenberg]

~6.20x

Workaround for Hyperkey Support on macOS 26.4 Beta 1

Hyper Key cannot be set for internal (built-in) MacBook keyboard on MacOS 26.4 Beta 1

I have added support for 26.4 beta 1 hyper key in BetterTouchTool 6.205 alpha. However I wasn't able to verify it yet because I broke my beta machine Would be great if any hyperkey users on 26.4 beta 1 could test it.

---

Fixed issue with menubar status item management
Specifically with clicking status items that have been hidden from the menubar.

---

Fixed an issue related to keeping physically pressed modifier keys in keyboard shortcuts

Regression: unwanted modifier keyup generated despite “Include currently pressed modifier keys”

With the “Include currently pressed modifier keys” option enabled, continuing to hold down a modifier when triggering a shortcut no longer seems to prevent a keyup event being emitted for the modifier. The issue appeared after upgrading from 5.800 to 6.194 and persists with 6.202 alpha. Reverting to 5.800 makes the problem go away, suggesting a BTT regression. I’m using macOS Sequoia 15.7.3. The strange thing is that I’m only experiencing the issue with Firefox, but nothing has changed in the …

---

Fixed an issue related to Logitech Mice after idle/sleep

Support for Logitech MX Master Mice

@spanway I think I found something in your logs again Would be great if you'd test with 6.201 alpha! @Emm_Gr I think this could be the same issue as yours, so hopefully resolved in 6.201 alpha

---

Fixed a rare issue that caused the "Text Selection Did Change" floating menu to be positioned incorrectly

[Andreas_Hegenberg]

6.207

1. Fixes the logitech_get_battery_status JavaScript function for accessing Logitech device battery states.

2. Option to show floating menus on lock screen (thanks @SkyLightWindow)
   

   

3. Added Tahoe compatibility for Notch Bar (still deprecated, but I haven't finished the migration path to Floating Menus yet, so let's keep supporting it for a bit longer)

[Andreas_Hegenberg]

6.210

Floating Menu's now support custom widgets, just drop a .swift file that follows the examples described here GitHub - folivoraAI/BetterTouchToolPlugins: Development of BetterTouchTool Plugins onto the BetterTouchTool window, afterwards (after confirming it shall be compiled & loaded) you will be able to select it from the "Custom Widget Plugin:

Experimenting with AI generated changelog. The following describes what has changed:

Changelog — Version 6.210 (2026022501)

Floating Menu Widgets

• New: Now Playing Widget — A new dedicated now playing widget for floating menus that shows the currently playing track with album artwork, artist, album name, and a real-time progress bar. Options include showing/hiding when paused or when no player is active, filtering by specific music apps, and choosing between cover art, app icon, or both as artwork display.
• New: Weather Widget — A new weather widget for floating menus showing current temperature, high/low, humidity, wind speed, sunrise/sunset times, and moon phase with automatic weather icons. Supports Celsius, Fahrenheit, or auto-detect based on system locale, custom location coordinates, and forecasts for future days.
• New: Custom Plugin Widgets — Floating menus now support custom widgets provided by plugins, allowing third-party or user-created widgets with interactive controls.
• New: Now Playing Widget Template — Added a ready-to-use template preset showcasing the now playing widget, including a version that displays on the lock screen.

Plugin System

• New: Swift Plugin Support — You can now write BetterTouchTool plugins in pure Swift. Simply drop a .swift file into the Plugins folder and BetterTouchTool will offer to compile it into a working plugin automatically. Changes to the source file are detected and the plugin can be recompiled on the fly.
• New: Plugin Trust & Security — All plugins now require user approval before they are loaded. When a plugin is modified, you will be prompted to approve the changes before it can run again.
• New: Hot Plugin Reloading — The Plugins folder is now actively monitored. Adding, removing, or modifying plugins automatically updates the available plugin list without restarting.

AI Chat (h@llo.ai)

• New: Smart Model Routing — Simple messages (like "thanks", "ok", "yes") can now be automatically routed to a faster, cheaper model to save costs and improve response times. You can configure a separate fast model in the AI setup.
• New: Model Fallback Chain — If the primary AI model fails, the assistant can automatically switch to one or two backup models, so conversations are less likely to be interrupted by API errors.
• New: Message Coalescing — When you type multiple messages quickly in a row, they are automatically combined into a single request instead of sending separate API calls.
• New: Custom Skill Editor — You can now create and edit individual AI skills directly from trigger configurations, in addition to managing the global skill library.
• New: Scheduled AI Tasks — Added support for scheduled AI triggers that can run AI tasks automatically on a schedule.
• Improved AI Setup Wizard — The setup wizard now includes configuration for Smart Model Routing and Model Fallback Chain.

Actions

• New: Play Sound action — A new action that plays a system sound or a custom sound file (AIFF, WAV, MP3, M4A, CAF, AAC). Includes a preview button in the configuration and supports selecting from built-in macOS sounds or browsing for a custom file.

Now Playing

• Fixed album artwork on macOS 15.4+ — Album artwork fetching for Apple Music and Spotify has been fixed on macOS 15.4 and later, where the previous method stopped working. Artwork is now reliably retrieved and displayed in widgets and variables.
• Improved artwork persistence — Cover artwork is no longer lost when receiving track change notifications that don't include new artwork data.

Smooth Scrolling

• Improved very slow scroll speeds — Smooth scrolling now supports very slow speeds (e.g. 0.01-0.05), which is great for auto-scrolling while reading. Previously the minimum effective speed was much higher.
• Finer speed control — The speed adjustment step size has been reduced from 0.1 to 0.01, allowing more precise speed tuning.
• Fixed scroll stop animation — Stopping continuous smooth scrolling no longer causes a brief visible "jump" in the opposite direction in some apps.

Logitech Devices

• Faster button setup on reconnect — Logitech device button configurations are now cached, so buttons are configured faster when a device reconnects.
• Improved Craft keyboard crown tap detection — Tap detection on the Logitech Craft crown is now significantly more reliable, detecting the majority of taps that were previously missed.
• Fixed crown mode switching — Switching the Craft crown between smooth and ratchet modes is now more reliable and no longer causes both modes to fire simultaneously.

UI / Preferences

• New: Capture Screenshot in Icon Picker — The icon picker now has a "Capture Screenshot" option, allowing you to take a screenshot of a screen region and use it directly as an icon.
• Improved Stream Deck plugin variable access — Stream Deck plugins can now read and set BetterTouchTool variables directly.

Changelog — Version 6.208 (2026022402)

AI Chat

• Added persistent memory: the AI assistant can now remember important details across conversations, recall relevant context automatically, and forget information on request
• AI memory is initialized automatically when starting a chat — no configuration needed
• Memories are extracted during conversation compaction so useful context is preserved even when older messages are summarized
• The embedding system now falls back to on-device processing when no external API key is configured, so memory search works out of the box

Keyboard Shortcuts

• Fixed modifier keys (Command, Option, Shift, Control, Fn) not being held reliably when using "key down only" shortcut mode — modifiers now persist correctly until the matching "key up" is sent
• Fixed modifier key release events not being seen by some apps (e.g. Electron-based apps like Kando) when using "key up only" shortcut mode — proper key-up events are now posted for each modifier
• Fixed modifiers being prematurely cleared during "key down only" actions, which could cause subsequent key presses to lose their modifier state

Notch Bar / Menu Bar

• Fixed an issue on macOS Tahoe where menu bar items could temporarily disappear from the Notch Bar due to incomplete system data being processed
• Improved reliability of menu bar item detection on macOS Tahoe by using the correct data source for item refresh

HalloAI Trigger

• Added a dedicated trigger selector for HalloAI, making it easier to configure AI assistant triggers, custom AI agents, and custom AI contexts

BetterTouchTool — Version 6.207 (2026022401)

Floating Menus

• New: Show floating menus on the lock screen — Floating menus can now optionally remain visible on the macOS lock screen. Enable the new "Show Menu On Lock Screen (experimental)" option in the floating menu's window level settings.

Notch Bar / Menu Bar Widget

• Improved status icon handling on macOS Tahoe — Status bar icons displayed in the Notch Bar now use a more reliable data source on macOS Tahoe, improving accuracy and reducing refresh delays.
• Fixed clicking status bar items from the Notch Bar — Clicking menu bar icons shown in the Notch Bar is now more reliable, especially on macOS Tahoe where items may be on a different screen.
• Fixed Notch Bar resource files not updating — If the Notch Bar support files were partially installed, they will now be properly refreshed on update.

Hyper Key

• New alternative Hyper Key mode for built-in keyboards — Added an alternate Hyper Key mode method on macOS 26.4+. This mode fully blocks the remapped key from reaching other apps. Enable via the BTTHyperKeyUseAlternateMode advanced setting.
• Force new Hyper Key mode on older macOS versions — The improved Hyper Key handling (normally only active on macOS 26.4+) can now be force-enabled on earlier macOS versions using the BTTForceNewHyperKeyMode advanced setting.
• Fixed Hyper Key cleanup — Switching Hyper Key modes or disabling the Hyper Key now properly removes all previous keyboard remappings.

Window Management

• Improved "Move Window to Space" on macOS 15+ — Moving windows between spaces is now more reliable on macOS Sequoia and later.

JavaScript Integration

• Fixed logitech_get_battery_status function — The JavaScript API function for reading Logitech device battery status was broken and has been restored.

UI / Preferences

• Added HalloAI trigger type support — The preferences window now properly handles the new HalloAI trigger category, including correct filtering and layout.
• Fixed toolbar view mode button layout — The view mode toggle in the toolbar no longer causes layout issues when hidden.

[Andreas_Hegenberg]

Changelog — Version 6.211 (2026022502)

Floating Menu Widgets

• Improved Custom Widget Plugin Selection — Widget plugins are now listed individually in the trigger selector under a dedicated "Widget Plugins" section, each showing the plugin's name and icon. You no longer need to manually pick a plugin from a dropdown after creating a generic custom widget item.
• Improved Custom Widget Descriptions — Custom widget triggers now display the plugin name in the trigger list (e.g., "Widget Plugin: My Plugin") instead of the generic "Floating Menu: Custom Widget" label.
• Plugin Size Preferences — Widget plugins can now specify their own preferred minimum and maximum sizes, which are automatically applied when the widget is displayed.
• Improved Custom Widget Preview — Custom widget plugins now show a placeholder in the floating menu editor preview instead of attempting to render live plugin content, which could cause issues.
• New: Weather Widget — Added a Weather Widget option to the floating menu widget selector.

Floating Menu Configuration

• Improved Plugin Configuration — When a widget plugin provides its own configuration options, those are now shown directly in the trigger settings instead of a generic plugin picker dropdown.