Langkau ke kandungan
MS
Dapatkan kunci API
Semak dokumentasi

Panduan

Cara menggunakan yt-dlp

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

Pada halaman ini

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.

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

Pengenalan kepada Linux Workers
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
Alat FonApa yang ia lakukanPeriksa
Python 3.11+Pelaksanaan pakej Python dan contoh dalam siri ini.python --version
Terakhir yt-dlp malam + lalai,curl-cffi ekstrasEkstraktor YouTube semasa, menyesuaikan penyelesai EJS dan sokongan impersonasi pelayar.python -m yt_dlp --version
FFmpeg dan ffprobeMenggabungkan 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
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
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.

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.

Hash fail yang dimuat turun
sha256sum yt-dlp

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.

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

Pilih kualiti dan kodek

Periksa format video ini
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 pilihanArtibila nak guna
Bb + BbPilih video sahaja dan audio sahaja; FFmpeg menggabungkan mereka.Anda memerlukan kedua-dua trek dan boleh menggabungkan secara tempatan.
A/BCuba 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:1080Lebih 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 mp4Pilih bekas apabila menggabungkan aliran berasingan.Anda telah memilih aliran yang kompatibel. ia tidak transcode codecs.
Menjaga kodek sumber, dengan bumbung 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"
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
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.

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

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

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
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
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 KemurtadanKeputusan Koleksi
Kualiti sumber yang paling tinggiGunakan bestvideo+bestaudio, simpan kodek sumber dan semak aliran gabungan dengan ffprobe.
Teks yang disusunSimpan segmen VTT/SRT dan bahasa di sebelah ID video. teks yang melengkung mengecualikan masa yang diperlukan untuk penyelarasan klip.
Tiada kapsyenRekod teks yang hilang secara eksplisit.Rute audio yang disimpan ke peringkat transcription anda jika teks adalah wajib.
Captions untuk banyak bahasaSetiap trek tambahan menambah permintaan dan boleh bertemu 429 tanpa mengira media.
Media Resumable + Penghantaran teksGunakan 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.

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
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.
PengawalApa yang membatasi
aria2c -x 2Menyambung ke satu pelayan untuk satu muat turun.
aria2c -s 2Pembahagian yang diminta untuk satu fail; pembahagian juga bergantung kepada saiz fail dan sokongan pelayan.
aria2c -j 1Perbezaan antara perkara-perkara di dalam aria2 permohonan, bukan pekerja lain yt-dlp.
--concurrent-fragments 1Fragment download di dalam native DASH/HLS download.
Pekerjaan anda yangKeseluruhan 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
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.

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

FilterGunaakibat
--playlist-items 1:55 entri pertama dalam senarai semasa.berguna untuk percubaan kecil, bukan titik pemeriksaan yang berterusan.
--dateafter 20260101Simpan 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.txtSkip ID sumber yang telah disimpan oleh muat turun terdahulu.Beroperasi di atas tajuk yang berubah dan kedudukan playlist.

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

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

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
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
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.
MencariTindakan
Hanya satu .part atau fail streaming berasingan yang tersisaPeriksa kesilapan transfer/merge dan mengembalikan kerja asal; jangan menandakan fail pertengahan lengkap.
Video Bermain Tanpa SuaraSemak format yang dipilih dan ffprobe aliran. format video sahaja memerlukan pemilihan audio dan penggabungan.
MP4 tidak akan dibuka dalam editor andaSemak kodek, bukan hanya ekstensi; pilih aliran yang kompatibel atau transcode secara eksplisit.
ID yang disimpan tetapi tiada fail tempatanSemak sama ada fail itu moved/deleted. Rekonversi inventori sebelum mengubah entri arkib.

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.

Pilih panduan kesilapan yang betul

Meningkatkan persekitaran Python ini
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.

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

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.

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.