Mac Mouse Fix Changelog

What's new in Mac Mouse Fix 3.0.2

Mar 6, 2024
  • Scrolling:
  • You can now stop scroll animations by scrolling one step in the opposite direction. This allows you to 'throw' and 'catch' the page when using 'Smoothness: High', similar to a Trackpad.
  • Mac Mouse Fix now sends scroll events earlier in the display refresh cycle, giving apps more time to process the scroll events and display scrolling smoothly. This improves framerates, especially on complex websites like YouTube.com.
  • Improved the responsiveness of the 'Smoothness: High' setting, making scrolling easier to control.
  • Improved on a mechanism introduced in 3.0.1 where the animation speed becomes faster as you move the scroll wheel faster when using 'Smoothness: Regular'. In 3.0.2 the speedup of the animation should appear more consistent and predictable, making it easier on the eyes while providing great control.
  • Fixed a problem where the scrolling speed was too slow, especially when using the 'Precision' option. This problem was introduced in 3.0.1. Thanks to @V-Coba for drawing attention to it in 795.
  • Improved behaviour inside the Arc browser when using 'Click and Scroll' to 'Zoom In or Out'.
  • Localization:
  • Updated 🇻🇳 Vietnamese translations. Credits to @nghlt!
  • Improved some 🇩🇪 German translations.
  • Text inside Mac Mouse Fix that doesn't have a translation for the current language will now show a placeholder value instead of just being blank. This should make it less confusing to navigate the app when there are missing translations.
  • Other:
  • Mac Mouse Fix will now show a notification with a link to this guide to users who might be experiencing a bug in macOS 13 Ventura and later that can prevent Mac Mouse Fix from being enabled.
  • Changed the default settings for mice with 3 buttons. The default settings no longer feature a 'Click and Scroll' action for the Scrollwheel Button, since that is pretty hard to perform. Instead, the default settings now feature a 'Hold' and a 'Double Click' action.
  • Added a tooltip to the Mac Mouse Fix icon on the About tab. It tells you how to reveal Mac Mouse Fix's config file in the Finder.
  • Lots of under-the-hood cleanup and improvements.

New in Mac Mouse Fix 3.0.1 (Jan 16, 2024)

  • Vietnamese was added:
  • Mac Mouse Fix is now available in 🇻🇳 Vietnamese. Big thanks to @nghlt on GitHub!
  • Bug fixes:
  • Mac Mouse Fix now works properly with Fast User Switching!
  • Fast User Switching is when you log into a second macOS account without logging out of the first account.
  • Before this update, scrolling stopped working after a fast user switch. Now everything should work correctly.
  • Fixed a small bug where the layout of the Buttons tab was too wide after starting Mac Mouse Fix for the first time.
  • Made the '+' field work more reliably when adding several Actions in quick succession.
  • Fixed an obscure crash reported by @V-Coba in Issue 735.
  • Other improvements:
  • Scrolling feels more responsive when using the 'Smoothness: Regular' setting.
  • The animation speed now becomes faster as you move the scroll wheel faster. That way, it feels more responsive when you scroll fast while feeling just as smooth when you scroll slowly.
  • Made the scroll speed acceleration more stable and predictable.
  • Implemented a mechanism to keep your settings when you update to a new Mac Mouse Fix version.
  • Before, Mac Mouse Fix would reset all your settings after updating to a new version, if the structure of the settings changed. Now, Mac Mouse Fix will attempt to upgrade the structure of your settings and keep your preferences.
  • So far, this only works, when updating from 3.0.0 to 3.0.1. If you're updating from an older version than 3.0.0, or if you downgrade from 3.0.1 to a previous version, your settings will still be reset.
  • The layout of the Buttons tab now better adapts its width to different languages.
  • Improvements to the GitHub Readme and other documents.
  • Improved localization systems. The translation files are now automatically cleaned up and analyzed for potential issues. There's a new Localization Guide which features any automatically detected issues along with other useful info and instructions for people who want to help translate Mac Mouse Fix. Removed dependency on the BartyCrouch tool which was previously used to get some of this functionality.
  • Improved several UI strings in English and German.
  • Lots of under-the-hood cleanup and improvements.

