Summary
A tool to control certain aspects of USB-connected headsets on Linux. Currently, support is provided for adjusting sidetone, getting battery state, controlling LEDs, and setting the inactive time. See below for which headset supports which feature.
Sidetone
Want to use your Headset under Linux or Mac OS X, but you shout while talking because there is no support for sidetone? With sidetone, sometimes also called loopback, you can hear your own voice while talking. This differs from a simple loopback via PulseAudio as you won't have any disturbing latency.
Supported Headsets
- HyperX Cloud Alpha Wireless
- Battery, Inactive time, Sidetone, Voice Prompts (only tested on Linux)
- HyperX Cloud Flight Wireless
- Battery only (only tested on Linux)
- Corsair Void (Most void-versions*)
- Sidetone, Battery (for Wireless), LED on/off, Notification Sound
- Logitech G430
- No support in current version (Last working on macOS in commit 41be99379f)
- Logitech G432
- Sidetone (only tested on Linux)
- Logitech G433
- Sidetone (only tested on Linux)
- Logitech G533
- Sidetone, Battery (for Wireless)
- Logitech G535
- Sidetone, Battery, Inactive time (only tested on Linux)
- Logitech G633 / G635 / G733 / G933 / G935
- Sidetone, Battery (for Wireless), LED on/off
- Logitech G930
- Sidetone, Battery
- SteelSeries Arctis 1, Arctis 1 for XBox
- Sidetone, Battery, Inactive time
- SteelSeries Arctis (7 and Pro)
- Sidetone, Battery, Inactive time, Chat-Mix level, LED on/off (allows to turn off the blinking LED on the base-station)
- SteelSeries Arctis 7+
- Sidetone, Battery, Chat-Mix level, Inactive time, Equalizer Presets, Equalizer
- SteelSeries Arctis Nova 7
- Sidetone, Battery, Chat-Mix level, Inactive time, Equalizer Presets, Equalizer
- SteelSeries Arctis 9
- Sidetone, Battery, Inactive time, Chat-Mix level
- SteelSeries Arctis Pro Wireless
- Sidetone, Battery, Inactive time
- Logitech G PRO
- Sidetone, Battery, Inactive time
- Logitech Zone Wired/Zone 750
- Sidetone, Voice prompts, Rotate to mute
- Roccat Elo 7.1 Air
- LED on/off, Inactive time (Note for Linux: Sidetone is handled by sound driver => use AlsaMixer)
For non-supported headsets on Linux: There is a chance that you can set the sidetone via AlsaMixer
* If your Corsair headset is not recognized, see Adding a corsair device. HS80 and HS70 wired, RGB Elite, and Virtuso is not supported, but you can change its sidetone in Alsamixer.
For more features or other headsets, the protocol of the respective headset must be analyzed further. This can be done by capturing the USB traffic between the device and the original Windows software and analyzing it with WireShark or USBlyzer. For that, you can also use a virtual machine with USB passthrough. The wiki provides a tutorial.
Some headsets expose sidetone as audio-channel volume and as such can be changed in Alsamixer.
Building
Prerequisites
You will need hidapi, c compilers and cmake. All usually installable via package managers.
Debian / Ubuntu
apt-get install build-essential git cmake libhidapi-dev
CentOS / RHEL (RedHat based)
RHEL and CentOS also require the epel-repository: yum install epel-release. Please inform yourself about the consequences of activating the epel-repository.
yum groupinstall "Development tools"
yum install git cmake hidapi-devel
Fedora
dnf install cmake hidapi-devel g++
Sabayon
equo i hidapi cmake
Arch Linux
pacman -S git cmake hidapi
FreeBSD
pkg install hidapi cmake
Gentoo
-
Enable nitratesky overlay:
eselect repository enable nitratesky -
Install:
emerge -a app-misc/headsetcontrol
Mac OS X
I recommend using Homebrew.
You can automatically compile and install the latest version of the software, by using
brew install sapd/headsetcontrol/headsetcontrol --HEAD.
If you wish to compile it manually, you can install the dependencies with brew install hidapi cmake.
Also you have to download Xcode via the Mac App Store for the compilers.
Windows
Windows support is a bit experimental and might not work in all cases. You can find binaries in the releases page, or compile instructions via MSYS2/MinGW in the wiki.
Compiling
git clone https://github.com/Sapd/HeadsetControl && cd HeadsetControl
mkdir build && cd build
cmake ..
make
If you want to be able to call HeadsetControl from every folder type:
make installThis will copy the binary to a folder globally accessible via path.
Access without root
Also in Linux, you need udev rules if you don't want to start the application with root. Those rules are generated via headsetcontrol -u. Typing make install on Linux generates and writes them automatically to /etc/udev/rules.d/.
You can reload udev configuration without reboot via sudo udevadm control --reload-rules && sudo udevadm trigger
Usage
Type headsetcontrol -h to get all available options.
(Don't forget to prefix it with ./ when the application resides in the current folder)
Type headsetcontrol -? to get a list of supported capabilities for the currently detected headset.
headsetcontrol -s 128 sets the sidetone to 128 (REAL loud). You can silence it with 0. I recommend a loudness of 16.
The following options don't work on all devices yet:
headsetcontrol -b check battery level. Returns a value from 0 to 100 or loading.
headsetcontrol -n 0|1 sends a notification sound, made by the headset. 0 or 1 are currently supported as values.
headsetcontrol -l 0|1 switches LED off/on (off almost doubles battery lifetime!).
headsetcontrol --short-output cut unnecessary output, for reading by other scripts or applications.
headsetcontrol -i 0-90 sets inactive time in minutes, time must be between 0 and 90, 0 disables the feature.
headsetcontrol -m retrieves the current chat-mix-dial level setting between 0 and 128. Below 64 is the game side and above is the chat side.
headsetcontrol -v 0|1 turn voice prompts on or off.
headsetcontrol -r 0|1 turn rotate to mute feature on or off.
headsetcontrol -u Generates and outputs udev-rules for Linux.
headsetcontrol --dev Advanced menu for developers, to send and/or receive custom data
headsetcontrol -p 0-3 sets equalizer preset, must be between 0 and 3, 0 is the default preset.
headsetcontrol -e string sets equalizer to specified curve, string must contain band values specific to the device (hex or decimal) delimited by spaces, or commas, or new-lines e.g "0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18".
Modifiers
--timeout 5000 Specifies a timeout for read-operations in milliseconds. Default is 5 seconds, 0 disables timeout.
Third Party
The following additional software can be used to enable control via a GUI
Linux
headsetcontrol-notifcationd provides notifications on the battery status of connected headsets (PHP based)
headset-charge-indicator adds a system tray icon, displaying the current amount of battery. Also provides controls via the icon's menu (Python based)
gnome-shell-extension-HeadsetControl adds a system tray icon, displaying the current amount of battery. Also provides controls via the icon's menu (gnome-shell 42 and later)
Windows
HeadsetControl-SystemTray adds a system tray icon, displaying the current amount of battery. (Python based)
Development
Look at the wiki if you want to contribute and implement another device or improve the software.
Release Cycle
HeadsetControl is designed to be a rolling-release software, with minor versions (0.x.0) providing new features in the software itself, and patch versions (0.0.x) fixing issues or adding support for new headsets. Major versions are reserved for bigger rewrites.
If you want to build and provide packages for it, we recommend building and providing the current git HEAD in most cases. This ensures that users have access to the latest features and fixes.
Notice
HeadsetControl is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
License
Released under GPL v3.
Like it?
If you like my software please star the repository.