Unduhan dasar
Tanpa opsi sama sekali, yt-dlp memilih kombinasi terbaik yang bisa digabungkannya dan menamai berkas sesuai judulnya. Cukup sering, inilah perintah yang tepat.
yt-dlp URL
Sebelum mengunduh sesuatu yang besar, ada baiknya melihat apa yang sebenarnya tersedia. Perintah ini mencetak tabel format lalu keluar tanpa mengunduh apa pun.
yt-dlp -F URL
Kolom kiri tabel itu adalah id format, yang lalu bisa Anda minta secara langsung. Dua id yang digabung dengan + berarti "unduh keduanya lalu gabungkan".
yt-dlp -f 137+140 URL
Kualitas dan pemilihan format
Id format yang ditulis mati akan rusak begitu sebuah situs mengubah tangga enkodingnya. Ekspresi selektor adalah versi yang tahan lama: minta properti yang Anda inginkan dan biarkan yt-dlp mencari yang paling cocok.
yt-dlp -f "bv*[height<=1080]+ba/b[height<=1080]" URL
Bacanya begini: aliran video terbaik yang tingginya tidak lebih dari 1080 ditambah audio terbaik, dan kalau pasangan itu tidak ada, berkas tunggal terbaik yang tingginya tidak lebih dari 1080. Cadangan setelah garis miring itulah yang mencegah perintah gagal di situs yang hanya menyediakan aliran progresif.
Menggabungkan dua aliran menghasilkan wadah yang harus dipilih yt-dlp. MP4 bisa diputar di mana saja; MKV menerima apa pun, dan itu penting begitu subtitle dan bab ikut terlibat.
yt-dlp -f "bv*+ba" --merge-output-format mp4 URL
Untuk menyatakan preferensi alih-alih batas keras, urutkan alih-alih menyaring. Ini lebih menyukai 1080p dan MP4 tetapi tetap mengunduh sesuatu ketika keduanya tidak tersedia.
yt-dlp -S "res:1080,ext:mp4" URL
Audio dan MP3
Mengekstrak audio membutuhkan ffmpeg — ini alasan paling umum kenapa perintah di bawah gagal pada pemasangan yang masih baru.
yt-dlp -x --audio-format mp3 URL
Menambahkan sampul album dan tag hanya butuh dua flag lagi, dan membuat hasilnya layak masuk pustaka musik alih-alih jadi folder berisi berkas tanpa identitas.
yt-dlp -x --audio-format mp3 --audio-quality 0 --embed-thumbnail --embed-metadata URL
--audio-quality 0 berarti bitrate variabel pada setelan terbaik, bukan "kualitas nol". Kalau Anda butuh bitrate tetap, sebutkan: --audio-quality 320K.
Kalau sumbernya sudah AAC atau Opus, mengonversi ke MP3 berarti mengenkode ulang dan kehilangan kualitas tanpa alasan. Mempertahankan aslinya lebih cepat sekaligus lebih baik.
yt-dlp -x --audio-format best URL
Subtitle
Subtitle yang ditanam ikut berpindah bersama berkasnya; berkas .srt terpisah lebih mudah disunting dan diteruskan ke alat lain.
yt-dlp --embed-subs --sub-langs en URL yt-dlp --write-subs --sub-langs en,vi --convert-subs srt URL
Takarir hasil mesin adalah sakelar tersendiri. Tanpa itu, video tanpa subtitle buatan manusia tidak menghasilkan apa-apa sama sekali, dan tanpa pesan galat.
yt-dlp --write-auto-subs --sub-langs en --convert-subs srt --skip-download URL
Playlist dan kanal
URL YouTube sering kali milik sebuah video sekaligus sebuah playlist, dan yt-dlp harus menebak mana yang Anda maksud. Sebutkan saja secara eksplisit.
yt-dlp --no-playlist URL yt-dlp --yes-playlist URL
Untuk apa pun yang panjang, berkas arsip lebih penting daripada opsi lain mana pun di sini: ia mencatat apa yang sudah diunduh sehingga menjalankan ulang melanjutkan dari tempatnya berhenti, bukan mulai dari awal.
yt-dlp --yes-playlist -i \ --download-archive archive.txt \ -o "%(playlist_index)02d - %(title)s.%(ext)s" \ URL
Dipadukan dengan -i, satu video yang dikunci wilayah atau sudah dihapus tidak lagi membatalkan dua ratus lainnya. Untuk mengambil sebagian saja, -I menerima rentang dan daftar: -I 1:10, -I "1,3,7-10".
Klip, bab, dan sponsor
Anda bisa mengunduh sebagian video alih-alih seluruhnya. Tanda bintang di depan menandai stempel waktu alih-alih nama bab, dan tanda kutipnya wajib — bash akan memperluas * yang telanjang terhadap nama berkas Anda.
yt-dlp --download-sections "*00:01:30-00:03:00" URL
SponsorBlock memakai penanda kiriman komunitas untuk memotong segmen sepenuhnya, atau membiarkannya sebagai bab yang bisa Anda lewati sendiri.
yt-dlp --sponsorblock-remove default URL yt-dlp --sponsorblock-mark all --embed-chapters URL
Nama berkas dan folder
Templat keluaran mengatur keduanya. Garis miring membuat direktori, jadi satu templat bisa menata seluruh arsip.
yt-dlp -o "%(uploader)s/%(upload_date>%Y-%m-%d)s - %(title)s.%(ext)s" URL
Judul kerap memuat karakter yang ditolak sebagian sistem berkas. --restrict-filenames menyederhanakan semuanya menjadi ASCII biasa, yang sepadan untuk apa pun yang akan dipindah-pindah antarmesin.
Di berkas .bat Windows setiap % harus digandakan — %%(title)s — atau penafsir batch akan memakan templatnya sebelum yt-dlp sempat melihatnya. Generator ini melakukannya untuk Anda saat Anda mengunduh .bat.
Galat yang benar-benar akan Anda temui
ffmpeg not found
Segala hal yang menggabungkan, mengonversi, menanam, atau memotong membutuhkan ffmpeg di PATH Anda. Pasang, lalu pastikan dengan ffmpeg -version.
Sign in to confirm you are not a bot
Coba --impersonate chrome dulu, lalu --cookies-from-browser. Kalau keduanya gagal, perbarui yt-dlp — pemeriksaan yang satu ini sering berubah dan perbaikannya biasanya datang dalam rilis beberapa hari kemudian.
Unable to extract player response
Hampir selalu karena yt-dlp yang usang. Perbarui dulu sebelum mengubah apa pun yang lain: yt-dlp -U, atau lewat pengelola paket kalau Anda memasangnya dengan cara itu.
Requested format is not available
Selektor Anda tidak cocok dengan apa pun. Jalankan -F untuk melihat apa yang ada, dan lebih baik pakai pengurutan (-S) daripada penyaring keras supaya selalu ada cadangan.
HTTP Error 403
URL-nya ditandatangani untuk sesi atau wilayah lain. Jalankan ulang dengan cookie baru, tambahkan --impersonate chrome, atau coba --geo-bypass.
Menjaga yt-dlp tetap mutakhir
Lebih banyak bug yang dilaporkan selesai dengan memperbarui daripada dengan flag apa pun. Kalau Anda memasang binary mandiri:
yt-dlp -U
Kalau dipasang lewat pengelola paket, perbarui dengan cara yang sama seperti Anda memasangnya — -U akan menolak, dan itu memang benar.