OpenSnek

Configure supported Razer mice on macOS without Synapse, Windows, or vendor lock-in.

OpenSnek is an open source native macOS app for configuring supported Razer mice over USB or Bluetooth.

Highlights

• Lightweight native macOS app bundle with no unnecessary runtime bloat
• Very low idle and background overhead, so it stays out of the way when you are not using it
• Optional menu bar control for quick, on-the-fly DPI adjustments
  
• Rebind all supported mouse buttons and write to onboard stoarge
  

Motivation

Razer does not support the Basilisk V3 X HyperSpeed on macOS at all, so this project started by reverse engineering the BLE protocol from Windows traffic between the mouse and Synapse.

The goal is simple: make supported Razer mice configurable on macOS without needing Synapse, Windows, or a second machine just to change settings.

More device support is welcome, whether that comes from new hardware captures or pull requests. For USB protocol reference work, this project also builds on the excellent documentation and reverse-engineering effort from OpenRazer.

Features

• Change DPI, stage count, and active stage
• Adjusts supported lighting settings
• Remaps supported buttons
• Works over USB and Bluetooth where the device protocol allows it
• Avoids the need for Synapse or a separate Windows machine

Download and Install

1. Download the latest DMG from GitHub Releases.
2. Open the DMG.
3. Drag OpenSnek.app into Applications.
4. Launch OpenSnek.

Official builds use the latest Xcode/macOS SDK. Minimum supported macOS version: macOS 14.

If macOS asks for permissions:

• For USB control, grant Input Monitoring to OpenSnek in System Settings > Privacy & Security.
• For Bluetooth control, allow Bluetooth access when prompted.

Supported Devices

Support is transport-specific. A mouse may be supported over USB, Bluetooth, or both, depending on what has been captured, tested, and validated in the app.

Status key:

• Validated = supported and locally capture/test validated in OpenSnek
• Mapped = supported through a shipped profile, but not yet locally validated on OpenSnek hardware
• Not yet = the transport exists on the hardware but OpenSnek does not support it yet
• No = that transport is not available on the device

Device	USB	Bluetooth	Notes
Basilisk V3 X HyperSpeed	Validated	Validated
Basilisk V3	Mapped	No	OpenRazer-backed USB profile, modeled after the Basilisk V3 35K with a 26,000 DPI ceiling
Basilisk V3 Pro	Validated	Validated
Basilisk V3 35K	Validated	No

Not every feature is fully supported on every listed transport yet. Some controls and readback paths are still partial while capture, testing, and validation continue.

Support docs:

• Per-device USB/BT feature matrix: docs/DEVICE_SUPPORT.md
• Protocol and transport docs: docs/protocol/PROTOCOL.md
• Contribution and new-device workflow: CONTRIBUTING.md

Unsupported Razer mice still get a best-effort experience when possible. OpenSnek will probe for controls that already match known behavior, show a light warning that the device is not fully supported, and avoid exposing UI for features that have not been mapped safely yet.

Support for more devices is welcome. New device support can land either through outside contributors or as more hardware becomes available for capture, testing, and validation.

Build From Source

From the repo root:

./run.sh

That rebuilds the canonical Xcode OpenSnek.app target, copies it into the stable local .dist bundle path, and launches it through OpenSnek/scripts/run_macos_app.sh.

If you want to reuse the current app bundle without rebuilding:

./run.sh --no-build

Build

swift build --package-path OpenSnek

Test

swift test --package-path OpenSnek

Xcode

./OpenSnek/scripts/generate_xcodeproj.sh --open

OpenSnek/OpenSnek.xcodeproj is generated from OpenSnek/project.yml on demand and is not checked into git.

Project Docs

• App build, run, probe, and validation details: OpenSnek/README.md
• Device support and reverse-engineering workflow: CONTRIBUTING.md
• Device support matrix by feature and transport: docs/DEVICE_SUPPORT.md
• DMG release and notarization setup: docs/release/DMG_RELEASE.md
• Protocol documentation: docs/protocol/PROTOCOL.md
• Supported Python tooling: tools/python/README.md
• BLE capture corpus: captures/README.md

License

This repository is licensed under the Apache License 2.0. See LICENSE.