Generator perintah yt-dlp untuk Bilibili

Susun perintah yt-dlp untuk Bilibili, dimulai dengan penyamaran browser yang menghindari sebagian besar error 403.

URL video, playlist, atau channel

Opsional. Kosongkan saja, dan perintahnya akan berakhir dengan URL untuk Anda isi sendiri.

Perintah Anda

yt-dlp -f 'bv*[height<=1080]+ba/b[height<=1080]' --merge-output-format mp4 --no-playlist --impersonate chrome --cookies-from-browser chrome https://www.bilibili.com/video/BV1xx411c7mD

Dasar

Anda mau apa

Video Hanya audio

Hanya audio akan mengambil trek suaranya dan membuang video.

Video dan kualitas

Kualitas maksimum -f

Membatasi tinggi gambar. yt-dlp tetap memilih trek terbaik pada batas itu atau di bawahnya.

Container --merge-output-format butuh ffmpeg

Jenis berkas tempat trek video dan audio yang terpisah digabungkan.

Opsi lanjutan (3)

Format selector sendiri -f

Menggantikan pilihan kualitas. Untuk yang sudah paham sintaks format.

Remux ke --remux-video butuh ffmpeg

Mengemas ulang trek tanpa encode ulang. Cepat dan tanpa kehilangan kualitas.

Encode ulang ke --recode-video butuh ffmpeg

Meng-encode ulang video. Lambat dan menurunkan kualitas — hanya kalau remux tidak bisa.

Audio

Format audio --audio-format butuh ffmpeg

Berkas tujuan konversi audio.

Kualitas audio --audio-quality butuh ffmpeg

VBR memberi rasio ukuran-ke-kualitas terbaik; bitrate tetap lebih mudah diperkirakan.

Subtitle

Menyisipkan menaruh subtitle di dalam video; menyimpan menulis berkas .srt terpisah di sebelahnya.

Bahasa subtitle --sub-langs

Dipisah dengan koma. Pakai all untuk semua bahasa yang tersedia.

Subtitle otomatis --write-auto-subs Sertakan subtitle buatan mesin bila tidak ada subtitle buatan manusia.

Playlist dan channel

Penanganan playlist

Apa yang dilakukan bila URL termasuk video sekaligus playlist.

Item yang mana -I

Rentang dan daftar keduanya bisa, misalnya 1-10,15 atau -5::2 untuk satu dari setiap dua item dari belakang.

Opsi lanjutan (1)

Berkas riwayat --download-archive

Mencatat apa yang sudah diunduh sehingga menjalankan ulang akan melewatinya. Ini cara menjaga sebuah channel tetap sinkron.

Potongan dan bab

Opsi lanjutan (2)

Unduh sebagian saja --download-sections butuh ffmpeg

Rentang waktu seperti *00:01:30-00:03:00, atau nama bab. Tanda bintang di depan berarti itu penanda waktu.

Pisah per bab --split-chapters butuh ffmpeg Menulis satu berkas per bab, bukan satu berkas panjang.

Metadata dan sampul

Sisipkan thumbnail --embed-thumbnail butuh ffmpeg Memakai thumbnail video sebagai sampul.

Sisipkan metadata --embed-metadata butuh ffmpeg Menulis judul, pengunggah, dan tanggal ke dalam berkasnya sendiri.

Sisipkan bab --embed-chapters butuh ffmpeg Menambahkan penanda bab yang bisa dilompati pemutar Anda.

Opsi lanjutan (3)

Simpan berkas thumbnail --write-thumbnail Menulis gambar sampul di sebelah video.

Simpan deskripsi --write-description Menulis deskripsi ke berkas .description.

Simpan metadata JSON --write-info-json Menulis semua yang yt-dlp ketahui tentang video ke berkas .info.json.

SponsorBlock

Hapus potongan --sponsorblock-remove butuh ffmpeg

