Skip to content
github-actions[bot] edited this page Aug 12, 2026 · 11 revisions

Audio AutoSwitch — Wiki

Audio AutoSwitch automatically changes the Windows default audio output when a supported wireless headset connects or disconnects.

It supports two detection paths:

  • WindowsEndpoint — generic mode for headsets whose Windows render endpoint reflects the physical state (ActiveUnplugged/absent). Validated with a Jabra Evolve 65.
  • LogitechGHub — fallback for the Logitech PRO X 2 LIGHTSPEED, whose endpoint remains visible to Windows while the physical headset is off.

Current versions

  • Latest stable: v1.2.3
  • Current main: includes additional Unreleased hardening for Bluetooth endpoints that are recreated with a different Windows Item ID.

The stable v1.2.3 added bounded polling to Reconfigure..., detailed endpoint diagnostics and persistence of the latest observed Bluetooth endpoint ID. Current main further hardens the recreated-ID fallback by matching the real svcl identity columns Device Name + Name.

What you can do from the tray

  • See the configured headset and fallback output.
  • Pause/resume AutoSwitch.
  • Reconfigure... without reinstalling: choose another headset/fallback and re-detect WindowsEndpoint or LogitechGHub.
  • Enable/disable Windows Audio Enhancements for the configured headset (one-off UAC elevation).
  • Exit AutoSwitch.

Documentation

Español

English

Important model

Windows audio Item IDs are machine-local identifiers, not portable configuration. They can change after reinstalling Windows/drivers or when Windows recreates a Bluetooth endpoint. Do not copy config.json between PCs.

The G HUB deviceId is also volatile and is never persisted; the runtime resolves the current PRO X 2 by its display name.

Project page: https://ayerdi.github.io/PROX2-AutoSwitch/

Clone this wiki locally