Open-source project
noah-nuebling/mac-mouse-fix avatar
noah-nuebling/mac-mouse-fix

Mac Mouse Fix: an Objective-C macOS app that makes a mouse behave more like a trackpad

Mac Mouse Fix - Make Your $10 Mouse Better Than an Apple Trackpad!

11,247 stars473 forksObjective-CNOASSERTION

At a glance

What is it?
Mac Mouse Fix is an Objective-C macOS app that remaps mouse buttons, gestures and scrolling. It installs through Homebrew or the project website, requires macOS 11 Big Sur or later, and version 3 is paid while version 2 stays free.
Who is it for?
Adopt Mac Mouse Fix if you run macOS 11 Big Sur or later and want a non-Apple mouse to behave like a trackpad, and you accept that version 3 is paid while version 2 remains free. Skip it if you are on macOS 10.15 Catalina or older and want a current build; the README points those systems to Mac Mouse Fix 2 instead.
Can I use it commercially?
Check first. The repository uses a licence we do not classify automatically, so read its LICENSE file before any commercial use.
Is it still maintained?
Yes. The repository received new commits within the last day.
What is it written in?
Mainly Objective-C, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • noah-nuebling/mac-mouse-fix11,247 ★ · +265
Star history
Repository2026-09-222026-11-15
noah-nuebling/mac-mouse-fix11k11.2k

265 Stars in the last 54 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

The problem Mac Mouse Fix targets: macOS treats third-party mice as second-class input

macOS ships with deep trackpad support and comparatively shallow support for ordinary USB and Bluetooth mice. The README frames the gap bluntly: the project exists to make a cheap mouse behave at the level of an Apple Trackpad or a Logitech MX Master, two devices it names as reference points. The audience is anyone on macOS who prefers a mouse but loses the gestures, smooth scrolling and button remapping that trackpad users take for granted.

The author states the ambition directly in the README: the goal is to turn Mac Mouse Fix into "the best mouse driver of all time", while conceding that some features are still missing. That admission matters more than the slogan. This is a driver-adjacent utility, not a finished platform, and the feature set has grown release by release.

How the app intercepts and rewrites mouse events

The repository layout is the clearest evidence of the architecture. Top-level entries include App/, Helper/, Shared/, Frameworks/, and a Mouse Fix.xcodeproj Xcode project, with Objective-C as the primary language. The App and Helper split is the standard macOS pattern for this class of tool: the visible application owns the UI and configuration, while a separate helper process does the event work. Splitting them is what allows the interception to keep running independently of the window you happen to have open.

Shared/ holds code used by both targets, which is where the event-handling and configuration logic most plausibly lives. Support/ and Various Notes/ suggest documentation and research material kept alongside the code rather than in the README.

Installing Mac Mouse Fix and remapping a first button

The README gives two installation routes. The primary one is the project website at macmousefix.com. The secondary one is Homebrew, and the README prints the command verbatim:

bash
brew install mac-mouse-fix

Run that in Terminal on a Mac with Homebrew already present. The README also points to the Releases page for older versions, which is where you go if you need a build other than the current one.

The README defers to the website for feature demos and to the Releases notes for detail. What the README does commit to is the platform requirement: the latest version is made for macOS 11 Big Sur or later. Check that before anything else, because the compatibility section is explicit that older systems get a different product.

For removal, the README is equally short. Move the app to the bin. It then warns that files will be left on your system, and recommends AppCleaner by FreeMacSoft for removing them.

Version 3 is paid, version 2 is free, and the split is the real adoption decision

The pricing section sends readers to macmousefix.com for Mac Mouse Fix 3 pricing, then states that Mac Mouse Fix 2 and below will remain free forever. The README does not state a number, only a link.

If you need free, version 2 is the answer the project gives. If you need current, you are on version 3 and the price lives on the website. There is no third option in the README. Note also that the licence file is present at the repository root under the name License, and the repository metadata reports the licence as NOASSERTION, meaning no standard SPDX identifier was detected. If you plan to redistribute or bundle the app, read that file rather than assuming an open source licence applies to the whole project.

Where Mac Mouse Fix is the wrong tool

