Hello,
I’m experiencing an issue with BetterTouchTool and my mouse Logitech G502 X Plus.
When the Logitech software (Logi Options+ / G HUB) is running, BetterTouchTool correctly detects the side buttons.
However, if I quit or disable the Logitech software, BetterTouchTool no longer detects presses of the following buttons:
The mouse itself still works, but these side buttons are not recognized by BetterTouchTool unless the Logitech app is running in the background.
This makes it impossible to remap or use these buttons in BetterTouchTool without keeping the Logitech software enabled.
Is this a known limitation or a compatibility issue with this mouse?
Is there any workaround or setting that would allow BetterTouchTool to detect these buttons without the Logitech software running?
System Information:
BetterTouchTool:
Mouse:
- Model: Logitech G502 X Plus
Logitech Software:
Thank you for your time and support.
have a look here on how to configure Logitech mice, best use the latest BTT alpha as this is a very new feature. Unfortunately Logitech Options needs to be uninstalled completely for this to work.
Unfortunately Logitech Options+ needs to be fully removed before these can be detected in BTT. (Quitting the logitech software is not enough)
That’s exactly what I did.
I completely removed all Logitech applications, including Logi Options+ / G HUB, and then rebooted my Mac.
After that, BetterTouchTool started detecting some of the buttons, but G7 and G8 are still not detected.
Let me know if there is anything else I should remove (drivers, background services, extensions, etc.) or if you need logs from my system.
Did you already look at the docs I linked on how to setup your Logitech mouse in BTT?
BTT only directly talks to the mouse if such a logitech configuration has been added.
// I'm going to sleep now, in case the docs don't help, you can enable logitech debug mode via this terminal command (quit BTT first)
defaults write com.hegenberg.BetterTouchTool BTTLogitechDebugEnabled 2
Afterwards launching BTT will write all relevant information about the mouse identification to ~/Library/Application Support/BetterTouchTool/Logs - you can send that to me (andreas@folivora.ai)
There have already been G502 X Plus users here that successfully remapped all buttons using BTT. (I only own the G502 Hero myself)
Thank you for the support.
There’s no urgency from my side — you can reply during your working hours.
In the meantime, I’ll try to configure everything again, as it’s possible that I’m doing something wrong.
Thanks again for your help.
One more thing I wanted to add 
Due to my professional background, I managed to reproduce a consistent crash — the application now crashes every time on launch.
I’ll attach the crash log to this message.
BetterTouchTool-2025-12-16-011346.ips (33.1 KB)
Hopefully this will be useful for debugging.
Unfortunately, I wasn’t able to resolve the issue.
I removed everything related to Logitech that I could find. The only thing that initially couldn’t be removed was
com.logi.ghub.hidfilter.dext.
I even disabled SIP in order to completely remove all Logitech-related components, and I also fully removed BetterTouchTool.
After that, I:
-
rebooted the Mac multiple times
-
reinstalled BetterTouchTool
-
updated to the latest alpha version
Despite all of this, the following buttons are still not detected / not working:
So far, I haven’t been able to get these buttons working in BTT.
Let me know if there is anything else I can try or any additional diagnostics you’d like me to provide.
It would also be great to have some kind of mouse battery level indicator available in BetterTouchTool
Oh G-hub indeed seems like a pain to remove. Apparently the only way to get rid of it completely (without disabling SIP) is to run
sudo /Applications/lghub.app/Contents/MacOS/lghub_updater --uninstall
If the com.logi.ghub.hidfilter.dext is still installed, BTT won't receive the events, did you manage to remove that while SIP was disabled? (https://www.reddit.com/r/LogitechG/comments/13yqpqi/lghub_cause_yeti_classic_to_not_be_recognized_by/ )
I’ve tried all of the steps described above, but unfortunately none of them helped — the issue still persists.
com.hegenberg.BetterTouchTool 2025-12-16--02-44-56-593.txt (784.5 KB)
The logs are helpful! It seems like there is some issue with an internal cache, possibly related to the receiver. Would be great if you could check whether 5.806 alpha helps (uploading now) - if not I'll try to get my hands on a G502 X Plus to debug it.
Thank you! It is somehow related to the lightspeed receiver. I have mostly tested with Unifying and Bolt receivers but I think I have a lightspeed receiver somewhere, will try to find it later today!
In 5.807 alpha I fixed one obvious issue visible in your latest log, but it might not be the only one.
I also noticed another issue: after the system wakes up from sleep, the mouse sensitivity (DPI) is lost / reset.
To restore it, I have to open the application and click “Apply settings now”.
I don't have a g502 x plus for testing yet, but I found a g903 that also uses a lightspeed adapter. I figured out why that wasn't working, maybe that fix will also work for the g502 x plus.
It is included in 5.809 alpha
