Ruflas/headset-battery-indicator

Description

A graphical system tray utility built with Python/Qt for "gaming" headsets. It provides quick access to battery status, ChatMix, Sidetone levels, and Auto-Off time by acting as a frontend for the official headsetcontrol package.

Installation Instructions

This package provides the graphical frontend for headset management.

Installation:

Enable the COPR repository: sudo dnf copr enable ruflas/headset-battery-indicator Install the package (This will automatically install headsetcontrol and python3-PySide6 as dependencies): sudo dnf install python-headset-battery-indicator

Install Dependencies (Manual / From Source)

You must have the headsetcontrol backend and the Python GUI library installed. Distribution Commands Fedora sudo dnf install headsetcontrol python3-pyside6 Debian/Ubuntu sudo apt install headsetcontrol python3-pyside6 Arch/Manjaro sudo pacman -S headsetcontrol python-pyside6

  1. Install the Script (via pip)

Once dependencies are met, navigate to the cloned directory and install the script package: Bash

Clone the repository

git clone https://github.com/ruflas/headset-battery-indicator.git cd headset-battery-indicator

Install the script using pip (this adds the 'headset-battery-indicator' command to your PATH)

pip install .

3-Make Executable (AppImage Method)

If you downloaded the AppImage from the Releases page, you only need to give it execute permissions: Bash

chmod +x Headset_Battery_Indicator-*.AppImage

Usage: After installation, add headset-battery-indicator to your system's Autostart applications. You can control all headset features (Sidetone, ChatMix, Lights) via the system tray icon's right-click menu.

Active Releases

The following unofficial repositories are provided as-is by owner of this project. Contact the owner directly for bugs or issues (IE: not bugzilla).

* Total number of downloaded packages.


This is a companion discussion topic for the original entry at https://copr.fedorainfracloud.org/coprs/ruflas/headset-battery-indicator

It seems like the RPM package was renamed from headset-battery-indicator to python-headset-battery-indicator, which made dnf unable to upgrade it from 1.3.0 to 2.2.0 without explicitly swapping it for the new package name (sudo dnf swap headset-battery-indicator python-headset-battery-indicator)

Thanks for the report! You were right β€” the RPM spec had been renamed to python-headset-battery-indicator at some point, which broke the upgrade path from 1.3.0.

The reason it happened: PyInstaller generates a .spec file in the project root with the same name as the binary (headset-battery-indicator.spec), so the RPM spec was renamed to avoid the conflict. That turned out to be the wrong fix β€” the right solution was to just ignore the PyInstaller-generated file in .gitignore, not rename the RPM package.

I’ve now reverted the name back to headset-battery-indicator and added Obsoletes/Provides entries so anyone who ended up with the python- named version will also get a clean upgrade automatically.

A new Copr build should be on its way. Thanks again!

1 Like