mirror of
				https://github.com/ytdl-org/youtube-dl.git
				synced 2025-10-29 09:26:20 -07:00 
			
		
		
		
	release 2015.03.03
This commit is contained in:
		
							
								
								
									
										411
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										411
									
								
								README.md
									
									
									
									
									
								
							| @@ -47,211 +47,107 @@ which means you can modify it, redistribute it or use it however you like. | |||||||
| # OPTIONS | # OPTIONS | ||||||
|     -h, --help                       print this help text and exit |     -h, --help                       print this help text and exit | ||||||
|     --version                        print program version and exit |     --version                        print program version and exit | ||||||
|     -U, --update                     update this program to latest version. Make |     -U, --update                     update this program to latest version. Make sure that you have sufficient permissions (run with sudo if needed) | ||||||
|                                      sure that you have sufficient permissions |     -i, --ignore-errors              continue on download errors, for example to skip unavailable videos in a playlist | ||||||
|                                      (run with sudo if needed) |     --abort-on-error                 Abort downloading of further videos (in the playlist or the command line) if an error occurs | ||||||
|     -i, --ignore-errors              continue on download errors, for example to |  | ||||||
|                                      skip unavailable videos in a playlist |  | ||||||
|     --abort-on-error                 Abort downloading of further videos (in the |  | ||||||
|                                      playlist or the command line) if an error |  | ||||||
|                                      occurs |  | ||||||
|     --dump-user-agent                display the current browser identification |     --dump-user-agent                display the current browser identification | ||||||
|     --list-extractors                List all supported extractors and the URLs |     --list-extractors                List all supported extractors and the URLs they would handle | ||||||
|                                      they would handle |     --extractor-descriptions         Output descriptions of all supported extractors | ||||||
|     --extractor-descriptions         Output descriptions of all supported |     --default-search PREFIX          Use this prefix for unqualified URLs. For example "gvsearch2:" downloads two videos from google videos for  youtube-dl "large apple". | ||||||
|                                      extractors |                                      Use the value "auto" to let youtube-dl guess ("auto_warning" to emit a warning when guessing). "error" just throws an error. The | ||||||
|     --default-search PREFIX          Use this prefix for unqualified URLs. For |                                      default value "fixup_error" repairs broken URLs, but emits an error if this is not possible instead of searching. | ||||||
|                                      example "gvsearch2:" downloads two videos |     --ignore-config                  Do not read configuration files. When given in the global configuration file /etc/youtube-dl.conf: Do not read the user configuration | ||||||
|                                      from google videos for  youtube-dl "large |                                      in ~/.config/youtube-dl/config (%APPDATA%/youtube-dl/config.txt on Windows) | ||||||
|                                      apple". Use the value "auto" to let |     --flat-playlist                  Do not extract the videos of a playlist, only list them. | ||||||
|                                      youtube-dl guess ("auto_warning" to emit a |  | ||||||
|                                      warning when guessing). "error" just throws |  | ||||||
|                                      an error. The default value "fixup_error" |  | ||||||
|                                      repairs broken URLs, but emits an error if |  | ||||||
|                                      this is not possible instead of searching. |  | ||||||
|     --ignore-config                  Do not read configuration files. When given |  | ||||||
|                                      in the global configuration file /etc |  | ||||||
|                                      /youtube-dl.conf: Do not read the user |  | ||||||
|                                      configuration in ~/.config/youtube- |  | ||||||
|                                      dl/config (%APPDATA%/youtube-dl/config.txt |  | ||||||
|                                      on Windows) |  | ||||||
|     --flat-playlist                  Do not extract the videos of a playlist, |  | ||||||
|                                      only list them. |  | ||||||
|     --no-color                       Do not emit color codes in output. |     --no-color                       Do not emit color codes in output. | ||||||
|  |  | ||||||
| ## Network Options: | ## Network Options: | ||||||
|     --proxy URL                      Use the specified HTTP/HTTPS proxy. Pass in |     --proxy URL                      Use the specified HTTP/HTTPS proxy. Pass in an empty string (--proxy "") for direct connection | ||||||
|                                      an empty string (--proxy "") for direct |  | ||||||
|                                      connection |  | ||||||
|     --socket-timeout SECONDS         Time to wait before giving up, in seconds |     --socket-timeout SECONDS         Time to wait before giving up, in seconds | ||||||
|     --source-address IP              Client-side IP address to bind to |     --source-address IP              Client-side IP address to bind to (experimental) | ||||||
|                                      (experimental) |     -4, --force-ipv4                 Make all connections via IPv4 (experimental) | ||||||
|     -4, --force-ipv4                 Make all connections via IPv4 |     -6, --force-ipv6                 Make all connections via IPv6 (experimental) | ||||||
|                                      (experimental) |  | ||||||
|     -6, --force-ipv6                 Make all connections via IPv6 |  | ||||||
|                                      (experimental) |  | ||||||
|  |  | ||||||
| ## Video Selection: | ## Video Selection: | ||||||
|     --playlist-start NUMBER          playlist video to start at (default is 1) |     --playlist-start NUMBER          playlist video to start at (default is 1) | ||||||
|     --playlist-end NUMBER            playlist video to end at (default is last) |     --playlist-end NUMBER            playlist video to end at (default is last) | ||||||
|     --playlist-items ITEM_SPEC       playlist video items to download. Specify |     --playlist-items ITEM_SPEC       playlist video items to download. Specify indices of the videos in the playlist seperated by commas like: "--playlist-items 1,2,5,8" | ||||||
|                                      indices of the videos in the playlist |                                      if you want to download videos indexed 1, 2, 5, 8 in the playlist. You can specify range: "--playlist-items 1-3,7,10-13", it will | ||||||
|                                      seperated by commas like: "--playlist-items |                                      download the videos at index 1, 2, 3, 7, 10, 11, 12 and 13. | ||||||
|                                      1,2,5,8" if you want to download videos |     --match-title REGEX              download only matching titles (regex or caseless sub-string) | ||||||
|                                      indexed 1, 2, 5, 8 in the playlist. You can |     --reject-title REGEX             skip download for matching titles (regex or caseless sub-string) | ||||||
|                                      specify range: "--playlist-items |  | ||||||
|                                      1-3,7,10-13", it will download the videos |  | ||||||
|                                      at index 1, 2, 3, 7, 10, 11, 12 and 13. |  | ||||||
|     --match-title REGEX              download only matching titles (regex or |  | ||||||
|                                      caseless sub-string) |  | ||||||
|     --reject-title REGEX             skip download for matching titles (regex or |  | ||||||
|                                      caseless sub-string) |  | ||||||
|     --max-downloads NUMBER           Abort after downloading NUMBER files |     --max-downloads NUMBER           Abort after downloading NUMBER files | ||||||
|     --min-filesize SIZE              Do not download any videos smaller than |     --min-filesize SIZE              Do not download any videos smaller than SIZE (e.g. 50k or 44.6m) | ||||||
|                                      SIZE (e.g. 50k or 44.6m) |     --max-filesize SIZE              Do not download any videos larger than SIZE (e.g. 50k or 44.6m) | ||||||
|     --max-filesize SIZE              Do not download any videos larger than SIZE |  | ||||||
|                                      (e.g. 50k or 44.6m) |  | ||||||
|     --date DATE                      download only videos uploaded in this date |     --date DATE                      download only videos uploaded in this date | ||||||
|     --datebefore DATE                download only videos uploaded on or before |     --datebefore DATE                download only videos uploaded on or before this date (i.e. inclusive) | ||||||
|                                      this date (i.e. inclusive) |     --dateafter DATE                 download only videos uploaded on or after this date (i.e. inclusive) | ||||||
|     --dateafter DATE                 download only videos uploaded on or after |     --min-views COUNT                Do not download any videos with less than COUNT views | ||||||
|                                      this date (i.e. inclusive) |     --max-views COUNT                Do not download any videos with more than COUNT views | ||||||
|     --min-views COUNT                Do not download any videos with less than |     --match-filter FILTER            (Experimental) Generic video filter. Specify any key (see help for -o for a list of available keys) to match if the key is present, | ||||||
|                                      COUNT views |                                      !key to check if the key is not present,key > NUMBER (like "comment_count > 12", also works with >=, <, <=, !=, =) to compare against | ||||||
|     --max-views COUNT                Do not download any videos with more than |                                      a number, and & to require multiple matches. Values which are not known are excluded unless you put a question mark (?) after the | ||||||
|                                      COUNT views |                                      operator.For example, to only match videos that have been liked more than 100 times and disliked less than 50 times (or the dislike | ||||||
|     --match-filter FILTER            (Experimental) Generic video filter. |                                      functionality is not available at the given service), but who also have a description, use  --match-filter "like_count > 100 & | ||||||
|                                      Specify any key (see help for -o for a list |  | ||||||
|                                      of available keys) to match if the key is |  | ||||||
|                                      present, !key to check if the key is not |  | ||||||
|                                      present,key > NUMBER (like "comment_count > |  | ||||||
|                                      12", also works with >=, <, <=, !=, =) to |  | ||||||
|                                      compare against a number, and & to require |  | ||||||
|                                      multiple matches. Values which are not |  | ||||||
|                                      known are excluded unless you put a |  | ||||||
|                                      question mark (?) after the operator.For |  | ||||||
|                                      example, to only match videos that have |  | ||||||
|                                      been liked more than 100 times and disliked |  | ||||||
|                                      less than 50 times (or the dislike |  | ||||||
|                                      functionality is not available at the given |  | ||||||
|                                      service), but who also have a description, |  | ||||||
|                                      use  --match-filter "like_count > 100 & |  | ||||||
|                                      dislike_count <? 50 & description" . |                                      dislike_count <? 50 & description" . | ||||||
|     --no-playlist                    If the URL refers to a video and a |     --no-playlist                    If the URL refers to a video and a playlist, download only the video. | ||||||
|                                      playlist, download only the video. |     --yes-playlist                   If the URL refers to a video and a playlist, download the playlist. | ||||||
|     --yes-playlist                   If the URL refers to a video and a |     --age-limit YEARS                download only videos suitable for the given age | ||||||
|                                      playlist, download the playlist. |     --download-archive FILE          Download only videos not listed in the archive file. Record the IDs of all downloaded videos in it. | ||||||
|     --age-limit YEARS                download only videos suitable for the given |     --include-ads                    Download advertisements as well (experimental) | ||||||
|                                      age |  | ||||||
|     --download-archive FILE          Download only videos not listed in the |  | ||||||
|                                      archive file. Record the IDs of all |  | ||||||
|                                      downloaded videos in it. |  | ||||||
|     --include-ads                    Download advertisements as well |  | ||||||
|                                      (experimental) |  | ||||||
|  |  | ||||||
| ## Download Options: | ## Download Options: | ||||||
|     -r, --rate-limit LIMIT           maximum download rate in bytes per second |     -r, --rate-limit LIMIT           maximum download rate in bytes per second (e.g. 50K or 4.2M) | ||||||
|                                      (e.g. 50K or 4.2M) |     -R, --retries RETRIES            number of retries (default is 10), or "infinite". | ||||||
|     -R, --retries RETRIES            number of retries (default is 10), or |     --buffer-size SIZE               size of download buffer (e.g. 1024 or 16K) (default is 1024) | ||||||
|                                      "infinite". |     --no-resize-buffer               do not automatically adjust the buffer size. By default, the buffer size is automatically resized from an initial value of SIZE. | ||||||
|     --buffer-size SIZE               size of download buffer (e.g. 1024 or 16K) |  | ||||||
|                                      (default is 1024) |  | ||||||
|     --no-resize-buffer               do not automatically adjust the buffer |  | ||||||
|                                      size. By default, the buffer size is |  | ||||||
|                                      automatically resized from an initial value |  | ||||||
|                                      of SIZE. |  | ||||||
|     --playlist-reverse               Download playlist videos in reverse order |     --playlist-reverse               Download playlist videos in reverse order | ||||||
|     --xattr-set-filesize             (experimental) set file xattribute |     --xattr-set-filesize             (experimental) set file xattribute ytdl.filesize with expected filesize | ||||||
|                                      ytdl.filesize with expected filesize |     --hls-prefer-native              (experimental) Use the native HLS downloader instead of ffmpeg. | ||||||
|     --hls-prefer-native              (experimental) Use the native HLS |     --external-downloader COMMAND    Use the specified external downloader. Currently supports aria2c,curl,wget | ||||||
|                                      downloader instead of ffmpeg. |     --external-downloader-args ARGS  Give these arguments to the external downloader. | ||||||
|     --external-downloader COMMAND    (experimental) Use the specified external |  | ||||||
|                                      downloader. Currently supports |  | ||||||
|                                      aria2c,curl,wget |  | ||||||
|  |  | ||||||
| ## Filesystem Options: | ## Filesystem Options: | ||||||
|     -a, --batch-file FILE            file containing URLs to download ('-' for |     -a, --batch-file FILE            file containing URLs to download ('-' for stdin) | ||||||
|                                      stdin) |  | ||||||
|     --id                             use only video ID in file name |     --id                             use only video ID in file name | ||||||
|     -o, --output TEMPLATE            output filename template. Use %(title)s to |     -o, --output TEMPLATE            output filename template. Use %(title)s to get the title, %(uploader)s for the uploader name, %(uploader_id)s for the uploader | ||||||
|                                      get the title, %(uploader)s for the |                                      nickname if different, %(autonumber)s to get an automatically incremented number, %(ext)s for the filename extension, %(format)s for | ||||||
|                                      uploader name, %(uploader_id)s for the |                                      the format description (like "22 - 1280x720" or "HD"), %(format_id)s for the unique id of the format (like Youtube's itags: "137"), | ||||||
|                                      uploader nickname if different, |                                      %(upload_date)s for the upload date (YYYYMMDD), %(extractor)s for the provider (youtube, metacafe, etc), %(id)s for the video id, | ||||||
|                                      %(autonumber)s to get an automatically |                                      %(playlist_title)s, %(playlist_id)s, or %(playlist)s (=title if present, ID otherwise) for the playlist the video is in, | ||||||
|                                      incremented number, %(ext)s for the |                                      %(playlist_index)s for the position in the playlist. %(height)s and %(width)s for the width and height of the video format. | ||||||
|                                      filename extension, %(format)s for the |                                      %(resolution)s for a textual description of the resolution of the video format. %% for a literal percent. Use - to output to stdout. | ||||||
|                                      format description (like "22 - 1280x720" or |                                      Can also be used to download to a different directory, for example with -o '/my/downloads/%(uploader)s/%(title)s-%(id)s.%(ext)s' . | ||||||
|                                      "HD"), %(format_id)s for the unique id of |     --autonumber-size NUMBER         Specifies the number of digits in %(autonumber)s when it is present in output filename template or --auto-number option is given | ||||||
|                                      the format (like Youtube's itags: "137"), |     --restrict-filenames             Restrict filenames to only ASCII characters, and avoid "&" and spaces in filenames | ||||||
|                                      %(upload_date)s for the upload date |     -A, --auto-number                [deprecated; use  -o "%(autonumber)s-%(title)s.%(ext)s" ] number downloaded files starting from 00000 | ||||||
|                                      (YYYYMMDD), %(extractor)s for the provider |     -t, --title                      [deprecated] use title in file name (default) | ||||||
|                                      (youtube, metacafe, etc), %(id)s for the |  | ||||||
|                                      video id, %(playlist_title)s, |  | ||||||
|                                      %(playlist_id)s, or %(playlist)s (=title if |  | ||||||
|                                      present, ID otherwise) for the playlist the |  | ||||||
|                                      video is in, %(playlist_index)s for the |  | ||||||
|                                      position in the playlist. %(height)s and |  | ||||||
|                                      %(width)s for the width and height of the |  | ||||||
|                                      video format. %(resolution)s for a textual |  | ||||||
|                                      description of the resolution of the video |  | ||||||
|                                      format. %% for a literal percent. Use - to |  | ||||||
|                                      output to stdout. Can also be used to |  | ||||||
|                                      download to a different directory, for |  | ||||||
|                                      example with -o '/my/downloads/%(uploader)s |  | ||||||
|                                      /%(title)s-%(id)s.%(ext)s' . |  | ||||||
|     --autonumber-size NUMBER         Specifies the number of digits in |  | ||||||
|                                      %(autonumber)s when it is present in output |  | ||||||
|                                      filename template or --auto-number option |  | ||||||
|                                      is given |  | ||||||
|     --restrict-filenames             Restrict filenames to only ASCII |  | ||||||
|                                      characters, and avoid "&" and spaces in |  | ||||||
|                                      filenames |  | ||||||
|     -A, --auto-number                [deprecated; use  -o |  | ||||||
|                                      "%(autonumber)s-%(title)s.%(ext)s" ] number |  | ||||||
|                                      downloaded files starting from 00000 |  | ||||||
|     -t, --title                      [deprecated] use title in file name |  | ||||||
|                                      (default) |  | ||||||
|     -l, --literal                    [deprecated] alias of --title |     -l, --literal                    [deprecated] alias of --title | ||||||
|     -w, --no-overwrites              do not overwrite files |     -w, --no-overwrites              do not overwrite files | ||||||
|     -c, --continue                   force resume of partially downloaded files. |     -c, --continue                   force resume of partially downloaded files. By default, youtube-dl will resume downloads if possible. | ||||||
|                                      By default, youtube-dl will resume |     --no-continue                    do not resume partially downloaded files (restart from beginning) | ||||||
|                                      downloads if possible. |     --no-part                        do not use .part files - write directly into output file | ||||||
|     --no-continue                    do not resume partially downloaded files |     --no-mtime                       do not use the Last-modified header to set the file modification time | ||||||
|                                      (restart from beginning) |     --write-description              write video description to a .description file | ||||||
|     --no-part                        do not use .part files - write directly |  | ||||||
|                                      into output file |  | ||||||
|     --no-mtime                       do not use the Last-modified header to set |  | ||||||
|                                      the file modification time |  | ||||||
|     --write-description              write video description to a .description |  | ||||||
|                                      file |  | ||||||
|     --write-info-json                write video metadata to a .info.json file |     --write-info-json                write video metadata to a .info.json file | ||||||
|     --write-annotations              write video annotations to a .annotation |     --write-annotations              write video annotations to a .annotation file | ||||||
|                                      file |     --load-info FILE                 json file containing the video information (created with the "--write-json" option) | ||||||
|     --load-info FILE                 json file containing the video information |     --cookies FILE                   file to read cookies from and dump cookie jar in | ||||||
|                                      (created with the "--write-json" option) |     --cache-dir DIR                  Location in the filesystem where youtube-dl can store some downloaded information permanently. By default $XDG_CACHE_HOME/youtube-dl | ||||||
|     --cookies FILE                   file to read cookies from and dump cookie |                                      or ~/.cache/youtube-dl . At the moment, only YouTube player files (for videos with obfuscated signatures) are cached, but that may | ||||||
|                                      jar in |                                      change. | ||||||
|     --cache-dir DIR                  Location in the filesystem where youtube-dl |  | ||||||
|                                      can store some downloaded information |  | ||||||
|                                      permanently. By default $XDG_CACHE_HOME |  | ||||||
|                                      /youtube-dl or ~/.cache/youtube-dl . At the |  | ||||||
|                                      moment, only YouTube player files (for |  | ||||||
|                                      videos with obfuscated signatures) are |  | ||||||
|                                      cached, but that may change. |  | ||||||
|     --no-cache-dir                   Disable filesystem caching |     --no-cache-dir                   Disable filesystem caching | ||||||
|     --rm-cache-dir                   Delete all filesystem cache files |     --rm-cache-dir                   Delete all filesystem cache files | ||||||
|  |  | ||||||
| ## Thumbnail images: | ## Thumbnail images: | ||||||
|     --write-thumbnail                write thumbnail image to disk |     --write-thumbnail                write thumbnail image to disk | ||||||
|     --write-all-thumbnails           write all thumbnail image formats to disk |     --write-all-thumbnails           write all thumbnail image formats to disk | ||||||
|     --list-thumbnails                Simulate and list all available thumbnail |     --list-thumbnails                Simulate and list all available thumbnail formats | ||||||
|                                      formats |  | ||||||
|  |  | ||||||
| ## Verbosity / Simulation Options: | ## Verbosity / Simulation Options: | ||||||
|     -q, --quiet                      activates quiet mode |     -q, --quiet                      activates quiet mode | ||||||
|     --no-warnings                    Ignore warnings |     --no-warnings                    Ignore warnings | ||||||
|     -s, --simulate                   do not download the video and do not write |     -s, --simulate                   do not download the video and do not write anything to disk | ||||||
|                                      anything to disk |  | ||||||
|     --skip-download                  do not download the video |     --skip-download                  do not download the video | ||||||
|     -g, --get-url                    simulate, quiet but print URL |     -g, --get-url                    simulate, quiet but print URL | ||||||
|     -e, --get-title                  simulate, quiet but print title |     -e, --get-title                  simulate, quiet but print title | ||||||
| @@ -261,155 +157,84 @@ which means you can modify it, redistribute it or use it however you like. | |||||||
|     --get-duration                   simulate, quiet but print video length |     --get-duration                   simulate, quiet but print video length | ||||||
|     --get-filename                   simulate, quiet but print output filename |     --get-filename                   simulate, quiet but print output filename | ||||||
|     --get-format                     simulate, quiet but print output format |     --get-format                     simulate, quiet but print output format | ||||||
|     -j, --dump-json                  simulate, quiet but print JSON information. |     -j, --dump-json                  simulate, quiet but print JSON information. See --output for a description of available keys. | ||||||
|                                      See --output for a description of available |     -J, --dump-single-json           simulate, quiet but print JSON information for each command-line argument. If the URL refers to a playlist, dump the whole playlist | ||||||
|                                      keys. |                                      information in a single line. | ||||||
|     -J, --dump-single-json           simulate, quiet but print JSON information |     --print-json                     Be quiet and print the video information as JSON (video is still being downloaded). | ||||||
|                                      for each command-line argument. If the URL |  | ||||||
|                                      refers to a playlist, dump the whole |  | ||||||
|                                      playlist information in a single line. |  | ||||||
|     --print-json                     Be quiet and print the video information as |  | ||||||
|                                      JSON (video is still being downloaded). |  | ||||||
|     --newline                        output progress bar as new lines |     --newline                        output progress bar as new lines | ||||||
|     --no-progress                    do not print progress bar |     --no-progress                    do not print progress bar | ||||||
|     --console-title                  display progress in console titlebar |     --console-title                  display progress in console titlebar | ||||||
|     -v, --verbose                    print various debugging information |     -v, --verbose                    print various debugging information | ||||||
|     --dump-intermediate-pages        print downloaded pages to debug problems |     --dump-intermediate-pages        print downloaded pages to debug problems (very verbose) | ||||||
|                                      (very verbose) |     --write-pages                    Write downloaded intermediary pages to files in the current directory to debug problems | ||||||
|     --write-pages                    Write downloaded intermediary pages to |  | ||||||
|                                      files in the current directory to debug |  | ||||||
|                                      problems |  | ||||||
|     --print-traffic                  Display sent and read HTTP traffic |     --print-traffic                  Display sent and read HTTP traffic | ||||||
|     -C, --call-home                  Contact the youtube-dl server for |     -C, --call-home                  Contact the youtube-dl server for debugging. | ||||||
|                                      debugging. |     --no-call-home                   Do NOT contact the youtube-dl server for debugging. | ||||||
|     --no-call-home                   Do NOT contact the youtube-dl server for |  | ||||||
|                                      debugging. |  | ||||||
|  |  | ||||||
| ## Workarounds: | ## Workarounds: | ||||||
|     --encoding ENCODING              Force the specified encoding (experimental) |     --encoding ENCODING              Force the specified encoding (experimental) | ||||||
|     --no-check-certificate           Suppress HTTPS certificate validation. |     --no-check-certificate           Suppress HTTPS certificate validation. | ||||||
|     --prefer-insecure                Use an unencrypted connection to retrieve |     --prefer-insecure                Use an unencrypted connection to retrieve information about the video. (Currently supported only for YouTube) | ||||||
|                                      information about the video. (Currently |  | ||||||
|                                      supported only for YouTube) |  | ||||||
|     --user-agent UA                  specify a custom user agent |     --user-agent UA                  specify a custom user agent | ||||||
|     --referer URL                    specify a custom referer, use if the video |     --referer URL                    specify a custom referer, use if the video access is restricted to one domain | ||||||
|                                      access is restricted to one domain |     --add-header FIELD:VALUE         specify a custom HTTP header and its value, separated by a colon ':'. You can use this option multiple times | ||||||
|     --add-header FIELD:VALUE         specify a custom HTTP header and its value, |     --bidi-workaround                Work around terminals that lack bidirectional text support. Requires bidiv or fribidi executable in PATH | ||||||
|                                      separated by a colon ':'. You can use this |     --sleep-interval SECONDS         Number of seconds to sleep before each download. | ||||||
|                                      option multiple times |  | ||||||
|     --bidi-workaround                Work around terminals that lack |  | ||||||
|                                      bidirectional text support. Requires bidiv |  | ||||||
|                                      or fribidi executable in PATH |  | ||||||
|     --sleep-interval SECONDS         Number of seconds to sleep before each |  | ||||||
|                                      download. |  | ||||||
|  |  | ||||||
| ## Video Format Options: | ## Video Format Options: | ||||||
|     -f, --format FORMAT              video format code, specify the order of |     -f, --format FORMAT              video format code, specify the order of preference using slashes, as in -f 22/17/18 .  Instead of format codes, you can select by | ||||||
|                                      preference using slashes, as in -f 22/17/18 |                                      extension for the extensions aac, m4a, mp3, mp4, ogg, wav, webm. You can also use the special names "best", "bestvideo", "bestaudio", | ||||||
|                                      .  Instead of format codes, you can select |                                      "worst".  You can filter the video results by putting a condition in brackets, as in -f "best[height=720]" (or -f "[filesize>10M]"). | ||||||
|                                      by extension for the extensions aac, m4a, |                                      This works for filesize, height, width, tbr, abr, vbr, asr, and fps and the comparisons <, <=, >, >=, =, != and for ext, acodec, | ||||||
|                                      mp3, mp4, ogg, wav, webm. You can also use |                                      vcodec, container, and protocol and the comparisons =, != . Formats for which the value is not known are excluded unless you put a | ||||||
|                                      the special names "best", "bestvideo", |                                      question mark (?) after the operator. You can combine format filters, so  -f "[height <=? 720][tbr>500]" selects up to 720p videos | ||||||
|                                      "bestaudio", "worst".  You can filter the |                                      (or videos where the height is not known) with a bitrate of at least 500 KBit/s. By default, youtube-dl will pick the best quality. | ||||||
|                                      video results by putting a condition in |                                      Use commas to download multiple audio formats, such as -f  136/137/mp4/bestvideo,140/m4a/bestaudio. You can merge the video and audio | ||||||
|                                      brackets, as in -f "best[height=720]" (or |                                      of two formats into a single file using -f <video-format>+<audio-format> (requires ffmpeg or avconv), for example -f | ||||||
|                                      -f "[filesize>10M]").  This works for |  | ||||||
|                                      filesize, height, width, tbr, abr, vbr, |  | ||||||
|                                      asr, and fps and the comparisons <, <=, >, |  | ||||||
|                                      >=, =, != and for ext, acodec, vcodec, |  | ||||||
|                                      container, and protocol and the comparisons |  | ||||||
|                                      =, != . Formats for which the value is not |  | ||||||
|                                      known are excluded unless you put a |  | ||||||
|                                      question mark (?) after the operator. You |  | ||||||
|                                      can combine format filters, so  -f "[height |  | ||||||
|                                      <=? 720][tbr>500]" selects up to 720p |  | ||||||
|                                      videos (or videos where the height is not |  | ||||||
|                                      known) with a bitrate of at least 500 |  | ||||||
|                                      KBit/s. By default, youtube-dl will pick |  | ||||||
|                                      the best quality. Use commas to download |  | ||||||
|                                      multiple audio formats, such as -f |  | ||||||
|                                      136/137/mp4/bestvideo,140/m4a/bestaudio. |  | ||||||
|                                      You can merge the video and audio of two |  | ||||||
|                                      formats into a single file using -f <video- |  | ||||||
|                                      format>+<audio-format> (requires ffmpeg or |  | ||||||
|                                      avconv), for example -f |  | ||||||
|                                      bestvideo+bestaudio. |                                      bestvideo+bestaudio. | ||||||
|     --all-formats                    download all available video formats |     --all-formats                    download all available video formats | ||||||
|     --prefer-free-formats            prefer free video formats unless a specific |     --prefer-free-formats            prefer free video formats unless a specific one is requested | ||||||
|                                      one is requested |  | ||||||
|     --max-quality FORMAT             highest quality format to download |     --max-quality FORMAT             highest quality format to download | ||||||
|     -F, --list-formats               list all available formats |     -F, --list-formats               list all available formats | ||||||
|     --youtube-skip-dash-manifest     Do not download the DASH manifest on |     --youtube-skip-dash-manifest     Do not download the DASH manifest on YouTube videos | ||||||
|                                      YouTube videos |     --merge-output-format FORMAT     If a merge is required (e.g. bestvideo+bestaudio), output to given container format. One of mkv, mp4, ogg, webm, flv.Ignored if no | ||||||
|     --merge-output-format FORMAT     If a merge is required (e.g. |                                      merge is required | ||||||
|                                      bestvideo+bestaudio), output to given |  | ||||||
|                                      container format. One of mkv, mp4, ogg, |  | ||||||
|                                      webm, flv.Ignored if no merge is required |  | ||||||
|  |  | ||||||
| ## Subtitle Options: | ## Subtitle Options: | ||||||
|     --write-sub                      write subtitle file |     --write-sub                      write subtitle file | ||||||
|     --write-auto-sub                 write automatic subtitle file (youtube |     --write-auto-sub                 write automatic subtitle file (youtube only) | ||||||
|                                      only) |     --all-subs                       downloads all the available subtitles of the video | ||||||
|     --all-subs                       downloads all the available subtitles of |  | ||||||
|                                      the video |  | ||||||
|     --list-subs                      lists all available subtitles for the video |     --list-subs                      lists all available subtitles for the video | ||||||
|     --sub-format FORMAT              subtitle format, accepts formats |     --sub-format FORMAT              subtitle format, accepts formats preference, for example: "ass/srt/best" | ||||||
|                                      preference, for example: "ass/srt/best" |     --sub-lang LANGS                 languages of the subtitles to download (optional) separated by commas, use IETF language tags like 'en,pt' | ||||||
|     --sub-lang LANGS                 languages of the subtitles to download |  | ||||||
|                                      (optional) separated by commas, use IETF |  | ||||||
|                                      language tags like 'en,pt' |  | ||||||
|  |  | ||||||
| ## Authentication Options: | ## Authentication Options: | ||||||
|     -u, --username USERNAME          login with this account ID |     -u, --username USERNAME          login with this account ID | ||||||
|     -p, --password PASSWORD          account password. If this option is left |     -p, --password PASSWORD          account password. If this option is left out, youtube-dl will ask interactively. | ||||||
|                                      out, youtube-dl will ask interactively. |  | ||||||
|     -2, --twofactor TWOFACTOR        two-factor auth code |     -2, --twofactor TWOFACTOR        two-factor auth code | ||||||
|     -n, --netrc                      use .netrc authentication data |     -n, --netrc                      use .netrc authentication data | ||||||
|     --video-password PASSWORD        video password (vimeo, smotri) |     --video-password PASSWORD        video password (vimeo, smotri) | ||||||
|  |  | ||||||
| ## Post-processing Options: | ## Post-processing Options: | ||||||
|     -x, --extract-audio              convert video files to audio-only files |     -x, --extract-audio              convert video files to audio-only files (requires ffmpeg or avconv and ffprobe or avprobe) | ||||||
|                                      (requires ffmpeg or avconv and ffprobe or |     --audio-format FORMAT            "best", "aac", "vorbis", "mp3", "m4a", "opus", or "wav"; "best" by default | ||||||
|                                      avprobe) |     --audio-quality QUALITY          ffmpeg/avconv audio quality specification, insert a value between 0 (better) and 9 (worse) for VBR or a specific bitrate like 128K | ||||||
|     --audio-format FORMAT            "best", "aac", "vorbis", "mp3", "m4a", |                                      (default 5) | ||||||
|                                      "opus", or "wav"; "best" by default |     --recode-video FORMAT            Encode the video to another format if necessary (currently supported: mp4|flv|ogg|webm|mkv) | ||||||
|     --audio-quality QUALITY          ffmpeg/avconv audio quality specification, |     -k, --keep-video                 keeps the video file on disk after the post-processing; the video is erased by default | ||||||
|                                      insert a value between 0 (better) and 9 |     --no-post-overwrites             do not overwrite post-processed files; the post-processed files are overwritten by default | ||||||
|                                      (worse) for VBR or a specific bitrate like |     --embed-subs                     embed subtitles in the video (only for mp4 videos) | ||||||
|                                      128K (default 5) |  | ||||||
|     --recode-video FORMAT            Encode the video to another format if |  | ||||||
|                                      necessary (currently supported: |  | ||||||
|                                      mp4|flv|ogg|webm|mkv) |  | ||||||
|     -k, --keep-video                 keeps the video file on disk after the |  | ||||||
|                                      post-processing; the video is erased by |  | ||||||
|                                      default |  | ||||||
|     --no-post-overwrites             do not overwrite post-processed files; the |  | ||||||
|                                      post-processed files are overwritten by |  | ||||||
|                                      default |  | ||||||
|     --embed-subs                     embed subtitles in the video (only for mp4 |  | ||||||
|                                      videos) |  | ||||||
|     --embed-thumbnail                embed thumbnail in the audio as cover art |     --embed-thumbnail                embed thumbnail in the audio as cover art | ||||||
|     --add-metadata                   write metadata to the video file |     --add-metadata                   write metadata to the video file | ||||||
|     --xattrs                         write metadata to the video file's xattrs |     --xattrs                         write metadata to the video file's xattrs (using dublin core and xdg standards) | ||||||
|                                      (using dublin core and xdg standards) |     --fixup POLICY                   Automatically correct known faults of the file. One of never (do nothing), warn (only emit a warning), detect_or_warn(the default; | ||||||
|     --fixup POLICY                   Automatically correct known faults of the |                                      fix file if we can, warn otherwise) | ||||||
|                                      file. One of never (do nothing), warn (only |     --prefer-avconv                  Prefer avconv over ffmpeg for running the postprocessors (default) | ||||||
|                                      emit a warning), detect_or_warn(the |     --prefer-ffmpeg                  Prefer ffmpeg over avconv for running the postprocessors | ||||||
|                                      default; fix file if we can, warn |     --ffmpeg-location PATH           Location of the ffmpeg/avconv binary; either the path to the binary or its containing directory. | ||||||
|                                      otherwise) |     --exec CMD                       Execute a command on the file after downloading, similar to find's -exec syntax. Example: --exec 'adb push {} /sdcard/Music/ && rm | ||||||
|     --prefer-avconv                  Prefer avconv over ffmpeg for running the |                                      {}' | ||||||
|                                      postprocessors (default) |     --convert-subtitles FORMAT       Convert the subtitles to other format (currently supported: srt|ass|vtt) | ||||||
|     --prefer-ffmpeg                  Prefer ffmpeg over avconv for running the |  | ||||||
|                                      postprocessors |  | ||||||
|     --ffmpeg-location PATH           Location of the ffmpeg/avconv binary; |  | ||||||
|                                      either the path to the binary or its |  | ||||||
|                                      containing directory. |  | ||||||
|     --exec CMD                       Execute a command on the file after |  | ||||||
|                                      downloading, similar to find's -exec |  | ||||||
|                                      syntax. Example: --exec 'adb push {} |  | ||||||
|                                      /sdcard/Music/ && rm {}' |  | ||||||
|     --convert-subtitles FORMAT       Convert the subtitles to other format |  | ||||||
|                                      (currently supported: srt|ass|vtt) |  | ||||||
|  |  | ||||||
| # CONFIGURATION | # CONFIGURATION | ||||||
|  |  | ||||||
|   | |||||||
| @@ -1,3 +1,3 @@ | |||||||
| from __future__ import unicode_literals | from __future__ import unicode_literals | ||||||
|  |  | ||||||
| __version__ = '2015.02.28' | __version__ = '2015.03.03' | ||||||
|   | |||||||
		Reference in New Issue
	
	Block a user