عن المشروع

Music Bot هو مرافق تليجرام لمكتبة Navidrome الخاصة بك. يتيح لك لصق رابط من خدمات مثل Tidal وSpotify وApple Music وDeezer وYouTube Music وSoundCloud وAmazon Music أو Shazam، ثم يحدد المسار أو الألبوم تلقائياً، ويجد نسخة عالية الجودة على شبكة Soulseek P2P عبر slskd، ويعبئها ببيانات تعريفية كاملة (المخرج، الألبوم، أرقام الأغاني، الأنواع، ReplayGain، صورة الغلاف، كلمات متزامنة)، ويضع الملفات في مكتبتك. بعد دقيقة يصبح الصوت جاهزاً للتشغيل في Navidrome. الميزات الرئيسية: • تحميل الألبومات/المسارات بصيغة FLAC، مع خيار b تفضيلي بصيغة mp3 (≥320 kbps) إذا تعذر العثور على نظير يدعم الجودة العالية. • اختيار دقيق للمصدر: كل مرشح يتم التحقق من مدته مقابل بيانات Deezer ويتم تقييمه بناءً على الثقة وموثوقية النظير. • وضع علامات غني: دمج بيانات Deezer التعريفية مع tags مجتمع Last.fm للحصول على تصنيفات دقيقة. • إدارة المكتبة: `/retag` لتحديث البيانات التعريفية في المجموعة كاملة، `/scan` لإعادة فحص Navidrome، `/stats` لعرض الحجم، و`/help` لجدولة الأوامر. • البحث المضمن: اكتب `@yourbot <query>` للبحث في Deezer أو مكتبتك، أو استخدم أوامر مثل `np` (إرسال المسار الحالي)، `s` (مشاركة الرابط)، `l` (الكلمات)، `del <name>` (حذف ألبوم). • التحميل المحلي: ضع ملف zip أو مجلدًا في صفحة التحميل بالروبوت أو `./bot-data/uploads/` لتمرير نفس خوارزمية التصنيف وإزالة التكرار. • الخصوصية: فقط معرفات مستخدمي Tليجرام المدرجة في `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` لإعادة تنزيل عنصر موجود، أو استخدم الوضع المضمن للبحث السريع وإجراءات التشغيل. يوفر الروبوت تحديثات حالة فورية على Tليجرام، يعرض النظير المختار وتقدم المسار والنتائج النهائية.