Mouser
A lightweight, open-source, fully local alternative to Logitech Options+ for remapping Logitech HID++ mice.
About Mouser
A lightweight, open-source, fully local alternative to Logitech Options+ for remapping Logitech HID++ mice.
What's New in vv3.6.0
Mouser v3.6.0
This one is a pretty practical release: better Linux support, fewer macOS headaches, smaller downloads, and more useful diagnostics when something goes wrong.
The big things: Linux Bluetooth Logitech mice should work much better now, macOS no longer leaks memory during long sessions, custom shortcuts are more reliable, and release packages are smaller and cleaner.
Highlights
- Fixed Linux Bluetooth Logitech detection, including MX Master devices over Bluetooth.
- Added a Linux permissions setup helper with bundled udev rules.
- Fixed a large macOS memory leak in long-running sessions.
- Fixed macOS custom shortcut capture, including Command/Control handling.
- Added an Ignore Trackpad setting for macOS.
- Added full macOS Logi Bolt receiver support.
- Added an About dialog and build/version diagnostics.
- Reduced macOS and Linux release bundle sizes.
Linux
- Fixed Bluetooth Logitech HID++ detection by preferring the Linux
hidrawbackend where needed. - Added support for known Logitech HID devices even when Linux does not report vendor usage metadata.
- Added detailed diagnostics for blocked access to
/dev/hidraw*,/dev/input/event*, and/dev/uinput. - Added a bundled udev rule and
install-linux-permissions.shhelper so users can set up device permissions without running Mouser as root. - Added warnings when Logitech devices are visible but blocked by Linux device permissions.
- Improved selection when multiple Logitech evdev devices are present.
- Preserved required PySide/Qt runtime libraries in Linux builds.
- Improved Linux release workflow smoke-test handling and runtime dependency setup.
- Reduced Linux release artifact size by preserving symlinks and trimming unused Qt payload.
macOS
- Added an Ignore Trackpad setting, enabled by default, so trackpad and Magic Mouse scrolling pass through normally while Mouser keeps handling discrete mouse wheel events.
- Fixed custom shortcut capture on macOS so Command and Control shortcuts are stored and displayed correctly.
- Fixed Enter and Escape capture in the custom shortcut dialog.
- Fixed circular mouse remapping cases, such as mapping
middle -> mode_shiftandmode_shift -> middle. - Fixed a macOS memory leak caused by PyObjC temporary objects in CGEventTap callbacks and foreground app polling.
- Added full Logi Bolt receiver support on macOS, including better receiver slot scanning and Bluetooth-first device selection.
- Improved receiver labeling so only confirmed Bolt receivers show as "Logi Bolt".
- Added a separate Intel macOS release build.
- Reduced macOS app bundle size by trimming unused Qt files while keeping required dependencies.
Shortcuts And Input
- Added support for digit shortcuts like
cmd+shift+3andcmd+shift+4. - Added shortcut aliases like
cmd,command,control, andoption. - Improved shortcut labels so captured and configured actions display more consistently.
- Preserved Smart Shift fallback scroll mode across restarts when Smart Shift is enabled.
Packaging And Builds
- Fixed packaged asset resolution for frozen Windows and Linux builds, including install paths with spaces.
- Added Windows build checks and docs for
hidapipackaging. - Added shared build support helpers for packaging.
- Updated release workflow actions for Node 24 compatibility.
- Included the Linux permissions helper in release artifacts.
App Diagnostics
- Added version information to the app window title.
- Added an About dialog with app version, build mode, commit, and launch path.
- Added startup logging for version and build metadata.
- Improved the bug report template so reports include better install and build details.
Tests
- Added and expanded regression coverage for Linux HID discovery, Linux permission diagnostics, Linux build support, macOS Logi Bolt behavior, Smart Shift persistence, shortcut parsing and capture, packaged asset paths, config migration, and macOS trackpad filtering.
Contributors
Thanks to @thisislvca, @farfromrefug, @vcanuel, @oraluben, @matthewcorven, @iljabauer, and @JFly02 for the fixes and improvements in this release.
Also thanks to everyone who opened issues, tested builds, and helped make the Linux and macOS support better.
Legal Notice
This software is provided by its original developers. We only index and provide links to official download sources. All downloads are from the original publishers and are completely legal and safe.
Download Information
Related Apps
Mole
GitHub🐹 Deep clean and optimize your Mac.
Kap
GitHubAn open-source screen recorder built with web technology
Kap
GitHubAn open-source screen recorder built with web technology
ImageGlass
GitHub🏞 A lightweight, versatile image viewer