Payak na pag-download
Kapag walang anumang opsyon, pipiliin ng yt-dlp ang pinakamahusay na kombinasyong kaya nitong pagsamahin at ipapangalan sa pamagat ang file. Nakapagtataka kung gaano kadalas ito na mismo ang tamang command.
yt-dlp URL
Bago mag-download ng malaki, sulit munang tingnan kung ano talaga ang inaalok. Ilalabas nito ang talahanayan ng mga format at titigil nang walang dina-download.
yt-dlp -F URL
Ang kaliwang hanay ng talahanayang iyon ay ang format id, na puwede mo nang hingin nang tuwiran pagkatapos. Ang dalawang id na pinagdugtong ng + ay nangangahulugang "i-download pareho at pagsamahin".
yt-dlp -f 137+140 URL
Kalidad at pagpili ng format
Nasisira ang mga nakatakdang format id sa oras na baguhin ng isang site ang hagdan ng pag-encode nito. Ang selector na ekspresyon ang bersyong matibay: hingin mo ang mga katangiang gusto mo at hayaang ang yt-dlp na ang humanap ng pinakatugma.
yt-dlp -f "bv*[height<=1080]+ba/b[height<=1080]" URL
Ganito basahin: ang pinakamahusay na video stream na hindi hihigit sa 1080 ang taas dagdag ang pinakamahusay na audio, at kung wala ang pares na iyon, ang pinakamahusay na iisang file na hindi hihigit sa 1080 ang taas. Ang pamalit na iyon pagkatapos ng slash ang pumipigil sa command na mabigo sa mga site na progresibong stream lang ang inilalathala.
Ang pagsasama ng dalawang stream ay nagbubunga ng container na kailangang piliin ng yt-dlp. Napapatugtog ang MP4 kahit saan; tumatanggap naman ang MKV ng kahit ano, at doon na ito nagiging mahalaga kapag may subtitle at kabanata na.
yt-dlp -f "bv*+ba" --merge-output-format mp4 URL
Para magsabi ng kagustuhan sa halip na mahigpit na hangganan, mag-ayos sa halip na magsala. Uunahin nito ang 1080p at MP4 pero may nada-download pa rin kapag wala ni isa sa dalawa.
yt-dlp -S "res:1080,ext:mp4" URL
Audio at MP3
Kailangan ng ffmpeg sa pagkuha ng audio — ito ang pinakamadalas na dahilan kung bakit nabibigo ang command sa ibaba sa bagong instalasyon.
yt-dlp -x --audio-format mp3 URL
Dalawang flag na lang ang kailangan para maidagdag ang cover art at mga tag, at doon nagiging kapaki-pakinabang ang resulta sa isang music library sa halip na maging folder ng mga file na walang pangalan.
yt-dlp -x --audio-format mp3 --audio-quality 0 --embed-thumbnail --embed-metadata URL
Ang --audio-quality 0 ay nangangahulugang variable bitrate sa pinakamahusay na setting, hindi "zero na kalidad". Kung kailangan mo ng nakapirming bitrate, ibigay mo: --audio-quality 320K.
Kapag AAC o Opus na ang pinagmulan, ang pag-convert sa MP3 ay muling nag-e-encode at nawawalan ng kalidad nang walang kapalit. Mas mabilis at mas mainam ang panatilihin ang orihinal.
yt-dlp -x --audio-format best URL
Mga subtitle
Sumasama sa file ang mga naka-embed na subtitle; mas madaling i-edit at ipasa sa ibang kasangkapan ang hiwalay na mga file na .srt.
yt-dlp --embed-subs --sub-langs en URL yt-dlp --write-subs --sub-langs en,vi --convert-subs srt URL
Hiwalay na switch ang mga subtitle na gawa ng makina. Kapag wala ito, ang video na walang subtitle na gawa ng tao ay walang ilalabas kahit ano, at wala ring error.
yt-dlp --write-auto-subs --sub-langs en --convert-subs srt --skip-download URL
Mga playlist at channel
Madalas na kabilang ang isang URL ng YouTube sa isang video at sa isang playlist nang sabay, kaya kailangang hulaan ng yt-dlp kung alin ang tinutukoy mo. Sabihin mo nang tuwiran.
yt-dlp --no-playlist URL yt-dlp --yes-playlist URL
Para sa kahit anong mahaba, mas mahalaga ang archive file kaysa sa kahit anong opsyon dito: itinatala nito kung ano na ang na-download, kaya ang muling pagpapatakbo ay itutuloy mula sa hinintuan sa halip na magsimula ulit sa umpisa.
yt-dlp --yes-playlist -i \ --download-archive archive.txt \ -o "%(playlist_index)02d - %(title)s.%(ext)s" \ URL
Kasama ang -i, ang isang video na naka-block ayon sa rehiyon o nabura na ay hindi na humihinto sa natitirang dalawandaan. Para kumuha ng bahagi lang sa halip na lahat, tumatanggap ang -I ng saklaw at listahan: -I 1:10, -I "1,3,7-10".
Mga clip, kabanata at sponsor
Puwede mong i-download ang bahagi lang ng video sa halip na ang buo. Ang asterisk sa unahan ay nangangahulugang timestamp at hindi pangalan ng kabanata, at kailangang-kailangan ang panipi — ipapalawak ng bash ang hubad na * laban sa mga pangalan ng file mo.
yt-dlp --download-sections "*00:01:30-00:03:00" URL
Gumagamit ang SponsorBlock ng mga marka na isinumite ng komunidad para putulin nang tuluyan ang mga bahagi, o iwan ang mga ito bilang kabanatang ikaw na mismo ang lalaktaw.
yt-dlp --sponsorblock-remove default URL yt-dlp --sponsorblock-mark all --embed-chapters URL
Pangalan ng file at mga folder
Kontrolado ng output template ang dalawa. Gumagawa ng direktoryo ang slash, kaya isang template lang ang kayang mag-ayos ng buong archive.
yt-dlp -o "%(uploader)s/%(upload_date>%Y-%m-%d)s - %(title)s.%(ext)s" URL
Madalas may mga karakter sa pamagat na tinatanggihan ng ilang file system. Ibinababa ng --restrict-filenames ang lahat sa payak na ASCII, at sulit iyon para sa kahit anong ilalipat-lipat sa pagitan ng mga makina.
Sa isang .bat na file sa Windows, kailangang dalawahin ang bawat % — %%(title)s — kung hindi, kakainin ng batch interpreter ang template bago pa man ito makita ng yt-dlp. Ginagawa na ito ng generator para sa iyo kapag nag-download ka ng .bat.
Mga error na talagang mararanasan mo
ffmpeg not found
Anumang nagsasama, nagko-convert, nag-e-embed o pumuputol ay kailangang may ffmpeg sa PATH mo. I-install mo, tapos kumpirmahin sa ffmpeg -version.
Sign in to confirm you are not a bot
Subukan mo muna ang --impersonate chrome, tapos ang --cookies-from-browser. Kung parehong nabigo, i-update ang yt-dlp — madalas magbago ang partikular na pagsusuring ito at kadalasang dumarating ang solusyon sa isang bagong bersyon sa loob ng ilang araw.
Unable to extract player response
Halos palaging luma na lang ang yt-dlp. I-update mo muna bago ka magbago ng kahit ano pa: yt-dlp -U, o ang package manager mo kung ganoon mo ito na-install.
Requested format is not available
Walang tinugma ang selector mo. Patakbuhin ang -F para makita kung ano ang meron, at mas mabuting gumamit ng pag-aayos (-S) kaysa mahigpit na salaan para laging may pamalit.
HTTP Error 403
Nilagdaan ang URL na iyon para sa ibang session o ibang rehiyon. Patakbuhin muli nang may bagong cookies, idagdag ang --impersonate chrome, o subukan ang --geo-bypass.
Panatilihing napapanahon ang yt-dlp
Mas maraming naiulat na depekto ang naaayos ng pag-update kaysa sa kahit anong flag. Kung nag-install ka ng nakatayong binary:
yt-dlp -U
Kung sa package manager mo ito na-install, doon mo rin i-update — tatanggi ang -U, at tama lang na tumanggi ito.