Skip to content

Latest commit

 

History

History
70 lines (49 loc) · 4.13 KB

README.md

File metadata and controls

70 lines (49 loc) · 4.13 KB

HeadsetControl-GUI Github All Releases license

This is a GUI for Sapds great HeadsetControl.
It's just a frontend to graphically interact with the original HeadsetControl and has no functionality by itself.

Platforms

OS Compiled Tested
Windows
Linux
MacOS

If you are on Linux or Mac and try to build the app and test it, I'd be happy to hear if it did or didn't work.

Installation (Windows)

WinGet

winget install LeoKlaus.HeadsetControl-GUI

After that to you can reboot powershell an you can run the program with the command:

HeadsetControl-GUI

Manual

  1. Download the latest release of HeadsetControl-GUI from the releases section of this page.
  2. Extract HeadsetControl-GUI to any folder.

The finished folder should look something like this:

361239376-0145ca37-6e59-4170-ba26-804e8856dbc8

Usage

Start HeadsetControl-GUI by double-clicking "HeadsetControl-GUI.exe", and if your headset is supported and everything was set up correctly, you will be greeted by the following screen HeadsetControl-GUI has..

If you don't find some features in you ui, probably it's not supported by your headset or it has not been implemented by HeadsetControl.

Videosenzatitolo-RealizzatoconClipchamp-ezgif com-crop

Here you can adjust all settings supported by your headset. Changes may or may not persist even after rebooting the system or turning the headset off(It depends on how headsets stores their own settings).

If you have a wireless headset with support for battery levels, you can also minimize HeadsetControl-GUI to the system tray.

338270796-ea327c0a-e39a-4035-aa99-bc6325724571

That way, you will be able to see the battery status at a glance and get a reminder when the batteries of your headset run low (below 15%). Hovering over the tray icon will show you the current battery percentage. You can also right-click the tray icon to bring up a context menu with quick access to the light control. You can also open or completely close the GUI through the context menu.

338270796-ea327c0a-e39a-4035-aa99-bc6325724571

Performance

While the concept of calling another app for every single interaction has some inherit overhead, HeadsetControl-GUI is very light on ressources. Being open in the background, HeadsetControl-GUI consists of a single process that uses virtually no CPU time and about 8-10MB of system memory.

349140526-3171e62d-8a0c-49b6-88bd-e5b03393c7fe

Building from source

To build HeadsetControl-GUI from source, you have to have a proper QT-ready development environment.
I developed, built and tested the program with Qt 6.7.0 and Qt Creator as IDE.
Clone the source code, import the project into Qt Creator or your favourite IDE and build it.

Additional information

This software comes with no warranty whatsoever.
It's not properly tested for memory leakage and may or may not work with configurations other than those I've tested.

Disclaimer: This program is in no way affiliated with Sapd or HeadsetControl. All issues regarding the functionality of HeadsetControl (like compatiblity with devices) are beyond the scope of this project.