Repolode
Submit
HeyOkay

HeyOkay/HaloBattery

Windows system tray app that shows battery levels for wireless mice, keyboards, headsets and controllers, one icon per device, without vendor software.

Open-source alternative to:Razer SynapseLogitech G HUB

View on GitHub
Stars
672
Forks
61
Open issues
146
Last commit
7 days ago

What is it?

Halo Battery is a Windows tray utility that reads battery levels from wireless peripherals and shows each device as its own icon. It works with 2.4 GHz receivers, USB cables and Windows Bluetooth, so you can check mouse, headset or controller charge without keeping the manufacturer's companion software running.

Each device gets a ring that fills with its level, changes color near and below a configurable alert threshold, and animates while charging. Alerts are held back while a full-screen game is running, and polling slows down during play. Devices can be renamed or hidden from the tray menu.

The app lists support for more than 30 brands, including Razer, Logitech, SteelSeries, HyperX, Corsair and Xbox. It includes a diagnostics report for adding unsupported devices, and an in-app update option. The project is distributed as a portable ZIP for Windows 10 and 11 and is written in Python.

Key features

  • 01Shows a separate tray icon with battery ring for each wireless device.
  • 02Works through 2.4 GHz receivers, USB cables and Windows Bluetooth without vendor apps.
  • 03Supports more than 30 brands including Razer, Logitech, SteelSeries and Xbox.
  • 04Holds alerts during full-screen games and lowers polling while gaming.
  • 05Lets you rename, hide and set alert levels per device.
  • 06Generates a diagnostics report to help add new devices.

Use cases

  • Checking wireless mouse or keyboard battery on a Windows desktop without installing each brand's software.
  • Keeping an eye on headset or controller charge during long sessions.
  • Replacing several vendor companion apps with a single tray utility.

Quick start

  1. 1

    Download the latest release ZIP from the releases page

  2. 2

    Extract the ZIP to its own folder and run the app

    HaloBattery\HaloBattery.exe
  3. 3

    Right-click a tray icon and enable Start with Windows (optional)

Things to know

  • Windows 10 and 11 only.
  • The released .exe is not code-signed, so SmartScreen may show a warning.
  • Some devices are only tested on real hardware for certain connections; check the device list.

Topics

#windows#system-tray#battery-monitor#wireless-peripherals#bluetooth#gaming-peripherals#python

FAQ

What is HaloBattery?
Windows system tray app that shows battery levels for wireless mice, keyboards, headsets and controllers, one icon per device, without vendor software. Halo Battery is a Windows tray utility that reads battery levels from wireless peripherals and shows each device as its own icon. It works with 2.4 GHz receivers, USB cables and Windows Bluetooth, so you can check mouse, headset or controller charge without keeping the manufacturer's companion software running.
Is HaloBattery free to use? What license does it have?
HaloBattery is open source under the MIT license. Check the license terms before using it in commercial products.
Is HaloBattery still maintained?
Actively maintained. The last commit to HaloBattery was on Oct 12, 2026.
What can I use HaloBattery for?
Checking wireless mouse or keyboard battery on a Windows desktop without installing each brand's software. Keeping an eye on headset or controller charge during long sessions. Replacing several vendor companion apps with a single tray utility.
How do I install HaloBattery?
Download the latest release ZIP from the releases page Extract the ZIP to its own folder and run the app: HaloBattery\HaloBattery.exe Right-click a tray icon and enable Start with Windows (optional)
Where can I get HaloBattery?
The source code and installation instructions are on GitHub: https://github.com/HeyOkay/HaloBattery

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects