Sobre el proyecto

telegram-slskd-local-bot es un bot de Telegram orientado a Docker para automatizar la adquisición de música y la organización de la biblioteca. Se sitúa junto a una instancia de slskd y utiliza Spotify para los metadatos de las publicaciones, incluidos artista, título, álbum y duración, y luego solicita a slskd que busque en Soulseek archivos FLAC coincidentes. Los resultados de búsqueda se clasifican según la coincidencia de duración, la profundidad de bits, la frecuencia de muestreo, las ranuras de carga disponibles, la velocidad y el nombre del archivo. El bot puede evitar versiones en vivo, remezclas o karaoke a menos que esos términos formen parte del título solicitado. Antes de guardar, envía la pista seleccionada al chat de Telegram para su revisión. Los archivos que superan el límite de 50 MB de Telegram se pueden enviar como una vista previa en Opus de la canción completa. El proyecto incluye la comprobación sin pérdida mediante la inspección del espectro FLAC y el etiquetado de posibles transcodificaciones de MP3 o archivos sin pérdida falsos. Las pistas guardadas se nombran con el formato "Artist - Title.flac", se etiquetan con la portada de Spotify y se colocan en un directorio de biblioteca musical configurado. Puede advertir cuando ya existen archivos similares. Los flujos de trabajo de chat compatibles incluyen importar listas de reproducción o álbumes de Spotify, revisar pistas individualmente, guardar automáticamente la mejor coincidencia, reintentar transferencias fallidas, probar el siguiente resultado, monitorear el progreso de la descarga y comprobar el estado de la importación. El acceso está restringido a los ID de usuario de Telegram incluidos en la lista de permitidos; si la lista de permitidos está vacía, el bot deniega el acceso a todos los usuarios. Las descargas abandonadas se pueden limpiar tras un intervalo configurable sin interrumpir las transferencias activas. El despliegue requiere una instancia de slskd en ejecución con una clave de API, credenciales de Spotify Developer, un token de bot de Telegram y directorios de descarga y música con permisos de escritura. El inicio rápido documentado utiliza Docker Compose, con el contenedor ejecutándose como UID 1000; la imagen proporcionada está destinada a amd64 en lugar de arm64. La documentación abarca la configuración, el uso, el comportamiento de puntuación, la solución de problemas y el desarrollo. El proyecto se publica bajo la licencia GPL-3.0-or-later.