A local-first battery dashboard for your Android devices.
BatteryHub turns your Windows desktop into a compact local power-status console for Android devices, Bluetooth accessories, and gamepads.
BatteryHub is intentionally not a phone-control suite. It does not sync notifications, SMS, files, contacts, clipboard, photos, or media. It only monitors battery status, locally, with a polished industrial console UI built for people who keep multiple devices on their desk.
Developers, Android power users, and privacy-conscious desktop users often keep test phones, tablets, headphones, mice, keyboards, and controllers nearby. BatteryHub gives those batteries one focused view: large percentages, clear status labels, local history, low-power warnings, and calm explanations when Windows cannot expose a battery value.
The narrow scope is the product.
- Industrial dark dashboard grouped by Android Devices, Accessories, and Gamepads.
- Android battery monitoring through the local BatteryHub Agent.
- Windows-connected accessory battery monitoring when Windows exposes battery data.
- PS5 DualSense detection with clear battery-unavailable states when Windows/HID cannot expose battery.
- System tray app, low-battery notifications, offline/stale states, and local recent history.
- Diagnostics page for scan timing, provider state, battery source, and reliability labels.
- Mock mode for screenshots, demos, and evaluation without real devices.
- Language setting for English, Chinese, Japanese, and French.
- Privacy-first positioning: no account, no cloud, no phone-control features.
| Device | Status |
|---|---|
| Android phones via BatteryHub Agent | Supported |
| BLE mice / keyboards | Supported when battery is reported |
| Bluetooth headphones | Partial, depends on device profile |
| Windows-reported tablets / phones | Supported when Windows exposes battery, may be cached |
| PS5 DualSense | Detection supported; battery depends on Windows/HID exposure |
| Xbox / generic controllers | Experimental or unsupported unless battery is exposed |
| 2.4GHz vendor dongles | Not supported yet |
| Vendor-specific Logitech/Razer/SteelSeries APIs | Not supported yet |
Not every Bluetooth device reports battery accurately. Some values, especially phone/tablet values exposed through Windows Bluetooth or HFP, can be cached or delayed by Windows. BatteryHub labels those sources instead of pretending they are always real-time.
See Battery Data Reliability for how BatteryHub explains reported, estimated, windows_cached, and unavailable values.
BatteryHub is not KDE Connect, Phone Link, DS4Windows, or a controller remapping tool.
It does not implement notification sync, clipboard sync, file transfer, SMS, remote control, media control, screen mirroring, controller remapping, virtual controller emulation, rumble, gyro, LED control, game overlays, Steam integration, DS4Windows integration, iOS support, Apple Watch support, Wear OS support, telecom data usage queries, cloud sync, accounts, plugins, or enterprise device management.
BatteryHub is local-first and battery-status-only.
- No cloud account
- No SMS access
- No contacts access
- No file access
- No photo access
- No microphone access
- No camera access
- No notification-reading permission
- No notification content
- No location access
- No browser data
- Local network only
- Battery status only
The Android Agent requests only the network access needed to expose battery status on your local network. Windows accessory monitoring is limited to devices already paired or connected to the PC.
npm.cmd install
npm.cmd run devOpen http://127.0.0.1:4173. Mock mode is enabled by default and shows an Android phone, headphones, mouse, low-battery DualSense controller, and unsupported-device examples.
npm.cmd run build:win:dirThe generated app folder is dist/win-unpacked. Keep the whole folder together and run BatteryHub.exe.
Open apps/android-agent in Android Studio and run BatteryHub Agent on an Android device on the same local network as your Windows PC.
The Agent shows the device name, battery percentage, charging state, charging method, temperature, health, local endpoint, and pairing token. The desktop app pairs manually from the Add device screen.
BatteryHub is a local power-status console. The interface is inspired by physical battery hardware: black glass panels, metallic borders, compact engineering labels, mono-spaced technical values, and cold cyan energy accents.
It should feel like a small serious utility, not a SaaS dashboard, phone manager, or RGB gaming control panel.
apps/
desktop/ Desktop UI, Electron shell, and Tauri-ready source
android-agent/ Minimal Android battery status agent
docs/ Architecture, product notes, screenshot and release notes
screenshots/ README-ready images
scripts/ Local preview, screenshot capture, checks, and Windows battery providers
- v0.1: Android dashboard, manual pairing, mock mode, local history, Agent reference app.
- v0.2: Windows-connected accessory battery cards and unsupported states.
- v0.3: Gamepad Battery Support, starting with PS5 DualSense detection.
- v0.4: Stable Windows provider, language setting, Android background service, clearer reliability labels.
- v0.5: App and tray icons, Diagnostics page, README GIF, release notes, and data reliability docs.
- v0.6: Signed installer research, SDL/HIDAPI gamepad provider, and broader accessory compatibility.
BatteryHub will stay focused on battery monitoring.
Issues and pull requests are welcome if they preserve the core scope: local-first battery monitoring for Android devices and Windows-connected accessories.
Good first contributions:
- Improve Windows Bluetooth/HID battery detection.
- Improve DualSense battery detection through SDL or HIDAPI providers.
- Add tests around status transitions and source reliability labels.
- Improve Android Agent background reliability.
- Polish packaging, installer, icon, and screenshot automation.
Please do not add phone-control features. If a feature needs SMS, contacts, files, photos, microphone, camera, notification content, cloud accounts, or remote control, it belongs in a different project.
battery, android, windows, desktop-app, tauri, local-first, privacy, dashboard, battery-monitor, android-tools, system-tray, open-source
MIT. See LICENSE.