Also check out the cool stuff introduced in 3.0.0 Beta 1!

---

New in 3.0.0 Beta 3

3.0.0 Beta 3 should now work properly on macOS 12 Monterey!

When running Beta 2 under Monterey, it used to crash most of the time when clicking the "Enable Mac Mouse Fix" toggle and it had some visual glitches.

Also check out the cool stuff introduced in 3.0.0 Beta 1!

---

New in 3.0.0 Beta 2

Fixed an issue where Mac Mouse Fix wouldn't open on most computers due to problems with Apple's Security Mechanisms. Should fix Issue #369.

3.0.0 will be the biggest update to Mac Mouse Fix so far!

Bringing together many features that I've worked on for a long time to finally deliver this awesome value proposal:

Make your $10 mouse better than an Apple Trackpad!

And you can test it now! I'm really excited to hear your guys' feedback!

Here is everything that's new:

1. Click and Drag to Scroll

You can now Click and Drag to Scroll freely in any direction!

It also allows you to go back and forward in Safari, mark messages as read in Mail, and do anything else you can do with a two-finger swipe on an Apple Trackpad!

I worked hard to implement the feature to this quality standard. But as a result, as you play around with it, I think you'll find it really "just works"!

2. Scroll Gestures

Mac Mouse Fix now supports Scroll Gestures! That means you can trigger actions by scrolling while holding down a mouse button!

Scroll Gestures let you get even more functionality out of a single mouse button in a super intuitive way.

In this beta, there are the following Scroll Gestures:

• Desktop & Launchpad allows you to reveal the Desktop or open Launchpad by scrolling either up or down. This feels super fluid and intuitive because it simulates pinching with 4 fingers on an Apple Trackpad.
• Move between Spaces lets you switch between Spaces by scrolling up or down. This feels super fluid as well since it simulates swiping on an Apple Trackpad with 3 fingers. However, I'm not sure if this is redundant since you can already Click and Drag to move between Spaces. Let me know what you think!
• Zoom in or out lets you take a closer look on the web or elsewhere. This was already available in Mac Mouse Fix 2 by holding the Command (⌘) key while scrolling, but now you can do it more easily using just one hand!
• Horizontal Scroll lets you scroll left and right. You can also use it to navigate between pages in Safari and other apps because simulates swiping with 2 fingers on an Apple Trackpad.
• Swift Scroll lets you scroll large distances with minimal effort.
• Precise Scroll lets you scroll small distances and use sensitive UI Elements like volume sliders with precision.
• App Switcher lets you switch between recent apps, just like pressing Command-Tab (⌘ + ↹) on your keyboard. This feature has some bugs and I'm not sure it's very useful, since you can already easily access the Tab Switcher from your keyboard, so I'll probably remove it later. Let me know what you think, though.

3. Inertial Scrolling

Inertial Scrolling makes scrolling on your mouse feel just as fast and fluid as an Apple Trackpad.

Inertial Scrolling creates long and very smooth animations. On a scroll wheel, long animations generally come with the tradeoff of less control.

But Mac Mouse Fix 3 implements some smart algorithms to give you a great intertial feel while still offering a lot of control.

By the way, if you download this Beta, I think you'll be one of the first humans to use scroll bouncing from a mouse! (other than the Magic Mouse) I think that's kinda cool.

4. Other Scrolling Improvements

I rewrote most of the scrolling code for MMF 3. This allowed me to implement many other small features and improvements:

1. There are now 2 additional keyboard modifiers so you can not only Zoom in or out with Command (⌘), and Scroll Horizontally with Shift (⇧), but also Scroll Swiftly with Control (^) and Scroll Precisely with Option (⌥).
2. You can now see and customize all 4 keyboard modifiers using a beautiful and intuitive new UI.
3. Always-On Precise Scrolling lets you scroll precisely even without holding down a modifier key by moving the scroll wheel slowly.
4. Horizontal Scroll Input from your mouse is no longer ignored, but instead it's smoothed and inverted just like normal vertical scroll input. If your mouse has a tilt wheel or a horizontal scroll wheel it should feel much nicer now.
5. The Scroll Direction Invert Settings are now independent of the System Settings allowing for a less complicated UI.
6. Scroll settings can now be combined more freely. For example, you can use Mac Mouse Fix's Scroll Speed even when Smooth Scrolling is disabled. Or you can use macOS's Scroll Speed when Smooth Scrolling is enabled. (Note: I personally don't like macOS' Scroll Speed at all and I can't think of reasons why anyone would prefer it. So if you do prefer it I'd be very interested to learn more about your experience! You can reach out through the "ⓘ About" Tab.)

