Skip to content

Adds a small icon to the "system tray" area of the Windows task bar, which displays the battery level of any connected SteelSeries Arctis headphone.

Notifications You must be signed in to change notification settings

aarol/arctis-battery-indicator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Arctis Battery Indicator

Adds a small icon to the "system tray" area of the Windows task bar, which displays the battery level of any connected SteelSeries Arctis headset.

Screenshot of indicator on Windows task bar

Features

  • Works on Windows 10+
  • Built using Rust, with very low resource usage (<1MB RAM)
  • Supports all known Arctis headsets

Installation

  • Download the latest release .zip file
  • Extract all of the files into any folder (like Downloads).
  • Right click Install.ps1 and run the PowerShell script.

You can also update the program by downloading a new version and running Install.ps1.

How to uninstall

Simply remove all of the files in %localAppData%\ArctisBatteryIndicator (copy the path, press Win+R and paste the path to enter)

The installer also creates a file in %appData%\Microsoft\Windows\Start Menu\Programs\Startup to run the program on startup.

Troubleshooting

If you're experiencing crashes or other issues, you can try running the arctis-battery-indicator-debug.exe located at %localAppData%\ArctisBatteryIndicator or look at the log file located in the same folder.

Why does it only show 100%, 75%, 50%, 25% or 0%?

This is limitation of the headsets themselves, as the devices only expose 5 possible battery states.

My headset is connected, but it still shows "No headphone adapter found"

Your headset might be unsupported due to being a newer model. Either create a new issue or see Adding a new headset

Connection status updates slowly / unreliably

Often the adapter (plugged into your PC) is really slow at updating its information whenever something happens, like headphones disconnecting / reconnecting. I haven't found a way to work around this yet. Shutting down the SteelSeries GG app may help on some occasions.

Development

Rust and Cargo need to be installed.

  • Running the application: cargo run --release

  • Installing the application locally: cargo install

  • Debugging the application: press F5 in VS Code with the Rust Analyzer extension and CodeLLDB installed.

Todo

  • Show rough estimations for battery remaining battery life (in hours)
  • Updated icons to show charging states, etc.

Adding a new headset

Add a new entry to the bottom of KNOWN_HEADPHONES in headphone_models.rs and submit a new pull request.

The parameters, such as write_bytes and battery_percent_idx can be discovered by sniffing the USB traffic with something like WireShark and USBPcap

I have a post on my website explaining how to do this: https://aarol.dev/posts/arctis-hid

About

Adds a small icon to the "system tray" area of the Windows task bar, which displays the battery level of any connected SteelSeries Arctis headphone.

Topics

Resources

Stars

Watchers

Forks