Sobre o projeto

Music Bot é um companheiro do Telegram para sua biblioteca Navidrome. Ele permite colar um link de serviços como Tidal, Spotify, Apple Music, Deezer, YouTube Music, SoundCloud, Amazon Music ou Shazam, identifica automaticamente a faixa ou o álbum, encontra uma cópia sem perdas na rede P2P Soulseek via slskd, marca-a com metadados completos (artista, álbum, números de faixa, gêneros, ReplayGain, capa, letras sincronizadas) e coloca os arquivos na sua biblioteca. Um minuto depois, a música fica disponível para reprodução no Navidrome. Principais recursos incluem: • Baixar álbuns/faixas em FLAC, com fallback opcional para mp3 (≥320 kbps) se nenhum peer sem perdas estiver disponível. • Seleção criteriosa de fontes: cada candidato tem a duração verificada em relação aos dados do Deezer e é pontuado por confiança e confiabilidade do peer. • Marcação rica: metadados do Deezer combinados com tags da comunidade do Last.fm para gêneros refinados. • Gerenciamento da biblioteca: /retag atualiza as tags de toda a coleção, /scan reanalisa o Navidrome, /stats mostra o tamanho e /help lista os comandos. • Busca inline: digite @yourbot [consulta] para buscar no Deezer, na sua biblioteca Navidrome ou emitir comandos como np (enviar faixa atual), s (compartilhar link), l (letras), del [nome] (remover um álbum). • Uploads locais: coloque um zip ou pasta na página de upload do bot ou em ./bot-data/uploads/ para o mesmo pipeline de marcação e deduplicação. • Privacidade: apenas IDs de usuário do Telegram listados em ALLOWED_USERS podem interagir. A configuração é uma pilha Docker Compose de dois serviços (slskd e music-bot) com configuração em .env. O bot se comunica com o slskd por sua REST API, usa a API gratuita do Deezer para metadados e respeita limites de qualidade (MAX_BIT_DEPTH, MAX_SAMPLE_RATE_HZ, MAX_FILE_BYTES). Suporte opcional a proxy e uma porta HTTP de upload local estão disponíveis. O uso é direto: cole um link de música para iniciar um download, adicione re para baixar novamente um item existente ou use o modo inline para buscas rápidas e ações de reprodução. O bot fornece atualizações de status em tempo real no Telegram, mostrando qual peer foi selecionado, o progresso da faixa e os resultados finais. No geral, o Music Bot automatiza o processo de adquirir, marcar e integrar novas músicas ao Navidrome, ao mesmo tempo que oferece controles de reprodução e letras diretamente pelo Telegram.