Skip to content

About

Control de salidas de audio y atajos globales para Windows, basado en deej.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

AudioDeejSwitch

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.

Inicio rápido

  1. Cierra tu deej anterior para liberar el puerto COM.
  2. Copia tu config.yaml actual a esta carpeta, junto a AudioDeejSwitch.exe. El archivo incluido es el ejemplo original; comprueba el puerto COM antes de usarlo.
  3. Ejecuta AudioDeejSwitch.exe. El mezclador queda en la bandeja del sistema.
  4. Clic derecho en su icono → Configuración.
  5. 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).
  6. 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.
  7. 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.

Qué incluye

  • 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.enabled en switcher.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.yaml integrado: conserva el texto y los comentarios, valida antes de guardar y crea config.yaml.bak con la versión anterior.
  • Selector de puerto COM detectado, con ayuda y botón para volver a escanear.
  • Editor visual de slider_mapping con í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 en switcher.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.

Archivos y arranque

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.

Instalador

package.ps1 compila el ejecutable, copia los archivos a dist y genera un instalador con Inno Setup 6:

.\package.ps1 -Version 1.0.3

El instalador se crea en dist\AudioDeejSwitch_Setup_1.0.3.exe.

Compilación y comprobaciones

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 6

El 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_NOTIFICATIONS

La 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.

Contribuir

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.

Desarrollo asistido por IA

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.

Créditos

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#.

Licencia

AudioDeejSwitch se distribuye bajo la licencia MIT.

About

Control de salidas de audio y atajos globales para Windows, basado en deej.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages