Monitor and control HeadsetControl-compatible gaming headsets from the Noctalia shell: battery in the bar, a sidetone toggle in the control center, and a full control panel for sidetone, equalizer presets, auto-off, noise filter, voice prompts and the volume limiter.

Requires headsetcontrol (install via your package manager, e.g. pacman -S headsetcontrol).

Install

mkdir -p ~/.local/share/noctalia/plugins
ln -s /path/to/this/repo/headsetcontrol ~/.local/share/noctalia/plugins/headsetcontrol
noctalia msg plugins enable loki/headsetcontrol

Usage

Bar widget: shows battery level. Scroll to adjust sidetone, click to open the control panel.
Control center tile: toggles sidetone on/off.
Control panel: full device controls. Controls appear only for capabilities the headset reports.

Settings

Setting	Default	Meaning
Poll interval	60 s	How often status is refreshed
Low battery threshold	20 %	Warn below this level
Default sidetone	64	Level used before any manual adjustment
Device (VID:PID)	(auto)	Force a device, e.g. `3329:4b19`
Mock device	off	Simulate a headset for development without hardware

Development

Edits to .luau files hot-reload. Trigger a manual refresh with:

noctalia msg plugin loki/headsetcontrol:headset all refresh

License

MIT