korus
Servidor de streaming de música autoalojado con interfaz web moderna (SvelteKit) y bot de Discord para reproducción en voz, gestión de biblioteca local y recomendaciones impulsadas por IA.
Ficha actualizada 28 sept 2026, 12:48 · upstream 28 sept 2026, 12:13 · release sin release detectada
Qué es korus
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Korus es un servidor de streaming de música autoalojado diseñado para gestionar bibliotecas locales de audio con una interfaz web intuitiva y un bot de Discord integrado. El backend está construido en Go con el framework Echo, mientras que la interfaz frontend utiliza SvelteKit con Svelte 5 y Tailwind CSS. La aplicación permite escaneo automático de archivos de música, organización por artista/álbum/canción y reproducción directa o mediante transcodificación en tiempo real para formatos no soportados nativamente por el navegador.
La plataforma incluye características avanzadas como gestión de listas de reproducción, historial de escucha, estadísticas detalladas y una función "Wrapped" tipo resumen anual. La integración con IA a través de OpenRouter permite recomendaciones personalizadas de radio, un asistente de chat para control de reproducción y generación dinámica de resúmenes. Además, cuenta con soporte para Lyrics sincronizados, metadatos enriquecidos vía ISRC y MusicBrainz, y autenticación multiusuario con JWT.
El bot de Discord complementa la experiencia permitiendo a los usuarios reproducir música en canales de voz, gestionar colas compartidas y acceder a estadísticas personales mediante vinculación de cuentas. La arquitectura soporta despliegue completo offline o con servicios externos opcionales como ListenBrainz para scrobbling. El sistema incluye un backend robusto que maneja transcodificación con FFmpeg/FFprobe y una base de datos SQLite sin dependencias de CGO, facilitando la instalación en entornos Docker mediante imágenes oficiales.
- Servidor de música local para escuchar bibliotecas personales en navegadores web sin instalar clientes nativos
- Bot de Discord para grupos de amigos que desean compartir sesiones de escucha en voz y gestionar colas colaborativas
- Herramienta de análisis de hábitos de escucha con estadísticas, historial y resúmenes anuales generados por IA
- Servidor de radio personalizada basada en gustos musicales detectados automáticamente desde la biblioteca local
- Plataforma para gestión de listas de reproducción compartidas entre usuarios vinculados a cuentas Discord
- Arquitectura híbrida Go/Node.js que ofrece rendimiento backend eficiente y frontend moderno con Svelte 5
- Soporte nativo para transcodificación en tiempo real con FFmpeg, permitiendo reproducir formatos propietarios en navegadores estándar
- Integración de IA opcional vía OpenRouter para recomendaciones inteligentes, chat asistente y generación de resúmenes dinámicos
- Bot de Discord funcional con soporte DAVE para cifrado end-to-end en conexiones de voz y autenticación multiusuario segura
- Base de datos SQLite ligera sin dependencias CGO, ideal para despliegues autoalojados en entornos minimalistas como Alpine Linux
- Dependencia externa de OpenRouter API para habilitar funcionalidades de IA (Ask, Radio inteligente, Wrapped dinámico), requiriendo clave de API válida
- El bot de Discord requiere instalación manual de libdave y binarios específicos de glibc 2.38, incompatibles con contenedores Alpine estándar sin configuración adicional
- La transcodificación en tiempo real consume recursos significativos de CPU y depende estrictamente de la disponibilidad de FFmpeg/FFprobe en el PATH
- Las funcionalidades de metadatos enriquecidos (imágenes de artistas, separación multi-artista) dependen de servicios externos opcionales que pueden ser bloqueados por firewalls corporativos
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.
Requiere Go 1.24+ y Node.js/Bun para el frontend. Se recomienda usar Docker con la imagen oficial ghcr.io/aunali321/korus. Configurar variables de entorno JWT_SECRET, MEDIA_ROOT y FFMPEG_PATH es obligatorio. Para el bot, instalar libdave manualmente antes de construir. Desactivar servicios externos (Metadata, MusicBrainz) con METADATA_ENRICH_ENABLED=false permite funcionamiento 100% offline si se desea. Asegurar que FFmpeg esté en PATH o definir las variables FFMPEG_PATH y FFPROBE_PATH.
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.