New in Mac Mouse Fix 3.0.0 (Dec 23, 2023)

  • Monetization:
  • Before you upgrade to Mac Mouse Fix 3 from Mac Mouse Fix 2, there's one thing you might want to know:
  • Mac Mouse Fix 3 will be free for 30 days and cost $1.99 to own. (It will launch at this price. I might adjust the pricing down the line.)
  • I know that monetization might not seem good for users at first glance, but I hope I implemented it in a way that everyone can get on board with.
  • It's pressure-free:
  • Your free days are only used up when you actually use Mac Mouse Fix. 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.
  • It syncs via iCloud:
  • Your license is synced via iCloud so it will automatically be available on all your computers!
  • It's convenient:
  • Paying for the app and activating your license is super fast and intuitive. And you can even pay with Apple Pay!
  • It's cute:
  • After you activate your license, there's a cute randomized thank you message on the "About" tab :)
  • You support the project:
  • By supporting the project financially, you allow me to keep working towards my dream of making Mac Mouse Fix the best mouse driver of all time!
  • Changes since the last Beta:
  • Slightly reduced CPU usage of "Scroll & Navigate" feature
  • Added "Version" in front of the version number on the "About" tab, to make it easier to understand
  • Updated the license string of the "Mac Mouse Fix Helper" app
  • Improved fallback mechanism for license-related values when there is no internet connection
  • Under the hood improvements and cleanup

New in Mac Mouse Fix 3.0.0 Beta 7 (Dec 17, 2023)

  • Improvements:
  • Added Korean translations. Big thanks to @jeongtae (on GitHub)!
  • Made scrolling with the 'Smoothness: High' option even smoother, by only changing the speed gradually, instead of having sudden jumps in the scrolling speed as you move the scroll wheel. This should make scrolling feel a little smoother and easier to follow with your eyes without making things less responsive. Scrolling with 'Smoothness: High' uses around 30% more CPU now, on my computer it went from 1.2% CPU usage when continuously scrolling to 1.6%. So scrolling is still highly efficient and I hope this won't make a difference to anyone. Big thanks to MOS, which inspired this feature and whose 'Scroll Monitor' I used to help implement the feature.
  • Mac Mouse Fix is now handling button inputs from all sources. Before, Mac Mouse Fix would only handle inputs from mice that it recognized. I think this might help compatibility with certain mice in edge cases, like when using a Hackintosh, but it will also lead Mac Mouse Fix to pick up artificially generated button inputs from other apps, which might lead to problems in other edge cases. Let me know if this leads to any problems for you, and I will address that in future updates.
  • Refined the feel and polish of the 'Click and Scroll' for 'Desktop & Launchpad' and 'Click and Scroll' to 'Move Between Spaces' gestures.
  • Now taking the information density of a language into account when calculating the time that notifications are shown for. Before this, notifications would only stay visible for a very short amount of time in languages with high information density like Chinese or Korean.
  • Enabled different gestures to move between Spaces, open Mission Control, or open App Exposé. In Beta 6, I made it so these actions were only available through the 'Click and Drag' gesture - as an experiment to see how many people actually cared about being able to access those actions in other ways. It seems that some do, so now I made it possible again to access these actions through a simple 'Click' of a button or through 'Click and Scroll'.
  • Made it possible to Rotate through a Click and Scroll gesture.
  • Improved the way that the Trackpad Simulation option works in some scenarios. For example when scrolling horizontally to delete a message in Mail, the direction that the message moves is now inverted, which I hope feels a bit more natural and consistent to most people.
  • Added a feature to remap to Primary Click or Secondary Click. I implemented this because the right mouse button on my favorite mouse broke. These options are hidden by default. You can see them by holding the Option key while selecting an action.
  • This is currently lacking translations for Chinese and Korean, so if you would like to contribute translations for these features that would be greatly appreciated!
  • Bug Fixes:
  • Fixed a bug where the direction of 'Click and Drag' for 'Mission Control & Spaces' was inverted for people who have never toggled the 'Natural scrolling' option in System Settings. Now, the direction of 'Click and Drag' gestures in Mac Mouse Fix should always match the direction of gestures on your Trackpad or Magic Mouse. If you want a separate option for inverting the 'Click and Drag' direction, instead of having it follow the System Settings, let me know.
  • Fixed a bug where the free days would count up too quickly for some users. If you were affected by this, let me know and I'll see what I can do.
  • Fixed an issue under macOS Sonoma where the tab bar wouldn't display properly.
  • Fixed jankiness when using 'macOS' scrolling speed while using 'Click and Scroll' to open Launchpad.
  • Fixed crash where the 'Mac Mouse Fix Helper' app (which runs in the background when Mac Mouse Fix is enabled) would crash sometimes when recording a keyboard shortcut.
  • Fixed a bug where Mac Mouse Fix would crash when trying to pick up artificial events generated by MiddleClick-Sonoma
  • Fixed an issue where the name for some mice displayed in the 'Restore Defaults...' dialog would contain the manufacturer twice.
  • Made it less likely for 'Click and Drag' for 'Mission Control & Spaces' to get stuck when the computer is slow.
  • Corrected use of 'Force Touch' in UI strings where it should be 'Force click'.
  • Fixed a bug that would occur for certain configurations, where opening Launchpad or showing the Desktop through 'Click and Scroll' wouldn't work if you released the button while the transition animation was still ongoing.
  • More:
  • Several under-the-hood improvements, stability improvements, under-the-hood cleanup, and more.

