Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

krisgfx9/Wireless-Device-Battery-Monitor

System Tools

Shows wireless mouse, headset, keyboard and controller battery levels directly on the Windows taskbar, without vendor software.

3,679
313
C++
GPL-3.0
1 day old

What it does

Wireless Battery is a small C++/Win32 tray application for Windows 10 and 11 that displays the remaining battery level of wireless mice, keyboards, headsets and controllers. It reads devices directly over HID using read-only vendor queries, so Logitech G HUB, Razer Synapse, Corsair iCUE and similar tools are not required. The app also has generic fallbacks for Bluetooth devices, standard HID battery reports, XInput and headsets supported by the bundled HeadsetControl.

The main display is a widget next to the notification area showing one icon and percentage per device, with red text at 15% or lower, a charging bolt, and dimmed text when a sleeping device last reported a value. A tray-icon mode is used when the taskbar is vertical or the widget cannot be placed.

Quick start

  1. Download WirelessBattery-Setup-<version>.exe from the latest release.
  2. Run the installer and click through. It needs no administrator rights, runtimes, drivers or vendor software, and it adds a Start menu entry and uninstaller.
  3. Look beside the notification area for the device readout. Click it to open the menu, where each device can be shown or hidden, the display mode switched, a manual refresh triggered, or startup with Windows enabled.

If you prefer not to install, download the portable zip, extract it anywhere and run WirelessBattery.exe. The executable is unsigned, so SmartScreen may show a warning; the README suggests More info → Run anyway or building it yourself. On Windows 11, new tray icons normally land in the ^ overflow and may need to be dragged onto the taskbar.

For scripting, the binary accepts --list to print devices and levels, --dump to print HID collections, and --quit to close the running instance.

Build from source

With MinGW-w64 (for example from MSYS2, installing mingw-w64-x86_64-gcc make), run make; a plain cmd with g++ and windres on PATH can use build.bat. Building the installer and portable zip additionally requires Inno Setup, then run powershell -File installer\build-installer.ps1 -Version 1.0.0. The script downloads a pinned HeadsetControl release and verifies its checksum; without headsetcontrol.exe beside the binary, only the extra headsets it supports are lost.

Supported hardware and constraints

Support is broad but uneven: Logitech, Razer, SteelSeries, Corsair, HyperX, Glorious, ASUS ROG, ZOWIE, several Chinese peripheral brands, DualShock 4/DualSense, GameSir and Xbox controllers have dedicated drivers. The README lists the exact tested models and notes that most other entries were implemented from protocol documentation and other projects without hardware testing, so owner reports are requested through the issue tracker.

Limitations that affect use: the taskbar widget only appears on the primary monitor; a very full centered Windows 11 taskbar can overlap it; sleeping devices may not answer and keep their last value; Keychron keyboards report battery only over Bluetooth, not the 2.4 GHz receiver; MSI peripherals, Razer Kraken/Barracuda headsets, HyperX Pulsefire mice and the Xbox Wireless Headset on the Xbox adapter are not supported yet. The ATK desktop app must be closed for ATK headset support. The project is GPL-3.0-or-later, so redistributed modified builds must also be released under that license with source.

HotRepo's take

On its first recorded day (November 17, 2026), the project entered HotRepo's new-project list with 103 stars and 15 forks gained over a window of roughly seven hours. That is a strong opening for a niche utility, and the repository is a real implementation rather than a download wrapper: C++ source, per-vendor drivers, a documented build, and a clear list of what has and has not been tested. For readers, the main decision is hardware coverage and Windows-only scope; the project is most useful on a primary-monitor Windows setup with devices from a listed vendor.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

Hacker News

Wireless Device Battery Monitor
▲ 1 · 0 comments · November 18, 2026

You might also like

  1. Binaryify/MonitorBarMenu-bar and tray tool that switches inputs and volume on HyperOS monitors without DDC/CI, plus dimming and resolution controls.Go162
  2. SpriteOvO/AirPodsDesktopBrings AirPods battery, ear detection and a popup to Windows and Linux desktops, for people who use Apple earbuds on a PC.C++3,777
  3. AprilNEA/OpenLogiA local replacement for Logitech Options+ that remaps buttons, DPI and SmartShift without an account.Rust24,428
  4. typecraft-dev/oma-castA keyboard launcher for Omarchy that ranks apps and Omarchy commands by learned usage, Raycast-style.JavaScript418
  5. umarz317/WatchPointerTurn an Apple Watch into a Bluetooth pointer for a Mac, with tap, drag, and scroll.Swift128