5. Menu Bar Item

Mac Mouse Fix now has a Menu Bar Item so you can always see when it's enabled!

The Menu Bar Item has a beautiful icon, and it also allows you to quickly disable certain features of Mac Mouse Fix so you can play a game or use an app without Mac Mouse Fix interfering.

Of course, you can also still disable it for a cleaner Menu Bar.

6. App-Specific Settings Have Been Removed

App-Specific Settings are gone for now. However, I do plan to bring them back in a much more robust and powerful form in the future.

For now, I think the quick settings in the Menu Bar Item are a better, if less convenient, solution.

They solve the most important problems of the old App-Specific Settings:

• App-Specific Settings didn't work with some programs like command line executables. This included popular apps like Minecraft.
• App-Specific Settings had many limitations like they didn't allow you to turn off buttons entirely, which was a problem for many gamers.

Another thing to consider is that the old App-Specific Settings were originally designed as a bandaid for some apps being incompatible with the old scrolling system. But now, with the new scrolling system precisely emulating Touch Scrolls coming from an Apple Trackpad, most of these incompatibilities should be fixed anyways! So there should be less of a need for what the old App-Specific Settings were best at.

I hope everone is okay with that! Let me know your thoughts!

7. UI Overhaul

I've completely rewritten the UI to be more beautiful and powerful while still retaining the simplicity and ease of use that people love about Mac Mouse Fix.

Here's what's new:

• The UI is now split up into different tabs. This cleans things up and allows Mac Mouse Fix to provide additional settings that are important to people without the UI becoming too complicated or overwhelming. This will also allow me to extend Mac Mouse Fix with new features in the future.
• I added subtle and delightful little animations all over the new UI that make it easier to navigate and add a feeling of polish.
• Options that depend on other options will be hidden and the layout will adjust with beautiful subtle animations. This keeps things as simple and streamlined as possible. So you don't have to waste time and brainpower looking at options that you don't need to be thinking about.
• The new UI features small hints for options that can otherwise be confusing.
• The new Action Table design makes it much clearer how to add and remove Actions, which many people were confused by. It also shrinks and grows to fit the number of Actions so you don't have to resize it manually.
• The new About Tab features a beautiful layout, and puts additional options for support, feedback, and more at your fingertips.
• Some existing UI strings have been improved.
• There's now a new option to Lock the Mouse Pointer during Click and Drag Gestures. I don't have one to test, but this should be very nice for Trackball-Mice!

8. Monetization

Mac Mouse Fix 3 will be free for 30 days and then cost $1.99 to own.

I know that paying for something that used to be free is not the best feeling, but I hope I can convince you that it's a really good thing for the project!

Like for every other aspect of Mac Mouse Fix, I paid great attention to making the user experience as simple and pleasant as possible:

1. The 30 free days are smartly implemented. Mac Mouse Fix only counts the days on which you actually use it. So there's no pressure to use the app before the time is up, and you can make an informed decision whether you want to buy the app or not without any stress.
2. After the 30 free days are over, paying for the app is extremely simple and fast. You can use all the payment methods you love like Apple Pay and PayPal, and it only takes 2 clicks to pay from inside the app via Apple Pay!
3. After you bought the app for $1.99, activating your license is also extremely simple. I actually put a link on the checkout screen in the web browser that takes you directly into the app and opens the screen for entering the license for you!
4. After you activate your license, there's a cute randomized thank you message on the about tab. (I heard there are even some super secret rare ones...)
5. Your license is synced via iCloud so it will automatically be available on all your computers!

By helping Mac Mouse Fix financially, you can also help me spend a lot more time on it and make it the best mouse driver EVERRR. I also love spending time on Mac Mouse Fix, so that would also make me happy :)

Will Mac Mouse Fix still be Open Source?

Yes. Mac Mouse Fix will still be open source, and I don't plan to change that at any point.

This also means you can use Mac Mouse Fix for free by building it from source and disabling the licensing checks. That's perfectly fine, I just discourage sharing these cracked versions online. And of course, on the next update, you'll get a non-cracked version which means you'll have to do this again for every update. (Or just pay $1.99 for the greatest mouse driver ever! :)

Anyone will also still be able to use source code from Mac Mouse Fix in their free and commercial products as long as they don't just sell a copy of Mac Mouse Fix without adding their own contribution.

