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

🎧 Headset Battery Indicator — Graphical Frontend

This package provides the graphical frontend for headset management.

📦 Installation

1. Install from COPR (Recommended for Fedora)

# Enable the COPR repository
sudo dnf copr enable ruflas/headset-battery-indicator

# Install the package
sudo dnf install headset-battery-indicator

This will automatically install headsetcontrol and python3-PySide6 as dependencies.

2. Manual Installation (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 |

Install the Script (via pip)

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

# Clone the repository
git clone https://github.com/ruflas/headset-battery-indicator.git
cd headset-battery-indicator

# Install the script using pip (adds the command to your PATH)
pip install .

3. Make Executable (AppImage Method)

If you downloaded the AppImage from the Releases page, simply give it execute permissions:

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, and 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).

Release	Architectures	Repo Download
Fedora 42	x86_64 (0)*	Fedora 42 (8 downloads)
Fedora 43	x86_64 (11)*	Fedora 43 (8 downloads)
Fedora rawhide	x86_64 (0)*	Fedora rawhide (4 downloads)

* Total number of downloaded packages.