1. ثبّت yt-dlp
winget يأتي مع Windows 10 و 11 ويتولى أمر PATH نيابةً عنك، وهو تحديدًا الجزء الذي يخطئ فيه الناس عند التثبيت اليدوي.
winget install yt-dlp.yt-dlp
وإن كنت تستخدم Scoop أو Chocolatey أصلًا فكلاهما مناسب بالقدر نفسه:
scoop install yt-dlp choco install yt-dlp
الطريق اليدوي هو ملف yt-dlp.exe واحد من صفحة الإصدارات الرسمية. ضعه في مجلد موجود ضمن PATH لديك — فوضعه على سطح المكتب يعمل فقط ما دامت الطرفية صادف وجودها في ذلك المجلد، وهذا هو السبب المعتاد لرسالة "yt-dlp is not recognized".
2. ثبّت ffmpeg
ينزّل yt-dlp من دون ffmpeg، لكن كل ما هو مثير للاهتمام يحتاج إليه: دمج الفيديو والصوت المنفصلين، واستخراج MP3، وتضمين الترجمات أو الصور المصغرة، واقتطاع المقاطع. ثبّته الآن لا بعد أول إخفاق محيّر.
winget install Gyan.FFmpeg
3. تأكد أنه نجح
افتح طرفية جديدة — فالمفتوحة أصلًا ما زالت تحمل PATH القديم — ثم شغّل:
yt-dlp --version ffmpeg -version
ظهور رقمَي إصدار يعني أنك انتهيت.
الاقتباس على Windows
لا يتعامل PowerShell و cmd مع الاقتباس كما يفعل bash، وأمر منسوخ من شرح موجّه لـ Linux ينكسر غالبًا لهذا السبب بالضبط. ففي PowerShell تكون علامة الاقتباس المفردة حرفية — وهي الخيار الأأمن لمحدِّد صيغة أو قالب إخراج. وفي cmd استخدم علامتي اقتباس مزدوجتين. وفي ملف .bat يجب مضاعفة كل %.
yt-dlp -o '%(title)s.%(ext)s' URL # PowerShell yt-dlp -o "%(title)s.%(ext)s" URL # cmd yt-dlp -o "%%(title)s.%%(ext)s" URL # inside a .bat file
ومفتاح الصدفة في المولّد ينتج الشكل الصحيح لكل حالة من هذه، فتستطيع النسخ من دون إعادة كتابة أي شيء.
التحديث
ملف yt-dlp.exe المستقل يحدّث نفسه بـ yt-dlp -U. وإن كان مثبّتًا عبر winget أو Scoop أو Chocolatey فحدّثه بالأداة نفسها — إذ سيرفض التحديث الذاتي، لأن الملف ملك لمدير الحزم.