BSD Ports

audio/headsetcontrol 4.1.0 FreeBSD

Tool to control certain aspects of USB-connected headsets

System
FreeBSD
Repository
FreeBSD ports
Maintainer
[email protected]
Last update
Commit
e137692ab6
License
GPLv3
Categories
audio
Package size
361.9 KiB, 2645.6 KiB installed

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.

Install

Binary package:

pkg install headsetcontrol

From the ports tree:

cd /usr/ports/audio/headsetcontrol/ && make install clean

To depend on this port in another port's Makefile:

RUN_DEPENDS=	headsetcontrol>0:audio/headsetcontrol

Packages

The version each package repository carries. “-” means the repository builds no package of it, “n/a” that there is no such repository.

Repositoryaarch64amd64armv6armv7i386
FreeBSD:14:latest4.1.04.1.02.6.13.1.04.1.0
FreeBSD:14:quarterly4.1.04.1.0n/a3.0.04.1.0
FreeBSD:15:latest4.1.04.1.0n/a3.0.03.1.0
FreeBSD:15:quarterly4.1.04.1.0n/an/an/a
FreeBSD:16:latest4.1.04.1.0n/an/an/a
FreeBSD:16:quarterlyn/an/an/an/an/a

Dependencies

As this port's Makefile names them.

Build 1

Library 1

The full lists below include those, and their dependencies in turn.

Build dependencies 17
Run dependencies 2

No port depends on this one.

Configuration

No options to configure.

USES
cmake
Service scripts
none

Message after installing

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.

Files

distinfo 1
FileSizeSHA256
Sapd-HeadsetControl-4.1.0_GH0.tar.gz4753904009882eb97406a58d7a0665d3a21903641fa9dca0e70d73b8b708786fd60386

Commit history 3

DateCommitCreditsLog message
e137692ab6 Alexander Vereeken audio/headsetcontrol: Update to 4.1.0
Changes: https://github.com/Sapd/HeadsetControl/releases/tag/4.1.0 PR: 298055 Reported by: Alexander Vereeken <[email protected]> (maintainer) Approved by: osa, vvd (Mentors, implicit)
8c904da715 Alexander Vereeken audio/headsetcontrol: Update to 4.0.0
Changes: https://github.com/Sapd/HeadsetControl/releases/tag/4.0.0 PR: 296996 Reported by: Alexander Vereeken <[email protected]> (maintainer)
ba4d25929c Alexander Vereeken */*: Update maintainer e-mail address
PR: 296700 MFH: 2026Q3 Approved by: Alexander Vereeken <[email protected]> (maintainer) Approved by: db@, yuri@ (Mentors, implicit)