تخطَّ إلى المحتوى
AR
الحصول على مفتاح API
تصفح الوثائق

الأدلة

أوامر yt-dlp للاستخدام اليومي

أوامر جاهزة للنسخ للفيديو والصوت والترجمة ومجموعات البيانات واستئناف عمليات التجميع.

في هذه الصفحة

الإعداد وطريقة استخدام الأوامر

تثبيت الإصدار الليلي الحالي والحزم اللازمة
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
ffmpeg -version
python -m yt_dlp --list-impersonate-targets

تستخدم وصفات التنزيل Deno و --impersonate="" كخط أساس. يتطلب هذا الأخير curl-cffi ويسمح له باختيار بصمات الأصابع المتاحة في المتصفح. Linux/macOS يأمر باستخدام بنك Bash؛ بالنسبة للعامل المقرر، أيضا جعل هذه الاعتمادات متاحة في هذا البيئة الخدمة.

هذه الأمثلة النهائية تستخدم تثبيت Python yt-dlp. استخدم بيئتك الافتراضية Python، أو استبدل Python -m yt_dlp مع الأمر المستقل yt-dlp. استخدم Linux أولاً، مع بدائل macOS وWindows في دليل الإعداد. قم بتثبيت FFmpeg/ffprobe للاندماج و Deno لـ YouTube Challenge Solving. استبدال URL المثال بمصدرك.

الاتفاقيةلماذا يهم
إرسال رسائل URL و Templatesيُفسر الشكل بطريقة أخرى شخصيات مثل &، الفضاء والفرق.
حفظ %(ext)s في أسماء الفيليتم تحديد وسائل الإعلام المختارة و ما بعد المعالجة لتمديدها.
استخدام --no-playlist لـ URL ساعةيجب ألا يزيد الفيديو المرتبط من قائمة التشغيل بشكل غير متوقع وظيفتك.
تحقق من إعداداتك المحفوظةيمكن أن يرث الأمثلة إعدادًا عالميًا.استخدم --ignore-config لاختبار عازل.
Windows .bat: علامات النسبة المئوية المزدوجةاستخدم %(id)s في ملف مجموعة، ولكن %(id)s في PowerShell التفاعلية وملفات التحكم العادية.

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

الخط الأساسي: آخر ليلة، دينو و FFmpeg، مع --impersonate="". تستخدم الوصفات Bash؛ استبدال عنوان العينة URL مع المصدر الخاص بك.

تحميل الفيديو مع الاختيار الافتراضي
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -P downloads \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
يختار التدفقات المتاحة باستخدام الافتراضات yt-dlp. لا يكون الحاويات MP4 بالضرورة.
قائمة المنتجات المتاحة
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"
فحص الرموز و audio-only/video-only صفوف.IDs النموذج الرقمي ليست سياسات الناتج المحمولة.
أضف تعليق 1080p
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -S "res:1080" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
تفضيل: إذا لم يكن هناك أي تنسيق عند أو تحت الهدف متاحًا ، فيمكن للترتيب اختيار واحد فوقه.
أولاً: إجراء الحد الأقصى لـ 1080p
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv*[height<=1080]+ba/b[height<=1080]" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
الفلتر: يفشل عندما لا يتطابق أي شكل. يحتفظ باختيار الترميز المصدر.
H.264 الفيديو و AAC الصوت في MP4
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv[vcodec^=avc1][height<=1080]+ba[acodec^=mp4a]/b[vcodec^=avc1][acodec^=mp4a][height<=1080]" \
  --merge-output-format mp4 "https://www.youtube.com/watch?v=jNQXAC9IVRw"
اختيار قوي من القواعد.يتطلب تنسيقات مطابقة و FFmpeg لدمج منفصل.

مجموعة بيانات الذكاء الاصطناعي: MP4 + المقبرات + البيانات الميتا

أفضل الفيديو + الصوت، MP4، المقبرات والبيانات الميتا
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bestvideo+bestaudio/best" --merge-output-format mp4 --remux-video mp4 \
  --write-info-json --write-subs --write-auto-subs --sub-langs "en" --sub-format "vtt/best" \
  --sleep-subtitles 5 --concurrent-fragments 1 -P dataset -o "%(id)s/%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
FFmpeg يجمع تدفقات المصدر. MP4 يحافظ على رموز المصدر؛ تحقق من التوافق مع الرفع وتغطية العلامة بشكل منفصل.

