Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Panduan

Cara menggunakan yt-dlp

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

Di halaman ini

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.

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
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
AlatApa yang dilakukanPeriksa
Python 3.11+Menggunakan paket Python dan contoh dalam seri ini.python --version
Terakhir yt-dlp malam + default,curl-cffi ekstrasYouTube Extractor, sesuai dengan penyelesai EJS dan dukungan peribadi browser.python -m yt_dlp --version
FFmpeg dan ffprobeMenggabungkan 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
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
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.

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.

Hash file yang diunduh
sha256sum yt-dlp

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.

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

Pilih kualitas dan kode

Periksa format video ini
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 OpsiArtinyaKapan harus menggunakannya
Bb + BbPilih streaming video dan audio streaming; FFmpeg menggabungkan mereka.Anda membutuhkan kedua jalur dan dapat bergabung secara lokal.
A/BCoba 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:1080Lebih 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 mp4Pilih kontena ketika menggabungkan arus terpisah.Anda sudah memilih aliran yang kompatibel. tidak transcode codecs.
Tetaplah kodek sumber, dengan atap yang keras 1080p
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
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.

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

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

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
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
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.
KebutuhanKeputusan Koleksi
Kualitas sumber yang paling tinggiGunakan bestvideo+bestaudio, simpan kode sumber dan verifikasi aliran gabungan dengan ffprobe.
Teks yang teraturTetap VTT/SRT segmen dan bahasa di samping ID video. teks yang melekat mengabaikan waktu yang diperlukan untuk penyelarasan klip.
Teks tidak adaRekaman teks yang hilang secara eksplisit.Rute audio yang disimpan ke tahap transcription Anda jika teks wajib.
Captions untuk banyak bahasaSetiap trek tambahan menambahkan permintaan dan dapat bertemu 429 secara independen dari media.
Media Resumable + Pengiriman TeksGunakan 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.

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
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.
KontrolApa yang membatasi
aria2c -x 2Menghubungkan satu server untuk download.
aria2c -s 2Pembagian yang diminta untuk satu file; pembagian juga tergantung pada ukuran file dan dukungan server.
aria2c -j 1Konversi item di dalam yang aria2 invokasi, bukan karyawan yt-dlp lainnya.
--concurrent-fragments 1Fragment download di dalam native DASH/HLS download.
Pekerjaan Anda yangTotal 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
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.

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

FilterGunakanKonsekuensi
--playlist-items 1:5Lima entri pertama dalam daftar saat ini.Sesuai untuk percobaan kecil, bukan titik pemeriksaan yang berkelanjutan.
--dateafter 20260101Tinggalkan 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.txtLakukan penghapusan ID sumber yang sudah tercatat oleh download sebelumnya.Beroperasi di berbagai judul dan posisi playlist yang berubah.

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
# 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
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.

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

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
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
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.
MencariYang perlu dilakukan
Hanya satu file .part atau streaming terpisah yang tersisaPeriksa kesalahan transfer/merge dan kembali kerja asal; jangan menandakan file pertengahan lengkap.
Video bermain tanpa suaraPemeriksaan format yang dipilih dan ffprobe aliran. format video-hanya membutuhkan pemilihan audio dan penggabungan.
MP4 tidak akan dibuka di editor AndaPeriksa codec, bukan hanya ekstensi; pilih aliran yang kompatibel atau transcode secara eksplisit.
ID yang diarkibkan tetapi tidak ada file lokalPeriksa apakah file itu moved/deleted. Mengumpulkan inventori sebelum mengubah entri arkib.

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.

Pilih panduan kesalahan yang tepat

Mengemas kini lingkungan Python ini
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.

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

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.

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.