Raphaël G. Git Repositories - youtubedl/blob - youtube-dl.1

   1 .TH YOUTUBE\-DL 1 ""
   2 .SH NAME
   3 .PP
   4 youtube\-dl \- download videos from youtube.com or other video platforms
   5 .SH SYNOPSIS
   6 .PP
   7 \f[B]youtube\-dl\f[] OPTIONS (#options) URL [URL...]
   8 .SH DESCRIPTION
   9 .PP
  10 \f[B]youtube\-dl\f[] is a small command\-line program to download videos
  11 from YouTube.com and a few more sites.
  12 It requires the Python interpreter, version 2.6, 2.7, or 3.3+, and it is
  13 not platform specific.
  14 It should work on your Unix box, on Windows or on Mac OS X.
  15 It is released to the public domain, which means you can modify it,
  16 redistribute it or use it however you like.
  17 .SH OPTIONS
  18 .IP
  19 .nf
  20 \f[C]
  21 \-h,\ \-\-help\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ print\ this\ help\ text\ and\ exit
  22 \-\-version\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ print\ program\ version\ and\ exit
  23 \-U,\ \-\-update\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ update\ this\ program\ to\ latest\ version
  24 \-i,\ \-\-ignore\-errors\ \ \ \ \ \ \ \ continue\ on\ download\ errors
  25 \-r,\ \-\-rate\-limit\ LIMIT\ \ \ \ \ maximum\ download\ rate\ (e.g.\ 50k\ or\ 44.6m)
  26 \-R,\ \-\-retries\ RETRIES\ \ \ \ \ \ number\ of\ retries\ (default\ is\ 10)
  27 \-\-buffer\-size\ SIZE\ \ \ \ \ \ \ \ \ size\ of\ download\ buffer\ (e.g.\ 1024\ or\ 16k)
  28 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ (default\ is\ 1024)
  29 \-\-no\-resize\-buffer\ \ \ \ \ \ \ \ \ do\ not\ automatically\ adjust\ the\ buffer\ size.\ By
  30 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ default,\ the\ buffer\ size\ is\ automatically\ resized
  31 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ from\ an\ initial\ value\ of\ SIZE.
  32 \-\-dump\-user\-agent\ \ \ \ \ \ \ \ \ \ display\ the\ current\ browser\ identification
  33 \-\-user\-agent\ UA\ \ \ \ \ \ \ \ \ \ \ \ specify\ a\ custom\ user\ agent
  34 \-\-referer\ REF\ \ \ \ \ \ \ \ \ \ \ \ \ \ specify\ a\ custom\ referer,\ use\ if\ the\ video\ access
  35 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ is\ restricted\ to\ one\ domain
  36 \-\-list\-extractors\ \ \ \ \ \ \ \ \ \ List\ all\ supported\ extractors\ and\ the\ URLs\ they
  37 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ would\ handle
  38 \-\-proxy\ URL\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ Use\ the\ specified\ HTTP/HTTPS\ proxy
  39 \-\-no\-check\-certificate\ \ \ \ \ Suppress\ HTTPS\ certificate\ validation.
  40 \f[]
  41 .fi
  42 .SS Video Selection:
  43 .IP
  44 .nf
  45 \f[C]
  46 \-\-playlist\-start\ NUMBER\ \ \ \ playlist\ video\ to\ start\ at\ (default\ is\ 1)
  47 \-\-playlist\-end\ NUMBER\ \ \ \ \ \ playlist\ video\ to\ end\ at\ (default\ is\ last)
  48 \-\-match\-title\ REGEX\ \ \ \ \ \ \ \ download\ only\ matching\ titles\ (regex\ or\ caseless
  49 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ sub\-string)
  50 \-\-reject\-title\ REGEX\ \ \ \ \ \ \ skip\ download\ for\ matching\ titles\ (regex\ or
  51 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ caseless\ sub\-string)
  52 \-\-max\-downloads\ NUMBER\ \ \ \ \ Abort\ after\ downloading\ NUMBER\ files
  53 \-\-min\-filesize\ SIZE\ \ \ \ \ \ \ \ Do\ not\ download\ any\ videos\ smaller\ than\ SIZE
  54 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ (e.g.\ 50k\ or\ 44.6m)
  55 \-\-max\-filesize\ SIZE\ \ \ \ \ \ \ \ Do\ not\ download\ any\ videos\ larger\ than\ SIZE\ (e.g.
  56 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 50k\ or\ 44.6m)
  57 \-\-date\ DATE\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ download\ only\ videos\ uploaded\ in\ this\ date
  58 \-\-datebefore\ DATE\ \ \ \ \ \ \ \ \ \ download\ only\ videos\ uploaded\ before\ this\ date
  59 \-\-dateafter\ DATE\ \ \ \ \ \ \ \ \ \ \ download\ only\ videos\ uploaded\ after\ this\ date
  60 \f[]
  61 .fi
  62 .SS Filesystem Options:
  63 .IP
  64 .nf
  65 \f[C]
  66 \-t,\ \-\-title\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ use\ title\ in\ file\ name\ (default)
  67 \-\-id\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ use\ only\ video\ ID\ in\ file\ name
  68 \-l,\ \-\-literal\ \ \ \ \ \ \ \ \ \ \ \ \ \ [deprecated]\ alias\ of\ \-\-title
  69 \-A,\ \-\-auto\-number\ \ \ \ \ \ \ \ \ \ number\ downloaded\ files\ starting\ from\ 00000
  70 \-o,\ \-\-output\ TEMPLATE\ \ \ \ \ \ output\ filename\ template.\ Use\ %(title)s\ to\ get
  71 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ the\ title,\ %(uploader)s\ for\ the\ uploader\ name,
  72 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ %(uploader_id)s\ for\ the\ uploader\ nickname\ if
  73 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ different,\ %(autonumber)s\ to\ get\ an\ automatically
  74 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ incremented\ number,\ %(ext)s\ for\ the\ filename
  75 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ extension,\ %(upload_date)s\ for\ the\ upload\ date
  76 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ (YYYYMMDD),\ %(extractor)s\ for\ the\ provider
  77 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ (youtube,\ metacafe,\ etc),\ %(id)s\ for\ the\ video\ id
  78 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ ,\ %(playlist)s\ for\ the\ playlist\ the\ video\ is\ in,
  79 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ %(playlist_index)s\ for\ the\ position\ in\ the
  80 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ playlist\ and\ %%\ for\ a\ literal\ percent.\ Use\ \-\ to
  81 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ output\ to\ stdout.\ Can\ also\ be\ used\ to\ download\ to
  82 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ a\ different\ directory,\ for\ example\ with\ \-o\ \[aq]/my/d
  83 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ ownloads/%(uploader)s/%(title)s\-%(id)s.%(ext)s\[aq]\ .
  84 \-\-autonumber\-size\ NUMBER\ \ \ Specifies\ the\ number\ of\ digits\ in\ %(autonumber)s
  85 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ when\ it\ is\ present\ in\ output\ filename\ template\ or
  86 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \-\-autonumber\ option\ is\ given
  87 \-\-restrict\-filenames\ \ \ \ \ \ \ Restrict\ filenames\ to\ only\ ASCII\ characters,\ and
  88 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ avoid\ "&"\ and\ spaces\ in\ filenames
  89 \-a,\ \-\-batch\-file\ FILE\ \ \ \ \ \ file\ containing\ URLs\ to\ download\ (\[aq]\-\[aq]\ for\ stdin)
  90 \-w,\ \-\-no\-overwrites\ \ \ \ \ \ \ \ do\ not\ overwrite\ files
  91 \-c,\ \-\-continue\ \ \ \ \ \ \ \ \ \ \ \ \ resume\ partially\ downloaded\ files
  92 \-\-no\-continue\ \ \ \ \ \ \ \ \ \ \ \ \ \ do\ not\ resume\ partially\ downloaded\ files\ (restart
  93 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ from\ beginning)
  94 \-\-cookies\ FILE\ \ \ \ \ \ \ \ \ \ \ \ \ file\ to\ read\ cookies\ from\ and\ dump\ cookie\ jar\ in
  95 \-\-no\-part\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ do\ not\ use\ .part\ files
  96 \-\-no\-mtime\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ do\ not\ use\ the\ Last\-modified\ header\ to\ set\ the
  97 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ file\ modification\ time
  98 \-\-write\-description\ \ \ \ \ \ \ \ write\ video\ description\ to\ a\ .description\ file
  99 \-\-write\-info\-json\ \ \ \ \ \ \ \ \ \ write\ video\ metadata\ to\ a\ .info.json\ file
 100 \-\-write\-thumbnail\ \ \ \ \ \ \ \ \ \ write\ thumbnail\ image\ to\ disk
 101 \f[]
 102 .fi
 103 .SS Verbosity / Simulation Options:
 104 .IP
 105 .nf
 106 \f[C]
 107 \-q,\ \-\-quiet\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ activates\ quiet\ mode
 108 \-s,\ \-\-simulate\ \ \ \ \ \ \ \ \ \ \ \ \ do\ not\ download\ the\ video\ and\ do\ not\ write
 109 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ anything\ to\ disk
 110 \-\-skip\-download\ \ \ \ \ \ \ \ \ \ \ \ do\ not\ download\ the\ video
 111 \-g,\ \-\-get\-url\ \ \ \ \ \ \ \ \ \ \ \ \ \ simulate,\ quiet\ but\ print\ URL
 112 \-e,\ \-\-get\-title\ \ \ \ \ \ \ \ \ \ \ \ simulate,\ quiet\ but\ print\ title
 113 \-\-get\-id\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ simulate,\ quiet\ but\ print\ id
 114 \-\-get\-thumbnail\ \ \ \ \ \ \ \ \ \ \ \ simulate,\ quiet\ but\ print\ thumbnail\ URL
 115 \-\-get\-description\ \ \ \ \ \ \ \ \ \ simulate,\ quiet\ but\ print\ video\ description
 116 \-\-get\-filename\ \ \ \ \ \ \ \ \ \ \ \ \ simulate,\ quiet\ but\ print\ output\ filename
 117 \-\-get\-format\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ simulate,\ quiet\ but\ print\ output\ format
 118 \-\-newline\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ output\ progress\ bar\ as\ new\ lines
 119 \-\-no\-progress\ \ \ \ \ \ \ \ \ \ \ \ \ \ do\ not\ print\ progress\ bar
 120 \-\-console\-title\ \ \ \ \ \ \ \ \ \ \ \ display\ progress\ in\ console\ titlebar
 121 \-v,\ \-\-verbose\ \ \ \ \ \ \ \ \ \ \ \ \ \ print\ various\ debugging\ information
 122 \-\-dump\-intermediate\-pages\ \ print\ downloaded\ pages\ to\ debug\ problems(very
 123 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ verbose)
 124 \f[]
 125 .fi
 126 .SS Video Format Options:
 127 .IP
 128 .nf
 129 \f[C]
 130 \-f,\ \-\-format\ FORMAT\ \ \ \ \ \ \ \ video\ format\ code,\ specifiy\ the\ order\ of
 131 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ preference\ using\ slashes:\ "\-f\ 22/17/18"
 132 \-\-all\-formats\ \ \ \ \ \ \ \ \ \ \ \ \ \ download\ all\ available\ video\ formats
 133 \-\-prefer\-free\-formats\ \ \ \ \ \ prefer\ free\ video\ formats\ unless\ a\ specific\ one
 134 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ is\ requested
 135 \-\-max\-quality\ FORMAT\ \ \ \ \ \ \ highest\ quality\ format\ to\ download
 136 \-F,\ \-\-list\-formats\ \ \ \ \ \ \ \ \ list\ all\ available\ formats\ (currently\ youtube
 137 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ only)
 138 \-\-write\-sub\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ write\ subtitle\ file\ (currently\ youtube\ only)
 139 \-\-write\-auto\-sub\ \ \ \ \ \ \ \ \ \ \ write\ automatic\ subtitle\ file\ (currently\ youtube
 140 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ only)
 141 \-\-only\-sub\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ [deprecated]\ alias\ of\ \-\-skip\-download
 142 \-\-all\-subs\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ downloads\ all\ the\ available\ subtitles\ of\ the
 143 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ video\ (currently\ youtube\ only)
 144 \-\-list\-subs\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ lists\ all\ available\ subtitles\ for\ the\ video
 145 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ (currently\ youtube\ only)
 146 \-\-sub\-format\ FORMAT\ \ \ \ \ \ \ \ subtitle\ format\ [srt/sbv/vtt]\ (default=srt)
 147 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ (currently\ youtube\ only)
 148 \-\-sub\-lang\ LANG\ \ \ \ \ \ \ \ \ \ \ \ language\ of\ the\ subtitles\ to\ download\ (optional)
 149 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ use\ IETF\ language\ tags\ like\ \[aq]en\[aq]
 150 \f[]
 151 .fi
 152 .SS Authentication Options:
 153 .IP
 154 .nf
 155 \f[C]
 156 \-u,\ \-\-username\ USERNAME\ \ \ \ account\ username
 157 \-p,\ \-\-password\ PASSWORD\ \ \ \ account\ password
 158 \-n,\ \-\-netrc\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ use\ .netrc\ authentication\ data
 159 \-\-video\-password\ PASSWORD\ \ video\ password\ (vimeo\ only)
 160 \f[]
 161 .fi
 162 .SS Post\-processing Options:
 163 .IP
 164 .nf
 165 \f[C]
 166 \-x,\ \-\-extract\-audio\ \ \ \ \ \ \ \ convert\ video\ files\ to\ audio\-only\ files\ (requires
 167 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ ffmpeg\ or\ avconv\ and\ ffprobe\ or\ avprobe)
 168 \-\-audio\-format\ FORMAT\ \ \ \ \ \ "best",\ "aac",\ "vorbis",\ "mp3",\ "m4a",\ "opus",\ or
 169 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ "wav";\ best\ by\ default
 170 \-\-audio\-quality\ QUALITY\ \ \ \ ffmpeg/avconv\ audio\ quality\ specification,\ insert
 171 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ a\ value\ between\ 0\ (better)\ and\ 9\ (worse)\ for\ VBR
 172 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ or\ a\ specific\ bitrate\ like\ 128K\ (default\ 5)
 173 \-\-recode\-video\ FORMAT\ \ \ \ \ \ Encode\ the\ video\ to\ another\ format\ if\ necessary
 174 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ (currently\ supported:\ mp4|flv|ogg|webm)
 175 \-k,\ \-\-keep\-video\ \ \ \ \ \ \ \ \ \ \ keeps\ the\ video\ file\ on\ disk\ after\ the\ post\-
 176 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ processing;\ the\ video\ is\ erased\ by\ default
 177 \-\-no\-post\-overwrites\ \ \ \ \ \ \ do\ not\ overwrite\ post\-processed\ files;\ the\ post\-
 178 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ processed\ files\ are\ overwritten\ by\ default
 179 \f[]
 180 .fi
 181 .SH CONFIGURATION
 182 .PP
 183 You can configure youtube\-dl by placing default arguments (such as
 184 \f[C]\-\-extract\-audio\ \-\-no\-mtime\f[] to always extract the audio
 185 and not copy the mtime) into \f[C]/etc/youtube\-dl.conf\f[] and/or
 186 \f[C]~/.config/youtube\-dl.conf\f[].
 187 .SH OUTPUT TEMPLATE
 188 .PP
 189 The \f[C]\-o\f[] option allows users to indicate a template for the
 190 output file names.
 191 The basic usage is not to set any template arguments when downloading a
 192 single file, like in
 193 \f[C]youtube\-dl\ \-o\ funny_video.flv\ "http://some/video"\f[].
 194 However, it may contain special sequences that will be replaced when
 195 downloading each video.
 196 The special sequences have the format \f[C]%(NAME)s\f[].
 197 To clarify, that is a percent symbol followed by a name in parenthesis,
 198 followed by a lowercase S.
 199 Allowed names are:
 200 .IP \[bu] 2
 201 \f[C]id\f[]: The sequence will be replaced by the video identifier.
 202 .IP \[bu] 2
 203 \f[C]url\f[]: The sequence will be replaced by the video URL.
 204 .IP \[bu] 2
 205 \f[C]uploader\f[]: The sequence will be replaced by the nickname of the
 206 person who uploaded the video.
 207 .IP \[bu] 2
 208 \f[C]upload_date\f[]: The sequence will be replaced by the upload date
 209 in YYYYMMDD format.
 210 .IP \[bu] 2
 211 \f[C]title\f[]: The sequence will be replaced by the video title.
 212 .IP \[bu] 2
 213 \f[C]ext\f[]: The sequence will be replaced by the appropriate extension
 214 (like flv or mp4).
 215 .IP \[bu] 2
 216 \f[C]epoch\f[]: The sequence will be replaced by the Unix epoch when
 217 creating the file.
 218 .IP \[bu] 2
 219 \f[C]autonumber\f[]: The sequence will be replaced by a five\-digit
 220 number that will be increased with each download, starting at zero.
 221 .IP \[bu] 2
 222 \f[C]playlist\f[]: The name or the id of the playlist that contains the
 223 video.
 224 .IP \[bu] 2
 225 \f[C]playlist_index\f[]: The index of the video in the playlist, a
 226 five\-digit number.
 227 .PP
 228 The current default template is \f[C]%(id)s.%(ext)s\f[], but that will
 229 be switchted to \f[C]%(title)s\-%(id)s.%(ext)s\f[] (which can be
 230 requested with \f[C]\-t\f[] at the moment).
 231 .PP
 232 In some cases, you don\[aq]t want special characters such as 中, spaces,
 233 or &, such as when transferring the downloaded filename to a Windows
 234 system or the filename through an 8bit\-unsafe channel.
 235 In these cases, add the \f[C]\-\-restrict\-filenames\f[] flag to get a
 236 shorter title:
 237 .IP
 238 .nf
 239 \f[C]
 240 $\ youtube\-dl\ \-\-get\-filename\ \-o\ "%(title)s.%(ext)s"\ BaW_jenozKc
 241 youtube\-dl\ test\ video\ \[aq]\[aq]_ä↭𝕐.mp4\ \ \ \ #\ All\ kinds\ of\ weird\ characters
 242 $\ youtube\-dl\ \-\-get\-filename\ \-o\ "%(title)s.%(ext)s"\ BaW_jenozKc\ \-\-restrict\-filenames
 243 youtube\-dl_test_video_.mp4\ \ \ \ \ \ \ \ \ \ #\ A\ simple\ file\ name
 244 \f[]
 245 .fi
 246 .SH VIDEO SELECTION
 247 .PP
 248 Videos can be filtered by their upload date using the options
 249 \f[C]\-\-date\f[], \f[C]\-\-datebefore\f[] or \f[C]\-\-dateafter\f[],
 250 they accept dates in two formats:
 251 .IP \[bu] 2
 252 Absolute dates: Dates in the format \f[C]YYYYMMDD\f[].
 253 .IP \[bu] 2
 254 Relative dates: Dates in the format
 255 \f[C](now|today)[+\-][0\-9](day|week|month|year)(s)?\f[]
 256 .PP
 257 Examples:
 258 .IP
 259 .nf
 260 \f[C]
 261 $\ youtube\-dl\ \-\-dateafter\ now\-6months\ #will\ only\ download\ the\ videos\ uploaded\ in\ the\ last\ 6\ months
 262 $\ youtube\-dl\ \-\-date\ 19700101\ #will\ only\ download\ the\ videos\ uploaded\ in\ January\ 1,\ 1970
 263 $\ youtube\-dl\ \-\-dateafter\ 20000101\ \-\-datebefore\ 20100101\ #will\ only\ download\ the\ videos\ uploaded\ between\ 2000\ and\ 2010
 264 \f[]
 265 .fi
 266 .SH FAQ
 267 .SS Can you please put the \-b option back?
 268 .PP
 269 Most people asking this question are not aware that youtube\-dl now
 270 defaults to downloading the highest available quality as reported by
 271 YouTube, which will be 1080p or 720p in some cases, so you no longer
 272 need the \-b option.
 273 For some specific videos, maybe YouTube does not report them to be
 274 available in a specific high quality format you\[aq]\[aq]re interested
 275 in.
 276 In that case, simply request it with the \-f option and youtube\-dl will
 277 try to download it.
 278 .SS I get HTTP error 402 when trying to download a video. What\[aq]s
 279 this?
 280 .PP
 281 Apparently YouTube requires you to pass a CAPTCHA test if you download
 282 too much.
 283 We\[aq]\[aq]re considering to provide a way to let you solve the
 284 CAPTCHA (https://github.com/rg3/youtube-dl/issues/154), but at the
 285 moment, your best course of action is pointing a webbrowser to the
 286 youtube URL, solving the CAPTCHA, and restart youtube\-dl.
 287 .SS I have downloaded a video but how can I play it?
 288 .PP
 289 Once the video is fully downloaded, use any video player, such as
 290 vlc (http://www.videolan.org) or mplayer (http://www.mplayerhq.hu/).
 291 .SS The links provided by youtube\-dl \-g are not working anymore
 292 .PP
 293 The URLs youtube\-dl outputs require the downloader to have the correct
 294 cookies.
 295 Use the \f[C]\-\-cookies\f[] option to write the required cookies into a
 296 file, and advise your downloader to read cookies from that file.
 297 Some sites also require a common user agent to be used, use
 298 \f[C]\-\-dump\-user\-agent\f[] to see the one in use by youtube\-dl.
 299 .SS ERROR: no fmt_url_map or conn information found in video info
 300 .PP
 301 youtube has switched to a new video info format in July 2011 which is
 302 not supported by old versions of youtube\-dl.
 303 You can update youtube\-dl with \f[C]sudo\ youtube\-dl\ \-\-update\f[].
 304 .SS ERROR: unable to download video
 305 .PP
 306 youtube requires an additional signature since September 2012 which is
 307 not supported by old versions of youtube\-dl.
 308 You can update youtube\-dl with \f[C]sudo\ youtube\-dl\ \-\-update\f[].
 309 .SS SyntaxError: Non\-ASCII character
 310 .PP
 311 The error
 312 .IP
 313 .nf
 314 \f[C]
 315 File\ "youtube\-dl",\ line\ 2
 316 SyntaxError:\ Non\-ASCII\ character\ \[aq]\\x93\[aq]\ ...
 317 \f[]
 318 .fi
 319 .PP
 320 means you\[aq]re using an outdated version of Python.
 321 Please update to Python 2.6 or 2.7.
 322 .SS What is this binary file? Where has the code gone?
 323 .PP
 324 Since June 2012 (#342) youtube\-dl is packed as an executable zipfile,
 325 simply unzip it (might need renaming to \f[C]youtube\-dl.zip\f[] first
 326 on some systems) or clone the git repository, as laid out above.
 327 If you modify the code, you can run it by executing the
 328 \f[C]__main__.py\f[] file.
 329 To recompile the executable, run \f[C]make\ youtube\-dl\f[].
 330 .SS The exe throws a \f[I]Runtime error from Visual C++\f[]
 331 .PP
 332 To run the exe you need to install first the Microsoft Visual C++ 2008
 333 Redistributable
 334 Package (http://www.microsoft.com/en-us/download/details.aspx?id=29).
 335 .SH COPYRIGHT
 336 .PP
 337 youtube\-dl is released into the public domain by the copyright holders.
 338 .PP
 339 This README file was originally written by Daniel Bolton
 340 (<https://github.com/dbbolton>) and is likewise released into the public
 341 domain.
 342 .SH BUGS
 343 .PP
 344 Bugs and suggestions should be reported at:
 345 <https://github.com/rg3/youtube-dl/issues>
 346 .PP
 347 Please include:
 348 .IP \[bu] 2
 349 Your exact command line, like
 350 \f[C]youtube\-dl\ \-t\ "http://www.youtube.com/watch?v=uHlDtZ6Oc3s&feature=channel_video_title"\f[].
 351 A common mistake is not to escape the \f[C]&\f[].
 352 Putting URLs in quotes should solve this problem.
 353 .IP \[bu] 2
 354 If possible re\-run the command with \f[C]\-\-verbose\f[], and include
 355 the full output, it is really helpful to us.
 356 .IP \[bu] 2
 357 The output of \f[C]youtube\-dl\ \-\-version\f[]
 358 .IP \[bu] 2
 359 The output of \f[C]python\ \-\-version\f[]
 360 .IP \[bu] 2
 361 The name and version of your Operating System ("Ubuntu 11.04 x64" or
 362 "Windows 7 x64" is usually enough).
 363 .PP
 364 For discussions, join us in the irc channel #youtube\-dl on freenode.