Skip to content
SPECIFICTION
Get listed

ZMouse

github.com

macOS

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

Alternatives to ZMouseAll alternatives →