تحميل: aria2c

2 اتصالات، الأصلي DASH/HLS
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist --downloader aria2c \
  --downloader "dash,m3u8:native" --downloader-args "aria2c:-x 2 -s 2 -j 1" \
  --concurrent-fragments 1 -P downloads "https://www.youtube.com/watch?v=jNQXAC9IVRw"
يتطلّب الملف التنفيذي aria2c. تحقّق أولًا من تنزيل فيديو واحد، ثم زد عدد الاتصالات. خفّضه فور ظهور الخطأ 403.

aria2 لديه تنفيذ الشبكة الخاص به. yt-dlp curl-cffi التصميم لا يحدد aria2 بصمات الأصابع. إذا فشل فقط المتصفح الخارجي، استخدم --downloader الأصلي ومقارنة نفس المصدر والطريق المباشر.

الصوت و MP3

حفظ البث الأصلي
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -P audio \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
لا MP3 التحويل. مفيد عندما تقبل خط التحويل أو التدوير الأصلي.
تحويل إلى MP3 عند معدل بيت المستهدف
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
  --audio-format mp3 --audio-quality 192K -P audio \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
يستخدم FFmpeg. 192K يسيطر على ترميز الإنتاج؛ فإنه لا يستعيد جودة المصدر.
تفضيل M4A دون ترتيب
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f "ba[ext=m4a]" -P audio \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
فشل إذا لم يكن هناك M4A تنسيق الصوت فقط متاحا.إضافة /ba فقط إذا كان التطبيق يقبل حاويات المصدر الأخرى.
MP3 مع الميثاد المعقدة والغطاء
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
  --audio-format mp3 --embed-metadata --embed-thumbnail -P audio \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
الخطوات metadata/thumbnail هي إضافية ما بعد المعالجة.تحقق من الملف النهائي، وليس مجرد نقل الرافعة المالية.

كلمات و عناوين

قائمة المسارات المتاحة
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --list-subs "https://www.youtube.com/watch?v=jNQXAC9IVRw"
اقرأ علامات اللغة المقدمة من هذا المصدر قبل اختيار --sub-langs.
تحميل العناوين الإنجليزية فقط
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-subs \
  --sub-langs "en.*" --sub-format "vtt/best" -P captions -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
لا يعود إلى التصوير التلقائي ولا ينزيل الوسائط.
يسمح أيضًا بتصنيف الإنجليزية التلقائية
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-subs \
  --write-auto-subs --sub-langs "en.*" --sub-format "vtt/best" -P captions \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
* يمكن أن يطابق العديد من الاختلافات الإنجليزية.هذا يحصل على المسارات المتاحة؛ فإنه لا يعمل التعرف على الكلام.
تحويل المسارات المختارة إلى SRT
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-subs \
  --write-auto-subs --sub-langs "en" --convert-subs srt -P captions \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
تحتاج إلى FFmpeg.اختر رمز لغة أخرى من --list-subs إذا لزم الأمر.
إدراج العناوين المقدمة في MKV
python -m yt_dlp --js-runtimes deno --impersonate="" --write-subs --sub-langs "en" \
  --embed-subs --remux-video mkv -P downloads "https://www.youtube.com/watch?v=jNQXAC9IVRw"
تنزيل وسائل الإعلام، وطلبات المقدمة باللغة الإنجليزية العناوين، وتدخل المسار المتاح.تحقق من وجود هذا المسار أولا.

يمكن أن يزيد طلب جميع لغات الملاحظات بشكل كبير من عدد الطلبات والملفات. الحفاظ على اللغة المطلوبة صريحة للعمل الروتيني. احفظ معرف المصدر واللغة في مخزون مجموعة البيانات الخاصة بك بحيث لا يتم فصل النسخ من وسائل الإعلام التي يصفها.

الميتاديات وطرق الناتج

طباعة بيانات الفيديو ك JSON
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --dump-json "https://www.youtube.com/watch?v=jNQXAC9IVRw" > video.json
يحاكي تنزيل الافتراضي، ولكنه يقوم بإخراج.إعادة توجيه يحل محل video.json.
كتابة ملف إضافي كامل بدون وسائل الإعلام
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-info-json \
  -P metadata -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
إنشاء .info.json الجانب.هذا هو بيانات المستخرج التشغيلي؛ حقول المشروع قبل عرضها علنا.
تحميل الـالـقـطـيـب فقط
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-thumbnail \
  -P thumbnails -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
