yt-dlp: نسخة حديثة من برنامج youtube-dl لتحميل الفيديوهات

في 23 أكتوبر 2020، رفعت رابطة صناعة التسجيلات الأمريكية دعوى إزالة بموجب قانون الألفية الرقمية لحقوق المؤلف (DMCA) ضد مشروع youtube-dl على منصة GitHub. بعد ثلاثة أيام، في 26 أكتوبر، ظهر مستودع جديد بهدوء على الرابط github.com/yt-dlp/yt-dlp. وبحلول الوقت الذي أعادت فيه GitHub المشروع الأصلي في 16 نوفمبر - إلى جانب صندوق جديد للدفاع عن المطورين بقيمة مليون دولار - كان المشروع الجديد قد بدأ بالفعل في استيعاب مساهمي youtube-dl.

أصبح هذا الفرع هو الفرع الرئيسي الآن. اعتبارًا من مايو 2026، سجل yt-dlp أكثر من 12 مليون عملية تنزيل شهريًا على PyPI. ويحظى مستودعه على GitHub بـ 160,766 نجمة. يُصدر المشروع إصدارًا جديدًا كل أسبوعين تقريبًا. أحدث إصدار، وقت كتابة هذا التقرير، هو `2026.03.17`. يدعم yt-dlp أكثر من 1800 موقع فيديو وصوت من خلال نظام إضافات الاستخراج الخاص به. فيما يلي شرحٌ مُفصّل لماهية yt-dlp وكيفية استخدامه، بالإضافة إلى وضعه القانوني في عام 2026، ولماذا قد يتوقف تثبيتٌ يعمل بكفاءة تامة عن العمل فجأةً في منتصف عام 2025.

من أين جاء yt-dlp: سلسلة التفرع من youtube-dl

يُعدّ التسلسل الزمني للمشاريع ذا أهمية بالغة هنا لأنه يُفسّر التباين في الأداء. فمشروع yt-dlp يُصدر تحديثات لإصلاح المشاكل في غضون ساعات من انقطاع خدمة يوتيوب، بينما قد يستغرق مشروع youtube-dl أسابيع. ثلاثة مشاريع تندرج ضمن هذا التسلسل، وكل خطوة فيه كانت مدفوعة بالإحباط من الخطوة السابقة.

كان youtube-dl هو البرنامج الأصلي. كتبه ريكاردو غارسيا في أغسطس 2006، وتولى فيليب هاغمايستر لاحقًا قيادته مع فريق متماسك تحت اسم `ytdl-org/youtube-dl`. وبحلول عام 2020، أصبح الأداة الرئيسية للأرشفة، لكن طلبات السحب كانت تتراكم، وتأخرت تحديثات يوتيوب في الوصول.

هذا النقص هو ما أدى إلى ظهور youtube-dlc، حيث يرمز الحرف "c" إلى "المجتمع". قام المستخدم `blackjack4494` بنسخ المستودع في عام 2020، وتمت معالجة طلبات الدمج في غضون أيام. ثم أصبح الفرع نفسه شبه غير نشط في أواخر العام نفسه - فوجود مطور واحد فقط لا يكفي.

yt-dlp هو نسخة مُعدّلة من youtube-dlc. أُنشئ المستودع في 26 أكتوبر 2020، بعد ثلاثة أيام من قيام رابطة صناعة التسجيلات الأمريكية (RIAA) بإزالة youtube-dl الأصلي. yt-dlp أداة سطر أوامر تُمكّنك من تنزيل مقاطع الفيديو والصوت من المواقع الإلكترونية المدعومة. يشير الحرف "p" إلى أحد المُشرفين الأوائل (`pukkandan`). يُدار المشروع الآن من قِبل فريق مُتعدد المُشرفين يضم `coletdjnz` و`dirkf` و`Grub4K` و`bashonly` و`seproDev`. بحلول يناير 2021، استوعب yt-dlp قاعدة مُساهمي youtube-dlc، ليُصبح النسخة المُهيمنة من youtube-dl. انصبّ التركيز على الميزات والتحسينات التي لم يدمجها المصدر الأصلي.