New in Mac Mouse Fix 3.0.0 Beta 6 (Dec 16, 2022)

  • Deep Optimizations:
  • For this Beta, I put a lot of work into getting the last bit of performance out of Mac Mouse Fix. And now I'm happy to announce that, when you click a mouse button in Beta 6, that's 2x faster compared to the previous beta! And scrolling is even 4x faster!
  • With Beta 6, MMF will also smartly turn parts of itself off to save your CPU and battery as much as possible.
  • For example, when you're currently using a mouse with 3 buttons but you only have actions set up for buttons not found on your mouse like buttons 4 and 5, Mac Mouse Fix will stop listening to button input from your mouse entirely. Meaning 0% CPU usage when you click a button on your mouse! Or when the scroll settings in MMF match the system, Mac Mouse Fix will stop listening to input from your scroll wheel entirely. Meaning 0% CPU usage when you scroll! But if you set up the Command (⌘)-Scroll to Zoom feature, Mac Mouse Fix will start to listen to your scroll wheel input - but only while you hold down the Command (⌘) key.
  • So it's really smart and will only use up CPU when it has to.
  • This means, MMF is now not only the most powerful, easy-to-use, and polished mouse driver for Mac, it's also one of, if not the, most optimized and efficient!
  • Reduced App Size:
  • At 16 MB, Beta 6 is ca. 2x smaller than Beta 5!
  • This is a side-effect of dropping support for older macOS versions.
  • Dropped Support for Older macOS Versions:
  • I tried hard to get MMF 3 to run properly on macOS versions before macOS 11 Big Sur. But the amount of work to get it to feel polished turned out to be overwhelming, so I had to give up on that.
  • Moving forward, the earliest officially supported version will be macOS 11 Big Sur.
  • The app will still open on older versions but there will be visual and maybe other problems. The app will not open anymore on macOS versions before 10.14.4. This is what allows us to shrink the app size by 2x since 10.14.4 is the earliest macOS version shipping with modern Swift libraries (See "Swift ABI Stability"), which means those Swift libraries don't have to be contained in the app anymore.
  • Scroll Improvements:
  • Beta 6 features great improvements to the configuration and the UI of the new scrolling systems introduced in MMF 3.
  • Greatly simplified and shortened the UI text on the Scroll tab. Most mentions of the word "Scroll" have been removed since it's implied by context.
  • Reworked the scroll smoothness settings to be much clearer and allow for some additional options. Now you can pick between a "Smoothness" of "Off", "Regular", or "High", Replacing the old "with Inertia" toggle. I think this is much clearer and it made space in the UI for the new "Trackpad Simulation" option.
  • Turning off the new "Trackpad Simulation" option disables the rubber band effect while scrolling, it also prevents scrolling between pages in Safari and other apps, and more. Lots of people have been annoyed by this, especially those with free-spinning scroll wheels as found on some Logitech Mice like the MX Master, but others enjoy it, so I decided to make it an option. I hope the presentation of the feature is clear. If you have any suggestions there, let me know.
  • Changed the "Natural Scroll Direction" option to "Reverse Scroll Direction". This means the setting now reverses the system scroll direction and is no longer independent of the system scroll direction. While this is arguably a slightly worse user experience, this new way of doing things allows us to implement some optimizations and it makes it more transparent to the user how to completely turn Mac Mouse Fix off for scrolling.
  • Improved the way that the scroll settings interact with modified scrolling in many different edge cases. E.g. the "Precision" option will no longer apply to the "Click and Scroll" for "Desktop & Launchpad" action since it's a hindrance here instead of being helpful.
  • Improved scroll speed when using "Click and Scroll" for "Desktop & Launchpad" or "Zoom In or Out" and other features.
  • Removed non-functioning link to the system scroll speed settings on the scroll tab which was present on macOS versions before macOS 13.0 Ventura. I couldn't find a way to make the link work and it's not terribly important.
  • Scroll Wheel:
  • Improved animation curve for "Regular Smoothness" (formerly accessible by turning "with Inertia" off). This makes things feel more smooth and responsive.
  • Improved the feel of all the scroll speed settings. The "Medium" speed and the "Fast" speed are faster. There is more separation between "Low" "Medium" and "High" speeds. The speedup as you move the scrollwheel faster feels more natural and comfortable when using the "Precision" option.
  • The way that the scrolling speed ramps up as you keep scrolling in one direction will feel more natural and gradual. I'm using new mathematical curves to model the speedup. The speed ramp-up will also be harder to trigger accidentally.
  • Not ramping up scrolling speed anymore when you keep scrolling in one direction while using the "macOS" scrolling speed.
  • Restricted the scroll animation time to a maximum. If the scroll animation would naturally take more time it will be sped up to stay below the maximum time. That way, scrolling into the page edge with a free-spinning wheel will not have the page content move off-screen for as long. This shouldn't affect normal scrolling with a non-free-spinning wheel.
  • Improved some interactions around the rubberband effect when scrolling into a page edge in Safari and other apps.
  • Fixed an issue where "Click and Scroll" and other scroll-related features wouldn't work properly after upgrading from a very old preference pane version of Mac Mouse Fix.
  • Fixed an issue where single-pixel scrolls were sent with a delay when using the "macOS" scrolling speed together with smooth scrolling.
  • Fixed a bug where scrolling would still be really fast after releasing the Swift Scroll modifier. Other improvements around how scroll speed is carried over from previous scroll swipes.
  • Improved the way that the scroll speed increases with larger display sizes
  • Notarization:
  • Starting with 3.0.0 Beta 6, Mac Mouse Fix will be "Notarized". That means no more messages about Mac Mouse Fix being "Malicious Software" when opening the app for the first time.
  • Notarizing your app costs $100 per year. I was always against this, since it felt hostile towards free and open source software like Mac Mouse Fix, and it also felt like a dangerous step towards Apple controlling and locking down the Mac like they do iOS. But lack of Notarization led to several problems, including ones where nobody could use the app anymore until I released a new version. Since Mac Mouse Fix will be monetized now I thought it was finally appropriate to Notarize the app for an easier and more stable user experience.
  • Chinese Translations:
  • Mac Mouse Fix is now available in Chinese!
  • More specifically, it's available in:
  • Chinese, Traditional
  • Chinese, Simplified
  • Chinese (Hong Kong)
  • Huge thanks to @groverlynn for providing all of these translations as well as for updating them throughout the betas and communicating with me. See his pull request here: #395.
  • Everything Else:
  • Aside from the changes listed above Beta 6 also features many smaller improvements.
  • Removed several options from the "Click", "Click and Hold" and "Click and Scroll" Actions because I thought they were redundant since the same functionality can be achieved otherwise and since this cleans up the menus a lot. Will bring those options back if people complain. So if you miss those options - please complain.
  • Click and Drag direction will now match trackpad swipe direction even when "Natural scrolling" is turned off under System Settings > Trackpad. Before, Click and Drag would always behave like swiping on the trackpad with "Natural scrolling" turned on.
  • Fixed an issue where the cursors would disappear and then reappear somewhere else when using a "Click and Drag" Action during a screen recording or when using the DisplayLink software.
  • Fixed centering of the "+" in the "+"-Field on the Buttons tab
  • Several visual Improvements to the buttons tab. The color palette of the "+"-Field and Action Table has been reworked to look correct when using macOS' "Allow wallpaper tinting in windows" option. The borders of the Action Table now have a transparent color that looks more dynamic and adjusts to its surroundings.
  • Made it so when you add lots of actions to the action table and the Mac Mouse Fix window grows, it will grow exactly as large as the screen (or as the screen minus the dock if you don't have dock-hiding enabled) and then stop. When you add even more actions, the action table will start scrolling.
  • This Beta now supports a new checkout where you can buy a license in US dollars as advertised. Before you could only buy a license in Euros. The old Euro licenses will still be supported of course.
  • Fixed an issue where momentum scrolling sometimes wasn't started when using the "Scroll & Navigate" feature.
  • When the Mac Mouse Fix window resizes itself during a tab switch it will now reposition itself so it does not overlap with the Dock
  • Fixed flicker on some UI elements when switching from the Buttons tab to another tab
  • Improved appearance of animation that the "+"-Field plays after recording an input. Especially on macOS versions before Big Sur, where the shadow of the "+"-Field would appear glitched during the animation.
  • Disabled notificati...

New in Mac Mouse Fix 3.0.0 Beta 5 (Nov 4, 2022)

  • Mouse:
  • Fixed scrolling in Terminal and other apps! See GitHub Issue #413.
  • Fixed incompatibility with some mice under macOS 13 Ventura by moving away from using unreliable Apple APIs in favor of low level hacks. Hope this doesn't introduce new issues - let me know if it does! Special thanks to Maria and GitHub user samiulhsnt for helping to figure this out! See GithHub Issue #424 for more infos.
  • Will not use any CPU when clicking Mouse Button 1 or 2 anymore. Slightly lowered CPU usage when clicking other buttons.
  • This is a "Debug Build" so the CPU usage can be around 10 times higher when clicking buttons in this beta vs the final release
  • The trackpad scrolling simulation that is used for Mac Mouse Fix' "Smooth Scrolling" and "Scroll & Navigate" features is now even more accurate. This might lead to better behaviour in some situations.
  • UI:
  • Automatically fixing issues with granting Accessibility Access after updating from an older version of Mac Mouse Fix. Adopts the changes described in the 2.2.2 Release Notes.
  • Added a "Cancel" button to the "Grant Accessibiliy Access" screen
  • Fixed an issue where configuring Mac Mouse Fix wouldn't work properly after installing a new version of Mac Mouse Fix, because the new version would connect to the old version of "Mac Mouse Fix Helper". Now, Mac Mouse Fix will not connect to the old "Mac Mouse Fix Helper" anymore and disable the old version automatically when appropriate.
  • Giving the user instructions on how to fix and issue where Mac Mouse Fix can't be enabled properly due to another version of Mac Mouse Fix being present on the system. This issue only occurs under macOS Ventura.
  • Polished behaviour and animations on the "Grant Accessibiliy Access" screen
  • Mac Mouse Fix will be brought to the foreground when it it's enabled. This improves the UI interactions in some situations like when you enable Mac Mouse Fix after it's been disabled under System Settings > General > Login Items.
  • Improved UI strings on the "Grant Accessibiliy Access" screen
  • Improved UI strings that show when trying to enable Mac Mouse Fix while it is disabled in System Settings
  • Fixed a German UI string
  • Under-the-hood:
  • The build number of "Mac Mouse Fix" and the embedded "Mac Mouse Fix Helper" are now synchronised. This is used to prevent "Mac Mouse Fix" from accidentally connecting to old versions of "Mac Mouse Fix Helper".
  • Fixed issue where some data around your license and trial period would sometimes display incorrectly when starting the app for the first time by removing cache data from the initial configuration
  • Lots of cleanup of the project structure and source code
  • Improved debug messages

New in Mac Mouse Fix 2.2.3 (Oct 31, 2022)

  • Fixed a bug where the 'Keyboard Shortcut...' option wouldn't do anything under macOS 10.13 High Sierra
  • Fixed a crash when using the 'Keyboard Shortcut...' option more than once under macOS 10.13 High Sierra and 10.14 Mojave
  • Enabled Apple icon rendering on macOS versions before macOS 11 Big Sur. Icons will now display properly in the 'More...' screen, when right-clicking the Action Table, and when recording keyboard shortcuts containing special keys only found on Apple keyboards.
  • Fixed text being cut off on the 'More Sheet' on macOS versions before macOS 11 Big Sur
  • Improved visual attributes of the Action Table like color and text margins on macOS versions before macOS 11 Big Sur
  • Improved color of Toast Notications on macOS versions before macOS 11 Big Sur
  • More under-the hood improvements

New in Mac Mouse Fix 2.2.2 (Oct 24, 2022)

  • Accessibility problems:
  • 2.2.2 solves a problem where "Mac Mouse Fix Helper" couldn't be granted Accessibility Access in System Settings after updating from Mac Mouse Fix 2.2.0 or earlier. See GitHub Issue #412.
  • Bug fixes:
  • Fixed issue where notifications would disappear abruptly instead of fading out with an animation under macOS Ventura
  • Fixed bug where links on the "More..." screen and the "Grant Accessibiliy Access" screen would sometimes open over and over again when clicking anywhere in the Mac Mouse Fix window
  • Other improvements:
  • Improved UI strings in "Grant Accessibiliy Access" screen
  • Under-the-hood improvements

New in Mac Mouse Fix 2.2.1 (Oct 24, 2022)

  • Ventura support:
  • Mac Mouse Fix now fully supports and feels native to macOS 13 Ventura.
  • Special thanks to @chamburr who helped with Ventura support in GitHub Issue #297.
  • Changes include:
  • Updated the UI for granting Accessibility Access to reflect the new Ventura System Settings
  • Mac Mouse Fix will 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
  • 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.
  • Bug fixes:
  • 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.
  • Fixed a crash in 'App-specific settings' when trying to add an app without a 'Bundle ID'. Might help with GitHub Issue #289.
  • Fixed a crash when trying to add apps which don't have a name to 'App-Specific settings'. Resolves GitHub Issue #241. Special thanks to jeongtae who was very helpful in figuring out the problem!
  • More small bug fixes and under-the-hood improvements.

New in Mac Mouse Fix 3.0.0 Beta 4 (Oct 20, 2022)

  • 3.0.0 Beta 4 brings a new "Restore defaults..." option as well as many quality-of-life improvements and bug fixes!

New in Mac Mouse Fix 3.0.0 Beta 3 (Sep 15, 2022)

  • 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.

New in Mac Mouse Fix 3.0.0 Beta 2 (Sep 15, 2022)

  • 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.

New in Mac Mouse Fix 3.0.0 Beta 1 (Sep 12, 2022)

  • :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"!
  • 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.
  • 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! 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:
  • 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 (⌥).
  • You can now see and customize all 4 keyboard modifiers using a beautiful and intuitive new UI.
  • Always-On Precise Scrolling lets you scroll precisely even without holding down a modifier key by moving the scroll wheel slowly.
  • 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.
  • The Scroll Direction Invert Settings are now independent of the System Settings allowing for a less complicated UI.
  • 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 think macOS' Scroll Speed is quite bad 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.)
  • 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 that makes sense. Let me know your thoughts!
  • 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!
  • 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:
  • 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.
  • 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!
  • 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!
  • 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...)
  • Your license is synced via iCloud so it will automatically be available on all your computers!

