]> Raphaël G. Git Repositories - youtubedl/blob - youtube-dl.1
9707195572534b16e6a0af74a6e64a83998c8673
[youtubedl] / 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 \-\-only\-sub\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ [deprecated]\ alias\ of\ \-\-skip\-download
140 \-\-all\-subs\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ downloads\ all\ the\ available\ subtitles\ of\ the
141 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ video\ (currently\ youtube\ only)
142 \-\-list\-subs\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ lists\ all\ available\ subtitles\ for\ the\ video
143 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ (currently\ youtube\ only)
144 \-\-sub\-format\ FORMAT\ \ \ \ \ \ \ \ subtitle\ format\ [srt/sbv]\ (default=srt)
145 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ (currently\ youtube\ only)
146 \-\-sub\-lang\ LANG\ \ \ \ \ \ \ \ \ \ \ \ language\ of\ the\ subtitles\ to\ download\ (optional)
147 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ use\ IETF\ language\ tags\ like\ \[aq]en\[aq]
148 \f[]
149 .fi
150 .SS Authentication Options:
151 .IP
152 .nf
153 \f[C]
154 \-u,\ \-\-username\ USERNAME\ \ \ \ account\ username
155 \-p,\ \-\-password\ PASSWORD\ \ \ \ account\ password
156 \-n,\ \-\-netrc\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ use\ .netrc\ authentication\ data
157 \-\-video\-password\ PASSWORD\ \ video\ password\ (vimeo\ only)
158 \f[]
159 .fi
160 .SS Post\-processing Options:
161 .IP
162 .nf
163 \f[C]
164 \-x,\ \-\-extract\-audio\ \ \ \ \ \ \ \ convert\ video\ files\ to\ audio\-only\ files\ (requires
165 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ ffmpeg\ or\ avconv\ and\ ffprobe\ or\ avprobe)
166 \-\-audio\-format\ FORMAT\ \ \ \ \ \ "best",\ "aac",\ "vorbis",\ "mp3",\ "m4a",\ "opus",\ or
167 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ "wav";\ best\ by\ default
168 \-\-audio\-quality\ QUALITY\ \ \ \ ffmpeg/avconv\ audio\ quality\ specification,\ insert
169 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ a\ value\ between\ 0\ (better)\ and\ 9\ (worse)\ for\ VBR
170 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ or\ a\ specific\ bitrate\ like\ 128K\ (default\ 5)
171 \-\-recode\-video\ FORMAT\ \ \ \ \ \ Encode\ the\ video\ to\ another\ format\ if\ necessary
172 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ (currently\ supported:\ mp4|flv|ogg|webm)
173 \-k,\ \-\-keep\-video\ \ \ \ \ \ \ \ \ \ \ keeps\ the\ video\ file\ on\ disk\ after\ the\ post\-
174 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ processing;\ the\ video\ is\ erased\ by\ default
175 \-\-no\-post\-overwrites\ \ \ \ \ \ \ do\ not\ overwrite\ post\-processed\ files;\ the\ post\-
176 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ processed\ files\ are\ overwritten\ by\ default
177 \f[]
178 .fi
179 .SH CONFIGURATION
180 .PP
181 You can configure youtube\-dl by placing default arguments (such as
182 \f[C]\-\-extract\-audio\ \-\-no\-mtime\f[] to always extract the audio
183 and not copy the mtime) into \f[C]/etc/youtube\-dl.conf\f[] and/or
184 \f[C]~/.config/youtube\-dl.conf\f[].
185 .SH OUTPUT TEMPLATE
186 .PP
187 The \f[C]\-o\f[] option allows users to indicate a template for the
188 output file names.
189 The basic usage is not to set any template arguments when downloading a
190 single file, like in
191 \f[C]youtube\-dl\ \-o\ funny_video.flv\ "http://some/video"\f[].
192 However, it may contain special sequences that will be replaced when
193 downloading each video.
194 The special sequences have the format \f[C]%(NAME)s\f[].
195 To clarify, that is a percent symbol followed by a name in parenthesis,
196 followed by a lowercase S.
197 Allowed names are:
198 .IP \[bu] 2
199 \f[C]id\f[]: The sequence will be replaced by the video identifier.
200 .IP \[bu] 2
201 \f[C]url\f[]: The sequence will be replaced by the video URL.
202 .IP \[bu] 2
203 \f[C]uploader\f[]: The sequence will be replaced by the nickname of the
204 person who uploaded the video.
205 .IP \[bu] 2
206 \f[C]upload_date\f[]: The sequence will be replaced by the upload date
207 in YYYYMMDD format.
208 .IP \[bu] 2
209 \f[C]title\f[]: The sequence will be replaced by the video title.
210 .IP \[bu] 2
211 \f[C]ext\f[]: The sequence will be replaced by the appropriate extension
212 (like flv or mp4).
213 .IP \[bu] 2
214 \f[C]epoch\f[]: The sequence will be replaced by the Unix epoch when
215 creating the file.
216 .IP \[bu] 2
217 \f[C]autonumber\f[]: The sequence will be replaced by a five\-digit
218 number that will be increased with each download, starting at zero.
219 .IP \[bu] 2
220 \f[C]playlist\f[]: The name or the id of the playlist that contains the
221 video.
222 .IP \[bu] 2
223 \f[C]playlist_index\f[]: The index of the video in the playlist, a
224 five\-digit number.
225 .PP
226 The current default template is \f[C]%(id)s.%(ext)s\f[], but that will
227 be switchted to \f[C]%(title)s\-%(id)s.%(ext)s\f[] (which can be
228 requested with \f[C]\-t\f[] at the moment).
229 .PP
230 In some cases, you don\[aq]t want special characters such as 中, spaces,
231 or &, such as when transferring the downloaded filename to a Windows
232 system or the filename through an 8bit\-unsafe channel.
233 In these cases, add the \f[C]\-\-restrict\-filenames\f[] flag to get a
234 shorter title:
235 .IP
236 .nf
237 \f[C]
238 $\ youtube\-dl\ \-\-get\-filename\ \-o\ "%(title)s.%(ext)s"\ BaW_jenozKc
239 youtube\-dl\ test\ video\ \[aq]\[aq]_ä↭𝕐.mp4\ \ \ \ #\ All\ kinds\ of\ weird\ characters
240 $\ youtube\-dl\ \-\-get\-filename\ \-o\ "%(title)s.%(ext)s"\ BaW_jenozKc\ \-\-restrict\-filenames
241 youtube\-dl_test_video_.mp4\ \ \ \ \ \ \ \ \ \ #\ A\ simple\ file\ name
242 \f[]
243 .fi
244 .SH VIDEO SELECTION
245 .PP
246 Videos can be filtered by their upload date using the options
247 \f[C]\-\-date\f[], \f[C]\-\-datebefore\f[] or \f[C]\-\-dateafter\f[],
248 they accept dates in two formats:
249 .IP \[bu] 2
250 Absolute dates: Dates in the format \f[C]YYYYMMDD\f[].
251 .IP \[bu] 2
252 Relative dates: Dates in the format
253 \f[C](now|today)[+\-][0\-9](day|week|month|year)(s)?\f[]
254 .PP
255 Examples:
256 .IP
257 .nf
258 \f[C]
259 $\ youtube\-dl\ \-\-dateafter\ now\-6months\ #will\ only\ download\ the\ videos\ uploaded\ in\ the\ last\ 6\ months
260 $\ youtube\-dl\ \-\-date\ 19700101\ #will\ only\ download\ the\ videos\ uploaded\ in\ January\ 1,\ 1970
261 $\ youtube\-dl\ \-\-dateafter\ 20000101\ \-\-datebefore\ 20100101\ #will\ only\ download\ the\ videos\ uploaded\ between\ 2000\ and\ 2010
262 \f[]
263 .fi
264 .SH FAQ
265 .SS Can you please put the \-b option back?
266 .PP
267 Most people asking this question are not aware that youtube\-dl now
268 defaults to downloading the highest available quality as reported by
269 YouTube, which will be 1080p or 720p in some cases, so you no longer
270 need the \-b option.
271 For some specific videos, maybe YouTube does not report them to be
272 available in a specific high quality format you\[aq]\[aq]re interested
273 in.
274 In that case, simply request it with the \-f option and youtube\-dl will
275 try to download it.
276 .SS I get HTTP error 402 when trying to download a video. What\[aq]s
277 this?
278 .PP
279 Apparently YouTube requires you to pass a CAPTCHA test if you download
280 too much.
281 We\[aq]\[aq]re considering to provide a way to let you solve the
282 CAPTCHA (https://github.com/rg3/youtube-dl/issues/154), but at the
283 moment, your best course of action is pointing a webbrowser to the
284 youtube URL, solving the CAPTCHA, and restart youtube\-dl.
285 .SS I have downloaded a video but how can I play it?
286 .PP
287 Once the video is fully downloaded, use any video player, such as
288 vlc (http://www.videolan.org) or mplayer (http://www.mplayerhq.hu/).
289 .SS The links provided by youtube\-dl \-g are not working anymore
290 .PP
291 The URLs youtube\-dl outputs require the downloader to have the correct
292 cookies.
293 Use the \f[C]\-\-cookies\f[] option to write the required cookies into a
294 file, and advise your downloader to read cookies from that file.
295 Some sites also require a common user agent to be used, use
296 \f[C]\-\-dump\-user\-agent\f[] to see the one in use by youtube\-dl.
297 .SS ERROR: no fmt_url_map or conn information found in video info
298 .PP
299 youtube has switched to a new video info format in July 2011 which is
300 not supported by old versions of youtube\-dl.
301 You can update youtube\-dl with \f[C]sudo\ youtube\-dl\ \-\-update\f[].
302 .SS ERROR: unable to download video
303 .PP
304 youtube requires an additional signature since September 2012 which is
305 not supported by old versions of youtube\-dl.
306 You can update youtube\-dl with \f[C]sudo\ youtube\-dl\ \-\-update\f[].
307 .SS SyntaxError: Non\-ASCII character
308 .PP
309 The error
310 .IP
311 .nf
312 \f[C]
313 File\ "youtube\-dl",\ line\ 2
314 SyntaxError:\ Non\-ASCII\ character\ \[aq]\\x93\[aq]\ ...
315 \f[]
316 .fi
317 .PP
318 means you\[aq]re using an outdated version of Python.
319 Please update to Python 2.6 or 2.7.
320 .SS What is this binary file? Where has the code gone?
321 .PP
322 Since June 2012 (#342) youtube\-dl is packed as an executable zipfile,
323 simply unzip it (might need renaming to \f[C]youtube\-dl.zip\f[] first
324 on some systems) or clone the git repository, as laid out above.
325 If you modify the code, you can run it by executing the
326 \f[C]__main__.py\f[] file.
327 To recompile the executable, run \f[C]make\ youtube\-dl\f[].
328 .SS The exe throws a \f[I]Runtime error from Visual C++\f[]
329 .PP
330 To run the exe you need to install first the Microsoft Visual C++ 2008
331 Redistributable
332 Package (http://www.microsoft.com/en-us/download/details.aspx?id=29).
333 .SH COPYRIGHT
334 .PP
335 youtube\-dl is released into the public domain by the copyright holders.
336 .PP
337 This README file was originally written by Daniel Bolton
338 (<https://github.com/dbbolton>) and is likewise released into the public
339 domain.
340 .SH BUGS
341 .PP
342 Bugs and suggestions should be reported at:
343 <https://github.com/rg3/youtube-dl/issues>
344 .PP
345 Please include:
346 .IP \[bu] 2
347 Your exact command line, like
348 \f[C]youtube\-dl\ \-t\ "http://www.youtube.com/watch?v=uHlDtZ6Oc3s&feature=channel_video_title"\f[].
349 A common mistake is not to escape the \f[C]&\f[].
350 Putting URLs in quotes should solve this problem.
351 .IP \[bu] 2
352 If possible re\-run the command with \f[C]\-\-verbose\f[], and include
353 the full output, it is really helpful to us.
354 .IP \[bu] 2
355 The output of \f[C]youtube\-dl\ \-\-version\f[]
356 .IP \[bu] 2
357 The output of \f[C]python\ \-\-version\f[]
358 .IP \[bu] 2
359 The name and version of your Operating System ("Ubuntu 11.04 x64" or
360 "Windows 7 x64" is usually enough).
361 .PP
362 For discussions, join us in the irc channel #youtube\-dl on freenode.