Skip to content

Install Guide EN

Jump to bottom
Ayerdi edited this page Aug 25, 2026 · 10 revisions

Install guide — English

Recommended installation (v1.4.0+)

  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 (downloads the installer assets from GitHub).
  • For the Logitech PRO X family / 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 Logitech PRO X family device, it tries LogitechGHub.
  6. If the headset is an Arctis Nova 5/5X, it configures SteelSeriesNova5 (read over HID).
  7. It actually tests both output switches before finishing.
  8. 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.

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
  • (native Core Audio backend; no third-party audio tool)
  • 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.

Audio AutoSwitch

Español

English

Latest release · Project page

Clone this wiki locally