بعض الحقائق المتعلقة بالمشروع جديرة بالذكر. يستخدم yt-dlp نظام ترقيم الإصدارات حسب التقويم، لذا فإن وسمًا مثل `2026.03.17` هو تاريخ الإصدار الفعلي. الترخيص هو "The Unlicense"، وهو ترخيص صريح للملكية العامة لا تستخدمه حتى معظم مشاريع البرمجيات الحرة والمفتوحة المصدر. يحتوي المستودع على 13,348 نسخة متفرعة و2,507 مشكلة مفتوحة. استبدلت أوبونتو 22.04 برنامج youtube-dl بـ yt-dlp كبرنامج تنزيل الفيديو الافتراضي، وتبعتها دبيان في برنامج bookworm. تضم قائمة المواقع المدعومة في `supportedsites.md` حاليًا أكثر من 1,500 موقع مُسمى؛ ويحتوي الكود البرمجي نفسه على ما يقارب 1,800 وحدة استخراج مع التحميل الكسول. تُضمّن كل من Arch وFedora وNixOS وHomebrew وChocolatey وScoop وWinget هذا البرنامج في حزمها. إن إصدار ما بين 20 إلى 30 نسخة سنويًا هو ما منع التوزيعات من العودة إلى المصدر الأصلي الأبطأ.

كيف جعل قرار رابطة صناعة التسجيلات الأمريكية (RIAA) بحظر ملفات yt-dlp أمرًا لا مفر منه في عام 2020

قدمت رابطة صناعة التسجيلات الأمريكية (RIAA) إشعارًا بموجب قانون الألفية الرقمية لحقوق المؤلف (DMCA) بتاريخ 23 أكتوبر 2020، استنادًا إلى المادة 1201 من الباب 17 من قانون الولايات المتحدة، وهي المادة المتعلقة بمنع التحايل على القوانين. وكانت حجتها أن برنامج youtube-dl قد تجاوز آلية التوقيع الرقمي "المشفرة المتداولة" الخاصة بيوتيوب، والتي وصفتها الرابطة بأنها إجراء تقني لحماية الوصول إلى الأعمال المحمية بحقوق الطبع والنشر. وقد امتثلت منصة GitHub في البداية وأزالت المستودع مع سبعة عشر نسخة متفرعة منه.

ما تلا ذلك كان أشبه بتأثير سترايساند الشهير. أعاد المطورون نشر شفرة المصدر بطرق مبتكرة بشكل متزايد، بما في ذلك صورة على تويتر استخدمت ألوان بكسلاتها لتشفير قاعدة الشفرة بأكملها. أرسلت مؤسسة الحدود الإلكترونية رسالة إلى غيت هاب في 16 نوفمبر 2020. وكان موقفها التقني بسيطًا: التوقيع الذي يمكن لأي متصفح متوافق مع المعايير تشغيله لا يُعد "إجراءً تقنيًا يتحكم فعليًا في الوصول" وفقًا للمادة 1201. يستخدم برنامج youtube-dl هذا التوقيع، ولا يُعطّله.

أعادت منصة GitHub تفعيل المستودع في اليوم نفسه. كما تعهدت بإنشاء صندوق دعم للمطورين بقيمة مليون دولار، والتزمت بمراجعة يدوية فنية وقانونية لكل عملية إزالة بموجب المادة 1201. وقد حفزت هذه الحادثة إنشاء مشروع yt-dlp. ويظهر مستودع النسخة الجديدة في سجل التغييرات بعد ثلاثة أيام من الإزالة. لم يكن أحد يعلم حينها ما إذا كانت GitHub ستتراجع. أراد المطورون ضمانًا.

قم بتثبيت yt-dlp على أنظمة التشغيل Windows و macOS و Linux

ينسى المستخدمون النصف الثاني من عملية التثبيت، ثم يتساءلون عن سبب تعطل خطوة الدمج. صحيح أن yt-dlp يستطيع بمفرده سحب بث واحد من أي موقع يدعمه، لكن ماذا عن أفضل فيديو وأفضل صوت؟ أو فصول مضمنة؟ أو إعادة دمج ملفات mp4؟ كل هذا يُسند إلى ffmpeg وffprobe. إذا تجاهلت هذين البرنامجين، فستُظهر محاولتك الأولى لـ `bv*+ba/b` رسالة غامضة وتتوقف. لذا: ثبّت كلا البرنامجين دائمًا.

