Langkau ke kandungan
MS
Dapatkan kunci API
Semak dokumentasi

Panduan

Arahan yt-dlp untuk kerja harian

Salin arahan untuk video, audio, sari kata, set data dan menyambung pengumpulan.

Pada halaman ini

Peraturan dan Konvensyen Perintah

Bermula daripada ketagihan malam dan penuh semasa
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
ffmpeg -version
python -m yt_dlp --list-impersonate-targets

Resep muat turun menggunakan Deno dan --impersonate="" sebagai garis asas. Yang terakhir memerlukan curl-cffi dan membolehkan ia memilih cap jari pelayar yang tersedia. Linux/macOS perintah menggunakan sintax Bash; bagi pekerja yang dirancang, juga membuat ketergantungan ini tersedia dalam persekitaran perkhidmatan itu.

Contoh terminal ini menggunakan pemasangan Python yt-dlp. Gunakan Python persekitaran maya anda, atau tukar Python -m yt_dlp dengan perintah yt-dlp yang berasingan. Gunakan Linux terlebih dahulu, dengan alternatif macOS dan Windows dalam panduan setup. Pemasangan FFmpeg/ffprobe untuk menggabungkan dan Deno untuk YouTube cabaran penyelesaian. Menggantikan contoh URL dengan sumber anda.

KonvensyenKenapa penting
URL dan templateShell sebaliknya menafsirkan watak-watak seperti &, ruang dan parentes.
%(ext)s disimpan dalam nama filMedia yang dipilih dan post-proses menentukan perpanjangan.
Gunakan --no-playlist untuk url jamVideo yang dipautkan daripada senarai main tidak boleh secara tidak dijangka memperluaskan pekerjaan anda.
Periksa konfigurasi anda yang disimpanContoh boleh mewarisi konfigurasi global. gunakan --ignore-config untuk ujian terisolasi.
Windows .bat: dua kali ganda templat peratusan tandaGunakan %(id) dalam fail batch, tetapi %(id) dalam fail PowerShell interaktif dan fail konfigurasi biasa.

Kualiti video dan MP4

Baseline: terbaru malam, Deno dan FFmpeg, dengan --impersonate="". Resep menggunakan Bash; menggantikan URL sampel dengan sumber anda.

Download video dengan pilihan lalai
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -P downloads \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Pilih aliran yang tersedia menggunakan lalai yt-dlp. bekas tidak semestinya MP4.
Senarai format yang tersedia
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Kodek pemeriksaan dan baris audio-only/video-only ID format nombor bukan dasar output mudah alih.
Lebih baik 1080p
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -S "res:1080" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Satu keutamaan: jika tiada format di atau di bawah sasaran tersedia, penarafan boleh memilih satu di atasnya.
Menerapkan maksimum 1080p
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv*[height<=1080]+ba/b[height<=1080]" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Filter: gagal apabila tiada format bertanding. mengekalkan pilihan kodek sumber.
H.264 video dan AAC audio dalam MP4
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 "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Pemilihan kodek yang ketat. memerlukan format yang sepadan dan FFmpeg untuk penggabungan aliran berasingan.

Kumpulan data AI: MP4 + captions + metadata

Video + audio terbaik, MP4, capsi dan metadata
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" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
FFmpeg menggabungkan aliran sumber. MP4 mengekalkan kodek sumber; memeriksa kompatibiliti decoder dan penutup tajuk secara berasingan.

Penghantaran ke luar : aria2c

Dua sambungan, asli DASH/HLS
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 "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Memerlukan program aria2c. Pastikan satu video berjaya dimuat turun sebelum menambah sambungan. Kurangkan sambungan dengan segera jika ralat 403 muncul.

aria2 mempunyai pelaksanaan rangkaian sendiri. yt-dlp impersonasi curl-cffi tidak mengkonfigurasi cap jari aria2. Jika hanya pemuat turun luaran gagal, gunakan --downloader asli dan bandingkan sumber dan laluan proxy yang sama.

Perbezaan antara audio dan MP3

Menyelamatkan aliran audio asal
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"
Tidak MP3 penukaran. berguna apabila saluran transcription atau playback anda menerima kodek asal.
Menukar kepada MP3 pada bitrat sasaran
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
  --audio-format mp3 --audio-quality 192K -P audio \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Penggunaan FFmpeg. 192K mengawal pengekodan output; ia tidak mengembalikan kualiti sumber.
Lebih baik M4A tanpa transcoding
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f "ba[ext=m4a]" -P audio \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Kegagalan jika tiada format audio sahaja M4A tersedia.Tambah /ba hanya jika aplikasi anda menerima bekas sumber lain.
MP3 dengan metadata dan penutup
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
  --audio-format mp3 --embed-metadata --embed-thumbnail -P audio \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Langkah-langkah metadata/thumbnail adalah post-proses tambahan. semak fail akhir, bukan hanya hoki pemindahan.

Tajuk dan subtitle

Senarai laluan yang tersedia
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --list-subs "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Baca tag bahasa yang ditawarkan oleh sumber ini sebelum memilih --sub-langs.
Download subtitle Bahasa Inggeris sahaja
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-subs \
  --sub-langs "en.*" --sub-format "vtt/best" -P captions -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Ia tidak jatuh kembali kepada captions automatik dan tidak memuat turun media.
