Razer Laptop Tools

The plan here is to use the solid foundation of tdakhran to build something that follows a few core pillars

• easy to maintain
• able to add and adjust devices without needing to own them, i own 1 razer latop and dont plan on another at this time
• cross platform (linux / windows)

What's in this fork?

• librazer published to crates.io for a generic interface other tools can also use
• bhelper (blade helper cli) cross platform tool for managing razer bios and devices

Future Features

• TDP controls + bios controls
• profiles
• a guide on how to get this machine to behave and keep a somewhat consistent battery consumption

Supported Devices

Model	Model Number	Features
Razer Blade 14" (2023) Mercury	RZ09-0482X	Performance, Fan, Keyboard, Battery Care, Lights Always On
Razer Blade 16" (2023) Black	RZ09-0483T	Performance, Fan, Keyboard, Logo, Battery Care, Lights Always On

Additional models can be added - see Adding Device Support section.

Features

• Performance Modes: Balanced, Silent, Custom (with CPU/GPU boost control)
• Fan Control: Auto, Manual RPM (2000-5000), Max Speed mode
• Keyboard Brightness: 0-255 levels
• Lid Logo (device-dependent): Off, Static, Breathing
• Battery Care: Limit charging to extend battery lifespan
• Lights Always On: Keep lighting active when on battery

Installation

cargo install --path bhelper

Linux: USB Permissions

On Linux, you need udev rules to access USB devices without root:

NOTE: this is only for testing and is very insecure, we will likely follow the pattern established by other razer tools

sudo cp 99-razer.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules
sudo udevadm trigger

Then unplug and replug your laptop (or reboot) for the rules to take effect.

Usage

blade-helper [OPTIONS] <COMMAND>

Commands:
  status   Show current device status (all settings)
  get      Get a specific setting value
  set      Set a device setting
  info     Show device information
  config   Manage configuration
  help     Print help

Options:
  -v, --verbose  Enable verbose output
      --json     Output in JSON format
  -h, --help     Print help
  -V, --version  Print version

Examples

# Show all current settings
blade-helper status

# Get device info
blade-helper info

# Set performance mode to silent
blade-helper set perf silent

# Set custom performance with CPU/GPU boost
blade-helper set perf custom
blade-helper set cpu high
blade-helper set gpu medium

# Set fan to manual at 3500 RPM
blade-helper set fan manual 3500

# Set fan to auto
blade-helper set fan auto

# Enable max fan speed
blade-helper set fan max enable

# Set keyboard brightness (0-255)
blade-helper set keyboard 128

# Set logo mode (if supported)
blade-helper set logo static

# Enable battery care mode
blade-helper set battery-care enable

# Get JSON output
blade-helper --json status

Adding Device Support

1. Find your device's PID using USB tools (e.g., lsusb on Linux)
2. Find model number prefix from Razer support site (format: RZ09-XXXXX)
3. Add a Descriptor entry in librazer/src/descriptor.rs with supported features
4. Test with blade-helper info and blade-helper status

Reverse Engineering

Read about the reverse engineering process for Razer Blade 16 in data/README.md. You can follow the steps and adjust the utility for other Razer laptops.

Acknowledgments

• tdakhran who created the first version of the tool
• razer-ctl the original project that did the reverse engineering
• openrazer for Reverse-Engineering-USB-Protocol
• Razer-Linux for USB HID protocol implementation