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
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,16 +2,16 @@
2
2
3
3
A tiny Windows battery indicator for Logitech LIGHTSPEED mice — no G HUB, no service, no telemetry.
4
4
5
-
SuperLightBattery shows the battery level of a Logitech LIGHTSPEED mouse (PRO X Superlight family and similar HID++ 2.0 devices) in the system tray. Two small executables, statically linked, no background framework. Tested on Windows 11.
5
+
SuperLightBattery shows the battery level of a Logitech LIGHTSPEED mouse (PRO X Superlight family and similar HID++ 2.0 devices) in the system tray. Small native binaries, statically linked, no background framework. Tested on Windows 11.
6
6
7
7
## Install
8
8
9
9
1. Download the latest release zip from the [Releases](https://github.com/Lken-cmd/SuperLightBattery/releases) page.
10
-
2. Unzip it anywhere. Keep `SuperLightBattery.exe` and `SuperLightBatteryInstaller.exe` next to each other.
10
+
2. Unzip it anywhere. Keep `SuperLightBattery.exe`, `SuperLightBatteryLauncher.exe`, and `SuperLightBatteryInstaller.exe` next to each other.
11
11
3. Run `SuperLightBatteryInstaller.exe`.
12
12
4. Click **Install**. The tray icon appears, and the app starts automatically at every logon from then on.
13
13
14
-
No admin rights are required. Files go to `%LOCALAPPDATA%\SuperLightBattery` and one value under `HKCU\Software\Microsoft\Windows\CurrentVersion\Run`.
14
+
No admin rights are required. Files go to `%LOCALAPPDATA%\SuperLightBattery` and a `SuperLightBattery` shortcut is added to the current user's Startup folder.
15
15
16
16
## Use
17
17
@@ -39,7 +39,7 @@ Run the installer again and click **Uninstall**, or:
39
39
SuperLightBatteryInstaller.exe --uninstall
40
40
```
41
41
42
-
This deletes the files, removes the registry 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.
42
+
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.
43
43
44
44
## CLI
45
45
@@ -49,7 +49,6 @@ For scripting and one-off checks, `SuperLightBattery.exe` has a small CLI:
49
49
SuperLightBattery.exe --list-devices # list candidate Logitech HID interfaces
50
50
SuperLightBattery.exe --probe # test HID++ communication and battery feature
51
51
SuperLightBattery.exe --once # print a single JSON snapshot and exit
52
-
SuperLightBattery.exe --tray # run the tray app (default)
53
52
```
54
53
55
54
`--once` example output:
@@ -103,31 +102,32 @@ The build writes:
103
102
104
103
```text
105
104
out\SuperLightBattery.exe
105
+
out\SuperLightBatteryLauncher.exe
106
106
out\SuperLightBatteryInstaller.exe
107
107
```
108
108
109
-
Both binaries are statically linked against the MSVC CRT (`/MT`), come in around 190 KB and 160 KB, and depend only on core Windows DLLs (`kernel32`, `user32`, `gdi32`, `shell32`, `setupapi`, `hid`, `advapi32`, `comctl32`). The icon is regenerated from `assets/generate-icon.ps1` if missing.
109
+
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.
110
110
111
111
## Troubleshooting
112
112
113
113
**The tray icon shows "unavailable" and the menu has nothing useful.**
114
114
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.
115
115
116
-
**A console window flashes when I run `SuperLightBattery.exe --tray` directly.**
117
-
The tray binary is a console-subsystem app; the autostart entry hides the console by going through `SuperLightBatteryInstaller.exe --launch-tray`, which spawns the tray with `CREATE_NO_WINDOW`. For a console-free manual launch, use the installer or `--launch-tray`.
116
+
**Why are there two app executables?**
117
+
`SuperLightBattery.exe`is the real tray and CLI app. `SuperLightBatteryLauncher.exe` is the tiny windowless startup launcher shown by Startup Apps.
118
118
119
119
**Icon looks blurry on a high-DPI display.**
120
120
The tray icon renders at the shell's requested pixel size with 4× supersampling and is per-monitor DPI aware. If it still looks soft, open an issue and include your DPI scaling (Settings → System → Display → Scale).
121
121
122
-
**Installer says "SuperLightBattery.exe must sit next to the installer."**
123
-
The two executables need to be in the same folder. The release zip ships them that way already; re-download the full archive if they got separated.
122
+
**Installer says a SuperLightBattery file must sit next to the installer.**
123
+
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.
124
124
125
125
**Tray won't exit during uninstall.**
126
126
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.
127
127
128
128
## Releases
129
129
130
-
Tagged releases (`v*`) trigger a GitHub Actions build on `windows-latest` that zips both binaries plus the README and LICENSE and publishes a GitHub Release.
130
+
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