Versión para Windows 10/11 de 64 bits basada en deej: conserva el Arduino,
el protocolo serie y config.yaml, y añade selección de salida y atajos globales.
- Cierra tu deej anterior para liberar el puerto COM.
- Copia tu
config.yamlactual a esta carpeta, junto aAudioDeejSwitch.exe. El archivo incluido es el ejemplo original; comprueba el puerto COM antes de usarlo. - Ejecuta
AudioDeejSwitch.exe. El mezclador queda en la bandeja del sistema. - Clic derecho en su icono → Configuración.
- Selecciona una salida, pulsa Capturar, pulsa la combinación que quieras
(por ejemplo
Ctrl+Alt+F8) y pulsa Añadir atajo. El atajo se guarda automáticamente. Para cambiar uno existente, selecciónalo en la lista, pulsa Capturar, pulsa la nueva combinación, pulsa Añadir atajo y elimina el anterior con Eliminar. También puedes asignar un atajo a Siguiente salida disponible (alternar). - Para alternar entre dos salidas con una sola tecla, pulsa Alternar, elige Salida A y Salida B, captura el atajo abajo y pulsa Añadir atajo.
- Usa Iniciar con Windows para activar o desactivar el arranque automático. Solo puede haber una instancia principal en ejecución.
Para abrir la configuración sin conectar con el Arduino, ejecuta Configurar.cmd
o AudioDeejSwitch.exe --settings. Este modo permite preparar la configuración,
pero los atajos necesitan la aplicación principal ejecutándose en la bandeja.
- Control de volúmenes original de deej: aplicaciones, grupos, master, mic, sonidos del sistema, aplicación en primer plano y aplicaciones sin asignar.
- Ventana nativa pequeña para seleccionar salida y configurar atajos globales.
- Atajos directos a un dispositivo o para alternar entre todas las salidas activas, ordenadas por nombre. No necesitan que la ventana tenga el foco ni siga abierta.
- Atajo A/B: alterna entre dos salidas concretas con una sola tecla.
- Instancia única: si se abre una segunda copia, se cierra sola para no duplicar atajos ni conexiones al Arduino.
- Botón Iniciar con Windows en la configuración, sin editar
shell:startup. - Comprobación de actualizaciones desde la bandeja. La comprobación automática al
iniciar es opcional y se activa con
check_updates.enabledenswitcher.yaml. - Cambio de salida predeterminada de consola y multimedia, sin avisos al cambiar correctamente. No modifica la salida de comunicaciones ni la entrada de micrófono.
- Salida automática al abrir la aplicación: selecciona una salida y pulsa Al iniciar; se aplicará cada vez que arranque AudioDeejSwitch, incluido el inicio con Windows. Si el dispositivo tarda en aparecer, reintenta durante unos 30 segundos y avisa si sigue sin estar disponible. Quitar inicio desactiva esta selección.
- Configuración con apariencia oscura e icono de deej con degradado rojo a negro en el ejecutable y la bandeja del sistema.
- Editor de
config.yamlintegrado: conserva el texto y los comentarios, valida antes de guardar y creaconfig.yaml.bakcon la versión anterior. - Selector de puerto COM detectado, con ayuda y botón para volver a escanear.
- Editor visual de
slider_mappingcon índices, destinos y lista de aplicaciones de audio en ejecución. - Detección de ediciones externas: si el archivo cambió después de abrir la ventana, se evita sobrescribirlo. En el editor de deej puedes recargarlo; para recargar los atajos, cierra y vuelve a abrir la ventana.
- Configuración de atajos en
switcher.yaml, recargada en aproximadamente un segundo sin reiniciar deej. Los cambios se guardan automáticamente al añadir o eliminar un atajo. Un YAML de atajos inválido conserva la configuración activa anterior. Los atajos ocupados o reservados se notifican y no se registran. Tienes una plantilla sin datos personales enswitcher.example.yaml.
Se admiten combinaciones de Ctrl, Alt, Shift o Win con cualquier tecla física del
teclado: letras, números, F1-F24, teclas OEM como Oem5, flechas, teclado numérico,
multimedia, etc. La captura guarda la tecla física, no el carácter: por ejemplo,
Shift+Oem1 puede escribir : según la distribución del teclado. F12 está
reservada por Windows. Los IDs de los dispositivos se guardan para distinguir
salidas con nombres iguales. Si un dispositivo está desconectado, su atajo muestra
un aviso; vuelve a funcionar cuando regresa con el mismo ID.
Las aplicaciones configuradas para una salida concreta pueden mantenerla al cambiar la predeterminada de Windows. Algunas necesitan reiniciar la reproducción. Esta versión cambia la salida de Windows; no asigna rutas de audio por aplicación.
Mantén el ejecutable, config.yaml y switcher.yaml en una carpeta con permisos
de escritura. Los archivos se buscan junto al ejecutable, incluido al arrancar
desde un acceso directo. Usa Iniciar con Windows en la configuración para
registrar o quitar el arranque automático.
La salida elegida con Al iniciar se guarda en switcher.yaml como
startup_output y se aplica cada vez que se abre la aplicación, también al
encender el equipo si el arranque automático está activo. No hace falta pulsar
ningún atajo; el cambio es silencioso si la salida está disponible.
package.ps1 compila el ejecutable, copia los archivos a dist y genera un
instalador con Inno Setup 6:
.\package.ps1 -Version 1.0.3El instalador se crea en dist\AudioDeejSwitch_Setup_1.0.3.exe.
Necesitas Go 1.22 o posterior. Desde esta carpeta, en PowerShell:
.\build.ps1
go test ./...
go vet ./...
.\package.ps1 -Version 1.0.3 # requiere Inno Setup 6El script verifica la integridad de las dependencias, genera el recurso de Windows
con el manifiesto necesario para la ventana y compila AudioDeejSwitch.exe sin
consola. Descarga la herramienta de recursos github.com/akavel/rsrc en su versión
fijada v0.10.2 y rechaza los antiguos backends de notificaciones basados en scripts.
Para regenerar también todo el código compilado, usa .\build.ps1 -Clean.
En Windows, los avisos usan directamente Shell_NotifyIcon sobre el mismo icono
de la bandeja: no generan scripts, no ejecutan PowerShell y no crean un icono
adicional. Solo si la bandeja aún no está disponible se usa un icono temporal,
que se retira tras 15 segundos sin mensajes nuevos. Windows puede ocultar los
avisos según sus ajustes de notificaciones.
Las pruebas nativas enumeran dispositivos, comprueban la disponibilidad de la interfaz de cambio de salida y verifican registro, recarga y liberación de atajos reales de Windows. No cambian la salida ni envían comandos al Arduino. Las pruebas de configuración comprueban validación, duplicados, respaldo y protección frente a ediciones externas. El cambio audible entre dispositivos y el funcionamiento de los potenciómetros requieren una comprobación con tu equipo.
Para comprobar también el envío de un aviso nativo de Windows:
$env:AUDIODEEJSWITCH_TEST_NOTIFICATIONS = '1'
go test ./pkg/deej -run '^TestWindowsNotifierLifecycle$' -count=1
Remove-Item Env:\AUDIODEEJSWITCH_TEST_NOTIFICATIONSLa prueba solicita un aviso y retira el icono al terminar; comprueba que Windows
acepta la solicitud, no que el aviso sea visible con los ajustes de tu escritorio.
La investigación de la detección de Defender y sus resultados están en
docs/defender-review.md.
Lee docs/CONTRIBUTING.md. Este proyecto es un fork
independiente: los cambios y las propuestas se gestionan en este repositorio,
no en el de deej original.
Parte del código y de la documentación se desarrolló con ayuda de herramientas de IA. El código generado se revisa, compila y prueba antes de publicarse; las decisiones de diseño y la publicación siguen siendo responsabilidad del mantenedor. El historial del repositorio conserva las contribuciones originales de deej.
Base: omriharel/deej, con su documentación y
licencia MIT conservada en LICENSE. Consulta la documentación original en el
repositorio de deej. Las funciones de
selección y atajos están inspiradas en
Audio Switcher; esta
implementación las añade en Go usando las APIs de Windows y no requiere instalar
Audio Switcher ni incorpora su código C#.
AudioDeejSwitch se distribuye bajo la licencia MIT.