Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md

Wireless Battery

Battery levels of your wireless mouse, headset, keyboard and controller, right on the Windows taskbar.

Wireless Battery on the taskbar

Just want it working? Download WirelessBattery-Setup from the latest release, run it and click through. That's it.

Experienced users can grab the portable zip, use the command-line options, or build it from source with make or build.bat.

  • Tiny: a ~350 KB app using about 2 MB of RAM. It's plain C++/Win32, with no runtime and no background service, and installs in seconds without admin rights.
  • No vendor software needed: it talks to the devices directly. G HUB, Synapse, iCUE, GG and NGenuity can stay closed (or keep running; they don't conflict).
  • Many brands: Logitech, Razer, SteelSeries, Corsair, HyperX, Glorious, PlayStation and Xbox controllers, any Bluetooth device Windows knows a battery level for, and every headset the bundled HeadsetControl supports.

Display

On the taskbar (default): 🎧 30% 🖱 93% next to the notification area, drawn with the Windows icon font.

  • Low battery: a red number means 15% or less.
  • Charging: a blue ⚡ appears next to the number.
  • Asleep: dimmed text means the device is asleep and the last known value is shown.
  • Theme: it follows light/dark mode and DPI scaling.

Tray icons: one icon per device with the number drawn in it, plus a "Low battery" notification at 15%. The app switches to this automatically when the taskbar is vertical or can't be found.

Hover for details. Click for the menu: every device (click one to hide or show it), display mode, Refresh now, Start with Windows, and Exit. Levels refresh every 60 seconds, and right away when a device is plugged in or the PC wakes up.

Supported devices

VendorDevicesHow
LogitechMice and keyboards on Unifying, Bolt, Lightspeed and Nano receivers, over USB or Bluetooth; G headsets (G533, G535, G633/G635/G733/G933/G935, G PRO/PRO X)HID++ 1.0 / 2.0 with feature discovery: unified battery, battery level, voltage, ADC
RazerWireless mice, keyboards and dongles; BlackShark V3 / V3 Pro headsetsRazer feature-report protocol; headset envelope protocol (queried every 5 min)
SteelSeriesArctis 1/7/7+/9/Pro/Pro Wireless, Arctis Nova 3P/5/7/7X/7P/Pro Wireless, GameBuds; Aerox 3/5/9 Wireless, Prime Wireless, Rival 3 Wireless (Gen 2), Rival 650, Rival ProVendor HID reports
CorsairVoid / Void Pro / Void Elite / HS70 / HS80 wireless; Bragi devices (Virtuoso, Void V2, HS80 MAX, Slipstream mice and keyboards)Vendor HID reports, Bragi GET (read-only)
Cooler MasterMM712, MM731 (2.4 GHz dongle or USB cable)Vendor HID status report (read-only)
HyperXCloud III Wireless, Cloud III S Wireless, Cloud II Wireless (HP, Kingston, DTS), Cloud II Core Wireless, Cloud Alpha Wireless, Cloud Alpha 2 Wireless, Cloud Flight, Cloud Flight SVendor HID reports
GloriousModel O / O- / D / D- Wireless, Model O 2 / D 2 PROVendor feature report
HitscanHyperlight X, Hyperlight NVendor feature report (same protocol as Glorious)
Kysona / Pulsar / ATK (VXE) / HitscanKysona M600 / Mercury, Pulsar and ATK VXE wireless mice (e.g. VXE X3 Pro, ATK F1 Extreme), Hitscan HyperlightShared vendor protocol with checksummed replies
ATK headsetsATK N9 ProVirtual COM port protocol (the ATK desktop app must be closed)
G-WolvesFenrir, Fenrir Pro / Max / Asym, HTX, HTS, HSK, HTR, HT-S2, Lycan, WARG, VUK and their 8K donglesGlorious or Kysona protocol, depending on the model
Keychron miceM4 and other Keychron mice on the 2.4 GHz receiver; 8K mice (M5 8K, G6 HE 8K ...) on the TurboLink 8K receiverVendor report from Keychron Launcher
LAMZUMaya X, Maya, Maya M, Tachi, Inca, Paro, Thorn, Atlantis Mini / OG Champion, Orcus (cable, 1K and 4K/8K dongles)Vendor feature report from LAMZU Aurora
RedragonCompx-based wireless mice: M916 Pro 1K (tested), M913 Impact Elite (tri-mode), G49 (receiver or cable)Kysona protocol
AULAF75 / F87 Pro / F99 wireless keyboards on the 2.4 GHz receiverReport 0x13 frame, command 0x4A, sum checksum (Bluetooth and wired modes untested)
ASUS ROGStrix Scope II 96 (RX), Azoth, Falchion keyboards; Keris, Harpe, Gladius, Chakram, Spatha, Pugio, Strix Impact mice; the Omni ReceiverROG HID battery query
ZOWIEEC1/EC2/EC3-CW and DW series (U2-DW, S2-DW ...)Community-documented read-only vendor commands
Rapoo VTVT3 Max Gen 2 (tested); other Nordic 54L VT mice exposing the same status interface; legacy VT3 Pro (experimental)Passive HID status report 07 on FF00:0002; legacy BB restricted to VT3 Pro 1215/4415. Receiver and USB cable, with charging state
Motospeed / Delux / AjazzMotospeed X6, Delux M900 Pro, Ajazz AJ179 family; AJ159 and other AJ-series mice on the 3151 receiverVendor reports (Delux: passive status broadcasts; AJ-series: 0xF7 status poll, then feature report 0x05)
Attack Shark and other Chinese brandsRongyuan receivers (81 models: Attack Shark R3, X82 PRO HE, Ajazz keyboards, some MSI and others); Xenta receivers (Attack Shark X6 / R1, X11, X3 Max, V3 Pro)Rongyuan status report; Xenta passive broadcasts
SonyDualShock 4, DualSense, DualSense Edge (USB, Bluetooth, wireless adapter); INZONE H9 II and H5 headsetsInput report; INZONE vendor protocol
GameSirNova Lite, Nova 2, Nova 2 Lite on the 2.4 GHz receiver; Nova 2 Lite on USBVendor device-info query (usage page FF7A)
XboxControllers on the Xbox Wireless adapter, USB or Bluetooth; headsets plugged into a controllerWindows.Gaming.Input battery report (real %), XInput fallback
BluetoothAnything that shows a battery in Settings → Bluetooth & devices (earbuds, headphones, BLE mice and keyboards)Windows device property
Generic HIDDevices reporting the standard HID Battery Strength usageHID usage page 0x06 / 0x85
HeadsetControlEvery headset it supports (Audeze, Jabra, Sony INZONE, newer Logitech and more)Bundled; runs headsetcontrol -o json

Tested on real hardware: Glorious Model O Wireless, HyperX Cloud III Wireless, Cooler Master MM712 (dongle), Rapoo VT3 Max Gen 2 (receiver 24AE:1417 and USB cable 24AE:4617; other Rapoo models are untested, see Rapoo protocol notes) and Redragon M916 Pro 1K (receiver 3554:F55D). Implemented from protocol documentation and other projects, not yet tested: everything else. If you own one of these devices, please report whether it works by opening an issue.

Install

Latest version

  1. Download WirelessBattery-Setup-<version>.exe from the latest release.
  2. Run it and click through. It needs no administrator rights and nothing else installed: no runtimes, no drivers, no vendor apps. HeadsetControl comes bundled.

The installer adds a Start menu entry and an uninstaller (Settings → Apps), and can start the app when you sign in. Prefer no installer? Download WirelessBattery-<version>-portable.zip, unzip it anywhere and run WirelessBattery.exe.

Notes:

  • SmartScreen warning: the exe is not code-signed, so Windows may say "Windows protected your PC". Click More info → Run anyway, or build it yourself.
  • Tray-icon mode on Windows 11: new tray icons go to the ^ overflow. Drag them onto the taskbar or enable them in Settings → Personalization → Taskbar → Other system tray icons.

Command line

WirelessBattery.exe --list   # print every device and its battery level, then exit
WirelessBattery.exe --dump   # print every HID collection (useful when asking for a new device)
WirelessBattery.exe --quit   # close the running instance

Build

You need MinGW-w64, e.g. from MSYS2 (pacman -S mingw-w64-x86_64-gcc make).

make            # MSYS2 / any shell with make
build.bat       # plain cmd with g++ and windres on PATH

To build the installer and portable zip, install Inno Setup and run powershell -File installer\build-installer.ps1 -Version 1.0.0. It downloads the pinned HeadsetControl release and verifies its checksum. GitHub Actions does all of this automatically: pushing a tag like v1.0.0 publishes a release with the installer, the portable zip and the HeadsetControl source (as its GPL license requires).

WirelessBattery.exe on its own also works. Without headsetcontrol.exe next to it (or on PATH) you just lose the extra headsets.

Limitations

  • Primary monitor only: the taskbar widget sits on the primary monitor's taskbar.
  • Crowded taskbars: with a very full centered Windows 11 taskbar, the app buttons can reach the widget. On Windows 10 the task-button area is narrowed automatically.
  • Sleeping devices: a device that is asleep may not answer. Its last value stays visible, dimmed. Logitech receivers drop sleeping devices from the link, so their last value is kept for 30 minutes.
  • Keychron keyboards: they only report their battery over Bluetooth (shown via the Bluetooth support). Over the 2.4 GHz receiver the firmware does not expose it. Keychron mice are supported.
  • Rapoo: supported VT mice push their status, so a refresh can wait up to 4 seconds per matching interface. Sleeping mice may stay dimmed with their last reading for up to 30 minutes. Support is for Nordic 54L report 07 and legacy VT3 Pro BB; CH584 report 08, office MT/M-series mice and other firmware protocols are not covered by this driver.
  • Not supported yet: MSI wireless mice and keyboards, Razer Kraken / Barracuda headsets, HyperX Pulsefire mice and the Xbox Wireless Headset on the Xbox adapter: their battery protocols are not documented. The Xbox Wireless Headset works over Bluetooth. A USB capture from an owner (see CONTRIBUTING.md) is the way to add them.
  • Other devices: some 2.4 GHz devices use undocumented protocols and are not supported yet. See CONTRIBUTING.md for how to help add one.

How it works

Each vendor driver in src/drivers/ recognises its devices by USB vendor and product ID, and only ever sends read-only battery queries. Unknown devices are never written to. The generic fallbacks (HID battery usage, Bluetooth, XInput, HeadsetControl) only look at devices no vendor driver has claimed.

The taskbar widget is a layered child window of Shell_TrayWnd, placed left of TrayNotifyWnd. If Explorer restarts, it is re-created.

Credits

The protocols come from these projects' research:

License

GNU General Public License v3.0 or later. You may use, modify and redistribute this software, but anything you distribute that is based on it must be released under the same license, with its source code.

关于 About

Show the battery level of wireless mice, headsets, keyboards and controllers on the Windows 10/11 taskbar. Lightweight tray app, no vendor software needed. Supports Logitech, Razer, SteelSeries, Corsair, HyperX, Glorious, PS4/PS5 DualSense, Xbox and Bluetooth devices.

语言 Languages

C++93.0%
Inno Setup2.3%
PowerShell1.9%
Shell1.8%
Batchfile0.5%
Makefile0.5%

提交活跃度 Commit Activity

代码提交热力图
过去 52 周的开发活跃度
10
Total Commits
峰值: 10次/周
Less
More

核心贡献者 Contributors