mousemap
mousemap: A focused open-source remapper for Mac users who need extra mouse-button actions. Ranked #87 of 105 in Keyboard and Mouse Customization Software by our editors (5.3/10); pricing: Open source; best for macOS users remapping extra mouse buttons.
At a glance
- Editor score5.3 / 10
- PricingOpen source
- Best formacOS users remapping extra mouse buttons
- Paid fromFree
- Supported operating systemsMacos
- Facts checked22 Sep 2026

Where it wins
- Maps extra mouse buttons to shortcuts or shell commands
- Includes menu bar app, settings editor, CLI, and verbose mode
- Supports JSON configuration, pass-through clicks, and start-at-login
Where it doesn't
- macOS-only, with no Windows or other operating-system support
- Focused on button remapping rather than broader mouse customization
- Requires Accessibility permission for the app
Our verdict on mousemap
mousemap is an open-source desktop utility for macOS users who want to assign custom actions to mouse buttons, including extra side buttons. Built in Swift, it intercepts mouse-button presses through a macOS event tap and maps them to keyboard shortcuts or shell commands. That makes it a practical fit for solo users and small teams with a specific remapping need, especially when a standard mouse driver does not provide the desired action.
The project offers several ways to manage the configuration. A menu bar app provides start and stop controls, configuration access, reload support, and a settings editor for adding, editing, and removing mappings. Advanced users can work with a JSON configuration file at a configurable path, while the command-line interface provides verbose button-event output. Optional pass-through preserves the original click, and start-at-login support is provided through a macOS LaunchAgent.
mousemap is free and open source, but its value comes from focused control rather than a broad customization suite. It suits Mac users who need button-to-shortcut or button-to-command mappings and are comfortable granting Accessibility permission and managing a compact configuration. Users seeking a wider mouse-management system should choose an alternative if they need cross-platform support, dedicated macro recording, per-application profiles, onboard device memory, polling-rate control, or sensitivity settings.
Your product? Our editors can test mousemap in depth and publish a review, labelled as paid · from $149/mo →
mousemap pricing
mousemap fact sheet
| Free plan | Not verified |
|---|---|
| Paid from | Free |
| Supported operating systems | Macos |
| Macro support | Not verified |
| Per-app profiles | Not verified |
| Onboard device memory | Not verified |
| Polling rate control | Not verified |
| Sensitivity controls | Not verified |
| Profile slots | Not verified |
| Deployment | Desktop |
| Platforms | macOS |
| Support | Community |
| Built for | Solo, Small business (editorial estimate) |
| Pricing | Open source |
| Website | github.com |
| Facts checked | 22 Sep 2026 |
Alternatives to mousemap
- Razer SynapseA free Razer-focused hub for remapping, macros, profiles, and Chroma lighting.9.2
- Logi Options+A broad free toolkit for remapping, automation, profiles, and multi-computer control.9.1
- Logitech G HUBA free desktop suite for Logitech G lighting, profiles, and device settings.9.0
See all mousemap alternatives →
Used mousemap? Be the first to review it
The editor score above is our own research. What this page doesn't have yet is a reader's view — what you used mousemap for, what worked and what didn't. No stars are seeded and no review is paid for; an editor reads every one before it appears.
Write a reviewTwo minutes · verified accounts only · read by an editor before it appears
Featured on iTechGuides
mousemap is listed in our Keyboard and Mouse Customization Software directory. Add the badge to your site — it links back to this page.
<a href="https://www.itechguides.com/products/mousemap/"><img src="https://www.itechguides.com/best/badge/mousemap.svg" alt="Featured on iTechGuides" width="230" height="46"></a>
Reviewed by iTechGuides Editors · Editorial team · Updated Oct 2026
Advertiser disclosure: iTechGuides is reader-supported. Vendors can pay for top positions in our rankings and for a place on other products' pages, and we may earn a commission when you click some links. Bought places stand at the number bought; this page and our disclosure say so. Paying vendors may get a fuller, more detailed review from our editors, and that review can change their score. How we rank.
Last updated · How we research and update


