134
135
--max-views COUNT Do not download any videos with more than
137
--match-filter FILTER (Experimental) Generic video filter.
138
Specify any key (see help for -o for a list
139
of available keys) to match if the key is
140
present, !key to check if the key is not
141
present,key > NUMBER (like "comment_count >
142
12", also works with >=, <, <=, !=, =) to
143
compare against a number, and & to require
144
multiple matches. Values which are not
145
known are excluded unless you put a
146
question mark (?) after the operator.For
147
example, to only match videos that have
148
been liked more than 100 times and disliked
149
less than 50 times (or the dislike
150
functionality is not available at the given
151
service), but who also have a description,
152
use --match-filter "like_count > 100 &
153
dislike_count <? 50 & description" .
136
154
--no-playlist If the URL refers to a video and a
137
155
playlist, download only the video.
156
--yes-playlist If the URL refers to a video and a
157
playlist, download the playlist.
138
158
--age-limit YEARS download only videos suitable for the given
140
160
--download-archive FILE Download only videos not listed in the
159
179
--playlist-reverse Download playlist videos in reverse order
160
180
--xattr-set-filesize (experimental) set file xattribute
161
181
ytdl.filesize with expected filesize
182
--hls-prefer-native (experimental) Use the native HLS
183
downloader instead of ffmpeg.
162
184
--external-downloader COMMAND (experimental) Use the specified external
163
185
downloader. Currently supports
318
340
video results by putting a condition in
319
341
brackets, as in -f "best[height=720]" (or
320
342
-f "[filesize>10M]"). This works for
321
filesize, height, width, tbr, abr, vbr, and
322
fps and the comparisons <, <=, >, >=, =, !=
323
. Formats for which the value is not known
324
are excluded unless you put a question mark
325
(?) after the operator. You can combine
326
format filters, so -f "[height <=?
327
720][tbr>500]" selects up to 720p videos
328
(or videos where the height is not known)
329
with a bitrate of at least 500 KBit/s. By
330
default, youtube-dl will pick the best
331
quality. Use commas to download multiple
332
audio formats, such as -f
343
filesize, height, width, tbr, abr, vbr,
344
asr, and fps and the comparisons <, <=, >,
345
>=, =, != and for ext, acodec, vcodec,
346
container, and protocol and the comparisons
347
=, != . Formats for which the value is not
348
known are excluded unless you put a
349
question mark (?) after the operator. You
350
can combine format filters, so -f "[height
351
<=? 720][tbr>500]" selects up to 720p
352
videos (or videos where the height is not
353
known) with a bitrate of at least 500
354
KBit/s. By default, youtube-dl will pick
355
the best quality. Use commas to download
356
multiple audio formats, such as -f
333
357
136/137/mp4/bestvideo,140/m4a/bestaudio.
334
358
You can merge the video and audio of two
335
359
formats into a single file using -f <video-
357
381
--all-subs downloads all the available subtitles of
359
383
--list-subs lists all available subtitles for the video
360
--sub-format FORMAT subtitle format (default=srt) ([sbv/vtt]
384
--sub-format FORMAT subtitle format, accepts formats
385
preference, for example: "ass/srt/best"
362
386
--sub-lang LANGS languages of the subtitles to download
363
387
(optional) separated by commas, use IETF
364
388
language tags like 'en,pt'
409
433
postprocessors (default)
410
434
--prefer-ffmpeg Prefer ffmpeg over avconv for running the
436
--ffmpeg-location PATH Location of the ffmpeg/avconv binary;
437
either the path to the binary or its
438
containing directory.
412
439
--exec CMD Execute a command on the file after
413
440
downloading, similar to find's -exec
414
441
syntax. Example: --exec 'adb push {}
415
442
/sdcard/Music/ && rm {}'
443
--convert-subtitles FORMAT Convert the subtitles to other format
444
(currently supported: srt|ass|vtt)
598
627
ERROR: no fmt_url_map or conn information found in video info
600
youtube has switched to a new video info format in July 2011 which is
601
not supported by old versions of youtube-dl. You can update youtube-dl
602
with sudo youtube-dl --update.
629
YouTube has switched to a new video info format in July 2011 which is
630
not supported by old versions of youtube-dl. See above for how to update
604
633
ERROR: unable to download video
606
youtube requires an additional signature since September 2012 which is
607
not supported by old versions of youtube-dl. You can update youtube-dl
608
with sudo youtube-dl --update.
635
YouTube requires an additional signature since September 2012 which is
636
not supported by old versions of youtube-dl. See above for how to update
639
ExtractorError: Could not find JS function u'OF'
641
In February 2015, the new YouTube player contained a character sequence
642
in a string that was misinterpreted by old versions of youtube-dl. See
643
above for how to update youtube-dl.
610
645
SyntaxError: Non-ASCII character
684
719
For one, have a look at the list of supported sites. Note that it can
685
720
sometimes happen that the site changes its URL scheme (say, from
686
http://example.com/v/1234567 to http://example.com/v/1234567 ) and
721
http://example.com/video/1234567 to http://example.com/v/1234567 ) and
687
722
youtube-dl reports an URL of a service in that list as unsupported. In
688
723
that case, simply report a bug.