Guia Instalacion ES

Guía de instalación — Español

Instalación recomendada (v1.4.0+)

1. Abre la última GitHub Release y descarga Audio-AutoSwitch.zip.
2. Extrae el ZIP completo a una carpeta normal; no ejecutes archivos desde dentro del ZIP.
3. Haz doble clic en Install.cmd.
4. Elige el auricular y la salida alternativa y completa la comprobación ON → OFF → ON.
5. Al terminar, apaga y enciende el auricular una vez para confirmar el cambio real de salida.

Install.cmd solo lanza el instalador PowerShell incluido; la lógica de instalación sigue estando en los .ps1 revisables. El paquete también incluye Verify.cmd y Uninstall.cmd.

Alternativa para usuarios de PowerShell

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

Ese bootstrap descarga la última release versionada y su checksum SHA-256, verifica el ZIP y ejecuta el mismo instalador.

Requisitos

• Windows 10/11 x64.
• PowerShell 5.1 o superior.
• Internet durante la instalación (descarga los assets del instalador desde GitHub).
• Para la familia Logitech PRO X / LogitechGHub: Logitech G HUB instalado, abierto y reconociendo el auricular.
• No hacen falta permisos de administrador para el funcionamiento normal. El cambio de Audio Enhancements sí muestra UAC.

Instalación en un clic

Abre PowerShell y ejecuta:

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

El bootstrap:

1. Consulta la última release estable de GitHub.
2. Descarga exactamente un ZIP y su .sha256.
3. Verifica SHA-256 antes de extraer/ejecutar.
4. Ejecuta el instalador completo.
5. Limpia los temporales incluso si algo falla.

Asistente de instalación

El instalador lista únicamente endpoints de salida reales (Type=Device, Direction=Render).

1. Elige HEADSET.
2. Elige FALLBACK (por ejemplo, altavoces).
3. Mantén el auricular encendido y sigue la prueba ON → OFF → ON.
4. Si Windows refleja Active ↔ Unplugged/ausente, se configura WindowsEndpoint.
5. Si Windows no refleja el apagado y confirmas que es de la familia Logitech PRO X, el instalador intenta LogitechGHub.
6. Si el auricular es un Arctis Nova 5/5X, se configura SteelSeriesNova5 (lectura por HID).
7. Se prueban de verdad ambos cambios de salida antes de terminar.
8. Opcionalmente puedes deshabilitar Audio Enhancements del headset.

Si no se puede demostrar un método de detección compatible, no instala una configuración dudosa.

Reconfigure... después de instalar

Desde el icono de bandeja puedes cambiar headset/fallback sin reinstalar.

El wizard vuelve a validar ON → OFF → ON. Bluetooth/Core Audio puede tardar varios segundos, por lo que las esperas son acotadas pero amplias.

Si Reconfigure no puede demostrar un modo compatible, deja la configuración anterior intacta.

Dónde se instala

%LOCALAPPDATA%\PROX2AutoSwitch\

Ahí encontrarás, entre otros:

• PROX2AutoSwitch.ps1
• config.json
• (native Core Audio backend; no third-party audio tool)
• autoswitch.log
• Toggle-AudioEnhancements.ps1
• lib\AutoSwitchCore.psm1

El inicio automático usa un acceso directo que lanza wscript.exe, para evitar una ventana de PowerShell visible.

Importante sobre Item ID

No copies config.json de otro PC. Los Item ID de audio pertenecen al Windows actual y pueden cambiar tras drivers, reinstalación o recreación de endpoints Bluetooth.

Siguiente paso: Verificar funcionamiento.