Memotong bagian yang ditandai komunitas dari berkas, memakai data SponsorBlock.

Opsi lanjutan (1)

Tandai potongan sebagai bab --sponsorblock-mark

Potongannya tetap ada tapi ditandai, sehingga Anda bisa melompatinya sendiri.

Berkas dan folder

Templat nama berkas -o

Nama kolom ditulis dalam %(...)s. Garis miring membuat folder.

Nama berkas aman (hanya ASCII) --restrict-filenames Membuang aksen, spasi, dan karakter apa pun yang mungkin ditolak sistem berkas tertentu.

Timpa berkas yang ada --force-overwrites Mengganti berkas yang sudah ada di sana.

Lanjutkan unduhan yang terputus -c Melanjutkan dari tempat unduhan berhenti.

Opsi lanjutan (4)

Folder unduhan -P

Tempat berkas ditulis. Gabungkan dengan templat di atas untuk membuat subfolder.

Nama yang aman untuk Windows --windows-filenames Membuang karakter yang ditolak Windows, bahkan saat dijalankan di sistem lain.

Pangkas nama menjadi --trim-filenames

Panjang maksimum nama berkas dalam karakter.

Jangan pernah timpa -w Melewati apa pun yang sudah diunduh.

Filter

Opsi lanjutan (5)

Diunggah setelah --dateafter

YYYYMMDD, atau tanggal relatif seperti now-1month.

Diunggah sebelum --datebefore

YYYYMMDD, atau tanggal relatif.

Ukuran minimum --min-filesize

Melewati yang lebih kecil. Menerima 5M, 500K, dan sejenisnya.

Ukuran maksimum --max-filesize

Melewati yang lebih besar.

Berhenti setelah --max-downloads

Jumlah berkas yang diunduh sebelum berhenti.

Jaringan

Batas kecepatan -r

Misalnya 2M atau 500K. Berguna saat Anda butuh sisa bandwidth untuk hal lain.

Opsi lanjutan (5)

Fragment paralel -N

Mempercepat trek yang terbagi fragment. Empat adalah titik awal yang wajar.

Percobaan ulang -R

Berapa kali mencoba lagi bagian yang gagal. infinite juga bisa.

Proxy --proxy

URL proxy HTTP, HTTPS, atau SOCKS.

Lewati pembatasan wilayah --geo-bypass Memalsukan asal permintaan. Berhasil di sebagian situs, tidak semua.

Menyamar sebagai browser --impersonate

Membuat permintaan terlihat seperti dari browser sungguhan. Ini solusi umum untuk error 403 yang muncul mendadak.

Cookies dari browser --cookies-from-browser

Membaca sesi login Anda langsung. Diperlukan untuk konten privat, dibatasi umur, atau khusus member.

Opsi lanjutan (1)

Berkas cookies --cookies

Berkas cookies.txt format Netscape yang diekspor dari browser Anda.

Siaran langsung

Opsi lanjutan (2)

Rekam dari awal --live-from-start Memulai siaran langsung dari awal, bukan dari momen sekarang.

Tunggu siarannya --wait-for-video

Memeriksa terus sampai siaran terjadwal dimulai. MIN-MAX detik antar pemeriksaan.

Solusi masalah

Opsi lanjutan (3)

User agent --user-agent usang

Usang, digantikan --add-headers. Tetap ada karena banyak panduan lama masih memakainya.

Referer --referer usang

Usang, digantikan --add-headers.

Argumen extractor --extractor-args

Opsi khusus per situs, misalnya youtube:player_client=web.

Keluaran dan debug

Hanya tampilkan daftar format -F Mencetak format yang tersedia lalu keluar tanpa mengunduh.

Opsi lanjutan (2)

Lanjut walau ada error -i Melewati item yang gagal, bukan berhenti. Wajib untuk playlist besar.

Simulasi -s Melakukan semuanya kecuali menulis berkas.

Atur ulang

Opsi yang penting di sini

