Home

Audio AutoSwitch — Wiki

Quick start / Inicio rápido (v1.2.4+)

Recommended / Recomendado: download Audio-AutoSwitch.zip from the latest GitHub Release, extract it to a normal folder, and double-click Install.cmd.

The same package also includes Verify.cmd for diagnostics and Uninstall.cmd for removal. The .cmd files are only small launchers; the actual logic remains in the PowerShell scripts included in the release.

PowerShell users can still use the one-command bootstrap:

powershell.exe -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/Ayerdi/PROX2-AutoSwitch/main/install.ps1 | iex"

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 (Active ↔ Unplugged/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 device 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

• Guía de instalación
• Verificar funcionamiento
• Preguntas frecuentes
• Seguridad
• Desinstalar

English

• Install guide
• Verify operation
• FAQ
• Security
• Uninstall

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/

Tray menu / Menú de la bandeja

Real example with a Logitech PRO X 2 configured. Device names vary by system. / Ejemplo real con un Logitech PRO X 2 configurado. Los nombres de los dispositivos varían según el equipo.