menu bar app · macOS 14+ · Apple Silicon
MacRazer talks to your Razer mouse directly over USB HID: battery, DPI, RGB lighting, polling rate, and button remapping, with no kernel extension, no driver install, and no Synapse. Built for the Cobra HyperSpeed and Atheris, which Razer's own Synapse for Mac still doesn't support.
$ git clone https://github.com/SorcRR/MacRazer.git $ cd MacRazer && swift run MacRazer
Connect over the 2.4 GHz dongle or USB‑C for every control. The Cobra HyperSpeed also works over Bluetooth for battery, DPI, brightness and colour.
Live percentage, charging state, and a learned time‑until‑empty estimate built from your mouse's own discharge history, kept per physical device by serial number. The menu bar mark shows a bolt while it charges, and a notification warns you once when the charge drops below 15%.
One click opens the current discharge curve, drain rate, time since last full charge, and a trend chart across past charge cycles.
A slider bounded to each model's real maximum, the mouse's own onboard preset stages, and a recallable custom value, per device.
125 / 500 / 1000 Hz, switchable from the menu bar without touching Windows.
Static colour via an inline hue/saturation wheel, plus spectrum, wave, off, and a brightness slider.
Side Back/Forward buttons to keyboard shortcuts, mouse clicks, or media keys, via a software remap (a CGEvent tap), saved per device.
Settings write to the mouse itself where supported, so they persist even when MacRazer isn't running.
Controls a model lacks are hidden automatically: no lighting on the Atheris, no battery UI on wired‑only mice.
When a new version is out, the popover shows what changed before you take it, and keeps the notes afterwards. Every release is on the site too.
| Mouse | Verified on hardware |
|---|---|
| Razer Cobra HyperSpeed (wired + wireless) | Everything, continuously the development mouse |
| Razer Atheris | Battery, DPI, polling maintainer |
| Razer Basilisk V3 X HyperSpeed | Battery, DPI, stages, polling, lighting, brightness @joelday |
| Razer Viper Ultimate (wireless) | Battery, DPI, polling, brightness @raphaelchenouard |
| Razer Orochi 2013 | DPI only @raphaelchenouard |
| Razer Basilisk V3 | Nothing; reported working by a user |
| Razer Cobra, Cobra Pro (wired + wireless) | Nothing; values from OpenRazer |
| Razer Basilisk X HyperSpeed | Nothing; values from OpenRazer |
| Razer Viper Ultimate (wired) | Nothing; its wireless sibling is verified |
| Any other Razer mouse | Nothing; detected and named, controls attempted |
Adding a model is a small registry change plus on‑hardware verification: see CONTRIBUTING.md.
Download MacRazer.dmg from the
latest release,
open it, and drag MacRazer into Applications.
This build is unsigned (no paid Apple Developer ID), so Gatekeeper will warn on first launch. That's the standard unsigned‑app warning, not an actual problem. Right‑click the app → Open → confirm, or run:
$ xattr -cr /Applications/MacRazer.app
Launch it. Grant Input Monitoring (and Accessibility if you use button remapping) when asked. From then on MacRazer starts at login by itself and new versions install themselves. Update & Restart in the popover replaces the app and relaunches it, so there's no DMG to drag. Both are switchable.
MacRazer is built and maintained on free time. If it's useful to you, a tip helps, and if you've got a Razer mouse this hasn't been verified on, a PR adding it helps even more.