Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Panduan

Perintah yt-dlp untuk pekerjaan sehari-hari

Salin perintah untuk video, audio, subtitel, set data, dan melanjutkan pengumpulan.

Di halaman ini

Konvensi dan Konvensi Perintah

Mulai dari ketergantungan malam dan lengkap saat ini
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
ffmpeg -version
python -m yt_dlp --list-impersonate-targets

Resep download menggunakan Deno dan --impersonate="" sebagai garis dasar. Yang terakhir membutuhkan curl-cffi dan membiarkan ia memilih jari browser yang tersedia. Linux/macOS perintah menggunakan sintax Bash; untuk pekerja yang dijadwalkan, juga membuat ketergantungan ini tersedia di lingkungan layanan itu.

Contoh terminal ini menggunakan instalasi Python yt-dlp. Gunakan Python lingkungan virtual Anda, atau menggantikan Python -m yt_dlp dengan perintah yt-dlp yang terpisah. Gunakan Linux terlebih dahulu, dengan alternatif macOS dan Windows dalam panduan pengaturan. Instal FFmpeg/ffprobe untuk menggabungkan dan Deno untuk YouTube Challenge Solving. Mengganti URL dengan sumber Anda.

KonvensyenMengapa itu penting
URL dan templateShell sebaliknya menafsirkan karakter seperti &, ruang dan parentes.
%(ext)s disimpan dalam nama fileMedia yang dipilih dan post-processing menentukan perpanjangan.
Gunakan --no-playlist untuk url jamVideo yang terhubung dari daftar main tidak harus secara tidak dijangka memperluas pekerjaan Anda.
Periksa konfigurasi yang disimpanContoh dapat mewarisi konfig global. gunakan --ignore-config untuk tes terisolasi.
Windows .bat: dua template peratus tandaGunakan %(id) dalam file batch, tetapi %(id) dalam file PowerShell interaktif dan konfigurasi normal.

Kualitas video dan MP4

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

Download video dengan default selection
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 default yt-dlp. kontena tidak semestinya MP4.
Daftar format yang tersedia
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Inspek kodek dan baris audio-only/video-only. ID format numerik tidak merupakan kebijakan output portabel.
Lebih baik 1080p
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -S "res:1080" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Keutamaan: Jika tidak ada format di atau di bawah target yang tersedia, sorting dapat memilih salah satu di atasnya.
Menggunakan 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 ketika tidak ada format yang sepadan. 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"
Memerlukan format yang sepadan dan FFmpeg untuk penggabungan aliran terpisah.

Data set 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 menyimpan kodek sumber; memeriksa kompatibilitas decoder dan penutup tag secara terpisah.

Download dari : aria2c

Dua koneksi, 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 unduhan satu video berhasil sebelum menambah koneksi. Segera kurangi koneksi jika muncul galat 403.

aria2 memiliki implementasi jaringan sendiri. yt-dlp impersonasi curl-cffi tidak mengkonfigurasi aria2 jari. Jika hanya download eksternal gagal, gunakan --downloader asli dan bandingkan sumber dan rute proxy yang sama.

Audio dan MP3

Menjaga Audio Stream Asli
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 konversi. berguna ketika transcription atau playback pipeline menerima codec asli.
Konversi ke MP3 pada target bitrate
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"
Menggunakan FFmpeg. 192K mengontrol pengekodan output; ia tidak memulihkan kualitas 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 tidak ada format audio-hanya M4A tersedia.Tambahkan /ba hanya jika aplikasi Anda menerima konten sumber lain.
MP3 dengan metadata tertanam 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 metadata/thumbnail adalah post-processing tambahan. periksa file akhir, bukan hanya transfer hook.

Capsion dan subtitle

Daftar jalur 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 Inggris yang disediakan hanya
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"
Tidak jatuh kembali ke captions otomatis dan tidak mengunduh media.
Juga memungkinkan captions bahasa Inggris otomatis
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"
* dapat memenuhi varian bahasa Inggris yang berbilang. ini mengambil jalur yang tersedia; tidak menjalankan pengenalan ucapan.
Konversi jalur yang dipilih ke 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 kode bahasa lain dari --list-subs jika perlu.
Mengintegrasikan 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"
Mengunduh media, permintaan yang disampaikan dalam bahasa Inggris subtitle dan memasukkan jalur yang tersedia. periksa apakah jalur itu ada terlebih dahulu.

Menerima semua bahasa caption dapat secara signifikan meningkatkan jumlah permintaan dan file. Tetap bahasa yang diminta secara eksplisit untuk kerja rutin. Simpan ID sumber dan bahasa dalam inventori database Anda sehingga transcript tidak terpisah dari media yang mereka jelaskan.

Metadata dan output pathways

Mencetak satu video dengan 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 download secara default, tetapi melakukan ekstraksi. redirect menggantikan video.json.
Menulis halaman 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"
Membuat berkas pendamping .info.json. Berkas ini berisi data operasional dari pengekstrak. Pilih bidang yang diperlukan sebelum memublikasikannya.
Download hanya untuk miniatur
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"
Menyimpan mini yang tersedia dalam format sumbernya. --convert-thumbnails jpg menambahkan langkah konversi ketika JPEG diperlukan.
Cetak jalur media akhir setelah pemrosesan
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"
Tidak seperti tahap default --print, cetakan after_move menunggu untuk download nyata dan langkah akhir.
Menambah jalur yang selesai ke 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, sehingga penarikan dapat menghasilkan entri berulang. perlakukan sebagai log penyelesaian, bukan inventori yang dikumpulkan.

