Compare commits

..

No commits in common. "811a183eb6a7dabcc8600f6bf9dc4aac11e72b26" and "f08c31cf33beb0687c4df58b83e319ec8dfe03ad" have entirely different histories.

9 changed files with 379 additions and 445 deletions

View File

@ -18,7 +18,7 @@ title: ''
<!-- <!--
Carefully read and work through this check list in order to prevent the most common mistakes and misuse of youtube-dl: Carefully read and work through this check list in order to prevent the most common mistakes and misuse of youtube-dl:
- First of, make sure you are using the latest version of youtube-dl. Run `youtube-dl --version` and ensure your version is 2021.01.24.1. If it's not, see https://yt-dl.org/update on how to update. Issues with outdated version will be REJECTED. - First of, make sure you are using the latest version of youtube-dl. Run `youtube-dl --version` and ensure your version is 2021.01.16. If it's not, see https://yt-dl.org/update on how to update. Issues with outdated version will be REJECTED.
- Make sure that all provided video/audio/playlist URLs (if any) are alive and playable in a browser. - Make sure that all provided video/audio/playlist URLs (if any) are alive and playable in a browser.
- Make sure that all URLs and arguments with special characters are properly quoted or escaped as explained in http://yt-dl.org/escape. - Make sure that all URLs and arguments with special characters are properly quoted or escaped as explained in http://yt-dl.org/escape.
- Search the bugtracker for similar issues: http://yt-dl.org/search-issues. DO NOT post duplicates. - Search the bugtracker for similar issues: http://yt-dl.org/search-issues. DO NOT post duplicates.
@ -26,7 +26,7 @@ Carefully read and work through this check list in order to prevent the most com
--> -->
- [ ] I'm reporting a broken site support - [ ] I'm reporting a broken site support
- [ ] I've verified that I'm running youtube-dl version **2021.01.24.1** - [ ] I've verified that I'm running youtube-dl version **2021.01.16**
- [ ] I've checked that all provided URLs are alive and playable in a browser - [ ] I've checked that all provided URLs are alive and playable in a browser
- [ ] I've checked that all URLs and arguments with special characters are properly quoted or escaped - [ ] I've checked that all URLs and arguments with special characters are properly quoted or escaped
- [ ] I've searched the bugtracker for similar issues including closed ones - [ ] I've searched the bugtracker for similar issues including closed ones
@ -41,7 +41,7 @@ Add the `-v` flag to your command line you run youtube-dl with (`youtube-dl -v <
[debug] User config: [] [debug] User config: []
[debug] Command-line args: [u'-v', u'http://www.youtube.com/watch?v=BaW_jenozKcj'] [debug] Command-line args: [u'-v', u'http://www.youtube.com/watch?v=BaW_jenozKcj']
[debug] Encodings: locale cp1251, fs mbcs, out cp866, pref cp1251 [debug] Encodings: locale cp1251, fs mbcs, out cp866, pref cp1251
[debug] youtube-dl version 2021.01.24.1 [debug] youtube-dl version 2021.01.16
[debug] Python version 2.7.11 - Windows-2003Server-5.2.3790-SP2 [debug] Python version 2.7.11 - Windows-2003Server-5.2.3790-SP2
[debug] exe versions: ffmpeg N-75573-g1d0487f, ffprobe N-75573-g1d0487f, rtmpdump 2.4 [debug] exe versions: ffmpeg N-75573-g1d0487f, ffprobe N-75573-g1d0487f, rtmpdump 2.4
[debug] Proxy map: {} [debug] Proxy map: {}

View File

@ -19,7 +19,7 @@ labels: 'site-support-request'
<!-- <!--
Carefully read and work through this check list in order to prevent the most common mistakes and misuse of youtube-dl: Carefully read and work through this check list in order to prevent the most common mistakes and misuse of youtube-dl:
- First of, make sure you are using the latest version of youtube-dl. Run `youtube-dl --version` and ensure your version is 2021.01.24.1. If it's not, see https://yt-dl.org/update on how to update. Issues with outdated version will be REJECTED. - First of, make sure you are using the latest version of youtube-dl. Run `youtube-dl --version` and ensure your version is 2021.01.16. If it's not, see https://yt-dl.org/update on how to update. Issues with outdated version will be REJECTED.
- Make sure that all provided video/audio/playlist URLs (if any) are alive and playable in a browser. - Make sure that all provided video/audio/playlist URLs (if any) are alive and playable in a browser.
- Make sure that site you are requesting is not dedicated to copyright infringement, see https://yt-dl.org/copyright-infringement. youtube-dl does not support such sites. In order for site support request to be accepted all provided example URLs should not violate any copyrights. - Make sure that site you are requesting is not dedicated to copyright infringement, see https://yt-dl.org/copyright-infringement. youtube-dl does not support such sites. In order for site support request to be accepted all provided example URLs should not violate any copyrights.
- Search the bugtracker for similar site support requests: http://yt-dl.org/search-issues. DO NOT post duplicates. - Search the bugtracker for similar site support requests: http://yt-dl.org/search-issues. DO NOT post duplicates.
@ -27,7 +27,7 @@ Carefully read and work through this check list in order to prevent the most com
--> -->
- [ ] I'm reporting a new site support request - [ ] I'm reporting a new site support request
- [ ] I've verified that I'm running youtube-dl version **2021.01.24.1** - [ ] I've verified that I'm running youtube-dl version **2021.01.16**
- [ ] I've checked that all provided URLs are alive and playable in a browser - [ ] I've checked that all provided URLs are alive and playable in a browser
- [ ] I've checked that none of provided URLs violate any copyrights - [ ] I've checked that none of provided URLs violate any copyrights
- [ ] I've searched the bugtracker for similar site support requests including closed ones - [ ] I've searched the bugtracker for similar site support requests including closed ones

View File

@ -18,13 +18,13 @@ title: ''
<!-- <!--
Carefully read and work through this check list in order to prevent the most common mistakes and misuse of youtube-dl: Carefully read and work through this check list in order to prevent the most common mistakes and misuse of youtube-dl:
- First of, make sure you are using the latest version of youtube-dl. Run `youtube-dl --version` and ensure your version is 2021.01.24.1. If it's not, see https://yt-dl.org/update on how to update. Issues with outdated version will be REJECTED. - First of, make sure you are using the latest version of youtube-dl. Run `youtube-dl --version` and ensure your version is 2021.01.16. If it's not, see https://yt-dl.org/update on how to update. Issues with outdated version will be REJECTED.
- Search the bugtracker for similar site feature requests: http://yt-dl.org/search-issues. DO NOT post duplicates. - Search the bugtracker for similar site feature requests: http://yt-dl.org/search-issues. DO NOT post duplicates.
- Finally, put x into all relevant boxes (like this [x]) - Finally, put x into all relevant boxes (like this [x])
--> -->
- [ ] I'm reporting a site feature request - [ ] I'm reporting a site feature request
- [ ] I've verified that I'm running youtube-dl version **2021.01.24.1** - [ ] I've verified that I'm running youtube-dl version **2021.01.16**
- [ ] I've searched the bugtracker for similar site feature requests including closed ones - [ ] I've searched the bugtracker for similar site feature requests including closed ones

View File

@ -18,7 +18,7 @@ title: ''
<!-- <!--
Carefully read and work through this check list in order to prevent the most common mistakes and misuse of youtube-dl: Carefully read and work through this check list in order to prevent the most common mistakes and misuse of youtube-dl:
- First of, make sure you are using the latest version of youtube-dl. Run `youtube-dl --version` and ensure your version is 2021.01.24.1. If it's not, see https://yt-dl.org/update on how to update. Issues with outdated version will be REJECTED. - First of, make sure you are using the latest version of youtube-dl. Run `youtube-dl --version` and ensure your version is 2021.01.16. If it's not, see https://yt-dl.org/update on how to update. Issues with outdated version will be REJECTED.
- Make sure that all provided video/audio/playlist URLs (if any) are alive and playable in a browser. - Make sure that all provided video/audio/playlist URLs (if any) are alive and playable in a browser.
- Make sure that all URLs and arguments with special characters are properly quoted or escaped as explained in http://yt-dl.org/escape. - Make sure that all URLs and arguments with special characters are properly quoted or escaped as explained in http://yt-dl.org/escape.
- Search the bugtracker for similar issues: http://yt-dl.org/search-issues. DO NOT post duplicates. - Search the bugtracker for similar issues: http://yt-dl.org/search-issues. DO NOT post duplicates.
@ -27,7 +27,7 @@ Carefully read and work through this check list in order to prevent the most com
--> -->
- [ ] I'm reporting a broken site support issue - [ ] I'm reporting a broken site support issue
- [ ] I've verified that I'm running youtube-dl version **2021.01.24.1** - [ ] I've verified that I'm running youtube-dl version **2021.01.16**
- [ ] I've checked that all provided URLs are alive and playable in a browser - [ ] I've checked that all provided URLs are alive and playable in a browser
- [ ] I've checked that all URLs and arguments with special characters are properly quoted or escaped - [ ] I've checked that all URLs and arguments with special characters are properly quoted or escaped
- [ ] I've searched the bugtracker for similar bug reports including closed ones - [ ] I've searched the bugtracker for similar bug reports including closed ones
@ -43,7 +43,7 @@ Add the `-v` flag to your command line you run youtube-dl with (`youtube-dl -v <
[debug] User config: [] [debug] User config: []
[debug] Command-line args: [u'-v', u'http://www.youtube.com/watch?v=BaW_jenozKcj'] [debug] Command-line args: [u'-v', u'http://www.youtube.com/watch?v=BaW_jenozKcj']
[debug] Encodings: locale cp1251, fs mbcs, out cp866, pref cp1251 [debug] Encodings: locale cp1251, fs mbcs, out cp866, pref cp1251
[debug] youtube-dl version 2021.01.24.1 [debug] youtube-dl version 2021.01.16
[debug] Python version 2.7.11 - Windows-2003Server-5.2.3790-SP2 [debug] Python version 2.7.11 - Windows-2003Server-5.2.3790-SP2
[debug] exe versions: ffmpeg N-75573-g1d0487f, ffprobe N-75573-g1d0487f, rtmpdump 2.4 [debug] exe versions: ffmpeg N-75573-g1d0487f, ffprobe N-75573-g1d0487f, rtmpdump 2.4
[debug] Proxy map: {} [debug] Proxy map: {}

View File

@ -19,13 +19,13 @@ labels: 'request'
<!-- <!--
Carefully read and work through this check list in order to prevent the most common mistakes and misuse of youtube-dl: Carefully read and work through this check list in order to prevent the most common mistakes and misuse of youtube-dl:
- First of, make sure you are using the latest version of youtube-dl. Run `youtube-dl --version` and ensure your version is 2021.01.24.1. If it's not, see https://yt-dl.org/update on how to update. Issues with outdated version will be REJECTED. - First of, make sure you are using the latest version of youtube-dl. Run `youtube-dl --version` and ensure your version is 2021.01.16. If it's not, see https://yt-dl.org/update on how to update. Issues with outdated version will be REJECTED.
- Search the bugtracker for similar feature requests: http://yt-dl.org/search-issues. DO NOT post duplicates. - Search the bugtracker for similar feature requests: http://yt-dl.org/search-issues. DO NOT post duplicates.
- Finally, put x into all relevant boxes (like this [x]) - Finally, put x into all relevant boxes (like this [x])
--> -->
- [ ] I'm reporting a feature request - [ ] I'm reporting a feature request
- [ ] I've verified that I'm running youtube-dl version **2021.01.24.1** - [ ] I've verified that I'm running youtube-dl version **2021.01.16**
- [ ] I've searched the bugtracker for similar feature requests including closed ones - [ ] I've searched the bugtracker for similar feature requests including closed ones

View File

@ -1,27 +1,3 @@
version 2021.01.24.1
Core
* Introduce --output-na-placeholder (#27896)
Extractors
* [franceculture] Make thumbnail optional (#18807)
* [franceculture] Fix extraction (#27891, #27903)
* [njpwworld] Fix extraction (#27890)
* [comedycentral] Fix extraction (#27905)
* [wat] Fix format extraction (#27901)
+ [americastestkitchen:season] Add support for seasons (#27861)
+ [trovo] Add support for trovo.live (#26125)
+ [aol] Add support for yahoo videos (#26650)
* [yahoo] Fix single video extraction
* [lbry] Unescape lbry URI (#27872)
* [9gag] Fix and improve extraction (#23022)
* [americastestkitchen] Improve metadata extraction for ATK episodes (#27860)
* [aljazeera] Fix extraction (#20911, #27779)
+ [minds] Add support for minds.com (#17934)
* [ard] Fix title and description extraction (#27761)
+ [spotify] Add support for Spotify Podcasts (#27443)
version 2021.01.16 version 2021.01.16
Core Core

761
README.md
View File

@ -52,431 +52,394 @@ Alternatively, refer to the [developer instructions](#developer-instructions) fo
youtube-dl [OPTIONS] URL [URL...] youtube-dl [OPTIONS] URL [URL...]
# 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. -U, --update Update this program to latest version. Make
Make sure that you have sufficient sure that you have sufficient permissions
permissions (run with sudo if needed) (run with sudo if needed)
-i, --ignore-errors Continue on download errors, for -i, --ignore-errors Continue on download errors, for example to
example to skip unavailable videos in a skip unavailable videos in a playlist
playlist --abort-on-error Abort downloading of further videos (in the
--abort-on-error Abort downloading of further videos (in playlist or the command line) if an error
the playlist or the command line) if an occurs
error occurs --dump-user-agent Display the current browser identification
--dump-user-agent Display the current browser --list-extractors List all supported extractors
identification --extractor-descriptions Output descriptions of all supported
--list-extractors List all supported extractors extractors
--extractor-descriptions Output descriptions of all supported --force-generic-extractor Force extraction to use the generic
extractors extractor
--force-generic-extractor Force extraction to use the generic --default-search PREFIX Use this prefix for unqualified URLs. For
extractor example "gvsearch2:" downloads two videos
--default-search PREFIX Use this prefix for unqualified URLs. from google videos for youtube-dl "large
For example "gvsearch2:" downloads two apple". Use the value "auto" to let
videos from google videos for youtube- youtube-dl guess ("auto_warning" to emit a
dl "large apple". Use the value "auto" warning when guessing). "error" just throws
to let youtube-dl guess ("auto_warning" an error. The default value "fixup_error"
to emit a warning when guessing). repairs broken URLs, but emits an error if
"error" just throws an error. The this is not possible instead of searching.
default value "fixup_error" repairs --ignore-config Do not read configuration files. When given
broken URLs, but emits an error if this in the global configuration file
is not possible instead of searching. /etc/youtube-dl.conf: Do not read the user
--ignore-config Do not read configuration files. When configuration in ~/.config/youtube-
given in the global configuration file dl/config (%APPDATA%/youtube-dl/config.txt
/etc/youtube-dl.conf: Do not read the on Windows)
user configuration in --config-location PATH Location of the configuration file; either
~/.config/youtube-dl/config the path to the config or its containing
(%APPDATA%/youtube-dl/config.txt on directory.
Windows) --flat-playlist Do not extract the videos of a playlist,
--config-location PATH Location of the configuration file; only list them.
either the path to the config or its --mark-watched Mark videos watched (YouTube only)
containing directory. --no-mark-watched Do not mark videos watched (YouTube only)
--flat-playlist Do not extract the videos of a --no-color Do not emit color codes in output
playlist, only list them.
--mark-watched Mark videos watched (YouTube only)
--no-mark-watched Do not mark videos watched (YouTube
only)
--no-color Do not emit color codes in output
## Network Options: ## Network Options:
--proxy URL Use the specified HTTP/HTTPS/SOCKS --proxy URL Use the specified HTTP/HTTPS/SOCKS proxy.
proxy. To enable SOCKS proxy, specify a To enable SOCKS proxy, specify a proper
proper scheme. For example scheme. For example
socks5://127.0.0.1:1080/. Pass in an socks5://127.0.0.1:1080/. Pass in an empty
empty string (--proxy "") for direct string (--proxy "") for direct connection
connection --socket-timeout SECONDS Time to wait before giving up, in seconds
--socket-timeout SECONDS Time to wait before giving up, in --source-address IP Client-side IP address to bind to
seconds -4, --force-ipv4 Make all connections via IPv4
--source-address IP Client-side IP address to bind to -6, --force-ipv6 Make all connections via IPv6
-4, --force-ipv4 Make all connections via IPv4
-6, --force-ipv6 Make all connections via IPv6
## Geo Restriction: ## Geo Restriction:
--geo-verification-proxy URL Use this proxy to verify the IP address --geo-verification-proxy URL Use this proxy to verify the IP address for
for some geo-restricted sites. The some geo-restricted sites. The default
default proxy specified by --proxy (or proxy specified by --proxy (or none, if the
none, if the option is not present) is option is not present) is used for the
used for the actual downloading. actual downloading.
--geo-bypass Bypass geographic restriction via --geo-bypass Bypass geographic restriction via faking
faking X-Forwarded-For HTTP header X-Forwarded-For HTTP header
--no-geo-bypass Do not bypass geographic restriction --no-geo-bypass Do not bypass geographic restriction via
via faking X-Forwarded-For HTTP header faking X-Forwarded-For HTTP header
--geo-bypass-country CODE Force bypass geographic restriction --geo-bypass-country CODE Force bypass geographic restriction with
with explicitly provided two-letter ISO explicitly provided two-letter ISO 3166-2
3166-2 country code country code
--geo-bypass-ip-block IP_BLOCK Force bypass geographic restriction --geo-bypass-ip-block IP_BLOCK Force bypass geographic restriction with
with explicitly provided IP block in explicitly provided IP block in CIDR
CIDR notation notation
## Video Selection: ## Video Selection:
--playlist-start NUMBER Playlist video to start at (default is --playlist-start NUMBER Playlist video to start at (default is 1)
1) --playlist-end NUMBER Playlist video to end at (default is last)
--playlist-end NUMBER Playlist video to end at (default is --playlist-items ITEM_SPEC Playlist video items to download. Specify
last) indices of the videos in the playlist
--playlist-items ITEM_SPEC Playlist video items to download. separated by commas like: "--playlist-items
Specify indices of the videos in the 1,2,5,8" if you want to download videos
playlist separated by commas like: "-- indexed 1, 2, 5, 8 in the playlist. You can
playlist-items 1,2,5,8" if you want to specify range: "--playlist-items
download videos indexed 1, 2, 5, 8 in 1-3,7,10-13", it will download the videos
the playlist. You can specify range: " at index 1, 2, 3, 7, 10, 11, 12 and 13.
--playlist-items 1-3,7,10-13", it will --match-title REGEX Download only matching titles (regex or
download the videos at index 1, 2, 3, caseless sub-string)
7, 10, 11, 12 and 13. --reject-title REGEX Skip download for matching titles (regex or
--match-title REGEX Download only matching titles (regex or caseless sub-string)
caseless sub-string) --max-downloads NUMBER Abort after downloading NUMBER files
--reject-title REGEX Skip download for matching titles --min-filesize SIZE Do not download any videos smaller than
(regex or caseless sub-string) SIZE (e.g. 50k or 44.6m)
--max-downloads NUMBER Abort after downloading NUMBER files --max-filesize SIZE Do not download any videos larger than SIZE
--min-filesize SIZE Do not download any videos smaller than (e.g. 50k or 44.6m)
SIZE (e.g. 50k or 44.6m) --date DATE Download only videos uploaded in this date
--max-filesize SIZE Do not download any videos larger than --datebefore DATE Download only videos uploaded on or before
SIZE (e.g. 50k or 44.6m) this date (i.e. inclusive)
--date DATE Download only videos uploaded in this --dateafter DATE Download only videos uploaded on or after
date this date (i.e. inclusive)
--datebefore DATE Download only videos uploaded on or --min-views COUNT Do not download any videos with less than
before this date (i.e. inclusive) COUNT views
--dateafter DATE Download only videos uploaded on or --max-views COUNT Do not download any videos with more than
after this date (i.e. inclusive) COUNT views
--min-views COUNT Do not download any videos with less --match-filter FILTER Generic video filter. Specify any key (see
than COUNT views the "OUTPUT TEMPLATE" for a list of
--max-views COUNT Do not download any videos with more available keys) to match if the key is
than COUNT views present, !key to check if the key is not
--match-filter FILTER Generic video filter. Specify any key present, key > NUMBER (like "comment_count
(see the "OUTPUT TEMPLATE" for a list > 12", also works with >=, <, <=, !=, =) to
of available keys) to match if the key compare against a number, key = 'LITERAL'
is present, !key to check if the key is (like "uploader = 'Mike Smith'", also works
not present, key > NUMBER (like with !=) to match against a string literal
"comment_count > 12", also works with and & to require multiple matches. Values
>=, <, <=, !=, =) to compare against a which are not known are excluded unless you
number, key = 'LITERAL' (like "uploader put a question mark (?) after the operator.
= 'Mike Smith'", also works with !=) to For example, to only match videos that have
match against a string literal and & to been liked more than 100 times and disliked
require multiple matches. Values which less than 50 times (or the dislike
are not known are excluded unless you functionality is not available at the given
put a question mark (?) after the service), but who also have a description,
operator. For example, to only match use --match-filter "like_count > 100 &
videos that have been liked more than dislike_count <? 50 & description" .
100 times and disliked less than 50 --no-playlist Download only the video, if the URL refers
times (or the dislike functionality is to a video and a playlist.
not available at the given service), --yes-playlist Download the playlist, if the URL refers to
but who also have a description, use a video and a playlist.
--match-filter "like_count > 100 & --age-limit YEARS Download only videos suitable for the given
dislike_count <? 50 & description" . age
--no-playlist Download only the video, if the URL --download-archive FILE Download only videos not listed in the
refers to a video and a playlist. archive file. Record the IDs of all
--yes-playlist Download the playlist, if the URL downloaded videos in it.
refers to a video and a playlist. --include-ads Download advertisements as well
--age-limit YEARS Download only videos suitable for the (experimental)
given 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, --limit-rate RATE Maximum download rate in bytes per -r, --limit-rate RATE Maximum download rate in bytes per second
second (e.g. 50K or 4.2M) (e.g. 50K or 4.2M)
-R, --retries RETRIES Number of retries (default is 10), or -R, --retries RETRIES Number of retries (default is 10), or
"infinite". "infinite".
--fragment-retries RETRIES Number of retries for a fragment --fragment-retries RETRIES Number of retries for a fragment (default
(default is 10), or "infinite" (DASH, is 10), or "infinite" (DASH, hlsnative and
hlsnative and ISM) ISM)
--skip-unavailable-fragments Skip unavailable fragments (DASH, --skip-unavailable-fragments Skip unavailable fragments (DASH, hlsnative
hlsnative and ISM) and ISM)
--abort-on-unavailable-fragment Abort downloading when some fragment is --abort-on-unavailable-fragment Abort downloading when some fragment is not
not available available
--keep-fragments Keep downloaded fragments on disk after --keep-fragments Keep downloaded fragments on disk after
downloading is finished; fragments are downloading is finished; fragments are
erased by default erased by default
--buffer-size SIZE Size of download buffer (e.g. 1024 or --buffer-size SIZE Size of download buffer (e.g. 1024 or 16K)
16K) (default is 1024) (default is 1024)
--no-resize-buffer Do not automatically adjust the buffer --no-resize-buffer Do not automatically adjust the buffer
size. By default, the buffer size is size. By default, the buffer size is
automatically resized from an initial automatically resized from an initial value
value of SIZE. of SIZE.
--http-chunk-size SIZE Size of a chunk for chunk-based HTTP --http-chunk-size SIZE Size of a chunk for chunk-based HTTP
downloading (e.g. 10485760 or 10M) downloading (e.g. 10485760 or 10M) (default
(default is disabled). May be useful is disabled). May be useful for bypassing
for bypassing bandwidth throttling bandwidth throttling imposed by a webserver
imposed by a webserver (experimental) (experimental)
--playlist-reverse Download playlist videos in reverse --playlist-reverse Download playlist videos in reverse order
order --playlist-random Download playlist videos in random order
--playlist-random Download playlist videos in random --xattr-set-filesize Set file xattribute ytdl.filesize with
order expected file size
--xattr-set-filesize Set file xattribute ytdl.filesize with --hls-prefer-native Use the native HLS downloader instead of
expected file size ffmpeg
--hls-prefer-native Use the native HLS downloader instead --hls-prefer-ffmpeg Use ffmpeg instead of the native HLS
of ffmpeg downloader
--hls-prefer-ffmpeg Use ffmpeg instead of the native HLS --hls-use-mpegts Use the mpegts container for HLS videos,
downloader allowing to play the video while
--hls-use-mpegts Use the mpegts container for HLS downloading (some players may not be able
videos, allowing to play the video to play it)
while downloading (some players may not --external-downloader COMMAND Use the specified external downloader.
be able to play it) Currently supports
--external-downloader COMMAND Use the specified external downloader. aria2c,avconv,axel,curl,ffmpeg,httpie,wget
Currently supports aria2c,avconv,axel,c --external-downloader-args ARGS Give these arguments to the external
url,ffmpeg,httpie,wget downloader
--external-downloader-args ARGS Give these arguments to the external
downloader
## Filesystem Options: ## Filesystem Options:
-a, --batch-file FILE File containing URLs to download ('-' -a, --batch-file FILE File containing URLs to download ('-' for
for stdin), one URL per line. Lines stdin), one URL per line. Lines starting
starting with '#', ';' or ']' are with '#', ';' or ']' are considered as
considered as comments and ignored. comments and ignored.
--id Use only video ID in file name --id Use only video ID in file name
-o, --output TEMPLATE Output filename template, see the -o, --output TEMPLATE Output filename template, see the "OUTPUT
"OUTPUT TEMPLATE" for all the info TEMPLATE" for all the info
--output-na-placeholder PLACEHOLDER Placeholder value for unavailable meta --autonumber-start NUMBER Specify the start value for %(autonumber)s
fields in output filename template (default is 1)
(default is "NA") --restrict-filenames Restrict filenames to only ASCII
--autonumber-start NUMBER Specify the start value for characters, and avoid "&" and spaces in
%(autonumber)s (default is 1) filenames
--restrict-filenames Restrict filenames to only ASCII -w, --no-overwrites Do not overwrite files
characters, and avoid "&" and spaces in -c, --continue Force resume of partially downloaded files.
filenames By default, youtube-dl will resume
-w, --no-overwrites Do not overwrite files downloads if possible.
-c, --continue Force resume of partially downloaded --no-continue Do not resume partially downloaded files
files. By default, youtube-dl will (restart from beginning)
resume downloads if possible. --no-part Do not use .part files - write directly
--no-continue Do not resume partially downloaded into output file
files (restart from beginning) --no-mtime Do not use the Last-modified header to set
--no-part Do not use .part files - write directly the file modification time
into output file --write-description Write video description to a .description
--no-mtime Do not use the Last-modified header to file
set the file modification time --write-info-json Write video metadata to a .info.json file
--write-description Write video description to a --write-annotations Write video annotations to a
.description file .annotations.xml file
--write-info-json Write video metadata to a .info.json --load-info-json FILE JSON file containing the video information
file (created with the "--write-info-json"
--write-annotations Write video annotations to a option)
.annotations.xml file --cookies FILE File to read cookies from and dump cookie
--load-info-json FILE JSON file containing the video jar in
information (created with the "--write- --cache-dir DIR Location in the filesystem where youtube-dl
info-json" option) can store some downloaded information
--cookies FILE File to read cookies from and dump permanently. By default
cookie jar in $XDG_CACHE_HOME/youtube-dl or
--cache-dir DIR Location in the filesystem where ~/.cache/youtube-dl . At the moment, only
youtube-dl can store some downloaded YouTube player files (for videos with
information permanently. By default obfuscated signatures) are cached, but that
$XDG_CACHE_HOME/youtube-dl or may change.
~/.cache/youtube-dl . At the moment, --no-cache-dir Disable filesystem caching
only YouTube player files (for videos --rm-cache-dir Delete all filesystem cache files
with obfuscated signatures) are cached,
but that may change.
--no-cache-dir Disable filesystem caching
--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 --write-all-thumbnails Write all thumbnail image formats to disk
disk --list-thumbnails Simulate and list all available thumbnail
--list-thumbnails Simulate and list all available formats
thumbnail formats
## Verbosity / Simulation Options: ## Verbosity / Simulation Options:
-q, --quiet Activate quiet mode -q, --quiet Activate quiet mode
--no-warnings Ignore warnings --no-warnings Ignore warnings
-s, --simulate Do not download the video and do not -s, --simulate Do not download the video and do not write
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
--get-id Simulate, quiet but print id --get-id Simulate, quiet but print id
--get-thumbnail Simulate, quiet but print thumbnail URL --get-thumbnail Simulate, quiet but print thumbnail URL
--get-description Simulate, quiet but print video --get-description Simulate, quiet but print video description
description --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 --get-format Simulate, quiet but print output format
filename -j, --dump-json Simulate, quiet but print JSON information.
--get-format Simulate, quiet but print output format See the "OUTPUT TEMPLATE" for a description
-j, --dump-json Simulate, quiet but print JSON of available keys.
information. See the "OUTPUT TEMPLATE" -J, --dump-single-json Simulate, quiet but print JSON information
for a description of available keys. for each command-line argument. If the URL
-J, --dump-single-json Simulate, quiet but print JSON refers to a playlist, dump the whole
information for each command-line playlist information in a single line.
argument. If the URL refers to a --print-json Be quiet and print the video information as
playlist, dump the whole playlist JSON (video is still being downloaded).
information in a single line. --newline Output progress bar as new lines
--print-json Be quiet and print the video --no-progress Do not print progress bar
information as JSON (video is still --console-title Display progress in console titlebar
being downloaded). -v, --verbose Print various debugging information
--newline Output progress bar as new lines --dump-pages Print downloaded pages encoded using base64
--no-progress Do not print progress bar to debug problems (very verbose)
--console-title Display progress in console titlebar --write-pages Write downloaded intermediary pages to
-v, --verbose Print various debugging information files in the current directory to debug
--dump-pages Print downloaded pages encoded using problems
base64 to debug problems (very verbose) --print-traffic Display sent and read HTTP traffic
--write-pages Write downloaded intermediary pages to -C, --call-home Contact the youtube-dl server for debugging
files in the current directory to debug --no-call-home Do NOT contact the youtube-dl server for
problems debugging
--print-traffic Display sent and read HTTP traffic
-C, --call-home 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 --encoding ENCODING Force the specified encoding (experimental)
(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 information about the video. (Currently
retrieve information about the video. supported only for YouTube)
(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 access is restricted to one domain
video access is restricted to one --add-header FIELD:VALUE Specify a custom HTTP header and its value,
domain separated by a colon ':'. You can use this
--add-header FIELD:VALUE Specify a custom HTTP header and its option multiple times
value, separated by a colon ':'. You --bidi-workaround Work around terminals that lack
can use this option multiple times bidirectional text support. Requires bidiv
--bidi-workaround Work around terminals that lack or fribidi executable in PATH
bidirectional text support. Requires --sleep-interval SECONDS Number of seconds to sleep before each
bidiv or fribidi executable in PATH download when used alone or a lower bound
--sleep-interval SECONDS Number of seconds to sleep before each of a range for randomized sleep before each
download when used alone or a lower download (minimum possible number of
bound of a range for randomized sleep seconds to sleep) when used along with
before each download (minimum possible --max-sleep-interval.
number of seconds to sleep) when used --max-sleep-interval SECONDS Upper bound of a range for randomized sleep
along with --max-sleep-interval. before each download (maximum possible
--max-sleep-interval SECONDS Upper bound of a range for randomized number of seconds to sleep). Must only be
sleep before each download (maximum used along with --min-sleep-interval.
possible number of seconds to sleep).
Must only be used along with --min-
sleep-interval.
## Video Format Options: ## Video Format Options:
-f, --format FORMAT Video format code, see the "FORMAT -f, --format FORMAT Video format code, see the "FORMAT
SELECTION" for all the info SELECTION" for all the info
--all-formats Download all available video formats --all-formats Download all available video formats
--prefer-free-formats Prefer free video formats unless a --prefer-free-formats Prefer free video formats unless a specific
specific one is requested one is requested
-F, --list-formats List all available formats of requested -F, --list-formats List all available formats of requested
videos videos
--youtube-skip-dash-manifest Do not download the DASH manifests and --youtube-skip-dash-manifest Do not download the DASH manifests and
related data on YouTube videos related data on YouTube videos
--merge-output-format FORMAT If a merge is required (e.g. --merge-output-format FORMAT If a merge is required (e.g.
bestvideo+bestaudio), output to given bestvideo+bestaudio), output to given
container format. One of mkv, mp4, ogg, container format. One of mkv, mp4, ogg,
webm, flv. Ignored if no merge is webm, flv. Ignored if no merge is required
required
## Subtitle Options: ## Subtitle Options:
--write-sub Write subtitle file --write-sub Write subtitle file
--write-auto-sub Write automatically generated subtitle --write-auto-sub Write automatically generated subtitle file
file (YouTube only) (YouTube only)
--all-subs Download all the available subtitles of --all-subs Download all the available subtitles of the
the video video
--list-subs List all available subtitles for the --list-subs List all available subtitles for the video
video --sub-format FORMAT Subtitle format, accepts formats
--sub-format FORMAT Subtitle format, accepts formats preference, for example: "srt" or
preference, for example: "srt" or "ass/srt/best"
"ass/srt/best" --sub-lang LANGS Languages of the subtitles to download
--sub-lang LANGS Languages of the subtitles to download (optional) separated by commas, use --list-
(optional) separated by commas, use subs for available language tags
--list-subs for available language tags
## 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 -p, --password PASSWORD Account password. If this option is left
left out, youtube-dl will ask out, youtube-dl will ask interactively.
interactively. -2, --twofactor TWOFACTOR Two-factor authentication code
-2, --twofactor TWOFACTOR Two-factor authentication code -n, --netrc Use .netrc authentication data
-n, --netrc Use .netrc authentication data --video-password PASSWORD Video password (vimeo, youku)
--video-password PASSWORD Video password (vimeo, youku)
## Adobe Pass Options: ## Adobe Pass Options:
--ap-mso MSO Adobe Pass multiple-system operator (TV --ap-mso MSO Adobe Pass multiple-system operator (TV
provider) identifier, use --ap-list-mso provider) identifier, use --ap-list-mso for
for a list of available MSOs a list of available MSOs
--ap-username USERNAME Multiple-system operator account login --ap-username USERNAME Multiple-system operator account login
--ap-password PASSWORD Multiple-system operator account --ap-password PASSWORD Multiple-system operator account password.
password. If this option is left out, If this option is left out, youtube-dl will
youtube-dl will ask interactively. ask interactively.
--ap-list-mso List all supported multiple-system --ap-list-mso List all supported multiple-system
operators operators
## 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/avconv and (requires ffmpeg or avconv and ffprobe or
ffprobe/avprobe) avprobe)
--audio-format FORMAT Specify audio format: "best", "aac", --audio-format FORMAT Specify audio format: "best", "aac",
"flac", "mp3", "m4a", "opus", "vorbis", "flac", "mp3", "m4a", "opus", "vorbis", or
or "wav"; "best" by default; No effect "wav"; "best" by default; No effect without
without -x -x
--audio-quality QUALITY Specify ffmpeg/avconv audio quality, --audio-quality QUALITY Specify ffmpeg/avconv audio quality, insert
insert a value between 0 (better) and 9 a value between 0 (better) and 9 (worse)
(worse) for VBR or a specific bitrate for VBR or a specific bitrate like 128K
like 128K (default 5) (default 5)
--recode-video FORMAT Encode the video to another format if --recode-video FORMAT Encode the video to another format if
necessary (currently supported: necessary (currently supported:
mp4|flv|ogg|webm|mkv|avi) mp4|flv|ogg|webm|mkv|avi)
--postprocessor-args ARGS Give these arguments to the --postprocessor-args ARGS Give these arguments to the postprocessor
postprocessor -k, --keep-video Keep the video file on disk after the post-
-k, --keep-video Keep the video file on disk after the processing; the video is erased by default
post-processing; the video is erased by --no-post-overwrites Do not overwrite post-processed files; the
default post-processed files are overwritten by
--no-post-overwrites Do not overwrite post-processed files; default
the post-processed files are --embed-subs Embed subtitles in the video (only for mp4,
overwritten by default webm and mkv videos)
--embed-subs Embed subtitles in the video (only for --embed-thumbnail Embed thumbnail in the audio as cover art
mp4, webm and mkv videos) --add-metadata Write metadata to the video file
--embed-thumbnail Embed thumbnail in the audio as cover --metadata-from-title FORMAT Parse additional metadata like song title /
art artist from the video title. The format
--add-metadata Write metadata to the video file syntax is the same as --output. Regular
--metadata-from-title FORMAT Parse additional metadata like song expression with named capture groups may
title / artist from the video title. also be used. The parsed parameters replace
The format syntax is the same as existing values. Example: --metadata-from-
--output. Regular expression with named title "%(artist)s - %(title)s" matches a
capture groups may also be used. The title like "Coldplay - Paradise". Example
parsed parameters replace existing (regex): --metadata-from-title
values. Example: --metadata-from-title "(?P<artist>.+?) - (?P<title>.+)"
"%(artist)s - %(title)s" matches a --xattrs Write metadata to the video file's xattrs
title like "Coldplay - Paradise". (using dublin core and xdg standards)
Example (regex): --metadata-from-title --fixup POLICY Automatically correct known faults of the
"(?P<artist>.+?) - (?P<title>.+)" file. One of never (do nothing), warn (only
--xattrs Write metadata to the video file's emit a warning), detect_or_warn (the
xattrs (using dublin core and xdg default; fix file if we can, warn
standards) otherwise)
--fixup POLICY Automatically correct known faults of --prefer-avconv Prefer avconv over ffmpeg for running the
the file. One of never (do nothing), postprocessors
warn (only emit a warning), --prefer-ffmpeg Prefer ffmpeg over avconv for running the
detect_or_warn (the default; fix file postprocessors (default)
if we can, warn otherwise) --ffmpeg-location PATH Location of the ffmpeg/avconv binary;
--prefer-avconv Prefer avconv over ffmpeg for running either the path to the binary or its
the postprocessors containing directory.
--prefer-ffmpeg Prefer ffmpeg over avconv for running --exec CMD Execute a command on the file after
the postprocessors (default) downloading and post-processing, similar to
--ffmpeg-location PATH Location of the ffmpeg/avconv binary; find's -exec syntax. Example: --exec 'adb
either the path to the binary or its push {} /sdcard/Music/ && rm {}'
containing directory. --convert-subs FORMAT Convert the subtitles to other format
--exec CMD Execute a command on the file after (currently supported: srt|ass|vtt|lrc)
downloading and post-processing,
similar to find's -exec syntax.
Example: --exec 'adb push {}
/sdcard/Music/ && rm {}'
--convert-subs FORMAT Convert the subtitles to other format
(currently supported: srt|ass|vtt|lrc)
# CONFIGURATION # CONFIGURATION

View File

@ -46,11 +46,10 @@
- **Amara** - **Amara**
- **AMCNetworks** - **AMCNetworks**
- **AmericasTestKitchen** - **AmericasTestKitchen**
- **AmericasTestKitchenSeason**
- **anderetijden**: npo.nl, ntr.nl, omroepwnl.nl, zapp.nl and npo3.nl - **anderetijden**: npo.nl, ntr.nl, omroepwnl.nl, zapp.nl and npo3.nl
- **AnimeOnDemand** - **AnimeOnDemand**
- **Anvato** - **Anvato**
- **aol.com**: Yahoo screen and movies - **aol.com**
- **APA** - **APA**
- **Aparat** - **Aparat**
- **AppleConnect** - **AppleConnect**
@ -193,6 +192,8 @@
- **CNNArticle** - **CNNArticle**
- **CNNBlogs** - **CNNBlogs**
- **ComedyCentral** - **ComedyCentral**
- **ComedyCentralFullEpisodes**
- **ComedyCentralShortname**
- **ComedyCentralTV** - **ComedyCentralTV**
- **CondeNast**: Condé Nast media group: Allure, Architectural Digest, Ars Technica, Bon Appétit, Brides, Condé Nast, Condé Nast Traveler, Details, Epicurious, GQ, Glamour, Golf Digest, SELF, Teen Vogue, The New Yorker, Vanity Fair, Vogue, W Magazine, WIRED - **CondeNast**: Condé Nast media group: Allure, Architectural Digest, Ars Technica, Bon Appétit, Brides, Condé Nast, Condé Nast Traveler, Details, Epicurious, GQ, Glamour, Golf Digest, SELF, Teen Vogue, The New Yorker, Vanity Fair, Vogue, W Magazine, WIRED
- **CONtv** - **CONtv**
@ -505,9 +506,6 @@
- **Mgoon** - **Mgoon**
- **MGTV**: 芒果TV - **MGTV**: 芒果TV
- **MiaoPai** - **MiaoPai**
- **minds**
- **minds:channel**
- **minds:group**
- **MinistryGrid** - **MinistryGrid**
- **Minoto** - **Minoto**
- **miomio.tv** - **miomio.tv**
@ -861,8 +859,6 @@
- **Sport5** - **Sport5**
- **SportBox** - **SportBox**
- **SportDeutschland** - **SportDeutschland**
- **spotify**
- **spotify:show**
- **Spreaker** - **Spreaker**
- **SpreakerPage** - **SpreakerPage**
- **SpreakerShow** - **SpreakerShow**
@ -944,13 +940,12 @@
- **TNAFlixNetworkEmbed** - **TNAFlixNetworkEmbed**
- **toggle** - **toggle**
- **ToonGoggles** - **ToonGoggles**
- **Tosh**: Tosh.0
- **tou.tv** - **tou.tv**
- **Toypics**: Toypics video - **Toypics**: Toypics video
- **ToypicsUser**: Toypics user profile - **ToypicsUser**: Toypics user profile
- **TrailerAddict** (Currently broken) - **TrailerAddict** (Currently broken)
- **Trilulilu** - **Trilulilu**
- **Trovo**
- **TrovoVod**
- **TruNews** - **TruNews**
- **TruTV** - **TruTV**
- **Tube8** - **Tube8**

View File

@ -1,3 +1,3 @@
from __future__ import unicode_literals from __future__ import unicode_literals
__version__ = '2021.01.24.1' __version__ = '2021.01.16'