New in Mac Mouse Fix 2.2.1 Beta 3 (Sep 6, 2022)

  • Mac Mouse Fix 2.2.1 Beta 3 brings back compatibily 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 that 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.

New in Mac Mouse Fix 2.2.1 Beta 2 (Aug 8, 2022)

  • Even more improvements for 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

New in Mac Mouse Fix 2.2.1 Beta 1 (Aug 8, 2022)

  • 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.

New in Mac Mouse Fix 2.2.0 (Jan 17, 2022)

  • 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 and 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. We built this option to make Mac Mouse Fix better compatible with Blender. But in its current form, it was not useful for Blender users because you couldn't combine it with keyboard modifiers. I'll try to improve Blender compatibility in a future release.

New in Mac Mouse Fix 2.1.0 (Jan 9, 2022)

  • I signed the app with a new certificate. The old certificate was revoked by Apple which renders old versions of Mac Mouse Fix unusable.
  • 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".

New in Mac Mouse Fix 2.0.0 (Jan 5, 2022)

  • 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.
  • 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 just using a single Button!
  • That's not all. The new Action Table allows you to put even more Actions to that same Button. You can easily get 7x more functionality out of a single Button compared to conventional Mouse Drivers. All while also being more simple to use and set up than the competition. Call that a flex. :O
  • Mac Mouse Fix Gestures also feel much more fluid and responsive than any other driver on the market.
  • This is possible because I reverse engineered the Apple Trackpad Driver to emulate how it works. If other drivers copy this, you know what's up. ;)
  • 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.
  • Updates:
  • 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:
  • Various bug fixes and stability improvements.

