Skip to content

Display the battery state of Razer products using log messages from Razer Synapse.

License

Notifications You must be signed in to change notification settings

sanraith/razer-taskbar

Repository files navigation

razer-taskbar

Summary

Display the battery state of Razer products using log messages from Razer Synapse. Inspired by Tekk-Know/RazerBatteryTaskbar, instead of USB communication this app uses Razer Synapse logs to get the latest battery status of Razer wireless devices. This has the advantage to support more devices (headsets, mice, keyboard, etc.) without extra configuration, but also requires Razer Synapse 3 or 4 to be running.

Screenshot of razer-taskbar battery icon and its menu showing its connected to a Razer headset.

≥80% ≥60% ≥40% ≥20% ≥0% unknown %
100% 100% charging 75% 75% charging 50% 50% charging 25% 25% charging 0% 0% charging battery unknown

Requirements

  • Windows (tested on Windows 10 & 11)
  • Razer Synapse 3 or Razer Synapse 4 running in the background
  • Optional: node.js (compile time)

Installation

Run the setup exe. After installation the app will show its icon on the taskbar. Use the Settings menu to configure automatic startup if needed.

Supported Hardware

  • Potentially any wireless Razer device compatible with Razer Synapse 3 or 4.
  • tested with Razer Blackshark V2 Pro (2023)

Compiling

  • npm install
  • npm run make
  • Setup exe will be created in the out\make directory.

How it works

The app is monitoring the logs of Razer Synapse. The monitored file is:

  • %LOCALAPPDATA%\Razer\Synapse3\Log\Razer Synapse 3.log for Razer Synapse 3
  • %LOCALAPPDATA%\Razer\RazerAppEngine\User Data\Logs\systray_systrayv2.log for Razer Synapse 4

The app reads the log content throttled by the "Maximum battery update delay" setting. The code is looking for connection and battery information in the logs, and parses the latest state of each device as defined in razer_watcher.ts. If the log format of Razer Synapse changes, this file will need to be updated.

Attributions