منصوبے کے بارے میں

Music Bot آپ کی Navidrome لائبریری کے لیے ایک ٹیلیگرام معاون ہے۔ یہ آپ کو Tidal، Spotify، Apple Music، Deezer، YouTube Music، SoundCloud، Amazon Music یا Shazam جیسی سروسز سے لنک چسپاں کرنے دیتا ہے اور خود بخود ٹریک یا البم کی شناخت کرتا ہے، slskd کے ذریعے Soulseek P2P نیٹ ورک پر لاز لیس کاپی تلاش کرتا ہے، اسے مکمل میٹا ڈیٹا (آرٹسٹ، البم، ٹریک نمبر، انواع، ReplayGain، کور آرٹ، سنکرونائزڈ بول) کے ساتھ ٹیگ کرتا ہے، اور فائلوں کو آپ کی لائبریری میں رکھتا ہے۔ ایک منٹ بعد موسیقی Navidrome میں چلنے کے قابل ہوتی ہے۔ اہم صلاحیتوں میں شامل ہیں: • البمز/ٹریکس کو FLAC میں ڈاؤن لوڈ کرنا، اور اگر لاز لیس پیر دستیاب نہ ہو تو اختیاری mp3 فال بیک (≥320 kbps)۔ • منتخب سورس: ہر امیدوار کی مدت Deezer ڈیٹا سے چیک کی جاتی ہے اور اعتماد اور پیر کی بھروسے کے لیے اسکور کیا جاتا ہے۔ • بھرپور ٹیگنگ: Deezer میٹا ڈیٹا کو Last.fm کمیونٹی ٹیگز کے ساتھ ملا کر باریک انواع حاصل کی جاتی ہیں۔ • لائبریری مینجمنٹ: `/retag` پوری کلیکشن میں ٹیگز تازہ کرتا ہے، `/scan` Navidrome کو دوبارہ اسکین کرتا ہے، `/stats` سائز دکھاتا ہے، اور `/help` کمانڈز کی فہرست دیتا ہے۔ • ان لائن تلاش: `@yourbot <query>` ٹائپ کریں تاکہ Deezer، آپ کی Navidrome لائبریری تلاش ہو، یا کمانڈز جاری کریں جیسے `np` (موجودہ ٹریک بھیجیں)، `s` (لنک شیئر کریں)، `l` (بول)، `del <name>` (البم ہٹائیں)۔ • مقامی اپ لوڈ: بوٹ کے اپ لوڈ پیج یا `./bot-data/uploads/` میں زپ یا فولڈر ڈراپ کریں تاکہ وہی ٹیگنگ اور ڈیڈپلیکیشن پائپ لائن استعمال ہو۔ • پرائیویسی: صرف وہ ٹیلیگرام یوزر آئی ڈیز جو `ALLOWED_USERS` میں درج ہیں تعامل کر سکتے ہیں۔ سیٹ اپ ایک دو سروس Docker Compose اسٹیک (slskd اور music-bot) ہے جس کی کنفیگریشن `.env` میں ہوتی ہے۔ بوٹ slskd کے REST API کے ذریعے بات چیت کرتا ہے، میٹا ڈیٹا کے لیے Deezer کی مفت API استعمال کرتا ہے، اور کوالٹی کی حدود (`MAX_BIT_DEPTH`, `MAX_SAMPLE_RATE_HZ`, `MAX_FILE_BYTES`) کا احترام کرتا ہے۔ اختیاری پراکسی سپورٹ اور لوکل اپ لوڈ HTTP پورٹ دستیاب ہیں۔ استعمال آسان ہے: ڈاؤن لوڈ شروع کرنے کے لیے میوزک لنک چسپاں کریں، موجودہ آئٹم کو دوبارہ ڈاؤن لوڈ کرنے کے لیے `re` شامل کریں، یا فوری تلاش اور پلے بیک ایکشنز کے لیے ان لائن موڈ استعمال کریں۔ بوٹ ٹیلیگرام میں ریئل ٹائم اسٹیٹس اپڈیٹس فراہم کرتا ہے، جس میں دکھایا جاتا ہے کہ کون سا پیر منتخب ہوا، ٹریک کی پیشرفت، اور حتمی نتائج۔ مجموعی طور پر، Music Bot نئی موسیقی حاصل کرنے، ٹیگ کرنے اور Navidrome میں ضم کرنے کے عمل کو خودکار بناتا ہے جبکہ آپ کو ٹیلیگرام سے براہ راست پلے بیک کنٹرول اور بول فراہم کرتا ہے۔