A lightweight Windows desktop widget that shows battery level and charging status for your Razer wireless devices—headphones, keyboard, and mouse—in one place. Styled with Razer’s dark theme and green accents.
Download the latest release (Windows installer)
- Download Razer Battery Widget Setup x.x.x.exe
- Run the installer
- Launch the app—the widget appears on your desktop and an icon sits in the system tray
Requirement: Razer Synapse 3 or Razer Synapse 4 must be running. The widget reads battery data from Synapse’s logs—no extra drivers or USB access needed.
- Three device slots — Headphones, keyboard, and mouse with clear icons and circular battery indicators
- Charging indicator — Lightning icon when a device is charging
- Razer-style UI — Dark background, green accents, always-on-top option
- System tray — Minimize to the tray; double-click or use the menu to show the widget again
- Start with Windows — Optional launch at login (toggle in the tray menu)
- Always on top — Optional toggle so the widget stays above other windows
- Windows 10 or 11
- Razer Synapse 3 or Razer Synapse 4 (running in the background)
- No admin rights or extra drivers required
- Move the widget — Drag it by the background
- Minimize — Close the window; the app stays in the system tray
- Show again — Double-click the tray icon or right-click → Show Widget
- Tray menu — Right-click the tray icon for Start with Windows, Always on top, and Quit
Devices are detected automatically from Synapse. Typical matches:
| Slot | Examples |
|---|---|
| Headphones | BlackShark, Kraken, Barracuda, Nari, Thresher, and other headsets |
| Keyboard | BlackWidow, Huntsman, Ornata, Cynosa, DeathStalker |
| Mouse | DeathAdder, Viper, Basilisk, Mamba, Naga, Orochi, Cobra, Pro Click |
If a device doesn’t appear, it may use a name that isn’t mapped yet; the widget still shows up to three devices, filling slots in order when the exact type isn’t recognized.
git clone https://github.com/LeonardoVidolin/razer-battery-widget.git
cd razer-battery-widget
npm install
npm startnpm run buildThe installer is created in the dist/ folder.
Battery data is read from Razer Synapse log files (same approach as razer-taskbar):
- Synapse 3:
%LOCALAPPDATA%\Razer\Synapse3\Log\Razer Synapse 3.log - Synapse 4:
%LOCALAPPDATA%\Razer\RazerAppEngine\User Data\Logs\systray_systrayv2*.log
Device names and keywords can be extended in renderer.js to support more products.
npm run tray-iconMIT — see LICENSE.
Maintainer: Release checklist and Git setup are in the docs/ folder.
Not affiliated with Razer Inc. Razer and Synapse are trademarks of Razer Inc.