Juga membenarkan capsi bahasa Inggeris automatik
python -m yt_dlp --js-runtimes deno --impersonate="" --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"
en.* boleh sepadan dengan pelbagai varian Bahasa Inggeris. ini mengambil trek yang tersedia; ia tidak menjalankan pengiktirafan ucapan.
Menukar laluan yang dipilih kepada SRT
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-subs \
  --write-auto-subs --sub-langs "en" --convert-subs srt -P captions \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Memerlukan FFmpeg. Pilih kod bahasa lain daripada --list-subs jika perlu.
Menambah subtitle yang disediakan dalam MKV
python -m yt_dlp --js-runtimes deno --impersonate="" --write-subs --sub-langs "en" \
  --embed-subs --remux-video mkv -P downloads "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Muat turun media, permintaan yang disampaikan dalam bahasa Inggeris subtitle dan memasukkan trek yang tersedia. semak sama ada trek itu wujud terlebih dahulu.

Meminta semua bahasa caption boleh meningkatkan jumlah permintaan dan fail. Pastikan bahasa yang diminta jelas untuk kerja rutin. Simpan ID sumber dan bahasa dalam inventori set data anda supaya transcripts tidak terpisah daripada media yang mereka jelaskan.

Metadata dan laluan output

Mencetak satu video metadata sebagai JSON
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --dump-json "https://www.youtube.com/watch?v=jNQXAC9IVRw" > video.json
Simulasi muat turun secara lalai, tetapi menjalankan ekstraksi. pengalihan menggantikan video.json.
Menulis sidecar metadata penuh tanpa media
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-info-json \
  -P metadata -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Mencipta .info.json sidecar. ini adalah data pengekstrak operasi; medan projek sebelum mendedahkan ia kepada orang awam.
Download hanya mini
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-thumbnail \
  -P thumbnails -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Ia menyimpan mini yang tersedia dalam format sumbernya. --convert-thumbnails jpg menambah langkah penukaran apabila JPEG diperlukan.
Cetak laluan media akhir selepas pemprosesan
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --print after_move:filepath -P downloads -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Berbeza dengan peringkat lalai --print, after_move cetakan menunggu untuk muat turun sebenar dan pergerakan akhir.
Menambah laluan selesai kepada manifest
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --print-to-file after_move:filepath completed-paths.txt -P downloads \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Menambah, jadi penarikan boleh menghasilkan entri berulang.Mengendalikan ia sebagai log penyelesaian, bukan inventori yang dipecah-belah.

Tempoh dan bab

Mengunduh sekejap 5 melalui 10
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --download-sections "*00:00:05-00:00:10" -o "clips/%(id)s-%(section_start)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Permintaan FFmpeg. sempadan klip boleh menyesuaikan dengan bingkai kunci yang tersedia; mengesahkan output apabila tepat masa yang penting.
Rekod semula di sekitar pemotongan yang diminta
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --download-sections "*00:00:05-00:00:10" --force-keyframes-at-cuts \
  -o "clips/%(id)s-%(section_start)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Menambah kerja-kerja pengekodan semula untuk meningkatkan pemotongan pada sempadan yang diminta. memeriksa tempoh yang dihasilkan dan penyesuaian audio/video.
Membahagikan video yang dibahagikan kepada fail
python -m yt_dlp --split-chapters -o "chapter:%(id)s-%(section_number)03d.%(ext)s" \
  "https://www.youtube.com/watch?v=YOUR_VIDEO_ID"
Gunakan video dengan metadata bab. output bab terpisah daripada download penuh asal; ruang cakera bajet untuk kedua-duanya.

Gunakan dasar output atau arkib yang berbeza untuk klip dan video penuh. entri arkib peringkat sumber tidak menyulitkan start/end kali yang dipilih, jadi satu arkib yang dikongsi boleh memadamkan klip kemudian yang anda akan cipta.

Senarai dan senarai URL

Download senarai URL yang diketahui
python -m yt_dlp --no-playlist --batch-file urls.txt -P collection -o "%(id)s.%(ext)s"
Mencipta fail UTF-8 dengan satu URL jam per baris. --no-playlist digunakan untuk menonton URL yang mengandungi konteks senarai main.
Memeriksa senarai main YouTube tanpa pengekstrakan video penuh
python -m yt_dlp --flat-playlist \
  --dump-json "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID" > playlist.jsonl
Satu JSON objek per entri. entri rata boleh terlepas tempoh dan butiran format.
Download 5 entri pertama dalam senarai main
python -m yt_dlp --playlist-items 1:5 -P collection -o "%(playlist_index)03d-%(id)s.%(ext)s" \
  "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID"
Indikator senarai main ialah menunjukkan perintah, bukan identiti. simpan ID video dalam nama fail.
Mengehadkan video yang layak mengikut tarikh dan tempoh
python -m yt_dlp --dateafter 20260101 --match-filters "!is_live & duration <= 1800" \
  --batch-file urls.txt
