Muat turun asas
Tanpa sebarang pilihan, yt-dlp memilih gabungan terbaik yang boleh digabungkannya dan menamakan fail mengikut tajuk. Agak mengejutkan betapa kerapnya inilah arahan yang betul.
yt-dlp URL
Sebelum memuat turun sesuatu yang besar, berbaloi melihat apa yang sebenarnya ditawarkan. Ini mencetak jadual format lalu keluar tanpa memuat turun apa-apa.
yt-dlp -F URL
Lajur kiri jadual itu ialah id format, yang kemudian boleh anda minta secara terus. Dua id yang disambung dengan + bermaksud "muat turun kedua-duanya lalu gabungkan".
yt-dlp -f 137+140 URL
Kualiti dan pemilihan format
Id format yang ditulis mati akan rosak sebaik sahaja sesebuah laman menukar tangga pengekodannya. Ungkapan pemilih ialah versi yang tahan lama: nyatakan sifat yang anda mahu dan biarkan yt-dlp mencari padanan terbaik.
yt-dlp -f "bv*[height<=1080]+ba/b[height<=1080]" URL
Bacanya begini: strim video terbaik yang tingginya tidak melebihi 1080 campur audio terbaik, dan jika pasangan itu tiada, fail tunggal terbaik yang tingginya tidak melebihi 1080. Sandaran selepas garis miring itulah yang menghalang arahan daripada gagal pada laman yang hanya menerbitkan strim progresif.
Menggabungkan dua strim menghasilkan bekas yang perlu dipilih oleh yt-dlp. MP4 boleh dimainkan di mana-mana; MKV menerima apa sahaja, dan itu mula penting sebaik sarikata dan bab terlibat.
yt-dlp -f "bv*+ba" --merge-output-format mp4 URL
Untuk menyatakan keutamaan dan bukan had keras, susun dan bukan tapis. Cara ini mengutamakan 1080p dan MP4 tetapi masih memuat turun sesuatu apabila kedua-duanya tiada.
yt-dlp -S "res:1080,ext:mp4" URL
Audio dan MP3
Mengekstrak audio memerlukan ffmpeg — inilah sebab paling lazim arahan di bawah gagal pada pemasangan yang baru dibuat.
yt-dlp -x --audio-format mp3 URL
Menambah seni kulit dan tag hanya memerlukan dua flag lagi, dan menjadikan hasilnya berguna dalam pustaka muzik dan bukan sekadar folder penuh fail tanpa nama.
yt-dlp -x --audio-format mp3 --audio-quality 0 --embed-thumbnail --embed-metadata URL
--audio-quality 0 bermaksud kadar bit berubah pada tetapan terbaik, bukan "kualiti sifar". Jika anda perlukan kadar bit tetap, nyatakan: --audio-quality 320K.
Apabila sumbernya sudah AAC atau Opus, menukarkannya kepada MP3 bermakna mengekod semula dan kehilangan kualiti tanpa faedah. Mengekalkan yang asal lebih pantas sekali gus lebih baik.
yt-dlp -x --audio-format best URL
Sarikata
Sarikata terbenam bergerak bersama fail; fail .srt berasingan lebih mudah disunting dan lebih mudah dihantar ke alat lain.
yt-dlp --embed-subs --sub-langs en URL yt-dlp --write-subs --sub-langs en,vi --convert-subs srt URL
Sarikata janaan mesin ialah suis berasingan. Tanpanya, video yang tiada sarikata buatan manusia tidak menghasilkan apa-apa langsung, dan tiada ralat pun.
yt-dlp --write-auto-subs --sub-langs en --convert-subs srt --skip-download URL
Senarai main dan saluran
URL YouTube selalunya milik video dan senarai main sekali gus, jadi yt-dlp terpaksa meneka yang mana satu anda maksudkan. Nyatakan dengan jelas.
yt-dlp --no-playlist URL yt-dlp --yes-playlist URL
Untuk apa-apa yang panjang, fail arkib lebih penting daripada mana-mana pilihan lain di sini: ia merekod apa yang sudah dimuat turun, jadi larian semula menyambung dari tempat ia berhenti dan bukan bermula semula.
yt-dlp --yes-playlist -i \ --download-archive archive.txt \ -o "%(playlist_index)02d - %(title)s.%(ext)s" \ URL
Digabungkan dengan -i, satu video yang disekat wilayah atau sudah dipadam tidak lagi membatalkan dua ratus yang lain. Untuk mengambil sebahagian sahaja, -I menerima julat dan senarai: -I 1:10, -I "1,3,7-10".
Klip, bab dan penajaan
Anda boleh memuat turun sebahagian video dan bukan keseluruhannya. Tanda bintang di hadapan menandakan cap masa dan bukan nama bab, dan tanda petik itu wajib — bash akan mengembangkan * yang berdiri sendiri terhadap nama fail anda.
yt-dlp --download-sections "*00:01:30-00:03:00" URL
SponsorBlock menggunakan penanda yang dihantar oleh komuniti untuk memotong keseluruhan segmen, atau membiarkannya sebagai bab yang boleh anda langkau sendiri.
yt-dlp --sponsorblock-remove default URL yt-dlp --sponsorblock-mark all --embed-chapters URL
Nama fail dan folder
Templat output mengawal kedua-duanya. Garis miring mencipta direktori, jadi satu templat sahaja boleh menyusun keseluruhan arkib.
yt-dlp -o "%(uploader)s/%(upload_date>%Y-%m-%d)s - %(title)s.%(ext)s" URL
Tajuk kerap mengandungi aksara yang ditolak oleh sesetengah sistem fail. --restrict-filenames menurunkan segalanya kepada ASCII biasa, dan itu berbaloi untuk apa-apa yang akan berpindah antara mesin.
Dalam fail .bat Windows setiap % mesti digandakan — %%(title)s — jika tidak penterjemah kelompok akan menelan templat itu sebelum yt-dlp sempat melihatnya. Penjana melakukannya untuk anda apabila anda memuat turun fail .bat.
Ralat yang benar-benar akan anda temui
ffmpeg not found
Apa sahaja yang menggabung, menukar, membenam atau memotong memerlukan ffmpeg dalam PATH anda. Pasangkannya, kemudian sahkan dengan ffmpeg -version.
Sign in to confirm you are not a bot
Cuba --impersonate chrome dahulu, kemudian --cookies-from-browser. Jika kedua-duanya gagal, kemas kini yt-dlp — pemeriksaan yang satu ini berubah kerap dan pembetulannya biasanya tiba dalam keluaran baharu dalam beberapa hari.
Unable to extract player response
Hampir selalu kerana yt-dlp sudah lapuk. Kemas kini dahulu sebelum menukar apa-apa lain: yt-dlp -U, atau pengurus pakej anda jika anda memasangnya begitu.
Requested format is not available
Pemilih anda tidak sepadan dengan apa-apa. Jalankan -F untuk melihat apa yang ada, dan lebih baik gunakan susunan (-S) daripada penapis keras supaya sentiasa ada sandaran.
HTTP Error 403
URL itu ditandatangani untuk sesi atau wilayah lain. Jalankan semula dengan kuki baharu, tambah --impersonate chrome, atau cuba --geo-bypass.
Mengekalkan yt-dlp terkini
Lebih banyak pepijat yang dilaporkan selesai dengan mengemas kini berbanding dengan mana-mana flag. Jika anda memasang binari kendiri:
yt-dlp -U
Jika dipasang melalui pengurus pakej, kemas kini dengan cara yang sama seperti anda memasangnya — -U akan menolak, dan ia betul berbuat begitu.