इस प्रोजेक्ट के बारे में

Music Bot आपके Navidrome लाइब्रेरी के लिए एक Telegram साथी है। यह आपको Tidal, Spotify, Apple Music, Deezer, YouTube Music, SoundCloud, Amazon Music, या Shazam जैसी सेवाओं से लिंक चिपकाने देता है और स्वतः ट्रैक या एल्बम की पहचान करता है, slskd के माध्यम से Soulseek P2P नेटवर्क पर एक लॉसलेस कॉपी खोजता है, इसे पूर्ण मेटाडेटा (कलाकार, एल्बम, ट्रैक नंबर, शैलियां, ReplayGain, कवर आर्ट, सिंक किए गए गीत) के साथ टैग करता है, और फाइलों को आपकी लाइब्रेरी में रखता है। एक मिनट बाद, संगीत Navidrome में चलाया जा सकता है। प्रमुख क्षमताओं में शामिल हैं: • FLAC में एल्बम/ट्रैक डाउनलोड करना, यदि कोई लॉसलेस पीयर उपलब्ध नहीं है तो एक वैकल्पिक mp3 फॉलबैक (≥320 kbps) के साथ। • चुनिंदा स्रोत चयन: प्रत्येक उम्मीदवार को Deezer डेटा के विरुद्ध अवधि से जांचा जाता है और विश्वास और पीयर विश्वसनीयता के लिए स्कोर किया जाता है। • समृद्ध टैगिंग: सूक्ष्म शैलियों के लिए Last.fm सामुदायिक टैग के साथ संयुक्त Deezer मेटाडेटा। • लाइब्रेरी प्रबंधन: `/retag` पूरे संग्रह में टैग को ताज़ा करता है, `/scan` Navidrome को पुनः स्कैन करता है, `/stats` आकार दिखाता है, और `/help` कमांड की सूची दिखाता है। • इनलाइन खोज: Deezer, आपकी Navidrome लाइब्रेरी, या `np` (वर्तमान ट्रैक भेजें), `s` (लिंक साझा करें), `l` (गीत), `del <name>` (एक एल्बम हटाएं) जैसे कमांड जारी करने के लिए खोजने के लिए `@yourbot <query>` टाइप करें। • स्थानीय अपलोड: समान टैगिंग और डेडुप्लिकेशन पाइपलाइन के लिए बॉट के अपलोड पेज या `./bot-data/uploads/` में एक zip या फोल्डर डालें। • गोपनीयता: केवल `ALLOWED_USERS` में सूचीबद्ध Telegram उपयोगकर्ता IDs ही संवाद कर सकते हैं। सेटअप एक दो-सेवा Docker Compose स्टैक (slskd और music-bot) है जिसमें `.env` में कॉन्फ़िगरेशन है। बॉट अपनी REST API के माध्यम से slskd के साथ संचार करता है, मेटाडेटा के लिए Deezer की निःशुल्क API का उपयोग करता है, और गुणवत्ता सीमाओं (`MAX_BIT_DEPTH`, `MAX_SAMPLE_RATE_HZ`, `MAX_FILE_BYTES`) का सम्मान करता है। वैकल्पिक प्रॉक्सी समर्थन और एक स्थानीय अपलोड HTTP पोर्ट उपलब्ध हैं। उपयोग सीधा है: डाउनलोड शुरू करने के लिए एक संगीत लिंक चिपकाएं, किसी मौजूदा आइटम को पुनः डाउनलोड करने के लिए `re` जोड़ें, या त्वरित खोज और प्लेबैक क्रियाओं के लिए इनलाइन मोड का उपयोग करें। बॉट Telegram में वास्तविक समय की स्थिति अपडेट प्रदान करता है, यह दिखाते हुए कि किस पीयर का चयन किया गया था, ट्रैक प्रगति, और अंतिम परिणाम। कुल मिलाकर, Music Bot Navidrome में नए संगीत को प्राप्त करने, टैग करने और एकीकृत करने की प्रक्रिया को स्वचालित करता है जबकि आपको सीधे Telegram से प्लेबैक नियंत्रण और गीत देता है।