Skip to content
mblaubergPublic

About

A lightweight, native alternative to Logi Options+ for Logitech mice on macOS.

Topics

Resources

Contributing

Security policy

Stars

5 stars

Watchers

0 watching

Forks

Repository files navigation

PureMouse icon

PureMouse

A lightweight, native alternative to Logi Options+ for Logitech mice on macOS.
Buttons, gestures, smooth scrolling, pointer speed and per-app settings,
with no account and no telemetry, and idle when your mouse is.

Download for macOS
Free and open source · macOS 14 or later · Apple silicon and Intel · signed but not notarised, so see Install before opening it

Latest release macOS 14 or later Swift, no dependencies MIT licence

Settings, Mouse › Buttons: a drawing of the MX Master 3S above its buttons. Forward goes forward on a click, opens Mission Control on a double-click and slows the pointer while held The PureMouse menu: the mouse and its battery, Smooth Scrolling, Pointer Speed and Pause PureMouse

Native and light
Swift and system frameworks only. No polling, no timers and no Electron: about 9 MB for the menu bar app, and zero CPU while your mouse is still.
Private
No account and no telemetry. The only network request is an update check you can turn off.
Leaves the mouse alone
Nothing is saved on the mouse, so it works normally on any other computer, and quitting hands it straight back to macOS.

PureMouse talks to the mouse directly over Logitech's HID++ protocol. Everything it does is in a plain JSON file, ~/.config/puremouse/config.json, which you can edit, copy or keep in your dotfiles.

Features

Every button, three ways

  • Give each extra button (not left or right click) one action for a click, another for a double-click and another for a hold. A button waits for a second click only if it has a double-click.
  • Mission Control, App Exposé, Spaces, back and forward, tabs, volume, media keys, Middle Click, a shortcut or a shell command.
  • Hold and Move: hold the gesture button and move the mouse for four more actions.
  • Precise Pointer slows the pointer while you hold a button. Drag Lock starts a drag on one click and lets go on the next.
  • Click a part of the drawing of your mouse to find its setting, or use Find by Pressing… and press the button itself.

Each app its own way

Microsoft Excel's page, with the action list open on the top button: Excel's own actions by name, such as Previous Sheet, Next Sheet and Format Cells, each with its shortcut
Named actions. The action list offers an app's own commands by name, here Excel's.
Apps: Chrome, Excel, Teams, Word, Preview and Safari, each with what it changes, and Screen Sharing, where PureMouse is off
Apps. Every app with settings of its own, and one where PureMouse is off.
  • Each app can have its own buttons, thumb wheel and scrolling. Buttons follow the app you're using; scrolling and the thumb wheel follow the app under the pointer.
  • Suggestions for common apps: tabs in browsers, volume in Zoom and Teams, zoom in Word.
  • 78 named actions for Zoom, Microsoft Teams, Adobe Photoshop, Figma, Final Cut Pro, Microsoft Excel, PowerPoint, Word, Visual Studio Code, Safari, Google Chrome and Microsoft Edge. Search finds them by name or by shortcut, and the thumb wheel offers pairs such as Brush Size or Switch Sheets.
  • Use PureMouse in this app turns PureMouse off in one app, such as a game or a remote desktop, and hands it back to macOS.

Smooth scrolling and pointer speed

