2014-09-13 07:58:44 +02:00
from __future__ import unicode_literals
2014-09-13 07:55:21 +02:00
import os . path
import optparse
2016-08-02 17:03:26 +02:00
import re
2014-09-13 07:55:21 +02:00
import sys
2015-01-24 01:38:48 +01:00
from . downloader . external import list_external_downloaders
2014-11-02 11:23:40 +01:00
from . compat import (
2014-09-30 17:27:53 +02:00
compat_expanduser ,
2015-02-28 21:42:16 +01:00
compat_get_terminal_size ,
2014-09-30 17:27:53 +02:00
compat_getenv ,
2014-11-15 15:17:19 +01:00
compat_kwargs ,
2015-09-05 17:42:41 +02:00
compat_shlex_split ,
2014-11-02 11:23:40 +01:00
)
from . utils import (
2015-04-03 20:30:37 +02:00
preferredencoding ,
2014-09-13 07:55:21 +02:00
write_string ,
)
from . version import __version__
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 :
2016-07-09 02:12:52 +02:00
# FIXME: https://github.com/rg3/youtube-dl/commit/dfe5fa49aed02cf36ba9f743b11b0903554b5e56
contents = optionf . read ( )
if sys . version_info < ( 3 , ) :
contents = contents . decode ( preferredencoding ( ) )
res = compat_shlex_split ( contents , comments = True )
2014-09-13 07:55:21 +02:00
finally :
optionf . close ( )
return res
def _readUserConf ( ) :
2014-09-30 17:27:53 +02:00
xdg_config_home = compat_getenv ( ' XDG_CONFIG_HOME ' )
2014-09-13 07:55:21 +02: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 17:27:53 +02:00
userConfFile = os . path . join ( compat_expanduser ( ' ~ ' ) , ' .config ' , ' youtube-dl ' , ' config ' )
2014-09-13 07:55:21 +02:00
if not os . path . isfile ( userConfFile ) :
2014-09-30 17:27:53 +02:00
userConfFile = os . path . join ( compat_expanduser ( ' ~ ' ) , ' .config ' , ' youtube-dl.conf ' )
2014-09-13 07:55:21 +02:00
userConf = _readOptions ( userConfFile , None )
if userConf is None :
2014-09-30 17:27:53 +02:00
appdata_dir = compat_getenv ( ' appdata ' )
2014-09-13 07:55:21 +02: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 17:27:53 +02:00
os . path . join ( compat_expanduser ( ' ~ ' ) , ' youtube-dl.conf ' ) ,
2014-09-13 07:55:21 +02:00
default = None )
if userConf is None :
userConf = _readOptions (
2014-09-30 17:27:53 +02:00
os . path . join ( compat_expanduser ( ' ~ ' ) , ' youtube-dl.conf.txt ' ) ,
2014-09-13 07:55:21 +02: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 23:10:11 +02:00
if option . takes_value ( ) :
opts . append ( ' %s ' % option . metavar )
2014-09-13 07:55:21 +02:00
2016-02-14 10:37:17 +01:00
return ' ' . join ( opts )
2014-09-13 07:55:21 +02:00
def _comma_separated_values_options_callback ( option , opt_str , value , parser ) :
setattr ( parser . values , option . dest , value . split ( ' , ' ) )
def _hide_login_info ( opts ) :
2016-09-13 23:16:01 +02:00
PRIVATE_OPTS = [ ' -p ' , ' --password ' , ' -u ' , ' --username ' , ' --video-password ' , ' --ap-password ' , ' --ap-username ' ]
2016-08-02 17:03:26 +02:00
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 private_opt in PRIVATE_OPTS :
2014-09-13 07:55:21 +02:00
try :
i = opts . index ( private_opt )
2014-10-12 23:10:11 +02:00
opts [ i + 1 ] = ' PRIVATE '
2014-09-13 07:55:21 +02:00
except ValueError :
pass
return opts
# No need to wrap help messages if we're on a wide console
2015-02-28 21:42:16 +01:00
columns = compat_get_terminal_size ( ) . columns
2014-10-12 23:10:11 +02:00
max_width = columns if columns else 80
max_help_position = 80
2014-09-13 07:55:21 +02:00
fmt = optparse . IndentedHelpFormatter ( width = max_width , max_help_position = max_help_position )
fmt . format_option_strings = _format_option_string
kw = {
2014-10-12 23:10:11 +02:00
' version ' : __version__ ,
' formatter ' : fmt ,
2015-01-01 22:01:26 +01:00
' usage ' : ' % prog [OPTIONS] URL [URL...] ' ,
2014-10-12 23:10:11 +02:00
' conflict_handler ' : ' resolve ' ,
2014-09-13 07:55:21 +02:00
}
2014-11-15 15:17:19 +01:00
parser = optparse . OptionParser ( * * compat_kwargs ( kw ) )
2014-09-13 07:55:21 +02:00
2014-10-12 23:10:11 +02:00
general = optparse . OptionGroup ( parser , ' General Options ' )
general . add_option (
' -h ' , ' --help ' ,
action = ' help ' ,
2015-03-25 11:02:55 +01:00
help = ' Print this help text and exit ' )
2014-10-12 23:10:11 +02:00
general . add_option (
' -v ' , ' --version ' ,
action = ' version ' ,
2015-03-25 11:02:55 +01:00
help = ' Print program version and exit ' )
2014-10-12 23:10:11 +02:00
general . add_option (
' -U ' , ' --update ' ,
action = ' store_true ' , dest = ' update_self ' ,
2015-03-25 11:02:55 +01:00
help = ' Update this program to latest version. Make sure that you have sufficient permissions (run with sudo if needed) ' )
2014-10-12 23:10:11 +02:00
general . add_option (
' -i ' , ' --ignore-errors ' ,
action = ' store_true ' , dest = ' ignoreerrors ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Continue on download errors, for example to skip unavailable videos in a playlist ' )
2014-10-12 23:10:11 +02: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 11:02:55 +01:00
help = ' Display the current browser identification ' )
2014-09-13 07:55:21 +02:00
general . add_option (
2014-10-12 23:10:11 +02:00
' --list-extractors ' ,
action = ' store_true ' , dest = ' list_extractors ' , default = False ,
2015-06-07 04:12:21 +02:00
help = ' List all supported extractors ' )
2014-10-12 23:10:11 +02: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 15:20:12 +02: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 07:55:21 +02:00
general . add_option (
' --default-search ' ,
dest = ' default_search ' , metavar = ' PREFIX ' ,
2015-03-25 11:02:55 +01: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 07:55:21 +02:00
general . add_option (
' --ignore-config ' ,
action = ' store_true ' ,
2014-12-04 07:57:18 +01: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) ' )
2014-10-24 14:48:12 +02: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 20:01:33 +01:00
general . add_option (
' --mark-watched ' ,
action = ' store_true ' , dest = ' mark_watched ' , default = False ,
help = ' Mark videos watched (YouTube only) ' )
2016-03-01 18:41:23 +01: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 04:22:10 +01:00
general . add_option (
' --no-color ' , ' --no-colors ' ,
action = ' store_true ' , dest = ' no_color ' ,
default = False ,
2015-03-25 11:02:55 +01:00
help = ' Do not emit color codes in output ' )
2014-09-13 07:55:21 +02:00
2015-01-10 19:55:36 +01:00
network = optparse . OptionGroup ( parser , ' Network Options ' )
network . add_option (
' --proxy ' , dest = ' proxy ' ,
default = None , metavar = ' URL ' ,
2016-05-08 09:15:58 +02:00
help = ' Use the specified HTTP/HTTPS/SOCKS proxy. To enable experimental '
' 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 19:55:36 +01: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 ,
help = ' Client-side IP address to bind to (experimental) ' ,
)
2015-01-10 20:02:02 +01:00
network . add_option (
' -4 ' , ' --force-ipv4 ' ,
action = ' store_const ' , const = ' 0.0.0.0 ' , dest = ' source_address ' ,
help = ' Make all connections via IPv4 (experimental) ' ,
)
network . add_option (
' -6 ' , ' --force-ipv6 ' ,
action = ' store_const ' , const = ' :: ' , dest = ' source_address ' ,
help = ' Make all connections via IPv6 (experimental) ' ,
)
2016-07-03 17:23:48 +02:00
network . add_option (
' --geo-verification-proxy ' ,
dest = ' g eo_verification_proxy ' , default = None , metavar = ' URL ' ,
help = ' Use this proxy to verify the IP address for some geo-restricted sites. '
' The default proxy specified by --proxy (or none, if the options is not present) is used for the actual downloading. (experimental) '
)
2015-03-03 00:03:06 +01:00
network . add_option (
' --cn-verification-proxy ' ,
dest = ' cn_verification_proxy ' , default = None , metavar = ' URL ' ,
2016-07-03 17:23:48 +02:00
help = optparse . SUPPRESS_HELP ,
2015-03-03 00:03:06 +01:00
)
2015-01-10 19:55:36 +01:00
2014-10-12 23:10:11 +02:00
selection = optparse . OptionGroup ( parser , ' Video Selection ' )
2014-09-13 07:55:21 +02:00
selection . add_option (
' --playlist-start ' ,
dest = ' playliststart ' , metavar = ' NUMBER ' , default = 1 , type = int ,
2015-03-25 11:02:55 +01:00
help = ' Playlist video to start at (default is %d efault) ' )
2014-09-13 07:55:21 +02:00
selection . add_option (
' --playlist-end ' ,
dest = ' playlistend ' , metavar = ' NUMBER ' , default = None , type = int ,
2015-03-25 11:02:55 +01:00
help = ' Playlist video to end at (default is last) ' )
2015-01-25 04:24:55 +01:00
selection . add_option (
' --playlist-items ' ,
dest = ' playlist_items ' , metavar = ' ITEM_SPEC ' , default = None ,
2015-07-21 05:11:23 +02: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 07:55:21 +02:00
selection . add_option (
2014-10-12 23:10:11 +02:00
' --match-title ' ,
dest = ' matchtitle ' , metavar = ' REGEX ' ,
2015-03-25 11:02:55 +01:00
help = ' Download only matching titles (regex or caseless sub-string) ' )
2014-10-12 23:10:11 +02:00
selection . add_option (
' --reject-title ' ,
dest = ' rejecttitle ' , metavar = ' REGEX ' ,
2015-03-25 11:02:55 +01:00
help = ' Skip download for matching titles (regex or caseless sub-string) ' )
2014-10-12 23:10:11 +02: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 11:02:55 +01:00
help = ' Download only videos uploaded in this date ' )
2014-10-12 23:10:11 +02:00
selection . add_option (
' --datebefore ' ,
metavar = ' DATE ' , dest = ' datebefore ' , default = None ,
2015-03-25 11:02:55 +01:00
help = ' Download only videos uploaded on or before this date (i.e. inclusive) ' )
2014-09-13 07:55:21 +02:00
selection . add_option (
2014-10-12 23:10:11 +02:00
' --dateafter ' ,
metavar = ' DATE ' , dest = ' dateafter ' , default = None ,
2015-03-25 11:02:55 +01:00
help = ' Download only videos uploaded on or after this date (i.e. inclusive) ' )
2014-09-13 07:55:21 +02:00
selection . add_option (
2014-10-12 23:10:11 +02:00
' --min-views ' ,
metavar = ' COUNT ' , dest = ' min_views ' , default = None , type = int ,
2015-03-25 11:02:55 +01:00
help = ' Do not download any videos with less than COUNT views ' )
2014-09-13 07:55:21 +02:00
selection . add_option (
2014-10-12 23:10:11 +02: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 03:32:21 +01:00
selection . add_option (
' --match-filter ' ,
metavar = ' FILTER ' , dest = ' match_filter ' , default = None ,
help = (
2015-03-25 11:02:55 +01:00
' Generic video filter (experimental). '
2015-02-10 03:32:21 +01:00
' Specify any key (see help for -o for a list of available keys) to '
' match if the key is present, '
' !key to check if the key is not present, '
' key > NUMBER (like " comment_count > 12 " , also works with '
' >=, <, <=, !=, =) to compare against a number, and '
' & to require multiple matches. '
' Values which are not known are excluded unless you '
' put a question mark (?) after the operator. '
' For example, to only match videos that have been liked more than '
' 100 times and disliked less than 50 times (or the dislike '
' functionality is not available at the given service), but who '
2015-09-13 14:00:10 +02:00
' also have a description, use --match-filter '
2015-02-10 03:32:21 +01:00
' " like_count > 100 & dislike_count <? 50 & description " . '
) )
2014-09-13 07:55:21 +02:00
selection . add_option (
2014-10-12 23:10:11 +02:00
' --no-playlist ' ,
action = ' store_true ' , dest = ' noplaylist ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Download only the video, if the URL refers to a video and a playlist. ' )
2015-02-24 17:25:02 +01:00
selection . add_option (
' --yes-playlist ' ,
action = ' store_false ' , dest = ' noplaylist ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Download the playlist, if the URL refers to a video and a playlist. ' )
2014-10-12 23:10:11 +02:00
selection . add_option (
' --age-limit ' ,
metavar = ' YEARS ' , dest = ' age_limit ' , default = None , type = int ,
2015-03-25 11:02:55 +01:00
help = ' Download only videos suitable for the given age ' )
2014-10-12 23:10:11 +02: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 07:55:21 +02:00
help = ' Download advertisements as well (experimental) ' )
2014-10-12 23:10:11 +02:00
authentication = optparse . OptionGroup ( parser , ' Authentication Options ' )
authentication . add_option (
' -u ' , ' --username ' ,
dest = ' username ' , metavar = ' USERNAME ' ,
2015-03-25 11:02:55 +01:00
help = ' Login with this account ID ' )
2014-10-12 23:10:11 +02:00
authentication . add_option (
' -p ' , ' --password ' ,
dest = ' password ' , metavar = ' PASSWORD ' ,
2015-03-25 11:02:55 +01:00
help = ' Account password. If this option is left out, youtube-dl will ask interactively. ' )
2014-10-12 23:10:11 +02:00
authentication . add_option (
' -2 ' , ' --twofactor ' ,
dest = ' twofactor ' , metavar = ' TWOFACTOR ' ,
2015-03-25 11:02:55 +01:00
help = ' Two-factor auth code ' )
2014-10-12 23:10:11 +02:00
authentication . add_option (
' -n ' , ' --netrc ' ,
action = ' store_true ' , dest = ' usenetrc ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Use .netrc authentication data ' )
2014-10-12 23:10:11 +02:00
authentication . add_option (
' --video-password ' ,
dest = ' videopassword ' , metavar = ' PASSWORD ' ,
2015-09-01 18:30:28 +02:00
help = ' Video password (vimeo, smotri, youku) ' )
2016-09-13 23:16:01 +02:00
adobe_pass = optparse . OptionGroup ( parser , ' Adobe Pass Options ' )
adobe_pass . add_option (
2016-09-14 19:58:47 +02:00
' --ap-mso ' ,
dest = ' ap_mso ' , metavar = ' MSO ' ,
2016-09-15 17:17:17 +02:00
help = ' Adobe Pass multiple-system operator (TV provider) identifier, use --ap-list-mso for a list of available MSOs ' )
2016-09-13 23:16:01 +02:00
adobe_pass . add_option (
' --ap-username ' ,
2016-09-14 19:58:47 +02:00
dest = ' ap_username ' , metavar = ' USERNAME ' ,
2016-09-15 17:17:17 +02:00
help = ' Multiple-system operator account login ' )
2016-09-13 23:16:01 +02:00
adobe_pass . add_option (
' --ap-password ' ,
2016-09-14 19:58:47 +02:00
dest = ' ap_password ' , metavar = ' PASSWORD ' ,
2016-09-15 17:17:17 +02:00
help = ' Multiple-system operator account password. If this option is left out, youtube-dl will ask interactively. ' )
2016-09-13 23:16:01 +02:00
adobe_pass . add_option (
2016-09-14 21:21:09 +02:00
' --ap-list-mso ' ,
action = ' store_true ' , dest = ' ap_list_mso ' , default = False ,
2016-09-15 17:17:17 +02:00
help = ' List all supported multiple-system operators ' )
2014-10-12 23:10:11 +02: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 18:37:38 +02:00
help = ' Video format code, see the " FORMAT SELECTION " for all the info ' )
2014-10-12 23:10:11 +02:00
video_format . add_option (
' --all-formats ' ,
action = ' store_const ' , dest = ' format ' , const = ' all ' ,
2015-03-25 11:02:55 +01:00
help = ' Download all available video formats ' )
2014-10-12 23:10:11 +02:00
video_format . add_option (
' --prefer-free-formats ' ,
action = ' store_true ' , dest = ' prefer_free_formats ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Prefer free video formats unless a specific one is requested ' )
2014-10-12 23:10:11 +02:00
video_format . add_option (
' -F ' , ' --list-formats ' ,
action = ' store_true ' , dest = ' listformats ' ,
2015-11-28 07:14:20 +01:00
help = ' List all available formats of requested videos ' )
2014-10-13 00:03:08 +02: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 10:38:41 +02:00
help = ' Do not download the DASH manifests and related data on YouTube videos ' )
2015-01-09 23:03:56 +01:00
video_format . add_option (
2015-01-10 02:03:00 +01:00
' --merge-output-format ' ,
action = ' store ' , dest = ' merge_output_format ' , metavar = ' FORMAT ' , default = None ,
2015-01-09 23:03:56 +01:00
help = (
2015-06-27 10:26:51 +02: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 23:03:56 +01:00
' Ignored if no merge is required ' ) )
2014-10-12 23:10:11 +02:00
subtitles = optparse . OptionGroup ( parser , ' Subtitle Options ' )
subtitles . add_option (
' --write-sub ' , ' --write-srt ' ,
action = ' store_true ' , dest = ' writesubtitles ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Write subtitle file ' )
2014-10-12 23:10:11 +02:00
subtitles . add_option (
' --write-auto-sub ' , ' --write-automatic-sub ' ,
action = ' store_true ' , dest = ' writeautomaticsub ' , default = False ,
2015-11-16 15:15:25 +01:00
help = ' Write automatically generated subtitle file (YouTube only) ' )
2014-10-12 23:10:11 +02:00
subtitles . add_option (
' --all-subs ' ,
action = ' store_true ' , dest = ' allsubtitles ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Download all the available subtitles of the video ' )
2014-10-12 23:10:11 +02:00
subtitles . add_option (
' --list-subs ' ,
action = ' store_true ' , dest = ' listsubtitles ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' List all available subtitles for the video ' )
2014-10-12 23:10:11 +02:00
subtitles . add_option (
' --sub-format ' ,
2015-02-15 18:03:41 +01:00
action = ' store ' , dest = ' subtitlesformat ' , metavar = ' FORMAT ' , default = ' best ' ,
2015-04-04 16:00:23 +02:00
help = ' Subtitle format, accepts formats preference, for example: " srt " or " ass/srt/best " ' )
2014-10-12 23:10:11 +02: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 20:50:06 +01:00
help = ' Languages of the subtitles to download (optional) separated by commas, use --list-subs for available language tags ' )
2014-10-12 23:10:11 +02:00
downloader = optparse . OptionGroup ( parser , ' Download Options ' )
downloader . add_option (
2016-05-30 16:48:35 +02:00
' -r ' , ' --limit-rate ' , ' --rate-limit ' ,
dest = ' ratelimit ' , metavar = ' RATE ' ,
2015-03-25 11:02:55 +01:00
help = ' Maximum download rate in bytes per second (e.g. 50K or 4.2M) ' )
2014-10-12 23:10:11 +02:00
downloader . add_option (
' -R ' , ' --retries ' ,
dest = ' retries ' , metavar = ' RETRIES ' , default = 10 ,
2015-03-25 11:02:55 +01:00
help = ' Number of retries (default is %d efault), or " infinite " . ' )
2016-03-19 15:40:36 +01:00
downloader . add_option (
' --fragment-retries ' ,
dest = ' fragment_retries ' , metavar = ' RETRIES ' , default = 10 ,
2016-08-26 23:52:18 +02:00
help = ' Number of retries for a fragment (default is %d efault), or " infinite " (DASH and hlsnative only) ' )
downloader . add_option (
' --skip-unavailable-fragments ' ,
action = ' store_true ' , dest = ' skip_unavailable_fragments ' , default = True ,
help = ' Skip unavailable fragments (DASH and hlsnative only) ' )
general . add_option (
' --abort-on-unavailable-fragment ' ,
action = ' store_false ' , dest = ' skip_unavailable_fragments ' ,
help = ' Abort downloading when some fragment is not available ' )
2014-10-12 23:10:11 +02:00
downloader . add_option (
' --buffer-size ' ,
dest = ' buffersize ' , metavar = ' SIZE ' , default = ' 1024 ' ,
2015-03-25 11:02:55 +01:00
help = ' Size of download buffer (e.g. 1024 or 16K) (default is %d efault) ' )
2014-10-12 23:10:11 +02:00
downloader . add_option (
' --no-resize-buffer ' ,
action = ' store_true ' , dest = ' noresizebuffer ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Do not automatically adjust the buffer size. By default, the buffer size is automatically resized from an initial value of SIZE. ' )
2014-10-12 23:10:11 +02:00
downloader . add_option (
' --test ' ,
action = ' store_true ' , dest = ' test ' , default = False ,
help = optparse . SUPPRESS_HELP )
2014-07-11 05:11:11 +02:00
downloader . add_option (
' --playlist-reverse ' ,
action = ' store_true ' ,
help = ' Download playlist videos in reverse order ' )
2015-01-25 04:49:44 +01:00
downloader . add_option (
' --xattr-set-filesize ' ,
dest = ' xattr_set_filesize ' , action = ' store_true ' ,
2015-03-25 11:02:55 +01:00
help = ' Set file xattribute ytdl.filesize with expected filesize (experimental) ' )
2015-02-17 12:09:12 +01:00
downloader . add_option (
' --hls-prefer-native ' ,
2016-04-21 19:02:17 +02:00
dest = ' hls_prefer_native ' , action = ' store_true ' , default = None ,
2016-04-21 18:44:01 +02:00
help = ' Use the native HLS downloader instead of ffmpeg ' )
2016-04-21 19:02:17 +02: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 12:26:40 +01: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 13:44:22 +01:00
' video while downloading (some players may not be able to play it) ' )
2015-01-24 01:38:48 +01:00
downloader . add_option (
' --external-downloader ' ,
dest = ' external_downloader ' , metavar = ' COMMAND ' ,
2015-03-02 15:06:09 +01:00
help = ' Use the specified external downloader. '
2015-01-24 01:38:48 +01:00
' Currently supports %s ' % ' , ' . join ( list_external_downloaders ( ) ) )
2015-03-02 15:06:09 +01:00
downloader . add_option (
' --external-downloader-args ' ,
dest = ' external_downloader_args ' , metavar = ' ARGS ' ,
2015-03-25 11:02:55 +01:00
help = ' Give these arguments to the external downloader ' )
2014-10-12 23:10:11 +02:00
workarounds = optparse . OptionGroup ( parser , ' Workarounds ' )
2014-09-13 07:55:21 +02:00
workarounds . add_option (
2014-10-12 23:10:11 +02:00
' --encoding ' ,
dest = ' encoding ' , metavar = ' ENCODING ' ,
2014-09-13 07:55:21 +02:00
help = ' Force the specified encoding (experimental) ' )
workarounds . add_option (
2014-10-12 23:10:11 +02:00
' --no-check-certificate ' ,
action = ' store_true ' , dest = ' no_check_certificate ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Suppress HTTPS certificate validation ' )
2014-09-13 07:55:21 +02:00
workarounds . add_option (
2014-10-12 23:10:11 +02:00
' --prefer-insecure ' ,
' --prefer-unsecure ' , action = ' store_true ' , dest = ' prefer_insecure ' ,
2014-09-13 07:55:21 +02:00
help = ' Use an unencrypted connection to retrieve information about the video. (Currently supported only for YouTube) ' )
workarounds . add_option (
2014-10-12 23:10:11 +02:00
' --user-agent ' ,
metavar = ' UA ' , dest = ' user_agent ' ,
2015-03-25 11:02:55 +01:00
help = ' Specify a custom user agent ' )
2014-09-13 07:55:21 +02:00
workarounds . add_option (
2014-10-12 23:10:11 +02:00
' --referer ' ,
metavar = ' URL ' , dest = ' referer ' , default = None ,
2015-03-25 11:02:55 +01:00
help = ' Specify a custom referer, use if the video access is restricted to one domain ' ,
2014-09-13 07:55:21 +02:00
)
workarounds . add_option (
2014-10-12 23:10:11 +02:00
' --add-header ' ,
metavar = ' FIELD:VALUE ' , dest = ' headers ' , action = ' append ' ,
2015-03-25 11:02:55 +01:00
help = ' Specify a custom HTTP header and its value, separated by a colon \' : \' . You can use this option multiple times ' ,
2014-09-13 07:55:21 +02:00
)
workarounds . add_option (
2014-10-12 23:10:11 +02: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 12:05:01 +01:00
workarounds . add_option (
2016-08-04 12:17:22 +02:00
' --sleep-interval ' , ' --min-sleep-interval ' , metavar = ' SECONDS ' ,
2015-01-23 12:07:13 +01:00
dest = ' sleep_interval ' , type = float ,
2016-08-08 22:46:52 +02: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 12:17:22 +02:00
workarounds . add_option (
' --max-sleep-interval ' , metavar = ' SECONDS ' ,
dest = ' max_sleep_interval ' , type = float ,
2016-08-08 22:46:52 +02: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 07:55:21 +02:00
2014-10-12 23:10:11 +02:00
verbosity = optparse . OptionGroup ( parser , ' Verbosity / Simulation Options ' )
verbosity . add_option (
' -q ' , ' --quiet ' ,
action = ' store_true ' , dest = ' quiet ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Activate quiet mode ' )
2014-09-13 07:55:21 +02:00
verbosity . add_option (
' --no-warnings ' ,
dest = ' no_warnings ' , action = ' store_true ' , default = False ,
help = ' Ignore warnings ' )
2014-10-12 23:10:11 +02:00
verbosity . add_option (
' -s ' , ' --simulate ' ,
action = ' store_true ' , dest = ' simulate ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Do not download the video and do not write anything to disk ' )
2014-10-12 23:10:11 +02:00
verbosity . add_option (
' --skip-download ' ,
action = ' store_true ' , dest = ' skip_download ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Do not download the video ' )
2014-10-12 23:10:11 +02:00
verbosity . add_option (
' -g ' , ' --get-url ' ,
action = ' store_true ' , dest = ' geturl ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Simulate, quiet but print URL ' )
2014-10-12 23:10:11 +02:00
verbosity . add_option (
' -e ' , ' --get-title ' ,
action = ' store_true ' , dest = ' gettitle ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Simulate, quiet but print title ' )
2014-10-12 23:10:11 +02:00
verbosity . add_option (
' --get-id ' ,
action = ' store_true ' , dest = ' getid ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Simulate, quiet but print id ' )
2014-10-12 23:10:11 +02:00
verbosity . add_option (
' --get-thumbnail ' ,
action = ' store_true ' , dest = ' getthumbnail ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Simulate, quiet but print thumbnail URL ' )
2014-10-12 23:10:11 +02:00
verbosity . add_option (
' --get-description ' ,
action = ' store_true ' , dest = ' getdescription ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Simulate, quiet but print video description ' )
2014-10-12 23:10:11 +02:00
verbosity . add_option (
' --get-duration ' ,
action = ' store_true ' , dest = ' getduration ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Simulate, quiet but print video length ' )
2014-10-12 23:10:11 +02:00
verbosity . add_option (
' --get-filename ' ,
action = ' store_true ' , dest = ' getfilename ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Simulate, quiet but print output filename ' )
2014-10-12 23:10:11 +02:00
verbosity . add_option (
' --get-format ' ,
action = ' store_true ' , dest = ' getformat ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Simulate, quiet but print output format ' )
2014-10-12 23:10:11 +02:00
verbosity . add_option (
' -j ' , ' --dump-json ' ,
action = ' store_true ' , dest = ' dumpjson ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Simulate, quiet but print JSON information. See --output for a description of available keys. ' )
2014-10-25 00:30:57 +02:00
verbosity . add_option (
' -J ' , ' --dump-single-json ' ,
action = ' store_true ' , dest = ' dump_single_json ' , default = False ,
2015-03-25 11:02:55 +01: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 18:01:41 +01: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 23:10:11 +02:00
verbosity . add_option (
' --newline ' ,
action = ' store_true ' , dest = ' progress_with_newline ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Output progress bar as new lines ' )
2014-10-12 23:10:11 +02:00
verbosity . add_option (
' --no-progress ' ,
action = ' store_true ' , dest = ' noprogress ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Do not print progress bar ' )
2014-10-12 23:10:11 +02:00
verbosity . add_option (
' --console-title ' ,
action = ' store_true ' , dest = ' consoletitle ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Display progress in console titlebar ' )
2014-10-12 23:10:11 +02:00
verbosity . add_option (
' -v ' , ' --verbose ' ,
action = ' store_true ' , dest = ' verbose ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Print various debugging information ' )
2014-10-12 23:10:11 +02:00
verbosity . add_option (
2015-03-08 18:37:43 +01:00
' --dump-pages ' , ' --dump-intermediate-pages ' ,
2014-10-12 23:10:11 +02:00
action = ' store_true ' , dest = ' dump_intermediate_pages ' , default = False ,
2015-05-22 16:14:55 +02:00
help = ' Print downloaded pages encoded using base64 to debug problems (very verbose) ' )
2014-10-12 23:10:11 +02: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 04:52:33 +01:00
' --print-traffic ' , ' --dump-headers ' ,
2014-10-12 23:10:11 +02:00
dest = ' debug_printtraffic ' , action = ' store_true ' , default = False ,
help = ' Display sent and read HTTP traffic ' )
2015-01-10 21:02:27 +01:00
verbosity . add_option (
' -C ' , ' --call-home ' ,
dest = ' call_home ' , action = ' store_true ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Contact the youtube-dl server for debugging ' )
2015-01-10 21:09:15 +01:00
verbosity . add_option (
' --no-call-home ' ,
dest = ' call_home ' , action = ' store_false ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Do NOT contact the youtube-dl server for debugging ' )
2014-10-12 23:10:11 +02:00
filesystem = optparse . OptionGroup ( parser , ' Filesystem Options ' )
filesystem . add_option (
' -a ' , ' --batch-file ' ,
dest = ' batchfile ' , metavar = ' FILE ' ,
2015-03-25 11:02:55 +01:00
help = ' File containing URLs to download ( \' - \' for stdin) ' )
2014-10-12 23:10:11 +02:00
filesystem . add_option (
' --id ' , default = False ,
2015-03-25 11:02:55 +01:00
action = ' store_true ' , dest = ' useid ' , help = ' Use only video ID in file name ' )
2014-10-12 23:10:11 +02:00
filesystem . add_option (
' -o ' , ' --output ' ,
dest = ' outtmpl ' , metavar = ' TEMPLATE ' ,
2016-08-18 18:59:13 +02:00
help = ( ' Output filename template, see the " OUTPUT TEMPLATE " for all the info ' ) )
2014-10-12 23:10:11 +02:00
filesystem . add_option (
' --autonumber-size ' ,
dest = ' autonumber_size ' , metavar = ' NUMBER ' ,
2015-03-25 11:02:55 +01:00
help = ' Specify the number of digits in %(autonumber)s when it is present in output filename template or --auto-number option is given ' )
2014-10-12 23:10:11 +02: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 17:11:53 +01:00
filesystem . add_option (
' -A ' , ' --auto-number ' ,
action = ' store_true ' , dest = ' autonumber ' , default = False ,
2015-09-13 14:00:10 +02:00
help = ' [deprecated; use -o " %(autonumber)s - %(title)s . %(ext)s " ] Number downloaded files starting from 00000 ' )
2014-10-12 23:10:11 +02:00
filesystem . add_option (
' -t ' , ' --title ' ,
action = ' store_true ' , dest = ' usetitle ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' [deprecated] Use title in file name (default) ' )
2014-10-12 23:10:11 +02:00
filesystem . add_option (
' -l ' , ' --literal ' , default = False ,
action = ' store_true ' , dest = ' usetitle ' ,
2015-03-25 11:02:55 +01:00
help = ' [deprecated] Alias of --title ' )
2014-10-12 23:10:11 +02:00
filesystem . add_option (
' -w ' , ' --no-overwrites ' ,
action = ' store_true ' , dest = ' nooverwrites ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Do not overwrite files ' )
2014-10-12 23:10:11 +02:00
filesystem . add_option (
' -c ' , ' --continue ' ,
action = ' store_true ' , dest = ' continue_dl ' , default = True ,
2015-03-25 11:02:55 +01:00
help = ' Force resume of partially downloaded files. By default, youtube-dl will resume downloads if possible. ' )
2014-10-12 23:10:11 +02:00
filesystem . add_option (
' --no-continue ' ,
action = ' store_false ' , dest = ' continue_dl ' ,
2015-03-25 11:02:55 +01:00
help = ' Do not resume partially downloaded files (restart from beginning) ' )
2014-10-12 23:10:11 +02:00
filesystem . add_option (
' --no-part ' ,
action = ' store_true ' , dest = ' nopart ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Do not use .part files - write directly into output file ' )
2014-10-12 23:10:11 +02:00
filesystem . add_option (
' --no-mtime ' ,
action = ' store_false ' , dest = ' updatetime ' , default = True ,
2015-03-25 11:02:55 +01:00
help = ' Do not use the Last-modified header to set the file modification time ' )
2014-10-12 23:10:11 +02:00
filesystem . add_option (
' --write-description ' ,
action = ' store_true ' , dest = ' writedescription ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Write video description to a .description file ' )
2014-10-12 23:10:11 +02:00
filesystem . add_option (
' --write-info-json ' ,
action = ' store_true ' , dest = ' writeinfojson ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Write video metadata to a .info.json file ' )
2014-10-12 23:10:11 +02:00
filesystem . add_option (
' --write-annotations ' ,
action = ' store_true ' , dest = ' writeannotations ' , default = False ,
2015-05-02 19:38:30 +02:00
help = ' Write video annotations to a .annotations.xml file ' )
2014-10-12 23:10:11 +02:00
filesystem . add_option (
2016-06-05 21:52:58 +02:00
' --load-info-json ' , ' --load-info ' ,
2014-10-12 23:10:11 +02:00
dest = ' load_info_filename ' , metavar = ' FILE ' ,
2015-04-04 16:09:11 +02:00
help = ' JSON file containing the video information (created with the " --write-info-json " option) ' )
2014-10-12 23:10:11 +02:00
filesystem . add_option (
' --cookies ' ,
dest = ' cookiefile ' , metavar = ' FILE ' ,
2015-03-25 11:02:55 +01:00
help = ' File to read cookies from and dump cookie jar in ' )
2014-09-13 07:55:21 +02: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 23:10:11 +02:00
' --rm-cache-dir ' ,
action = ' store_true ' , dest = ' rm_cachedir ' ,
2014-09-13 07:55:21 +02:00
help = ' Delete all filesystem cache files ' )
2015-01-25 02:38:47 +01:00
thumbnail = optparse . OptionGroup ( parser , ' Thumbnail images ' )
thumbnail . add_option (
' --write-thumbnail ' ,
action = ' store_true ' , dest = ' writethumbnail ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Write thumbnail image to disk ' )
2015-01-25 03:11:12 +01:00
thumbnail . add_option (
' --write-all-thumbnails ' ,
action = ' store_true ' , dest = ' write_all_thumbnails ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Write all thumbnail image formats to disk ' )
2015-01-25 02:38:47 +01: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 23:10:11 +02:00
postproc = optparse . OptionGroup ( parser , ' Post-processing Options ' )
postproc . add_option (
' -x ' , ' --extract-audio ' ,
action = ' store_true ' , dest = ' extractaudio ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Convert video files to audio-only files (requires ffmpeg or avconv and ffprobe or avprobe) ' )
2014-10-12 23:10:11 +02:00
postproc . add_option (
' --audio-format ' , metavar = ' FORMAT ' , dest = ' audioformat ' , default = ' best ' ,
2015-03-25 11:02:55 +01:00
help = ' Specify audio format: " best " , " aac " , " vorbis " , " mp3 " , " m4a " , " opus " , or " wav " ; " %d efault " by default ' )
2014-10-12 23:10:11 +02:00
postproc . add_option (
' --audio-quality ' , metavar = ' QUALITY ' ,
dest = ' audioquality ' , default = ' 5 ' ,
2015-03-25 11:02:55 +01: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 23:10:11 +02:00
postproc . add_option (
' --recode-video ' ,
metavar = ' FORMAT ' , dest = ' recodevideo ' , default = None ,
2015-07-11 18:15:16 +02:00
help = ' Encode the video to another format if necessary (currently supported: mp4|flv|ogg|webm|mkv|avi) ' )
2015-06-10 03:08:16 +02:00
postproc . add_option (
2015-06-30 21:22:09 +02:00
' --postprocessor-args ' ,
2015-07-11 18:15:16 +02:00
dest = ' postprocessor_args ' , metavar = ' ARGS ' ,
help = ' Give these arguments to the postprocessor ' )
2014-10-12 23:10:11 +02:00
postproc . add_option (
' -k ' , ' --keep-video ' ,
action = ' store_true ' , dest = ' keepvideo ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Keep the video file on disk after the post-processing; the video is erased by default ' )
2014-10-12 23:10:11 +02:00
postproc . add_option (
' --no-post-overwrites ' ,
action = ' store_true ' , dest = ' nopostoverwrites ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Do not overwrite post-processed files; the post-processed files are overwritten by default ' )
2014-10-12 23:10:11 +02:00
postproc . add_option (
' --embed-subs ' ,
action = ' store_true ' , dest = ' embedsubtitles ' , default = False ,
2016-03-19 23:12:34 +01:00
help = ' Embed subtitles in the video (only for mp4, webm and mkv videos) ' )
2014-10-12 23:10:11 +02:00
postproc . add_option (
' --embed-thumbnail ' ,
action = ' store_true ' , dest = ' embedthumbnail ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Embed thumbnail in the audio as cover art ' )
2014-10-12 23:10:11 +02:00
postproc . add_option (
' --add-metadata ' ,
action = ' store_true ' , dest = ' addmetadata ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Write metadata to the video file ' )
2015-03-04 22:33:56 +01:00
postproc . add_option (
' --metadata-from-title ' ,
metavar = ' FORMAT ' , dest = ' metafromtitle ' ,
2015-03-25 11:02:55 +01:00
help = ' Parse additional metadata like song title / artist from the video title. '
2015-03-04 22:33:56 +01:00
' The format syntax is the same as --output, '
2015-03-14 19:55:42 +01:00
' the parsed parameters replace existing values. '
2015-05-21 18:06:25 +02:00
' Additional templates: %(album)s , %(artist)s . '
2015-03-04 22:33:56 +01:00
' Example: --metadata-from-title " %(artist)s - %(title)s " matches a title like '
' " Coldplay - Paradise " ' )
2014-10-12 23:10:11 +02:00
postproc . add_option (
' --xattrs ' ,
action = ' store_true ' , dest = ' xattrs ' , default = False ,
2015-03-25 11:02:55 +01:00
help = ' Write metadata to the video file \' s xattrs (using dublin core and xdg standards) ' )
2015-01-10 05:45:51 +01:00
postproc . add_option (
' --fixup ' ,
metavar = ' POLICY ' , dest = ' fixup ' , default = ' detect_or_warn ' ,
2015-02-02 20:28:18 +01:00
help = ' Automatically correct known faults of the file. '
2015-01-10 05:45:51 +01:00
' One of never (do nothing), warn (only emit a warning), '
2015-06-14 22:57:07 +02:00
' detect_or_warn (the default; fix file if we can, warn otherwise) ' )
2014-10-12 23:10:11 +02:00
postproc . add_option (
' --prefer-avconv ' ,
action = ' store_false ' , dest = ' prefer_ffmpeg ' ,
2014-09-13 07:55:21 +02:00
help = ' Prefer avconv over ffmpeg for running the postprocessors (default) ' )
2014-10-12 23:10:11 +02:00
postproc . add_option (
' --prefer-ffmpeg ' ,
action = ' store_true ' , dest = ' prefer_ffmpeg ' ,
2014-09-13 07:55:21 +02:00
help = ' Prefer ffmpeg over avconv for running the postprocessors ' )
2015-02-13 11:14:01 +01: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 07:55:21 +02:00
postproc . add_option (
2014-10-12 23:10:11 +02:00
' --exec ' ,
metavar = ' CMD ' , dest = ' exec_cmd ' ,
2014-11-23 20:41:03 +01:00
help = ' Execute a command on the file after downloading, similar to find \' s -exec syntax. Example: --exec \' adb push {} /sdcard/Music/ && rm {} \' ' )
2015-02-28 14:43:24 +01:00
postproc . add_option (
2015-12-30 18:12:35 +01:00
' --convert-subs ' , ' --convert-subtitles ' ,
2015-02-28 14:43:24 +01:00
metavar = ' FORMAT ' , dest = ' convertsubtitles ' , default = None ,
help = ' Convert the subtitles to other format (currently supported: srt|ass|vtt) ' )
2014-09-13 07:55:21 +02:00
parser . add_option_group ( general )
2015-01-10 19:55:36 +01:00
parser . add_option_group ( network )
2014-09-13 07:55:21 +02:00
parser . add_option_group ( selection )
parser . add_option_group ( downloader )
parser . add_option_group ( filesystem )
2015-01-25 02:38:47 +01:00
parser . add_option_group ( thumbnail )
2014-09-13 07:55:21 +02: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 17:18:31 +02:00
parser . add_option_group ( adobe_pass )
2014-09-13 07:55:21 +02:00
parser . add_option_group ( postproc )
if overrideArguments is not None :
opts , args = parser . parse_args ( overrideArguments )
if opts . verbose :
2014-10-12 23:10:11 +02:00
write_string ( ' [debug] Override config: ' + repr ( overrideArguments ) + ' \n ' )
2014-09-13 07:55:21 +02:00
else :
2015-04-11 23:57:56 +02: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 : ] )
2015-03-24 16:39:46 +01:00
2015-02-10 01:36:38 +01:00
if ' --ignore-config ' in command_line_conf :
system_conf = [ ]
user_conf = [ ]
2014-09-13 07:55:21 +02:00
else :
2016-07-07 19:40:58 +02:00
system_conf = _readOptions ( ' /etc/youtube-dl.conf ' )
2015-02-10 01:36:38 +01:00
if ' --ignore-config ' in system_conf :
user_conf = [ ]
2014-09-13 07:55:21 +02:00
else :
2016-07-07 19:40:58 +02:00
user_conf = _readUserConf ( )
2015-02-10 01:36:38 +01:00
argv = system_conf + user_conf + command_line_conf
2014-09-13 07:55:21 +02:00
opts , args = parser . parse_args ( argv )
if opts . verbose :
2015-02-10 01:36:38 +01:00
write_string ( ' [debug] System config: ' + repr ( _hide_login_info ( system_conf ) ) + ' \n ' )
write_string ( ' [debug] User config: ' + repr ( _hide_login_info ( user_conf ) ) + ' \n ' )
write_string ( ' [debug] Command-line args: ' + repr ( _hide_login_info ( command_line_conf ) ) + ' \n ' )
2014-09-13 07:55:21 +02:00
return parser , opts , args