Install Guide EN

Install guide — English

Recommended installation (v1.2.4+)

1. Open the latest GitHub Release and download Audio-AutoSwitch.zip.
2. Extract the complete ZIP to a normal folder; do not run files from inside the ZIP.
3. Double-click Install.cmd.
4. Pick the headset and fallback output, then complete the ON → OFF → ON check.
5. When setup finishes, power the headset off and on once to confirm the real output switch.

Install.cmd only launches the included PowerShell installer; the installation logic remains in the reviewable .ps1 files. The package also includes Verify.cmd and Uninstall.cmd.

PowerShell alternative

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

That bootstrap downloads the latest versioned release and its SHA-256 checksum, verifies the ZIP, and runs the same installer.

Requirements

• Windows 10/11 x64.
• PowerShell 5.1 or newer.
• Internet during installation so NirSoft SoundVolumeCommandLine can be downloaded if not already installed.
• For PRO X 2 / LogitechGHub: Logitech G HUB installed, open and recognizing the headset.
• Normal runtime does not require administrator rights. The Audio Enhancements toggle uses one-off UAC elevation.

One-click install

Open PowerShell and run:

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

The bootstrap:

1. Resolves the latest stable GitHub release.
2. Downloads exactly one release ZIP and its .sha256 asset.
3. Verifies SHA-256 before extraction/execution.
4. Runs the full installer.
5. Cleans temporary files even on failure.

Setup wizard

The installer lists real render endpoints only (Type=Device, Direction=Render).

1. Pick the HEADSET.
2. Pick the FALLBACK output (for example speakers).
3. Keep the headset on and follow the ON → OFF → ON test.
4. If Windows reflects Active ↔ Unplugged/absent, it configures WindowsEndpoint.
5. If Windows cannot see the physical power-off and you confirm a PRO X 2, it tries LogitechGHub.
6. It actually tests both output switches before finishing.
7. You can optionally disable Audio Enhancements for the headset.

If no compatible detection method can be proven, the installer does not create a questionable setup.

Reconfigure... after installation

Use the tray icon to change headset/fallback without reinstalling.

The wizard validates ON → OFF → ON again. Bluetooth/Core Audio can take several seconds, so waits are bounded but intentionally generous. Stable v1.2.3 added polling and detailed endpoint diagnostics; current main additionally hardens recreated Bluetooth endpoints by resolving the real Device Name + Name columns and persisting the newest Item ID.

If Reconfigure cannot prove a compatible detection mode, the previous configuration is left untouched.

Install location

%LOCALAPPDATA%\PROX2AutoSwitch\

Important files include:

• PROX2AutoSwitch.ps1
• config.json
• svcl.exe
• autoswitch.log
• Toggle-AudioEnhancements.ps1
• lib\AutoSwitchCore.psm1

Autostart uses a shortcut that launches wscript.exe so no PowerShell console remains visible.

Item ID warning

Do not copy config.json from another PC. Windows audio Item IDs belong to the current machine and can change after drivers, reinstallations or Bluetooth endpoint recreation.

Next: Verify operation.