بالنسبة لنظام ويندوز، أستخدم أداة winget. قم بتثبيت yt-dlp.yt-dlp باستخدام winget، ثم قم بتثبيت Gyan.FFmpeg باستخدام winget. يمكنك استخدام Scoop إذا كنت تستخدمه بالفعل، وكذلك Chocolatey. إذا كنت ترى أن استخدام مدير حزم أمر مبالغ فيه، يمكنك تحميل ملف yt-dlp.exe المستقل من GitHub Releases - ما عليك سوى وضعه في مجلد، وإضافة المجلد إلى متغير PATH، وانتهى الأمر.

لمستخدمي نظام ماك، إليكم النسخة الأسهل: `brew install yt-dlp ffmpeg`. سطر واحد فقط. تابعوا.

تختلف متطلبات نظام لينكس باختلاف التوزيعات. يأتي الإصدار yt-dlp مُضمّنًا في الأرشيف الرئيسي لـ Debian، بينما يُخزّن في Arch ضمن مجلد `extra`. أما Fedora، فتحصل عليه عبر قنواتها القياسية. تكمن المشكلة في التوقيت: فعندما يُصدر تحديثٌ لـ YouTube، تتأخر إصدارات التوزيعات عادةً لعدة أيام. الحل الأمثل هو تثبيت Python، وهي أفضل طريقة لتنزيل الفيديوهات في نفس يوم صدور التحديث: `python -m pip install -U yt-dlp` على أي نظام يعمل بنظام Python 3.9 أو أحدث. يُحدّث هذا الأمر تلقائيًا. لا يزال خيار curl-and-chmod مُدرجًا في الوثائق (`sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod +x /usr/local/bin/yt-dlp`)، ولكن يُنصح باستخدامه فقط في حال عدم وجود خيار آخر عبر مدير الحزم.

بعد التثبيت، يقوم الأمر `yt-dlp -U` بتحديث pip والنسخ الثنائية؛ ويتجاهل نسخ مدير الحزم عمدًا. اختر طريقة تثبيت واحدة والتزم بها. يُعدّ استخدام ffmpeg وffprobe معًا أمرًا لا غنى عنه.

أوامر yt-dlp الأساسية التي ستستخدمها فعليًا

قائمة الغش الأساسية مختصرة. الأمر الأساسي، `yt-dlp URL`، يكفي للحالات الشائعة. أما ما بعد ذلك فهو عبارة عن علامة أو علامتين.

قبل تحميل أي فيديو من يوتيوب، شغّل الأمر `yt-dlp -F URL` للاطلاع على الخيارات المتاحة. يعرض الناتج جميع صيغ الفيديو، وجميع مسارات الصوت، وجميع المسارات المدمجة مسبقًا التي عثر عليها المُستخرج، بالإضافة إلى برامج الترميز وأحجام الملفات. بعد ذلك، ينتقل معظم المستخدمين مباشرةً إلى الأمر `yt-dlp -f "bv*+ba/b" URL`. يُقرأ هذا الخيار على أنه "أفضل فيديو بالإضافة إلى أفضل صوت، وفي حال عدم وجود مسارين منفصلين، يتم استخدام أفضل مسار مدمج". يُعد هذا الخيار الصيغة الرئيسية لاختيار الصيغة في yt-dlp، ويستحق الحفظ. أضف `--merge-output-format mp4` لفرض استخدام الحاوية؛ وأضف `-x --audio-format mp3` للصوت فقط. بالنسبة للترجمة، فإن `--write-subs --sub-langs en` يجلب الترجمة الرسمية، و `--write-auto-subs` يعود إلى المسار الذي تم إنشاؤه تلقائيًا عندما لا يكون هناك ترجمة بشرية.

