A command-line tool for controlling the RGB lighting and scroll wheel mode on Razer Basilisk V3 mice via direct USB HID — no Razer drivers or Synapse required.
demo.mp4
Tested with: Razer Basilisk V3 Pro (Wireless), plugged in via USB.
- OpenRazer — Linux driver and user-space daemon for Razer devices, with Python bindings and a command-line tool (
razer-cli) for controlling lighting and other features. Linux only.
go install github.com/jashort/bmouse@latestOr build from source:
git clone https://github.com/jashort/bmouse.git
cd bmouse
make buildmacOS You may need to grant your terminal
Input Monitoringpermission in System Preferences > Security & Privacy > Privacy to allowbmouseto detect the mouse.For example:
./bmouse list Razer HID devices: PID=0x00AA Razer Basilisk V3 Pro UsagePage=0x0001 Usage=0x0006 Interface=2 Path=DevSrvsID:4294971771 ... ./bmouse static ff0000 no Razer Basilisk V3 found (is it plugged in?)Indicates that the mouse is detected but not accessible due to missing permissions. Granting
Input Monitoringpermission should resolve this.
bmouse <command> [--zone <zone>] [args...]
| Command | Description | Example |
|---|---|---|
list | List all Razer HID devices | bmouse list |
status | Show current settings | bmouse status |
static <hex-color> | Set a solid color | bmouse static ff0000 |
breathe <hex-color> | Single-color breathing | bmouse breathe 00ff00 |
breathe-dual <color1> <color2> | Two-color breathing | bmouse breathe-dual ff0000 0000ff |
spectrum | Rainbow spectrum cycling | bmouse spectrum |
reactive <hex-color> [--speed 1-3] | Light up on click | bmouse reactive ff0000 --speed 1 |
off | Turn LEDs off | bmouse off |
scroll [mode] | Get or set scroll wheel mode | bmouse scroll tactile |
| Value | Duration |
|---|---|
1 | Short |
2 | Medium (default) |
3 | Long |
| Mode | Description |
|---|---|
tactile | Clicky, notched scrolling |
free | Free-spin (smooth, silent) |
smart | Smart Reel — automatically switches based on scroll speed |
| Flag | Description | Default |
|---|---|---|
--zone <zone> | Target LED zone (see table below) | all |
--brightness <0-255> | LED brightness | 255 |
--speed <1-3> | Reactive effect duration (1=short, 2=medium, 3=long) | 2 (medium) |
Use the optional --zone flag to target a specific LED zone. Defaults to all zones.
| Zone | Description |
|---|---|
all | All LEDs at once (default) |
scroll | Scroll-wheel LED |
logo | Logo LED |
under | Underglow light strip |
6-digit hex, with or without a leading #:
ff8800 #ff8800
# Set all LEDs to red
bmouse static ff0000
# Set all LEDs to red at half brightness
bmouse static ff0000 --brightness 128 # Green breathing effect on the logo only
bmouse breathe --zone logo 00ff88
# Two-color breathing
bmouse breathe-dual ff0000 0000ff
# Red reactive with short duration
bmouse reactive --speed 1 ff0000
# Spectrum cycling on the scroll wheel
bmouse spectrum --zone scroll
# Turn off underglow
bmouse off --zone under
# Switch to free-spin scroll wheel
bmouse scroll free
# Check current scroll mode
bmouse scroll
# Show current LED and scroll settings
bmouse status- go-hid — cross-platform Go bindings for the HIDAPI library
MIT