OpenMr0097

A tiny Windows system-tray app that shows the battery level of a Logitech wireless mouse.

Features

• Battery percentage shown directly in the tray icon, colour-coded (green / amber / red, blue while charging, grey when there is no reading).
• Refreshes automatically every 60 seconds; left-click to refresh now.
• Estimated time remaining ("~3 days left"), shown on hover.
• Low-battery notifications at 15% and 5%, once per discharge.
• CSV history log of every reading, at %LOCALAPPDATA%\OpenMr0097\history.csv.
• Optional "Start with Windows" toggle (per-user, no admin rights).
• python -m openmr0097.battery prints the level once and exits, if you just want a number.

Supported mice

Logitech wireless mice that speak HID++ 2.0 — for example the G Pro X Superlight and G Pro X 2 — connected over a Lightspeed or Unifying receiver, or directly.

Requirements

• Windows 10 or later
• Python 3.9+

Install

git clone https://github.com/Bigmansol0/OpenMr0097.git
cd OpenMr0097
pip install -r requirements.txt
pythonw main.py

To build a standalone dist\OpenMr0097.exe (no Python needed to run it):

powershell -ExecutionPolicy Bypass -File packaging\build.ps1

Layout

main.py            launcher - pythonw main.py starts the tray app
openmr0097/        the package
  battery.py         HID++ 2.0 protocol and device discovery
  tray.py            the tray icon, menu and polling loop
  icon_render.py     tray artwork
  history.py         CSV log and time-remaining estimate
  notify.py          low-battery threshold logic
  startup.py         "Start with Windows" registry entry
packaging/         PyInstaller spec and build script
tests/             run with: python -m pytest

Notes

Only one program can read the mouse at a time. If G HUB or Logitech Options is running, readings may intermittently fail — close them for reliable results.