A lightweight Rust application that displays battery status of Razer wireless devices in the Windows system tray by monitoring Razer Synapse log files.
✅ Works with both Synapse V3 and V4 - Automatically detects which version you're using ✅ Minimal resource usage - ~5-10MB RAM vs ~150MB for the Electron version ✅ Fast startup - Launches in <100ms ✅ Real-time monitoring - Watches log files for battery status changes ✅ System tray icon - Visual battery indicator in taskbar ✅ Multiple devices - Shows lowest battery device (non-charging preferred) ✅ Custom themes - Full theming support with custom icon packs ✅ Configurable polling - Set log polling interval with minute and second precision
This app does NOT use the Razer SDK. Instead, it reads the same log files that Razer Synapse writes to extract battery information:
- Log Location:
%LOCALAPPDATA%\Razer\Synapse3\Log\Razer Synapse 3.log - Method: Parses log entries with regex to find
_OnBatteryLevelChangedevents - Example log line:
2024-01-30 14:23:45 INFO _OnBatteryLevelChanged Name: Razer Viper Ultimate Handle: 12345 level 87 state 0
- Log Location:
%LOCALAPPDATA%\Razer\RazerAppEngine\User Data\Logs\systray_systrayv2*.log - Method: Parses JSON data from log entries with
connectingDeviceData - Example log line:
[2024-01-30T14:23:45] connectingDeviceData: [{"serialNumber":"AB123","hasBattery":true,"powerStatus":{"level":87,"chargingStatus":"NoCharge_BatteryFull"},"name":{"en":"Razer Viper Ultimate"}}]
- Rust (install from https://rustup.rs/)
- Windows 10/11
cd rust-implementation
cargo build --releaseThe compiled executable will be at: target\release\razer-taskbar.exe
Simply run the executable:
.\target\release\razer-taskbar.exeThe app will:
- Create a tray icon in your taskbar
- Auto-detect Synapse V3 or V4
- Start monitoring log files
- Update the tray icon when battery levels change
Settings are stored in: %LOCALAPPDATA%\razer-taskbar\settings.json
You can configure how often the app checks log files for battery updates in Settings → General → Log polling interval. The interval can be set using two inputs:
- Minutes: 0-999
- Seconds: 0-59
The total interval is calculated as minutes × 60 + seconds with a minimum of 1 second. Default is 1 minute, 0 seconds.
Examples:
0 min 30 sec= checks every 30 seconds1 min 0 sec= checks every minute (default)0 min 5 sec= checks every 5 seconds (faster updates, slightly higher CPU usage)
Razer Taskbar supports fully custom icon themes. You can create your own themes or use community-created ones.
- Create a
themes/folder next torazer-taskbar.exe - Inside
themes/, create a folder for your theme (e.g.,themes/MyTheme/) - Add
dark/and/orlight/subfolders with your PNG icons - Open Settings → General, select your theme from the dropdown
- Click OK to apply
A theme folder must follow this layout:
themes/
└── MyTheme/ ← Your theme name
├── icon.properties ← Battery range → filename mapping
├── dark/ ← Icons for dark mode
│ ├── 100.png
│ ├── 80.png
│ ├── 60.png
│ ├── 40.png
│ ├── 20.png
│ ├── 5.png
│ ├── charging.png ← Overlay when charging
│ ├── no_device.png ← Shown when no device detected
│ ├── mouse.png ← Device type overlay (optional)
│ ├── keyboard.png ← Device type overlay (optional)
│ ├── headphones.png ← Device type overlay (optional)
│ └── unknown.png ← Device type overlay (optional)
└── light/ ← Icons for light mode
├── 100.png
├── 80.png
├── 60.png
├── 40.png
├── 20.png
├── 5.png
├── charging.png
├── no_device.png
├── mouse.png
├── keyboard.png
├── headphones.png
└── unknown.png
Note: Both
dark/andlight/subfolders are optional. If a subfolder is missing, the app automatically falls back to built-in embedded assets for that theme.
By default, the app scans the themes/ folder next to the executable. You can specify a different location:
- Open Settings → General
- Check Use custom theme folder
- Click Browse... and select your themes root directory
- Select a theme from the dropdown
- Click OK
The selected folder should contain theme subfolders (e.g., C:\MyThemes\ThemeA\, C:\MyThemes\ThemeB\).
This file maps battery percentage ranges to icon filenames. The same mapping applies to both the dark/ and light/ subfolders — you only need one icon.properties at the root of your theme folder.
# Format: min-max=filename.png
81-100=100.png
61-80=80.png
41-60=60.png
21-40=40.png
6-20=20.png
0-5=5.png- Ranges are inclusive on both ends.
- Filenames are relative to the active theme subfolder (
dark/orlight/). charging.pngandno_device.pngare reserved special names and do not need to be listed inicon.properties.mouse.png,keyboard.png,headphones.png, andunknown.pngare optional device type overlays drawn on top of the battery icon when Show device type overlay is enabled in settings. If a file is absent from the custom folder the built-in embedded overlay for the active theme is used as fallback.- You can define as many or as few ranges as you like (e.g. a single
0-100=battery.pngis valid). - Ranges must not overlap; the first matching range wins.
| Property | Recommended value |
|---|---|
| Format | PNG with transparency (RGBA) |
| Size | 32 × 32 px (Windows scales down if larger, which may look blurry) |
| Color depth | 32-bit |
When loading an icon the app tries the following sources in order, stopping at the first hit:
<custom_folder>/<theme>/filename— your themed custom asset<custom_folder>/filename— flat custom asset (nodark//light/subfolder needed; useful for single-theme packs)- Embedded
<theme>/filename— the built-in asset for the selected theme - Embedded opposite-theme
filename— automatic fallback if the other embedded theme also has the file
The active theme is chosen in Settings → General → Icon theme with three options:
| Option | Behaviour |
|---|---|
| Dark | Always use icons from the dark/ subfolder |
| Light | Always use icons from the light/ subfolder |
| System | Automatically follows the Windows system theme (dark/light app mode). The OS preference is read from HKCU\Software\Microsoft\Windows\CurrentVersion\Themes\Personalize\AppsUseLightTheme each time settings are applied. |
The setting is saved to settings.json and takes effect immediately after closing the settings window. The default is System.
MIT (same as original project)