~ubuntu-branches/ubuntu/vivid/youtube-dl/vivid

« back to all changes in this revision

Viewing changes to README.txt

  • Committer: Package Import Robot
  • Author(s): Rogério Brito
  • Date: 2015-03-01 02:12:13 UTC
  • mfrom: (44.1.24 sid)
  • Revision ID: package-import@ubuntu.com-20150301021213-8w657cue71kp77sz
Tags: 2015.02.28-1
Imported Upstream version 2015.02.28. Closes: #778765.

Show diffs side-by-side

added added

removed removed

Lines of Context:
87
87
                                     on Windows)
88
88
    --flat-playlist                  Do not extract the videos of a playlist,
89
89
                                     only list them.
 
90
    --no-color                       Do not emit color codes in output.
90
91
 
91
92
Network Options:
92
93
----------------
133
134
                                     COUNT views
134
135
    --max-views COUNT                Do not download any videos with more than
135
136
                                     COUNT views
 
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
139
159
                                     age
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
164
186
                                     aria2c,curl,wget
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
358
382
                                     the video
359
383
    --list-subs                      lists all available subtitles for the video
360
 
    --sub-format FORMAT              subtitle format (default=srt) ([sbv/vtt]
361
 
                                     youtube only)
 
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
411
435
                                     postprocessors
 
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)
416
445
 
417
446
CONFIGURATION
418
447
=============
597
626
 
598
627
ERROR: no fmt_url_map or conn information found in video info
599
628
 
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
 
631
youtube-dl.
603
632
 
604
633
ERROR: unable to download video
605
634
 
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
 
637
youtube-dl.
 
638
 
 
639
ExtractorError: Could not find JS function u'OF'
 
640
 
 
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.
609
644
 
610
645
SyntaxError: Non-ASCII character
611
646
 
683
718
 
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.
689
724