يوفر الخصم المتاح في تنسيق المصدر. --convert-thumbnails يضيف jpg خطوة التحويل عندما يكون JPEG مطلوبا.
طباعة المسار الأخير للوسائط بعد المعالجة
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --print after_move:filepath -P downloads -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
على عكس مرحلة الافتراضية --print ، ينتظر طباعة after_move تنزيل حقيقي وتحركها النهائي.
إعادة توجيه المسارات المكتملة إلى بيان
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --print-to-file after_move:filepath completed-paths.txt -P downloads \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
يضاف، بحيث يمكن أن تنتج الانسحابات إدخالات متكررة.تعامل معها كسجل الانتهاء، وليس سجل مكرر.

الفصول والرقم الزمني

تحميل ثانية 5 من خلال 10
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --download-sections "*00:00:05-00:00:10" -o "clips/%(id)s-%(section_start)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
يتطلب FFmpeg.يمكن لحدود مقطع فيديو أن تتوافق مع المفاتيح المتاحة؛ التحقق من النتيجة عند التوقيت الدقيق.
إعادة تشفير حول القطع المطلوبة
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --download-sections "*00:00:05-00:00:10" --force-keyframes-at-cuts \
  -o "clips/%(id)s-%(section_start)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
إضافة عمل إعادة التشفير لتحسين قطع على الحدود المطلوبة.تحقق من مدة النتيجة و audio/video التوافق.
تقسيم الفيديو المكتوب إلى ملفات
python -m yt_dlp --split-chapters -o "chapter:%(id)s-%(section_number)03d.%(ext)s" \
  "https://www.youtube.com/watch?v=YOUR_VIDEO_ID"
استخدم الفيديو مع بيانات الميتا الفصل. يتم فصل النتائج الفصلية عن النسخة الأصلية الكاملة؛ مساحة القرص الميزانية لكلاهما.

استخدم سياسة إخراج أو أرشيف مختلفة للكليب والفيديوهات الكاملة.لا تقوم إدخال أرشيف على مستوى المصدر بتشفير الأوقات المحددة start/end، بحيث يمكن لأي أرشيف مشترك قضاء مقطع في وقت لاحق من المستند الذي تخطط لإنشائه.

قائمة الألعاب و قائمة URL

تحميل قائمة URL المعروفة
python -m yt_dlp --no-playlist --batch-file urls.txt -P collection -o "%(id)s.%(ext)s"
إنشاء ملف UTF-8 مع واحد مشاهدة URL لكل خط. --no-playlist ينطبق على مشاهدة URL التي تشمل سياق القائمة.
فحص قائمة تشغيل YouTube دون استخراج الفيديو الكامل
python -m yt_dlp --flat-playlist \
  --dump-json "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID" > playlist.jsonl
واحد JSON الكائن لكل إدخال. قد يغفل الإدخالات المسطحة عن مدة وتفاصيل النموذج.
تحميل أول خمسة أجزاء من قائمة البرامج
python -m yt_dlp --playlist-items 1:5 -P collection -o "%(playlist_index)03d-%(id)s.%(ext)s" \
  "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID"
عرض مؤشرات قائمة اللعب هو عرض الأوامر وليس الهوية.
الحد من الفيديوهات المؤهلة حسب التاريخ والمدة
python -m yt_dlp --dateafter 20260101 --match-filters "!is_live & duration <= 1800" \
  --batch-file urls.txt
يتطلب البنود غير الحية مع مدة معروفة تصل إلى 30 دقائق، موعدا في أو بعد يناير 1، 2026.
توقف بعد 10 تحميلات جديدة
python -m yt_dlp --download-archive archive.txt --max-downloads 10 --batch-file urls.txt
يسيطر الحد على الملفات التي تم تنزيلها حديثًا ، وليس عدد طلبات listing/extraction التي تحدث.

أرشيف و إعادة التأهيل

إعادة تدوير مجموعة مع نفس السياسة
python -m yt_dlp --download-archive archive.txt --continue --no-abort-on-error -P collection \
  -o "%(id)s.%(ext)s" --batch-file urls.txt
يتم إزالة الهوية الكاملة.تعود تنزيلات جزئية إلى حيث تم دعمها.استخدم نفس المسارات الأرشيفية والخروج مثل العمل الأصلي.
السلام على العامل وربط التقاعد
python -m yt_dlp --sleep-requests 1 --sleep-interval 5 --max-sleep-interval 10 --retries 3 \
  --fragment-retries 3 --socket-timeout 30 --batch-file urls.txt