Waktu dan bab

Download sekunder 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"
Memerlukan FFmpeg. batas klip dapat berkoordinasi dengan frame key yang tersedia; memverifikasi output ketika tepat waktu penting.
Mengekodkan kembali 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 untuk meningkatkan pemotongan pada batas yang diminta. memeriksa durasi yang dihasilkan dan alignment audio/video.
Membagi video yang dibagi menjadi file
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 dari download penuh asli; ruang cakera anggaran untuk keduanya.

Gunakan kebijakan output atau arkib yang berbeda untuk klip dan video penuh. input arkib tingkat sumber tidak mengenkripsi waktu yang dipilih start/end, sehingga satu arkib yang dikongsi dapat menekan klip kemudian yang akan Anda ciptakan.

Daftar dan URL

Download URL yang dikenal
python -m yt_dlp --no-playlist --batch-file urls.txt -P collection -o "%(id)s.%(ext)s"
Buat file UTF-8 dengan satu URL per baris. --no-playlist berlaku untuk menonton URL yang mencakup konteks playlist.
Periksa daftar main YouTube tanpa ekstraksi 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 mungkin melewatkan waktu dan detail format.
Download 5 Daftar Pertandingan Pertama
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"
Indeks playlist adalah menunjukkan perintah, bukan identitas. simpan ID video dalam nama file.
Mengurangi video yang layak berdasarkan tanggal dan durasi
python -m yt_dlp --dateafter 20260101 --match-filters "!is_live & duration <= 1800" \
  --batch-file urls.txt
Item yang tidak hidup dengan durasi yang diketahui hingga 30 menit, tanggal pada atau setelah Januari 1, 2026.
Berhenti setelah 10 download baru
python -m yt_dlp --download-archive archive.txt --max-downloads 10 --batch-file urls.txt
Batas mengontrol file yang baru diunduh, tidak berapa banyak permintaan listing/extraction terjadi.

Arsip dan pemulihan

Menggambarkan koleksi dengan kebijakan 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 lengkap terlepas. download parsial kembali di mana didukung. gunakan jalur arsip dan output yang sama dengan pekerjaan asal.
Menyelamatkan seorang pekerja dan mengikat pensiunnya
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
Tambah batas pekerja tingkat kue ketika beberapa proses berbagi rute atau sesi.
Cap transfer bandwidth
python -m yt_dlp --js-runtimes deno --impersonate="" --limit-rate 2M \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Mengontrol tingkat transfer media. tidak mengatur jumlah permintaan ekstraksi.
Mengurangi Kompetisi Fragmen Indigenous
python -m yt_dlp --js-runtimes deno --impersonate="" --concurrent-fragments 1 \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Mulai dengan satu fragmen pada saat penyelidikan 403s. proses pekerja lain masih menambahkan permintaan kontemporer mereka sendiri.

Konfigurasi dan Filenama

Hanya muat koleksi eksplisit Anda config
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf --batch-file urls.txt
Konfigurasi yang disebut secara eksplisit juga diisi dengan --ignore-config. gunakan jalur penuh untuk pekerjaan yang dijadwalkan.
Nama yang dapat dibaca dengan identitas 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"
Judul dikurangi menjadi 150 byte dalam template ini. ID membedakan judul duplikat atau berubah.
Menggunakan direktori sementara yang terpisah
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"
Perhatikan bahwa kedua direktori memiliki ruang yang cukup; sistem file yang berbeda mungkin memerlukan salinan.

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

Cookie dan jalan runtime

Gunakan profil browser yang memiliki akses
python -m yt_dlp --js-runtimes deno --impersonate="" \
  --cookies-from-browser "chrome:Profile 1" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Mengganti Profil 1 dengan profil browser Anda yang sebenarnya. gunakan cookie sesi hanya ketika diperlukan, dan tetap privasi.
Baca file cookie pribadi yang ada
python -m yt_dlp --js-runtimes deno --impersonate="" --cookies private/youtube-cookies.txt \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Memerlukan format file cookie Netscape.A JSON ekspor tidak setara.
Gunakan Deno yang dapat diimplementasikan 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"
Mengganti jalur dengan Deno biner yang dipasang untuk pekerja Anda.

Diagnosis dan verifikasi

Periksa ekstraksi yang bersih
python -m yt_dlp --js-runtimes deno --impersonate="" --ignore-config --verbose --simulate \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Menghapus konfigurasi implisit dan tidak menyimpan media. masih membuat permintaan ekstraksi dan tidak membuktikan transfer akan berhasil.
Menangkap log diagnostik pribadi
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
Redact cookie/header nilai, proxy pengesahan dan URL yang ditandatangani sebelum berbagi.
Pemeriksaan aliran yang disimpan dan durasi
ffprobe -v error -show_entries format=duration,size:stream=codec_type,codec_name,width,height -of json "YOUR_OUTPUT_FILE"
Gunakan jalur akhir, setelah pemrosesan. ffprobe membaca headers; ia tidak mendekodkan setiap bingkai.
Menghapus file yang disimpan tanpa membuat output
ffmpeg -v error -i "YOUR_OUTPUT_FILE" -f null -
Periksa lebih dalam yang membaca seluruh file. periksa status output dan pesan.
Update paket Python dan periksa versi
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version