# Sapd/HeadsetControl

Sidetone and Battery status for Logitech G930, G533, G633, G933 SteelSeries Arctis 7/PRO 2019 and Corsair VOID (Pro) in Linux and MacOSX

Repository: https://github.com/Sapd/HeadsetControl
Canonical: https://ross.abutalabs.com/products/headsetcontrol
Language: C++
License: GPL-3.0
License Family: copyleft
Topics: linux, headsets, osx, hid, usb, corsair, logitech, hidapi, corsair-void, sidetone, battery
Last push: 2026-08-26T10:42:49+00:00

## Health v2 (maintenance only)
Score: 86/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 62, longevity 100
- inputs: {"age_days": 3854, "days_push": 7, "days_rel": 41, "gap_med": 426, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1892, forks 234 (observed 2026-08-28T04:05:50.276023+00:00)

## What it is
HeadsetControl is a cross-platform command-line utility written in C++ that controls USB gaming headsets from brands like Logitech, SteelSeries, and Corsair via HID. It exposes device settings such as sidetone level, battery status, LED control, equalizer presets, chat-mix, and power-off timers through a simple CLI suitable for scripts and status bars.

## Use cases
- check the battery level of my Arctis 7 from the command line
- adjust sidetone volume on a Logitech G933 so I can hear my own voice
- turn off the blinking LED on my Corsair Void Pro
- set an equalizer preset on my gaming headset
- monitor headset battery in my Waybar or polybar script
- set an auto power-off timer so the headset stops idling
- balance game and chat audio with chat-mix control
- manage headset microphone mute and volume settings

## When to choose
- You own one of the supported USB headsets (Logitech G930/G533/G633/G933, SteelSeries Arctis 7/PRO 2019, Corsair VOID series, and others listed in the README) and want native control without vendor software
- You are on Linux, macOS, or Windows and need scriptable headset control for desktop widgets, keybindings, or automation
- You want a lightweight, well-packaged tool that installs via apt, dnf, AUR, Nix, Homebrew, or signed release binaries

## When to avoid
- Your headset model is not in the supported devices table, especially Bluetooth-only or newer devices
- You need a graphical interface - this is a CLI tool and only third-party GUI frontends exist
- You want system-wide audio processing or sound-card EQ rather than control of the headset's onboard settings

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, audio-processing, configuration-management
- domain: hardware, gaming-tools, cross-platform
- platform: windows, bsd, cli, cross-platform
- tags: hid, hidapi, usb-headsets, sidetone, battery-status, led-control, equalizer, logitech, steelseries, corsair, gaming-headsets, udev-rules, command-line, linux, macos

## Member repositories
- Sapd/HeadsetControl (main) score 86

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:50.276023+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:12:56.687726+00:00, confidence not recorded.
  - readme: https://github.com/Sapd/HeadsetControl (fetched 2026-08-28T04:05:50.276023+00:00, sha 179ef2d340bc)
- Data as of 2026-08-30T08:39:29.467469+00:00.