LGSTrayEx

Note: This is a community-maintained fork of the original andyvorld/LGSTrayBattery.
The original project appears unmaintained since February 2024.
This fork continues development with bug fixes and new features.

Check the original page for detailed documentation.

Install

Configuration

See included settings file for documentation.

New Features

• MQTT client, advertise to HA
• Notifications for device on/off, battery level thresholds, configurable
• Improved numeric display with small battery bar
• Configurable colors for battery level bar in icon mode, per light/dark theme
• Support for monitoring devices that connect both wired and wireless
• Ghub and Native devices: choose which source you want to monitor from devices menu
• Menu option Keep Offline Devices: configures tray icon behaviour
• Device On/Off status represented in http xml with is_online key
• Dark / Light menu

See release notes

Device compatibility

• 🔋 Wireless mice/keyboards/headsets using Unifying, Bolt, Lightspeed or direct Bluetooth receivers
• 🔋 Devices from roughly 2010+ that support HID++ 2.0
• 🪫 Older HID++ 1.0 devices are likely unsupported (ping will fail)

Currently tested with:

• ✅(Bolt) MX Keys S
• ✅(Bolt) MX Anywhere 3S
• ✅(Bolt) MX Master 3
• ✅(Bolt) MX Mechanical
• ✅(Unifying) M330 Silent
• ✅(Lightspeed) G Pro X 2 Mouse
• ✅(Lightspeed) G305 Mouse
• ✅(Lightspeed) G705 Mouse
• ✅(Lightspeed) G515 TKL
• 🟥(Lightspeed) G522 Headset Native - not detected, cannot fix
• 🟨(Lightspeed) G522 Headset Ghub - awaiting confirmation

OS Compatibility

• currently Windows 11 only

Known issues

• enableRichToolsips = true coud result in tooltips not closing properly when using fullscreen apps
  Set this to false for classic windows tooltips. There is no specific functionality implemented for this.
  It will default to false in versions after v3.1.3
• if application does not start / does not produce log file please ensure proper permissions in install folder: Current user and SYSTEM must have Full Control over folder and files.

Issue reporting

1. Edit appsettings.toml

[Logging]
enabled = true
verbose = true

2. Reproduce issue
3. Post the resulting diagnostic.log along with the issue description and repro.

Notes

• hidapi.dll is same as andy's, SHA256: 38bda32f593c054cacaf95bebce36f9bacc7fbd0740f7b6f72f6d368fbc84b4d