Apa yang anda mahu
Audio sahaja mengekstrak runut bunyi dan membuang strim video.
Rujukan pilihan yt-dlp
Ditulis berdasarkan yt-dlp 2026.07.21. Pilihan ditambah dan ditukar nama antara versi, jadi semak versi anda dengan yt-dlp --version.
Asas
Video dan kualiti
-f FORMAT
--format
Kualiti maksimum
Mengehadkan ketinggian. yt-dlp tetap memilih strim terbaik pada atau bawah had itu.
-f FORMAT
--format
Format selector tersuai
Mengatasi senarai kualiti di atas. Untuk mereka yang sudah biasa dengan sintaks format.
Contoh
-f "bv*[vcodec^=av01]+ba"-f "b[filesize<50M]"
--merge-output-format FORMAT
perlukan ffmpeg
Container
Jenis fail tempat strim video dan audio berasingan digabungkan.
--remux-video FORMAT
perlukan ffmpeg
Remux kepada
Membungkus semula strim tanpa mengekod semula. Pantas dan tanpa kehilangan kualiti.
--recode-video FORMAT
perlukan ffmpeg
Kod semula kepada
Mengekod semula video. Perlahan dan hilang kualiti — guna hanya apabila remux tidak mencukupi.
Audio
--audio-format FORMAT
perlukan ffmpeg
Format audio
Fail yang audio itu akan ditukar kepadanya.
--audio-quality QUALITY
perlukan ffmpeg
Kualiti audio
VBR memberi nisbah saiz-kepada-kualiti terbaik; bitrate tetap lebih mudah dijangka.
Sari kata
Sari kata
Menyisip meletakkannya di dalam video; menyimpan menulis fail .srt berasingan di sebelahnya.
Bahasa sari kata
Dipisahkan dengan koma. Guna all untuk semua bahasa yang ada.
Contoh
--sub-langs "en,vi"--sub-langs "en.*,ja"--sub-langs all
Sari kata janaan automatik
Sertakan kapsyen janaan mesin apabila tiada versi manusia.
Senarai main dan saluran
Pengendalian senarai main
Apa yang perlu dibuat apabila URL itu milik kedua-dua video dan senarai main.
-I ITEM_SPEC
--playlist-items
Item yang mana
Julat dan senarai kedua-duanya berfungsi, contohnya 1-10,15 atau -5::2 untuk setiap item kedua dari belakang.
Contoh
-I 1:5-I "1,3,7-10"-I "-5::2"
Fail arkib
Merekod apa yang telah dimuat turun supaya larian berikutnya melangkaunya. Cara untuk menyelaraskan satu saluran.
Petikan dan bab
--download-sections REGEX
perlukan ffmpeg
Muat turun sebahagian sahaja
Julat masa seperti *00:01:30-00:03:00, atau nama bab. Tanda bintang di depan bermaksud ia cap masa.
Contoh
--download-sections "*00:01:30-00:03:00"--download-sections "intro"
--split-chapters
perlukan ffmpeg
Pecahkan mengikut bab
Menulis satu fail bagi setiap bab, bukan satu fail panjang.
Metadata dan kulit muka
--embed-thumbnail
perlukan ffmpeg
Sisip kulit muka
Menggunakan thumbnail video sebagai gambar kulit.
--embed-metadata
perlukan ffmpeg
Sisip metadata
Menulis tajuk, pemuat naik dan tarikh ke dalam fail itu sendiri.
--embed-chapters
perlukan ffmpeg
Sisip bab
Menambah penanda bab yang boleh dilompat oleh pemain media anda.
Simpan fail kulit muka
Menulis imej kulit di sebelah video.
Simpan penerangan
Menulis penerangan ke dalam fail .description.
Simpan metadata JSON
Menulis semua yang yt-dlp tahu tentang video itu ke dalam fail .info.json.
SponsorBlock
--sponsorblock-remove CATS
perlukan ffmpeg
Buang petikan
Memotong petikan yang ditanda komuniti daripada fail menggunakan data SponsorBlock.
Tanda petikan sebagai bab
Mengekalkan petikan itu tetapi menandanya, supaya anda boleh melangkau sendiri.
Fail dan folder
-o [TYPES:]TEMPLATE
--output
Templat nama fail
Nama medan diletak dalam %(...)s. Garis miring mencipta folder.
Contoh
-o "%(title)s.%(ext)s"-o "%(playlist_index)02d - %(title)s.%(ext)s"
-P [TYPES:]PATH
--paths
Folder muat turun
Tempat fail ditulis. Gabungkan dengan templat di atas untuk subfolder.
Nama fail selamat (ASCII)
Membuang tanda diakritik, ruang dan apa sahaja yang mungkin ditolak oleh sistem fail yang cerewet.
Nama selamat untuk Windows
Membuang aksara yang ditolak Windows walaupun anda menjalankannya di tempat lain.
Potong nama kepada
Panjang maksimum nama fail dalam aksara.
Tulis ganti fail sedia ada
Menggantikan fail yang sudah ada di situ.
-w
--no-overwrites
Jangan sekali-kali tulis ganti
Melangkau apa sahaja yang sudah dimuat turun.
-c
--continue
Sambung semula muat turun separa
Menyambung dari tempat muat turun yang terputus berhenti.
Penapis
Dimuat naik selepas
YYYYMMDD, atau tarikh relatif seperti now-1month.
Contoh
--dateafter 20240101--dateafter now-1month
Dimuat naik sebelum
YYYYMMDD, atau tarikh relatif.
Saiz minimum
Melangkau apa sahaja yang lebih kecil. Menerima 5M, 500K dan seumpamanya.
Saiz maksimum
Melangkau apa sahaja yang lebih besar.
Berhenti selepas
Bilangan fail untuk dimuat turun sebelum berhenti.
Rangkaian
-r RATE
--limit-rate
Had kelajuan
Contohnya 2M atau 500K. Berguna apabila anda perlukan baki lebar jalur anda.
-N N
--concurrent-fragments
Fragmen selari
Mempercepat strim berfragmen. Empat ialah titik permulaan yang berpatutan.
-R RETRIES
--retries
Cubaan semula
Berapa kali mencuba semula bahagian yang gagal. infinite dibenarkan.
Proxy
URL proxy HTTP, HTTPS atau SOCKS.
Pintas sekatan geografi
Memalsukan asal permintaan. Berkesan pada sesetengah laman, bukan semua.
Menyamar sebagai pelayar
Menjadikan permintaan kelihatan seperti daripada pelayar sebenar. Penyelesaian biasa untuk ralat 403 yang muncul tiba-tiba.
Log masuk dan cookies
Cookies daripada pelayar
Membaca sesi log masuk anda secara terus. Diperlukan untuk kandungan peribadi, berhad umur atau khas ahli.
Fail cookies
Fail cookies.txt format Netscape yang dieksport daripada pelayar anda.
Siaran langsung
Rakam dari mula
Memulakan siaran langsung dari permulaan, bukan dari saat semasa.
Tunggu siaran
Menyemak berulang kali sehingga siaran berjadual bermula. MIN-MAX saat antara semakan.
Jalan penyelesaian
--user-agent UA
usang — --add-headers
User agent
Usang, digantikan dengan --add-headers. Dikekalkan kerana banyak panduan lama masih menggunakannya.
--referer URL
usang — --add-headers
Referer
Usang, digantikan dengan --add-headers.
Argumen extractor
Suis khusus laman, contohnya youtube:player_client=web.
Contoh
--extractor-args "youtube:player_client=web,android"