Skip to content

Install Guide EN

Ayerdi edited this page Aug 7, 2026 · 10 revisions

🚀 Installation Guide

Switch your Windows audio output when you power your Logitech PRO X 2 Lightspeed on or off.


✅ Requirements

Requirement Detail
Windows 10/11 x64
Logitech G HUB Installed, open and recognizing the PRO X 2
Internet Only during install (downloads svcl.exe from NirSoft)
PowerShell 5.1 or newer

Note: no admin rights should be required.


⚡ 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. Install Logitech G HUB and confirm it detects the PRO X 2.
  2. Download the ZIP of the latest version from GitHub Releases.
  3. Extract the whole ZIP to a normal folder. Don't run from inside the ZIP.
  4. If Windows blocked the downloaded scripts:
Get-ChildItem . -Filter *.ps1 | Unblock-File
  1. Run:
powershell.exe -ExecutionPolicy Bypass -File ".\Instalar-PROX2-AutoSwitch.ps1"

🛠️ What the installer does

  1. Downloads SoundVolumeCommandLine from NirSoft and verifies its SHA-256 before running it.
  2. Connects to G HUB (ws://localhost:9010) and locates the PRO X 2.
  3. Asks you to select the headset and the alternative output as defaults.
  4. Captures the real Item IDs of your current Windows and actually tests both switches.
  5. Copies the runtime, creates an invisible autostart entry (wscript.exe) and starts 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.

Clone this wiki locally