إضافة حدود العامل على مستوى الحصى عندما تشارك عدة عمليات مسارًا أو جلسة.
كاب نقل نطاق النطاق
python -m yt_dlp --js-runtimes deno --impersonate="" --limit-rate 2M \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
يسيطر على معدل نقل وسائل الإعلام.لا ينظم عدد طلبات الاستخراج.
انخفاض المنافسة في قطعة الأصلي
python -m yt_dlp --js-runtimes deno --impersonate="" --concurrent-fragments 1 \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
ابدأ بقطعة واحدة في وقت واحد عند التحقيق 403s. لا تزال عمليات العمال الأخرى تضاف إلى طلباتهم المتنافسة الخاصة.

التكوين والاسم الفيل

تحميل مجرد جمعك المحدد
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf --batch-file urls.txt
يتم تحميل التكوين المسمى صراحة حتى مع --ignore-config.استخدم مسارات كاملة للعمل المقرر.
أسماء قابلة للقراءة مع هوية مستقرة
python -m yt_dlp --js-runtimes deno --impersonate="" -P downloads \
  -o "%(channel_id)s/%(upload_date)s-%(title).150B [%(id)s].%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
يتم ترتيب العنوان إلى 150 بايت في هذا القالب. IDs تميز العناوين المكررة أو التغيير.
استخدم قائمة مؤقتة منفصلة
python -m yt_dlp --js-runtimes deno --impersonate="" -P "home:downloads" -P "temp:work" \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
تأكد من أن كلا الدليلين لديه مساحة كافية؛ قد تتطلب أنظمة الملفات المختلفة نسخة.

بالنسبة للمجموعات طويلة الأمد ، تقرر ما إذا كانت أسماء الفيل يجب أن تكون مفاتيح التطبيق القابلة للقراءة للإنسان أو مستقرة. يمكن تغيير أسماء القنوات والألقاب. Channel/video IDs هي مفاتيح أفضل للتكرار، مع الحقول الوصفية التي يتم الاحتفاظ بها في البيانات الميتا.

الكوكيز وطرق التشغيل

استخدم ملف تعريف المتصفح الذي لديه إمكانية الوصول إليه
python -m yt_dlp --js-runtimes deno --impersonate="" \
  --cookies-from-browser "chrome:Profile 1" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
استبدال الملف الشخصي 1 بملف تعريف المتصفح الحقيقي الخاص بك.استخدم ملفات تعريف الجلسة فقط عند الحاجة، والحفاظ عليها خصوصية.
اقرأ ملف الكوكي الخاص الحالي
python -m yt_dlp --js-runtimes deno --impersonate="" --cookies private/youtube-cookies.txt \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
يتطلب تنسيق ملف الكوكيز Netscape.A JSON export is not equivalent.
استخدام Deno قابل للتنفيذ خارج PATH العامل
python -m yt_dlp --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
استبدال المسار مع دينو الثنائي المثبتة لعملك.

التشخيص والتحقق

فحص استخراج نظيف
python -m yt_dlp --js-runtimes deno --impersonate="" --ignore-config --verbose --simulate \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
يزيل إعدادات الافتراضية ويحفظ أي وسائل الإعلام. لا يزال يجعل طلبات الاستخراج ولا يثبت أن نقل سيكون ناجحا.
التقاط سجل التشخيص الخاص
python -m yt_dlp --js-runtimes deno --impersonate="" --ignore-config --verbose --simulate \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw" > diagnostic.log 2>&1
يغير إعادة توجيهات القائمة cookie/header، وتصديق البروكسي، وتوقيع عناوين URL قبل المشاركة.
فحص التدفقات المتوقعة ومدة
ffprobe -v error -show_entries format=duration,size:stream=codec_type,codec_name,width,height -of json "YOUR_OUTPUT_FILE"
استخدم المسار النهائي، بعد المعالجة. ffprobe يقرأ الأوراق؛ لا يزين كل إطار.
تخفيف الملف المحفوظ دون إنشاء النتيجة
ffmpeg -v error -i "YOUR_OUTPUT_FILE" -f null -
فحص أعمق يقرأ الملف بأكمله.تحقق من حالة الخروج والرسائل.
تحديث حزمة Python والتحقق من إصدارها
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version