1. ثبّت yt-dlp
Homebrew هو الطريق الأقل مقاومة، ويثبّت الأداتين في سطر واحد.
brew install yt-dlp ffmpeg
ومن دون Homebrew، يبقي pipx على yt-dlp في بيئته الخاصة كي لا يصطدم بأي شيء آخر ثبّته عبر Python.
pipx install yt-dlp
تجنّب pip install المجرّد داخل Python الخاص بالنظام: فإصدارات macOS الحديثة تقاوم ذلك، وحين ينجح فإنه يميل إلى الانكسار لاحقًا لأسباب لا علاقة لها بالموضوع.
2. ثبّت ffmpeg
مضمّن أعلاه إن كنت استخدمت Homebrew. وإلا فثبّته على حدة — فالدمج واستخراج MP3 والتضمين كلها تعتمد عليه.
brew install ffmpeg
3. تأكد أنه نجح
yt-dlp --version ffmpeg -version
إن لم تجد الصدفة yt-dlp بعد التثبيت عبر pipx، فشغّل pipx ensurepath وافتح طرفية جديدة.
كوكيز Safari
يحتاج --cookies-from-browser safari إلى صلاحية الوصول الكامل للقرص للطرفية لديك، وتُمنح من System Settings ← Privacy & Security. ومن دونها تفشل القراءة بخطأ صلاحيات لا يذكر هذا الإعداد أصلًا. أما Chrome و Firefox فيعملان من دونها.
التحديث
brew upgrade yt-dlp # Homebrew pipx upgrade yt-dlp # pipx