| Port details on branch 2026Q3 |
- headsetcontrol Tool to control certain aspects of USB-connected headsets
- 3.1.0 audio
=0 3.1.0Version of this port present on the latest quarterly branch. - Maintainer: avereeken@fastmail.de
 - Port Added: 2026-07-11 19:18:05
- Last Update: 2026-07-11 19:14:46
- Commit Hash: 6682793
- License: GPLv3
- WWW:
- https://github.com/Sapd/HeadsetControl
- Description:
- A tool to control certain aspects of USB-connected headsets.
Currently, support is provided for
- Adjusting sidetone
- Getting battery state
- Controlling LEDs
- Setting the inactive time.
See the link below for which headset supports which feature.
¦ ¦ ¦ ¦ 
- Manual pages:
- FreshPorts has no man page information for this port.
- pkg-plist: as obtained via:
make generate-plist - USE_RC_SUBR (Service Scripts)
- no SUBR information found for this port
- Dependency lines:
-
- headsetcontrol>0:audio/headsetcontrol
- To install the port:
- cd /usr/ports/audio/headsetcontrol/ && make install clean
- To add the package, run one of these commands:
- pkg install audio/headsetcontrol
- pkg install headsetcontrol
NOTE: If this package has multiple flavors (see below), then use one of them instead of the name specified above.- PKGNAME: headsetcontrol
- Flavors: there is no flavor information for this port.
- distinfo:
- TIMESTAMP = 1756041005
SHA256 (Sapd-HeadsetControl-3.1.0_GH0.tar.gz) = caba01afa69477f0a4fce1f8608a0c5e85e7032c350c1239bb4e1ecdfb171359
SIZE (Sapd-HeadsetControl-3.1.0_GH0.tar.gz) = 76475
No package information for this port in our database- Sometimes this happens. Not all ports have packages. Perhaps there is a build error. Check the fallout link:

- Dependencies
- NOTE: FreshPorts displays only information on required and default dependencies. Optional dependencies are not covered.
- Build dependencies:
-
- hidapi>=0 : comms/hidapi
- cmake : devel/cmake-core
- ninja : devel/ninja
- Library dependencies:
-
- libhidapi.so : comms/hidapi
- There are no ports dependent upon this port
Configuration Options:
- No options to configure
- Options name:
- audio_headsetcontrol
- USES:
- cmake
- pkg-message:
- For install:
- Type headsetcontrol -h to get all available options.
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 --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.
- Master Sites:
|