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

مولّد أوامر yt-dlp لمنصة X (تويتر)

ابنِ أمر yt-dlp لفيديو على X، بأسماء ملفات متوقَّعة وبالخيارات التي تتطلبها المنشورات الحساسة.

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

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

yt-dlp --merge-output-format mp4 --no-playlist -o '%(uploader_id)s - %(id)s.%(ext)s' https://x.com/user/status/1234567890
الأساسيات

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

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

يحدّد سقف الارتفاع. سيظل 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)
إعادة تعيين

ملاحظات حول X

تعمل روابط x.com وtwitter.com كلتاهما. وما يسمّيه الناس GIF على X هو في الحقيقة فيديو MP4 قصير، فيُنزَّل كأي فيديو آخر؛ حوّله بعد ذلك إن كنت تريد GIF فعليًا.

المنشورات ذات المحتوى الحساس تتطلب جلسة مسجَّلة الدخول مفعَّلًا فيها الإعداد المقابل. والقالب الافتراضي يسمّي الملفات باسم الكاتب ومعرّف المنشور، مما يُبقي المجلد سهل التصفح.

غيّرت X واجهة API الخاصة بها عدة مرات، والنتيجة العملية أن إصلاحات المستخرِجات تصل في تحديثات yt-dlp خلال أيام — فالتثبيت الأقدم من بضعة أسابيع هو موضع معظم بلاغات «X معطّل» فعلًا. حدِّث قبل التنقيح: yt-dlp -U. ووصول الضيوف يأتي ويذهب؛ وحين يُسحب تصبح الجلسة المسجَّلة الدخول مع الكوكيز هي الطريق العامل، وهي أيضًا الطريق الوحيد إلى الوسائط الحساسة.

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

يقدّم X الفيديو أجزاء HLS مع بديل MP4 في معظم الحالات، فالدمج شائع وffmpeg أول تبعية تفحصها. ومنشورات «GIF» هي الاستثناء الجدير بالمعرفة: تصل MP4 كسائر الأشياء، وتحويلها بعدها إلى GIF حقيقي عمل ffmpeg لا yt-dlp — وملف WebM متكرر الدورة أقرب عادة إلى مقصود المرسل على أي حال.

المنشورات المقيَّدة بالعمر والحساسة هي الجدار الصلب: الإعداد في الحساب لا في الأمر. سجّل الدخول عبر المتصفح مرة، وفعّل إعداد الوسائط الحساسة، وسلّم الكوكيز، ويعمل الأمر — فلا يوجد التفاف بلا كوكيز، لأن X يفحص الجلسة على الخادم. والمنشورات المحذوفة تسلك سلوكها في أي مكان: ما ذهب ذهب، والمرايا التي كانت تحتفظ بنسخ أُقفلت منذ سنوات.

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

لماذا يفشل منشور مقيَّد بالعمر على X؟
منشورات المحتوى الحساس تتطلب جلسة مسجَّلة الدخول. استخدم ‎--cookies-from-browser بحساب مفعَّل فيه ذلك الإعداد.
كيف أنزّل صورة GIF من X؟
هي فيديوهات MP4 لا صور GIF، وتُنزَّل كأي فيديو آخر. حوّلها بعد ذلك إن كنت تحتاج GIF فعليًا.
هل يمكنني اختيار جودة الفيديو على X؟
نعم. تنشر X عدة نسخ؛ حدِّد سقف الارتفاع من قائمة الجودة أو اسردها أولًا بالأمر ‎-F.