|
|
@ -38,12 +38,6 @@ which means you can modify it, redistribute it or use it however you like. |
|
|
|
playlist or the command line) if an error |
|
|
|
occurs |
|
|
|
--dump-user-agent display the current browser identification |
|
|
|
--user-agent UA specify a custom user agent |
|
|
|
--referer REF specify a custom referer, use if the video |
|
|
|
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 |
|
|
|
--list-extractors List all supported extractors and the URLs |
|
|
|
they would handle |
|
|
|
--extractor-descriptions Output descriptions of all supported |
|
|
@ -51,18 +45,6 @@ which means you can modify it, redistribute it or use it however you like. |
|
|
|
--proxy URL Use the specified HTTP/HTTPS proxy. Pass in |
|
|
|
an empty string (--proxy "") for direct |
|
|
|
connection |
|
|
|
--no-check-certificate Suppress HTTPS certificate validation. |
|
|
|
--prefer-insecure Use an unencrypted connection to retrieve |
|
|
|
information about the video. (Currently |
|
|
|
supported only for YouTube) |
|
|
|
--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 |
|
|
|
--socket-timeout None Time to wait before giving up, in seconds |
|
|
|
--bidi-workaround Work around terminals that lack |
|
|
|
bidirectional text support. Requires bidiv |
|
|
@ -79,7 +61,6 @@ which means you can modify it, redistribute it or use it however you like. |
|
|
|
configuration in ~/.config/youtube-dl.conf |
|
|
|
(%APPDATA%/youtube-dl/config.txt on |
|
|
|
Windows) |
|
|
|
--encoding ENCODING Force the specified encoding (experimental) |
|
|
|
|
|
|
|
## Video Selection: |
|
|
|
--playlist-start NUMBER playlist video to start at (default is 1) |
|
|
@ -125,9 +106,9 @@ which means you can modify it, redistribute it or use it however you like. |
|
|
|
of SIZE. |
|
|
|
|
|
|
|
## Filesystem Options: |
|
|
|
-t, --title use title in file name (default) |
|
|
|
-a, --batch-file FILE file containing URLs to download ('-' for |
|
|
|
stdin) |
|
|
|
--id use only video ID in file name |
|
|
|
-l, --literal [deprecated] alias of --title |
|
|
|
-A, --auto-number number downloaded files starting from 00000 |
|
|
|
-o, --output TEMPLATE output filename template. Use %(title)s to |
|
|
|
get the title, %(uploader)s for the |
|
|
@ -160,18 +141,15 @@ which means you can modify it, redistribute it or use it however you like. |
|
|
|
--restrict-filenames Restrict filenames to only ASCII |
|
|
|
characters, and avoid "&" and spaces in |
|
|
|
filenames |
|
|
|
-a, --batch-file FILE file containing URLs to download ('-' for |
|
|
|
stdin) |
|
|
|
--load-info FILE json file containing the video information |
|
|
|
(created with the "--write-json" option) |
|
|
|
-t, --title [deprecated] use title in file name |
|
|
|
(default) |
|
|
|
-l, --literal [deprecated] alias of --title |
|
|
|
-w, --no-overwrites do not overwrite files |
|
|
|
-c, --continue force resume of partially downloaded files. |
|
|
|
By default, youtube-dl will resume |
|
|
|
downloads if possible. |
|
|
|
--no-continue do not resume partially downloaded files |
|
|
|
(restart from beginning) |
|
|
|
--cookies FILE file to read cookies from and dump cookie |
|
|
|
jar in |
|
|
|
--no-part do not use .part files |
|
|
|
--no-mtime do not use the Last-modified header to set |
|
|
|
the file modification time |
|
|
@ -181,6 +159,19 @@ which means you can modify it, redistribute it or use it however you like. |
|
|
|
--write-annotations write video annotations to a .annotation |
|
|
|
file |
|
|
|
--write-thumbnail write thumbnail image to disk |
|
|
|
--load-info FILE json file containing the video information |
|
|
|
(created with the "--write-json" option) |
|
|
|
--cookies FILE file to read cookies from and dump cookie |
|
|
|
jar in |
|
|
|
--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 |
|
|
|
--rm-cache-dir Delete all filesystem cache files |
|
|
|
|
|
|
|
## Verbosity / Simulation Options: |
|
|
|
-q, --quiet activates quiet mode |
|
|
@ -210,6 +201,19 @@ which means you can modify it, redistribute it or use it however you like. |
|
|
|
problems |
|
|
|
--print-traffic Display sent and read HTTP traffic |
|
|
|
|
|
|
|
## Workarounds: |
|
|
|
--encoding ENCODING Force the specified encoding (experimental) |
|
|
|
--no-check-certificate Suppress HTTPS certificate validation. |
|
|
|
--prefer-insecure Use an unencrypted connection to retrieve |
|
|
|
information about the video. (Currently |
|
|
|
supported only for YouTube) |
|
|
|
--user-agent UA specify a custom user agent |
|
|
|
--referer REF specify a custom referer, use if the video |
|
|
|
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 |
|
|
|
|
|
|
|
## Video Format Options: |
|
|
|
-f, --format FORMAT video format code, specify the order of |
|
|
|
preference using slashes: "-f 22/17/18". |
|
|
|