Steelseries Mouse Battery Retrieval
This is a handy Windows application that retrieves the battery level of your Steelseries mouse and displays it in the system tray.
Table of Contents
Usage
Once the application is started, you can hover over the icon to see the battery level. Right-clicking allows you to exit the application or view the battery level again.
Our Tested/Working Devices
- Steelseries AEROX 3 Wireless (2.4G mode)
- Steelseries AEROX 5 Wireless (2.4G mode)
- Steelseries AEROX 9 Wireless (2.4G mode)
- Steelseries Prime Wireless
- Steelseries Prime Mini Wireless
Installation
Latest Version (Recommended)
- Download the latest application installer from the Releases tab.
- Run the installer. This will install the application and place a shortcut in your Start Menu and add it to your auto-startup folder.
- After installation, the installer will ask you if you want to run the application. If you choose not to, you can run it from the Start Menu shortcut or by restarting your computer.
Manual installation
- Download the Git repository as a zip file and extract it somewhere (or clone it with Git).
- Install Python 3 (https://www.python.org/downloads/) and ensure you check the box to add it to your PATH.
- Install the following packages via the
pip install -r requirements.txt
command in the mouse-battery
folder.
- Run the script:
- Place the
start_mouse.bat
file as a shortcut in your startup folder (C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup).
- You may need to modify the bat script to point to your Python installation if you have multiple versions installed or have renamed the executable.
- Alternatively, you can run the script manually.
Building application and installer from source
To build the application yourself, check out building.md
Supported Devices
The rivalcfg
library supports a variety of devices. A complete list of supported devices can be found here.
Troubleshooting
If you encounter any issues, first check the knownissues.md
file in the repository to see if your problem is already listed.
If your problem is not listed, you can run the script in the mouse-battery
folder. Note the output of the script and open an issue with the output and your mouse model. Provide additional details, such as whether you have multiple mice connected, your connection mode, etc.
python mouse.py
Uninstallation
Latest Version
- Go to the Control Panel and select "Uninstall a program".
- Find "SteelMouse" in the list and click "Uninstall".
Older Version
- Delete the
mouse-battery
folder.
- Delete the
start_mouse.bat
file in your startup folder (C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup).
- Uninstall Python 3 if you no longer need it.
Acknowledgements
- DeveloperX19 for the license of his intellectual property of the icon art.
- flozz for the
rivalcfg
library and the idea of a standalone Python executable.
- Pyenb for rewrites.
- T-solidus-T for improvements to the threads, icon & menu logic.
- bossman90 for the battery charging indicator in the system tray.
License
MIT: Feel free to use this code as you wish. If you do use it, I'd appreciate a mention.