مولّد أوامر yt-dlp ليوتيوب

yt-dlp -f 'bv*[height<=1080]+ba/b[height<=1080]' --merge-output-format mp4 --embed-subs --sub-langs en --no-playlist --embed-thumbnail --embed-metadata --embed-chapters --sponsorblock-remove default 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'

الأساسيات

ما الذي تريده

فيديو صوت فقط

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

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

أقصى جودة -f أفضل المتاح 4K (2160p) 2K (1440p) 1080p 720p 480p 360p

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

الحاوية --merge-output-format يحتاج ffmpeg أبقِ الأصل MP4 (الأكثر توافقًا) MKV (يحتفظ بكل شيء) WebM MOV

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

خيارات متقدمة (3)

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

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

إعادة التغليف إلى --remux-video يحتاج ffmpeg بلا MP4 (الأكثر توافقًا) MKV (يحتفظ بكل شيء) WebM MOV

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

إعادة الترميز إلى --recode-video يحتاج ffmpeg بلا MP4 (الأكثر توافقًا) MKV (يحتفظ بكل شيء) WebM

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

الصوت

صيغة الصوت --audio-format يحتاج ffmpeg MP3 M4A (AAC) Opus FLAC (بلا فقد) WAV (بلا فقد) Vorbis أفضل المتاح (دون تحويل)

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

جودة الصوت --audio-quality يحتاج ffmpeg الأفضل (VBR) 320 kbps 256 kbps 192 kbps 128 kbps

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

الترجمات

الترجمات بلا ضمّنها في الفيديو احفظها كملف ‎.srt ضمّنها واحفظها

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

لغات الترجمة --sub-langs

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

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

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

التعامل مع قائمة التشغيل دع yt-dlp يقرّر هذا الفيديو فقط قائمة التشغيل كاملة

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

أي العناصر -I

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

خيارات متقدمة (1)

ملف الأرشيف --download-archive

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

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

خيارات متقدمة (2)

نزِّل جزءًا منه فقط --download-sections يحتاج ffmpeg

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

قسِّمه إلى فصول --split-chapters يحتاج ffmpeg يكتب ملفًا لكل فصل بدل ملف واحد طويل.

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

ضمِّن الصورة المصغّرة --embed-thumbnail يحتاج ffmpeg يستخدم الصورة المصغّرة للفيديو كصورة غلاف.

ضمِّن البيانات الوصفية --embed-metadata يحتاج ffmpeg يكتب العنوان والناشر والتاريخ داخل الملف نفسه.

ضمِّن الفصول --embed-chapters يحتاج ffmpeg يضيف علامات فصول يمكن لمشغّلك التنقل بينها.

خيارات متقدمة (3)

احفظ ملف الصورة المصغّرة --write-thumbnail يكتب صورة الغلاف بجانب الفيديو.

احفظ الوصف --write-description يكتب الوصف في ملف ‎.description.

احفظ البيانات الوصفية بصيغة JSON --write-info-json يكتب كل ما يعرفه yt-dlp عن الفيديو في ملف ‎.info.json.

SponsorBlock

أزِل المقاطع --sponsorblock-remove يحتاج ffmpeg بلا الرعايات فقط الرعايات والمقدمات والترويج الذاتي كل ما هو معلَّم

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

خيارات متقدمة (1)

علِّم المقاطع كفصول --sponsorblock-mark بلا الرعايات والمقدمات والترويج الذاتي كل ما هو معلَّم

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

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

قالب اسم الملف -o

العنوان العنوان + المعرّف قائمة تشغيل مرقّمة الناشر / التاريخ - العنوان

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

أسماء ملفات آمنة (ASCII) --restrict-filenames يحذف الحركات والمسافات وكل ما قد يرفضه نظام ملفات متشدّد.

اكتب فوق الملفات الموجودة --force-overwrites يستبدل الملفات الموجودة أصلًا.

استأنف التنزيلات الناقصة -c يكمل من حيث توقّف التنزيل المقطوع.

خيارات متقدمة (4)

مجلد التنزيل -P

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

أسماء آمنة لـ Windows --windows-filenames يحذف الأحرف التي يرفضها Windows حتى لو كنت تعمل على نظام آخر.

اقتطع الأسماء إلى --trim-filenames

أقصى طول لاسم الملف بعدد الأحرف.

لا تكتب فوق شيء أبدًا -w يتخطى كل ما نُزِّل من قبل.

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

خيارات متقدمة (5)

نُشر بعد --dateafter

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

نُشر قبل --datebefore

YYYYMMDD، أو تاريخ نسبي.

أدنى حجم --min-filesize

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

أقصى حجم --max-filesize

يتخطى كل ما هو أكبر.

توقّف بعد --max-downloads

عدد الملفات التي تُنزَّل قبل التوقف.

الشبكة

حد السرعة -r

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

خيارات متقدمة (5)

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

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

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

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

وكيل (Proxy) --proxy

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

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

انتحال هوية متصفح --impersonate بلا Chrome Edge Safari Firefox

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

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

الكوكيز من المتصفح --cookies-from-browser بلا Chrome Firefox Edge Brave Safari Chromium Opera Vivaldi

يقرأ جلسة الدخول لديك مباشرة. ضروري للمحتوى الخاص أو المقيَّد بالعمر أو المخصص للأعضاء.

خيارات متقدمة (1)

ملف الكوكيز --cookies

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

البث المباشر

خيارات متقدمة (2)

سجِّل من البداية --live-from-start يبدأ تسجيل البث المباشر من أوله بدل اللحظة الحالية.

انتظر البث --wait-for-video

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

حلول بديلة

خيارات متقدمة (3)

User agent --user-agent مهجور

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

Referer --referer مهجور

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

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

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

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

اسرد الصيغ فقط -F يطبع الصيغ المتاحة ثم ينتهي دون تنزيل.

خيارات متقدمة (2)

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

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