بالنسبة للقوائم، يقرأ الخيار `-a urls.txt` رابطًا واحدًا في كل سطر، وهو الطريقة القياسية لتنزيل عدة فيديوهات دفعة واحدة. أما الخيار `--playlist-items 1-10,15,20-` فيقسم قائمة التشغيل. ويحتفظ الخيار `--download-archive seen.txt` بسجل التنزيلات المكتملة، بحيث تتخطى عمليات إعادة التشغيل ما تم تنزيله مسبقًا. يُعد أرشيف التنزيل الطريقة الأمثل لتنزيل قوائم التشغيل والقنوات كاملةً تدريجيًا دون الحاجة إلى إعادة التنزيل. يتبع اسم الملف الناتج نمطًا محددًا. ينتج عن السلسلة `-o "%(channel)s/%(upload_date>%Y-%m-%d)s — %(title)s.%(ext)s"` أسماء ملفات مُؤرَّخة ومُجمَّعة حسب القنوات في المجلد الذي تختاره. وتكون النتيجة متوافقة مع مكتبات Plex وJellyfin. يُغيّر الخيار `-P` مجلد الوجهة. أما الخيار `--restrict-filenames` فيُبقي أسماء الملفات بتنسيق ASCII لضمان التوافق مع أنظمة الملفات المختلفة. و `--print filename` يعرض معاينة لما سيكتبه yt-dlp قبل بدء عملية التنزيل.

إذا تم تشغيل التنزيل بدلاً من تنزيله، فهذا يعني أن متصفحك يفتح الرابط قبل أن يراه برنامج yt-dlp. مرر عنوان URL كمعامل حرفي، أو ضعه بين علامتي اقتباس، ثم شغّل yt-dlp من سطر الأوامر.

ميزات المستخدم المتقدم: معالجات ما بعد المعالجة، وحظر الرعاة، وملفات تعريف الارتباط

إلى جانب الأساسيات، يتمتع برنامج yt-dlp بمجموعة واسعة من الميزات. أما الخيارات المذكورة أدناه فهي الأكثر أهمية من الناحية العملية.

يُعدّ دمج SponsorBlock مفيدًا. إذ يستفيد هذا الخيار من قاعدة بيانات مجتمع SponsorBlock، حيث يقوم إما بتحديد علامات الفصول أو حذف أقسام الرعاة من فيديوهات يوتيوب بشكل كامل. يقرأ خيار `--cookies-from-browser` ملفات تعريف الارتباط من ملفات تعريف المتصفح، بما في ذلك حاويات فايرفوكس، وهي الطريقة الأمثل لتنزيل أي محتوى مدفوع أو يتطلب تسجيل دخول. بالنسبة للأرشيفات الضخمة التي تصل إلى تيرابايت، يُحسّن استخدام برنامج التنزيل الخارجي aria2c سرعة التنزيل بشكل ملحوظ على الشبكات التي تُشكّل فيها نوافذ TCP عنق الزجاجة. كما يقوم خيار `--split-chapters` بتقسيم محتوى الفيديو حسب الفصول إلى ملفات منفصلة، وهو أمر مفيد عند تحميل عدة محاضرات في ملف واحد. يدعم yt-dlp أيضًا خيار `--video-multistreams` لدمج مسارات الفيديو عندما يُوفّر الموقع مسارات متعددة، على الرغم من ندرة هذا الخيار.

يستحق نظام الإضافات سطرًا خاصًا به. سيكتشف yt-dlp تلقائيًا وحدات بايثون الموجودة في `~/.yt-dlp/plugins/` (أو المثبتة عبر `pip` باستخدام نقطة الدخول `yt-dlp-plugins`) ويُحمّلها كمستخلصات أو معالجات لاحقة. هكذا تُدعم المواقع غير المألوفة دون انتظار تصحيح من المصدر الرئيسي. وهي أيضًا الطريقة التي تتكامل بها إضافات موفر PoToken المذكورة أدناه.

وضع PoToken وSABR في الفترة 2025-2026

أمضت يوتيوب عام 2025 في تعقيد عمل برنامج yt-dlp. وهناك تغييران هما السبب في أن عملية تثبيت سليمة تمامًا قد تبدأ فجأة بالفشل في عام 2026.

يُعدّ PoToken هو الأكبر. يتطلب كل طلب فيديو الآن رمز إثبات المنشأ. يرتبط هذا الرمز بالفيديو، وينتهي صلاحيته بسرعة، كما أنه مرتبط بالجلسة. توقف استخراج الرمز يدويًا عن العمل منذ أشهر. ما يعمل حاليًا هو أداة مساعدة صغيرة تُسمى `bgutil-ytdlp-pot-provider` تعمل بشكل مستقل؛ حيث تُنشئ هذه الأداة الرموز عند الطلب، ويستقبلها استدعاء yt-dlp الرئيسي تلقائيًا. يحتوي موقع yt-dlp wiki على دليل بعنوان "دليل رمز إثبات المنشأ" يشرح عملية الإعداد. بدون هذه الأداة المساعدة، ستعود الطلبات بمستوى أمان منخفض أو محظورة تمامًا، وقد لا يعمل yt-dlp بشكل صحيح حتى مع مقاطع الفيديو التي تم تشغيلها في متصفحك قبل ثلاثين ثانية.

