On the recordRead 12 Oct 202619 facts
ZMouse
On the record
- Availability
- The README describes ZMouse as a personal, macOS-only project that works on the author’s hardware and may have rough edges.github.com · read 5 Oct 2026
- Build and install
- The README documents building from source with Rust or bundling a self-signed .app for installation in /Applications.github.com · read 5 Oct 2026
- Button actions
- A button can send a keystroke with modifiers, map to another mouse button, or be disabled.github.com · read 12 Oct 2026
- 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.github.com · read 12 Oct 2026
- Configuration
- Configuration is stored at ~/Library/Application Support/zmouse/config.toml.github.com · read 5 Oct 2026
- Device grouping
- The app can group multiple identities for one physical mouse so they share one set of mappings.github.com · read 12 Oct 2026
- 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.github.com · read 5 Oct 2026
- Install and platform
- The stated requirement is macOS on Apple Silicon or Intel; the README describes building and installing from source with Rust.github.com · read 12 Oct 2026
- Interface
- ZMouse includes a native menu-bar app and an egui configuration editor, and edits apply live.github.com · read 12 Oct 2026
- Keystroke buttons
- MMO thumb buttons that emit keys such as 1–9, 0, - and = can be remapped per device without remapping a real keyboard.github.com · read 12 Oct 2026
- License
- The GitHub repository identifies its license as MIT.github.com · read 12 Oct 2026
- 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.github.com · read 12 Oct 2026
- Permissions
- The app requires Accessibility and Input Monitoring permissions on first launch.github.com · read 12 Oct 2026
- Project status
- The maker describes ZMouse as a personal project that works on the author's hardware and may have rough edges.github.com · read 12 Oct 2026
- Purpose
- ZMouse is a per-device mouse button and keystroke remapper for macOS, written in Rust.github.com · read 12 Oct 2026
- Safety
- The built-in Apple trackpad and keyboard are excluded from device discovery.github.com · read 5 Oct 2026
- Safety behavior
- The built-in Apple trackpad and keyboard are excluded from device discovery.github.com · read 12 Oct 2026
- Scroll controls
- Scroll-wheel options include a jitter filter and a weak-tick boost, and the app says it never touches trackpads.github.com · read 12 Oct 2026