New in Mac Mouse Fix 2.0.0 Beta 13 (Jan 4, 2022)

  • 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

New in Mac Mouse Fix 2.0.0 Beta 12 (Jul 15, 2021)

  • Mac Mouse Fix will now automatically repair the permissions on the ~/Library/LaunchAgents folder. This fixes an issue where some people couldn't enable Mac Mouse Fix.
  • Thanks to @maddn who found the cause of this problem in Issue #117, and to everyone else who reported the issue.
  • Resolved an issue where Click and Drag wouldn't work when Caps Lock was enabled. Fixes #136.
  • When using Click and Drag to move between Spaces, the animation follows the mouse pointer more closely.
  • Removed the colon at the end of the label of the Smooth scrolling checkbox as @FraserEmbrey suggested in Issue #135.
  • Improved UI strings.

New in Mac Mouse Fix 2.0.0 Beta 11 (Jun 13, 2021)

  • Small bug fixes and under-the-hood improvements.

New in Mac Mouse Fix 2.0.0 Beta 10 (May 30, 2021)

  • Reworked the 'Grant Accessibility Access' screen
  • Improved responsiveness of Click and Drag actions
  • Added a 'Get Help' link to the 'More...' view
  • Fixed an issue where Mac Mouse Fix Actions sometimes stopped working when the system was under heavy load. Might fix this GitHub Issue.
  • Made previously dead links link to the new Guides on GitHub
  • Improved enabling mechanism. The 'Enable Mac Mouse Fix' checkbox will now only be checked once Mac Mouse Fix Helper has successfully launched. This should provide the user better feedback if something goes wrong.
  • Many other small under-the-hood and UI improvements

