تخطَّ إلى المحتوى
yt-dlp
تغيير اللغة

مرجع خيارات yt-dlp

كُتب هذا المرجع بناءً على yt-dlp 2026.07.21. تُضاف الخيارات وتُعاد تسميتها بين الإصدارات، لذا تحقّق من إصدارك بالأمر yt-dlp --version.

الأساسيات

ما الذي تريده

خيار «الصوت فقط» يستخرج المسار الصوتي ويتجاهل مسار الفيديو.

الفيديو والجودة

-f FORMAT --format

أقصى جودة

يحدّد سقف الارتفاع. سيظل yt-dlp يختار أفضل مسار عنده أو دونه.

-f FORMAT --format

محدِّد صيغة مخصص

يتجاوز قائمة الجودة. لمن يعرف صياغة الصيغ مسبقًا.

أمثلة

  • -f "bv*[vcodec^=av01]+ba"
  • -f "b[filesize<50M]"
--merge-output-format FORMAT يحتاج ffmpeg

الحاوية

نوع الملف الذي تُدمج فيه مسارات الفيديو والصوت المنفصلة.

--remux-video FORMAT يحتاج ffmpeg

إعادة التغليف إلى

يعيد تغليف المسارات دون إعادة ترميز. سريع وبلا فقد في الجودة.

--recode-video FORMAT يحتاج ffmpeg

إعادة الترميز إلى

يعيد ترميز الفيديو. بطيء ومع فقد في الجودة — استخدمه فقط حين لا تكفي إعادة التغليف.

الصوت

--audio-format FORMAT يحتاج ffmpeg

صيغة الصوت

الملف الذي سيُحوَّل الصوت إليه.

--audio-quality QUALITY يحتاج ffmpeg

جودة الصوت

يمنح VBR أفضل نسبة بين الحجم والجودة؛ أما معدلات البت الثابتة فأسهل في التوقّع.

الترجمات

الترجمات

التضمين يضعها داخل الفيديو؛ أما الحفظ فيكتب ملف ‎.srt منفصلًا بجانبه.

--sub-langs LANGS

لغات الترجمة

افصل بينها بفاصلة. استخدم all لكل اللغات المتاحة.

أمثلة

  • --sub-langs "en,vi"
  • --sub-langs "en.*,ja"
  • --sub-langs all
--write-auto-subs

الترجمات المولَّدة آليًا

أدرِج التعليقات المولَّدة آليًا حين لا توجد ترجمة بشرية.

قوائم التشغيل والقنوات

التعامل مع قائمة التشغيل

ما العمل حين ينتمي الرابط إلى فيديو وقائمة تشغيل في آنٍ واحد.

-I ITEM_SPEC --playlist-items

أي العناصر

تعمل النطاقات والقوائم معًا، مثل 1-10,15 أو ‎-5::2 لكل عنصر ثانٍ ابتداءً من النهاية.

أمثلة

  • -I 1:5
  • -I "1,3,7-10"
  • -I "-5::2"
--download-archive FILE

ملف الأرشيف

يسجّل ما نُزِّل فعلًا كي يتخطاه التشغيل التالي. هذه هي طريقة إبقاء قناة متزامنة.

المقاطع والفصول

--download-sections REGEX يحتاج ffmpeg

نزِّل جزءًا منه فقط

نطاق زمني مثل ‎*00:01:30-00:03:00، أو اسم فصل. النجمة في البداية تعني أنه ختم زمني.

أمثلة

  • --download-sections "*00:01:30-00:03:00"
  • --download-sections "intro"
--split-chapters يحتاج ffmpeg

قسِّمه إلى فصول

يكتب ملفًا لكل فصل بدل ملف واحد طويل.

البيانات الوصفية والغلاف

--embed-thumbnail يحتاج ffmpeg

ضمِّن الصورة المصغّرة

يستخدم الصورة المصغّرة للفيديو كصورة غلاف.

--embed-metadata يحتاج ffmpeg

ضمِّن البيانات الوصفية

يكتب العنوان والناشر والتاريخ داخل الملف نفسه.

--embed-chapters يحتاج ffmpeg

ضمِّن الفصول

يضيف علامات فصول يمكن لمشغّلك التنقل بينها.

--write-thumbnail

احفظ ملف الصورة المصغّرة

يكتب صورة الغلاف بجانب الفيديو.

--write-info-json

احفظ البيانات الوصفية بصيغة JSON

