Usage: __main__.py [options] url [url...

]
Options:
General Options:
-h, --help print this help text and exit
--version print program version and exit
-U, --update update this program to latest version. Make
sure that you have sui!ient permissions "run #ith sudo i needed$
-i, --ignore-errors !ontinue on do#nload errors, or example to
skip unavaila%le videos in a playlist
--a%ort-on-error &%ort do#nloading o urther videos "in the
playlist or the !ommand line$ i an error o!!urs
--dump-user-agent display the !urrent %ro#ser identii!ation
--list-extra!tors 'ist all supported extra!tors and the U('s
they #ould handle
--extra!tor-des!riptions Output des!riptions o all supported
extra!tors
--proxy U(' Use the spe!iied )**+,)**+- proxy. +ass in an
empty string "--proxy ..$ or dire!t !onne!tion
--so!ket-timeout /one *ime to #ait %eore giving up, in se!onds
--deault-sear!h +(0123 Use this preix or un4ualiied U('s. 1or
example .gvsear!h5:. do#nloads t#o videos rom google videos or youtu%e-dl .large
apple..
Use the value .auto. to let youtu%e-dl guess
".auto_#arning. to emit a #arning #hen guessing$. .error. 6ust thro#s an error. *he
deault value .ixup_error. repairs %roken
U('s, %ut emits an error i this is not possi%le instead o sear!hing.
--ignore-!onig 7o not read !oniguration iles. 8hen given in
the glo%al !oniguration ile ,et!,youtu%e-dl.!on: do not read the user
!oniguration
in 9,.!onig,youtu%e-dl.!on ":&++7&*&
:,youtu%e-dl,!onig.txt on 8indo#s$
;ideo -ele!tion:
--playlist-start /UM<0( playlist video to start at "deault is =$
--playlist-end /UM<0( playlist video to end at "deault is last$
--mat!h-title (0G03 do#nload only mat!hing titles "regex or
!aseless su%-string$
--re6e!t-title (0G03 skip do#nload or mat!hing titles "regex or
!aseless su%-string$
--max-do#nloads /UM<0( &%ort ater do#nloading /UM<0( iles
--min-ilesi>e -2?0 7o not do#nload any videos smaller than -2?0
"e.g. @Ak or BB.Cm$
--max-ilesi>e -2?0 7o not do#nload any videos larger than -2?0
"e.g. @Ak or BB.Cm$
--date 7&*0 do#nload only videos uploaded in this date
--date%eore 7&*0 do#nload only videos uploaded on or %eore
this date "i.e. in!lusive$
--dateater 7&*0 do#nload only videos uploaded on or ater this
date "i.e. in!lusive$
--min-vie#s DOU/* 7o not do#nload any videos #ith less than
DOU/* vie#s
--max-vie#s DOU/* 7o not do#nload any videos #ith more than
DOU/* vie#s
--no-playlist do#nload only the !urrently playing video
--age-limit E0&(- do#nload only videos suita%le or the given
age
--do#nload-ar!hive 12'0 7o#nload only videos not listed in the ar!hive
ile. (e!ord the 27s o all do#nloaded videos in it.
--in!lude-ads 7o#nload advertisements as #ell "experimental$
--youtu%e-in!lude-dash-maniest *ry to do#nload the 7&-) maniest on Eou*u%e
videos "experimental$
7o#nload Options:
-r, --rate-limit '2M2* maximum do#nload rate in %ytes per se!ond
"e.g. @AF or B.5M$
-(, --retries (0*(20- num%er o retries "deault is =A$
--%uer-si>e -2?0 si>e o do#nload %uer "e.g. =A5B or =CF$
"deault is =A5B$
--no-resi>e-%uer do not automati!ally ad6ust the %uer si>e.
<y deault, the %uer si>e is automati!ally resi>ed rom an initial value o -2?0.
1ilesystem Options:
-a, --%at!h-ile 12'0 ile !ontaining U('s to do#nload "G-G or
stdin$
--id use only video 27 in ile name
-&, --auto-num%er num%er do#nloaded iles starting rom AAAAA
-o, --output *0M+'&*0 output ilename template. Use :"title$s to get
the title, :"uploader$s or the uploader name, :"uploader_id$s or the uploader
ni!kname i dierent, :"autonum%er$s to get
an automati!ally in!remented num%er, :"ext$s or the ilename extension, :"ormat$s
or
the ormat des!ription "like .55 - =5HAxI5A.
or .)7.$, :"ormat_id$s or the uni4ue id o the ormat "like Eoutu%eGs itags:
.=JI.$,
:"upload_date$s or the upload date
"EEEEMM77$, :"extra!tor$s or the provider "youtu%e, meta!ae, et!$, :"id$s or the
video id,
:"playlist$s or the playlist the video is in,
:"playlist_index$s or the position in the playlist and :: or a literal per!ent.
:"height$s and :"#idth$s or the #idth and
height o the video ormat. :"resolution$s or a textual des!ription o the
resolution o
the video ormat. Use - to output to stdout.
Dan also %e used to do#nload to a dierent dire!tory, or example #ith -o
G,my,do#nloads,:"uploader$s,:"title$s-:"id$s.:
"ext$sG .
--autonum%er-si>e /UM<0( -pe!iies the num%er o digits in :
"autonum%er$s #hen it is present in output ilename template or --auto-num%er
option is given
--restri!t-ilenames (estri!t ilenames to only &-D22 !hara!ters,
and avoid .K. and spa!es in ilenames
-t, --title [depre!ated] use title in ile name "deault$
-l, --literal [depre!ated] alias o --title
-#, --no-over#rites do not over#rite iles
-!, --!ontinue or!e resume o partially do#nloaded iles. <y
deault, youtu%e-dl #ill resume do#nloads i possi%le.
--no-!ontinue do not resume partially do#nloaded iles
"restart rom %eginning$
--no-part do not use .part iles
--no-mtime do not use the 'ast-modiied header to set the
ile modii!ation time
--#rite-des!ription #rite video des!ription to a .des!ription ile
--#rite-ino-6son #rite video metadata to a .ino.6son ile
--#rite-annotations #rite video annotations to a .annotation ile
--#rite-thum%nail #rite thum%nail image to disk
--load-ino 12'0 6son ile !ontaining the video inormation
"!reated #ith the .--#rite-6son. option$
--!ookies 12'0 ile to read !ookies rom and dump !ookie 6ar
in
--!a!he-dir 72( 'o!ation in the ilesystem #here youtu%e-dl
!an store some do#nloaded inormation permanently. <y deault
L37G_D&D)0_)OM0,youtu%e-dl
or 9,.!a!he,youtu%e-dl . &t the moment, only
Eou*u%e player iles "or videos #ith o%us!ated signatures$ are !a!hed, %ut that
may
!hange.
--no-!a!he-dir 7isa%le ilesystem !a!hing
--rm-!a!he-dir 7elete all ilesystem !a!he iles
;er%osity , -imulation Options:
-4, --4uiet a!tivates 4uiet mode
--no-#arnings 2gnore #arnings
-s, --simulate do not do#nload the video and do not #rite
anything to disk
--skip-do#nload do not do#nload the video
-g, --get-url simulate, 4uiet %ut print U('
-e, --get-title simulate, 4uiet %ut print title
--get-id simulate, 4uiet %ut print id
--get-thum%nail simulate, 4uiet %ut print thum%nail U('
--get-des!ription simulate, 4uiet %ut print video des!ription
--get-duration simulate, 4uiet %ut print video length
--get-ilename simulate, 4uiet %ut print output ilename
--get-ormat simulate, 4uiet %ut print output ormat
-6, --dump-6son simulate, 4uiet %ut print M-O/ inormation.
-ee --output or a des!ription o availa%le keys.
--ne#line output progress %ar as ne# lines
--no-progress do not print progress %ar
--!onsole-title display progress in !onsole title%ar
-v, --ver%ose print various de%ugging inormation
--dump-intermediate-pages print do#nloaded pages to de%ug pro%lems "very
ver%ose$
--#rite-pages 8rite do#nloaded intermediary pages to iles
in the !urrent dire!tory to de%ug pro%lems
--print-trai! 7isplay sent and read )**+ trai!
8orkarounds:
--en!oding 0/DO72/G 1or!e the spe!iied en!oding "experimental$
--no-!he!k-!ertii!ate -uppress )**+- !ertii!ate validation.
--preer-inse!ure Use an unen!rypted !onne!tion to retrieve
inormation a%out the video. "Durrently supported only or Eou*u%e$
--user-agent U& spe!iy a !ustom user agent
--reerer (01 spe!iy a !ustom reerer, use i the video
a!!ess is restri!ted to one domain
--add-header 120'7:;&'U0 spe!iy a !ustom )**+ header and its value,
separated %y a !olon G:G. Eou !an use this option multiple times
--%idi-#orkaround 8ork around terminals that la!k %idire!tional
text support. (e4uires %idiv or ri%idi exe!uta%le in +&*)
;ideo 1ormat Options:
-, --ormat 1O(M&* video ormat !ode, spe!iy the order o
preeren!e using slashes: .- 55,=I,=H.. .- mpB. and .- lv. are also supported.
Eou !an
also use the spe!ial names .%est.,
.%estvideo., .%estaudio., .#orst., .#orstvideo. and .#orstaudio.. <y deault,
youtu%e-dl #ill pi!k
the %est 4uality.
--all-ormats do#nload all availa%le video ormats
--preer-ree-ormats preer ree video ormats unless a spe!ii!
one is re4uested
--max-4uality 1O(M&* highest 4uality ormat to do#nload
-1, --list-ormats list all availa%le ormats
-u%title Options:
--#rite-su% #rite su%title ile
--#rite-auto-su% #rite automati! su%title ile "youtu%e only$
--all-su%s do#nloads all the availa%le su%titles o the
video
--list-su%s lists all availa%le su%titles or the video
--su%-ormat 1O(M&* su%title ormat "deaultNsrt$ "[s%v,vtt]
youtu%e only$
--su%-lang '&/G- languages o the su%titles to do#nload
"optional$ separated %y !ommas, use 20*1 language tags like Gen,ptG
&uthenti!ation Options:
-u, --username U-0(/&M0 a!!ount username
-p, --pass#ord +&--8O(7 a!!ount pass#ord
-5, --t#oa!tor *8O1&D*O( t#o-a!tor auth !ode
-n, --netr! use .netr! authenti!ation data
--video-pass#ord +&--8O(7 video pass#ord "vimeo, smotri$
+ost-pro!essing Options:
-x, --extra!t-audio !onvert video iles to audio-only iles
"re4uires mpeg or av!onv and pro%e or avpro%e$
--audio-ormat 1O(M&* .%est., .aa!., .vor%is., .mpJ., .mBa., .opus.,
or .#av.O %est %y deault
--audio-4uality PU&'2*E mpeg,av!onv audio 4uality spe!ii!ation,
insert a value %et#een A "%etter$ and Q "#orse$ or ;<( or a spe!ii! %itrate like
=5HF
"deault @$
--re!ode-video 1O(M&* 0n!ode the video to another ormat i
ne!essary "!urrently supported: mpBRlvRoggR#e%mRmkv$
-k, --keep-video keeps the video ile on disk ater the post-
pro!essingO the video is erased %y deault
--no-post-over#rites do not over#rite post-pro!essed ilesO the
post-pro!essed iles are over#ritten %y deault
--em%ed-su%s em%ed su%titles in the video "only or mpB
videos$
--em%ed-thum%nail em%ed thum%nail in the audio as !over art
--add-metadata #rite metadata to the video ile
--xattrs #rite metadata to the video ileGs xattrs
"using du%lin !ore and xdg standards$
--preer-av!onv +reer av!onv over mpeg or running the
postpro!essors "deault$
--preer-mpeg +reer mpeg over av!onv or running the
postpro!essors
--exe! DM7 0xe!ute a !ommand on the ile ater
do#nloading, similar to indGs -exe! syntax. 0xample: --exe! Gad% push ST
,sd!ard,Musi!, KK rm
STG