New in Mac Mouse Fix 2.0.0 Beta 9 (May 7, 2021)

  • This beta features some bug fixes and quality of life improvements when running in a multi-user environment.

New in Mac Mouse Fix 2.0.0 Beta 8 (May 6, 2021)

  • Reverted changes to input processing introduced in Beta 6 because it lead to issues where the mouse pointer would get stuck in place. See this Github Issue for more info.
  • Added a help link to the 'Grant Accessibility Access' screen

New in Mac Mouse Fix 2.0.0 Beta 7 (May 6, 2021)

  • Signed the app with a new certificate. The old certificate was revoked which lead to problems. See this GitHub Issue.
  • This and future Mac Mouse Fix Beta releases will run natively on M1 Macs.
  • Small bug fixes and improvements.

New in Mac Mouse Fix 1.0.4 (May 6, 2021)

  • Signed the app with a new certificate. The old certificate was revoked which renders old versions of Mac Mouse Fix unusable. See this GitHub Issue for more info.
  • Fixed an issue where Mac Mouse Fix wouldn't work properly when it was launched from the Downloads folder
  • Added a help link to the 'Grant Accessibility Access to Mac Mouse Fix Helper' screen

New in Mac Mouse Fix 2.0.0 Beta 6 (May 4, 2021)

  • Now using Sparkle for updates. This brings the following improvements:
  • You can now opt-in to receive automatic updates to new beta versions
  • Releasing new updates is now faster and easier
  • Updating is now more secure
  • I can now count downloads for free without compromising users privacy by using Google Analytics or other tracking software
  • Sparkle is generally more robust and flexible compared to the old updating mechanism making future changes easier
  • Made some changes to how input is processed that might fix #93

