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

535
README.md
View File

@ -54,139 +54,126 @@ Alternatively, refer to the [developer instructions](#developer-instructions) fo
# 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
identification
--list-extractors List all supported extractors --list-extractors List all supported extractors
--extractor-descriptions Output descriptions of all supported --extractor-descriptions Output descriptions of all supported
extractors extractors
--force-generic-extractor Force extraction to use the generic --force-generic-extractor Force extraction to use the generic
extractor extractor
--default-search PREFIX Use this prefix for unqualified URLs. --default-search PREFIX Use this prefix for unqualified URLs. For
For example "gvsearch2:" downloads two example "gvsearch2:" downloads two videos
videos from google videos for youtube- from google videos for youtube-dl "large
dl "large apple". Use the value "auto" apple". Use the value "auto" to let
to let youtube-dl guess ("auto_warning" youtube-dl guess ("auto_warning" to emit a
to emit a warning when guessing). warning when guessing). "error" just throws
"error" just throws an error. The an error. The default value "fixup_error"
default value "fixup_error" repairs repairs broken URLs, but emits an error if
broken URLs, but emits an error if this this is not possible instead of searching.
is not possible instead of searching. --ignore-config Do not read configuration files. When given
--ignore-config Do not read configuration files. When in the global configuration file
given in the global configuration file /etc/youtube-dl.conf: Do not read the user
/etc/youtube-dl.conf: Do not read the configuration in ~/.config/youtube-
user configuration in dl/config (%APPDATA%/youtube-dl/config.txt
~/.config/youtube-dl/config on Windows)
(%APPDATA%/youtube-dl/config.txt on --config-location PATH Location of the configuration file; either
Windows) the path to the config or its containing
--config-location PATH Location of the configuration file; directory.
either the path to the config or its --flat-playlist Do not extract the videos of a playlist,
containing directory. only list them.
--flat-playlist Do not extract the videos of a
playlist, only list them.
--mark-watched Mark videos watched (YouTube only) --mark-watched Mark videos watched (YouTube only)
--no-mark-watched Do not mark videos watched (YouTube --no-mark-watched Do not mark videos watched (YouTube only)
only)
--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/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
seconds
--source-address IP Client-side IP address to bind to --source-address IP Client-side IP address to bind to
-4, --force-ipv4 Make all connections via IPv4 -4, --force-ipv4 Make all connections via IPv4
-6, --force-ipv6 Make all connections via IPv6 -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
X-Forwarded-For HTTP header
--no-geo-bypass Do not bypass geographic restriction via
faking X-Forwarded-For HTTP header faking X-Forwarded-For HTTP header
--no-geo-bypass Do not bypass geographic restriction --geo-bypass-country CODE Force bypass geographic restriction with
via faking X-Forwarded-For HTTP header explicitly provided two-letter ISO 3166-2
--geo-bypass-country CODE Force bypass geographic restriction country code
with explicitly provided two-letter ISO --geo-bypass-ip-block IP_BLOCK Force bypass geographic restriction with
3166-2 country code explicitly provided IP block in CIDR
--geo-bypass-ip-block IP_BLOCK Force bypass geographic restriction notation
with explicitly provided IP block in
CIDR 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
download the videos at index 1, 2, 3,
7, 10, 11, 12 and 13.
--match-title REGEX Download only matching titles (regex or --match-title REGEX Download only matching titles (regex or
caseless sub-string) caseless sub-string)
--reject-title REGEX Skip download for matching titles --reject-title REGEX Skip download for matching titles (regex or
(regex or caseless sub-string) 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 --max-filesize SIZE Do not download any videos larger than SIZE
SIZE (e.g. 50k or 44.6m) (e.g. 50k or 44.6m)
--date DATE Download only videos uploaded in this --date DATE Download only videos uploaded in this date
date --datebefore DATE Download only videos uploaded on or before
--datebefore DATE Download only videos uploaded on or this date (i.e. inclusive)
before this date (i.e. inclusive) --dateafter DATE Download only videos uploaded on or after
--dateafter DATE Download only videos uploaded on or this date (i.e. inclusive)
after this date (i.e. inclusive) --min-views COUNT Do not download any videos with less than
--min-views COUNT Do not download any videos with less COUNT views
than COUNT views --max-views COUNT Do not download any videos with more than
--max-views COUNT Do not download any videos with more COUNT views
than COUNT views --match-filter FILTER Generic video filter. Specify any key (see
--match-filter FILTER Generic video filter. Specify any key the "OUTPUT TEMPLATE" for a list of
(see the "OUTPUT TEMPLATE" for a list available keys) to match if the key is
of available keys) to match if the key present, !key to check if the key is not
is present, !key to check if the key is present, key > NUMBER (like "comment_count
not present, key > NUMBER (like > 12", also works with >=, <, <=, !=, =) to
"comment_count > 12", also works with compare against a number, key = 'LITERAL'
>=, <, <=, !=, =) to compare against a (like "uploader = 'Mike Smith'", also works
number, key = 'LITERAL' (like "uploader with !=) to match against a string literal
= 'Mike Smith'", also works with !=) to and & to require multiple matches. Values
match against a string literal and & to which are not known are excluded unless you
require multiple matches. Values which put a question mark (?) after the operator.
are not known are excluded unless you For example, to only match videos that have
put a question mark (?) after the been liked more than 100 times and disliked
operator. For example, to only match less than 50 times (or the dislike
videos that have been liked more than functionality is not available at the given
100 times and disliked less than 50 service), but who also have a description,
times (or the dislike functionality is use --match-filter "like_count > 100 &
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 Download only the video, if the URL --no-playlist Download only the video, if the URL refers
refers to a video and a playlist. to a video and a playlist.
--yes-playlist Download the playlist, if the URL --yes-playlist Download the playlist, if the URL refers to
refers to a video and a playlist. a video and a playlist.
--age-limit YEARS Download only videos suitable for the --age-limit YEARS Download only videos suitable for the given
given age age
--download-archive FILE Download only videos not listed in the --download-archive FILE Download only videos not listed in the
archive file. Record the IDs of all archive file. Record the IDs of all
downloaded videos in it. downloaded videos in it.
@ -194,183 +181,168 @@ Alternatively, refer to the [developer instructions](#developer-instructions) fo
(experimental) (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
order
--xattr-set-filesize Set file xattribute ytdl.filesize with --xattr-set-filesize Set file xattribute ytdl.filesize with
expected file size expected file size
--hls-prefer-native Use the native HLS downloader instead --hls-prefer-native Use the native HLS downloader instead of
of ffmpeg ffmpeg
--hls-prefer-ffmpeg Use ffmpeg instead of the native HLS --hls-prefer-ffmpeg Use ffmpeg instead of the native HLS
downloader downloader
--hls-use-mpegts Use the mpegts container for HLS --hls-use-mpegts Use the mpegts container for HLS videos,
videos, allowing to play the video allowing to play the video while
while downloading (some players may not downloading (some players may not be able
be able to play it) to play it)
--external-downloader COMMAND Use the specified external downloader. --external-downloader COMMAND Use the specified external downloader.
Currently supports aria2c,avconv,axel,c Currently supports
url,ffmpeg,httpie,wget aria2c,avconv,axel,curl,ffmpeg,httpie,wget
--external-downloader-args ARGS Give these arguments to the external --external-downloader-args ARGS Give these arguments to the external
downloader 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")
--autonumber-start NUMBER Specify the start value for
%(autonumber)s (default is 1)
--restrict-filenames Restrict filenames to only ASCII --restrict-filenames Restrict filenames to only ASCII
characters, and avoid "&" and spaces in characters, and avoid "&" and spaces in
filenames filenames
-w, --no-overwrites Do not overwrite files -w, --no-overwrites Do not overwrite files
-c, --continue Force resume of partially downloaded -c, --continue Force resume of partially downloaded files.
files. By default, youtube-dl will By default, youtube-dl will resume
resume downloads if possible. downloads if possible.
--no-continue Do not resume partially downloaded --no-continue Do not resume partially downloaded files
files (restart from beginning) (restart from beginning)
--no-part Do not use .part files - write directly --no-part Do not use .part files - write directly
into output file into output file
--no-mtime Do not use the Last-modified header to --no-mtime Do not use the Last-modified header to set
set the file modification time the file modification time
--write-description Write video description to a --write-description Write video description to a .description
.description file
--write-info-json Write video metadata to a .info.json
file file
--write-info-json Write video metadata to a .info.json file
--write-annotations Write video annotations to a --write-annotations Write video annotations to a
.annotations.xml file .annotations.xml file
--load-info-json FILE JSON file containing the video --load-info-json FILE JSON file containing the video information
information (created with the "--write- (created with the "--write-info-json"
info-json" option) option)
--cookies FILE File to read cookies from and dump --cookies FILE File to read cookies from and dump cookie
cookie jar in jar in
--cache-dir DIR Location in the filesystem where --cache-dir DIR Location in the filesystem where youtube-dl
youtube-dl can store some downloaded can store some downloaded information
information permanently. By default permanently. By default
$XDG_CACHE_HOME/youtube-dl or $XDG_CACHE_HOME/youtube-dl or
~/.cache/youtube-dl . At the moment, ~/.cache/youtube-dl . At the moment, only
only YouTube player files (for videos YouTube player files (for videos with
with obfuscated signatures) are cached, obfuscated signatures) are cached, but that
but that may change. 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 --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 --get-filename Simulate, quiet but print output filename
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 -j, --dump-json Simulate, quiet but print JSON information.
information. See the "OUTPUT TEMPLATE" See the "OUTPUT TEMPLATE" for a description
for a description of available keys. of available keys.
-J, --dump-single-json Simulate, quiet but print JSON -J, --dump-single-json Simulate, quiet but print JSON information
information for each command-line for each command-line argument. If the URL
argument. If the URL refers to a refers to a playlist, dump the whole
playlist, dump the whole playlist playlist information in a single line.
information in a single line. --print-json Be quiet and print the video information as
--print-json Be quiet and print the video JSON (video is still being downloaded).
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-pages Print downloaded pages encoded using --dump-pages Print downloaded pages encoded using base64
base64 to debug problems (very verbose) to debug problems (very verbose)
--write-pages Write downloaded intermediary pages to --write-pages Write downloaded intermediary pages to
files in the current directory to debug files in the current directory to debug
problems 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
--no-call-home Do NOT contact the youtube-dl server for
debugging 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 --prefer-insecure Use an unencrypted connection to retrieve
retrieve information about the video. information about the video. (Currently
(Currently supported only for YouTube) 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 --referer URL Specify a custom referer, use if the video
video access is restricted to one access is restricted to one domain
domain --add-header FIELD:VALUE Specify a custom HTTP header and its value,
--add-header FIELD:VALUE Specify a custom HTTP header and its separated by a colon ':'. You can use this
value, separated by a colon ':'. You option multiple times
can use this option multiple times
--bidi-workaround Work around terminals that lack --bidi-workaround Work around terminals that lack
bidirectional text support. Requires bidirectional text support. Requires bidiv
bidiv or fribidi executable in PATH or fribidi executable in PATH
--sleep-interval SECONDS Number of seconds to sleep before each --sleep-interval SECONDS Number of seconds to sleep before each
download when used alone or a lower download when used alone or a lower bound
bound of a range for randomized sleep of a range for randomized sleep before each
before each download (minimum possible download (minimum possible number of
number of seconds to sleep) when used seconds to sleep) when used along with
along with --max-sleep-interval. --max-sleep-interval.
--max-sleep-interval SECONDS Upper bound of a range for randomized --max-sleep-interval SECONDS Upper bound of a range for randomized sleep
sleep before each download (maximum before each download (maximum possible
possible number of seconds to sleep). number of seconds to sleep). Must only be
Must only be used along with --min- used along with --min-sleep-interval.
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
@ -378,103 +350,94 @@ Alternatively, refer to the [developer instructions](#developer-instructions) fo
--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
--list-subs List all available subtitles for the
video video
--list-subs List all available subtitles for the 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 (optional) separated by commas, use --list-
--list-subs for available language tags 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
post-processed files are overwritten by
default default
--no-post-overwrites Do not overwrite post-processed files; --embed-subs Embed subtitles in the video (only for mp4,
the post-processed files are webm and mkv videos)
overwritten by default --embed-thumbnail Embed thumbnail in the audio as cover art
--embed-subs Embed subtitles in the video (only for
mp4, webm and mkv videos)
--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
--metadata-from-title FORMAT Parse additional metadata like song --metadata-from-title FORMAT Parse additional metadata like song title /
title / artist from the video title. artist from the video title. The format
The format syntax is the same as syntax is the same as --output. Regular
--output. Regular expression with named expression with named capture groups may
capture groups may also be used. The also be used. The parsed parameters replace
parsed parameters replace existing existing values. Example: --metadata-from-
values. Example: --metadata-from-title title "%(artist)s - %(title)s" matches a
"%(artist)s - %(title)s" matches a title like "Coldplay - Paradise". Example
title like "Coldplay - Paradise". (regex): --metadata-from-title
Example (regex): --metadata-from-title
"(?P<artist>.+?) - (?P<title>.+)" "(?P<artist>.+?) - (?P<title>.+)"
--xattrs Write metadata to the video file's --xattrs Write metadata to the video file's xattrs
xattrs (using dublin core and xdg (using dublin core and xdg standards)
standards) --fixup POLICY Automatically correct known faults of the
--fixup POLICY Automatically correct known faults of file. One of never (do nothing), warn (only
the file. One of never (do nothing), emit a warning), detect_or_warn (the
warn (only emit a warning), default; fix file if we can, warn
detect_or_warn (the default; fix file otherwise)
if we can, warn otherwise) --prefer-avconv Prefer avconv over ffmpeg for running the
--prefer-avconv Prefer avconv over ffmpeg for running postprocessors
the postprocessors --prefer-ffmpeg Prefer ffmpeg over avconv for running the
--prefer-ffmpeg Prefer ffmpeg over avconv for running postprocessors (default)
the postprocessors (default)
--ffmpeg-location PATH Location of the ffmpeg/avconv binary; --ffmpeg-location PATH Location of the ffmpeg/avconv binary;
either the path to the binary or its either the path to the binary or its
containing directory. containing directory.
--exec CMD Execute a command on the file after --exec CMD Execute a command on the file after
downloading and post-processing, downloading and post-processing, similar to
similar to find's -exec syntax. find's -exec syntax. Example: --exec 'adb
Example: --exec 'adb push {} push {} /sdcard/Music/ && rm {}'
/sdcard/Music/ && rm {}'
--convert-subs FORMAT Convert the subtitles to other format --convert-subs FORMAT Convert the subtitles to other format
(currently supported: srt|ass|vtt|lrc) (currently supported: srt|ass|vtt|lrc)

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'