À propos du projet

Music Bot est un compagnon Telegram pour votre bibliothèque Navidrome. Il vous permet de coller un lien depuis des services comme Tidal, Spotify, Apple Music, Deezer, YouTube Music, SoundCloud, Amazon Music ou Shazam et identifie automatiquement le morceau ou l'album, trouve une copie sans perte sur le réseau P2P Soulseek via slskd, l'étiquette avec des métadonnées complètes (artiste, album, numéros de piste, genres, ReplayGain, pochette, paroles synchronisées) et place les fichiers dans votre bibliothèque. Une minute plus tard, la musique est lisible dans Navidrome. Les capacités clés incluent : • Téléchargement d'albums/morceaux en FLAC, avec un repli mp3 optionnel (≥320 kbps) si aucun pair sans perte n'est disponible. • Sélection exigeante des sources : chaque candidat est vérifié en durée par rapport aux données Deezer et noté pour sa confiance et la fiabilité du pair. • Étiquetage riche : métadonnées Deezer combinées aux tags communautaires Last.fm pour des genres nuancés. • Gestion de bibliothèque : `/retag` actualise les tags sur toute la collection, `/scan` relance le scan de Navidrome, `/stats` affiche la taille, et `/help` liste les commandes. • Recherche inline : tapez `@yourbot` suivi de votre requête pour chercher dans Deezer, votre bibliothèque Navidrome, ou émettre des commandes comme `np` (envoyer la piste actuelle), `s` (partager le lien), `l` (paroles), `del` (supprimer un album). • Téléversements locaux : déposez un zip ou un dossier dans la page d'upload du bot ou `./bot-data/uploads/` pour le même pipeline d'étiquetage et de déduplication. • Confidentialité : seuls les identifiants d'utilisateur Telegram listés dans `ALLOWED_USERS` peuvent interagir. L'installation est une pile Docker Compose à deux services (slskd et music-bot) avec la configuration dans `.env`. Le bot communique avec slskd via son API REST, utilise l'API gratuite de Deezer pour les métadonnées et respecte les plafonds de qualité (`MAX_BIT_DEPTH`, `MAX_SAMPLE_RATE_HZ`, `MAX_FILE_BYTES`). Une prise en charge optionnelle de proxy et un port HTTP pour les téléversements locaux sont disponibles. L'utilisation est simple : collez un lien musical pour lancer un téléchargement, ajoutez `re` pour retélécharger un élément existant, ou utilisez le mode inline pour des recherches rapides et des actions de lecture. Le bot fournit des mises à jour de statut en temps réel dans Telegram, montrant quel pair a été sélectionné, la progression des pistes et les résultats finaux. Globalement, Music Bot automatise le processus d'acquisition, d'étiquetage et d'intégration de nouvelle musique dans Navidrome tout en vous donnant des contrôles de lecture et les paroles directement depuis Telegram.