telegram-slskd-local-bot
Bot que automatiza la descarga de música FLAC desde Soulseek (slskd) vía Telegram, resolviendo metadatos de Spotify y organizando la biblioteca local. Listo para Docker.
Ficha actualizada 26 sept 2026, 17:54 · upstream 26 sept 2026, 17:48 · release v0.12.0
Qué es telegram-slskd-local-bot
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este proyecto es un bot de Telegram diseñado para el descubrimiento y descarga automática de música en formato FLAC a través del protocolo Soulseek (slskd). El flujo de trabajo consiste en que el usuario envía un nombre de canción al bot, quien consulta la API de Spotify para obtener metadatos precisos como artista, título y duración. Posteriormente, busca archivos correspondientes en una instancia local o remota de slskd, puntuando los resultados según calidad de audio, coincidencia de duración y fiabilidad del origen.
Una vez seleccionada la mejor opción (manualmente o mediante modo automático), el bot descarga el archivo, lo renombra siguiendo un patrón estándar (`Artista - Título.flac`) y lo mueve a una carpeta de destino en la biblioteca de música local. Está preparado para integrarse con herramientas de transcodificación posteriores como audio-transcode-watcher o servidores de streaming como Navidrome.
El despliegue es sencillo mediante Docker Compose, aunque requiere configuración previa de credenciales para Telegram, Spotify y slskd. El código está escrito en Python y cuenta con una arquitectura modular que separa la resolución de metadatos, búsqueda, puntuación y procesamiento de archivos. Es ideal para usuarios que buscan mantener su biblioteca de música lossless sin depender de servicios de streaming comerciales.
- Descarga automática de canciones específicas desde Soulseek a través de Telegram.
- Importación de álbumes o listas de reproducción desde Spotify hacia una colección local FLAC.
- Organización automática de archivos de audio con metadatos correctos y renombrado consistente.
- Integración en pipelines de transcodificación para servidores multimedia como Jellyfin o Navidrome.
- Gestión de biblioteca personal sin depender de servicios de streaming comerciales.
- Arquitectura modular clara separando resolución, búsqueda, puntuación y procesamiento.
- Soporte nativo para Docker y Docker Compose con imágenes oficiales disponibles.
- Algoritmo de puntuación que prioriza coincidencia de duración y calidad de audio (16bit/44.1kHz).
- Modo automático por chat configurable sin intervención manual constante.
- Limpieza automática de descargas abandonadas y gestión de tiempos de espera.
- Requiere una instancia activa de slskd con API habilitada para funcionar.
- Dependencia de credenciales de Spotify Developer (requiere registro en la plataforma).
- No incluye transcodificación nativa, solo descarga archivos FLAC originales.
- El bot no responde a usuarios fuera de la lista permitida por defecto (fail-closed).
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.
Necesita un contenedor slskd separado o acceso a una instancia existente. Configurar variables de entorno para tokens de Telegram, credenciales de Spotify y URL del servidor Soulseek. Asegurar permisos de escritura en las carpetas de descarga y biblioteca local. Monitorizar logs para verificar coincidencias de metadatos antes de la descarga.
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.