Lumaktaw sa nilalaman
yt-dlp

Sanggunian ng mga opsyon ng yt-dlp

Isinulat batay sa yt-dlp 2026.07.21. Nadaragdagan at napapalitan ng pangalan ang mga opsyon sa bawat bersyon, kaya suriin ang sa iyo gamit ang yt-dlp --version.

Panimula

Ano ang gusto mo

Kinukuha ng audio-only ang soundtrack at itinatapon ang video stream.

Video at kalidad

-f FORMAT --format

Pinakamataas na kalidad

Nililimitahan ang taas. Pipiliin pa rin ng yt-dlp ang pinakamahusay na stream sa loob ng limitasyong iyon.

-f FORMAT --format

Custom na format selector

Pinapalitan nito ang dropdown ng kalidad. Para sa mga pamilyar na sa syntax ng format.

Mga halimbawa

  • -f "bv*[vcodec^=av01]+ba"
  • -f "b[filesize<50M]"
--remux-video FORMAT kailangan ang ffmpeg

I-remux sa

Binabalot muli ang mga stream nang hindi nag-e-encode ulit. Mabilis at walang nawawala.

--recode-video FORMAT kailangan ang ffmpeg

I-encode ulit sa

Ini-encode muli ang video. Mabagal at may nawawalang kalidad — gamitin lang kung kulang ang remux.

Audio

--audio-quality QUALITY kailangan ang ffmpeg

Kalidad ng audio

Ang VBR ang may pinakamahusay na sukat-sa-kalidad; mas madaling hulaan ang nakapirming bitrate.

Mga subtitle

Mga subtitle

Inilalagay ng pag-embed ang subtitle sa loob ng video; ang pag-save naman ay gumagawa ng hiwalay na .srt sa tabi nito.

Mga wika ng subtitle

Paghiwalayin ng kuwit. Gamitin ang all para sa lahat ng available na wika.

Mga halimbawa

  • --sub-langs "en,vi"
  • --sub-langs "en.*,ja"
  • --sub-langs all

Awtomatikong ginawang subtitle

Isama ang caption na gawa ng makina kapag walang gawa ng tao.

Mga playlist at channel

Paghawak sa playlist

Ano ang gagawin kapag ang URL ay kabilang sa isang video at sa isang playlist nang sabay.

-I ITEM_SPEC --playlist-items

Aling mga item

Gumagana ang saklaw at listahan, halimbawa 1-10,15 o -5::2 para sa tuwing ikalawang item mula sa dulo.

Mga halimbawa

  • -I 1:5
  • -I "1,3,7-10"
  • -I "-5::2"

Archive file

Itinatala kung ano na ang na-download para laktawan ito sa muling pagpapatakbo. Ito ang paraan para manatiling naka-sync ang isang channel.

Mga bahagi at kabanata

--download-sections REGEX kailangan ang ffmpeg

I-download ang bahagi lang

Isang saklaw ng oras tulad ng *00:01:30-00:03:00, o pangalan ng kabanata. Ang asterisk sa unahan ang nagsasabing timestamp ito.

Mga halimbawa

  • --download-sections "*00:01:30-00:03:00"
  • --download-sections "intro"
--split-chapters kailangan ang ffmpeg

Hatiin ayon sa kabanata

Gumagawa ng isang file bawat kabanata sa halip na isang mahabang file.

Metadata at artwork

--embed-thumbnail kailangan ang ffmpeg

I-embed ang thumbnail

Ginagamit ang thumbnail ng video bilang cover art.

--embed-metadata kailangan ang ffmpeg

I-embed ang metadata

Isinusulat ang pamagat, uploader at petsa sa loob mismo ng file.

--embed-chapters kailangan ang ffmpeg

I-embed ang mga kabanata

Nagdadagdag ng marka ng kabanata na kayang laktawan ng iyong player.

I-save ang metadata JSON