SABR هو الجزء الثاني. SABR هو معدل البت التكيفي من جانب الخادم في يوتيوب، وبحلول عام 2025، بدأ مستخرج الويب بإرجاع تنسيقات SABR فقط، مما يُعطّل مسار التنزيل العادي. عادةً ما يكون الحل عبارة عن تلميح لوسيطات المستخرج بالإضافة إلى ملفات تعريف الارتباط من متصفح مُسجّل الدخول. المواضيع التي تستحق المتابعة أثناء تطوير الحل هي المشكلات رقم 12482، و14307، و14390، و16082، و13968. النتيجة النهائية: لا يزال yt-dlp يعمل على الغالبية العظمى من محتوى يوتيوب العام، ولكن في عام 2026، غالبًا ما يكون الأمر الذي يعمل ببساطة عبارة عن أمر يتطلب "مُزوّد رمز PoToken، وملفات تعريف ارتباط جديدة، وقليل من الصبر".

الوضع القانوني لتقنية yt-dlp في عام 2026: الولايات المتحدة، ألمانيا، الاتحاد الأوروبي

الجواب القانوني يتعلق بالاختصاص القضائي، والخلاصة هي أنه لم يتم حسم أي شيء بشكل نهائي.

في الولايات المتحدة ، لم تصدر أي محكمة حكمًا بشأن برنامج yt-dlp تحديدًا. وتُعدّ قضية رابطة صناعة التسجيلات الأمريكية (RIAA) لعام 2020 أقرب سابقة قضائية، وقد انتهت بنقض الحكم خارج المحكمة. دخلت القاعدة النهائية التاسعة لمكتب حقوق النشر الأمريكي، الصادرة كل ثلاث سنوات، بموجب المادة 1201 حيز التنفيذ في 28 أكتوبر 2024، وتستمر حتى 28 أكتوبر 2027. وقد جددت هذه القاعدة استثناءات سابقة، وأضافت استثناءً لأبحاث موثوقية الذكاء الاصطناعي، لكنها لم تُنشئ استثناءً عامًا للتحايل على حقوق النشر لأغراض الأرشفة الشخصية للفيديوهات. ولا تزال المشكلة الهيكلية للمادة 1201 قائمة، وهي أنها تُجرّم الأدوات التي تتعامل مع إدارة الحقوق الرقمية (DRM) بغض النظر عن النية.

في ألمانيا ، انصبّ التركيز على مسؤولية شركات الاستضافة وليس على البرمجيات نفسها. رفضت محكمة هامبورغ الإقليمية العليا استئناف شركة Uberspace، وهي شركة استضافة موقع `youtube-dl.org` ومقرها ماينز، في 27 نوفمبر/تشرين الثاني 2024. وقد حسم هذا القرار حكمًا سابقًا لمحكمة أدنى درجة صدر عام 2023، يقضي بمسؤولية شركات الاستضافة عن المواقع التي تُشير إلى أدوات تجاوز الحماية. لا يُجرّم هذا المبدأ برنامج yt-dlp بشكل مباشر، ولكنه يجعل الاستضافة في ألمانيا محفوفة بالمخاطر لأي مشروع يُعلن صراحةً عن إمكانيات تجاوز الحماية.

على مستوى الاتحاد الأوروبي ، يُوحّد قانون الخدمات الرقمية إجراءات الإخطار والإزالة (المادتان 16 و17)، ولكنه لا يُنظّم برامج التنزيل. لا يوجد قرارٌ على مستوى الاتحاد الأوروبي يُلزم مُقدّمي خدمات الاستضافة بحظر برنامج yt-dlp. ولا يُعدّ الاستخدام الشخصي لبرنامج yt-dlp على محتواك الخاصّ نقطة ضغط قانوني في أيٍّ من هذه الولايات القضائية. وينطبق الأمر نفسه على المحتوى الذي منح مُنشئه الإذن باستخدامه. يكمن الإشكال في التوزيع والتفاعل مع حماية البث.

