🇬🇧 English · 🇮🇹 Italiano
A tray icon showing the battery level of the Logitech G435 headset through its LIGHTSPEED dongle. Written in Rust, it runs on Linux (natively on KDE, on GNOME with the AppIndicator extension) and on Windows.
- The icon shows the percentage and changes color with the level: green, orange (≤35%) or red (≤15%).
- The tooltip shows
G435: 94% (4140 mV). - Menu: refresh now, start at login, a cheat sheet of the headset button combinations, quit.
- On Linux, makes the headset's Volume + button work (see Headset buttons).
- Reads the battery every 15 minutes and retries every minute after an error.
- On Linux, scheduled reads wait until the headset is not playing audio, for at most 30 minutes, and the icon keeps showing the last value in the meantime. The first read at startup and a manual refresh happen right away. A game or browser with an open audio stream counts as "playing" even when silent.
- No G HUB, no Logitech DLLs, no network traffic.
Unofficial project, not affiliated with Logitech. The user interface is currently in Italian.
| PID | Revision | Transport | Status |
|---|---|---|---|
046d:0acb |
HDT647 (most common) | report 6 through the Realtek bridge ("bootloader") | tested |
046d:0adf |
newer revision | 64-byte reports with CRC-16 | ported from portyporty, untested |
To check which one you have: lsusb | grep 046d on Linux, or Device Manager on Windows.
Arch Linux (AUR): two packages, pick one:
- logitech-g435-battery-bin: prebuilt binary, installs in seconds.
- logitech-g435-battery: compiled on your machine.
yay -S logitech-g435-battery-binBoth also install the udev rule and a menu entry. Start G435 Tray from the application menu, then enable start at login from the tray icon menu.
Other Linux distributions: download g435-tray-<version>-x86_64-linux.tar.gz from the latest release, extract it and run g435-tray. If you get a permission error, install the included udev rule (see Permissions).
Windows: download g435-tray-<version>-x86_64-windows.zip from the latest release, extract it and run g435-tray.exe. The Windows build is compiled and tested automatically, but it hasn't been tried on real Windows hardware yet: feedback is welcome.
Every release also has a SHA256SUMS file to verify the downloads.
cargo build --releaseThe binary ends up in target/release/g435-tray (g435-tray.exe on Windows).
- Linux: needs
libudev(packagesystemd-libs/libudev-dev), ALSA (alsa-lib/libasound2-dev) andpkg-config. - Windows: the Rust MSVC toolchain is enough. hidapi uses its native Rust backend, so no C compiler is needed.
To install it for the current user (into ~/.cargo/bin):
cargo install --path .The program needs access to the dongle's /dev/hidrawN. If g435-tray --once fails with a permission error:
sudo cp packaging/linux/70-logitech-g435.rules /etc/udev/rules.d/sudo udevadm control --reload && sudo udevadm triggerg435-tray start the tray icon
g435-tray --once print "94% (4140 mV)" and exit (handy for scripts/waybar/polybar)
g435-tray --interval 30 read every 30 minutes
G435_DEBUG=1 g435-tray --once dump the HID traffic
- The percentage is an estimate based on the Li-Po battery voltage (4.2 V = 100%, 3.4 V = 0%). While charging, the voltage rises and the estimate reads higher than the real charge.
- On the
0acbdongle every read puts the USB bridge in "bootloader" mode, and audio and microphone stop for about 0.6 seconds. This is a limit of the dongle firmware: no way to read the battery without the bootloader is known (measurements in docs/PROTOCOL.md). That's why the program reads only every 15 minutes and, on Linux, waits for the audio to stop. It checks/proc/asound/cardN/pcm*/sub*/statusof the G435's USB sound card; PipeWire closes the device a few seconds after playback ends. This check is not implemented on Windows yet. - The battery command only reaches the headset when the dongle is in remote mode 1. If it isn't, the program sets it (the same value the official pairing tool uses).
- If the dongle stops answering (it acknowledges commands but returns no data), unplug it and plug it back in.
Tested with input event captures and a raw usbmon trace of the dongle:
| Button | Reaches the PC? | Result on Linux |
|---|---|---|
| Volume − | yes, HID KEY_VOLUMEDOWN |
lowers the system volume |
| Volume + | yes, HID KEY_VOLUMEUP, only while the dongle's USB playback volume is below 100% |
raises the system volume |
| Mute | no: no USB traffic at all, the mic is muted inside the headset | the system mic icon cannot follow it |
| Power, combinations | no | handled inside the headset |
- Volume + does nothing (double beep): the dongle drops it while its hardware volume is at the maximum, as if the PC were already at 100%. PipeWire always leaves that control at 100% and scales in software. The tray app keeps it one step below the maximum (174/175, an inaudible −0.4 dB), so Volume + works. Manually:
amixer -c <card> cset name='G435 Wireless Gaming Headset Playback Volum' 174. - Volume keys ignored on KDE Plasma: KDE lists the dongle's "Consumer Control" device as a mouse in System Settings → Mouse & Touchpad; if it gets disabled there, the volume keys stop working. Re-enable it there, or set
Enabled=truein the[Libinput][1133][2763][Logitech G series G435 Wireless Gaming Headset Consumer Control]section of~/.config/kcminputrc. - The headset has no play button, no ANC and no transparency mode; the closest thing is sidetone, which plays your own voice back through the microphone. Sidetone, the 85/100 dB volume limit and LIGHTSPEED/Bluetooth switching are only available through button combinations: the tray menu lists them under Comandi della cuffia.
Both dongles talk to the same audio SoC (Airoha/Audiowise) using "PA" commands:
50 41 <category> <seq> <len> <command...> request
50 49 ... reply
| Command | Bytes | Reply |
|---|---|---|
| REMOTE_GET_CONNECT_STATUS | 0e .. 01 e3 |
02 00 e3 <0/1> |
| REMOTE_GET_MODE / SET_MODE | 0e .. 01 e0 / 0e .. 02 e1 01 |
02 00 e0 <mode> |
| GET_BATTERY | 06 .. 01 00 31 |
07 00 06 <seq|80> 00 <mV lo> <mV hi> .. |
On the 0acb the transport is: enter the bootloader with output report 06 01 03, send the command with 06 04 03 <len lo> <len hi> <cmd> (ack 06 5a on the input endpoint), read the reply with GET_FEATURE on report 6, and leave with 06 08 03. Details, timings and a known way to hang the dongle are in docs/PROTOCOL.md.
Besides the battery, the available research documents these commands:
- Headset connection status (on/off): works, and the program already uses it to report "headset off".
- RSSI / radio link quality (
GET_RSSI,LQ_GET_QUALTY): candidates for a signal indicator. Unverified: during testing the dongle got stuck right after aGET_RSSIand anOTA_CMD_ECHO. - Firmware version (
OTA_CMD_GET_IMAGE_VERSION). - LEDs (
CMD_SET_LED,CMD_SET_LED_PWM) and EQ/DSP (EQ_ON_OFF,DSP_CMD_IIR_EQ, ...): present in firmware shared by several products, but they may have no effect on the G435. - Dongle ↔ headset pairing (scan and connect by MAC address): what the official re-pairing tool does.
- Dangerous commands to stay away from: OTA/flash/NVDS (
ERASE_LOAD_REGION,OTA_CMD_UPDATE,AW_HA_CLEAR_NVDS, ...).
Nobody has found commands for sidetone, the volume limit, reading the hardware mute, or detecting charging yet. The mute and the button combinations produce no USB traffic at all (checked with usbmon).
The volume and mute shown by other projects (e.g. G435-Companion) belong to the operating system, not the headset.
- deddroid: idea, testing on real hardware and design decisions.
- Claude (Anthropic): wrote the Rust code, analyzed the existing projects and verified the protocol on the
0acbdongle, all in a Claude Code session. - endes for reverse engineering the
0acbdongle, portyporty (Oğuz Kayra Bozkurt) for the0adfdongle protocol: see the sources below.
MIT: anyone can use, modify and redistribute the code, including commercially, as long as the license file is kept. Parts derived from other projects are listed in THIRD-PARTY-NOTICES.
- endes — "USB HID down the rabbit hole: Logitech G435 dongle" and the command list gist
- portyporty/g435-battery-percentage: Windows tray app,
0adfdongle, voltage→percentage curve - GotardoN1/G435-Companion: Bluetooth battery through Windows PnP properties
- CSaratakij/G435BatteryApproximate: estimate based on usage time, no real reading
