MX Mouse v0.2.0 — More mice, one small helper

MX Mouse v0.2.0 — More mice, one small helper

New

• One native helper manages multiple compatible Logitech mice, including separate paired slots on a receiver. Each mouse has its own settings and connection state.
• Feature and button discovery replaces the two-model admission list. Settings shows the controls reported by the mouse, including extra buttons and M705 variants with different layouts.
• Bolt and additional Unifying-compatible receiver definitions, including selected Nano and Lightspeed transports. Receiver discovery does not guarantee every paired device supports the implemented features.
• Independent MX Master 4 gesture-button and Haptic-panel bindings when temporary button diversion is supported. Haptic feedback and raw-XY gestures are not implemented.
• Device selection, a generic control list for additional models, and per-device profiles that preserve existing global defaults.

Fixed

• Receiver mice that report no serial over HID++ (such as the M705 101b) no longer stay stuck on "Receiver pairing changed". A receiver mouse is now identified only by its receiver pairing serial.

• A mouse with a new ID (new receiver, re-pairing or older profile key) uses the saved profile of the same model automatically.

• Wider device sidebar with wrapped model names, aligned connection and battery details, and a restored previous-pairings toggle. Historical connections for a listed model no longer appear as extra devices; separate current mice keep separate rows and profiles.

• Known mouse diagrams retain their arrows and clickable inline shortcut editors when additional controls are discovered. Point & Scroll sits below the diagram, and the footer aligns Uninstall Options+, permissions and Start at login.

• Quit Options+ appears only while Options+ is running. Removed redundant control instructions and unused hidden UI state.

• Coarse upper battery levels now say “High (approx.)”; “Full” is reserved for an explicit charge-complete report.

• Receiver discovery uses the paired mouse serial before waking it, preserving its profile and offline shortcut editors across helper restarts.

• The helper is explicitly marked as a hidden agent so MX Mouse stays out of Force Quit when Settings is closed. Verified in the macOS Force Quit dialog with the helper running.

• Opening Settings starts the helper before mouse discovery and automatically quits a conflicting Logi Options+ agent. Failures are reported.

• Installation detects helpers launched under their login-item identifier; Settings recognises a resident helper whose executable path disappeared during replacement.

• Restored M705 artwork, clickable button labels and connector arrows, including wheel tilt, using Options+ artwork and layout metadata.

• Remembered mice retain their last known layouts and editable shortcuts while offline, after receiver removal, and across Settings/helper restarts. Existing MX Master 3 installations receive a baseline layout until discovery refreshes it.

• The README distinguishes resident helper memory from the additional memory used only while Settings is open.

• Unsupported optional wheel or DPI settings no longer disable working button shortcuts.

• Failed receiver discovery retries automatically, even if the initial scan found no mouse. Wake and settings reload retry immediately.

• A sleeping or disconnected paired mouse shows as waiting and retains wake recovery, without repeatedly logging expected offline errors.

• Settings initially selects a connected mouse instead of the first offline pairing. Explicit selections remain stable.

• Receiver-slot replacements cannot receive cleanup writes intended for the previous mouse.

Footprint and validation

The helper executable is 112,672 bytes, 17,536 bytes larger than the reconnect-fix baseline. It uses the same macOS frameworks, with no additional resident runtime or worker process. Persistent application state is 2,264 bytes per discovered mouse and 256 bytes per transport on arm64; framework and HID allocations are additional.

Earlier builds with one M705 active through Unifying and an additional MX Master 3 pairing offline measured helper physical footprint below 5 MiB. Longer-running samples were 4.39 MiB; five samples of an earlier build with Settings closed were 3.05 MiB. This is a one-active-mouse result, not a two-mouse memory measurement.

Native tests pass with AddressSanitizer/UndefinedBehaviorSanitizer where applicable. Coverage includes receiver routing and replacement, actual MX Master 3S/4 control-table fixtures, independent gesture/Haptic bindings, reconnect and scan retries, profile isolation, device selection, unsupported controls, import and installation. The release ZIP is extracted and both app signatures, version numbers and architecture are verified before publication.

Hardware limits

The new implementation has been checked for discovery, configuration and battery reporting on an older M705 (101b) through a Unifying receiver. MX Master 3 for Mac Bluetooth has hardware evidence from earlier builds. Physical button/scroll interaction, two simultaneously awake mice, MX Master 3S/4, Bolt, reconnect and sleep/wake testing remain incomplete for this release. The updated build also has discovery, configuration and coarse battery evidence for the newer M705 (406d) through Unifying, with MX Master 3 for Mac connected simultaneously.

Only features the helper implements are exposed. HID++ 1.0-only mice, older Gestures2 thumbwheels and alternative gaming-mouse control/DPI protocols require additional backends. See coverage and verification tiers.

Install

Updated v0.2.0 package: bundle build 8, including sidebar and footer layout fixes, preserved inline shortcut editors, accurate coarse battery labels and receiver identity recovery for offline editing.