Ia memerlukan item bukan hidup dengan tempoh yang diketahui sehingga 30 minit, tarikh pada atau selepas Januari 1, 2026. penapisan masih boleh memerlukan permintaan per video.
Hentikan selepas 10 muat turun
python -m yt_dlp --download-archive archive.txt --max-downloads 10 --batch-file urls.txt
Batas mengawal fail yang baru dimuat turun, bukan berapa banyak permintaan listing/extraction berlaku.

Arkib dan pemulihan

Menggambar semula koleksi dengan dasar yang sama
python -m yt_dlp --download-archive archive.txt --continue --no-abort-on-error -P collection \
  -o "%(id)s.%(ext)s" --batch-file urls.txt
ID yang selesai diselesaikan. pemindahan sebahagian kembali di mana disokong. gunakan laluan arkib dan output yang sama seperti kerja asal.
Menyelamatkan seorang pekerja dan mengikat pencen
python -m yt_dlp --sleep-requests 1 --sleep-interval 5 --max-sleep-interval 10 --retries 3 \
  --fragment-retries 3 --socket-timeout 30 --batch-file urls.txt
Menambah had pekerja peringkat kue apabila beberapa proses berkongsi laluan atau sesi.
Kapal Penghantaran Bandwidth
python -m yt_dlp --js-runtimes deno --impersonate="" --limit-rate 2M \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Mengawal kadar pemindahan media. ia tidak mengawal bilangan permintaan pengekstrakan.
Mengurangkan persaingan fragmen asli
python -m yt_dlp --js-runtimes deno --impersonate="" --concurrent-fragments 1 \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Mulakan dengan satu fragmen pada masa yang sama apabila menyiasat 403s. proses pekerja lain masih menambah permintaan mereka sendiri.

Konfigurasi dan Filenama

Hanya muat turun koleksi eksplisit anda config
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf --batch-file urls.txt
Konfig yang dinamakan secara eksplisit juga boleh dimuat dengan --ignore-config. gunakan laluan penuh untuk pekerjaan yang dijadualkan.
Nama yang boleh dibaca dengan identiti yang stabil
python -m yt_dlp --js-runtimes deno --impersonate="" -P downloads \
  -o "%(channel_id)s/%(upload_date)s-%(title).150B [%(id)s].%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Tajuk dikelilingi kepada 150 byte dalam templat ini. ID membezakan tajuk yang berulang atau berubah.
Menggunakan direktori sementara yang berasingan
python -m yt_dlp --js-runtimes deno --impersonate="" -P "home:downloads" -P "temp:work" \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Pastikan kedua-dua direktori mempunyai ruang yang mencukupi; sistem fail yang berbeza mungkin memerlukan salinan.

Untuk koleksi jangka panjang, memutuskan sama ada nama filenam harus menjadi kunci aplikasi yang boleh dibaca oleh manusia atau stabil. Nama dan tajuk saluran boleh berubah. Channel/video ID adalah kunci yang lebih baik untuk deduplikasi, dengan medan deskriptif yang disimpan dalam metadata.

Cookies dan laluan runtime

Gunakan profil pelayar yang mempunyai akses
python -m yt_dlp --js-runtimes deno --impersonate="" \
  --cookies-from-browser "chrome:Profile 1" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Menggantikan Profil 1 dengan profil pelayar sebenar anda. gunakan kuki sesi hanya apabila perlu, dan simpan mereka peribadi.
Membaca fail kuki peribadi yang sedia ada
python -m yt_dlp --js-runtimes deno --impersonate="" --cookies private/youtube-cookies.txt \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Permintaan format fail cookie Netscape. satu JSON eksport tidak setara.
Gunakan Deno yang boleh dijalankan di luar PATH pekerja
python -m yt_dlp --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Menggantikan laluan dengan Deno binari yang dipasang untuk pekerja anda.

Diagnosis dan pengesahan

Periksa ekstraksi bersih
python -m yt_dlp --js-runtimes deno --impersonate="" --ignore-config --verbose --simulate \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Menghapuskan konfigurasi implisit dan menyimpan tiada media. ia masih membuat permintaan pengekstrakan dan tidak membuktikan bahawa pemindahan akan berjaya.
Menangkap log diagnostik peribadi
python -m yt_dlp --js-runtimes deno --impersonate="" --ignore-config --verbose --simulate \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw" > diagnostic.log 2>&1
Pengalihan menggantikan log. mengedit nilai cookie/header, pengesahan proxy dan URL yang ditandatangani sebelum berkongsi.
Pemeriksaan aliran yang disimpan dan tempoh
ffprobe -v error -show_entries format=duration,size:stream=codec_type,codec_name,width,height -of json "YOUR_OUTPUT_FILE"
Gunakan laluan akhir, selepas pemprosesan. ffprobe membaca tajuk; ia tidak memecahkan setiap bingkai.
Mengecualikan fail yang disimpan tanpa mencipta output
ffmpeg -v error -i "YOUR_OUTPUT_FILE" -f null -
Semak lebih dalam yang membaca keseluruhan fail. semak status keluar dan mesej.
Memperbaharui pakej Python dan semak versi
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version