How heyokay/halobattery works
Halo Battery is a Windows system-tray app that discovers wireless peripherals, reads their battery state through device-specific protocols or Windows APIs, and presents a separate icon per device. The main flow is polling providers, normalizing readings as device status, then rendering tray icons and exposing details and controls. Provider registration and shared HID discovery are useful internal layers. The README documents user-facing features and device support; source excerpts confirm selected provider and rendering behavior, but not the full application wiring.
Main entry points: __init__.py Provider registry · hidlist.py HID discovery · base.py Device status · halo_battery.pyw App runtime
Components 19
Tray application
- App runtime
halo_battery.pyw - Tray controls
flyout.py - Icon rendering
icons.py - Battery history
history.py
Battery providers
- Provider registry
providers/__init__.py - HID audio providers
providers/audeze.py - HID brand providers
providers/razer.py - Logitech HID++
providers/logitech.py - SteelSeries devices
providers/steelseries.py - WLmouse devices
providers/wlmouse.py - Bluetooth provider
providers/bluetooth.py - PlayStation provider
providers/playstation.py - Xbox-style provider
providers/xinput.py
Shared internals
- HID discovery
providers/hidlist.py - Device status
providers/base.py
Windows and devices
- USB/HID devices
- Windows APIs
- Bluetooth devices
Other components
- User
Connections 35
- User → App runtime: launches
README.md - App runtime → Provider registry: polls providers
- Provider registry → HID audio providers: registers
providers/__init__.py - Provider registry → HID brand providers: registers
providers/__init__.py - Provider registry → Logitech HID++: registers
providers/__init__.py - Provider registry → SteelSeries devices: registers
providers/__init__.py - Provider registry → WLmouse devices: registers
providers/__init__.py - Provider registry → Bluetooth provider: registers
providers/__init__.py - Provider registry → PlayStation provider: registers
providers/__init__.py - Provider registry → Xbox-style provider: registers
providers/__init__.py - HID audio providers → HID discovery: enumerates
providers/audeze.py - HID brand providers → HID discovery: enumerates
providers/razer.py - Logitech HID++ → HID discovery: enumerates
providers/logitech.py - SteelSeries devices → HID discovery: enumerates
providers/steelseries.py - WLmouse devices → HID discovery: enumerates
providers/wlmouse.py - PlayStation provider → HID discovery: enumerates
providers/playstation.py - Xbox-style provider → HID discovery: enumerates
providers/xinput.py - HID audio providers → Device status: returns readings
providers/audeze.py - HID brand providers → Device status: returns readings
providers/razer.py - Logitech HID++ → Device status: returns readings
providers/logitech.py - SteelSeries devices → Device status: returns readings
providers/steelseries.py - WLmouse devices → Device status: returns readings
providers/wlmouse.py - Bluetooth provider → Windows APIs: queries battery
providers/bluetooth.py - Bluetooth provider → Device status: returns readings
providers/bluetooth.py - Windows APIs → Bluetooth devices: reads state
- PlayStation provider → Device status: returns readings
providers/playstation.py - Xbox-style provider → Windows APIs: queries reports
providers/xinput.py - Xbox-style provider → Device status: returns readings
providers/xinput.py - HID discovery → USB/HID devices: discovers
providers/hidlist.py - App runtime → Tray controls: shows controls
- Tray controls → Icon rendering: configures display
- App runtime → Icon rendering: renders tray
README.md - App runtime → Battery history: tracks levels
- User → Tray controls: opens controls
README.md - User → Icon rendering: views status
README.md