Anda mau apa
Hanya audio akan mengambil trek suaranya dan membuang video.
Referensi opsi yt-dlp
Ditulis untuk yt-dlp 2026.07.21. Opsi ditambah dan diganti nama antar versi, jadi periksa versi Anda dengan yt-dlp --version.
Dasar
Video dan kualitas
-f FORMAT
--format
Kualitas maksimum
Membatasi tinggi gambar. yt-dlp tetap memilih trek terbaik pada batas itu atau di bawahnya.
-f FORMAT
--format
Format selector sendiri
Menggantikan pilihan kualitas. Untuk yang sudah paham sintaks format.
Contoh
-f "bv*[vcodec^=av01]+ba"-f "b[filesize<50M]"
--merge-output-format FORMAT
butuh ffmpeg
Container
Jenis berkas tempat trek video dan audio yang terpisah digabungkan.
--remux-video FORMAT
butuh ffmpeg
Remux ke
Mengemas ulang trek tanpa encode ulang. Cepat dan tanpa kehilangan kualitas.
--recode-video FORMAT
butuh ffmpeg
Encode ulang ke
Meng-encode ulang video. Lambat dan menurunkan kualitas — hanya kalau remux tidak bisa.
Audio
--audio-format FORMAT
butuh ffmpeg
Format audio
Berkas tujuan konversi audio.
--audio-quality QUALITY
butuh ffmpeg
Kualitas audio
VBR memberi rasio ukuran-ke-kualitas terbaik; bitrate tetap lebih mudah diperkirakan.
Subtitle
Subtitle
Menyisipkan menaruh subtitle di dalam video; menyimpan menulis berkas .srt terpisah di sebelahnya.
Bahasa subtitle
Dipisah dengan koma. Pakai all untuk semua bahasa yang tersedia.
Contoh
--sub-langs "en,vi"--sub-langs "en.*,ja"--sub-langs all
Subtitle otomatis
Sertakan subtitle buatan mesin bila tidak ada subtitle buatan manusia.
Playlist dan channel
Penanganan playlist
Apa yang dilakukan bila URL termasuk video sekaligus playlist.
-I ITEM_SPEC
--playlist-items
Item yang mana
Rentang dan daftar keduanya bisa, misalnya 1-10,15 atau -5::2 untuk satu dari setiap dua item dari belakang.
Contoh
-I 1:5-I "1,3,7-10"-I "-5::2"
Berkas riwayat
Mencatat apa yang sudah diunduh sehingga menjalankan ulang akan melewatinya. Ini cara menjaga sebuah channel tetap sinkron.
Potongan dan bab
--download-sections REGEX
butuh ffmpeg
Unduh sebagian saja
Rentang waktu seperti *00:01:30-00:03:00, atau nama bab. Tanda bintang di depan berarti itu penanda waktu.
Contoh
--download-sections "*00:01:30-00:03:00"--download-sections "intro"
--split-chapters
butuh ffmpeg
Pisah per bab
Menulis satu berkas per bab, bukan satu berkas panjang.
Metadata dan sampul
--embed-thumbnail
butuh ffmpeg
Sisipkan thumbnail
Memakai thumbnail video sebagai sampul.
--embed-metadata
butuh ffmpeg
Sisipkan metadata
Menulis judul, pengunggah, dan tanggal ke dalam berkasnya sendiri.
--embed-chapters
butuh ffmpeg
Sisipkan bab
Menambahkan penanda bab yang bisa dilompati pemutar Anda.
Simpan berkas thumbnail
Menulis gambar sampul di sebelah video.
Simpan deskripsi
Menulis deskripsi ke berkas .description.
Simpan metadata JSON
Menulis semua yang yt-dlp ketahui tentang video ke berkas .info.json.
SponsorBlock
--sponsorblock-remove CATS
butuh ffmpeg
Hapus potongan
Memotong bagian yang ditandai komunitas dari berkas, memakai data SponsorBlock.
Tandai potongan sebagai bab
Potongannya tetap ada tapi ditandai, sehingga Anda bisa melompatinya sendiri.
Berkas dan folder
-o [TYPES:]TEMPLATE
--output
Templat nama berkas
Nama kolom ditulis dalam %(...)s. Garis miring membuat folder.
Contoh
-o "%(title)s.%(ext)s"-o "%(playlist_index)02d - %(title)s.%(ext)s"
-P [TYPES:]PATH
--paths
Folder unduhan
Tempat berkas ditulis. Gabungkan dengan templat di atas untuk membuat subfolder.
Nama berkas aman (hanya ASCII)
Membuang aksen, spasi, dan karakter apa pun yang mungkin ditolak sistem berkas tertentu.
Nama yang aman untuk Windows
Membuang karakter yang ditolak Windows, bahkan saat dijalankan di sistem lain.
Pangkas nama menjadi
Panjang maksimum nama berkas dalam karakter.
Timpa berkas yang ada
Mengganti berkas yang sudah ada di sana.
-w
--no-overwrites
Jangan pernah timpa
Melewati apa pun yang sudah diunduh.
-c
--continue
Lanjutkan unduhan yang terputus
Melanjutkan dari tempat unduhan berhenti.
Filter
Diunggah setelah
YYYYMMDD, atau tanggal relatif seperti now-1month.
Contoh
--dateafter 20240101--dateafter now-1month
Diunggah sebelum
YYYYMMDD, atau tanggal relatif.
Ukuran minimum
Melewati yang lebih kecil. Menerima 5M, 500K, dan sejenisnya.
Ukuran maksimum
Melewati yang lebih besar.
Berhenti setelah
Jumlah berkas yang diunduh sebelum berhenti.
Jaringan
-r RATE
--limit-rate
Batas kecepatan
Misalnya 2M atau 500K. Berguna saat Anda butuh sisa bandwidth untuk hal lain.
-N N
--concurrent-fragments
Fragment paralel
Mempercepat trek yang terbagi fragment. Empat adalah titik awal yang wajar.
-R RETRIES
--retries
Percobaan ulang
Berapa kali mencoba lagi bagian yang gagal. infinite juga bisa.
Proxy
URL proxy HTTP, HTTPS, atau SOCKS.
Lewati pembatasan wilayah
Memalsukan asal permintaan. Berhasil di sebagian situs, tidak semua.
Menyamar sebagai browser
Membuat permintaan terlihat seperti dari browser sungguhan. Ini solusi umum untuk error 403 yang muncul mendadak.
Login dan cookies
Cookies dari browser
Membaca sesi login Anda langsung. Diperlukan untuk konten privat, dibatasi umur, atau khusus member.
Berkas cookies
Berkas cookies.txt format Netscape yang diekspor dari browser Anda.
Siaran langsung
Rekam dari awal
Memulai siaran langsung dari awal, bukan dari momen sekarang.
Tunggu siarannya
Memeriksa terus sampai siaran terjadwal dimulai. MIN-MAX detik antar pemeriksaan.
Solusi masalah
--user-agent UA
usang — --add-headers
User agent
Usang, digantikan --add-headers. Tetap ada karena banyak panduan lama masih memakainya.
--referer URL
usang — --add-headers
Referer
Usang, digantikan --add-headers.
Argumen extractor
Opsi khusus per situs, misalnya youtube:player_client=web.
Contoh
--extractor-args "youtube:player_client=web,android"