razer-battery-report

Razer Battery Level Tray Indicator

Show your wireless Razer devices battery levels in your system tray.

Currently, this works only on Windows.

Supported devices

• Razer DeathAdder V3 Pro
• Razer DeathAdder V3 HyperSpeed
• Razer DeathAdder V2 Pro
• Razer Basilisk V3 Pro
• Razer Viper Ultimate

Note: If your device is not listed, you can add support for it yourself! Please see the Adding new devices yourself section below. Contributions and Pull Requests are welcome!

Usage

Installation

Note: Since this project is currently in active development, there is no installer (.msi or setup .exe) yet. To set up the application permanently (Start Menu icon, Autostart), please follow the manual steps below.

1. Download the latest razer-battery-report.exe from Releases.

2. Move the executable to a safe permanent location.

   • Recommended: Create a folder at C:\Program Files\Razer Battery Report\ and move the .exe there.
   • Note: This prevents accidental deletion from your Downloads folder.

3. Add to Startup (Recommended):

   • Right-click razer-battery-report.exe -> Create shortcut.
   • Press Win + R, type shell:startup and press Enter.
   • Move the created shortcut into the opened folder.
   • Now the app will start automatically when you log in.

4. Add to Start Menu (Optional):

   • Create another shortcut.
   • Press Win + R, type shell:programs and press Enter.
   • Move the shortcut into the opened folder.
   • Now you can search for "Razer Battery Report" in Windows Search.

Tips:

• You can rename the shortcuts to simply "Razer Battery Report" (remove ".exe" and "Shortcut").
• Custom Icon:
  1. Download mouse.ico (save it in the same folder as the .exe).
  2. Right-click the shortcut -> Properties -> Change Icon... -> Browse -> Select the downloaded .ico file.

Building from Source

To build, you must have Rust and Git installed on your system.

1. Clone this repository: git clone https://github.com/xzeldon/razer-battery-report.git
2. Navigate into your local repository: cd razer-battery-report
3. Build: cargo build --release
4. Executable will be located at target/release/razer-battery-report.exe

Adding new devices yourself

• add device with name, pid, interface, usage_page, usage to devices.rs
• add transaction_id to switch statement in DeviceInfo in devices.rs

You can grab pid and other data from the openrazer

Todo

• Tray Applet
  • Force update devices button in tray menu
  • Colored tray icons for different battery levels
  • Show log window button in tray menu
  • Further reduce CPU usage by using Event Loop Proxy events (more info here)
• Prebuilt Binary
• Command Line Arguments for update frequency
• Support for other Razer Devices (I only have DeathAdder V3 Pro, so I won't be able to test it with other devices)

Acknowledgments

• Linux Drivers for Razer devices: https://github.com/openrazer/openrazer
• This python script: https://github.com/spozer/razer-battery-checker
• 🖱️ Logitech Battery Level Tray Indicator (Elem): https://github.com/Fuwn/elem