You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+3-22Lines changed: 3 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# SuperLightBattery
2
2
3
-
A tiny Windows battery indicator for the Logitech PRO X Superlight — no G HUB, no service, no telemetry.
3
+
A tiny Windows battery indicator for the Logitech PRO X Superlight, no G HUB, no service, no telemetry.
4
4
5
5
SuperLightBattery shows the battery level of an original Logitech PRO X Superlight in the system tray. Small native binaries, statically linked, no background framework. Tested on Windows 11.
6
6
@@ -45,7 +45,7 @@ Run the installer again and click **Uninstall**, or:
45
45
SuperLightBatteryInstaller.exe --uninstall
46
46
```
47
47
48
-
This deletes the files, removes the startup shortcut, cleans up any old registry startup entry, and stops the running tray. If a file is locked because the tray is still active, the installer schedules it for deletion at next reboot.
48
+
This deletes the files, removes the startup shortcutand stops the running tray.
49
49
50
50
## CLI
51
51
@@ -89,13 +89,11 @@ SuperLightBattery.exe --once # print a single JSON snapshot and exit
89
89
90
90
Notes:
91
91
92
-
-`battery.percent` is firmware-reported when available. Voltage is never converted into a fake percentage.
92
+
-`battery.percent` is firmware-reported.
93
93
-`battery.source` names the HID++ feature or register that supplied the value.
94
94
-`device.name` is the firmware-reported name; `device.hid_product` is the generic Windows HID product string.
95
95
- Unsupported sections come back as `null`.
96
96
97
-
`--list-devices` and `--probe` deliberately do not print serial numbers, USB instance IDs, HID device paths, captures, or logs.
98
-
99
97
## Build from source
100
98
101
99
You need MSVC C++ build tools (Visual Studio 2019 or 2022, x64) and PowerShell.
The app and installer are statically linked against the MSVC CRT (`/MT`); the small startup launcher is CRT-free. The binaries depend only on core Windows DLLs (`kernel32`, `user32`, `gdi32`, `shell32`, `setupapi`, `hid`, `advapi32`, `comctl32`, `ole32`). The icon is regenerated from `assets/generate-icon.ps1` if missing.
116
114
117
-
## Troubleshooting
118
-
119
-
**The tray icon shows "unavailable" and the menu has nothing useful.**
120
-
Run `SuperLightBattery.exe --probe` from a terminal. It will list which Logitech HID collections are detected and which (if any) answer HID++. Make sure the receiver is plugged in and the mouse is paired and on.
121
-
122
-
**Why are there two app executables?**
123
-
`SuperLightBattery.exe` is the real tray and CLI app. `SuperLightBatteryLauncher.exe` is the tiny windowless startup launcher shown by Startup Apps.
124
-
125
-
**Icon looks blurry on a high-DPI display.**
126
-
The tray icon renders at the shell's requested pixel size from a pixel-aligned 16×16 source and is per-monitor DPI aware. If it still looks soft, open an issue and include your DPI scaling (Settings → System → Display → Scale).
127
-
128
-
**Installer says a SuperLightBattery file must sit next to the installer.**
129
-
The tray/CLI app, startup launcher, and installer need to be in the same folder. The release zip ships them that way already; re-download the full archive if they got separated.
130
-
131
-
**Tray won't exit during uninstall.**
132
-
The installer posts `WM_CLOSE` to the tray window and waits briefly. If the tray was unresponsive at that moment, exit it manually from its right-click menu and run uninstall again. The locked files were already scheduled for deletion at next reboot.
133
-
134
115
## Releases
135
116
136
117
Tagged releases (`v*`) trigger a GitHub Actions build on `windows-latest` that zips the binaries plus the README and LICENSE and publishes a GitHub Release.
0 commit comments