NaviMusic
NaviMusic es un reproductor web de música autocontenido para Navidrome y OpenSubsonic, construido con React + Vite en TypeScript sin backend ni dependencias externas.
Ficha actualizada 22 sept 2026, 20:52 · upstream 22 sept 2026, 20:40 · release v1.5.0
Qué es NaviMusic
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
NaviMusic es una aplicación web de reproducción musical que funciona como cliente independiente. No aloja, indexa, transcódica o distribuye música; simplemente conecta a un servidor Subsonic compatible (Navidrome incluido) y muestra la interfaz de usuario. El diseño se enfoca en sentirse como una app nativa en lugar de una página web tradicional.
La arquitectura es minimalista: el contenedor Docker no contiene ningún backend, solo un servidor estático que sirve los archivos del proyecto. Cada llamada a la API del servidor se realiza directamente desde el navegador, sin intermediarios ni dependencias de terceros.
Se construye con React 18 y Vite en TypeScript, utilizando Zustand para el estado, TanStack Query para gestión de datos, Howler.js para reproducción de audio y CSS Modules para estilos. No utiliza frameworks UI como Tailwind o componentes de librerías externas.
- Reproducir música personal desde un servidor Navidrome local en una red doméstica
- Organizar y reproducir música sin necesidad de instalar aplicaciones dedicadas
- Integración con dispositivos móviles mediante el Media Session API para control por voz o pantalla
- Acceso a archivos de música almacenados en NAS como Synology o QNAP
- Reproducción de música en entornos de trabajo con restricciones de red y seguridad
- No requiere instalación ni configuración de servidor adicional: solo se necesita un servidor Subsonic compatible
- Diseño completamente responsivo que funciona tanto en escritorio como en móviles, incluso sin conexión a internet
- Reproducción de audio con calidad máxima (lossless) y soporte para archivos MP3, FLAC, OGG, WAV y más
- Interfaz moderna inspirada en aplicaciones nativas con animaciones fluidas y materiales semitransparentes
- Soporte completo para reproducción en pantalla completa, control por teclado y integración con el sistema operativo
- No incluye transcodificación ni procesamiento de audio: solo reproduce archivos que ya estén descargados o disponibles en el servidor
- El diseño se centra en la interfaz visual; no incluye funcionalidades como listas de reproducción personalizadas, playlists avanzadas o gestión de biblioteca completa
- La sincronización con el servidor depende del estado local del navegador y puede desincronizarse si el usuario cierra sesión sin guardar
- No tiene soporte para reproducción en dispositivos móviles (Android/iOS) ni integración con sistemas operativos como Windows o macOS
- El diseño no es completamente accesible: carece de lectores de pantalla nativos, navegación por teclado completa y soporte para alto contraste
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 NaviMusic, se recomienda usar Docker. El contenedor se ejecuta en modo detached (sin terminal) con `./run.sh start`, lo que permite iniciar el servidor desde la consola del host sin bloquear la interfaz de usuario. El contenedor se ejecuta en un puerto 4580 y debe ser accesible a través de una red interna. Se recomienda colocar NaviMusic detrás de un proxy web (como Nginx o Caddy) que maneje el TLS, HSTS, compresión HTTP/2 y headers de seguridad como CSP. Para producción, se puede desplegar el contenedor en un servidor dedicado con recursos adecuados. Es importante configurar una política CORS en el servidor Subsonic para permitir la comunicación con NaviMusic desde su origen. Además, se debe implementar autenticación segura (token JWT) y proteger las rutas de API. Se recomienda usar Docker Compose para gestionar múltiples contenedores o un solo contenedor con todas las
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.