عن المشروع

ytdl-sub أداة سطر أوامر تؤتمت تنزيل الوسائط عبر yt-dlp وتُهيّئ الملفات الناتجة لمشغلات الوسائط والخوادم الشائعة، بما في ذلك Kodi وJellyfin وPlex وEmby ومشغلات الموسيقى الحديثة. وفقًا لملف README، لا حاجة إلى إضافات إضافية أو أدوات استخراج خارجية. كيفية العمل: تُعرَّف الاشتراكات في ملفات YAML. يستورد كل اشتراك إعدادات مسبقة تصف كيفية التعامل مع ملفات الوسائط وإخراجها. يأتي المشروع بالعديد من الإعدادات المسبقة الجاهزة حتى يتمكن المستخدمون من بدء التنزيل دون بناء إعداد من الصفر. أمر واحد، `ytdl-sub sub subscriptions.yaml`، يعالج الملف. تشمل حالات الاستخدام النموذجية الموضحة في README التعامل مع قنوات YouTube كبرامج تلفزيونية، وتنظيم مقاطع الفيديو الموسيقية والحفلات، والتعامل مع قوائم SoundCloud أو Bandcamp. يشير README إلى أن التعامل مع SoundCloud يكتب وسوم الموسيقى عبر واجهة beets API. يُرتَّب الإخراج في أدلة مثل tv_shows وmusic وmusic_videos، مع صور مصغرة مُولَّدة وملفات بيانات وصفية .nfo وملصقات وصور فنية مناسبة لخوادم الوسائط. الإعداد مرن: يمكن تعيين تجاوزات عامة ضمن قسم `__preset__`، ويمكن تمرير الخيارات مباشرة إلى واجهة yt-dlp بلغة Python، مثل ملف تعريف الارتباط. يمكن للإعدادات المسبقة تعيين وسوم النوع وتصنيفات المحتوى، واستخدام إعداد "Only Recent" المسبق لتحديد التنزيلات حسب النطاق الزمني وعدد الملفات. الإعدادات المخصصة مدعومة، مع دليل إرشادي وإعدادات نموذجية مرتبطة من README. تشمل خيارات التثبيت المذكورة Docker Compose (واجهة رسومية، بلا واجهة، تمرير CPU/GPU)، وDocker CLI، وWindows، وUnraid، وLinux، وLinux ARM، وPIP، والتثبيت المحلي، وبناء Docker المحلي. تُوصف صورة Docker ذات الواجهة الرسومية بأنها تجمع بين صورة code-server من LinuxServer.io مع ytdl-sub مثبّتة مسبقًا، ويوصي بها README. دعم المجتمع متاح عبر قناة Discord، وGitHub Issues لطلبات الميزات والإبلاغ عن الأخطاء، وأسئلة شائعة في الوثائق. يربط README أيضًا بـ readthedocs للحصول على معلومات مفصلة حول جميع حقول الإعداد.