Isinusulat sa isang .info.json file ang lahat ng alam ng yt-dlp tungkol sa video.

SponsorBlock

--sponsorblock-remove CATS kailangan ang ffmpeg

Tanggalin ang mga bahagi

Pinuputol sa file ang mga bahaging minarkahan ng komunidad gamit ang datos ng SponsorBlock.

Markahan ang mga bahagi bilang kabanata

Pinapanatili ang mga bahagi ngunit minamarkahan ang mga ito, para ikaw mismo ang makalaktaw.

Mga file at folder

Template ng pangalan ng file

Ang pangalan ng field ay inilalagay sa %(...)s. Ang slash ay gumagawa ng folder.

Mga halimbawa

  • -o "%(title)s.%(ext)s"
  • -o "%(playlist_index)02d - %(title)s.%(ext)s"

Folder ng download

Kung saan isinusulat ang mga file. Isama sa template sa itaas para sa mga subfolder.

Ligtas (ASCII) na pangalan ng file

Tinatanggal ang tuldik, espasyo at kahit anong maaaring tanggihan ng masungit na filesystem.

Pangalang ligtas sa Windows

Tinatanggal ang mga karakter na tinatanggihan ng Windows kahit sa ibang sistema ka nagpapatakbo.

-w --no-overwrites

Huwag kailanman palitan

Nilalaktawan ang anumang na-download na.

-c --continue

Ituloy ang di-tapos na download

Ipinagpapatuloy mula sa kung saan huminto ang naputol na download.

Mga filter

Na-upload matapos ang

YYYYMMDD, o relatibong petsa gaya ng now-1month.

Mga halimbawa

  • --dateafter 20240101
  • --dateafter now-1month

Pinakamaliit na sukat

Nilalaktawan ang mas maliit dito. Tumatanggap ng 5M, 500K at katulad.

Network

-r RATE --limit-rate

Limitasyon sa bilis

Halimbawa 2M o 500K. Kapaki-pakinabang kapag kailangan mo ang natitirang bandwidth.

-N N --concurrent-fragments

Magkakasabay na fragment

Pinapabilis ang mga fragmented stream. Apat ang makatuwirang panimula.

-R RETRIES --retries

Mga pagsubok muli

Ilang beses uulitin ang bahaging nabigo. Pwede ang infinite.

Lampasan ang geo-restriction

Pineperahe ang pinagmulan ng request. Gumagana sa ilang site, hindi sa lahat.

Magpanggap na browser

Ginagawang mukhang totoong browser ang mga request. Ito ang karaniwang lunas sa biglaang 403 error.

Pag-log in at cookies

Cookies file

Isang cookies.txt na nasa Netscape format na na-export mula sa iyong browser.

Mga live stream

Mag-record mula sa simula

Sinisimulan ang live stream mula sa umpisa sa halip na sa kasalukuyang sandali.

Hintayin ang stream

Paulit-ulit na sumisilip hanggang magsimula ang nakaiskedyul na stream. MIN-MAX segundo sa pagitan ng bawat pagsilip.

Mga workaround

--user-agent UA luma na — --add-headers

User agent

Luma na, pinalitan ng --add-headers. Pinanatili dahil marami pa ring lumang gabay ang gumagamit nito.

--referer URL luma na — --add-headers

Referer

Luma na, pinalitan ng --add-headers.

Mga argumento ng extractor

Mga switch na tiyak sa site, halimbawa youtube:player_client=web.

Mga halimbawa

  • --extractor-args "youtube:player_client=web,android"

Output at pag-debug

-i --ignore-errors

Magpatuloy kahit may error

Nilalaktawan ang mga item na nabigo sa halip na tumigil. Mahalaga para sa malalaking playlist.

-F --list-formats

Ilista lang ang mga format

Ipinipirint ang mga available na format at lumalabas nang walang dina-download.

-s --simulate

Simulate

Ginagawa ang lahat maliban sa pagsulat ng file.