Mouse › Scrolling: smooth scrolling at Balanced, its speed, the main wheel's direction, mode and SmartShift, and the thumb wheel scrolling sideways
Mouse › Scrolling. Feel and speed, wheel mode, SmartShift and the thumb wheel.
Mouse › Pointer: the pointer speed slider from Slow to Fast at 1,600 DPI, with presets of 800, 1,600 and 3,200 DPI
Mouse › Pointer. Pointer speed and the presets a button can cycle.
  • Smooth, accelerated scrolling on both wheels: Precise, Balanced, Gliding or your own feel. It runs in step with the display, and only while the wheel is moving.
  • The thumb wheel scrolls sideways, or switches tabs, changes the volume, zooms or moves between Spaces.
  • Wheel direction (separate from the trackpad's), ratchet or free spin, and SmartShift.
  • Pointer speed from Slow to Fast, with presets you can cycle from a button or the menu.

Set it up once, then forget it's there

General: PureMouse active, the MX Master 3S on its USB receiver at 82% battery, open at login, the menu bar icon, notifications and both permissions allowed
General. Status, login, the menu bar icon and permissions.
About This Mouse for the MX Master 3S: battery 82%, connected by USB receiver, and its model ID, with Copy Details
About This Mouse. Battery, connection, firmware and model, one click away.
  • Settings return within two seconds of the mouse answering after a wake, a reconnect or a switch back to this Mac, and the menu says if they could not be applied.
  • Battery in the menu, a notification at 20% and 5%, and one warning if a mouse comes back already low.
  • Universal Control: the wheels and buttons keep working when the pointer moves to another Mac.
  • Updates install from the menu when you choose them, after a check of the release's checksum and signature.
  • Two or more mice? Settings edits them all at once or one at a time.
  • Undo any change with ⌘Z, and Export and Import Settings to move them to another Mac.
  • Pause PureMouse from the menu, or hide its menu bar icon: battery alerts and update checks keep running.

Supported mice

MX Master 3 and 3S      MX Master 4      MX Anywhere 3 and 3S      Signature Plus M750

PureMouse works with Logitech mice that speak HID++ 2.0, over Bluetooth or a Logi Bolt or Unifying receiver. It keeps no list of models: it adopts any mouse or trackball, or any device with adjustable DPI, and turns on each feature that mouse reports. Keyboards, numpads, presenters and receivers are left alone.

Family What PureMouse turns on
MX Master 3, 3S and 4 Buttons, gestures, DPI, both wheels, SmartShift and battery; haptic feedback on the 4
MX Anywhere 3 and 3S Buttons, DPI, smooth scrolling, SmartShift and battery
MX Vertical and Lift Buttons, DPI and battery
Signature Plus M750 Buttons, DPI, smooth scrolling on its notched wheel and battery
MX Ergo Buttons, smooth scrolling on its notched wheel and battery
G-series, such as the G305 and G Pro X 2 Superstrike Battery, and DPI where the mouse accepts it

Tested on hardware: MX Master 3S. The other families are supported from what each mouse reports, and the test suite runs PureMouse against captured or published replies from several of them. Supported mice has the model details, where each comes from and the limits. Using another Logitech mouse? Share puremouse probe output in an issue to help verify its features.

Install

Requires macOS 14 or later, on Apple silicon or Intel. PureMouse is signed but not notarised, so expect macOS to block it the first time; step 2 clears that before you open it.

  1. Download PureMouse-<version>.dmg from the latest release, open it and drag PureMouse.app to Applications.

  2. Before opening it, clear the quarantine flag. Open Terminal and run:

    xattr -dr com.apple.quarantine /Applications/PureMouse.app

    Opened it already and got a warning? See Opening a blocked app.

  3. Quit Logi Options+ if it is installed: only one app can control the mouse at a time.

  4. Open PureMouse. It opens Settings and starts at login from then on.

  5. In System Settings › Privacy & Security, allow Accessibility (for scrolling, shortcuts and swipes) and Input Monitoring (for Bluetooth). PureMouse picks up each grant by itself, and Settings › General shows both. Privacy says what each one is used for.

To check the download first, put SHA256SUMS from the release beside the dmg and run shasum -a 256 -c SHA256SUMS.

Updating

  • From the menu. After asking once, PureMouse checks for a new release at most once a day. A new release brings one quiet notification, and the menu shows Update to X.Y.Z… with Skip This Version under it. Choosing it asks, then downloads the release, checks it against its SHA256SUMS and that it is signed by the same certificate as this copy, replaces the app and opens it again, with no window if Settings was not open. Settings › About has the same as Update and Relaunch, and Settings comes back on About. Quitting PureMouse while it runs stops the update.
  • If it can't. If a check fails, or the app is on a read-only disk or needs an administrator, nothing is replaced: the menu says why and links the release page (or opens it), and you update by hand.
  • Your choice. Nothing installs unless you choose it, and the switch in Settings › About turns the check, and the row, off. Versions after 0.5.1 have the daily check; in any version, Check for Updates in Settings › About checks once. Privacy has the details.
  • By hand. Download the new dmg, replace the app in Applications, clear the quarantine flag as in step 2 and open it; it replaces the running copy. Your settings and permissions carry over.

Removing

Run the command below, then move the app to the Bin. Your config stays in ~/.config/puremouse.

/Applications/PureMouse.app/Contents/MacOS/puremouse unregister

Lightweight by design

PureMouse Measured on
Download 6.2 MB dmg, 15.3 MB installed; universal (Apple silicon and Intel) 0.6.0, 2026-11-04
Memory: background process 4.9 MB after 10 hours with an MX Master 3S connected 0.4.0, 2026-11-03, one reading
Memory: menu bar app About 9 MB fresh, about 14 MB once its menu has been opened 0.6.0, 2026-11-04, median of 5 runs
Memory: Settings About 30 MB in its own process while its window is open, then nothing 0.6.0, 2026-11-04, median of 5 runs
Idle CPU Zero in normal use: no polling, no timers, no wake-ups* By design
Processes Two: the background process and an optional menu bar app, plus Settings while its window is open By design
Network One small update check a day if you allow it, or when you press Check for Updates; an update only when you choose it By design
Privacy No account, no telemetry, no settings saved permanently on the mouse By design

The sizes are the published 0.6.0 release: the dmg as downloaded, and the app inside it counted file by file (scripts/check-size.sh). The memory figures are measured at idle, from macOS 27.0.1 on Apple silicon, the menu bar app and Settings from the footprint rig, built from source. Figures move with each release and each macOS, so they are taken again for every minor release.

The background process uses only system frameworks and no UI toolkit. Settings is a separate app that runs only while its window is open (it shows in the Dock meanwhile, and quits when you close it), so the menu bar app stays small.

* Three exceptions. The optional daily update check (off until you say yes) is scheduled by macOS, which picks a convenient moment; PureMouse has no timer for it. The other two are short-lived: while a permission is still to be granted, PureMouse checks for it with growing gaps for up to ten minutes; and a Bluetooth mouse that does not answer when it connects is retried once a minute until it does.

Privacy and security

No account and no telemetry. PureMouse keeps its settings and support files in your home folder; updating also uses temporary files and replaces the installed app. It goes online only to check for updates (once a day if you allow it, or when you press Check for Updates) and to download one you choose to install. Privacy lists every permission, file and request; Security says how to report a vulnerability.

Documentation

Supported mice Model details, what each reports and where that comes from
Configuration Every field, action and gesture in config.json, which applies when you save it and can give each model of mouse its own settings
Troubleshooting Logs, permissions, Gatekeeper and macOS upgrades
Privacy Permissions, files written and the update check
How it works The background process, menu bar app and Settings, device support, scrolling and source layout
Architecture decisions Why it is built this way
Development Building, testing, signing and releases

Bug reports and ideas are welcome in Issues; Contributing explains how to ask for a mouse and how to send a change.

Support

PureMouse is free and open source. If it's made your mouse nicer to use, you can support it on GitHub Sponsors. Thank you!

Licence

MIT. See LICENSE.

PureMouse is an independent project, not affiliated with or endorsed by Logitech. Logitech, Logi, Logi Options+, Logi Bolt, Unifying and MX Master are trademarks of Logitech.

About

A lightweight, native alternative to Logi Options+ for Logitech mice on macOS.

Topics

Resources

Contributing

Security policy

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages