عن المشروع

music-dl هي أداة سطر أوامر للبحث عن الموسيقى وتنزيلها، مكتوبة بلغة PHP وتتطلب إصدار PHP 8.5 أو أحدث. المشروع مخصص لأغراض التعلم والتبادل، ويحظر ملف README صراحةً استخدامه لأغراض تجارية. تتوفر طريقتان للتثبيت: تنزيل الملف التنفيذي الجاهز music-dl مباشرةً (عبر curl ثم منح صلاحية التنفيذ)، أو تثبيت guanguans/music-dl عبر Composer بشكل عام أو محلي. الأمر الرئيسي هو music، ويُستخدم للبحث عن الموسيقى وتنزيلها. يمكن تمرير كلمات البحث المفتاحية كوسيط، ويدعم عدة خيارات: -b/--break لتحديد ما إذا كان التنزيل يتوقف بعده؛ -d/--directory لتحديد مجلد التنزيل؛ -D/--driver لتحديد محرك البحث (sync وfork وprocess)؛ -l/--locale لتحديد اللغة (الافتراضي zh_CN)؛ -N/--no-notify لإيقاف إشعارات سطح المكتب؛ -p/--page و-P/--per-page للتحكم في الترقيم (الافتراضي الصفحة الأولى و30 عنصرًا لكل صفحة)؛ -s/--sources لتحديد مصادر الموسيقى، ويدعم tencent وnetease وkugou مع إمكانية اختيار أكثر من مصدر؛ --isolated لتجنب تكرار تشغيل الأمر نفسه؛ --xdebug لإخراج معلومات التصحيح؛ --configuration لتمرير أزواج مفاتيح وقيم الإعدادات ديناميكيًا. بالإضافة إلى ذلك، تتوفر أوامر مساعدة مثل completion (لإنشاء سكربت إكمال shell) وinspire وself-update (التحديث الذاتي) وthanks، إلى جانب الخيارات العامة المعتادة مثل --help و--version و--ansi و--verbose. يتضمن المشروع سكربتات Composer مثل الاختبارات وphp-cs-fixer وecs، مع سير عمل CI وشارات تغطية الكود، ويستخدم ترخيص MIT.