Velvet
Velvet es un servidor musical autocontenido para uso local, con inteligencia artificial para la selección de canciones, API Subsonic y soporte para Samsung TV.
Ficha actualizada 23 sept 2026, 5:59 · upstream 23 sept 2026, 5:53 · release v0.5.16
Qué es Velvet
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Velvet es un servidor de música autocontenido diseñado para usuarios que valoran su colección personal. Ofrece una experiencia de streaming completa sin necesidad de servicios en la nube ni suscripciones. El proyecto combina una interfaz visual atractiva con funcionalidades avanzadas como Auto-DJ inteligente, enriquecimiento de metadatos (géneros, artistas, álbumes) y soporte para múltiples plataformas de reproducción.
El sistema utiliza un enfoque basado en archivos donde cada pista se almacena individualmente en disco local. El servidor puede escanear carpetas virtuales (vpaths), detectar discos multi-cd, agrupar álbumes por series o categorías, y gestionar metadatos desde fuentes externas como Last.fm, MusicBrainz o Discogs.
La arquitectura está construida sobre Node.js con Next.js para la interfaz web, y soporta múltiples servicios de reproducción: Sonos, DLNA/UPnP, Subsonic API (Symfonium, DSub, Ultrasonic), Samsung TV Tizen app, Spotify, Apple Music y TuneIn. También incluye integración con Home Assistant.
La experiencia de usuario se centra en la biblioteca musical como centro de atención principal. Ofrece herramientas avanzadas como análisis de BPM, mezcla armónica, normalización de nivel de ruido (EBU R128), visualizador Milkdrop, y un sistema de reproducción inteligente que compara múltiples candidatos para seleccionar la siguiente canción.
La interfaz incluye exploradores de álbumes y artistas con búsqueda por nombre, filtros avanzados, ordenamiento personalizado y gestión de imágenes de portada. El panel de administración permite gestionar carpetas virtuales, permisos por usuario, configuración de servicios externos y herramientas de análisis como AcoustID y Tag Workshop.
La experiencia se completa con un sistema de escrutinio (scrobbling) integrado que registra la reproducción en plataformas como Last.fm y ListenBrainz. El servidor soporta transcodificación on-demand para mejorar la calidad de audio, incluyendo soporte para reproducción sin cortes (gapless) y sincronización de crossfade.
Velvet se diferencia por su enfoque en la experiencia local: no depende de servidores externos ni de servicios de pago. La selección de canciones es dinámica
- Reproducción musical personal sin depender de servicios externos
- Control de música en Samsung Smart TV mediante la aplicación Tizen
- Integración con Home Assistant para automatización de dispositivos compatibles
- Escaneo y organización automática de archivos musicales locales
- Selección inteligente de canciones basada en contexto musical (BPM, género, estilo)
- Reproducción sin cortes (gapless) y sincronización de crossfade entre pistas
- Auto-DJ que compara múltiples candidatos para seleccionar la siguiente canción, considerando BPM, clave, género y historial reciente
- Enriquecimiento de metadatos con fuentes externas como Last.fm, MusicBrainz y Discogs mediante herramientas administrativas
- Soporte completo para Samsung Smart TV (Tizen app) junto a Sonos, DLNA/UPnP y Subsonic API
- Normalización de nivel de ruido EBU R128 y reproducción sin cortes con sincronización de crossfade
- Visualizador Milkdrop en pantalla completa que reacciona al audio del sistema
- Gestión avanzada de carpetas virtuales (vpaths) con permisos por usuario, tipo de archivo y acceso controlado
- El rendimiento puede degradarse con grandes bibliotecas de música debido a la carga en disco y CPU
- La selección automática de canciones depende de la calidad de los datos disponibles (Last.fm, MusicBrainz, Discogs)
- La normalización de nivel de ruido EBU R128 no garantiza que el audio suene igual en todos los dispositivos
- El sistema de escrutinio (scrobbling) requiere credenciales y tokens para las plataformas integradas
- La interfaz web puede ser inintuitiva para usuarios con poca experiencia tecnológica
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.
Velvet se despliega principalmente mediante Docker. Se ejecuta como un contenedor en un servidor Linux, con el volumen de disco local configurado como `./save:/app/save` y la carpeta de música como `/music`. Para producción, se recomienda usar un contenedorizador como Docker Swarm o Kubernetes para escalar horizontalmente. El servicio debe estar protegido por un firewall y no ejecutarse en modo root. Se recomienda configurar el volumen del disco con permisos adecuados y mantener copias de seguridad periódicas. La aplicación está escrita en Node.js, lo que permite la ejecución asíncrona mediante `node --inspect` para depuración remota.
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.