MacRazer v0.1.5

Daily update check, hover tooltips on the battery-usage charts, and a fix for charge-history resetting on sleep/wake.

What changed since v0.1.4

Added

• Update check. The app checks GitHub once a day for a newer release and shows a card in the popover (plus a badge dot on the menu bar icon) when one is available, with a one-click "Download" that fetches the new DMG and opens it in Finder.
• Hover tooltips on the battery-usage charts. Hovering the discharge curve or a past-charge bar shows its value/time next to the section title.

Changed

• "Time since last full charge" is now "Time since last charge", and shows the percentage the cycle started from (e.g. "1d 4h (from 73%)") — the cycle boundary isn't necessarily a full 100% charge, so the old label was misleading for partial top-ups.

Fixed

• A one-off garbage charging-status read right after sleep/wake (or a reconnect) no longer wipes the whole discharge history. A not-charging→charging transition now has to be confirmed on two consecutive polls before it's trusted, since acting on a single bad read destructively reset the "time since last charge" timer to ~0.

Install

Download MacRazer.dmg below, open it, and drag MacRazer into Applications.

This build is unsigned (no paid Apple Developer ID), so Gatekeeper will warn on first launch. Right-click the app, choose Open, then confirm — see the README's Install section for details.

Still marked pre-release: not all device types have been verified on real hardware.

MacRazer v0.1.4

Battery usage graph, plus a round of bug fixes from a broader code review.

What changed since v0.1.3

Added

• Battery usage graph. A chart-icon button beside the battery percentage opens a new page showing the current discharge curve (live, since the last charge), the discharge rate, time since the last full charge, and a bar chart of the last 10 charge cycles with their average length.

Changed

• Time estimates now break down into days once they pass 24 hours (e.g. "~1d 4h") instead of showing raw hour counts.

Fixed

• The implausible-battery-jump guard now stays active permanently instead of disabling itself after the first successful post-reconnect read.
• A flaky serial-number read on reconnect no longer fragments a device's battery history across two files.
• The button-remap event tap is now torn down when Accessibility is revoked at runtime instead of leaking.
• Corrupted HID responses (bad CRC) are now logged instead of silently accepted.
• The battery level bar no longer flashes red before the first reading completes.
• HIDMonitor's IOKit callback context is now properly retained, removing a theoretical use-after-free.

Docs

• README documents the one known case where two devices share settings: identical mice of the same model with no hardware serial number.

Install

Download MacRazer.dmg below, open it, and drag MacRazer into Applications.

This build is unsigned (no paid Apple Developer ID), so Gatekeeper will warn on first launch. Right-click the app, choose Open, then confirm — see the README's Install section for details.

Still marked pre-release: not all device types have been verified on real hardware.

MacRazer v0.1.3

Connection awareness.

What changed since v0.1.2

• Bluetooth detection. If your Razer mouse is connected over Bluetooth, MacRazer now tells you so and prompts switching to the 2.4 GHz dongle or USB-C — instead of just showing "offline". Razer only exposes its control protocol (battery, DPI, lighting) over USB, never Bluetooth.
• Connection-type indicator. The popover header shows a small chip next to "Connected" telling you whether control is running over the 2.4 GHz dongle or a wired USB-C cable.
• Docs: the README and first-run setup screen now note the USB-only requirement.

Install

Download MacRazer.dmg below, open it, and drag MacRazer into Applications.

This build is unsigned (no paid Apple Developer ID), so Gatekeeper will warn on first launch. Right-click the app, choose Open, then confirm — see the README's Install section for details.

Still marked pre-release: not all device types have been verified on real hardware.

MacRazer v0.1.2

Adds a proper first-run experience.

What changed since v0.1.1

• First-run setup & permissions screen. A dedicated window walks you through the two macOS permissions MacRazer needs — Input Monitoring (required, to read battery/DPI/lighting) and Accessibility (optional, only for button remapping) — with live status and one-click native grant prompts. It appears automatically whenever Input Monitoring is missing and is reachable any time from the menu bar (Setup & Permissions…).
• Handles the classic macOS "the grant only applies after a relaunch" gotcha with a Quit & Relaunch button and an explanatory tip, and confirms success by showing your detected mouse.

Install

Download MacRazer.dmg below, open it, and drag MacRazer into Applications.

This build is unsigned (no paid Apple Developer ID), so Gatekeeper will warn on first launch. Right-click the app, choose Open, then confirm — see the README's Install section for details.

Still marked pre-release: not all device types have been verified on real hardware.

MacRazer v0.1.1

Maintenance release.

What changed since v0.1.0

• Tighter event-tap scope (privacy): the button-remapping CGEvent tap now watches only the extra mouse buttons it actually remaps — it no longer observes primary left/right clicks. Those were briefly tapped for a one-off button-detection diagnostic (used to confirm scroll-wheel-click remapping works); that diagnostic has been removed.
• Popover footer now shows the real app version (read from the bundle).
• README: added app screenshots.

Full notes in CHANGELOG.md.

Install

Download MacRazer.dmg below, open it, and drag MacRazer into Applications.

This build is unsigned (no paid Apple Developer ID), so Gatekeeper will warn on first launch. Right-click the app, choose Open, then confirm — see the README's Install section for details.

Still marked pre-release: not all device types have been verified on real hardware.

MacRazer v0.1.0

First public build of MacRazer, a native macOS menu bar app to control Razer mice over USB HID (Razer's Synapse doesn't support macOS).

Tested on the Razer Cobra HyperSpeed and Razer Atheris. Should detect and partially work with other Razer mice using the same protocol, but those are untested.

Features: battery %, charging status, DPI (read/write, custom values), polling rate, RGB lighting (static/spectrum/wave), brightness, time-until-empty estimate, and software button remapping for the side buttons. Full list in CHANGELOG.md.

Install

Download MacRazer.dmg below, open it, and drag MacRazer into Applications.

This build is unsigned (no paid Apple Developer ID), so Gatekeeper will warn on first launch. Right-click the app, choose Open, then confirm — see the README's Install section for details.

Marked as a pre-release since this is the first build and not all device types have been verified.