New in Mac Mouse Fix 2.0.0 Beta 4 (Apr 16, 2021)

  • Various improvements to the user experience.
  • The remap table is now grouped by button, making it much easier to parse, especially when using many actions on the same button.
  • The default configuration now features lots more actions mapped to the Middle Button. Namely 'Look Up', 'Show Desktop', 'Launchpad', and 'Mission Control & Spaces'. I think that, with the new cleaned-up layout, this is not overwhelming to new users like it would have been with the old layout. It teaches users about the possibilities and it empowers users who don't like to spend much time setting things up.
  • Introduces toast notifications. These allow Mac Mouse Fix to show peripheral and contextual information without obstructing what the user wants to do.
  • When a button is captured or uncaptured by Mac Mouse Fix a toast appears with info on what's happening and a link to a help page. (Link is not currently working)
  • When the user tries to assign an action to the Primary or Secondary Mouse Button - which is not currently supported - a toast appears providing appropriate feedback.
  • Many other small improvements.

New in Mac Mouse Fix 1.0.3 (Apr 16, 2021)

  • Fixes an issue where the app-specific settings table would sometimes display its first column super wide after switching to dark mode
  • Fixes several issues that would occur when installing the app version of Mac Mouse Fix while the old preference pane version was still running. Resolves #67.

New in Mac Mouse Fix 2.0.0 Beta 3 (Apr 8, 2021)

  • Changes in Beta 3:
  • Fixed some issues when upgrading from the old prefpane version of the app to the new app version
  • Fixed some issues when running the app without moving it out of the Downloads folder
  • Minor UI and UX improvements. The Click and Drag should now follow the mouse pointer super closely.

New in Mac Mouse Fix 2.0.0 Beta 2 (Mar 30, 2021)

  • Use keyboard shortcuts right from your mouse! I made sure this feature is super easy to use and incredibly flexible, just like the rest of the new remapping engine. I think you'll love it!
  • Various small tweaks to UI text and layout.
  • Fixes a bug where some users couldn't close the Add Window. (Thanks @4332weizi!)

