# Cara menggunakan yt-dlp

Panduan unduhan yang mengutamakan Linux, dengan pemasangan versi nightly, format, subtitel, set data, dan pengumpulan yang bisa dilanjutkan.

Referensi kanonikal: https://flashdata.dev/id/docs/guides/how-to-use-yt-dlp
Diulang: 2026-11-13 oleh FlashData

- [Mengatur alat](https://flashdata.dev/id/docs/guides/how-to-use-yt-dlp/reference.md#install) — Python, FFmpeg dan JavaScript
- [Pilih output](https://flashdata.dev/id/docs/guides/how-to-use-yt-dlp/reference.md#formats) — Video, audio dan captions
- [Ulangi koleksi](https://flashdata.dev/id/docs/guides/how-to-use-yt-dlp/reference.md#repeatable) — Manifest, Config dan Arkib
- [Mengatur Kegagalan Run](https://flashdata.dev/id/docs/guides/how-to-use-yt-dlp/reference.md#maintain) — Temukan diagnosis yang tepat

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

## Menginstal basis penggunaan harian


**Mulai dengan malam + Deno + FFmpeg.** Gunakan lingkungan virtual proyek dan memungkinkan peribadi browser dengan `--impersonate=""`. setup Linux di bawah ini menginstal alat; macOS dan Windows alternatif berada di tab.

**Linux**

Contoh Ubuntu / Debian dengan Python 3.11+.Memasang alat sistem, buat lingkungan virtual proyek, kemudian instal malam saat ini dan ekstrasinya.Mengoperasikan instalator Deno sebagai pengguna yang sama yang dimiliki oleh pekerja.


**Linux Operator yang**

```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 di lingkungan proyek sehingga perintah update malam sama seperti pada Linux.


**MacOS yang**

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

Instal Python 3.11+, Deno dan FFmpeg executables, kemudian buka terminal baru. Gunakan penerjemah lingkungan secara langsung jika PowerShell memblokir aktivasi. aria2 adalah pilihan; instal secara terpisah jika menggunakan resep download eksternal.


**Lingkungan 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 | Apa yang dilakukan | Periksa |
| --- | --- | --- |
| Python 3.11+ | Menggunakan paket Python dan contoh dalam seri ini. | python --version |
| Terakhir yt-dlp malam + default,curl-cffi ekstras | YouTube Extractor, sesuai dengan penyelesai EJS dan dukungan peribadi browser. | python -m yt_dlp --version |
| FFmpeg dan ffprobe | Menggabungkan aliran, menukar audio, memotong klip dan memeriksa media yang disimpan. | ffmpeg -version / ffprobe -version |
| Deno 2.3+ (diperlukan dalam aliran kerja ini) | Mengendalikan tantangan YouTube.Memasang pada setiap pekerja, bukan hanya mesin pengembangan Anda. | deno --version |

**Install executables juga.** `[default]` menyediakan skrip EJS; Deno terpisah. FFmpeg dan ffprobe juga harus berada di PATH pekerja.

**Periksa garis dasar lengkap**

```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 harus mencatat target browser yang tersedia.Jika target tidak tersedia, pastikan curl-cffi dipasang di lingkungan virtual ini.

**Pengujian dengan Deno dan browser impersonasi**

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

Pemeriksaan jam berjalan JS dan permintaan-kedai garis. simulasi menguji ekstraksi; ikuti dengan transfer nyata.

FlashData berbasis operasi termasuk --impersonate=": ia memungkinkan curl-cffi untuk memilih jari browser yang tersedia. Ini mengubah jari permintaan; tidak menyediakan cookie login, menyelesaikan tantangan JavaScript atau mengubah IP output. Jika opsi ini memperlambat rute kerja atau memperkenalkan kesalahan, ulangi tes satu video yang sama tanpa itu dan tetapkan konfigurasi kerja.

> **Sebuah layanan membutuhkan jalannya sendiri**
> Installer Deno biasanya menempatkan biner di ~/.deno/bin. Sebuah shell interaktif menemukan itu tidak membuktikan sistemd layanan, konten atau pekerjaan cron dapat. Tetapkan pekerja PATH atau melewati --js-runtimes deno:/absolute/path/to/deno. Gunakan jalur Python lingkungan virtual dalam perintah layanan.

- [Instalasi Resmi](https://github.com/yt-dlp/yt-dlp/wiki/Installation)
- [FFmpeg Pengunduran Diri](https://ffmpeg.org/download.html)
- [Menginstal Deno](https://docs.deno.com/runtime/getting_started/installation/)
- [YouTube Runtime Pengaturan](https://github.com/yt-dlp/yt-dlp/wiki/EJS)

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

### Periksa pembebasan sebelum meletakkannya pada pekerja


Dapatkan executables dari halaman peluncuran proyek resmi, atau instal paket Python dari sumber paket yang diterbitkan. Jika Anda mengunduh biner tunggal, bandingkan SHA-256 dengan nama file yang sepadan dalam SHA2-256SUMS dari rilis itu. Rekam pengeluaran dan cek dengan gambar pekerja Anda sehingga Anda dapat mengidentifikasi apa yang berjalan.

**Linux**


**Hash file yang diunduh**

```bash
sha256sum yt-dlp
```


**macOS**


**Hash file yang diunduh**

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


**Windows**


**Hash file yang diunduh**

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


Perbandingan cek hanya berguna ketika nilai yang diharapkan berasal dari pelepasan yang dipercaya, bukan cermin yang sama yang tidak diketahui seperti yang dapat dilaksanakan. Jika perangkat lunak keamanan menandakan file, periksa sumbernya dan laporkan sebelum membuat pengecualian. Ketersediaan sumber terbuka sendiri tidak menjadi bukti bahwa setiap biner atau plugin pihak ketiga yang dimuat turun aman.

Mengendalikan file konfigurasi yang dikongsi sebagai kode untuk diperiksa: opsi seperti --exec dapat memulai perintah, dan plugins menambahkan kode ke proses download. Simpan cookie browser, proxy credentials dan URL yang ditandatangani dari contoh konfigurasi dan laporan diagnostik.

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

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

## Download 1 video


**Menggunakan video singkat pertama.** Cita URL, tambahkan `--no-playlist`, dan nama file dengan ID video. perintah mencetak jalur akhir setelah 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 adalah file setelah penggabungan dan post-proses. buka jalan itu; jangan anggap file akan berakhir di .mp4.

Tanpa format override, yt-dlp memilih arus yang disukai. Sumber berkualitas tinggi sering memiliki streaming video dan audio yang terpisah, jadi dua transfer yang diikuti oleh penggabungan FFmpeg normal. File intermediate dan file .part dapat muncul saat pekerjaan berjalan.

> **Jangan mengekstrak perpanjangan**
> Tetap %(ext)s dalam template output. menamakan WebM stream file.mp4 hanya mengubah namanya. pemilihan format, remuxing dan konversi menentukan apa yang ada di dalam file.

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

## Pilih kualitas dan kode


**Periksa format video ini**

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

**Pilih kebijakan, bukan ID format yang disalin.** Periksa resolusi, kode dan jalur terpisah audio/video.

| Selektor atau Opsi | Artinya | Kapan harus menggunakannya |
| --- | --- | --- |
| Bb + Bb | Pilih streaming video dan audio streaming; FFmpeg menggabungkan mereka. | Anda membutuhkan kedua jalur dan dapat bergabung secara lokal. |
| A/B | Coba selektor A, kemudian B jika A tidak tersedia. | Definisi penurunan eksplisit bukannya menganggap setiap sumber memiliki format yang sama. |
| [height<=1080] | Mengecualikan aliran di atas 1080 piksel tinggi. | Sebuah ikatan atas yang keras adalah sebuah kewajiban. |
| -S res:1080 | Lebih baik resolusi sampai 1080; dapat memilih yang lebih besar ketika tidak ada yang tersedia di bawah ini. | 1080p adalah preferensi daripada atap yang keras. |
| --merge-output-format mp4 | Pilih kontena ketika menggabungkan arus terpisah. | Anda sudah memilih aliran yang kompatibel. tidak transcode codecs. |

**Tetaplah kodek sumber, dengan atap 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"
```

Ini dapat menghasilkan WebM, MP4 atau konten lain yang didukung. itu gagal jika tidak ada format memenuhi langit-langit; itu tidak diam-diam mengunduh 4K.

Untuk editor atau stack playback yang secara khusus membutuhkan H.264 video dan AAC audio, filter codec tersebut dan bergabung dengan MP4. MP4 adalah sebuah kontena: aliran dalam sebuah kontena MP4 masih dapat mengandung codec aplikasi Anda tidak dapat mengekodkan.

**Permintaan H.264 + AAC, sampai 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 kode yang diperlukan tidak tersedia, selektor ketat ini gagal. memutuskan apakah untuk menerima kode sumber yang berbeda atau transcode; jangan menghapus persyaratan secara tidak sengaja.

Remuxing mengembalikan aliran tanpa menyulitkan mereka. Transcoding mengubah codec dan mengkonsumsi CPU sambil berpotensi mengubah kualitas. Gunakan --remux-video ketika aliran sudah sesuai dengan konten target; gunakan konversi FFmpeg yang disengaja ketika decoder downstream membutuhkan codec yang berbeda.

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

## Menjaga audio atau MP3


Jika saluran transeksi Anda menerima kodek audio sumber, muat turun yang streaming langsung. Ini menghindari konversi yang tidak perlu. MP3 berguna ketika konsumen secara spesifik memerlukannya; tingkat bit yang tinggi MP3 tidak dapat memulihkan detail yang sudah hilang di sumber.

**Mengekalkan audio stream 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 sumber konten dan kodek, biasanya M4A/AAC atau WebM/Opus.

**Konversi audio ke 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 memilih pengaturan kualitas variabel terbaiknya; gunakan bitrate seperti 192K ketika spesifikasi downstream Anda membutuhkan satu.

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

## Menyelamatkan captions dan metadata


Koleksi yang berguna membutuhkan lebih dari filename. Simpan ID video, URL sumber, judul, durasi dan capsi yang tersedia sehingga Anda dapat mencari koleksi dan menjejaki aset kembali ke sumbernya. Mulai dengan menyenaraikan trek caption; meminta en tidak berarti setiap video memiliki trek Inggris.

**Inspek captions, kemudian menyimpan track bahasa Inggris 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 memungkinkan capsi otomatis. ini mengambil trek yang ada dan tidak meniru video yang tidak memiliki.

**Media dengan metadata dan sebuah 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"
```

File .info.json adalah metadata operasi terperinci, bukan respon API publik yang bersih. Ini dapat mencakup URL media yang habis dan bidang yang terkait dengan permintaan. Simpan sampel penuh dengan koleksi, dan mengekspor hanya bidang yang diperlukan sistem downstream Anda. Jika kamu inginkan SRT dan bukannya VTT, tambahkan --convert-subs srt dan pastikan FFmpeg tersedia.

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

## Membangun item AI data set


Untuk koleksi pelatihan, memutuskan media dan output teks bersama-sama. Sebuah persyaratan umum adalah video dan audio terbaik yang tersedia, digabungkan ke dalam MP4, dengan capsi berjam-jam dan metadata ekstraksi yang disimpan di bawah ID video yang sama. Sebuah atap resolusi yang berguna untuk previews biasanya adalah default yang salah untuk set data sumber-kualitas.

**Download satu item lengkap data set**

```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 arus terpisah; --remux-video juga mencakup rangkaian rangkaian. gunakan tag bahasa yang tepat dari --list-subs; menggantikan dengan bahasa yang diperlukan oleh database Anda.

Mulai dengan satu bahasa yang tepat. Dalam check live kami, en.* dipilih en, en-en dan en-de; trek ketiga kembali 429 sebelum media download dimulai. Salah satu kesalahan dapat menghentikan item di tahap itu. Setelah penyejukan, hanya menarik trek yang diperlukan, atau memecah media dan caption pekerjaan jika koleksi Anda harus menjaga media ingestion bergerak.

Fallback /best membolehkan aliran gabungan video/audio ketika jalur terpisah tidak tersedia. Menghapus hal tersebut jika kontrak pengumpulan Anda membutuhkan sumber bestvideo dan bestaudio yang terpisah. MP4 tidak berarti H.264: resep ini menyimpan kode sumber yang dipilih. Gunakan selektor H.264/AAC yang ketat di atas jika dekoder pelatihan Anda membutuhkan codec tersebut, atau transcode sebagai langkah terpisah, tercatat.

**File yang diharapkan ketika ada track tag Inggris**

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

Tidak ada file caption yang dibuat ketika jalur yang diminta tidak tersedia; jangan menandakan penutup teks lengkap hanya karena MP4 selesai.

| Kebutuhan | Keputusan Koleksi |
| --- | --- |
| Kualitas sumber yang paling tinggi | Gunakan bestvideo+bestaudio, simpan kode sumber dan verifikasi aliran gabungan dengan ffprobe. |
| Teks yang teratur | Tetap VTT/SRT segmen dan bahasa di samping ID video. teks yang melekat mengabaikan waktu yang diperlukan untuk penyelarasan klip. |
| Teks tidak ada | Rekaman teks yang hilang secara eksplisit.Rute audio yang disimpan ke tahap transcription Anda jika teks wajib. |
| Captions untuk banyak bahasa | Setiap trek tambahan menambahkan permintaan dan dapat bertemu 429 secara independen dari media. |
| Media Resumable + Pengiriman Teks | Gunakan arkib set data yang terpisah dan inventori dengan media, metadata dan status caption. input arkib tidak membuktikan semua halaman yang diperlukan ada. |

Jangan menggunakan ulang arsip yang dibuat oleh media sebelumnya yang hanya berjalan untuk kebijakan baru ini: video yang diarkibkan mungkin terhapus sebelum capsi yang hilang dikumpulkan. Atau menjalankan kebijakan set data dengan arsip sendiri atau jadwal pas untuk perbaikan catatan terpisah untuk ID yang hilang teks. Simpan captions asli; jika model Anda membutuhkan teks transcript yang bersih, derivatkan dalam langkah pemrosesan yang diubah suai.

- [Resep Data yang Sama dalam Python](https://flashdata.dev/id/docs/guides/yt-dlp-python-api/reference.md#dataset)
- [Mengendalikan caption dan metadata 429s](https://flashdata.dev/id/docs/guides/yt-dlp-429-too-many-requests/reference.md)

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

## Meningkatkan transfer melaluiput tanpa mengganggu IP


aria2c dapat membantu ketika satu koneksi menginduksi koneksi yang tidak dapat dipercaya atau latent tinggi. Tidak dapat memperbaiki permintaan pemain yang ditolak atau IP output yang ditandai. Pertama, buat download asli bekerja pada satu sumber; kemudian bandingkan waktu transfer dan kesalahan dengan sejumlah kecil koneksi aria2.

**Mulai dengan dua koneksi per HTTP transfer**

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

Pasang aria2 terlebih dahulu. Gunakan pengunduh bawaan untuk DASH/HLS di sini agar jumlah segmen yang diunduh bersamaan tetap bisa diatur.

| Kontrol | Apa yang membatasi |
| --- | --- |
| aria2c -x 2 | Menghubungkan satu server untuk download. |
| aria2c -s 2 | Pembagian yang diminta untuk satu file; pembagian juga tergantung pada ukuran file dan dukungan server. |
| aria2c -j 1 | Konversi item di dalam yang aria2 invokasi, bukan karyawan yt-dlp lainnya. |
| --concurrent-fragments 1 | Fragment download di dalam native DASH/HLS download. |
| Pekerjaan Anda yang | Total video aktif berbagi host yang sama atau proxy outit IP. |

curl-cffi impersonasi adalah kepunyaan permintaan yt-dlp sendiri; ia tidak mengkonfigurasi aria2 jari TLS. Jika download asli bekerja tetapi aria2 mendapatkan 403, kembali ke asli sebelum mengubah pengaturan ekstrak yang tidak terkait. Tetap ekstraksi dan transfer eksternal pada sesi proxy yang sama.

Dalam operasi FlashData, menaikkan konversi terlalu agresif dapat membuat rute kerja mulai kembali 403 dengan segera. Jika ini terjadi, berhenti pekerjaan lain, kembali ke satu pekerja dan satu koneksi, kemudian re-test. Jangan mengimbangi dengan menambahkan lebih banyak aria2 pembahagian atau menarik aliran yang sama yang ditolak secara paralel. Jika IP itu tetap ditolak pada beban rendah, gunakan aliran kerja penggantian IP 403.

**Transfer asli konservatif untuk perbandingan**

```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 adalah diagnostis bandwidth cap, bukan batas YouTube universal. menaikkan penembusan secara bertahap hanya setelah rute bekerja.

- [aria2 Koneksi dan opsi dibagi](https://aria2.github.io/manual/en/html/aria2c.html)
- [403 Perintah pemulihan](https://flashdata.dev/id/docs/guides/yt-dlp-403-forbidden/reference.md#rate)
- [Kontrol tingkat untuk metadata dan captions](https://flashdata.dev/id/docs/guides/yt-dlp-429-too-many-requests/reference.md#pacing)

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

## Siapkan koleksi


Untuk set kecil yang diketahui, buat UTF-8 urls.txt dengan satu URL jam per baris. Untuk daftar main YouTube, pertama-tama daftar IDnya dalam manifest. Extraction rata memeriksa daftar pemutaran tanpa melakukan extraction penuh untuk setiap video; itu berguna untuk ulasan jangkauan, tetapi entri mungkin tidak memiliki waktu, format dan rincian ketersediaan.

**Membuat Manifest Playlist 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
```

Mengganti YOUR_PLAYLIST_ID. memeriksa urls.txt sebelum memulai transfer media. redirect mengganti manifest ini jika Anda menjalankan lagi.

Untuk menguji koleksi, pilih beberapa entri daftar main dengan --playlist-items 1:5. Tab /video saluran adalah titik awal yang lebih jelas untuk video yang dimuat naik daripada halaman utama saluran yang tidak jelas. Jangan memperlakukan perintah playlist sebagai identitas: item dapat dimasukkan, dipesan kembali atau dihapus.

| Filter | Gunakan | Konsekuensi |
| --- | --- | --- |
| --playlist-items 1:5 | Lima entri pertama dalam daftar saat ini. | Sesuai untuk percobaan kecil, bukan titik pemeriksaan yang berkelanjutan. |
| --dateafter 20260101 | Tinggalkan entri yang tanggal pada atau setelah 1 Januari 2026. | Filter tanggal mungkin masih memerlukan ekstraksi per video. |
| --match-filters "!is_live & duration <= 1800" | Memerlukan item non-live dengan durasi yang diketahui pada waktu maksimum 30 menit. | Entri dengan durasi yang tidak diketahui tidak sesuai dengan filter ketat ini. |
| --download-archive archive.txt | Lakukan penghapusan ID sumber yang sudah tercatat oleh download sebelumnya. | Beroperasi di berbagai judul dan posisi playlist yang berubah. |

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

## Mengumpulkan kembali koleksi dengan aman


Simpan yang berikut sebagai yt-dlp-work.conf dalam folder koleksi Anda, di samping urls.txt. Ini menentukan kebijakan output sekali, memberikan koleksi arsipnya sendiri, dan membatasi retries. Simpan file output dan arsip ini bersama: sebuah arsip mencatat keberhasilan oleh ekstraktor dan ID, bukan oleh jumlah cek atau lokasi file saat ini.

**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 opsi per baris. jalur dalam contoh ini relatif dengan direktori kerja. Gunakan jalur mutlak ketika sebuah kalendar dapat memulai di tempat lain.

**Menggunakan Koleksi**

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

--ignore-config menghapus konfigurasi user/system secara implisit; file --config-locations yang disediakan secara eksplisit masih diisi.

Mengatur perintah yang sama setelah gangguan. ID lengkap dilumpuhkan, dan transfer parsial yang dapat dipulihkan terus di mana disokong. Kegagalan ekstraksi dapat diubah pada rangkaian berikutnya. File .part default adalah status yang berguna; jangan menghapus mereka sebagai langkah retry rutin.

> **Arsip terpisah untuk output terpisah**
> ID tunggal dalam archive.txt tidak membedakan MP3, 1080p dan 4K. Gunakan file arkib yang berbeda untuk kebijakan output yang berbeda. Jika Anda menghapus file media tetapi menyimpan catatan arkibnya, yt-dlp masih akan melumpuhkannya. Jika Anda kemudian mengunggah file ke penyimpanan awan, merekam sukses upload terpisah dari sukses download lokal.

--no-abort-on-error terus melewati input yang tidak tersedia, tetapi berjalan masih dapat keluar nonzero dan kesalahan post-proses membutuhkan perhatian. Hindari menambahkan --ignore-errors hanya untuk mendapatkan pekerjaan hijau: itu dapat memperlakukan kegagalan post-processing sebagai download yang sukses. Periksa log dan output yang selesai sebelum mengisytiharkan koleksi lengkap.

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

## Periksa file yang selesai


File completed-paths.txt adalah inventori yang berguna. Uji output akhir yang sebenarnya daripada streaming sementara video-hanya. ffprobe membaca konten dan streaming metadata; satu laluan dekoding terpisah menangkap masalah yang hanya akan hilang oleh header yang dapat dibaca.

**Periksa file yang 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"
```

Mengganti jalur dengan satu dari completed-paths.txt. periksa jangka waktu yang diharapkan, aliran audio/video yang diperlukan dan codec yang kompatibel dengan decoder.

**Seleksi lengkap decode**

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

Membaca dan memecahkan file penuh tanpa membuat output media baru. periksa status output serta pesan; ini membutuhkan waktu lebih lama dari ffprobe.

| Mencari | Yang perlu dilakukan |
| --- | --- |
| Hanya satu file .part atau streaming terpisah yang tersisa | Periksa kesalahan transfer/merge dan kembali kerja asal; jangan menandakan file pertengahan lengkap. |
| Video bermain tanpa suara | Pemeriksaan format yang dipilih dan ffprobe aliran. format video-hanya membutuhkan pemilihan audio dan penggabungan. |
| MP4 tidak akan dibuka di editor Anda | Periksa codec, bukan hanya ekstensi; pilih aliran yang kompatibel atau transcode secara eksplisit. |
| ID yang diarkibkan tetapi tidak ada file lokal | Periksa apakah file itu moved/deleted. Mengumpulkan inventori sebelum mengubah entri arkib. |

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

## 9 Memperoleh perintah yang terbukti ke pekerjaan yang direncanakan


Lakukan perintah lengkap dengan sukses secara manual sebelum merancang. Jadual biasanya dimulai dengan PATH dan direktori kerja yang berbeda. Berikan itu jalur Python penuh lingkungan virtual, jalur konfigurasi penuh dan direktori kerja yang jelas; juga membuat FFmpeg dan waktu berjalan JavaScript tersedia untuk proses itu.

- Gunakan satu pekerja untuk collection/archive. Jangan biarkan hari kemarin melebihi hari ini melawan output yang sama.
- Pada Linux, gunakan timer/service atau cron entry dengan direktori kerja dan kunci seperti flock. Simpan log di luar folder media dan putar mereka.
- Pada macOS, gunakan lanchd dengan jalur eksekusi absolut dan manual kerja.
- Pada Windows Task Scheduler, tetapkan Program ke lingkungan python.exe, Argumen ke -m yt_dlp ditambah pilihan konfigurasi dan batch, dan Mulai ke folder koleksi.
- Rekor start/end waktu, versi yang dapat diimplementasikan, manifest sumber, status output dan completed/failed menghitung. output nonzero tidak berarti setiap item gagal.
- Simpan file cookie dan pengesahan tujuan dari repositori konfigurasi yang dikongsi. berikan pekerjaan hanya pengesahan yang dibutuhkan.

Pilihan tidur di config bertindak dalam satu proses. Sepuluh pekerja yang menggunakan pengaturan yang sama masih menghasilkan sepuluh aliran permintaan yang berlebihan. Meningkatkan --concurrent-fragments mengubah persaingan fragmen di dalam sebuah download, bukan jumlah video di kotak kerja Anda.

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

## Pilih panduan kesalahan yang tepat


**Mengemas kini lingkungan Python ini**

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

Ketika sumber kerja sebelumnya pecah, update ke malam terakhir pertama, termasuk tambahan yang sepadan. Untuk penggunaan biner yang terpisah yt-dlp --update-to di malam hari; -U hanya tinggal di saluran saat ini. Lakukan sebuah kanary kecil setelah setiap update, kemudian membangun kembali karyawan dan merekam revisi sehingga armada tidak diam-diam mencampur pelepasan.

| Gejala | Mulai dari sini |
| --- | --- |
| `Requested format is not available` | Daftar format dan periksa filter Anda yang ketat sebelum mengubah retries. |
| `ffmpeg not found` / `ffprobe and ffmpeg not found` | Periksa PATH dari akun pekerja atau jadual yang sebenarnya. |
| JavaScript Challenge / Peringatan Runtime yang Hilang | Periksa deteksi waktu berjalan dan paket EJS yang sesuai. |
| HTTP 403 selama transfer | Identifikasi host yang ditolak dan stadium; ekstraksi terpisah dari transfer media. |
| HTTP 429 | Berhenti IP yang terjebak, memungkinkan frekuensi permintaan extraction/caption yang lebih rendah dan dingin. |
| `Sign in to confirm you’re not a bot` | Berhenti mengatur dan mendiagnosis satu sumber, sesi dan jaringan. |

- [403 Diagnosis aliran kerja](https://flashdata.dev/id/docs/guides/yt-dlp-403-forbidden/reference.md)
- [Bot-check diagnostik proses kerja](https://flashdata.dev/id/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [429 Kenaikan tingkat batas](https://flashdata.dev/id/docs/guides/yt-dlp-429-too-many-requests/reference.md)
- [Perintah harian referensi](https://flashdata.dev/id/docs/guides/yt-dlp-commands/reference.md)
- [Membangun Pekerja Python](https://flashdata.dev/id/docs/guides/yt-dlp-python-api/reference.md)

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

## Ketika output tergolong dalam saluran awan


Jika Anda ingin memiliki download, aliran kerja di atas memberi Anda kontrol atas file, format dan pemrosesan. Jika aplikasi Anda membutuhkan media lengkap yang disimpan, FlashData menyediakan pekerjaan download YouTube yang diikuti, pengendalian bot, routing proxy dan retries. Aplikasi Anda mengajukan pengaturan sumber dan output, kemudian menyimpan ID pekerjaan dan catatan pengiriman.

- [Perbandingan dua model operasi](https://flashdata.dev/id/docs/guides/flashdata-vs-yt-dlp/reference.md)
- [Unduhan massal video YouTube](https://flashdata.dev/id/products/youtube-download#bulk-downloads)
- [Coba download demo](https://flashdata.dev/id/products/youtube-download#playground)
- [Download referensi API](https://flashdata.dev/id/docs/sources/youtube_download/reference.md)

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

## Materi Referensi


Referensi opsi upstream adalah sumber kebenaran untuk versi yang diinstal Anda. Gunakan bagian-bagian ini saat mengubah kebijakan pengumpulan atau mengupdate gambar pekerja.

- [Format Seleksi dan Sortering](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)
- [Pertanyaan umum tentang yt-dlp](https://github.com/yt-dlp/yt-dlp/wiki/FAQ)
