Bose-SoundTouch-Hybrid
Servicio open source que reemplaza el Bose Cloud desactivado con una nube privada local, manteniendo la funcionalidad completa de altavoces SoundTouch mediante app web y control DLNA/AirPlay.
Ficha actualizada 26 sept 2026, 20:25 · upstream 26 sept 2026, 20:10 · release v4.5
Qué es Bose-SoundTouch-Hybrid
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Bose-SoundTouch-Hybrid es un servicio de software open source diseñado para actuar como sustituto del servidor Bose Cloud desactivado, permitiendo el control total de los altavoces SoundTouch desde una red local. La solución integra una aplicación web responsiva que gestiona la autenticación, la configuración inicial y el mantenimiento de los dispositivos, eliminando la dependencia de servidores externos de Bose.
El proyecto se basa en una arquitectura híbrida que combina un backend en Node.js con una interfaz frontend moderna. Su función principal es interceptar y gestionar las complejas secuencias de conexión (handshakes) necesarias para mantener los altavoces autenticados y funcionales. Esto permite el uso completo del control remoto físico, incluyendo la reproducción de música local almacenada en un NAS o PC, así como servicios de streaming populares a través de integraciones con Music Assistant.
Ofrece capacidades avanzadas de automatización y gestión de presets físicos, permitiendo hasta 12 configuraciones por altavoz mediante doble pulsación. Incluye herramientas para la detección automática de dispositivos en la red, agrupación multihabitación nativa sin latencia y recuperación automática de presets si se pierden debido a fallos de firmware. Además, soporta integración directa con Home Assistant como add-on nativo.
- Reemplazar el servicio Bose Cloud oficial para mantener los altavoces SoundTouch funcionales en una red local sin depender de servidores externos.
- Gestionar reproducción multihabitación y grupos de altavoces utilizando la sincronización hardware nativa de Bose para minimizar la latencia.
- Acceder a música local almacenada en un NAS, Plex o Jellyfin, así como servicios de streaming como Spotify o Apple Music vía Music Assistant.
- Automatizar el encendido y apagado de altavoces mediante programadores de tiempo o temporizadores de apagado tras la reproducción.
- Asignar listas de reproducción específicas a los botones físicos de los altavoces, incluyendo podcasts y libros de audio.
- Utilizar la aplicación como un controlador centralizado para configurar nuevos altavoces, realizar reinicios de fábrica o provisionamiento WiFi.
- Control 100% local: La autenticación y gestión de credenciales se realizan en la red privada, sin dependencia del servicio Bose Cloud.
- Detección automática de dispositivos: Escanea la red para encontrar todos los altavoces SoundTouch al inicio, eliminando la necesidad de entrada manual de IPs.
- Integración con Music Assistant: Soporta una amplia gama de fuentes de música y servicios de streaming a través de una búsqueda unificada.
- Compatibilidad nativa con Home Assistant: Disponible como add-on Supervisor para usuarios del ecosistema de automatización doméstico.
- Gestión avanzada de presets físicos: Permite hasta 12 configuraciones por altavoz mediante doble pulsación de los botones físicos.
- Recuperación automática de presets: Detecta y re-inyecta automáticamente la configuración si los presets se pierden tras un fallo de WiFi o reinicio.
- Requiere un servidor local (NAS, PC) o integración con Home Assistant para funcionar como servicio en la nube privada.
- La configuración inicial requiere editar el archivo `.env` con credenciales de Music Assistant y otras variables específicas del entorno.
- Depende de Music Assistant para la gestión del catálogo musical; sin esta integración, las funcionalidades de streaming se ven limitadas.
- Al actualizar a versiones recientes (v4.x), los ajustes previos pueden reinitializarse, requiriendo una reconfiguración manual de preferencias.
- La interfaz web requiere un navegador moderno y no soporta control directo desde dispositivos móviles sin conexión a la red local.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para desplegar, descargue la imagen precompilada del registro de contenedores GitHub o clone el repositorio. Utilice Docker en un NAS/PC o instálelo como add-on nativo en Home Assistant Supervisor. Es obligatorio descargar el archivo `bose-soundtouch-hybrid.yml` actualizado y configurar las variables de entorno en `.env`, incluyendo la URL de Music Assistant y credenciales. Verifique que el puerto 8080 esté libre y que la red local permita conexiones WebSocket para el control de altavoces.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.