Support for Logitech MX Master Mice

Hello Andreas
Thanks for good work adding Logitech support!
I am running BTT 6.183 on Mac Mini Tahoe 26.3
I have my “MX Master 3S for Mac” and “MX Keys Mini for Business” connected via a Logitech Bolt receiver on a USB extension as I’m not in range for direct Bluetooth connection.
I have been able to set my Logitech Mouse Configuration and configure custom button actions no problem. I would really like to have a view of battery status but this Javascript is failing:

let battery = await logitech_get_battery_status({ deviceName: "MX Master 3S for Mac" });

ReferenceError: Can't find variable: logitech_get_battery_status

By contrast, this Javascript works fine:

let dpi = await logitech_get_dpi({ deviceName: "MX Master 3S for Mac" });

Device discovery finds both my Logitech devices and logitech_is_running() returns true.

Any suggestions?

Many thanks

The problem returned this morning. I suspect it happened after I woke up my MBP, but I'm not sure. Turning the mouse off/on with the button fixes the issue, so I dont know. :woman_shrugging:t4:

@Emm_Gr if you can send the logs from ~/Library/Application Support/BetterTouchTool/Logs, I think they would help in this case! (andreas@folivora.ai)

@jamesfpb you are right, I accidentally added a typo to the javascript function. Will be fixed with the next alpha in a few minutes

Yes, I would like to send it, but there’s one thing I don’t understand: the last update of the log file is from February 21. How can I force BetterTouchTool to create a new log update?

you mean the file date? That is irrelevant, the content of the log files is updated continuously

Oh, okay, I'm sending it to your email now. My BTT just crashed about 10 minutes ago at 8:10 UTC. Before that, the mouse wasn't working properly.

I’m on Tahoe 26.3 usng a MX Master 3S and MX Keys.

When I wake from sleep or restart, I get none of my custom BTT commands for the MX Master 3S

It’s almost like Better Touch Tools doesn’t detect it. Quitting and re-opening and manually re-scanning for devices does not fix it.

The mouse itself works. I can get it back working after a few rounds of force quitting and/or restarting the Mac.

If this is related: alongside this, I’m also experiencing that BTT itself won’t kick-in on wake. Most common way to tell for me is my Caps Lock Hyper Key doesn’t work.

I don’t know if this is tied to Logi integraiton (Eg: Using MX Keys), but I believe the way I bound the Hyper Key is the vanilla recommendation.

  1. Process helper installed and active.
  2. Restart BTT on wake enabled.
  3. Uninstalled LogiOptions using recommended command; no processes active in ActivityMonitor
  4. Setapp BTT - latest available version on the Setapp platform (6.183)
  5. 2021 MacBook Pro M1 - Tahoe 26.3

Works excellently when it works, but currently my issue is that it doesn’t.. :joy:

Any other steps I missed to get this going?

Wow - you did it for the G203 LIGHTSYNC and it works! Thank you so much!!! So cool. :star_struck: One thing I noticed with this mouse is that the LED brightness setting works for the breathing function, but not for the Fixed Color - that seems to be always full brightness. But no big deal - super awesome!

Hey Andreas,

Sorry for delay in getting back to you. Can confirm - I’ve had no issues since. It works immediately every time I switch on, not even a second delay. Thank so much as always!

Hi Andreas
I am using BTT 6.220 on Tahoe 26.3 with “MX Master 3S for Mac” connected by Bolt receiver, no trackpad.
I am trying to trigger actions with long hold and release from different mouse buttons (no modifier). I’m having very mixed results:

  • Rightclick - works fine
  • Middle button - not working at all for this usage (though I have been able to trigger actions from a straight click)
  • For buttons 3,4,6,7 (forward, back, thumb, top) - I can trigger actions from mouse down but get no reaction from mouse up.

I’d really like to be able to hold down the top button to open the application switcher and choose an application by releasing the mouse button over my choice. This only works for me with Rightclick at the moment but this is not a good button choice for my objective because of the button’s other common uses.

Any advice?

Thanks

sounds like you might still have some other mouse related app installed, is that possible? The 3S should definitely be working fine!

If not, could you share some screenshots of your config?

1 Like

I got it working correctly now I think. My symptoms mainly down to not understanding the difference between the BTT window switcher and the Mac application switcher and just being too new to some of the click config. Too ready to assume the problem related to the new Logitech functionality :slight_smile:
Thanks

Hi Andreas,

How can I best help debug this issue, or what’s the process to follow?

First of all, THANK YOU times a million for adding the full MX Master Mouse support! I am BEYOND THRILLED.

That being said, I am having some confusion in getting my buttons configured. I did download the example set (https://folivora.ai/releases/mx_master_example2.bttpreset) to help with this, but that actually added a new piece of confusion that googling is not solving:

There are actions assigned to the “Gesture Button” and actions assigned to the “Thumb Button”. I…am a little lost. As far as I can gather, these would be the same button with different names, right? And both the Gesture Button and Thumb button actions are based on drags.

The gesture/thumb button on my 3s is acting really strangely. Most frequently it’s shooting the pointer up into the top corners. But it’s also made the volume work a few times (but accelerates louder and softer sooo fast it’s not realistically usable - I nearly blew my speakers multiple times). It has not done any of the other actions assigned to the Gesture or Thumb buttons in the preset.

I do not have any conflicting actions of my own as far as I can gather, but it’s also really hard to tell, because when I look at the triggers from the example preset, the buttons are named, but when I click on my group of MX Master 3s actions, they are numbered. I’m comparing apples to oranges here.

Is there any chance you have a map of the buttons that have both their names and their numbers? I think that would help me troubleshoot a lot before asking further questions, and I’d love to see this on the Logitech mouse support documentation page. Thanks!

Hi Andreas,

I am using BetterTouchTool 6.194. After selecting the MX Master 3 configuration, how can the scroll distance per ratchet step be increased? Currently the scrolling distance is much smaller than the default.

@ars747 you can use scroll modifiers: Scroll Modifiers | BetterTouchTool Documentation (e.g. add the smooth scroll modifier or alternatively the distance per tick or scroll speed modifier)

@PurpleAshleigh ah you are right, the dedicated gesture button was only added with the mx master 4 so the preset doesn't fully match - I missed that. Have you tried just setting your basic functions manually? The presets are mostly to show what is possible but I'll create a better one for the 3 and 3s later today!

@jamie9090 as far as I know all sleep related issues have been resolved in the more recent alpha versions

Thanks! Yeah I can go back to doing it manually. I just felt a little stuck and thought the example preset could help. Will delete then.

Also, not sure if you missed my final question: Do you have a map (like the screenshot or even a list) of the names of the buttons paired with their button number in BTT? They don’t match the screenshot and I think this would help my confusion a lot.

the difference is because in the preset I named them for the MX Master 4 which has the extra gesture button. When I upload a new preset for the 3 / 3S I'll name them correctly for these mice. (But the names are just manually entered by me as notes in the preset)

1 Like

Well that’s the thing…without the names entered, they’re just button numbers in the system - and when I go back to reference the system to remind me how to trigger something, I don’t know which button that number is referring to.

An alternative would be to name the button in every single configured action in the notes, but that does feel like a lot of extra work TBH

Oh wait, are you saying you’ll name them in the app or just the preset?