2014-09-13 05:58:44 +00:00
from __future__ import unicode_literals
2014-09-13 05:55:21 +00:00
import os . path
import optparse
2016-08-02 15:03:26 +00:00
import re
2014-09-13 05:55:21 +00:00
import sys
2015-01-24 00:38:48 +00:00
from . downloader . external import list_external_downloaders
2014-11-02 10:23:40 +00:00
from . compat import (
2014-09-30 15:27:53 +00:00
compat_expanduser ,
2015-02-28 20:42:16 +00:00
compat_get_terminal_size ,
2014-09-30 15:27:53 +00:00
compat_getenv ,
2014-11-15 14:17:19 +00:00
compat_kwargs ,
2015-09-05 15:42:41 +00:00
compat_shlex_split ,
2014-11-02 10:23:40 +00:00
)
from . utils import (
2015-04-03 18:30:37 +00:00
preferredencoding ,
2014-09-13 05:55:21 +00:00
write_string ,
)
from . version import __version__
2017-07-23 08:21:35 +00:00
def _hide_login_info ( opts ) :
PRIVATE_OPTS = set ( [ ' -p ' , ' --password ' , ' -u ' , ' --username ' , ' --video-password ' , ' --ap-password ' , ' --ap-username ' ] )
eqre = re . compile ( ' ^(?P<key> ' + ( ' | ' . join ( re . escape ( po ) for po in PRIVATE_OPTS ) ) + ' )=.+$ ' )
def _scrub_eq ( o ) :
m = eqre . match ( o )
if m :
return m . group ( ' key ' ) + ' =PRIVATE '
else :
return o
opts = list ( map ( _scrub_eq , opts ) )
for idx , opt in enumerate ( opts ) :
if opt in PRIVATE_OPTS and idx + 1 < len ( opts ) :
opts [ idx + 1 ] = ' PRIVATE '
return opts
2014-09-13 05:55:21 +00:00
def parseOpts ( overrideArguments = None ) :
def _readOptions ( filename_bytes , default = [ ] ) :
try :
optionf = open ( filename_bytes )
except IOError :
return default # silently skip if file is not present
try :
2019-03-09 12:14:41 +00:00
# FIXME: https://github.com/ytdl-org/youtube-dl/commit/dfe5fa49aed02cf36ba9f743b11b0903554b5e56
2016-07-09 00:12:52 +00:00
contents = optionf . read ( )
if sys . version_info < ( 3 , ) :
contents = contents . decode ( preferredencoding ( ) )
res = compat_shlex_split ( contents , comments = True )
2014-09-13 05:55:21 +00:00
finally :
optionf . close ( )
return res
def _readUserConf ( ) :
2014-09-30 15:27:53 +00:00
xdg_config_home = compat_getenv ( ' XDG_CONFIG_HOME ' )
2014-09-13 05:55:21 +00:00
if xdg_config_home :
userConfFile = os . path . join ( xdg_config_home , ' youtube-dl ' , ' config ' )
if not os . path . isfile ( userConfFile ) :
userConfFile = os . path . join ( xdg_config_home , ' youtube-dl.conf ' )
else :
2014-09-30 15:27:53 +00:00
userConfFile = os . path . join ( compat_expanduser ( ' ~ ' ) , ' .config ' , ' youtube-dl ' , ' config ' )
2014-09-13 05:55:21 +00:00
if not os . path . isfile ( userConfFile ) :
2014-09-30 15:27:53 +00:00
userConfFile = os . path . join ( compat_expanduser ( ' ~ ' ) , ' .config ' , ' youtube-dl.conf ' )
2014-09-13 05:55:21 +00:00
userConf = _readOptions ( userConfFile , None )
if userConf is None :
2014-09-30 15:27:53 +00:00
appdata_dir = compat_getenv ( ' appdata ' )
2014-09-13 05:55:21 +00:00
if appdata_dir :
userConf = _readOptions (
os . path . join ( appdata_dir , ' youtube-dl ' , ' config ' ) ,
default = None )
if userConf is None :
userConf = _readOptions (
os . path . join ( appdata_dir , ' youtube-dl ' , ' config.txt ' ) ,
default = None )
if userConf is None :
userConf = _readOptions (
2014-09-30 15:27:53 +00:00
os . path . join ( compat_expanduser ( ' ~ ' ) , ' youtube-dl.conf ' ) ,
2014-09-13 05:55:21 +00:00
default = None )
if userConf is None :
userConf = _readOptions (
2014-09-30 15:27:53 +00:00
os . path . join ( compat_expanduser ( ' ~ ' ) , ' youtube-dl.conf.txt ' ) ,
2014-09-13 05:55:21 +00:00
default = None )
if userConf is None :
userConf = [ ]
return userConf
def _format_option_string ( option ) :
''' ( ' -o ' , ' --option ' ) -> -o, --format METAVAR '''
opts = [ ]
if option . _short_opts :
opts . append ( option . _short_opts [ 0 ] )
if option . _long_opts :
opts . append ( option . _long_opts [ 0 ] )
if len ( opts ) > 1 :
opts . insert ( 1 , ' , ' )
2014-10-12 21:10:11 +00:00
if option . takes_value ( ) :
opts . append ( ' %s ' % option . metavar )
2014-09-13 05:55:21 +00:00
2016-02-14 09:37:17 +00:00
return ' ' . join ( opts )
2014-09-13 05:55:21 +00:00
def _comma_separated_values_options_callback ( option , opt_str , value , parser ) :
setattr ( parser . values , option . dest , value . split ( ' , ' ) )
# No need to wrap help messages if we're on a wide console
2015-02-28 20:42:16 +00:00
columns = compat_get_terminal_size ( ) . columns
2014-10-12 21:10:11 +00:00
max_width = columns if columns else 80
max_help_position = 80
2014-09-13 05:55:21 +00:00
fmt = optparse . IndentedHelpFormatter ( width = max_width , max_help_position = max_help_position )
fmt . format_option_strings = _format_option_string
kw = {
2014-10-12 21:10:11 +00:00
' version ' : __version__ ,
' formatter ' : fmt ,
2015-01-01 21:01:26 +00:00
' usage ' : ' % prog [OPTIONS] URL [URL...] ' ,
2014-10-12 21:10:11 +00:00
' conflict_handler ' : ' resolve ' ,
2014-09-13 05:55:21 +00:00
}
2014-11-15 14:17:19 +00:00
parser = optparse . OptionParser ( * * compat_kwargs ( kw ) )
2014-09-13 05:55:21 +00:00
2014-10-12 21:10:11 +00:00
general = optparse . OptionGroup ( parser , ' General Options ' )
general . add_option (
' -h ' , ' --help ' ,
action = ' help ' ,
2015-03-25 10:02:55 +00:00
help = ' Print this help text and exit ' )
2014-10-12 21:10:11 +00:00
general . add_option (
2020-02-29 09:33:09 +00:00
' --version ' ,
2014-10-12 21:10:11 +00:00
action = ' version ' ,
2015-03-25 10:02:55 +00:00
help = ' Print program version and exit ' )
2014-10-12 21:10:11 +00:00
general . a dd_option (
' -U ' , ' --update ' ,
action = ' store_true ' , dest = ' update_self ' ,
2015-03-25 10:02:55 +00:00
help = ' Update this program to latest version. Make sure that you have sufficient permissions (run with sudo if needed) ' )
2014-10-12 21:10:11 +00:00
general . add_option (
' -i ' , ' --ignore-errors ' ,
action = ' store_true ' , dest = ' ignoreerrors ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Continue on download errors, for example to skip unavailable videos in a playlist ' )
2014-10-12 21:10:11 +00:00
general . add_option (
' --abort-on-error ' ,
action = ' store_false ' , dest = ' ignoreerrors ' ,
help = ' Abort downloading of further videos (in the playlist or the command line) if an error occurs ' )
general . add_option (
' --dump-user-agent ' ,
action = ' store_true ' , dest = ' dump_user_agent ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Display the current browser identification ' )
2014-09-13 05:55:21 +00:00
general . add_option (
2014-10-12 21:10:11 +00:00
' --list-extractors ' ,
action = ' store_true ' , dest = ' list_extractors ' , default = False ,
2015-06-07 02:12:21 +00:00
help = ' List all supported extractors ' )
2014-10-12 21:10:11 +00:00
general . add_option (
' --extractor-descriptions ' ,
action = ' store_true ' , dest = ' list_extractor_descriptions ' , default = False ,
help = ' Output descriptions of all supported extractors ' )
2015-06-12 13:20:12 +00:00
general . add_option (
' --force-generic-extractor ' ,
action = ' store_true ' , dest = ' force_generic_extractor ' , default = False ,
help = ' Force extraction to use the generic extractor ' )
2014-09-13 05:55:21 +00:00
general . add_option (
' --default-search ' ,
dest = ' default_search ' , metavar = ' PREFIX ' ,
2015-03-25 10:02:55 +00:00
help = ' Use this prefix for unqualified URLs. For example " gvsearch2: " downloads two videos from google videos for youtube-dl " large apple " . Use the value " auto " to let youtube-dl guess ( " auto_warning " to emit a warning when guessing). " error " just throws an error. The default value " fixup_error " repairs broken URLs, but emits an error if this is not possible instead of searching. ' )
2014-09-13 05:55:21 +00:00
general . add_option (
' --ignore-config ' ,
action = ' store_true ' ,
2014-12-04 06:57:18 +00:00
help = ' Do not read configuration files. '
' When given in the global configuration file /etc/youtube-dl.conf: '
' Do not read the user configuration in ~/.config/youtube-dl/config '
' ( % APPDATA % /youtube-dl/config.txt on Windows) ' )
2016-09-14 15:28:17 +00:00
general . add_option (
2016-12-31 16:41:37 +00:00
' --config-location ' ,
dest = ' config_location ' , metavar = ' PATH ' ,
help = ' Location of the configuration file; either the path to the config or its containing directory. ' )
2014-10-24 12:48:12 +00:00
general . add_option (
' --flat-playlist ' ,
action = ' store_const ' , dest = ' extract_flat ' , const = ' in_playlist ' ,
default = False ,
help = ' Do not extract the videos of a playlist, only list them. ' )
2016-02-29 19:01:33 +00:00
general . add_option (
' --mark-watched ' ,
action = ' store_true ' , dest = ' mark_watched ' , default = False ,
help = ' Mark videos watched (YouTube only) ' )
2016-03-01 17:41:23 +00:00
general . add_option (
' --no-mark-watched ' ,
action = ' store_false ' , dest = ' mark_watched ' , default = False ,
help = ' Do not mark videos watched (YouTube only) ' )
2015-02-10 03:22:10 +00:00
general . add_option (
' --no-color ' , ' --no-colors ' ,
action = ' store_true ' , dest = ' no_color ' ,
default = False ,
2015-03-25 10:02:55 +00:00
help = ' Do not emit color codes in output ' )
2014-09-13 05:55:21 +00:00
2015-01-10 18:55:36 +00:00
network = optparse . OptionGroup ( parser , ' Network Options ' )
network . add_option (
' --proxy ' , dest = ' proxy ' ,
default = None , metavar = ' URL ' ,
2018-05-19 16:53:24 +00:00
help = ' Use the specified HTTP/HTTPS/SOCKS proxy. To enable '
2016-05-08 07:15:58 +00:00
' SOCKS proxy, specify a proper scheme. For example '
' socks5://127.0.0.1:1080/. Pass in an empty string (--proxy " " ) '
' for direct connection ' )
2015-01-10 18:55:36 +00:00
network . add_option (
' --socket-timeout ' ,
dest = ' socket_timeout ' , type = float , default = None , metavar = ' SECONDS ' ,
help = ' Time to wait before giving up, in seconds ' )
network . add_option (
' --source-address ' ,
metavar = ' IP ' , dest = ' source_address ' , default = None ,
2017-01-28 15:40:07 +00:00
help = ' Client-side IP address to bind to ' ,
2015-01-10 18:55:36 +00:00
)
2015-01-10 19:02:02 +00:00
network . add_option (
' -4 ' , ' --force-ipv4 ' ,
action = ' store_const ' , const = ' 0.0.0.0 ' , dest = ' source_address ' ,
2017-01-28 15:40:07 +00:00
help = ' Make all connections via IPv4 ' ,
2015-01-10 19:02:02 +00:00
)
network . add_option (
' -6 ' , ' --force-ipv6 ' ,
action = ' store_const ' , const = ' :: ' , dest = ' source_address ' ,
2017-01-28 15:40:07 +00:00
help = ' Make all connections via IPv6 ' ,
2015-01-10 19:02:02 +00:00
)
2017-02-18 20:58:17 +00:00
geo = optparse . OptionGroup ( parser , ' Geo Restriction ' )
geo . add_option (
2016-07-03 15:23:48 +00:00
' --geo-verification-proxy ' ,
dest = ' geo_verification_proxy ' , default = None , metavar = ' URL ' ,
help = ' Use this proxy to verify the IP address for some geo-restricted sites. '
2018-05-14 16:42:33 +00:00
' The default proxy specified by --proxy (or none, if the option is not present) is used for the actual downloading. ' )
2017-02-18 20:58:17 +00:00
geo . add_option (
2015-03-02 23:03:06 +00:00
' --cn-verification-proxy ' ,
dest = ' cn_verification_proxy ' , default = None , metavar = ' URL ' ,
2017-02-18 20:58:17 +00:00
help = optparse . SUPPRESS_HELP )
geo . add_option (
' --geo-bypass ' ,
action = ' store_true ' , dest = ' geo_bypass ' , default = True ,
2018-05-19 16:53:24 +00:00
help = ' Bypass geographic restriction via faking X-Forwarded-For HTTP header ' )
2017-02-18 20:58:17 +00:00
geo . add_option (
' --no-geo-bypass ' ,
action = ' store_false ' , dest = ' geo_bypass ' , default = True ,
2018-05-19 16:53:24 +00:00
help = ' Do not bypass geographic restriction via faking X-Forwarded-For HTTP header ' )
2017-02-18 20:58:17 +00:00
geo . add_option (
' --geo-bypass-country ' , metavar = ' CODE ' ,
dest = ' geo_bypass_country ' , default = None ,
2018-05-19 16:53:24 +00:00
help = ' Force bypass geographic restriction with explicitly provided two-letter ISO 3166-2 country code ' )
2018-05-02 00:18:01 +00:00
geo . add_option (
' --geo-bypass-ip-block ' , metavar = ' IP_BLOCK ' ,
dest = ' geo_bypass_ip_block ' , default = None ,
2018-05-19 16:53:24 +00:00
help = ' Force bypass geographic restriction with explicitly provided IP block in CIDR notation ' )
2015-01-10 18:55:36 +00:00
2014-10-12 21:10:11 +00:00
selection = optparse . OptionGroup ( parser , ' Video Selection ' )
2014-09-13 05:55:21 +00:00
selection . add_option (
' --playlist-start ' ,
dest = ' playliststart ' , metavar = ' NUMBER ' , default = 1 , type = int ,
2015-03-25 10:02:55 +00:00
help = ' Playlist video to start at (default is %d efault) ' )
2014-09-13 05:55:21 +00:00
selection . add_option (
' --playlist-end ' ,
dest = ' playlistend ' , metavar = ' NUMBER ' , default = None , type = int ,
2015-03-25 10:02:55 +00:00
help = ' Playlist video to end at (default is last) ' )
2015-01-25 03:24:55 +00:00
selection . add_option (
' --playlist-items ' ,
dest = ' playlist_items ' , metavar = ' ITEM_SPEC ' , default = None ,
2015-07-21 03:11:23 +00:00
help = ' Playlist video items to download. Specify indices of the videos in the playlist separated by commas like: " --playlist-items 1,2,5,8 " if you want to download videos indexed 1, 2, 5, 8 in the playlist. You can specify range: " --playlist-items 1-3,7,10-13 " , it will download the videos at index 1, 2, 3, 7, 10, 11, 12 and 13. ' )
2014-09-13 05:55:21 +00:00
selection . add_option (
2014-10-12 21:10:11 +00:00
' --match-title ' ,
dest = ' matchtitle ' , metavar = ' REGEX ' ,
2015-03-25 10:02:55 +00:00
help = ' Download only matching titles (regex or caseless sub-string) ' )
2014-10-12 21:10:11 +00:00
selection . add_option (
' --reject-title ' ,
dest = ' rejecttitle ' , metavar = ' REGEX ' ,
2015-03-25 10:02:55 +00:00
help = ' Skip download for matching titles (regex or caseless sub-string) ' )
2014-10-12 21:10:11 +00:00
selection . add_option (
' --max-downloads ' ,
dest = ' max_downloads ' , metavar = ' NUMBER ' , type = int , default = None ,
help = ' Abort after downloading NUMBER files ' )
selection . add_option (
' --min-filesize ' ,
metavar = ' SIZE ' , dest = ' min_filesize ' , default = None ,
help = ' Do not download any videos smaller than SIZE (e.g. 50k or 44.6m) ' )
selection . add_option (
' --max-filesize ' ,
metavar = ' SIZE ' , dest = ' max_filesize ' , default = None ,
help = ' Do not download any videos larger than SIZE (e.g. 50k or 44.6m) ' )
selection . add_option (
' --date ' ,
metavar = ' DATE ' , dest = ' date ' , default = None ,
2015-03-25 10:02:55 +00:00
help = ' Download only videos uploaded in this date ' )
2014-10-12 21:10:11 +00:00
selection . add_option (
' --datebefore ' ,
metavar = ' DATE ' , dest = ' datebefore ' , default = None ,
2015-03-25 10:02:55 +00:00
help = ' Download only videos uploaded on or before this date (i.e. inclusive) ' )
2014-09-13 05:55:21 +00:00
selection . add_option (
2014-10-12 21:10:11 +00:00
' --dateafter ' ,
metavar = ' DATE ' , dest = ' dateafter ' , default = None ,
2015-03-25 10:02:55 +00:00
help = ' Download only videos uploaded on or after this date (i.e. inclusive) ' )
2014-09-13 05:55:21 +00:00
selection . add_option (
2014-10-12 21:10:11 +00:00
' --min-views ' ,
metavar = ' COUNT ' , dest = ' min_views ' , default = None , type = int ,
2015-03-25 10:02:55 +00:00
help = ' Do not download any videos with less than COUNT views ' )
2014-09-13 05:55:21 +00:00
selection . add_option (
2014-10-12 21:10:11 +00:00
' --max-views ' ,
metavar = ' COUNT ' , dest = ' max_views ' , default = None , type = int ,
help = ' Do not download any videos with more than COUNT views ' )
2015-02-10 02:32:21 +00:00
selection . add_option (
' --match-filter ' ,
metavar = ' FILTER ' , dest = ' match_filter ' , default = None ,
help = (
2017-01-28 15:40:07 +00:00
' Generic video filter. '
2017-06-08 14:52:19 +00:00
' Specify any key (see the " OUTPUT TEMPLATE " for a list of available keys) to '
2017-02-17 16:18:26 +00:00
' match if the key is present, '
' !key to check if the key is not present, '
2015-02-10 02:32:21 +00:00
' key > NUMBER (like " comment_count > 12 " , also works with '
2017-02-18 16:59:26 +00:00
' >=, <, <=, !=, =) to compare against a number, '
' key = \' LITERAL \' (like " uploader = \' Mike Smith \' " , also works with !=) '
' to match against a string literal '
' and & to require multiple matches. '
2017-02-17 16:18:26 +00:00
' Values which are not known are excluded unless you '
' put a question mark (?) after the operator. '
2015-02-10 02:32:21 +00:00
' For example, to only match videos that have been liked more than '
' 100 times and disliked less than 50 times (or the dislike '
' functionality is not available at the given service), but who '
2015-09-13 12:00:10 +00:00
' also have a description, use --match-filter '
2015-02-10 02:32:21 +00:00
' " like_count > 100 & dislike_count <? 50 & description " . '
) )
2014-09-13 05:55:21 +00:00
selection . add_option (
2014-10-12 21:10:11 +00:00
' --no-playlist ' ,
action = ' store_true ' , dest = ' noplaylist ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Download only the video, if the URL refers to a video and a playlist. ' )
2015-02-24 16:25:02 +00:00
selection . add_option (
' --yes-playlist ' ,
action = ' store_false ' , dest = ' noplaylist ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Download the playlist, if the URL refers to a video and a playlist. ' )
2014-10-12 21:10:11 +00:00
selection . add_option (
' --age-limit ' ,
metavar = ' YEARS ' , dest = ' age_limit ' , default = None , type = int ,
2015-03-25 10:02:55 +00:00
help = ' Download only videos suitable for the given age ' )
2014-10-12 21:10:11 +00:00
selection . add_option (
' --download-archive ' , metavar = ' FILE ' ,
dest = ' download_archive ' ,
help = ' Download only videos not listed in the archive file. Record the IDs of all downloaded videos in it. ' )
selection . add_option (
' --include-ads ' ,
dest = ' include_ads ' , action = ' store_true ' ,
2014-09-13 05:55:21 +00:00
help = ' Download advertisements as well (experimental) ' )
2014-10-12 21:10:11 +00:00
authentication = optparse . OptionGroup ( parser , ' Authentication Options ' )
authentication . add_option (
' -u ' , ' --username ' ,
dest = ' username ' , metavar = ' USERNAME ' ,
2015-03-25 10:02:55 +00:00
help = ' Login with this account ID ' )
2014-10-12 21:10:11 +00:00
authentication . add_option (
' -p ' , ' --password ' ,
dest = ' password ' , metavar = ' PASSWORD ' ,
2015-03-25 10:02:55 +00:00
help = ' Account password. If this option is left out, youtube-dl will ask interactively. ' )
2014-10-12 21:10:11 +00:00
authentication . add_option (
' -2 ' , ' --twofactor ' ,
dest = ' twofactor ' , metavar = ' TWOFACTOR ' ,
2016-12-12 11:13:34 +00:00
help = ' Two-factor authentication code ' )
2014-10-12 21:10:11 +00:00
authentication . add_option (
' -n ' , ' --netrc ' ,
action = ' store_true ' , dest = ' usenetrc ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Use .netrc authentication data ' )
2014-10-12 21:10:11 +00:00
authentication . add_option (
' --video-password ' ,
dest = ' videopassword ' , metavar = ' PASSWORD ' ,
2020-12-09 19:01:23 +00:00
help = ' Video password (vimeo, youku) ' )
2016-09-13 21:16:01 +00:00
adobe_pass = optparse . OptionGroup ( parser , ' Adobe Pass Options ' )
adobe_pass . add_option (
2016-09-14 17:58:47 +00:00
' --ap-mso ' ,
dest = ' ap_mso ' , metavar = ' MSO ' ,
2016-09-15 15:17:17 +00:00
help = ' Adobe Pass multiple-system operator (TV provider) identifier, use --ap-list-mso for a list of available MSOs ' )
2016-09-13 21:16:01 +00:00
adobe_pass . add_option (
' --ap-username ' ,
2016-09-14 17:58:47 +00:00
dest = ' ap_username ' , metavar = ' USERNAME ' ,
2016-09-15 15:17:17 +00:00
help = ' Multiple-system operator account login ' )
2016-09-13 21:16:01 +00:00
adobe_pass . add_option (
' --ap-password ' ,
2016-09-14 17:58:47 +00:00
dest = ' ap_password ' , metavar = ' PASSWORD ' ,
2016-09-15 15:17:17 +00:00
help = ' Multiple-system operator account password. If this option is left out, youtube-dl will ask interactively. ' )
2016-09-13 21:16:01 +00:00
adobe_pass . add_option (
2016-09-14 19:21:09 +00:00
' --ap-list-mso ' ,
action = ' store_true ' , dest = ' ap_list_mso ' , default = False ,
2016-09-15 15:17:17 +00:00
help = ' List all supported multiple-system operators ' )
2014-10-12 21:10:11 +00:00
video_format = optparse . OptionGroup ( parser , ' Video Format Options ' )
video_format . add_option (
' -f ' , ' --format ' ,
action = ' store ' , dest = ' format ' , metavar = ' FORMAT ' , default = None ,
2015-04-19 16:37:38 +00:00
help = ' Video format code, see the " FORMAT SELECTION " for all the info ' )
2014-10-12 21:10:11 +00:00
video_format . add_option (
' --all-formats ' ,
action = ' store_const ' , dest = ' format ' , const = ' all ' ,
2015-03-25 10:02:55 +00:00
help = ' Download all available video formats ' )
2014-10-12 21:10:11 +00:00
video_format . add_option (
' --prefer-free-formats ' ,
action = ' store_true ' , dest = ' prefer_free_formats ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Prefer free video formats unless a specific one is requested ' )
2014-10-12 21:10:11 +00:00
video_format . add_option (
' -F ' , ' --list-formats ' ,
action = ' store_true ' , dest = ' listformats ' ,
2015-11-28 06:14:20 +00:00
help = ' List all available formats of requested videos ' )
2014-10-12 22:03:08 +00:00
video_format . add_option (
' --youtube-include-dash-manifest ' ,
action = ' store_true ' , dest = ' youtube_include_dash_manifest ' , default = True ,
help = optparse . SUPPRESS_HELP )
video_format . add_option (
' --youtube-skip-dash-manifest ' ,
action = ' store_false ' , dest = ' youtube_include_dash_manifest ' ,
2015-06-27 08:38:41 +00:00
help = ' Do not download the DASH manifests and related data on YouTube videos ' )
2015-01-09 22:03:56 +00:00
video_format . add_option (
2015-01-10 01:03:00 +00:00
' --merge-output-format ' ,
action = ' store ' , dest = ' merge_output_format ' , metavar = ' FORMAT ' , default = None ,
2015-01-09 22:03:56 +00:00
help = (
2015-06-27 08:26:51 +00:00
' If a merge is required (e.g. bestvideo+bestaudio), '
' output to given container format. One of mkv, mp4, ogg, webm, flv. '
2015-01-09 22:03:56 +00:00
' Ignored if no merge is required ' ) )
2014-10-12 21:10:11 +00:00
subtitles = optparse . OptionGroup ( parser , ' Subtitle Options ' )
subtitles . add_option (
' --write-sub ' , ' --write-srt ' ,
action = ' store_true ' , dest = ' writesubtitles ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Write subtitle file ' )
2014-10-12 21:10:11 +00:00
subtitles . add_option (
' --write-auto-sub ' , ' --write-automatic-sub ' ,
action = ' store_true ' , dest = ' writeautomaticsub ' , default = False ,
2015-11-16 14:15:25 +00:00
help = ' Write automatically generated subtitle file (YouTube only) ' )
2014-10-12 21:10:11 +00:00
subtitles . add_option (
' --all-subs ' ,
action = ' store_true ' , dest = ' allsubtitles ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Download all the available subtitles of the video ' )
2014-10-12 21:10:11 +00:00
subtitles . add_option (
' --list-subs ' ,
action = ' store_true ' , dest = ' listsubtitles ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' List all available subtitles for the video ' )
2014-10-12 21:10:11 +00:00
subtitles . add_option (
' --sub-format ' ,
2015-02-15 17:03:41 +00:00
action = ' store ' , dest = ' subtitlesformat ' , metavar = ' FORMAT ' , default = ' best ' ,
2015-04-04 14:00:23 +00:00
help = ' Subtitle format, accepts formats preference, for example: " srt " or " ass/srt/best " ' )
2014-10-12 21:10:11 +00:00
subtitles . add_option (
' --sub-lang ' , ' --sub-langs ' , ' --srt-lang ' ,
action = ' callback ' , dest = ' subtitleslangs ' , metavar = ' LANGS ' , type = ' str ' ,
default = [ ] , callback = _comma_separated_values_options_callback ,
2016-01-22 19:50:06 +00:00
help = ' Languages of the subtitles to download (optional) separated by commas, use --list-subs for available language tags ' )
2014-10-12 21:10:11 +00:00
downloader = optparse . OptionGroup ( parser , ' Download Options ' )
downloader . add_option (
2016-05-30 14:48:35 +00:00
' -r ' , ' --limit-rate ' , ' --rate-limit ' ,
dest = ' ratelimit ' , metavar = ' RATE ' ,
2015-03-25 10:02:55 +00:00
help = ' Maximum download rate in bytes per second (e.g. 50K or 4.2M) ' )
2014-10-12 21:10:11 +00:00
downloader . add_option (
' -R ' , ' --retries ' ,
dest = ' retries ' , metavar = ' RETRIES ' , default = 10 ,
2015-03-25 10:02:55 +00:00
help = ' Number of retries (default is %d efault), or " infinite " . ' )
2016-03-19 14:40:36 +00:00
downloader . add_option (
' --fragment-retries ' ,
dest = ' fragment_retries ' , metavar = ' RETRIES ' , default = 10 ,
2017-03-28 16:35:48 +00:00
help = ' Number of retries for a fragment (default is %d efault), or " infinite " (DASH, hlsnative and ISM) ' )
2016-08-26 21:52:18 +00:00
downloader . add_option (
' --skip-unavailable-fragments ' ,
action = ' store_true ' , dest = ' skip_unavailable_fragments ' , default = True ,
2017-03-28 16:35:48 +00:00
help = ' Skip unavailable fragments (DASH, hlsnative and ISM) ' )
2017-01-28 14:06:22 +00:00
downloader . add_option (
2016-08-26 21:52:18 +00:00
' --abort-on-unavailable-fragment ' ,
action = ' store_false ' , dest = ' skip_unavailable_fragments ' ,
help = ' Abort downloading when some fragment is not available ' )
2017-04-23 20:09:08 +00:00
downloader . add_option (
' --keep-fragments ' ,
action = ' store_true ' , dest = ' keep_fragments ' , default = False ,
help = ' Keep downloaded fragments on disk after downloading is finished; fragments are erased by default ' )
2014-10-12 21:10:11 +00:00
downloader . add_option (
' --buffer-size ' ,
dest = ' buffersize ' , metavar = ' SIZE ' , default = ' 1024 ' ,
2015-03-25 10:02:55 +00:00
help = ' Size of download buffer (e.g. 1024 or 16K) (default is %d efault) ' )
2014-10-12 21:10:11 +00:00
downloader . add_option (
' --no-resize-buffer ' ,
action = ' store_true ' , dest = ' noresizebuffer ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Do not automatically adjust the buffer size. By default, the buffer size is automatically resized from an initial value of SIZE. ' )
2018-01-28 06:21:45 +00:00
downloader . add_option (
' --http-chunk-size ' ,
dest = ' http_chunk_size ' , metavar = ' SIZE ' , default = None ,
help = ' Size of a chunk for chunk-based HTTP downloading (e.g. 10485760 or 10M) (default is disabled). '
' May be useful for bypassing bandwidth throttling imposed by a webserver (experimental) ' )
2014-10-12 21:10:11 +00:00
downloader . add_option (
' --test ' ,
action = ' store_true ' , dest = ' test ' , default = False ,
help = optparse . SUPPRESS_HELP )
2014-07-11 03:11:11 +00:00
downloader . add_option (
' --playlist-reverse ' ,
action = ' store_true ' ,
help = ' Download playlist videos in reverse order ' )
2017-01-31 09:03:31 +00:00
downloader . add_option (
' --playlist-random ' ,
action = ' store_true ' ,
help = ' Download playlist videos in random order ' )
2015-01-25 03:49:44 +00:00
downloader . add_option (
' --xattr-set-filesize ' ,
dest = ' xattr_set_filesize ' , action = ' store_true ' ,
2018-05-19 16:53:24 +00:00
help = ' Set file xattribute ytdl.filesize with expected file size ' )
2015-02-17 11:09:12 +00:00
downloader . add_option (
' --hls-prefer-native ' ,
2016-04-21 17:02:17 +00:00
dest = ' hls_prefer_native ' , action = ' store_true ' , default = None ,
2016-04-21 16:44:01 +00:00
help = ' Use the native HLS downloader instead of ffmpeg ' )
2016-04-21 17:02:17 +00:00
downloader . add_option (
' --hls-prefer-ffmpeg ' ,
dest = ' hls_prefer_native ' , action = ' store_false ' , default = None ,
help = ' Use ffmpeg instead of the native HLS downloader ' )
2016-01-30 11:26:40 +00:00
downloader . add_option (
' --hls-use-mpegts ' ,
dest = ' hls_use_mpegts ' , action = ' store_true ' ,
help = ' Use the mpegts container for HLS videos, allowing to play the '
2016-01-30 12:44:22 +00:00
' video while downloading (some players may not be able to play it) ' )
2015-01-24 00:38:48 +00:00
downloader . add_option (
' --external-downloader ' ,
dest = ' external_downloader ' , metavar = ' COMMAND ' ,
2015-03-02 14:06:09 +00:00
help = ' Use the specified external downloader. '
2015-01-24 00:38:48 +00:00
' Currently supports %s ' % ' , ' . join ( list_external_downloaders ( ) ) )
2015-03-02 14:06:09 +00:00
downloader . add_option (
' --external-downloader-args ' ,
dest = ' external_downloader_args ' , metavar = ' ARGS ' ,
2015-03-25 10:02:55 +00:00
help = ' Give these arguments to the external downloader ' )
2014-10-12 21:10:11 +00:00
workarounds = optparse . OptionGroup ( parser , ' Workarounds ' )
2014-09-13 05:55:21 +00:00
workarounds . add_option (
2014-10-12 21:10:11 +00:00
' --encoding ' ,
dest = ' encoding ' , metavar = ' ENCODING ' ,
2014-09-13 05:55:21 +00:00
help = ' Force the specified encoding (experimental) ' )
workarounds . add_option (
2014-10-12 21:10:11 +00:00
' --no-check-certificate ' ,
action = ' store_true ' , dest = ' no_check_certificate ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Suppress HTTPS certificate validation ' )
2014-09-13 05:55:21 +00:00
workarounds . add_option (
2014-10-12 21:10:11 +00:00
' --prefer-insecure ' ,
' --prefer-unsecure ' , action = ' store_true ' , dest = ' prefer_insecure ' ,
2018-02-27 15:30:08 +00:00
help = ' Use an unencrypted connection to retrieve information about the video. (Currently supported only for YouTube) ' )
2014-09-13 05:55:21 +00:00
workarounds . add_option (
2014-10-12 21:10:11 +00:00
' --user-agent ' ,
metavar = ' UA ' , dest = ' user_agent ' ,
2015-03-25 10:02:55 +00:00
help = ' Specify a custom user agent ' )
2014-09-13 05:55:21 +00:00
workarounds . add_option (
2014-10-12 21:10:11 +00:00
' --referer ' ,
metavar = ' URL ' , dest = ' referer ' , default = None ,
2015-03-25 10:02:55 +00:00
help = ' Specify a custom referer, use if the video access is restricted to one domain ' ,
2014-09-13 05:55:21 +00:00
)
workarounds . add_option (
2014-10-12 21:10:11 +00:00
' --add-header ' ,
metavar = ' FIELD:VALUE ' , dest = ' headers ' , action = ' append ' ,
2015-03-25 10:02:55 +00:00
help = ' Specify a custom HTTP header and its value, separated by a colon \' : \' . You can use this option multiple times ' ,
2014-09-13 05:55:21 +00:00
)
workarounds . add_option (
2014-10-12 21:10:11 +00:00
' --bidi-workaround ' ,
dest = ' bidi_workaround ' , action = ' store_true ' ,
help = ' Work around terminals that lack bidirectional text support. Requires bidiv or fribidi executable in PATH ' )
2015-01-23 11:05:01 +00:00
workarounds . add_option (
2016-08-04 10:17:22 +00:00
' --sleep-interval ' , ' --min-sleep-interval ' , metavar = ' SECONDS ' ,
2015-01-23 11:07:13 +00:00
dest = ' sleep_interval ' , type = float ,
2016-08-08 20:46:52 +00:00
help = (
' Number of seconds to sleep before each download when used alone '
' or a lower bound of a range for randomized sleep before each download '
' (minimum possible number of seconds to sleep) when used along with '
' --max-sleep-interval. ' ) )
2016-08-04 10:17:22 +00:00
workarounds . add_option (
' --max-sleep-interval ' , metavar = ' SECONDS ' ,
dest = ' max_sleep_interval ' , type = float ,
2016-08-08 20:46:52 +00:00
help = (
' Upper bound of a range for randomized sleep before each download '
' (maximum possible number of seconds to sleep). Must only be used '
' along with --min-sleep-interval. ' ) )
2014-09-13 05:55:21 +00:00
2014-10-12 21:10:11 +00:00
verbosity = optparse . OptionGroup ( parser , ' Verbosity / Simulation Options ' )
verbosity . add_option (
' -q ' , ' --quiet ' ,
action = ' store_true ' , dest = ' quiet ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Activate quiet mode ' )
2014-09-13 05:55:21 +00:00
verbosity . add_option (
' --no-warnings ' ,
dest = ' no_warnings ' , action = ' store_true ' , default = False ,
help = ' Ignore warnings ' )
2014-10-12 21:10:11 +00:00
verbosity . add_option (
' -s ' , ' --simulate ' ,
action = ' store_true ' , dest = ' simulate ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Do not download the video and do not write anything to disk ' )
2014-10-12 21:10:11 +00:00
verbosity . add_option (
' --skip-download ' ,
action = ' store_true ' , dest = ' skip_download ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Do not download the video ' )
2014-10-12 21:10:11 +00:00
verbosity . add_option (
' -g ' , ' --get-url ' ,
action = ' store_true ' , dest = ' geturl ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Simulate, quiet but print URL ' )
2014-10-12 21:10:11 +00:00
verbosity . add_option (
' -e ' , ' --get-title ' ,
action = ' store_true ' , dest = ' gettitle ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Simulate, quiet but print title ' )
2014-10-12 21:10:11 +00:00
verbosity . add_option (
' --get-id ' ,
action = ' store_true ' , dest = ' getid ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Simulate, quiet but print id ' )
2014-10-12 21:10:11 +00:00
verbosity . add_option (
' --get-thumbnail ' ,
action = ' store_true ' , dest = ' getthumbnail ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Simulate, quiet but print thumbnail URL ' )
2014-10-12 21:10:11 +00:00
verbosity . add_option (
' --get-description ' ,
action = ' store_true ' , dest = ' getdescription ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Simulate, quiet but print video description ' )
2014-10-12 21:10:11 +00:00
verbosity . add_option (
' --get-duration ' ,
action = ' store_true ' , dest = ' getduration ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Simulate, quiet but print video length ' )
2014-10-12 21:10:11 +00:00
verbosity . add_option (
' --get-filename ' ,
action = ' store_true ' , dest = ' getfilename ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Simulate, quiet but print output filename ' )
2014-10-12 21:10:11 +00:00
verbosity . add_option (
' --get-format ' ,
action = ' store_true ' , dest = ' getformat ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Simulate, quiet but print output format ' )
2014-10-12 21:10:11 +00:00
verbosity . add_option (
' -j ' , ' --dump-json ' ,
action = ' store_true ' , dest = ' dumpjson ' , default = False ,
2017-06-08 14:52:19 +00:00
help = ' Simulate, quiet but print JSON information. See the " OUTPUT TEMPLATE " for a description of available keys. ' )
2014-10-24 22:30:57 +00:00
verbosity . add_option (
' -J ' , ' --dump-single-json ' ,
action = ' store_true ' , dest = ' dump_single_json ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Simulate, quiet but print JSON information for each command-line argument. If the URL refers to a playlist, dump the whole playlist information in a single line. ' )
2015-01-08 17:01:41 +00:00
verbosity . add_option (
' --print-json ' ,
action = ' store_true ' , dest = ' print_json ' , default = False ,
help = ' Be quiet and print the video information as JSON (video is still being downloaded). ' ,
)
2014-10-12 21:10:11 +00:00
verbosity . add_option (
' --newline ' ,
action = ' store_true ' , dest = ' progress_with_newline ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Output progress bar as new lines ' )
2014-10-12 21:10:11 +00:00
verbosity . add_option (
' --no-progress ' ,
action = ' store_true ' , dest = ' noprogress ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Do not print progress bar ' )
2014-10-12 21:10:11 +00:00
verbosity . add_option (
' --console-title ' ,
action = ' store_true ' , dest = ' consoletitle ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Display progress in console titlebar ' )
2014-10-12 21:10:11 +00:00
verbosity . add_option (
' -v ' , ' --verbose ' ,
action = ' store_true ' , dest = ' verbose ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Print various debugging information ' )
2014-10-12 21:10:11 +00:00
verbosity . add_option (
2015-03-08 17:37:43 +00:00
' --dump-pages ' , ' --dump-intermediate-pages ' ,
2014-10-12 21:10:11 +00:00
action = ' store_true ' , dest = ' dump_intermediate_pages ' , default = False ,
2015-05-22 14:14:55 +00:00
help = ' Print downloaded pages encoded using base64 to debug problems (very verbose) ' )
2014-10-12 21:10:11 +00:00
verbosity . add_option (
' --write-pages ' ,
action = ' store_true ' , dest = ' write_pages ' , default = False ,
help = ' Write downloaded intermediary pages to files in the current directory to debug problems ' )
verbosity . add_option (
' --youtube-print-sig-code ' ,
action = ' store_true ' , dest = ' youtube_print_sig_code ' , default = False ,
help = optparse . SUPPRESS_HELP )
verbosity . add_option (
2015-02-10 03:52:33 +00:00
' --print-traffic ' , ' --dump-headers ' ,
2014-10-12 21:10:11 +00:00
dest = ' debug_printtraffic ' , action = ' store_true ' , default = False ,
help = ' Display sent and read HTTP traffic ' )
2015-01-10 20:02:27 +00:00
verbosity . add_option (
' -C ' , ' --call-home ' ,
dest = ' call_home ' , action = ' store_true ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Contact the youtube-dl server for debugging ' )
2015-01-10 20:09:15 +00:00
verbosity . add_option (
' --no-call-home ' ,
dest = ' call_home ' , action = ' store_false ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Do NOT contact the youtube-dl server for debugging ' )
2014-10-12 21:10:11 +00:00
filesystem = optparse . OptionGroup ( parser , ' Filesystem Options ' )
filesystem . add_option (
' -a ' , ' --batch-file ' ,
dest = ' batchfile ' , metavar = ' FILE ' ,
2018-03-27 15:25:29 +00:00
help = " File containing URLs to download ( ' - ' for stdin), one URL per line. "
" Lines starting with ' # ' , ' ; ' or ' ] ' are considered as comments and ignored. " )
2014-10-12 21:10:11 +00:00
filesystem . add_option (
' --id ' , default = False ,
2015-03-25 10:02:55 +00:00
action = ' store_true ' , dest = ' useid ' , help = ' Use only video ID in file name ' )
2014-10-12 21:10:11 +00:00
filesystem . add_option (
' -o ' , ' --output ' ,
dest = ' outtmpl ' , metavar = ' TEMPLATE ' ,
2016-08-18 16:59:13 +00:00
help = ( ' Output filename template, see the " OUTPUT TEMPLATE " for all the info ' ) )
2021-01-22 16:51:22 +00:00
filesystem . add_option (
' --output-na-placeholder ' ,
dest = ' outtmpl_na_placeholder ' , metavar = ' PLACEHOLDER ' , default = ' NA ' ,
help = ( ' Placeholder value for unavailable meta fields in output filename template (default is " %d efault " ) ' ) )
2014-10-12 21:10:11 +00:00
filesystem . add_option (
' --autonumber-size ' ,
2017-02-23 23:04:27 +00:00
dest = ' autonumber_size ' , metavar = ' NUMBER ' , type = int ,
help = optparse . SUPPRESS_HELP )
2016-05-01 12:34:11 +00:00
filesystem . add_option (
' --autonumber-start ' ,
2017-01-28 16:57:56 +00:00
dest = ' autonumber_start ' , metavar = ' NUMBER ' , default = 1 , type = int ,
help = ' Specify the start value for %(autonumber)s (default is %d efault) ' )
2014-10-12 21:10:11 +00:00
filesystem . add_option (
' --restrict-filenames ' ,
action = ' store_true ' , dest = ' restrictfilenames ' , default = False ,
help = ' Restrict filenames to only ASCII characters, and avoid " & " and spaces in filenames ' )
2014-12-12 16:11:53 +00:00
filesystem . add_option (
' -A ' , ' --auto-number ' ,
action = ' store_true ' , dest = ' autonumber ' , default = False ,
2017-02-23 23:04:27 +00:00
help = optparse . SUPPRESS_HELP )
2014-10-12 21:10:11 +00:00
filesystem . add_option (
' -t ' , ' --title ' ,
action = ' store_true ' , dest = ' usetitle ' , default = False ,
2017-02-23 23:04:27 +00:00
help = optparse . SUPPRESS_HELP )
2014-10-12 21:10:11 +00:00
filesystem . add_option (
' -l ' , ' --literal ' , default = False ,
action = ' store_true ' , dest = ' usetitle ' ,
2017-02-23 23:04:27 +00:00
help = optparse . SUPPRESS_HELP )
2014-10-12 21:10:11 +00:00
filesystem . add_option (
' -w ' , ' --no-overwrites ' ,
action = ' store_true ' , dest = ' nooverwrites ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Do not overwrite files ' )
2014-10-12 21:10:11 +00:00
filesystem . add_option (
' -c ' , ' --continue ' ,
action = ' store_true ' , dest = ' continue_dl ' , default = True ,
2015-03-25 10:02:55 +00:00
help = ' Force resume of partially downloaded files. By default, youtube-dl will resume downloads if possible. ' )
2014-10-12 21:10:11 +00:00
filesystem . add_option (
' --no-continue ' ,
action = ' store_false ' , dest = ' continue_dl ' ,
2015-03-25 10:02:55 +00:00
help = ' Do not resume partially downloaded files (restart from beginning) ' )
2014-10-12 21:10:11 +00:00
filesystem . add_option (
' --no-part ' ,
action = ' store_true ' , dest = ' nopart ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Do not use .part files - write directly into output file ' )
2014-10-12 21:10:11 +00:00
filesystem . add_option (
' --no-mtime ' ,
action = ' store_false ' , dest = ' updatetime ' , default = True ,
2015-03-25 10:02:55 +00:00
help = ' Do not use the Last-modified header to set the file modification time ' )
2014-10-12 21:10:11 +00:00
filesystem . add_option (
' --write-description ' ,
action = ' store_true ' , dest = ' writedescription ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Write video description to a .description file ' )
2014-10-12 21:10:11 +00:00
filesystem . add_option (
' --write-info-json ' ,
action = ' store_true ' , dest = ' writeinfojson ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Write video metadata to a .info.json file ' )
2014-10-12 21:10:11 +00:00
filesystem . add_option (
' --write-annotations ' ,
action = ' store_true ' , dest = ' writeannotations ' , default = False ,
2015-05-02 17:38:30 +00:00
help = ' Write video annotations to a .annotations.xml file ' )
2014-10-12 21:10:11 +00:00
filesystem . add_option (
2016-06-05 19:52:58 +00:00
' --load-info-json ' , ' --load-info ' ,
2014-10-12 21:10:11 +00:00
dest = ' load_info_filename ' , metavar = ' FILE ' ,
2015-04-04 14:09:11 +00:00
help = ' JSON file containing the video information (created with the " --write-info-json " option) ' )
2014-10-12 21:10:11 +00:00
filesystem . add_option (
' --cookies ' ,
dest = ' cookiefile ' , metavar = ' FILE ' ,
2015-03-25 10:02:55 +00:00
help = ' File to read cookies from and dump cookie jar in ' )
2014-09-13 05:55:21 +00:00
filesystem . add_option (
' --cache-dir ' , dest = ' cachedir ' , default = None , metavar = ' DIR ' ,
help = ' Location in the filesystem where youtube-dl can store some downloaded information permanently. By default $XDG_CACHE_HOME/youtube-dl or ~/.cache/youtube-dl . At the moment, only YouTube player files (for videos with obfuscated signatures) are cached, but that may change. ' )
filesystem . add_option (
' --no-cache-dir ' , action = ' store_const ' , const = False , dest = ' cachedir ' ,
help = ' Disable filesystem caching ' )
filesystem . add_option (
2014-10-12 21:10:11 +00:00
' --rm-cache-dir ' ,
action = ' store_true ' , dest = ' rm_cachedir ' ,
2014-09-13 05:55:21 +00:00
help = ' Delete all filesystem cache files ' )
2021-05-16 14:34:10 +00:00
thumbnail = optparse . OptionGroup ( parser , ' Thumbnail Options ' )
2015-01-25 01:38:47 +00:00
thumbnail . add_option (
' --write-thumbnail ' ,
action = ' store_true ' , dest = ' writethumbnail ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Write thumbnail image to disk ' )
2015-01-25 02:11:12 +00:00
thumbnail . add_option (
' --write-all-thumbnails ' ,
action = ' store_true ' , dest = ' write_all_thumbnails ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Write all thumbnail image formats to disk ' )
2015-01-25 01:38:47 +00:00
thumbnail . add_option (
' --list-thumbnails ' ,
action = ' store_true ' , dest = ' list_thumbnails ' , default = False ,
help = ' Simulate and list all available thumbnail formats ' )
2014-10-12 21:10:11 +00:00
postproc = optparse . OptionGroup ( parser , ' Post-processing Options ' )
postproc . add_option (
' -x ' , ' --extract-audio ' ,
action = ' store_true ' , dest = ' extractaudio ' , default = False ,
2021-01-22 17:00:53 +00:00
help = ' Convert video files to audio-only files (requires ffmpeg/avconv and ffprobe/avprobe) ' )
2014-10-12 21:10:11 +00:00
postproc . add_option (
' --audio-format ' , metavar = ' FORMAT ' , dest = ' audioformat ' , default = ' best ' ,
2017-03-16 11:54:47 +00:00
help = ' Specify audio format: " best " , " aac " , " flac " , " mp3 " , " m4a " , " opus " , " vorbis " , or " wav " ; " %d efault " by default; No effect without -x ' )
2014-10-12 21:10:11 +00:00
postproc . add_option (
' --audio-quality ' , metavar = ' QUALITY ' ,
dest = ' audioquality ' , default = ' 5 ' ,
2015-03-25 10:02:55 +00:00
help = ' Specify ffmpeg/avconv audio quality, insert a value between 0 (better) and 9 (worse) for VBR or a specific bitrate like 128K (default %d efault) ' )
2014-10-12 21:10:11 +00:00
postproc . add_option (
' --recode-video ' ,
metavar = ' FORMAT ' , dest = ' recodevideo ' , default = None ,
2015-07-11 16:15:16 +00:00
help = ' Encode the video to another format if necessary (currently supported: mp4|flv|ogg|webm|mkv|avi) ' )
2015-06-10 01:08:16 +00:00
postproc . add_option (
2015-06-30 19:22:09 +00:00
' --postprocessor-args ' ,
2015-07-11 16:15:16 +00:00
dest = ' postprocessor_args ' , metavar = ' ARGS ' ,
help = ' Give these arguments to the postprocessor ' )
2014-10-12 21:10:11 +00:00
postproc . add_option (
' -k ' , ' --keep-video ' ,
action = ' store_true ' , dest = ' keepvideo ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Keep the video file on disk after the post-processing; the video is erased by default ' )
2014-10-12 21:10:11 +00:00
postproc . add_option (
' --no-post-overwrites ' ,
action = ' store_true ' , dest = ' nopostoverwrites ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Do not overwrite post-processed files; the post-processed files are overwritten by default ' )
2014-10-12 21:10:11 +00:00
postproc . add_option (
' --embed-subs ' ,
action = ' store_true ' , dest = ' embedsubtitles ' , default = False ,
2016-03-19 22:12:34 +00:00
help = ' Embed subtitles in the video (only for mp4, webm and mkv videos) ' )
2014-10-12 21:10:11 +00:00
postproc . add_option (
' --embed-thumbnail ' ,
action = ' store_true ' , dest = ' embedthumbnail ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Embed thumbnail in the audio as cover art ' )
2014-10-12 21:10:11 +00:00
postproc . add_option (
' --add-metadata ' ,
action = ' store_true ' , dest = ' addmetadata ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Write metadata to the video file ' )
2015-03-04 21:33:56 +00:00
postproc . add_option (
' --metadata-from-title ' ,
metavar = ' FORMAT ' , dest = ' metafromtitle ' ,
2015-03-25 10:02:55 +00:00
help = ' Parse additional metadata like song title / artist from the video title. '
2017-05-13 17:03:15 +00:00
' The format syntax is the same as --output. Regular expression with '
' named capture groups may also be used. '
' The parsed parameters replace existing values. '
2017-05-14 00:33:24 +00:00
' Example: --metadata-from-title " %(artist)s - %(title)s " matches a title like '
2017-05-13 17:03:15 +00:00
' " Coldplay - Paradise " . '
' Example (regex): --metadata-from-title " (?P<artist>.+?) - (?P<title>.+) " ' )
2014-10-12 21:10:11 +00:00
postproc . add_option (
' --xattrs ' ,
action = ' store_true ' , dest = ' xattrs ' , default = False ,
2015-03-25 10:02:55 +00:00
help = ' Write metadata to the video file \' s xattrs (using dublin core and xdg standards) ' )
2015-01-10 04:45:51 +00:00
postproc . add_option (
' --fixup ' ,
metavar = ' POLICY ' , dest = ' fixup ' , default = ' detect_or_warn ' ,
2015-02-02 19:28:18 +00:00
help = ' Automatically correct known faults of the file. '
2015-01-10 04:45:51 +00:00
' One of never (do nothing), warn (only emit a warning), '
2015-06-14 20:57:07 +00:00
' detect_or_warn (the default; fix file if we can, warn otherwise) ' )
2014-10-12 21:10:11 +00:00
postproc . add_option (
' --prefer-avconv ' ,
action = ' store_false ' , dest = ' prefer_ffmpeg ' ,
2018-06-28 18:09:14 +00:00
help = ' Prefer avconv over ffmpeg for running the postprocessors ' )
2014-10-12 21:10:11 +00:00
postproc . add_option (
' --prefer-ffmpeg ' ,
action = ' store_true ' , dest = ' prefer_ffmpeg ' ,
2018-06-28 18:09:14 +00:00
help = ' Prefer ffmpeg over avconv for running the postprocessors (default) ' )
2015-02-13 10:14:01 +00:00
postproc . add_option (
' --ffmpeg-location ' , ' --avconv-location ' , metavar = ' PATH ' ,
dest = ' ffmpeg_location ' ,
help = ' Location of the ffmpeg/avconv binary; either the path to the binary or its containing directory. ' )
2014-09-13 05:55:21 +00:00
postproc . add_option (
2014-10-12 21:10:11 +00:00
' --exec ' ,
metavar = ' CMD ' , dest = ' exec_cmd ' ,
2020-04-23 19:31:38 +00:00
help = ' Execute a command on the file after downloading and post-processing, similar to find \' s -exec syntax. Example: --exec \' adb push {} /sdcard/Music/ && rm {} \' ' )
2015-02-28 13:43:24 +00:00
postproc . add_option (
2015-12-30 17:12:35 +00:00
' --convert-subs ' , ' --convert-subtitles ' ,
2015-02-28 13:43:24 +00:00
metavar = ' FORMAT ' , dest = ' convertsubtitles ' , default = None ,
2017-09-22 18:30:03 +00:00
help = ' Convert the subtitles to other format (currently supported: srt|ass|vtt|lrc) ' )
2014-09-13 05:55:21 +00:00
parser . add_option_group ( general )
2015-01-10 18:55:36 +00:00
parser . add_option_group ( network )
2017-02-18 20:58:17 +00:00
parser . add_option_group ( geo )
2014-09-13 05:55:21 +00:00
parser . add_option_group ( selection )
parser . add_option_group ( downloader )
parser . add_option_group ( filesystem )
2015-01-25 01:38:47 +00:00
parser . add_option_group ( thumbnail )
2014-09-13 05:55:21 +00:00
parser . add_option_group ( verbosity )
parser . add_option_group ( workarounds )
parser . add_option_group ( video_format )
parser . add_option_group ( subtitles )
parser . add_option_group ( authentication )
2016-09-15 15:18:31 +00:00
parser . add_option_group ( adobe_pass )
2014-09-13 05:55:21 +00:00
parser . add_option_group ( postproc )
if overrideArguments is not None :
opts , args = parser . parse_args ( overrideArguments )
if opts . verbose :
2014-10-12 21:10:11 +00:00
write_string ( ' [debug] Override config: ' + repr ( overrideArguments ) + ' \n ' )
2014-09-13 05:55:21 +00:00
else :
2015-04-11 21:57:56 +00:00
def compat_conf ( conf ) :
if sys . version_info < ( 3 , ) :
return [ a . decode ( preferredencoding ( ) , ' replace ' ) for a in conf ]
return conf
command_line_conf = compat_conf ( sys . argv [ 1 : ] )
2016-09-14 15:28:17 +00:00
opts , args = parser . parse_args ( command_line_conf )
2015-03-24 15:39:46 +00:00
2016-12-31 16:41:37 +00:00
system_conf = user_conf = custom_conf = [ ]
if ' --config-location ' in command_line_conf :
location = compat_expanduser ( opts . config_location )
if os . path . isdir ( location ) :
location = os . path . join ( location , ' youtube-dl.conf ' )
if not os . path . exists ( location ) :
parser . error ( ' config-location %s does not exist. ' % location )
custom_conf = _readOptions ( location )
elif ' --ignore-config ' in command_line_conf :
pass
2014-09-13 05:55:21 +00:00
else :
2016-07-07 17:40:58 +00:00
system_conf = _readOptions ( ' /etc/youtube-dl.conf ' )
2016-12-31 16:41:37 +00:00
if ' --ignore-config ' not in system_conf :
2016-07-07 17:40:58 +00:00
user_conf = _readUserConf ( )
2016-09-14 15:28:17 +00:00
2017-01-16 15:07:12 +00:00
argv = system_conf + user_conf + custom_conf + command_line_conf
2014-09-13 05:55:21 +00:00
opts , args = parser . parse_args ( argv )
if opts . verbose :
2016-12-31 16:41:37 +00:00
for conf_label , conf in (
( ' System config ' , system_conf ) ,
( ' User config ' , user_conf ) ,
( ' Custom config ' , custom_conf ) ,
( ' Command-line args ' , command_line_conf ) ) :
write_string ( ' [debug] %s : %s \n ' % ( conf_label , repr ( _hide_login_info ( conf ) ) ) )
2014-09-13 05:55:21 +00:00
return parser , opts , args