v1.2.3

MX Master 3 battery readings marked as approximate

The MX Master 3's firmware only exposes the legacy BATTERY_STATUS (0x1000) feature over Bluetooth, which reports four discrete levels (100/50/20/5) rather than a true state of charge — so it legitimately shows 100% for days after a full charge, then jumps to 50%. The dropdown now labels these readings "approx., mouse reports 4 levels".

MX Master 3S / 4 (UNIFIED_BATTERY, true 1% state of charge) are unchanged. README updated with the per-model precision difference and a troubleshooting entry.

Install: verify with shasum -a 256 -c checksums.txt, unzip, move to /Applications. See README for Gatekeeper/Input Monitoring steps.

🤖 Generated with Claude Code

MX Battery 1.2.2

Fixes the app getting stuck on "mouse not responding" after the Mac sleeps or is locked for a while. The cached macOS IOKit handle went stale across sleep/wake and never rebuilt; the app now rebuilds it and retries automatically, recovering on the first poll after wake.

Verify the download

shasum -a 256 -c checksums.txt

Expected: 2758dc20ee247296054fc566031c7ab5ca350887524e5b2f13f71ed707ffb267 MXBattery-1.2.2.zip

First launch

Signed with a self-signed developer certificate (not Apple-notarized): right-click MXBattery.app > Open > Open (once). Grant Input Monitoring under System Settings > Privacy & Security, relaunch. Building from source is four commands — see the README.

MX Battery 1.2.1

Fixes the Open at Login menu item, which was missing from the menu in 1.2.0. Also the first release signed with a stable developer certificate.

Verify the download

shasum -a 256 -c checksums.txt

Expected: 3575040bbfdcbbfcd86aa9b38ef94ec85aa457e5e77c9dff0d20bc3855c4d72d MXBattery-1.2.1.zip

First launch

Signed with a self-signed developer certificate (not Apple-notarized), so Gatekeeper still warns on first open: right-click MXBattery.app > Open > Open (once). Grant Input Monitoring under System Settings > Privacy & Security (required by macOS for any HID device access), relaunch. Building from source is four commands — see the README.

MX Battery 1.2.0

Superseded by v1.2.1 — the Open at Login menu item was missing in this build. Please use the latest release. Binary removed to prevent installs of the broken version.

MX Battery 1.1.0

First packaged release.

Menu bar battery monitor for Logitech MX Master 3 / 3S / 4 over Bluetooth, reading real state of charge via HID++ 2.0. No Logitech software, no network access, read-only toward the device. HID access is the repo's own ctypes/IOKit module — no third-party HID code.

Verify the download

shasum -a 256 -c checksums.txt

Expected: 96e7da61e06f841ea2cde220ad29417159d7de2650c5c54b4e356d5222a83422 MXBattery-1.1.0.zip

First launch

The app is built locally and not notarized with Apple, so Gatekeeper will warn on first open: right-click MXBattery.app > Open > Open (once). Then grant Input Monitoring under System Settings > Privacy & Security (required by macOS for any HID device access; see README for why), and relaunch. Prefer not to trust a prebuilt binary? The README covers building from source in four commands.