Repolode
Submit
TomBadash

TomBadash/Mouser

A free, fully local alternative to Logitech Options+ for remapping buttons and controlling Logitech HID++ mice on Windows, macOS, and Linux.

Open-source alternative to:Logitech Options+

View on GitHub
Stars
5,299
Forks
209
Open issues
137
Last commit
14 hours ago

What is it?

Mouser lets you reassign the programmable buttons on Logitech HID++ mice, such as the gesture button, back and forward buttons, and horizontal scroll, to keyboard shortcuts, mouse clicks, or built-in actions like Alt+Tab, Mission Control, or media controls. Mappings can be set per application, so the same button can behave differently in Chrome and VS Code.

Beyond button remapping, Mouser adjusts DPI, toggles SmartShift between ratchet and free-spin scrolling, inverts scroll direction, and handles gesture-button swipes. It runs on Windows, macOS, and Linux using native input hooks, and the best device support is for the MX Master and MX Anywhere families. Other Logitech models get a generic fallback UI.

Mouser has no telemetry, no cloud component, and no Logitech account requirement. Configuration is stored as a local JSON file. Logitech Options+ must be closed while Mouser runs, because both apps compete for HID++ access.

Key features

  • 01Remap middle, gesture, back, forward, and horizontal scroll buttons to shortcuts or mouse clicks.
  • 02Per-application profiles switch mappings automatically when the foreground app changes.
  • 03Adjust DPI and toggle SmartShift scroll modes, with scroll direction inversion.
  • 04Gesture button supports tap and swipe actions in four directions.
  • 05Runs on Windows, macOS (Apple Silicon and Intel), and Linux, with a system tray or menu-bar presence.
  • 06Available in English, Simplified Chinese, and Traditional Chinese.

Use cases

  • Mapping MX Master side buttons to Alt+Tab or browser back and forward.
  • Setting different button behavior for coding tools versus design or browsing apps.
  • Using a Logitech mouse on Linux where Options+ is unavailable.
  • Avoiding a vendor account and cloud-connected configuration software.

Quick start

  1. 1

    Open the latest release page

  2. 2

    Download the zip for your platform and extract it

  3. 3

    Run the Mouser executable (Mouser.exe, Mouser.app, or ./Mouser)

Things to know

  • Logitech Options+ must not be running, since it conflicts with Mouser over HID++ access.
  • Best experience is on MX Master and MX Anywhere; other Logitech models get only a generic fallback UI.
  • Linux needs a one-time permissions helper script and a mouse reconnect before it works.
  • macOS release builds are ad-hoc signed, so Accessibility permission may need to be granted again after rebuilds.

Topics

#mouse-remapping#logitech#hid#python#automation#desktop-app#cross-platform#controler#free#linux

FAQ

What is Mouser?
A free, fully local alternative to Logitech Options+ for remapping buttons and controlling Logitech HID++ mice on Windows, macOS, and Linux. Mouser lets you reassign the programmable buttons on Logitech HID++ mice, such as the gesture button, back and forward buttons, and horizontal scroll, to keyboard shortcuts, mouse clicks, or built-in actions like Alt+Tab, Mission Control, or media controls. Mappings can be set per application, so the same button can behave differently in Chrome and VS Code.
Is Mouser free to use? What license does it have?
Mouser is open source under the MIT license. Check the license terms before using it in commercial products.
Is Mouser still maintained?
Actively maintained. The last commit to Mouser was on Oct 19, 2026.
What can I use Mouser for?
Mapping MX Master side buttons to Alt+Tab or browser back and forward. Setting different button behavior for coding tools versus design or browsing apps. Using a Logitech mouse on Linux where Options+ is unavailable. Avoiding a vendor account and cloud-connected configuration software.
How do I install Mouser?
Open the latest release page Download the zip for your platform and extract it Run the Mouser executable (Mouser.exe, Mouser.app, or ./Mouser)
Where can I get Mouser?
The source code and installation instructions are on GitHub: https://github.com/TomBadash/Mouser

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects