HeadsetControl-MacOSTray

HeadsetControl-MacOSTray is a macOS background application that uses the headsetcontrol library to talk directly to supported headsets. It provides a convenient status bar menu to display headset battery, chatmix, and device information, and allows quick access to settings and refresh actions.

Preconditions

1. MacOS 14 or later
2. Homebrew to install headsetcontrol and the app

Installation

1. Install headsetcontrol via Homebrew. The app links against the installed library and headers:

   brew install sapd/headsetcontrol/headsetcontrol --HEAD

2. Install headsetcontrol-macostray via Homebrew

   brew install --cask chrislauinger77/cask/headsetcontrol-macostray

3. Restart the app after installing or updating headsetcontrol so macOS loads the current library.
4. You need to allow the execution of the app in macOS security settings.

Update

1. This app

   brew upgrade

2. headsetcontrol

   brew reinstall headsetcontrol

   headsetcontrol is used as a library to talk to supported headsets. It should be updated occasionally even when the app has no updates. The app will use the updated library after restart of the app. Additional headsets might be added as well as new features for existing ones.

Screenshots

Tray

Settings

Features

• Status bar integration for headset battery and chatmix
• Settings panel for configuration
• Refresh button to manually update headset status
• Automatic periodic updates
• Direct integration with libheadsetcontrol through the headsetcontrol C API
• Test mode for checking menu and battery states without a connected headset

Dynamic Capability Menu

• The tray menu dynamically displays controls based on the capabilities reported by your headset. If a capability is available, a corresponding submenu or action is shown:

• Sidetone: Choose from Off, Low, Mid, High, Max. Sets the sidetone level through the headsetcontrol library.

• Lights: Toggle headset lights on or off.

• Inactive Time: Choose the headset idle timeout from the configured options.

• Voice Prompts: Toggle headset voice prompts on or off.

• Rotate to Mute: Toggle rotate-to-mute on or off.

• Equalizer Preset: If available, shows preset names from the device; otherwise, shows the configured generic presets.

These menu items only appear if the headset reports the corresponding capability through libheadsetcontrol. Selecting an option immediately applies the setting through the library; V2.x no longer launches the headsetcontrol command line tool as a subprocess.

Support

If you like my work, please consider supporting me !

Build with Xcode

1. Clone this repository:

   git clone https://github.com/ChrisLauinger77/HeadsetControl-MacOSTray.git

2. Install headsetcontrol so Xcode can find headsetcontrol_c.h and libheadsetcontrol.
3. Open the project in Xcode and build.

Usage

• The app runs in the background and places an icon in the macOS status bar.
• Click the icon to view headset data.
• Access settings via the dialog to configure update interval, sidetone levels, inactive-time options, equalizer preset names, low-battery notifications, and test mode.
• Use the Refresh button in the settings panel to manually update headset status.

Troubleshooting

• No headset data appears: Ensure headsetcontrol is installed, restart the app, and check that your headset is supported by the installed headsetcontrol version.
• Build fails with headsetcontrol_c.h not found: Install headsetcontrol through Homebrew and make sure the headers are available in /opt/homebrew/include or /usr/local/include.

License

See LICENSE for details.

Credits

• Sapd for HeadsetControl