Skip to content
SPECIFICTION
Get listed

mousemap

github.com

macOS

Spec sheet

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

Where Specifiction places it

Alternatives to mousemapAll alternatives →