razer-taskbar

KO | EN

gitlite — search

#ai #typescript #android #machine-learning #rust #deep-learning #docker #macos #java #cli #kubernetes #awesome-list #mcp #open-source

(★ 121)

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

razer-taskbar Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# razer-taskbar

## Summary

Display the battery state of Razer products using log messages from Razer Synapse.
Inspired by [Tekk-Know/RazerBatteryTaskbar](https://github.com/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.](https://raw.githubusercontent.com/sanraith/razer-taskbar/main/docs/screenshot.png)

| ≥80% | ≥60% | ≥40% | ≥20% | ≥0% | unknown % | numeric |
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|![100%](https://raw.githubusercontent.com/sanraith/razer-taskbar/main/src/assets/battery100_@2x.png) ![100% charging](https://raw.githubusercontent.com/sanraith/razer-taskbar/main/src/assets/battery100_chrg_@2x.png)|![75%](https://raw.githubusercontent.com/sanraith/razer-taskbar/main/src/assets/battery75_@2x.png) ![75% charging](https://raw.githubusercontent.com/sanraith/razer-taskbar/main/src/assets/battery75_chrg_@2x.png)|![50%](https://raw.githubusercontent.com/sanraith/razer-taskbar/main/src/assets/battery50_@2x.png) ![50% charging](https://raw.githubusercontent.com/sanraith/razer-taskbar/main/src/assets/battery50_chrg_@2x.png)|![25%](https://raw.githubusercontent.com/sanraith/razer-taskbar/main/src/assets/battery25_@2x.png) ![25% charging](https://raw.githubusercontent.com/sanraith/razer-taskbar/main/src/assets/battery25_chrg_@2x.png)|![0%](https://raw.githubusercontent.com/sanraith/razer-taskbar/main/src/assets/battery0_@2x.png) ![0% charging](https://raw.githubusercontent.com/sanraith/razer-taskbar/main/src/assets/battery0_chrg_@2x.png)|![battery unknown](https://raw.githubusercontent.com/sanraith/razer-taskbar/main/src/assets/battery_unknown_@2x.png)|![100%](https://raw.githubusercontent.com/sanraith/razer-taskbar/main/src/assets/numeric-icon/battery078.png) ![100%](https://raw.githubusercontent.com/sanraith/razer-taskbar/main/src/assets/numeric-icon-chrg/battery078.png)|

## 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`](https://github.com/sanraith/razer-taskbar/blob/main/src/watcher/razer_watcher.ts).
If the log format of Razer Synapse changes, this file will need to be updated.

## Attributions

* RazerBatteryTaskbar: <https://github.com/Tekk-Know/RazerBatteryTaskbar>
* Battery icons are made by me. Design is based on [Dreamstale - Flaticon](https://www.flaticon.com/free-icons/battery)

razer-taskbar

razer-taskbar Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

razer-taskbar

razer-taskbar Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README