دليل إعداد خطوة بخطوة لـ Windows وmacOS وLinux.
yt-dlp هو مُحمّل وسائط قوي بسطر الأوامر (فرع مُصان بنشاط من youtube-dl) يتيح لك تحميل الفيديو والصوت من آلاف المواقع. بما أنه يعمل في الطرفية، فليس لديه واجهة رسومية أصلية.
لتحميل فيديوهات عالية الجودة (1080p، 4K، إلخ) أو استخراج صوت MP3، يجب تثبيت FFmpeg. بالإضافة لذلك، يُوصى بشدة بتثبيت بيئة تشغيل JavaScript مثل Deno لتجاوز اختناق السرعة وحظر الروبوتات في YouTube. أدناه الدليل الكامل لإعداد هذه الأدوات.
لا تريد تثبيت برامج؟ يمكنك تشغيل أي أمر مباشرة في وحدة التحكم عبر الإنترنت بدون أي إعداد.
Windows 10 (1809+) وWindows 11 يتضمنان Windows Package Manager (winget) افتراضياً. يدير التثبيت والمسارات والتحديثات تلقائياً.
winget install yt-dlpللمستخدمين المتقدمين الذين يستخدمون مديري حزم سطر الأوامر على Windows.
scoop install yt-dlpchoco install yt-dlpتحميل الملف التنفيذي المستقل مباشرة.
C:\yt-dlp\، وانقل yt-dlp.exe المُحمّل إليها.
C:\yt-dlp، ثم انقر OK في جميع النوافذ.Homebrew هو مدير الحزم القياسي لـ macOS. يحل جميع التبعيات تلقائياً، بما في ذلك Python وFFmpeg.
brew install yt-dlpبدلاً من ذلك، يمكنك تثبيت yt-dlp باستخدام مدير الحزم MacPorts.
sudo port install yt-dlpتحميل الملف المُجمّع مباشرة في مسار التنفيذ المحلي.
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlpاستخدام مدير pip لـ Python يضمن حصولك على أحدث التحديثات لسكريبتات استخراج الفيديو مباشرة.
python3 -m pip install -U yt-dlpثبّت yt-dlp عبر مدير حزم توزيعة Linux الخاصة بك.
sudo apt update && sudo apt install yt-dlpsudo pacman -S yt-dlpsudo dnf install yt-dlpتحميل ملف Linux المستقل مباشرة في مسار الملفات التنفيذية المحلي.
sudo wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlpFFmpeg هي مكتبة وسائط مفتوحة المصدر يستخدمها yt-dlp لدمج مسارات الفيديو عالي الدقة (1080p، 4K) والصوت المنفصلة، أو لاستخراج الصوت كـ MP3. بدون FFmpeg، سيحمّل yt-dlp فقط تدفقات 720p أو أقل مع صوت مدمج.
ثبّت FFmpeg عبر winget بأمر واحد:
winget install Gyan.FFmpegبدلاً من ذلك، قم بتنزيل النسخ البرمجية من Gyan.dev، وفك الضغط، وأضف مجلد bin إلى متغير البيئة PATH الخاص بك.
إذا كنت تستخدم Homebrew، يتم التثبيت تلقائياً. للتثبيت اليدوي:
brew install ffmpegثبّت عبر مدير حزم نظامك:
Debian / Ubuntu:sudo apt install ffmpegsudo pacman -S ffmpegDeno هو بيئة تشغيل JavaScript حديثة. يستخدم yt-dlp Deno لتنفيذ خوارزميات فك تشفير التوقيع المبنية على JavaScript في YouTube. تثبيت Deno يساعد في تجاوز اختناق سرعة التحميل وحظر كشف الروبوتات "n-challenge".
ثبّت Deno عبر winget بأمر واحد:
winget install DenoLand.Denoبدلاً من ذلك، استخدم Scoop: scoop install deno
ثبّت Deno عبر Homebrew:
brew install denoثبّت Deno باستخدام السكريبت الرسمي:
curl -fsSL https://deno.land/install.sh | shتأكد من تثبيت unzip وcurl قبل تشغيل هذا السكريبت.
بعد التثبيت، افتح الطرفية (PowerShell أو موجه الأوامر أو Terminal.app) وتحقق من عمل كل شيء بتشغيل أمر فحص الإصدار.
نفّذ أمر الاستعلام عن الإصدار في طرفيتك:
yt-dlp --versionإذا تم التثبيت بنجاح، سيطبع رقم إصدار بتاريخ الإصدار مثل:
2026.06.18إذا ظهر "الأمر غير موجود"، تأكد من إعادة تشغيل الطرفية أو التحقق من إضافة المجلد المحتوي على yt-dlp بشكل صحيح إلى متغير البيئة PATH.
تواجه مشاكل؟ إليك حلول أكثر أخطاء yt-dlp شيوعاً على Windows وmacOS وLinux.
yt-dlp ليس في PATH نظامك. إذا ثبّته عبر winget أو Homebrew أو pip، ببساطة أغلق وأعد فتح الطرفية — يتم تحديث PATH فقط للجلسات الجديدة.
yt-dlp.exe يدوياً، تحتاج لإضافة مجلده إلى متغير البيئة PATH. انظر خطوات إعداد PATH المفصلة أعلاه.
yt-dlp --cookies-from-browser chrome "URL"winget install ffmpegyt-dlp -Uwinget upgrade yt-dlp أو brew upgrade yt-dlp).
yt-dlp -U)، حيث يتم تحديث طرق تجاوز الاختناق بشكل متكرر.
yt-dlp.exe مبني باستخدام PyInstaller الذي يجمع مفسر Python في ملف تنفيذي واحد. برامج مكافحة الفيروسات غالباً تُنبّه على حزم PyInstaller لأن نفس تقنية التغليف تستخدمها بعض البرمجيات الخبيثة — لكن yt-dlp نفسه آمن تماماً.
winget install yt-dlp (الحزم المعتمدة من Microsoft لا يتم تنبيهها).
YouTube ومنصات الفيديو الأخرى تحدّث بروتوكولات البث بشكل متكرر، مما قد يُعطّل الإصدارات القديمة من yt-dlp. حافظ على تحديث التثبيت المحلي لحل أخطاء الاستخراج تلقائياً.
إذا حمّلت الملف مباشرة أو ثبّته عبر pip، شغّل أمر التحديث المدمج في طرفيتك:
yt-dlp -UWindows (winget): winget upgrade yt-dlp
macOS (Homebrew): brew upgrade yt-dlp
Python (pip): python3 -m pip install --upgrade yt-dlp
ابدأ بهذه الأوامر الأساسية في طرفيتك:
| الهدف | أمر | إجراءات |
|---|---|---|
| تحميل فيديو (أفضل جودة) | yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
| استخراج صوت MP3 | yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
نعم، yt-dlp آمن. إنه مشروع مفتوح المصدر 100% مرخص تحت Unlicense، مستضاف على GitHub مع 100,000+ نجمة ومئات المساهمين النشطين. كل سطر من الكود قابل للتدقيق العام.
winget لتجنب ذلك.إذا كنت تفضل عدم تشغيل ملفات تنفيذية محلياً، وحدة التحكم عبر الإنترنت يشغّل yt-dlp على خوادمنا — لا يتم تثبيت أي شيء على جهازك.
100K+ ⭐
مفتوح المصدر على GitHub
شغّل أوامر yt-dlp مباشرة على خادمنا. استخدم واجهة الويب لتحميل قوائم التشغيل وتسجيل البث واستخراج الصوت فوراً.