Menyamar sebagai browser --impersonate Membuat permintaan terlihat seperti dari browser sungguhan. Ini solusi umum untuk error 403 yang muncul mendadak.
Cookies dari browser --cookies-from-browser Membaca sesi login Anda langsung. Diperlukan untuk konten privat, dibatasi umur, atau khusus member.
Kualitas maksimum -f Membatasi tinggi gambar. yt-dlp tetap memilih trek terbaik pada batas itu atau di bawahnya.

Error 403 dan batas kualitas

Bilibili menolak permintaan yang tidak terlihat berasal dari browser, itulah kenapa perintah biasa sering mengembalikan 403. Penyamaran dinyalakan di preset ini karena itu solusinya dalam banyak kasus.

1080p ke atas biasanya khusus akun yang sudah masuk dan kadang akun berbayar, jadi di sini cookies penting untuk kualitas, bukan cuma untuk akses. Video multi-bagian muncul sebagai item playlist.

Bilibili adalah platform yang paling cepat merusak yt-dlp yang tua — situs ini merombak API-nya lebih sering daripada platform Barat mana pun, dan pembaruan ekstraktor mendarat di rilis yt-dlp hanya hitungan hari setelah tiap perubahan. Ketika unduhan yang bulan lalu masih mulus mulai gagal, perbarui dulu: yt-dlp -U. Penyamaran browser (nyala bawaan di preset ini) menutupi bagian header-harus-terlihat-browser dari masalah 403; sisanya biasanya sesi yang hilang atau kedaluwarsa.

Unggahan multi-bagian — struktur P1/P2/P3 yang lazim pada serial — datang sebagai entri playlist, jadi mode seluruh playlist mengambil tiap bagian, dan nomor urut playlist di templat nama menjaga bagian-bagian tetap berurutan. Danmaku (komentar yang berjalan di layar) adalah trek subtitle di mata yt-dlp: --write-subs menyimpannya sebagai berkas .ass, satu-satunya format tempat mereka ada. Kalau tidak mau, jangan lakukan apa-apa — mereka tidak digabung kecuali diminta.

Kualitas bersyarat — tangga "dolby" dan premium — hanya ada untuk akun yang memilikinya, dan tidak ada flag yang menjangkaunya tanpa cookies dari akun sedemikian. Konten terkunci wilayah adalah tembok satu lagi: sebagian unggahan hanya terlihat dari daratan Tiongkok, dan proxy di dalam wilayah adalah satu-satunya jalan saat pemblokiran ditegakkan di CDN, bukan di halaman. Geo-bypass kadang berhasil untuk blok level halaman dan tak pernah untuk yang level CDN.

Bilibili menyajikan kualitas tingginya sebagai DASH dengan audio terpisah, jadi ffmpeg menggabungkan persis seperti YouTube — langkah penggabungannya sudah ada di preset ini. Ekstraksi audio-saja dengan -x bekerja dan menjadi cara tercepat mengambil hanya suaranya dari unggahan multi-bagian yang panjang. Untuk replay siaran, replay menjadi VOD biasa setelah stream berakhir, jadi unduh seperti video mana pun; opsi perekaman langsung di situs ini untuk stream yang sedang berlangsung.

Pertanyaan yang sering diajukan

› Kenapa Bilibili mengembalikan 403?

Bilibili menolak permintaan yang tidak terlihat berasal dari browser. --impersonate chrome mengatasinya hampir selalu; tambahkan cookies untuk konten khusus member.

› Bagaimana mengunduh 1080p atau lebih dari Bilibili?

Resolusi yang lebih tinggi disisihkan untuk akun yang sudah masuk dan kadang akun berbayar. Pakai --cookies-from-browser dengan akun seperti itu.

› Bagaimana mengambil semua bagian video multi-bagian?

Setel penanganan playlist ke seluruh playlist — bagian-bagiannya muncul sebagai item playlist.