mousemap
The facts below are what the maker publishes about mousemap, checked and dated. Our editors have not written about it yet.
The facts
Each one read from mousemap's own pages, with the date it was checked.
What it does
- Actions
- It maps mouse buttons, including extra side buttons, to keyboard shortcuts or shell commands.checked 12 Oct 2026
- Build
- The README provides a Swift release-build command and describes both CLI and menu bar app binaries.checked 12 Oct 2026
- Click behavior
- Each mapping can optionally pass the original click through to apps.checked 5 Oct 2026
- Compatibility
- The project describes itself as macOS-only and requires macOS Accessibility access.checked 12 Oct 2026
- Configuration
- Mappings use JSON, defaulting to ~/.config/mousemap/config.json, and can be supplied from a custom path.checked 12 Oct 2026
- Distribution
- The repository links an MIT license and describes building the CLI and menu bar app with Swift Package Manager.checked 5 Oct 2026
- Interface
- The menu bar app includes a JSON settings editor with add, edit, remove, save, and automatic reload functions.checked 12 Oct 2026
- Login
- The menu’s Start at Login option installs a LaunchAgent pointing to the built binary.checked 5 Oct 2026
- Login support
- The menu bar app can start at login by installing a LaunchAgent plist.checked 12 Oct 2026
- Pass-through
- Each mapping can optionally let the original click reach apps alongside the mapped action.checked 12 Oct 2026
- Permission
- The app requires macOS Accessibility permission to intercept and post input events for remapping.checked 5 Oct 2026
- Permissions
- macOS Accessibility permission is required to receive and post input events for remapping.checked 12 Oct 2026
- Privacy
- The app says it runs locally, does not collect or send data, and only reads its config file.checked 12 Oct 2026
- Purpose
- mousemap is a lightweight, macOS-only mouse button remapper built in Swift.checked 12 Oct 2026
- Releases
- The repository page showed no releases when opened.checked 5 Oct 2026
- Support
- The README invites contributions through pull requests with a clear description and any testing done.checked 12 Oct 2026
- Supported operating systems
- macoschecked 22 Sep 2026
- Who it serves
- The maker describes it as a macOS menu bar tool for mapping extra mouse buttons to shortcuts or shell commands.checked 5 Oct 2026
Where it runs
- App interface
- The menu bar app includes a JSON settings editor that can add, edit, and remove mappings, save them, and auto-reload configuration.checked 5 Oct 2026
- Mappings
- Supported shortcut keys include letters, digits, arrows, common editing and navigation keys, and F1–F12.checked 12 Oct 2026
Alternatives to mousemap
- 1
SteelSeries GG
Free planAndroidiOSWebAPI8.3Free plan - 2
be quiet! IO Center
Free planWebLinuxmacOSWindows7.9Free plan - 3

Akko Cloud Driver
Free planWebmacOSWindows7.8Free plan - 4
MonsGeek Driver
Free planWebLinuxmacOSWindows7.8Free plan - 5
ROCCAT Swarm II
Free planAndroidiOSWindows7.8Free plan - 6
Rebind
Free planmacOSWindows7.7$140 one-time