Learn about the details in the new MMF License which MMF 3 will be licensed under.

Will I have to pay to use the Mac Mouse Fix 3 Beta?

No. You can just use your 30 free days. The free day counter probably won't reset when the stable version of Mac Mouse Fix 3 releases, since that would be extra stuff to design and implement and I don't think anyone will care too much. (Let me know if you do). But I will extend the number of free days if the beta goes on for more than 30 days.

Can I get Mac Mouse Fix for free if I already donated?

Yes! If you bought me a milkshake before the 10th of September 2022, you can write an email to [email protected] with "Milkshake Karma" in the subject and a screenshot as proof and then I'll send you a 100% off discount code or something!

9. Internationalization

With the UI rewrite, it's now possible to translate Mac Mouse Fix into different languages!

I already translated it into German, my native language, and you can translate it into your language, too!

I plan to write a more detailed guide on this in the future, but if you want to give it a go, here's a small overview of the steps:

• Download the source code & Xcode
• Add your language to the project
• Put your translations into the .strings and .stringsdict files throughout the project
• Commit your changes and create a pull request

If your translation is added to the project you'll get 10 MMF copies for free, and of course, you'll be credited as a contributor. I heard you can also leave your personal message by changing some of the (secret rare thank you messages) on the About tab.

Maybe I'll add more perks in the future. Let me know if you have any ideas for that!

10. How You Can Help

You can help by sharing your ideas, issues and feedback!

The best place to share your ideas and issues is the Feedback Assistant. The best place to give quick unstructured feedback is the Feedback Discussion.

You can also access both these places from within the app on the "ⓘ About" tab.

Thanks for helping to make Mac Mouse Fix better! 🚀

Mac Mouse Fix 2.2.1 Beta 3 brings back compatibility with older macOS versions & more.

• Fixed crash on launch under older macOS versions. Should resolve Issue #327.
• Fixed a crash when trying to add apps which don't have an app name to App-Specific Settings. Should resolve Issue #241. Special thanks to jeongtae who was very helpful in figuring out the problem!
• More small bug fixes and under-the-hood improvements.

Even more improvements for Ventura!

Mac Mouse Fix will now feel fully native to Ventura.

• Updated the UI for granting Accessibility Permissions to reflect the new Ventura System Settings
• Mac Mouse Fix will now be displayed properly under Ventura's new System Settings > Login Items menu
• Mac Mouse Fix will react properly when it's disabled under System Settings > Login Items
• Fixed a glitch where the Action Table would become too narrow when resizing the main window under Ventura

Ventura support!

Mac Mouse Fix now fully supports macOS 13 Ventura. Special thanks to @chamburr who helped with Ventura support in GitHub Issue #297.

Dropped support for older macOS versions

Unfortunately, Apple only lets you develop for macOS 10.13 High Sierra and later when developing from macOS 13 Ventura.

So the minimum supported version has increased from 10.11 El Capitan to 10.13 High Sierra.

I'm sorry about this. But to cheer you up there's a chill ladybug in the next section.

Bug fixes 🐞

• Fixed a crash in 'App-specific settings' when trying to add an app without a 'Bundle ID'. Might help with GitHub Issues #289 and #241.
• Fixed an issue where Mac Mouse Fix changes the scrolling behaviour of some drawing tablets. See GitHub Issue #249.
• Fixed an issue where keyboard shortcuts including the 'A' key couldn't be recorded. Fixes GitHub Issue #275.
• Fixed an issue where some button remappings wouldn't work properly when using a non-standard keyboard layout.
• Other small fixes and visual improvements.

Also check out the cool stuff introduced in Mac Mouse Fix 2!

---

Mac Mouse Fix 2.2.0 features various usability improvements and bug fixes!

Remapping to Apple-Exclusive function keys is better now

The last update, 2.1.0, introduced a cool new feature that lets you remap your mouse buttons to any key on your keyboard - even function keys that are only found on Apple keyboards. 2.2.0 features further improvements and refinements to that feature:

• You can now hold Option (⌥) to remap to keys that are only found on Apple keyboards - even if you don't have an Apple keyboard at hand.
• The function key symbols feature an improved appearance, making them fit in better with other text.
• The ability to remap to Caps Lock has been disabled. It did not work as expected.

Add / remove Actions more easily

Some users had trouble figuring out that you can add and remove Actions from the Action Table. To make things easier to understand, 2.2.0 features the following changes and new features:

