ZMouse
github.com
Spec sheet
- Purpose
- ZMouse is a per-device mouse button and keystroke remapper for macOS, written in Rust.Read 12 Oct 2026 · github.com
- License
- The GitHub repository identifies its license as MIT.Read 12 Oct 2026 · github.com
- Availability
- The README describes ZMouse as a personal, macOS-only project that works on the author’s hardware and may have rough edges.Read 5 Oct 2026 · github.com
- Build and install
- The README documents building from source with Rust or bundling a self-signed .app for installation in /Applications.Read 5 Oct 2026 · github.com
- Button actions
- A button can send a keystroke with modifiers, map to another mouse button, or be disabled.Read 12 Oct 2026 · github.com
- CLI
- The command-line interface can launch the app, edit or apply mappings, list mice, inspect HID and event-tap streams, and diagnose scroll-wheel deltas.Read 12 Oct 2026 · github.com
- Configuration
- Configuration is stored at ~/Library/Application Support/zmouse/config.toml.Read 5 Oct 2026 · github.com
- Device grouping
- The app can group multiple identities for one physical mouse so they share one set of mappings.Read 12 Oct 2026 · github.com
- Device mappings
- Mappings use USB vendor and product IDs and are designed to survive reconnects, reboots, and switching between a wireless mouse’s dongle and Bluetooth.Read 5 Oct 2026 · github.com
- Install and platform
- The stated requirement is macOS on Apple Silicon or Intel; the README describes building and installing from source with Rust.Read 12 Oct 2026 · github.com
- Interface
- ZMouse includes a native menu-bar app and an egui configuration editor, and edits apply live.Read 12 Oct 2026 · github.com
- Keystroke buttons
- MMO thumb buttons that emit keys such as 1–9, 0, - and = can be remapped per device without remapping a real keyboard.Read 12 Oct 2026 · github.com
- Per-device mappings
- Mappings use stable USB vendor and product IDs and are designed to persist across reconnects, reboots, and switching a wireless mouse between its dongle and Bluetooth.Read 12 Oct 2026 · github.com
- Permissions
- The app requires Accessibility and Input Monitoring permissions on first launch.Read 12 Oct 2026 · github.com
- Project status
- The maker describes ZMouse as a personal project that works on the author's hardware and may have rough edges.Read 12 Oct 2026 · github.com
- Safety
- The built-in Apple trackpad and keyboard are excluded from device discovery.Read 5 Oct 2026 · github.com
- Safety behavior
- The built-in Apple trackpad and keyboard are excluded from device discovery.Read 12 Oct 2026 · github.com
- Scroll controls
- Scroll-wheel options include a jitter filter and a weak-tick boost, and the app says it never touches trackpads.Read 12 Oct 2026 · github.com
- Supported operating systems
- macosRead 22 Sep 2026 · github.com
Where Specifiction places it
- Keyboard and Mouse Customization Software#104 of 1056.7