v1.5.0 stable Windows 10/11 x64 MIT

Audio AutoSwitch

Automatically switch the Windows default audio output when a compatible wireless headset turns on or off — with a generic Windows endpoint mode, direct Logitech PRO X 2 Centurion HID with tray battery, G HUB fallback for other compatible Logitech headsets, and SteelSeries Arctis Nova 5/5X over HID.

Download latest release Installation guide

What it does

Headset on

Windows selects the configured headset automatically.

Headset off

Windows returns to the configured fallback output.

Tray controls + battery

Pause switching, reconfigure endpoints and control Audio Enhancements. PRO X 2 also shows live battery percentage and connection state.

Invisible startup

Runs per-user in the background without leaving a PowerShell window open.

See it in action

Audio AutoSwitch changing the Windows output when the headset turns on and off

Headset on selects the headset; headset off returns to the fallback.

Audio AutoSwitch tray menu

Real tray menu with a Logitech PRO X 2 configured.

Quick install

  1. Open the latest release.
  2. Download Audio-AutoSwitch.zip and extract it.
  3. Double-click Install.cmd.
  4. Select the headset and fallback output.
  5. Follow the real ON → OFF → ON validation cycle.

The release also includes Verify.cmd and Uninstall.cmd. Release ZIPs are published with SHA-256 checksums.

One-command bootstrap

The bootstrap fetches the latest versioned release and checksum, verifies SHA-256, then launches the same installer.

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

Detection providers

WindowsEndpoint

The general path. If Windows reports a useful endpoint transition such as Active ↔ Unplugged, no vendor software is required.

Active       → Connected
Unplugged    → Disconnected
Unknown      → no switch

Logitech PRO X 2 · Centurion HID

v1.5.0 reads the LIGHTSPEED receiver directly, restoring ON/OFF detection after G HUB changed its old battery route. The same direct reply supplies tray battery percentage.

valid battery → ON + %
known power signature → OFF
unknown → no switch

LogitechGHub

Other compatible Logitech headsets can still use G HUB's local WebSocket when Windows does not expose their physical state.

payload present → ON
payload absent  → OFF

Designed to fail safely

  • An unknown headset state never changes the output.
  • Two consecutive OFF observations are required before switching to the fallback.
  • Bluetooth endpoint recreation is handled by stable Device Name + Name identity before persisting a new Item ID.
  • The installer validates real switching in both directions.
  • The native Core Audio backend replaces the legacy third-party download; releases are SHA-256 verified.
  • Normal runtime is non-elevated; only the Audio Enhancements helper requests UAC.

Requirements

  • Windows 10/11 x64.
  • PowerShell 5.1 or newer.
  • Internet access during installation.
  • Logitech G HUB only for Logitech headsets that still use the G HUB provider; PRO X 2 direct state/battery is read from HID.

More documentation

Wiki

Installation, how it works, tray/reconfiguration, troubleshooting and FAQ.

Open English Wiki →

Spanish Wiki

The same user-facing documentation is maintained as a separate Spanish Wiki path.

Open Spanish Wiki →

Technical notes

Verified hardware behavior, G HUB findings, COM details and historical design constraints.

Open technical docs →

Security

Threat boundary, dependency verification and private vulnerability reporting guidance.

Read security policy →