• You can now delete Actions by right-clicking them.
  • This should make it easier to discover the option to delete Actions.
  • The right-click menu features a symbol of the '-' button. This should help draw attention to the '-' button, which should then draw attention to the '+' button. This hopefully makes the option to add Actions more discoverable as well.
• You can now add Actions to the Action Table by right-clicking an empty row.
• The '-' button is now only active when an Action is selected. This should make it clearer that the '-' button deletes the selected Action.
• The default window height has been increased so that there's a visible empty row which can be right-clicked to add and Action.
• The '+' and '-' buttons have tooltips now.

Click and Drag improvements

The threshold for activating Click and Drag has been increased from 5 pixels to 7 pixels. This makes it harder to accidentally activate Click and Drag, while still letting users switch Spaces etc. by using small, comfortable flicks.

Other UI changes

• The appearance of the Action Table has been improved.
• Various other UI enhancements.

Bug fixes

• Fixed an issue where the UI wasn't greyed out when starting MMF while it was disabled.
• Removed hidden "Button 3 Click and Drag" option.
  • When selecting it, the app would crash. I built this option to make Mac Mouse Fix better compatible with Blender. But in its current form, it is not very useful for Blender users because you can’t combine it with keyboard modifiers. I plan to improve Blender compatibility in a future release.

Also check out the cool stuff introduced in Mac Mouse Fix 2!

---

The app works again.

I signed the app with a new certificate. The old certificate was revoked by Apple which renders old versions of Mac Mouse Fix unusable. See this post for more info.

New feature!

You can now control Media Playback, Speaker Volume, Display Brightness and more right from your mouse! This is possible because Mac Mouse Fix now lets you remap your mouse buttons to any key on your keyboard - even Apple's proprietary function keys like "Play-Pause" or "Mute Speaker".

Note: Mac Mouse Fix 2 is outdated now. Get the latest version!

Mac Mouse Fix 2 is here! 🎉

Mac Mouse Fix 2 makes your Mouse even better.

Mouse Gestures done right.

Click a Mouse Button and Drag in different directions to enter Mission Control, move between Spaces, or see all windows of the current app - all using just a single Button!

Mac Mouse Fix Gestures feel much more fluid and responsive than any other driver on the market. This is possible because Mac Mouse Fix can precisely emulate the output of Apple's Trackpad driver.

With great power comes great ... ease of use!

With the new Action Table, you can set up your Mouse exactly how you want it - in seconds.

Move the pointer into the "+" field, then simply show Mac Mouse Fix the clicks and drags that you want to assign a new Action to.

Adding an Action for Double-Clicking the Middle Mouse Button is super simple. ^

A major boost to your productivity.

Mouse Gestures, together with the new Action Table allow you to get 7x more functionality out of a single Button compared to conventional mouse drivers. All while being so simple and intuitive that you'll actually use all those features.

This way anyone can leverage the convenient navigation options that make macOS so powerful - from any mouse. Even the simplest ones.

For example, with the default configuration, you can use all these Actions using just the Middle Mouse Button:

• Mission Control
• Move Left a Space
• Move Right a Space
• App Exposé
• Show Desktop
• Launchpad
• Look Up

And this is right out of the box. Without even tapping into the endless, yet easy-to-use customization options.

... And a lot more

Neat features

• Keyboard Shortcuts right from your Mouse give you even more flexibility for your workflow.
• Smart zoom allows you to get a better glance on the web and elsewhere.

UI refinements

• New Help and Feedback options are now easily accessible in the app where you need them.
• Set up is easier and more streamlined.

Improved update experience

The new and improved Update Mechanism ...

• is secure against man in the middle attacks.
• lets you test the latest Beta version - hassle-free!
• features an improved UI.
• lets me count downloads without relying on Google Analytics or other frameworks that might compromise your privacy.

Reliability enhancements

• Various bug fixes and stability improvements.

---

Mac Mouse Fix started out as a little hobby project to teach myself programming. But due to your support and encouragement, my goal is now to create the Best Mouse Driver Ever. Today we came quite a bit closer to that goal. Thank you! 🚀🚀🚀 :)

Changes in Beta 13

This update features small refinements:

• Improved performance of "Click and Drag for Mission Control and Spaces" feature
• Added keyboard shortcuts for standard actions like minimizing, copy-paste, etc.
• Added several menu bar items
• Various other UI refinements

Thanks for helping to make Mac Mouse Fix better! :)