New in Mac Mouse Fix 2.0.0 Beta 1 (Mar 25, 2021)

  • Click and drag to use Mission Control, switch between Spaces or see Application Windows from a single button in a highly responsive and intuitive way. This is made possible because due to reverse engineering the way that touch input is processed by macOS to enable for unparalleled simulation of 3 finger swipes on an Apple Trackpad.
  • Brand new, best-in-class remapping engine that lets you configure your mouse buttons in whatever way you want in a super easy way. Fully supports mice with up to 32 buttons. Use double click, click and hold, click and drag, keyboard modifiers and more to make your mouse super useful.
  • Added an option to use 'Smart Zoom' right from your mouse.
  • Added options to use the default functions of Mouse Buttons alongside the additional ones that Mac Mouse Fix provides.
  • Added option to simulate mouse button click input. Hold the Option (⌥) key while choosing a function for a mouse button to see this option. (Use the 'Open Link in new Tab' option to simulate clicks of the Middle Mouse Button)
  • Added an option to simulate mouse button 3 click and drag, so you can use Blender and other software alongside the other features provided by Mac Mouse Fix. Hold the Option (⌥) key while choosing a function for a click and drag input to see this option.

New in Mac Mouse Fix 1.0.2 (Mar 23, 2021)

  • This release fixes an issue where the "Invert scrolling direction" option would always re-enable itself after launching the app. (See #68)

New in Mac Mouse Fix 1.0.1 (Mar 23, 2021)

  • Icons on the 'More...' sheet are now displayed properly on older macOS versions.
  • Mac Mouse Fix is now a Universal Binary running natively on M1 Macs.
  • Improved scrolling behaviour when Smooth Scrolling is turned off. Fixes #61.

New in Mac Mouse Fix 1.0.0 (Mar 2, 2021)

  • Mac Mouse Fix is now an App instead of a Preference Pane
  • Updated and optimized for macOS 11 BigSur
  • Added support for macOS 10.11 El Capitan
  • Added compatibilty to many mice including the Logitech MX Master
  • You can now swap the side buttons functions if they happen to be inverted on your mouse (Shoutouts to @divadretlaw!)
  • Added Dark Mode support (Thank you @stevenguh!)
  • Mac Mouse Fix will now completely uninstall itself automatically after you move it to the Trash (Just make sure that 'Enable Mac Mouse Fix' is checked before you do so)
  • Mac Mouse Fix now takes even less space and is lighter on your CPU
  • Keyboard modifier interception is now completely disabled when no mice are attached to your computer
  • You can now zoom in and out by holding Command (⌘) while scrolling
  • Updated App Icon
  • You can now disable smooth scrolling for specific apps
  • Added 'Look Up' and 'Launchpad' options, which were removed in 0.9.1, back in
  • New and improved 'More...' screen
  • Even more responsive scrolling through use of multi-threading and other techniques
  • Various other bug fixes and under-the-hood improvements

New in Mac Mouse Fix 0.9.1 (Oct 16, 2019)

  • Fixed compatiblity with Catalina by fixing a bug that would occur when setting up a message port to communicate with the Mouse Fix Helper application from within the Mouse Fix prefpane.
  • Added full support for Bluetooth mice, by improving device management code.
  • Fixed scrolling and zooming in certain apps like Terminal, Launchpad, and Pixelmator, by adding a different type of scroll delta value to the artificial scroll events.
  • Made smooth scrolling slightly more responsive by only updating display synchronization and app specific configurations on the first of each series of consecutive scrollwheel ticks.
  • Smooth scrolling now ignores all adobe apps.
  • Added the ability to invert scrolling direction without enabling smooth scrolling.
  • Removed the ability to remap to 'Launchpad' entirely. Sorry to everyone who used that feature. Please check out the excellent Steer Mouse to replicate this functionality. Other great alternatives are USBOverdrive, BetterTouchTool or ControllerMate. My reasoning behind this is that the Launchpad option was not really compatible with any of the other options for the Middle Button. Suppose that clicking the Middle Button is mapped to Mission Control, and holding it is mapped to Launchpad. After opening Launchpad with a long press, the user will likely expect a click of the Middle Button to dismiss Launchpad, but instead, it will immediately switch to Mission Control, which is unexpected and confusing for some people (I tested this on my dad). I might add Launchpad back in, if I find a solution for this Problem. In the meantime, please consider one of the alternatives mentioned above.
  • Removed the ability to remap clicking and holding the middle button to 'Look Up', as this option might lead to a bad user experience. The problems with this option were similar to the problems with the Launchpad option described above.