# Cara menggunakan yt-dlp

Panduan muat turun berasaskan Linux yang meliputi pemasangan versi nightly, format, sari kata, set data dan sambungan pengumpulan.

Referensi boonical: https://flashdata.dev/ms/docs/guides/how-to-use-yt-dlp
Diulas: 2026-11-13 oleh FlashData

- [Menetapkan alat](https://flashdata.dev/ms/docs/guides/how-to-use-yt-dlp/reference.md#install) — Python, FFmpeg dan JavaScript
- [Pilih output](https://flashdata.dev/ms/docs/guides/how-to-use-yt-dlp/reference.md#formats) — Video, audio dan captions
- [Kembali ke koleksi](https://flashdata.dev/ms/docs/guides/how-to-use-yt-dlp/reference.md#repeatable) — Manifest, config dan arkib
- [Menyelesaikan kegagalan](https://flashdata.dev/ms/docs/guides/how-to-use-yt-dlp/reference.md#maintain) — Cari diagnosis yang betul

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

## Menerapkan baseline penggunaan harian


**Mula dengan malam + Deno + FFmpeg.** Gunakan persekitaran maya projek dan memungkinkan peribadi pelayar dengan `--impersonate=""`. setup Linux di bawah memasang alat; alternatif macOS dan Windows terdapat dalam tab.

**Linux**

Contoh Ubuntu / Debian dengan Python 3.11+.Memasang alat sistem, mewujudkan persekitaran maya projek, kemudian memasang malam semasa dan ekstrasnya.


**Pengenalan kepada Linux Workers**

```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**

Dengan Homebrew dipasang, gunakan untuk Python, Deno, FFmpeg dan aria2. Tetap yt-dlp itu sendiri dalam persekitaran projek supaya perintah kemas kini malam adalah sama seperti pada Linux.


**MacOS setup**

```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**

Pemasang Python 3.11+, Deno dan FFmpeg executables, kemudian buka terminal baru. Gunakan penerjemah persekitaran secara langsung jika PowerShell memblokir pengaktifan. aria2 adalah opsional; memasangnya secara berasingan jika menggunakan resipi muat turun luaran.


**Persekitaran Windows**

```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
```


| Alat Fon | Apa yang ia lakukan | Periksa |
| --- | --- | --- |
| Python 3.11+ | Pelaksanaan pakej Python dan contoh dalam siri ini. | python --version |
| Terakhir yt-dlp malam + lalai,curl-cffi ekstras | Ekstraktor YouTube semasa, menyesuaikan penyelesai EJS dan sokongan impersonasi pelayar. | python -m yt_dlp --version |
| FFmpeg dan ffprobe | Menggabungkan aliran, menukar audio, memotong klip dan memeriksa media disimpan. | ffmpeg -version / ffprobe -version |
| Deno 2.3+ (diperlukan dalam aliran kerja ini) | Melaksanakan cabaran YouTube. memasangnya pada setiap pekerja, bukan sahaja mesin pembangunan anda. | deno --version |

**Memasang juga pelaksana.** `[default]` menyediakan skrip EJS; Deno terpisah. FFmpeg dan ffprobe juga mesti berada pada PATH pekerja.

**Lihat keseluruhan baseline**

```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
```

Perintah akhir hendaklah senarai sasaran pelayar yang tersedia.Jika sasaran tidak tersedia, pastikan curl-cffi dipasang dalam persekitaran maya ini.

**Pengujian ekstraksi dengan Deno dan pengimpersonaan pelayar**

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

Pemeriksaan JS runtime dan permintaan-handler garis. simulasi ujian ekstraksi; mengikuti dengan pemindahan sebenar.

Baseline operasi FlashData termasuk --impersonate=": ia membolehkan curl-cffi memilih cap jari pelayar yang tersedia. Ini mengubah cap jari permintaan; ia tidak menyediakan cookies log masuk, menyelesaikan cabaran JavaScript atau mengubah IP keluar. Jika opsyen ini melambatkan laluan kerja atau memasukkan kesilapan, ulangi ujian satu video yang sama tanpa itu dan simpan konfigurasi kerja.

> **Perkhidmatan memerlukan laluan sendiri**
> Installer Deno biasanya meletakkan binari dalam ~/.deno/bin. Sebuah shell interaktif yang menemukannya tidak membuktikan bahawa perkhidmatan sistemd, bekas atau kerja cron boleh. Tetapkan pekerja PATH atau melepasi --js-runtimes deno:/absolute/path/to/deno. Gunakan laluan Python persekitaran maya dalam perintah perkhidmatan.

- [Pemasangan rasmi](https://github.com/yt-dlp/yt-dlp/wiki/Installation)
- [FFmpeg Penghantaran](https://ffmpeg.org/download.html)
- [Menggunakan Deno](https://docs.deno.com/runtime/getting_started/installation/)
- [YouTube Pengenalan](https://github.com/yt-dlp/yt-dlp/wiki/EJS)

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

### Semak pengeluaran sebelum meletakkannya pada pekerja


Dapatkan pelaksana dari halaman pelancaran projek rasmi, atau memasang pakej Python daripada sumber pakej yang diterbitkan. Jika anda memuat turun binari berasingan, bandingkan SHA-256 dengan nama fail yang sepadan dalam SHA2-256SUMS daripada siaran itu. Mencatat pelepasan dan cek dengan imej pekerja anda supaya anda boleh mengenal pasti apa yang berjalan.

**Linux**


**Hash fail yang dimuat turun**

```bash
sha256sum yt-dlp
```


**macOS**


**Hash fail yang dimuat turun**

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


**Windows**


**Hash fail yang dimuat turun**

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


Perbandingan cek hanya berguna apabila nilai yang dijangka berasal daripada pelepasan yang dipercayai, bukan cermin yang tidak diketahui yang sama dengan yang boleh dilaksanakan. Jika perisian keselamatan menandakan fail, siasatan sumber dan laporan sebelum membuat pengecualian. Ketersediaan sumber terbuka sahaja tidak membuktikan bahawa setiap plugin binari atau pihak ketiga yang dimuat turun adalah selamat.

Mengendalikan fail konfigurasi yang dikongsi sebagai kod untuk disemak semula: opsyen seperti --exec boleh melancarkan perintah, dan plugin menambah kod kepada proses muat turun. Simpan cookies pelayar, pengesahan proxy dan URL yang ditandatangani daripada contoh konfigurasi dan laporan diagnostik.

- [Penerbitan rasmi dan cek](https://github.com/yt-dlp/yt-dlp/releases)

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

## Download 1 video


**Menggunakan satu video pendek terlebih dahulu.** Cita URL, tambahkan `--no-playlist`, dan nama fail dengan ID video. perintah mencetak laluan akhir selepas penggabungan dan post-proses.

**1 video, 1 folder output**

```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"
```

Jalan yang dicetak ialah fail selepas penggabungan dan post-proses. buka laluan itu; jangan anggap fail akan berakhir dalam .mp4.

Tanpa format override, yt-dlp memilih aliran yang disukai. Sumber berkualiti tinggi sering mempunyai aliran video dan audio yang berasingan, jadi dua pemindahan diikuti oleh penggabungan FFmpeg adalah normal. Fail pertengahan dan fail .part boleh muncul semasa kerja berjalan.

> **Jangan keras kod ekstensi**
> Simpan %(ext)s dalam templat output. nama WebM aliran file.mp4 hanya mengubah namanya. pemilihan format, remuxing dan penukaran menentukan apa yang ada di dalam fail.

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

## Pilih kualiti dan kodek


**Periksa format video ini**

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

**Pilih dasar, bukan ID format yang disalin.** Semak resolusi, kodek dan trek audio/video yang berasingan.

| Pilihan atau pilihan | Arti | bila nak guna |
| --- | --- | --- |
| Bb + Bb | Pilih video sahaja dan audio sahaja; FFmpeg menggabungkan mereka. | Anda memerlukan kedua-dua trek dan boleh menggabungkan secara tempatan. |
| A/B | Cuba selektor A, kemudian B jika A tidak tersedia. | Menetapkan penurunan eksplisit daripada menganggap setiap sumber mempunyai format yang sama. |
| [height<=1080] | Mengecualikan aliran di atas 1080 piksel tinggi. | Sebuah tali pinggang yang keras merupakan satu keperluan. |
| -S res:1080 | Lebih suka resolusi sehingga 1080; boleh memilih yang lebih besar apabila tiada yang tersedia di bawah. | 1080p adalah satu keutamaan daripada bumbung yang keras. |
| --merge-output-format mp4 | Pilih bekas apabila menggabungkan aliran berasingan. | Anda telah memilih aliran yang kompatibel. ia tidak transcode codecs. |

**Menjaga kodek sumber, dengan bumbung yang keras 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"
```

Ia boleh menghasilkan WebM, MP4 atau bekas lain yang disokong. ia gagal jika tiada format memenuhi bumbung; ia tidak diam-diam memuat turun 4K.

Untuk editor atau stack playback yang secara khusus memerlukan H.264 video dan AAC audio, filter kodek tersebut dan bergabung dengan MP4. MP4 ialah bekas: aliran dalam bekas MP4 masih boleh mengandungi kodek aplikasi anda tidak boleh memecahkan.

**Permintaan H.264 + AAC, sehingga 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"
```

Jika kodek yang diperlukan tidak tersedia, pemilih ketat ini gagal. memutuskan sama ada untuk menerima kodek sumber yang berbeza atau transcode; jangan menghapuskan keperluan secara tidak sengaja.

Remuxing mengembalikan aliran tanpa mengekod semula mereka. Transcoding mengubah kodek dan menghabiskan CPU sementara berpotensi mengubah kualiti. Gunakan --remux-video apabila aliran sudah sesuai dengan bekas sasaran; gunakan konversi FFmpeg yang disengaja apabila decoder downstream memerlukan kodek yang berbeza.

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

## Menyimpan audio atau MP3


Jika saluran transcription anda menerima kodek audio sumber, muat turun yang streaming secara langsung. Ini mengelakkan pertukaran kerugian yang tidak perlu. MP3 berguna apabila pengguna secara khusus memerlukannya; kadar bit yang tinggi MP3 tidak boleh memulihkan butiran yang telah hilang dalam sumber.

**Menjaga audio streaming terbaik yang tersedia**

```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"
```

Menunggu bekas sumber dan kodek, biasanya M4A/AAC atau WebM/Opus.

**Menukar audio kepada 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"
```

Permintaan FFmpeg. --audio-quality 0 pilih seting kualiti variabel terbaiknya; gunakan kadar bit seperti 192K apabila spesifikasi downstream anda memerlukan satu.

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

## Menyelamatkan captions dan metadata


Sebuah koleksi yang berguna memerlukan lebih daripada nama filen. Simpan ID video, URL sumber, tajuk, tempoh dan capsi yang tersedia supaya anda boleh mencari koleksi dan menjejaki aset kembali ke sumbernya. Mulakan dengan menyenaraikan trek caption; meminta en tidak bermakna setiap video mempunyai trek Bahasa Inggeris.

**Pemeriksaan captions, kemudian menyimpan bahasa Inggeris tanpa media**

```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 memilih subtitle yang disampaikan; --write-auto-subs juga membenarkan capsi automatik. ini mengambil trek yang sedia ada dan tidak meniru video yang tidak mempunyai.

**Media dengan metadata dan miniatur**

```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"
```

Fail .info.json adalah metadata operasi terperinci, bukan jawapan API awam yang bersih. Ia boleh termasuk URL media yang tamat tempoh dan medan yang berkaitan dengan permintaan. Simpan sampel penuh dengan koleksi, dan mengeksport hanya medan yang diperlukan oleh sistem downstream anda. Jika kamu memerlukan SRT daripada VTT, tambahkan --convert-subs srt dan pastikan FFmpeg tersedia.

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

## Membina item AI data set


Untuk koleksi latihan, memutuskan media dan output teks bersama-sama. Satu keperluan biasa ialah video dan audio yang terbaik, digabungkan ke dalam MP4, dengan capsi berjam-jam dan metadata pengekstrakan disimpan di bawah ID video yang sama. Sebuah bumbung resolusi yang berguna untuk previews biasanya adalah lalai yang salah untuk set data kualiti sumber.

**Download satu item set data lengkap**

```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"
```

Contoh Bash. FFmpeg menggabungkan aliran berasingan; --remux-video juga meliputi rintangan aliran gabungan. gunakan tag bahasa yang tepat daripada --list-subs; menggantikan en dengan bahasa yang diperlukan oleh set data anda.

Mulakan dengan satu bahasa yang tepat. Dalam semak langsung kami, en.* dipilih en, en-en dan en-de; trek ketiga kembali 429 sebelum memulakan muat turun media. Kesilapan caption boleh menghentikan item pada peringkat itu. Selepas penyejukan, hanya menarik balik trek yang diperlukan, atau memecah media dan rekod pekerjaan jika koleksi anda perlu mengekalkan pengambilan media bergerak.

/best fallback membolehkan aliran gabungan video/audio apabila trek berasingan tidak tersedia. Menghapuskan kegagalan ini jika kontrak pengumpulan anda memerlukan sumber bestvideo dan bestaudio yang berasingan. MP4 tidak bermaksud H.264: resipi ini mengekalkan kodek sumber yang dipilih. Gunakan pemilih H.264/AAC yang ketat di atas jika decoder latihan anda memerlukan kodek tersebut, atau transcode sebagai langkah yang berasingan, disimpan.

**Fail yang diharapkan apabila terdapat trek isyarat Bahasa Inggeris**

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

Tidak ada fail caption yang dicipta apabila trek yang diminta tidak tersedia; jangan menandakan penutup teks lengkap hanya kerana MP4 selesai.

| Keperluan Keperluan Kemurtadan | Keputusan Koleksi |
| --- | --- |
| Kualiti sumber yang paling tinggi | Gunakan bestvideo+bestaudio, simpan kodek sumber dan semak aliran gabungan dengan ffprobe. |
| Teks yang disusun | Simpan segmen VTT/SRT dan bahasa di sebelah ID video. teks yang melengkung mengecualikan masa yang diperlukan untuk penyelarasan klip. |
| Tiada kapsyen | Rekod teks yang hilang secara eksplisit.Rute audio yang disimpan ke peringkat transcription anda jika teks adalah wajib. |
| Captions untuk banyak bahasa | Setiap trek tambahan menambah permintaan dan boleh bertemu 429 tanpa mengira media. |
| Media Resumable + Penghantaran teks | Gunakan arkib set data yang berasingan dan inventori dengan media, metadata dan status caption. entri arkib tidak membuktikan semua halaman yang diperlukan wujud. |

Jangan gunakan semula arkib yang dicipta oleh media terdahulu yang hanya berjalan untuk dasar baru ini: video yang diarkibkan mungkin terlepas sebelum capsi yang hilang dikumpulkan. Atau menjalankan dasar set data dengan arkib sendiri atau merancang laluan pembaikan tajuk berasingan untuk ID teks yang hilang. Simpan capsi asal; jika model anda memerlukan teks transcript yang bersih, beralih kepada langkah pemprosesan yang dikeluarkan.

- [Resep set data yang sama dalam Python](https://flashdata.dev/ms/docs/guides/yt-dlp-python-api/reference.md#dataset)
- [Pengurusan caption dan metadata 429s](https://flashdata.dev/ms/docs/guides/yt-dlp-429-too-many-requests/reference.md)

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

## Meningkatkan penghantaran tanpa mengecilkan IP


aria2c boleh membantu apabila satu sambungan menjejaskan sambungan yang tidak boleh dipercayai atau latent tinggi. Ia tidak boleh membetulkan permintaan pemain yang ditolak atau IP keluar yang ditandakan. Pertama, buat download asli berfungsi pada satu sumber; kemudian bandingkan masa dan kesilapan pemindahan dengan bilangan kecil sambungan aria2.

**Mulakan dengan dua sambungan per HTTP pemindahan**

```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"
```

Simpan aria2 terlebih dahulu. simpan DASH/HLS dengan pemuat turun asli di sini supaya persaingan segmen kekal jelas.

| Pengawal | Apa yang membatasi |
| --- | --- |
| aria2c -x 2 | Menyambung ke satu pelayan untuk satu muat turun. |
| aria2c -s 2 | Pembahagian yang diminta untuk satu fail; pembahagian juga bergantung kepada saiz fail dan sokongan pelayan. |
| aria2c -j 1 | Perbezaan antara perkara-perkara di dalam aria2 permohonan, bukan pekerja lain yt-dlp. |
| --concurrent-fragments 1 | Fragment download di dalam native DASH/HLS download. |
| Pekerjaan anda yang | Keseluruhan video aktif berkongsi host yang sama atau proxy keluar IP. |

curl-cffi impersonasi tergolong dalam permintaan yt-dlp sendiri; ia tidak mengkonfigurasi aria2 jari TLS. Jika muat turun asli berfungsi tetapi aria2 mendapat 403, kembali ke asli sebelum mengubah tetapan ekstrak yang tidak berkaitan. Tetap ekstraksi dan pemindahan luaran pada sesi proxy yang sama.

Dalam operasi FlashData, menaikkan persaingan terlalu agresif boleh membuat laluan kerja mula kembali 403 dengan serta-merta. Jika ini berlaku, hentikan kerja-kerja lain, kembali kepada satu pekerja dan satu sambungan, kemudian re-test. Jangan mengimbangi dengan menambah lebih banyak aria2 bahagian atau mengalihkan aliran yang sama yang ditolak secara serentak. Jika IP itu kekal ditolak pada beban rendah, gunakan aliran kerja penggantian IP 403.

**Perbezaan antara pemindahan asli konservatif**

```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 ialah cap lebar band diagnostik, bukan had YouTube universal. menaikkan laluan secara beransur-ansur hanya selepas laluan berfungsi.

- [aria2 sambungan dan pilihan berkongsi](https://aria2.github.io/manual/en/html/aria2c.html)
- [403 Perintah pemulihan](https://flashdata.dev/ms/docs/guides/yt-dlp-403-forbidden/reference.md#rate)
- [Kawalan kadar untuk metadata dan captions](https://flashdata.dev/ms/docs/guides/yt-dlp-429-too-many-requests/reference.md#pacing)

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

## Menyediakan koleksi


Untuk set kecil yang diketahui, cipta UTF-8 urls.txt dengan satu URL jam per baris. Untuk senarai main YouTube, terlebih dahulu senaraikan ID mereka dalam manifest. Extraction rata memeriksa senarai main tanpa membuat extraction penuh untuk setiap video; ia berguna untuk ulasan julat, tetapi entri mungkin kekurangan tempoh, format dan butiran ketersediaan.

**Mencipta manifest senarai main YouTube**

```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
```

Menggantikan YOUR_PLAYLIST_ID. memeriksa urls.txt sebelum memulakan pemindahan media. pengalihan menggantikan manifest ini jika anda menjalankan lagi.

Untuk mencuba koleksi, pilih beberapa entri senarai main dengan --playlist-items 1:5. Tab /video saluran adalah titik permulaan yang lebih jelas untuk video yang dimuat naik daripada halaman utama saluran yang tidak jelas. Jangan menganggap perintah senarai main sebagai identiti: item boleh dimasukkan, dipesan semula atau dihapuskan.

| Filter | Guna | akibat |
| --- | --- | --- |
| --playlist-items 1:5 | 5 entri pertama dalam senarai semasa. | berguna untuk percubaan kecil, bukan titik pemeriksaan yang berterusan. |
| --dateafter 20260101 | Simpan entri yang tarikh pada atau selepas 1 Januari 2026. | Filter tarikh masih boleh memerlukan ekstraksi per video. |
| --match-filters "!is_live & duration <= 1800" | Memerlukan item yang tidak hidup dengan tempoh yang diketahui pada maksimum 30 minit. | Entri dengan tempoh yang tidak diketahui tidak sepadan dengan penapis yang ketat ini. |
| --download-archive archive.txt | Skip ID sumber yang telah disimpan oleh muat turun terdahulu. | Beroperasi di atas tajuk yang berubah dan kedudukan playlist. |

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

## Menggabungkan semula koleksi dengan selamat


Simpan yang berikut sebagai yt-dlp-work.conf dalam folder koleksi anda, di samping urls.txt. Ia menentukan dasar output sekali, memberikan koleksi arkib sendiri, dan membatasi penarikan. Simpan fail output dan arkib ini bersama-sama: arkib mencatat kejayaan oleh pengekstrak dan ID, bukan oleh jumlah pemeriksaan atau lokasi fail semasa.

**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
```

Konfigurasi teks rata, satu pilihan per baris.Langkah-langkah dalam contoh ini adalah relatif kepada direktori kerja.Menggunakan laluan mutlak apabila jadual boleh bermula di tempat lain.

**Mengendalikan koleksi**

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

--ignore-config menghapuskan konfigurasi user/system secara implisit; fail --config-locations yang disediakan secara eksplisit masih dimuat naik.

Mengatur perintah yang sama selepas gangguan. ID yang selesai dilumpuhkan, dan pemindahan sebahagian yang boleh dipulihkan berterusan di mana disokong. Kegagalan pengekstrakan boleh dipertimbangkan semula pada baris seterusnya. Fail .part lalai adalah keadaan yang berguna; jangan memadamkan mereka sebagai langkah retry rutin.

> **Arkib berasingan untuk output berasingan**
> ID tunggal dalam archive.txt tidak membezakan MP3, 1080p dan 4K. Gunakan fail arkib yang berbeza untuk dasar output yang berbeza. Jika anda memadam fail media tetapi mengekalkan entri arkib, yt-dlp masih akan melumpuhkan. Jika anda kemudian memuat naik fail ke penyimpanan awan, rekod kejayaan muat naik secara berasingan daripada kejayaan muat turun tempatan.

--no-abort-on-error terus melepasi input yang tidak tersedia, tetapi satu berjalan masih boleh keluar nonzero dan kesilapan selepas pemprosesan memerlukan perhatian. Elakkan menambah --ignore-errors hanya untuk mendapatkan pekerjaan hijau: ia boleh mengendalikan kegagalan selepas pemprosesan sebagai muat turun yang berjaya. Semak log dan output selesai sebelum mengisytiharkan koleksi selesai.

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

## Periksa fail yang telah selesai


Fail completed-paths.txt merupakan inventori permulaan yang berguna. Ujian output akhir sebenar daripada sementara video-hanya aliran. ffprobe membaca konten dan aliran metadata; laluan dekod berasingan menangkap masalah yang hanya tajuk yang boleh dibaca akan hilang.

**Periksa satu fail selesai**

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

Menggantikan laluan dengan satu daripada completed-paths.txt. semak jangka masa yang dijangka, aliran audio/video yang diperlukan dan kodek yang kompatibel dengan decoder.

**Pilihan pemeriksaan dekod penuh**

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

Membaca dan memecahkan keseluruhan fail tanpa mencipta output media baru. semak status keluar serta mesej; ini mengambil masa lebih lama daripada ffprobe.

| Mencari | Tindakan |
| --- | --- |
| Hanya satu .part atau fail streaming berasingan yang tersisa | Periksa kesilapan transfer/merge dan mengembalikan kerja asal; jangan menandakan fail pertengahan lengkap. |
| Video Bermain Tanpa Suara | Semak format yang dipilih dan ffprobe aliran. format video sahaja memerlukan pemilihan audio dan penggabungan. |
| MP4 tidak akan dibuka dalam editor anda | Semak kodek, bukan hanya ekstensi; pilih aliran yang kompatibel atau transcode secara eksplisit. |
| ID yang disimpan tetapi tiada fail tempatan | Semak sama ada fail itu moved/deleted. Rekonversi inventori sebelum mengubah entri arkib. |

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

## 9.Mengalihkan perintah yang terbukti ke dalam pekerjaan yang dijadualkan


Lakukan perintah penuh dengan berjaya secara manual sebelum merancang. Jadual biasanya bermula dengan PATH yang berbeza dan direktori kerja. Berikan ia laluan Python penuh persekitaran maya, laluan konfigurasi penuh dan direktori kerja yang jelas; juga membuat FFmpeg dan masa berjalan JavaScript tersedia untuk proses itu.

- Gunakan satu pekerja untuk collection/archive. Jangan biarkan pergerakan semalam melampaui pergerakan hari ini terhadap output yang sama.
- Pada Linux, gunakan timer/service atau cron entri dengan direktori kerja dan kunci seperti flock. Simpan log di luar folder media dan putar mereka.
- Pada macOS, gunakan pelancaran dengan laluan eksekusi mutlak dan laluan kerja.
- Pada Windows Task Scheduler, tetapkan Program untuk persekitaran python.exe, Argumen untuk -m yt_dlp ditambah opsyen konfigurasi dan batch, dan Mulakan ke folder koleksi.
- Rekod start/end masa, versi yang boleh dijalankan, manifest sumber, status keluar dan completed/failed mengira. output batch nonzero tidak bermakna setiap item gagal.
- Simpan fail cookie dan pengesahan destinasi daripada repositori konfigurasi yang dikongsi. berikan pekerjaan hanya pengesahan yang diperlukan.

Pilihan tidur dalam konfigur berfungsi dalam satu proses. Sepuluh pekerja yang menggunakan tetapan yang sama masih menghasilkan sepuluh aliran permintaan yang melampau. Meningkatkan --concurrent-fragments mengubah persaingan fragmen di dalam muat turun, bukan bilangan video dalam kotak kerja anda.

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

## Pilih panduan kesilapan yang betul


**Meningkatkan persekitaran Python ini**

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

Apabila sumber kerja terdahulu pecah, update kepada yang terakhir malam pertama, termasuk tambahan yang sepadan. Untuk penggunaan binari yang berasingan yt-dlp --update-to pada waktu malam; -U hanya tinggal di saluran semasa. Berjalankan sebuah kanary kecil selepas setiap kemas kini, kemudian membina semula pekerja dan merekodkan penilaian supaya armada tidak diam-diam mencampur pelepasan.

| Gejala | Mula di sini |
| --- | --- |
| `Requested format is not available` | Senarai format dan semak filter anda yang ketat sebelum mengubah retries. |
| `ffmpeg not found` / `ffprobe and ffmpeg not found` | Semak PATH daripada akaun pekerja atau jadual sebenar. |
| JavaScript Challenge / Peringatan Runtime yang Hilang | Semak pengesanan masa berjalan dan pakej EJS yang sepadan. |
| HTTP 403 semasa pemindahan | Menentukan tuan rumah yang ditolak dan peringkat; pengekstrakan berasingan daripada pemindahan media. |
| HTTP 429 | Berhenti IP yang terjejas, membolehkan sejuk dan frekuensi permintaan extraction/caption yang lebih rendah. |
| `Sign in to confirm you’re not a bot` | Berhenti batch dan diagnosis satu sumber, sesi dan rangkaian. |

- [403 Diagnosis aliran kerja](https://flashdata.dev/ms/docs/guides/yt-dlp-403-forbidden/reference.md)
- [Bot-check diagnostik aliran kerja](https://flashdata.dev/ms/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [429 Kadar-limit pemulihan](https://flashdata.dev/ms/docs/guides/yt-dlp-429-too-many-requests/reference.md)
- [Perintah harian rujukan](https://flashdata.dev/ms/docs/guides/yt-dlp-commands/reference.md)
- [Membina pekerja Python](https://flashdata.dev/ms/docs/guides/yt-dlp-python-api/reference.md)

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

## Apabila pengeluaran tergolong dalam saluran awan


Jika anda ingin mempunyai pemuat turun, aliran kerja di atas memberi anda kawalan fail, format dan pemprosesan. Jika aplikasi anda memerlukan media lengkap yang disimpan, FlashData menyediakan pekerjaan muat turun YouTube yang dipantau, pengendalian bot, routing proxy dan penarikan. Permohonan anda mengemukakan tetapan sumber dan output, kemudian menyimpan ID pekerjaan dan rekod penghantaran.

- [Perbandingan kedua-dua model operasi](https://flashdata.dev/ms/docs/guides/flashdata-vs-yt-dlp/reference.md)
- [Muat turun video YouTube secara pukal](https://flashdata.dev/ms/products/youtube-download#bulk-downloads)
- [Cuba download demo](https://flashdata.dev/ms/products/youtube-download#playground)
- [Download rujukan API](https://flashdata.dev/ms/docs/sources/youtube_download/reference.md)

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

## Bahan rujukan


Rujukan opsyen upstream adalah sumber kebenaran untuk versi yang dipasang anda. gunakan seksyen ini apabila mengubah dasar pengumpulan atau mengemas kini imej pekerja.

- [Format pemilihan dan sorting](https://github.com/yt-dlp/yt-dlp#format-selection)
- [Konfigurasi Loading](https://github.com/yt-dlp/yt-dlp#configuration)
- [Templat output](https://github.com/yt-dlp/yt-dlp#output-template)
- [Soalan lazim tentang yt-dlp](https://github.com/yt-dlp/yt-dlp/wiki/FAQ)
