melisma-server
Servidor personal de letras para la app Melisma. Fusiona fuentes (Apple, Spotify) en un documento único, gestiona tokens y caché local usando Node.js 24+ y SQLite sin dependencias externas.
Ficha actualizada 24 sept 2026, 0:18 · upstream 24 sept 2026, 0:04 · release sin release detectada
Qué es melisma-server
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Melisma Server es una herramienta open source diseñada para actuar como servidor de caché de letras musicales personal. Su función principal es consolidar información de múltiples fuentes (Apple Music, Spotify, Musixmatch, etc.) en un único documento coherente, gestionando tiempos y traducciones automáticamente.
El proyecto utiliza Node.js 24 con SQLite integrado, eliminando la necesidad de contenedores complejos o pasos de compilación. Incluye una interfaz de administración para gestionar tokens, probar fuentes y monitorizar logs, facilitando el mantenimiento sin intervención constante. Es ideal para usuarios que buscan precisión en las letras sincronizadas y quieren evitar exponer credenciales en aplicaciones móviles.
La arquitectura soporta despliegue nativo o mediante Docker con Kamal 2, permitiendo una integración sencilla en entornos auto-alojados. La API expone endpoints para consulta de letras y contribución de datos, optimizando las solicitudes desde la aplicación cliente al evitar llamadas redundantes a proveedores externos.
- Servidor de caché de letras para la app Melisma Android
- Consolidación de fuentes de letras (Apple, Spotify, etc.) en un formato único
- Gestión segura de tokens de API fuera del dispositivo móvil
- Almacenamiento local de respuestas para reducir latencia y llamadas a proveedores
- Interfaz de administración para pruebas de fuentes y rotación de claves
- Fusiona seis fuentes (Apple, Spotify, etc.) en un documento único con tiempos precisos
- Renovación automática del token de Spotify mediante Chromium headless
- Arquitectura sin dependencias externas usando Node.js 24 y SQLite nativo
- Interfaz web para gestión de tokens, logs y pruebas de fuentes en vivo
- Licencia AGPL-3.0 garantizando código abierto y transparencia
- No está diseñado para compartir públicamente; el uso compartido puede llevar a la terminación de cuentas de proveedores
- Requiere configuración manual de tokens para algunas fuentes (Apple, Spotify) que no son gratuitas
- Sin soporte nativo para Docker Compose, requiere scripts Make o configuración manual Kamal
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.
Requiere Node 24+. Ejecutar npm start localmente o usar make docker-build con Kamal 2. Configurar BL_API_KEY en entorno o admin. Backup obligatorio del volumen de datos (better-lyrics-data:/data) para no perder caché y credenciales. TLS recomendado fuera del servidor (ej. Cloudflare).
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.