Install Guide EN

🚀 Installation Guide

Automatically switch your Windows audio output when you connect or disconnect your wireless headset (works with any headset Windows can see, and with Logitech PRO X 2 via G HUB).

---

✅ Requirements

Requirement	Detail
Windows	10/11 x64
For universal mode	None — Windows just needs to see the headset endpoint (e.g. Jabra Evolve 65)
For Logitech PRO X 2	Logitech G HUB installed, open and recognizing the PRO X 2
Internet	Only during install (downloads svcl.exe from NirSoft — skipped if already installed)
PowerShell	5.1 or newer

Note: no admin rights should be required for normal operation. Only toggling Audio Enhancements asks for a one-time UAC elevation.

---

⚡ One-click install

Open PowerShell and paste:

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

It downloads the latest version, verifies its SHA-256 against the published checksum and runs the full installer automatically.

---

📦 Manual install

1. Download the ZIP of the latest version from GitHub Releases.
2. Extract the whole ZIP to a normal folder. Don't run from inside the ZIP.
3. If Windows blocked the downloaded scripts:

Get-ChildItem . -Filter *.ps1 | Unblock-File

4. Run:

powershell.exe -ExecutionPolicy Bypass -File ".\Instalar-PROX2-AutoSwitch.ps1"

---

🛠️ What the installer does

1. Downloads SoundVolumeCommandLine from NirSoft only if it is not already installed, and verifies its SHA-256 before running it.
2. Lists the Windows output devices and lets you pick the headset and the alternative output (fallback).
3. Checks whether Windows reflects the headset's physical state (it asks you to turn the headset OFF → ON):
   • if Windows shows Active → Unplugged → Active, it picks the universal (WindowsEndpoint) mode automatically;
   • if not, and the headset is a Logitech PRO X 2, it connects to G HUB (ws://localhost:9010), lists only PRO X 2 candidates and uses the battery payload;
   • if nothing works, it aborts instead of installing something that can't work.
4. Captures the real Item IDs of your current Windows and actually tests both switches.
5. Offers to disable the headset's Audio Enhancements (one UAC prompt).
6. Copies the runtime, creates an invisible autostart entry (wscript.exe) and starts AutoSwitch.

---

🖥️ Tray icon

Once running, an icon appears in the system tray:

• Headset / Fallback / Next switch — info lines showing the configured devices and which output AutoSwitch would switch to right now (refreshed every 5 s).
• AutoSwitch: Enabled / Disabled — pause or resume switching without quitting.
• Disable / Enable Audio Enhancements for — toggles the global Windows audio enhancements of the configured headset (a UAC prompt appears; the menu updates only if the change is verified).
• Reconfigure... — pick a new headset and fallback from the current Windows output devices without reinstalling.
• Exit — stop AutoSwitch.

---

⚠️ Important

• Windows audio Item IDs are not reused across installs. Don't copy config.json from another machine.
• The dev000000XX from G HUB isn't persisted either: the runtime keeps the extendedDisplayName and discovers the deviceId at startup.

---

📁 Where it installs

%LOCALAPPDATA%\PROX2AutoSwitch\

Autostart: %APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\PRO X 2 AutoSwitch.lnk

The shortcut runs wscript.exe → hidden PowerShell. No console stays visible at login.