Repolode
Submit
noah-nuebling

noah-nuebling/mac-mouse-fix

A macOS utility that adds button remapping, smooth scrolling and scroll inversion to third-party mice.

Open-source alternative to:SteerMouseLogitech Options

View on GitHubWebsite
Stars
11,136
Forks
451
Open issues
1,302
Last commit
6 hours ago

What is it?

Mac Mouse Fix is a macOS app that enhances non-Apple mice. It lets you assign actions to mouse buttons, including keyboard keys, media and system keys such as screen brightness and volume, and gestures like Click and Drag for Scroll & Navigate or Spaces & Mission Control.

The app also smooths scroll wheel input and lets you invert scrolling direction independently of the trackpad setting. Users can disable features globally from the menu bar, though per-app settings are listed as planned rather than available in the current version.

The latest version targets macOS 11 Big Sur and later, and the project is distributed through its website and Homebrew. Older Mac Mouse Fix 2 releases support macOS 10.11 and later. Some mice that rely on proprietary vendor driver protocols may not have all their buttons recognized.

Key features

  • 01Assign keyboard keys, media keys and system actions to mouse buttons
  • 02Smooth scrolling for mouse wheels
  • 03Independent scroll direction inversion
  • 04Click and Drag gestures for window management and Mission Control
  • 05Menu bar toggles to quickly disable features

Use cases

  • Using a cheap third-party mouse with a Mac as comfortably as an Apple trackpad
  • Snapping windows to halves or quarters with a mouse button drag
  • Controlling screen brightness or volume directly from a mouse button

Topics

#macos#mouse#scrolling#remapping#utility#input-devices#3rd-party-mouse#invert-scrolling#mac-mouse#mouse-events

FAQ

What is mac-mouse-fix?
A macOS utility that adds button remapping, smooth scrolling and scroll inversion to third-party mice. Mac Mouse Fix is a macOS app that enhances non-Apple mice. It lets you assign actions to mouse buttons, including keyboard keys, media and system keys such as screen brightness and volume, and gestures like Click and Drag for Scroll & Navigate or Spaces & Mission Control.
Is mac-mouse-fix free to use? What license does it have?
mac-mouse-fix is open source under the Other license. Check the license terms before using it in commercial products.
Is mac-mouse-fix still maintained?
Actively maintained. The last commit to mac-mouse-fix was on Oct 21, 2026.
What can I use mac-mouse-fix for?
Using a cheap third-party mouse with a Mac as comfortably as an Apple trackpad Snapping windows to halves or quarters with a mouse button drag Controlling screen brightness or volume directly from a mouse button
Where can I get mac-mouse-fix?
The source code and installation instructions are on GitHub: https://github.com/noah-nuebling/mac-mouse-fix

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

Related projects