Sobre o projeto

telegram-slskd-local-bot é um bot do Telegram orientado para Docker para automatizar a aquisição de música e a organização da biblioteca. Fica ao lado de uma instância slskd e usa o Spotify para metadados de lançamento, incluindo artista, título, álbum e duração, e depois pede ao slskd para procurar no Soulseek ficheiros FLAC correspondentes. Os resultados da pesquisa são classificados usando correspondência de duração, profundidade de bits, taxa de amostragem, slots de upload disponíveis, velocidade e nome do ficheiro. O bot pode evitar versões ao vivo, remix ou karaoke, a menos que esses termos façam parte do título solicitado. Antes de guardar, envia a faixa selecionada para o chat do Telegram para revisão. Ficheiros maiores que o limite de 50 MB do Telegram podem ser enviados como uma pré-visualização Opus da música completa. O projeto inclui verificação sem perdas ao inspecionar o espetro FLAC e rotular possíveis transcodificações de MP3 ou ficheiros falsos sem perdas. As faixas guardadas são nomeadas no formato "Artist - Title.flac", etiquetadas com a capa do Spotify e colocadas num diretório de biblioteca de música configurado. Pode avisar quando já existem ficheiros semelhantes. Os fluxos de trabalho de chat suportados incluem importar playlists ou álbuns do Spotify, revisar faixas individualmente, guardar automaticamente a melhor correspondência, repetir transferências falhadas, tentar o resultado seguinte, monitorizar o progresso da transferência e verificar o estado da importação. O acesso é restrito a IDs de utilizador do Telegram na lista de permissões; se a lista de permissões estiver vazia, o bot nega todos os utilizadores. As transferências abandonadas podem ser limpas após um intervalo configurável sem interromper transferências ativas. A implementação requer uma instância slskd em execução com uma chave de API, credenciais de programador do Spotify, um token de bot do Telegram e diretórios de transferência e música com permissão de escrita. O início rápido documentado usa Docker Compose, com o contentor a ser executado como UID 1000; a imagem fornecida tem como alvo amd64 em vez de arm64. A documentação abrange configuração, utilização, comportamento de pontuação, resolução de problemas e desenvolvimento. O projeto é lançado sob GPL-3.0-or-later.