يكتب كل ما يعرفه yt-dlp عن الفيديو في ملف ‎.info.json.

SponsorBlock

--sponsorblock-remove CATS يحتاج ffmpeg

أزِل المقاطع

يقتطع من الملف المقاطع التي حدّدها المجتمع اعتمادًا على بيانات SponsorBlock.

--sponsorblock-mark CATS

علِّم المقاطع كفصول

يبقي المقاطع لكنه يعلّمها، فتستطيع تخطّيها بنفسك.

الملفات والمجلدات

-o [TYPES:]TEMPLATE --output

قالب اسم الملف

تُوضع أسماء الحقول داخل ‎%(...)s. والشرطات المائلة تنشئ مجلدات.

أمثلة

  • -o "%(title)s.%(ext)s"
  • -o "%(playlist_index)02d - %(title)s.%(ext)s"
-P [TYPES:]PATH --paths

مجلد التنزيل

المكان الذي تُكتب فيه الملفات. اجمعه مع القالب أعلاه لإنشاء مجلدات فرعية.

--restrict-filenames

أسماء ملفات آمنة (ASCII)

يحذف الحركات والمسافات وكل ما قد يرفضه نظام ملفات متشدّد.

--windows-filenames

أسماء آمنة لـ Windows

يحذف الأحرف التي يرفضها Windows حتى لو كنت تعمل على نظام آخر.

--force-overwrites

اكتب فوق الملفات الموجودة

يستبدل الملفات الموجودة أصلًا.

-w --no-overwrites

لا تكتب فوق شيء أبدًا

يتخطى كل ما نُزِّل من قبل.

-c --continue

استأنف التنزيلات الناقصة

يكمل من حيث توقّف التنزيل المقطوع.

عوامل التصفية

--dateafter DATE

نُشر بعد

YYYYMMDD، أو تاريخ نسبي مثل now-1month.

أمثلة

  • --dateafter 20240101
  • --dateafter now-1month
--min-filesize SIZE

أدنى حجم

يتخطى كل ما هو أصغر. يقبل 5M و500K وما شابه.

الشبكة

-r RATE --limit-rate

حد السرعة

مثل 2M أو 500K. مفيد حين تحتاج بقية النطاق الترددي لأمر آخر.

-N N --concurrent-fragments

أجزاء متوازية

يسرّع المسارات المجزّأة. الرقم أربعة نقطة بداية معقولة.

-R RETRIES --retries

عدد المحاولات

كم مرة يُعاد المحاولة عند فشل جزء. القيمة infinite مسموحة.

--proxy URL

وكيل (Proxy)

رابط وكيل HTTP أو HTTPS أو SOCKS.

--geo-bypass

تجاوز الحجب الجغرافي

يزيّف مصدر الطلب. ينجح مع بعض المواقع لا كلها.

--impersonate CLIENT[:OS]

انتحال هوية متصفح

يجعل الطلبات تبدو صادرة من متصفح حقيقي. هذا هو الحل المعتاد لأخطاء 403 المفاجئة.

تسجيل الدخول وملفات الكوكيز

--cookies FILE

ملف الكوكيز

ملف cookies.txt بصيغة Netscape مُصدَّر من متصفحك.

البث المباشر

--live-from-start

سجِّل من البداية

يبدأ تسجيل البث المباشر من أوله بدل اللحظة الحالية.

--wait-for-video MIN[-MAX]

انتظر البث

يستعلم دوريًا حتى يبدأ بث مجدول. القيمة MIN-MAX هي الثواني بين كل استعلام وآخر.

حلول بديلة

--user-agent UA مهجور — --add-headers

User agent

مهجور لصالح ‎--add-headers. أُبقي عليه لأن كثيرًا من الشروحات القديمة ما زالت تستخدمه.

--referer URL مهجور — --add-headers

Referer

مهجور لصالح ‎--add-headers.

--extractor-args IE_KEY:ARGS

وسائط المستخرِج

مفاتيح خاصة بكل موقع، مثل youtube:player_client=web.

أمثلة

  • --extractor-args "youtube:player_client=web,android"

الإخراج والتشخيص

-i --ignore-errors

تابع رغم الأخطاء

يتخطى العناصر الفاشلة بدل التوقف. ضروري لقوائم التشغيل الكبيرة.

-F --list-formats

اسرد الصيغ فقط

يطبع الصيغ المتاحة ثم ينتهي دون تنزيل.

-s --simulate

محاكاة

ينفّذ كل شيء عدا كتابة الملف.