تخطَّ إلى المحتوى
yt-dlp

تنزيل ترجمات يوتيوب — مولّد أوامر yt-dlp

ابنِ أمر yt-dlp الذي يحفظ الترجمات كملف ‎.srt دون تنزيل الفيديو.

اختياري. اتركه فارغًا وسينتهي الأمر بكلمة URL لتضع مكانها ما تريد.

الأمر الخاص بك

yt-dlp --write-subs --convert-subs srt --sub-langs en --write-auto-subs --no-playlist -s 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
الأساسيات

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

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

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

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

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

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

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

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

الصوت

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

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

الترجمات

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

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

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

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

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

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

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

المقاطع والفصول
خيارات متقدمة (2)

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

البيانات الوصفية والغلاف
خيارات متقدمة (3)
SponsorBlock

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

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

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

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

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

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

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

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

عوامل التصفية
خيارات متقدمة (5)

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

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

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

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

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

الشبكة

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

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

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

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

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

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

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

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

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

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

البث المباشر
خيارات متقدمة (2)

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

حلول بديلة
خيارات متقدمة (3)

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

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

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

الإخراج والتشخيص
خيارات متقدمة (2)
إعادة تعيين

الترجمات من دون الفيديو

ينفّذ وضع المحاكاة كل شيء عدا كتابة ملف الفيديو، فتحتفظ بالترجمات وتتخطى التنزيل. والتحويل إلى SRT يحتاج ffmpeg.

إن لم يظهر شيء فالأرجح أن الفيديو بلا ترجمة بشرية — فالتعليقات المولَّدة آليًا مفتاح منفصل، ومن دونه لا يجد yt-dlp شيئًا ولا يقول شيئًا.

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

اختيار اللغة هو حيث تصبح تنزيلات الترجمات دقيقة الشعيرات. --sub-langs en يأخذ المسار الموسوم «en» بعينه؛ وen-orig اسم يوتيوب للمولَّد آليًا، وen.* بوصفه نمطًا يصطاد الاثنين مع المتغيرات الإقليمية. ولغات متعددة تأخذ قائمة مفصولة بفواصل. وإن كان في الفيديو مساران بشري وآلي للغة واحدة فهما مدخلان مستقلان، وتنزيل الاثنين نتيجة مشروعة لا خطأ.

الصيغ تهم حين يذهب ملف الترجمة إلى برنامج تحرير: SRT هي صيغة التبادل الآمنة، وVTT يحمل التنسيق الذي يعرضه مشغّل الويب، وصيغ يوتيوب الخاصة JSON3/_SRV موجَّهة للآلات. ومفتاح التحويل إلى SRT يتكفل بالحالة الشائعة، ويحتاج ffmpeg، ويفقد التنسيق عمدًا — فبرامج التحرير تريد نصًا لا ترميزًا. وإن بدا الخرج فارغًا فتحقق من وجود الملف قبل أن تفترض أن التحويل فشل: فملف SRT بصفر بايت معناه أن المسار نفسه كان فارغًا.

التعليقات المولَّدة آليًا تستحق تحذيرًا: فهي نسخ آلي، بكل ما يتضمنه ذلك — متجانسات مخطئة، ولا ترقيم، وأسماء مشوَّهة. ولفيديو بلغة تقرؤها فهي فهرس بحث؛ ولأي شيء ستقتبسه فالمسار البشري (إن وُجد) هو الجدير بالاحتفاظ. وينال البث المباشر تعليقات آلية حيًّا تُحفظ بعد انتهاء البث فقط — فخيارات تسجيل البث المباشر على هذا الموقع للصورة، وتنزال تعليقات بث منتهٍ بالخيارات العادية للترجمات.

الأسئلة الشائعة

كيف أنزّل الترجمات من دون الفيديو؟
اختر خيار ‎.srt وفعّل المحاكاة، فتتخطى كتابة ملف الفيديو مع الاحتفاظ بالترجمات.
لماذا لم يظهر ملف ترجمة؟
الأرجح أن الفيديو بلا ترجمة بشرية. فعّل الترجمات المولَّدة آليًا للحصول على التي أنتجتها الآلة.
كيف أختار لغات الترجمة؟
افصل بينها بفواصل، مثل en,ar. استخدم all لكل المتاح، أو نمطًا مثل ‎en.* لكل صيغ الإنجليزية.
هل أحصل على SRT بدل VTT؟
نعم — خيار ‎.srt يحوّلها، وهذا يحتاج ffmpeg.