واجهات المستخدم الرسومية ونظام التنزيل الأوسع

لا يرغب الجميع في استخدام سطر الأوامر، كما أن سطر أوامر yt-dlp ليس من نقاط قوته التسويقية. يُعد yt-dlp أحد برامج تنزيل الفيديو العديدة، ولكنه يعمل كمحرك أساسي في معظم واجهات المستخدم الرسومية الحديثة لبرامج تنزيل الفيديو. أما Stacher، فهو واجهة المستخدم الرسومية الأكثر سلاسةً وتوافقًا مع مختلف المنصات. Tartube بديلٌ مبنيٌّ على Python/GTK. yt-dlg هو نسخةٌ مُعدّلةٌ من yt-dlp، طوّرها المجتمع خصيصًا لهذا الغرض. Tube-Archivist خادم Docker مُستضاف ذاتيًا لأرشفة القنوات، حيث يُمكنه تنزيل الفيديوهات من مواقع ويب مختلفة وفقًا لجدول زمني. YTDL-Material واجهة ويب أمامية مُستضافة ذاتيًا. ytdl-sub أداة تكوين YAML تعريفية شائعة الاستخدام بين مُستخدمي Plex وJellyfin المُستضافين ذاتيًا. يدمج JDownloader 2 برنامج yt-dlp من خلال إضافة. تُوفّر كل أداة واجهة اختيار فيديو ولوحة خيارات تنزيل خاصة بها، ولكن الجزء الأكبر من العمل يقع على عاتق yt-dlp.

القاعدة الأساسية: yt-dlp للتنزيلات الأرشيفية، وstreamlink للبث المباشر إلى مشغل، وgallery-dl للمواقع التي تحتوي على صور كثيرة.

الأمان: من أين يتم تنزيل yt-dlp وكيفية اكتشاف النسخ المزيفة

المصادر الآمنة الوحيدة هي إصدارات GitHub، وPyPI (باستخدام الأمر `pip install yt-dlp`)، وحزم التوزيع الرسمية، ومديري حزم Windows الرئيسيين (Winget، وScoop، وChocolatey). مواقع تنزيل yt-dlp التابعة لجهات خارجية تُضمّن برامج إعلانية، أو برامج تعدين، أو ملفات ثنائية مُعدّلة. وقد صنّف Windows Defender ملف `yt-dlp.exe` المُضمّن في PyInstaller سابقًا على أنه `Trojan:Win32/Wacatac.B!ml` (المشكلتان #7532 و#15415). هذه إنذارات خاطئة ناتجة عن خلل في النظام. عادةً ما تُزال قواعد بيانات التوقيعات في غضون أيام. تعتمد المشاريع الصغيرة مفتوحة المصدر مثل yt-dlp على جهود المتطوعين. وتُعدّ التبرعات بالعملات الرقمية عبر بوابات مثل Plisio إحدى الطرق الآمنة التي تُمكّن المساهمين الدوليين من الحصول على الدعم.

مثال عملي: لنفترض أنك تريد تنزيل فيديو من يوتيوب إلى جهاز الكمبيوتر لعرض تقديمي. الأمر هو `yt-dlp -f "bv*+ba/b" --merge-output-format mp4 URL`، والذي يُعطيك تنسيق التنزيل الصحيح. yt-dlp هو نسخة مُعدّلة من youtube-dl، ويحتوي على عدد أكبر من أدوات الاستخراج، كما يُتيح لك تنزيل الفيديوهات التي لا يدعمها البرنامج الأصلي. يُغطي yt-dlp، من خلال نظام الإضافات الخاص به، مصادر متخصصة، كما يُتيح لك استخدام `-a urls.txt` عند الحاجة إلى تنزيل الفيديوهات من مواقع ويب مختلفة. جميع المواقع التي يدعمها yt-dlp موجودة في ملف `supportedsites.md`.

Elisabeth McGowan

A freelance writer passionate about celebrities, net worth stories, athletes, and political figures. She transforms facts into engaging narratives. A true cheese lover and cycling enthusiast, she finds inspiration in motion and flavor.