The compatibility list is the sharpest limitation. If you are on macOS 10.11 El Capitan or later, the README points you to the latest version of Mac Mouse Fix 2. It adds that version 3.0.0 and later might still work on your machine, but with visual issues and features that may not work properly. If you are maintaining older Macs, the current release is not for you.

The second limitation is uninstallation residue. The README states plainly that moving the app to the bin leaves files behind, and it recommends AppCleaner to remove them. Anyone who installs, dislikes it, and expects a clean removal should plan for leftover files.

The third is scope. This is a driver-level utility that intercepts input events. If your problem is a mouse that macOS does not recognize at all, or a hardware fault, a remapping layer is not the fix. And if you are happy with trackpad gestures and only occasionally plug in a mouse, the configuration effort may exceed the benefit.

Mac Mouse Fix versus Mos and BetterMouse

Mos and BetterMouse are other mouse utilities a reader may compare against; the repository does not describe either, so the comparison here is structural. What can be said from this repository is what Mac Mouse Fix is: an Objective-C macOS app with a separate helper process, a paid version 3 and a permanently free version 2, distributed through its own website and Homebrew, and positioned explicitly against the Apple Trackpad and the Logitech MX Master.

That positioning tells you what to test when comparing. Mac Mouse Fix is aiming at gesture parity and scroll feel, not at being a general-purpose automation tool. If your requirement is a free, no-cost scroll fix, version 2 is the project's own answer and the comparison collapses. If your requirement is current macOS support plus ongoing development, the last push was on 2026-11-02 and the newest release, 2.2.6, shipped on 2026-10-03, so the project is moving. Evaluate Mos and BetterMouse against that same axis: which macOS versions they support and whether they charge.

Maintenance, upgrade cost and licence questions

The repository is not archived, and the last push was on 2026-11-02. Release history shows 2.2.6 on 2026-10-03, 3.1.0 on 2026-09-15, and a 3.1.0 Beta 1 on 2025-11-29.

The upgrade cost is mostly the paid transition from version 2 to version 3. The README's pricing section only states that Mac Mouse Fix 2 and below stay free forever and links to the website for version 3 pricing.

On licensing, the repository contains a file named License and the metadata reports NOASSERTION rather than a recognized identifier. That is a signal to read the file directly. The README's pricing section and the licence file may not describe the same thing, since the app is distributed as a paid product while source is published. Do not treat the presence of source code as permission to redistribute the binary. This is not legal advice; read the License file and, if the distinction matters to your organisation, get proper advice.

Editorial conclusion

Adopt Mac Mouse Fix if you run macOS 11 Big Sur or later and want a non-Apple mouse to behave like a trackpad, and you accept that version 3 is paid while version 2 remains free. Skip it if you are on macOS 10.15 Catalina or older and want a current build; the README points those systems to Mac Mouse Fix 2 instead. Before installing, confirm your macOS version against the compatibility list, and before paying, check the pricing section on macmousefix.com rather than a forum screenshot of a licence key.

Frequently asked questions

What does Mac Mouse Fix do?

It is a macOS app that makes a regular mouse behave more like an Apple Trackpad, covering button remapping, gestures and scrolling. The README describes the goal as turning regular mice into the best input devices for Macs.

Is Mac Mouse Fix free?

Mac Mouse Fix 2 and below will remain free forever, according to the README. Mac Mouse Fix 3 is paid, and the README sends readers to macmousefix.com for its pricing.

How do I install Mac Mouse Fix?

Download the latest version from macmousefix.com, or install through Homebrew with brew install mac-mouse-fix. Older versions are available on the Releases page.

How do I uninstall Mac Mouse Fix?

The README says to move the app to the bin. It also warns that files will be left on your system and recommends AppCleaner by FreeMacSoft for removing them.

How do I install Mac Mouse Fix 2?

Version 2 is the route for older systems. The README points users on macOS 10.11 El Capitan or later to the latest version of Mac Mouse Fix 2.

Official sources

  1. Issues
  2. noah-nuebling/mac-mouse-fix on GitHub
  3. Project website
  4. README
  5. Releases
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/noah-nuebling-mac-mouse-fix.svg)](https://hysenlabs.com/projects/noah-nuebling-mac-mouse-fix)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/noah-nuebling-mac-mouse-fix.svg)](https://hysenlabs.com/projects/noah-nuebling-mac-mouse-fix)

Was this useful?