# كيفية استخدام yt-dlp

دليل للعمل اليومي على Linux يشمل تثبيت الإصدار الليلي، واختيار الصيغ، وجلب الترجمة، وإعداد مجموعات البيانات، واستئناف التجميع.

مرجع كانوني: https://flashdata.dev/ar/docs/guides/how-to-use-yt-dlp
Reviewed: 2026-11-13 by FlashData

- [إعداد الأدوات](https://flashdata.dev/ar/docs/guides/how-to-use-yt-dlp/reference.md#install) — Python و FFmpeg و JavaScript
- [اختيار الإنتاج](https://flashdata.dev/ar/docs/guides/how-to-use-yt-dlp/reference.md#formats) — الفيديو والصوت والقبعات
- [تكرار مجموعة](https://flashdata.dev/ar/docs/guides/how-to-use-yt-dlp/reference.md#repeatable) — ملاحظة، تصحيح، ورسائل
- [إصلاح خطوة فاشلة](https://flashdata.dev/ar/docs/guides/how-to-use-yt-dlp/reference.md#maintain) — العثور على التشخيص الصحيح

<a id="install"></a>

## تثبيت أدوات التنزيل اليومية


**جهّز الإصدار الليلي وDeno وFFmpeg.** استخدم بيئة Python افتراضية للمشروع وفعّل محاكاة المتصفح بواسطة `--impersonate=""`. تعرض الخطوات أدناه إعداد Linux، ويمكنك فتح تبويب macOS أو Windows لعرض الخطوات المناسبة.

**Linux**

مثال Ubuntu / Debian مع Python 3.11+. تثبيت أدوات النظام، وخلق بيئة مشروع افتراضي، ثم تثبيت الليلة الحالية ومكملاتها.


**إعداد Linux**

```bash
sudo apt-get update
sudo apt-get install -y python3 python3-venv ffmpeg aria2 curl unzip
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
curl -fsSL https://deno.land/install.sh -o /tmp/install-deno.sh
sh /tmp/install-deno.sh
export PATH="$HOME/.deno/bin:$PATH"
deno --version
python -m yt_dlp --version
```


**macOS**

مع Homebrew مثبتة، استخدمها لـ Python، Deno، FFmpeg و aria2. حافظ على yt-dlp نفسه في بيئة المشروع بحيث يكون الأمر التحديث الليلي هو نفسه كما هو الحال على Linux.


**ماكوس إعداد**

```bash
brew install python deno ffmpeg aria2
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
python -m yt_dlp --version
```


**Windows · PowerShell**

قم بتثبيت Python 3.11+ و Deno و FFmpeg ، ثم افتح محطة جديدة. استخدم المترجم البيئي مباشرة إذا قفل PowerShell تنشيط. aria2 اختياري؛ قم بتثبيته بشكل منفصل إذا كنت تستخدم وصفة التحميل الخارجية.


**بيئة ويندوز**

```powershell
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
ffmpeg -version
.\.venv\Scripts\python.exe -m yt_dlp --version
```


| أداة | ماذا يفعل | تحقق |
| --- | --- | --- |
| Python 3.11+ | يعمل حزمة Python وأمثلة في هذه السلسلة. | python --version |
| آخر yt-dlp ليلاً + الافتراض,curl-cffi إضافات | مستخلص YouTube الحالي، يتماشى مع حل EJS ودعم تصفية المتصفح. | python -m yt_dlp --version |
| FFmpeg و ffprobe | انضم البث، وتحويل الصوت، وقطع مقاطع الفيديو، ومراجعة وسائل الإعلام المحفوظة. | ffmpeg -version / ffprobe -version |
| دينا 2.3+ (مطلوب في هذا التدفق) | يتوفر تحديات يوتيوب.تثبيتها على كل عامل وليس فقط آلة تطويرك. | deno --version |

**تثبيت إجراءات التنفيذ أيضا.** `[default]` يوفر كتابات EJS؛ Deno منفصلة. FFmpeg و ffprobe يجب أن تكون أيضا على PATH العامل.

**تحقق من خط البازلاء الكامل**

```bash
deno --version
ffmpeg -version
ffprobe -version
python -m pip show yt-dlp yt-dlp-ejs curl-cffi
python -m yt_dlp --list-impersonate-targets
```

يجب أن يدرج الأمر النهائي أهداف المتصفح المتاحة.إذا لم تكن الأهداف متاحة، فاحرص على curl-cffi مثبتة في هذا البيئة الافتراضية الدقيقة.

**اختبار استخراج مع Deno و Impersonal Browser**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose \
  --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

فحص ساعات تشغيل JS وخطوط طلب-معالج.محاكاة اختبار استخراج؛ اتبعها مع نقل حقيقي.

وتشمل خطة أساسية التشغيل لـ FlashData --impersonate=": تسمح لـ curl-cffi باختيار بصمات الأصابع المتاحة للمتصفح. هذا يغير بصمات الطلب؛ فإنه لا يوفر ملفات تعريف الارتباط، وحل تحديات جاكرتا أو تغيير IP الخروج. إذا تباطأ هذا الخيار مسار العمل أو يقدم أخطاء، تكرار نفس اختبار الفيديو الواحد دون ذلك والحفاظ على تكوين العمل.

> **خدمة يحتاج إلى مسارها الخاص**
> يضع جهاز تثبيت Deno عادة الثنائي في ~/.deno/bin. لا يمكن العثور على شل التفاعلية على أنه يدل على أن خدمة نظام أو حاوية أو عمل كرون. إدخال العامل PATH أو pass --js-runtimes deno:/absolute/path/to/deno. استخدم مسار Python في البيئة الافتراضية في أمر الخدمة.

- [التثبيت الرسمي](https://github.com/yt-dlp/yt-dlp/wiki/Installation)
- [FFmpeg تحميل](https://ffmpeg.org/download.html)
- [إعداد Deno](https://docs.deno.com/runtime/getting_started/installation/)
- [YouTube Runtime إعدادات](https://github.com/yt-dlp/yt-dlp/wiki/EJS)

<a id="verify-install"></a>

### تحقق من الإفراج قبل وضعها على عامل


احصل على إجراءات من صفحة الإصدار الرسمية للمشروع، أو تثبيت حزمة Python من مصدر الحزمة المنشورة. إذا قمت بتنزيل ثنائي منفصل، قارن SHA-256 مع اسم الملف المطابق في هذا الإصدار SHA2-256SUMS. تسجيل الإصدار والرقابة مع صورة العامل الخاص بك حتى تتمكن من تحديد بالضبط ما كان يمر.

**Linux**


**هش الملف المنسد**

```bash
sha256sum yt-dlp
```


**macOS**


**هش الملف المنسد**

```bash
shasum -a 256 yt-dlp_macos
```


**Windows**


**هش الملف المنسد**

```powershell
Get-FileHash -Algorithm SHA256 .\yt-dlp.exe
```


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

معالجة ملفات التكوين المشتركة كرمز للتحقق: خيارات مثل --exec يمكن إطلاق الأوامر، والمكونات الإضافية إضافة رمز إلى عملية التنزيل. الحفاظ على ملفات تعريف المتصفح، وملفات التحقق من البروكسي، وتوقيع عناوين URL خارج أمثلة التكوين والتقارير التشخيصية.

- [الإصدارات الرسمية والرقابة](https://github.com/yt-dlp/yt-dlp/releases)

<a id="first-download"></a>

## تحميل الفيديو واحد


**استخدم مقطع فيديو قصير أولاً.** اكتب عنوان URL، أضف `--no-playlist`، وأسم الملف بـ ID الفيديو.

**فيديو واحد، مجلد إخراج واحد**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -P downloads \
  -o "%(id)s.%(ext)s" --print after_move:filepath \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

الطريق المطبوع هو الملف بعد الانضمام وبعد المعالجة.فتح هذا الطريق؛ لا تفترض أن الملف سوف ينتهي في .mp4.

دون إعادة تشكيل، yt-dlp يختار التدفقات المتاحة المفضلة. مصادر عالية الجودة غالبا ما يكون لها تسربات الفيديو والصوت منفصلة، لذلك اثنين من التحويلات تليها مزيج FFmpeg طبيعية. قد تظهر ملفات متوسطة وملف .part بينما يتم تشغيل العمل.

> **لا تضع في ضغط التمديد**
> حفظ %(ext)s في قوالب الناتج. اسم WebM تدفق file.mp4 فقط تغيير اسمه. اختيار تنسيق، إعادة التدوير، وتحويل يقرر ما هو داخل الملف.

<a id="formats"></a>

## اختيار الجودة والرموز


**تحقق من تنسيقات هذا الفيديو**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

**اختر سياسة وليس علامة تنسيق نسخة.** تحقق من الدقة والترميزات ومسارات audio/video منفصلة.

| الخيار أو الخيار | معنى | متى تستخدمها |
| --- | --- | --- |
| بـ + بـ | اختر بث الفيديو وحده وبث الصوت وحده؛ FFmpeg يجمع بينهما. | تحتاج إلى كلا المسارات ويمكن دمجها محليا. |
| A/B | حاول اختيار A ثم B إذا لم يكن A متاحًا. | تعريف سحب صريح بدلاً من افتراض أن كل مصدر له نفس التنسيقات. |
| [height<=1080] | استبعاد البث فوق 1080 بكسل عالية. | الارتفاع الشديد هو شرط. |
| -S res:1080 | تفضل القرار حتى 1080؛ يمكنك اختيار قرار أكبر عندما لا يوجد قرار أدناه. | 1080p هو تفضيل بدلا من سقف صلب. |
| --merge-output-format mp4 | اختر حاوية عند دمج تدفقات منفصلة. | لقد اخترت بالفعل التدفقات المتوافقة. لا يتحول إلى رموز. |

**الحفاظ على المنسوجات المصدرية، مع سقف صلب 1080p**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv*[height<=1080]+ba/b[height<=1080]" -P downloads \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

هذا يمكن أن ينتج WebM، MP4 أو حاوية أخرى مدعومة. فإنه يفشل إذا لم يلتقي أي شكل السقف؛ فإنه لا ينزيل بصمت 4K.

بالنسبة للمحرر أو الستار الترويجي الذي يتطلب على وجه التحديد H.264 الفيديو و AAC الصوت، تصفية تلك الكوديك والاندماج في MP4. MP4 هو حاوية: يمكن أن يحتوي تدفق في حاوية MP4 على رمز لا يزال لا يمكن تفكيك التطبيق.

**طلب H.264 + AAC، تصل إلى 1080p**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv[vcodec^=avc1][height<=1080]+ba[acodec^=mp4a]/b[vcodec^=avc1][acodec^=mp4a][height<=1080]" \
  --merge-output-format mp4 -P downloads "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

إذا لم تكن المشتركين المطلوبين متاحة، فإن هذا المختار الصارم يفشل.قرر ما إذا كان قبول المشتركين المصدرين المختلفين أو ترانسكود؛ لا تُزيل المطالبة عن طريق الحادث.

إعادة التدوير يتدفق دون إعادة تشفيرها. يتغير التشفير في الرمز ويستهلك CPU في حين يتغير الجودة المحتملة. استخدم --remux-video عندما تناسب البثات بالفعل حاوية الهدف؛ استخدم تحويل عمد FFmpeg عندما يتطلب جهاز تفكيك الدفق السفلي ترميزات مختلفة.

<a id="audio"></a>

## حفظ الصوت أو MP3


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

**الحفاظ على أفضل البث الصوتي المتاح**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -P audio \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

توقع حاوية المصدر والرمز، وعادة M4A/AAC أو WebM/Opus.

**تحويل الصوت إلى MP3**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
  --audio-format mp3 --audio-quality 0 -P audio -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

FFmpeg --audio-quality 0 يختار إعداد أفضل متغير؛ استخدم معدل بيت مثل 192K عندما تتطلب مواصفات التدفق السفلي واحد.

<a id="sidecars"></a>

## حفظ الملاحظات والبيانات الميتا


مجموعة مفيدة تحتاج إلى أكثر من اسم الفيل. احفظ بطاقات الفيديو، ودرجات URL المصدر، والعناوين، والفترات، والملاحظات المتاحة حتى تتمكن من البحث عن المجموعة وتتبع الأصول مرة أخرى إلى مصدرها. ابدأ من خلال إدراج مسارات العلامة؛ طلب en لا يعني أن كل فيديو لديه مسار باللغة الإنجليزية.

**فحص المقبرات، ثم حفظ المسارات الإنجليزية دون وسائل الإعلام**

```bash
python -m yt_dlp --list-subs "https://www.youtube.com/watch?v=jNQXAC9IVRw"
python -m yt_dlp --skip-download --write-subs --write-auto-subs --sub-langs "en.*" \
  --sub-format "vtt/best" -P captions -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

--write-subs يختار العناوين الفرعية المقدمة؛ --write-auto-subs يسمح أيضًا بالقبعات التلقائية.

**وسائل الإعلام مع الميتايدات وقطعة صغيرة**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist --write-info-json \
  --write-thumbnail -P downloads -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

الملف .info.json هو بيانات التشغيل التفصيلية، وليس استجابة API العامة النظيفة. يمكن أن تشمل عناوين URL المتأخرة وملفات متعلقة بالطلب. احفظ اللوحة الجانبية الكاملة مع المجموعة، وتصدير فقط الحقول التي يحتاجها نظام التدفق السفلي الخاص بك. إذا كنت بحاجة إلى SRT بدلاً من VTT، أضف --convert-subs srt وتأكد FFmpeg متاحة.

<a id="dataset"></a>

## بناء عنصر من مجموعة بيانات AI


لتمرير مجموعة التدريب ، تقرر وسائل الإعلام والنص الناتج معا. متطلبات مشتركة هي أفضل الفيديو والصوت المتاحة، جنبا إلى جنب مع MP4، مع التصوير المكتشف في الوقت المناسب ومتى البيانات الاستخراج التي يتم الاحتفاظ بها تحت نفس الهوية الفيديو. سقف القرار المفيد للملاحظات السابقة هو عادة الافتراض الخاطئ لمجموعة بيانات الجودة المصدرية.

**تحميل واحد كامل مجموعة البيانات**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bestvideo+bestaudio/best" \
  --merge-output-format mp4 --remux-video mp4 \
  --write-info-json --write-subs --write-auto-subs \
  --sub-langs "en" --sub-format "vtt/best" \
  --sleep-subtitles 5 --concurrent-fragments 1 \
  -P dataset -o "%(id)s/%(id)s.%(ext)s" \
  --print after_move:filepath "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

مثال باش. FFmpeg يجمع بين التدفقات منفصلة؛ --remux-video يغطي أيضا سحب التدفق المشترك. استخدم علامة اللغة الدقيقة من --list-subs؛ استبدال مع اللغة التي تحتاجها مجموعة البيانات.

ابدأ باللغة المكتوبة بالضبط. في فحصنا الحي ، تم اختيار en * ، en - ، en - ، en - ، و en - ، و العودة إلى المسار الثالث 429 قبل أن يبدأ تنزيل وسائل الإعلام. خطأ في التوقيع يمكن أن يوقف البند في هذه المرحلة. بعد انخفاض البارد، إعادة فقط المسار المطلوب، أو تقسيم وسائل الإعلام وموظفات التوقيع إذا كان مجموعتك يجب أن تبقى وسائل الإعلام الإدخال يتحرك.

يتيح /Best Fallback تدفقًا مشتركًا video/audio عندما لا تكون المسارات منفصلة متاحة. إزالة هذا السقوط إذا كان عقد جمعك يتطلب مصادر أفضل الفيديو والفيديو منفصلة. MP4 لا يعني H.264: يحتفظ هذا الوصفة بالشرائح المصدرية المختارة. استخدم المختار الصارم H.264/AAC أعلاه إذا كان مدرع التدريب الخاص بك يتطلب تلك الرموز، أو ترانسكود كخطوة منفصلة، مسجلة.

**الملفات المتوقعة عندما يكون هناك مسار الإنجليزية**

```text
dataset/VIDEO_ID/
  VIDEO_ID.mp4
  VIDEO_ID.info.json
  VIDEO_ID.en.vtt
```

لا يتم إنشاء ملف التعليق عندما يكون المسار المطلوب غير متاحًا؛ لا تضع علامة على تغطية النص كاملة فقط لأن MP4 قد انتهى.

| الاحتياج | قرار جمع |
| --- | --- |
| أعلى جودة المصدر المتاحة | استخدم Bestvideo+bestaudio، واحتفظ بالرموز المصدرية والتحقق من التدفقات المدمجة مع ffprobe. |
| النص المكتوب | حفظ VTT/SRT القطاعات واللغة بجانب معرف الفيديو.تخفيف النص المسطح الوقت اللازم للتصحيح. |
| التسميات التوضيحية المفقودة | تسجيل النص المفقود صراحة.إعادة توجيه الصوت الذي تم حفظه إلى مرحلة الترجمة الخاصة بك إذا كان النص إلزاميًا. |
| كلمات مفتاحية لعدد كبير من اللغات | كل مسار إضافي يضيف طلبات ويمكن أن تلتقي 429 بغض النظر عن وسائل الإعلام. |
| إعادة توجيه + تسليم النص | استخدم ملف مجموعة بيانات منفصل ومخزن مع حالات الوسائط والميثاديتات والعلامات.لا يثبت إدخال الأرشيف أن جميع الصفحات المطلوبة موجودة. |

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

- [وصفة البيانات نفسها في Python](https://flashdata.dev/ar/docs/guides/yt-dlp-python-api/reference.md#dataset)
- [التعليقات والتحويلات 429s](https://flashdata.dev/ar/docs/guides/yt-dlp-429-too-many-requests/reference.md)

<a id="aria2"></a>

## تحسين نطاق النقل دون إزعاج IP


aria2c يمكن أن يساعد عندما يكون اتصال واحد يخضع لارتباط غير موثوق أو عالي التردد. لا يمكن إصلاح طلب لاعب رفض أو IP الخروج المسمى. أولاً، قم بتحميل الأصلي يعمل على مصدر واحد، ثم قارن وقت التحويل والأخطاء مع عدد صغير من الاتصالات aria2.

**بدءاً من اتصالين لكل نقل HTTP**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --downloader aria2c --downloader "dash,m3u8:native" \
  --downloader-args "aria2c:-x 2 -s 2 -j 1" \
  --concurrent-fragments 1 \
  -P downloads -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

تثبيت aria2 أولاً. حفظ DASH/HLS مع المتصفح الأصلي هنا بحيث يبقى منافسة القسم واضحة.

| السيطرة | ما الذي يحد من |
| --- | --- |
| aria2c -x 2 | اتصال واحد إلى خادم واحد لتحميل. |
| aria2c -s 2 | تقسيمات مطلوبة لملف واحد؛ تقسيم يعتمد أيضا على حجم الملف ودعم الخادم. |
| aria2c -j 1 | البنود المتناقضة داخل هذا aria2 الاستدعاء، وليس غيرها yt-dlp العمال. |
| --concurrent-fragments 1 | تُنزيل القطع داخل قارئ DASH/HLS الأصلي. |
| وظيفتك كوين | الفيديوهات النشطة الإجمالية التي تشارك نفس المضيف أو IP الخروج البروكسي. |

curl-cffi يقع في طلبات yt-dlp؛ لا يحدد بصمات الأصابع TLS aria2. إذا كان تنزيلات الأصلية تعمل ولكن aria2 يحصل على 403، العودة إلى الأصلية قبل تغيير إعدادات المستخرج غير ذات الصلة. الحفاظ على الاستخراج والنقل الخارجي في نفس جلسة البروكسي.

في تشغيل FlashData ، يمكن أن يؤدي زيادة التنافسية بشكل عدواني للغاية إلى بدء مسار العمل في العودة 403 على الفور. إذا حدث هذا ، توقف الوظائف الأخرى ، والعودة إلى عامل واحد وربط واحد ، ثم إعادة اختبار. لا تعوض عن طريق إضافة المزيد من aria2 الانقسامات أو سحب نفس التدفق المرفوع بالتوازي. إذا كان هذا IP لا يزال مرفوعًا عند الحمل المنخفض ، استخدم تدفق العمل 403 لتغيير IP.

**نقل المحافظين الأصليين للمقارنة**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --downloader native --concurrent-fragments 1 --limit-rate 2M \
  --sleep-requests 2 --sleep-interval 5 --max-sleep-interval 10 \
  -P diagnostics "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

2M هو كاب العرض التشخيصي، وليس الحد الأقصى لـ YouTube.

- [aria2 اتصال وخيارات الانقسام](https://aria2.github.io/manual/en/html/aria2c.html)
- [403 أمر استرداد](https://flashdata.dev/ar/docs/guides/yt-dlp-403-forbidden/reference.md#rate)
- [التحكم في معدلات البيانات الميتات والقبعات](https://flashdata.dev/ar/docs/guides/yt-dlp-429-too-many-requests/reference.md#pacing)

<a id="collections"></a>

## إعداد مجموعة


لعدد صغير من المجموعات المعروفة، قم بإنشاء UTF-8 urls.txt مع واحد URL مشاهدة لكل خط. بالنسبة لقائمة تشغيل YouTube ، قم أولاً بتسجيل هويتك في بيان. يفتتح استخراج مسطح قائمة التشغيل دون إجراء استخراج كامل لكل مقطع فيديو؛ فهي مفيدة لمراجعة نطاق، ولكن قد تفتقر إدخالاتها إلى مدة وتشكيلات وتفاصيل متوفرة.

**إنشاء قائمة تشغيل YouTube Manifesto**

```bash
python -m yt_dlp --flat-playlist --print "https://www.youtube.com/watch?v=%(id)s" \
  "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID" > urls.txt
```

استبدال YOUR_PLAYLIST_ID.تحقق urls.txt قبل بدء نقل الوسائط.تستبدل إعادة توجيه هذا المظاهر إذا قمت بتشغيله مرة أخرى.

لتجربة مجموعة، حدد عدد قليل من إدخالات قائمة التشغيل مع --playlist-items 1:5. خريطة /فيديوهات القناة هي نقطة انطلاق أكثر وضوحا للفيديوهات التي تم تحميلها من الصفحة الرئيسية القناة غير الواضحة. لا تتعامل مع أوامر القائمة على التدوين كهوية: يمكن إدخال العناصر أو إعادة الطلب أو إزالتها.

| الفلتر | الاستخدام | عواقب |
| --- | --- | --- |
| --playlist-items 1:5 | أول خمسة إدخالات في القائمة الحالية. | مفيد لحاجة صغيرة وليس نقطة التحقق المستدامة. |
| --dateafter 20260101 | الحفاظ على الإدخالات التي تم إدخالها في أو بعد يناير 1، 2026. | قد يتطلب تصفية التاريخ إزالة الفيديو. |
| --match-filters "!is_live & duration <= 1800" | مطلوب عنصر غير حي مع مدة معروفة في أقصى 30 دقائق. | لا تتوافق الإدخالات ذات المدة غير المعروفة مع هذا الفلتر الصارم. |
| --download-archive archive.txt | إزالة الهوية المصدرية التي تم تسجيلها بالفعل من خلال التحميلات السابقة. | يعمل على تغير العناوين ومواقف القائمة. |

<a id="repeatable"></a>

## إعادة جمع مجموعة بأمان


احفظ ما يلي على النحو yt-dlp-work.conf في مجلد جمعك، إلى جانب urls.txt. يحدد سياسة الإنتاج مرة واحدة، ويعطي المجموعة أرشيفها الخاص، ويحد من الانسحاب. حفظ ملفات الناتج وهذه الأرشيف معا: تسجل الأرشيف نجاح المستخرج والهوية، وليس من خلال رقم التحقق أو موقع الملف الحالي.

**yt-dlp-work.conf**

```text
# YouTube worker baseline
--js-runtimes deno
--impersonate=""
--concurrent-fragments 1

# Output policy
--no-playlist
-f "bv*[height<=1080]+ba/b[height<=1080]"
-P downloads
-o "%(channel_id)s/%(id)s.%(ext)s"
--write-info-json

# Resume and remember completed media
--continue
--download-archive archive.txt
--no-abort-on-error

# Bound each attempt and spread out work
--retries 5
--fragment-retries 5
--socket-timeout 30
--sleep-requests 1
--sleep-interval 5
--max-sleep-interval 10

# Append paths only after the final move
--print-to-file after_move:filepath completed-paths.txt
```

تكوين النص المسطح، خيار واحد لكل خط.الطرق في هذا المثال هي نسبية إلى دليل العمل.استخدم مسارات مطلقة عندما يمكن للجدول الزمني أن يبدأ في مكان آخر.

**إجراء المجموعة**

```bash
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf --batch-file urls.txt
```

--ignore-config يزيل تكوين user/system الافتراضي؛ لا يزال ملف --config-locations المورد صراحة محمولًا.

إعادة تشغيل نفس الأمر بعد انقطاع. يتم إزالة الهوية المكتملة ، وتستمر التحويلات الجزئية المتكررة حيث تم دعمها. يمكن إعادة تدوير فشل الاستخراج في المرة القادمة. الملفات .part الافتراضية هي حالة مفيدة؛ لا حذفها كخطوة عادية الانسحاب.

> **أرشيف منفصل لخروج منفصل**
> لا يميز معرف واحد في archive.txt بين MP3 و 1080p و 4K. استخدم ملفات الأرشيف المختلفة لسياسات النشر المختلفة. إذا قمت بحذف ملف الوسائط ولكن حفظ إدخاله في الأرشيف، yt-dlp لا يزال يغيب عن ذلك. إذا قمت بتحميل الملفات في وقت لاحق إلى تخزين السحابة، تسجيل النجاح التحميل منفصل عن النجاح المحلي التحميل.

--no-abort-on-error لا يزال ماضي غير متوفر إدخالات، ولكن يمكن أن لا يزال تشغيل الخروج غير صفر، وتتطلب أخطاء ما بعد المعالجة الاهتمام. تجنب إضافة --ignore-errors فقط للحصول على وظيفة خضراء: يمكن أن تعامل مع الفشل ما بعد المعالجة على أنها تنزيلات ناجحة. تحقق من السجلات والخروجات المكتملة قبل الإعلان عن مجموعة كاملة.

<a id="verify"></a>

## تحقق من الملفات النهائية


الملف completed-paths.txt هو مخزن بدء مفيد. اختبار النتيجة النهائية الحقيقية بدلاً من تدفق الفيديو المؤقت فقط. ffprobe يقرأ حاوية وتدفق البيانات الميتا؛ يمسح مرسوم التشفير منفصل المشاكل التي سيفتقدها القائمة القابلة للقراءة وحدها.

**فحص ملف واحد**

```bash
ffprobe -v error -show_entries format=duration,size:stream=codec_type,codec_name,width,height -of json "downloads/CHANNEL_ID/VIDEO_ID.mp4"
```

استبدال المسار بأحد من completed-paths.txt.تحقق من المدة المتوقعة، والمتطلبات audio/video التيارات والمدرعات متوافقة مع التخزين.

**اختياري كاملة التخزين التحقق**

```bash
ffmpeg -v error -i "downloads/CHANNEL_ID/VIDEO_ID.mp4" -f null -
```

قراءة وتفكيك الملف بأكمله دون إنشاء إصدار جديد من وسائل الإعلام.تحقق من حالة الخروج وكذلك الرسائل؛ هذا يستغرق وقتا أطول من ffprobe.

| البحث | الإجراء المطلوب |
| --- | --- |
| لا يزال ملف .part أو منفصلًا فقط | فحص الخطأ transfer/merge وإعادة تشغيل العمل الأصلي؛ لا تضع علامة على ملف الوسط كاملا. |
| ألعاب الفيديو بدون صوت | فحص النموذج المحدد و ffprobe التي تدفق.إن تنسيق الفيديو وحده يحتاج إلى اختيار الصوت والاندماج. |
| MP4 لن يفتح في محررك | فحص الرموز، وليس فقط التمديد؛ حدد الشبكات المتوافقة أو ترانسكود صراحة. |
| أرشيف الهوية ولكن لا ملف محلي | تحقق مما إذا كان الملف moved/deleted. تجمع المخزون قبل تغيير إدخالات الأرشيف. |

<a id="schedule"></a>

## 9: تحريك أمر مثبت إلى وظيفة مخططة


قم بتنفيذ الأمر الكامل بنجاح يدويا قبل التخطيط له. عادة ما يبدأ الجدول الزمني مع PATH مختلف ومجلد عمل. إعطائها مسار Python الكامل للبيئة الافتراضية، مسار التحكم الكامل ومسار عمل صريح؛ كما جعل FFmpeg ووقت تشغيل JavaScript متاحًا لهذا العملية.

- استخدام عامل واحد لـ collection/archive. لا تدع سباق أمس يغطي سباق اليوم ضد نفس النتائج.
- على لينكس، استخدم timer/service أو إدخال cron مع دليل عمل ومغلق مثل المجموعة.
- على macOS، استخدم المبدأ مع مسارات تنفيذية مطلقة وموضوع العمل.
- على Windows Task Scheduler، حدد البرنامج إلى البيئة python.exe، الحجج إلى -m yt_dlp بالإضافة إلى خيارات التكوين والقطع، والبدء في مجلد المجموعة.
- تسجيل start/end الوقت، والنسخة القابلة للتنفيذ، ومتى المصدر، وحالة الخروج، و completed/failed حساب.
- حفظ ملفات الكوكيز والمصادقة المستهدفة من مخزن التكوين المشترك.إعطاء وظيفة فقط المصادقات التي يحتاجها.

خيارات النوم في التثبيت يعمل في إطار عملية واحدة. عشرة عمال يستخدمون نفس الإعدادات لا يزالون ينتجون عشرة تدفقات متقلبة من الطلبات. زيادة --concurrent-fragments تغير منافسة الفقرات داخل تنزيل، وليس عدد الفيديوهات في شريط العمل الخاص بك.

<a id="maintain"></a>

## اختيار دليل الخطأ الصحيح


**تحديث بيئة Python**

```bash
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
```

عند انقطاع مصدر عمل سابق، تحديث أحدث ليلة الأولى، بما في ذلك إضافات المطابقة. بالنسبة للاستخدام الثنائي المستقل yt-dlp --update-to ليلاً؛ -U وحدها يبقى على القناة الحالية. تشغيل قناة صغيرة بعد كل تحديث ، ثم إعادة بناء العمال وتسجيل التعديل بحيث لا يخلط الأسطول الصامت الإصدارات.

| الرمز | ابدأ هنا |
| --- | --- |
| `Requested format is not available` | قم بتصنيف وتفتيش الفلاتر الصارمة قبل تغيير الإخراج. |
| `ffmpeg not found` / `ffprobe and ffmpeg not found` | تحقق من PATH من حساب العامل الحقيقي أو الجدول الزمني. |
| تحدي جاكافا سكاي / هشاشة تشغيل مفقودة | تحقق من اكتشاف وقت التشغيل وحزمة EJS المقابلة. |
| HTTP 403 أثناء التحويل | تحديد المضيف المرفوض والمسرح؛ استخراج منفصل من نقل وسائل الإعلام. |
| HTTP 429 | وقف IP المتضرر، والسماح بارد وانخفاض وتردد الطلب extraction/caption. |
| `Sign in to confirm you’re not a bot` | استيقظ المجموعة وتشخيص مصدر واحد، الجلسة والشبكة. |

- [403 تشخيص تدفق العمل](https://flashdata.dev/ar/docs/guides/yt-dlp-403-forbidden/reference.md)
- [بوت-تشك تشخيص سير العمل](https://flashdata.dev/ar/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [429 استعادة الحد الأدنى للمعدل](https://flashdata.dev/ar/docs/guides/yt-dlp-429-too-many-requests/reference.md)
- [مرجع الأوامر اليومية](https://flashdata.dev/ar/docs/guides/yt-dlp-commands/reference.md)
- [بناء عامل Python](https://flashdata.dev/ar/docs/guides/yt-dlp-python-api/reference.md)

<a id="managed-downloads"></a>

## عندما ينتمي الإنتاج إلى خط أنابيب السحابة


إذا كنت ترغب في امتلاك المتصفح، وتدفقات العمل أعلاه يعطيك السيطرة على الملفات والفرم ومعالجة. إذا كانت التطبيق بحاجة إلى وسائل الإعلام المكتملة التي يتم تسليمها إلى التخزين ، فإن FlashData يوفر وظائف تنزيل YouTube المتابعة ، ومعالجة الروبوتات ، وتوجيه البروكسي ، والتقاعد. يقدم تطبيقك إعدادات المصدر والخروج، ثم يحافظ على معرف العمل وسجل التسليم.

- [مقارنة بين النماذج العملية](https://flashdata.dev/ar/docs/guides/flashdata-vs-yt-dlp/reference.md)
- [تنزيل فيديوهات YouTube بالجملة](https://flashdata.dev/ar/products/youtube-download#bulk-downloads)
- [اقرأ المزيد: Download demo](https://flashdata.dev/ar/products/youtube-download#playground)
- [تحميل API Reference](https://flashdata.dev/ar/docs/sources/youtube_download/reference.md)

<a id="references"></a>

## المواد المرجعية


مرجع الخيارات أعلى هو مصدر الحقيقة للنسخة المثبتة.استخدم هذه الأقسام عند تغيير سياسة جمع أو تحديث صورة العامل.

- [اختيار وتصنيف](https://github.com/yt-dlp/yt-dlp#format-selection)
- [تحميل التحكم](https://github.com/yt-dlp/yt-dlp#configuration)
- [نموذج الخروج](https://github.com/yt-dlp/yt-dlp#output-template)
- [الأسئلة الشائعة حول yt-dlp](https://github.com/yt-dlp/yt-dlp/wiki/FAQ)