Apple Silicon · macOS 13+. Download the ZIP, unzip, and drag MX Mouse Settings into Applications. Quit Settings and gracefully stop its helper before replacing an older installation. Existing settings are preserved. See upgrade instructions.

Development-signed and not notarized; macOS may require Privacy & Security → Open Anyway. Grant permissions to the embedded MX Mouse Helper if requested, and quit competing mouse controllers first.

MX Mouse v0.1.2 — Reconnect recovery

MX Mouse v0.1.2 — Reconnect recovery

Fixed

After reconnecting an MX Master, the helper could fail its initial HID++ handshake and stop trying. Settings still displayed the saved shortcut, but the mouse button did not trigger it.

The helper now retries failed handshakes automatically, backing off from 1 second to 30 seconds between attempts. Retries stop once connected, removed, or shut down. Saved shortcuts are preserved.

Install

Apple Silicon · macOS 13+. Download the ZIP, unzip, and drag MX Mouse Settings into Applications. Quit Settings and stop its helper before replacing an older installation. See upgrade instructions.

Development-signed and not notarized; macOS may require Privacy & Security → Open Anyway. Use Set Up… to grant helper permissions if requested. Quit competing mouse controllers first.

Validation and limits

Automated tests cover failed-handshake retry, backoff, timer cleanup, and suppression during normal connection, removal, shutdown, and diagnostic probes. Parser, storage, device, importer, and installer tests pass. The signed app was checked on a connected MX Master 3 for Mac; the user confirmed the shortcut worked after recovery. Repeated physical reconnect and sleep/wake testing remain incomplete.

Device support is unchanged: MX Master 3 for Mac over direct Bluetooth and Logitech M705 through a Unifying receiver. Multiple simultaneous mice remain unsupported.

MX Mouse v0.1.1 — M705 + Unifying

MX Mouse v0.1.1 — M705 + Unifying

New

• Logitech M705 through a Logitech Unifying USB receiver (046d:c52b, paired mouse 101b). Includes the older thumb-button variant.
• Model-specific settings with a real M705 image and thumb-button callout.
• Battery indicator when the mouse reports it: percentage or a coarse label.
• Clear selected/unselected control labels; no dashed focus outline.

MX Master 3 for Mac over direct Bluetooth remains supported. Saved settings are preserved; new thumb bindings default to native behavior.

Install

Apple Silicon · macOS 13+. Download the ZIP, unzip, and drag MX Mouse Settings into Applications. Quit the existing Settings app and stop its helper before replacing an older installation. See the README setup link for upgrade steps.

Development-signed and not notarized; macOS may require Privacy & Security → Open Anyway. Use Set Up… to grant helper permissions if requested. Quit competing mouse controllers first.

Limits and validation

M705 wheel tilt remains native; no M705 software DPI, SmartShift, or thumb-wheel controls. Bolt, other receiver models, and multiple simultaneous mice are unsupported. Options+ profile import remains specific to MX Master 3 profiles.

Live M705 discovery, capability queries, configuration, battery queries, and clean shutdown were checked. Full button/scroll interaction and sleep/wake testing remain incomplete. Automated parser, storage, receiver-pairing, importer, and installer checks pass. The packaged app's signatures are verified after ZIP extraction.

MX Mouse v0.1.0 — experimental

MX Mouse v0.1.0 — experimental

Small native macOS settings app with a separate C mouse helper.

• Configure five buttons, wheel speed/direction, wheel modes, and pointer DPI.
• Autosave, optional start at login, and supported global Options+ imports.
• Thumb button defaults to native behavior. Existing saved bindings are preserved.
• Settings exits completely when closed.

Download and install

Apple Silicon (arm64), macOS 13 or later. Download MX-Mouse-v0.1.0-macos-arm64.zip, unzip, and drag MX Mouse Settings into Applications.

This build is development-signed and not notarized. macOS may block opening it; if you trust this release, use System Settings → Privacy & Security → Open Anyway, then follow the prompts. Click Set Up… in the app to grant MX Mouse Helper Input Monitoring and Accessibility access. Quit competing mouse controllers first.

Supported hardware and testing

Only MX Master 3 for Mac (046d:b023), direct Bluetooth is implemented. Other models and receivers are unsupported. Connected-mouse behavior, reconnect, and sleep/wake still need hardware verification.

Automated parser, configuration, device-registry, Options+ importer, and installer regression checks pass. Bundle signatures are checked after extracting the release ZIP. These checks do not replace hardware testing.

The helper measured 4.3 MB (Activity Monitor) with an MX Master 3 for Mac connected over Bluetooth. Settings uses about 29 MB while open and exits when closed.

The release includes settings recovery, handshake retry on settings reload/system wake, installer replacement fixes, and removal of unused UI state. No App Store or notarization submission is involved.