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

Gallery

About

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!