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