I vibe reverse engineered my Bluetooth mouse to support it on macOS

Name: I vibe reverse engineered my Bluetooth mouse to support it on macOS
Availability: InStock
Author: gh123man

by gh123man·Mar 27, 2026·7 points·1 comment

Visit Project View on HN

AI Analysis

●●SolidNiche GemShip It

Reverse-engineered BLE protocol brings Razer mouse config to macOS without Synapse.

Strengths

•Native macOS app with minimal overhead, no Electron bloat
•BLE packet capture + coding agents enabled reverse engineering without prior RE experience
•Menu bar DPI control and onboard storage writes work offline

Weaknesses

•OpenRazer already does similar work for Linux, limiting novelty
•Device support depends on manual packet captures for each mouse model

Post Description

I bought a Razer Basilisk V3 X HyperSpeed to use as a Bluetooth mouse for my mac without realizing Razer doesn't offer software support for it. So instead of returning it, I used coding agents (mostly codex) to reverse engineer the BLE spec and then build an app around it! Along the way I added support for a few other Razer mice.

I have essentially no reverse engineering experience, so I likely would not have attempted this project without a coding agent to help. The general process was: Capture BLE packets with btvs on windows, perform an action on the mouse with synapse open, then send the capture to codex to figure out what happened and update the spec. I repeated this for every mouse button and binding until I had the full picture. There are some docs in the docs folder that detail the process and results if you are interested!