action='help',help='print this help text and exit')
general.add_option('-v','--version',
action='version',help='print program version and exit')
general.add_option('-U','--update',
action='store_true',dest='update_self',help='update this program to latest version. Make sure that you have sufficient permissions (run with sudo if needed)')
general.add_option('-i','--ignore-errors',
action='store_true',dest='ignoreerrors',help='continue on download errors, for example to skip unavailable videos in a playlist',default=False)
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',
help='display the current browser identification',default=False)
general.add_option('--list-extractors',
action='store_true',dest='list_extractors',
help='List all supported extractors and the URLs they would handle',default=False)
help='Use the specified HTTP/HTTPS proxy. Pass in an empty string (--proxy "") for direct connection')
general.add_option(
'--socket-timeout',dest='socket_timeout',
type=float,default=None,help=u'Time to wait before giving up, in seconds')
general.add_option(
'--default-search',
dest='default_search',metavar='PREFIX',
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.')
general.add_option(
'--ignore-config',
action='store_true',
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.conf (%APPDATA%/youtube-dl/config.txt on Windows)')
selection.add_option('--min-filesize',metavar='SIZE',dest='min_filesize',help="Do not download any videos smaller than SIZE (e.g. 50k or 44.6m)",default=None)
selection.add_option('--max-filesize',metavar='SIZE',dest='max_filesize',help="Do not download any videos larger than SIZE (e.g. 50k or 44.6m)",default=None)
selection.add_option('--date',metavar='DATE',dest='date',help='download only videos uploaded in this date',default=None)
help='video format code, specify the order of preference using slashes: "-f 22/17/18". "-f mp4" and "-f flv" are also supported. You can also use the special names "best", "bestvideo", "bestaudio", "worst", "worstvideo" and "worstaudio". By default, youtube-dl will pick the best quality.')
video_format.add_option('--all-formats',
action='store_const',dest='format',help='download all available video formats',const='all')
video_format.add_option('--prefer-free-formats',
action='store_true',dest='prefer_free_formats',default=False,help='prefer free video formats unless a specific one is requested')
video_format.add_option('--max-quality',
action='store',dest='format_limit',metavar='FORMAT',help='highest quality format to download')
video_format.add_option('-F','--list-formats',
action='store_true',dest='listformats',help='list all available formats')
dest='batchfile',metavar='FILE',help='file containing URLs to download (\'-\' for stdin)')
filesystem.add_option('--id',
action='store_true',dest='useid',help='use only video ID in file name',default=False)
filesystem.add_option('-A','--auto-number',
action='store_true',dest='autonumber',
help='number downloaded files starting from 00000',default=False)
filesystem.add_option('-o','--output',
dest='outtmpl',metavar='TEMPLATE',
help=('output filename template. Use %(title)s to get the title, '
'%(uploader)s for the uploader name, %(uploader_id)s for the uploader nickname if different, '
'%(autonumber)s to get an automatically incremented number, '
'%(ext)s for the filename extension, '
'%(format)s for the format description (like "22 - 1280x720" or "HD"), '
'%(format_id)s for the unique id of the format (like Youtube\'s itags: "137"), '
'%(upload_date)s for the upload date (YYYYMMDD), '
'%(extractor)s for the provider (youtube, metacafe, etc), '
'%(id)s for the video id, %(playlist)s for the playlist the video is in, '
'%(playlist_index)s for the position in the playlist and %% for a literal percent. '
'%(height)s and %(width)s for the width and height of the video format. '
'%(resolution)s for a textual description of the resolution of the video format. '
'Use - to output to stdout. Can also be used to download to a different directory, '
'for example with -o \'/my/downloads/%(uploader)s/%(title)s-%(id)s.%(ext)s\' .'))
filesystem.add_option('--autonumber-size',
dest='autonumber_size',metavar='NUMBER',
help='Specifies the number of digits in %(autonumber)s when it is present in output filename template or --auto-number option is given')
filesystem.add_option('--restrict-filenames',
action='store_true',dest='restrictfilenames',
help='Restrict filenames to only ASCII characters, and avoid "&" and spaces in filenames',default=False)
filesystem.add_option('-t','--title',
action='store_true',dest='usetitle',help='[deprecated] use title in file name (default)',default=False)
filesystem.add_option('-l','--literal',
action='store_true',dest='usetitle',help='[deprecated] alias of --title',default=False)
filesystem.add_option('-w','--no-overwrites',
action='store_true',dest='nooverwrites',help='do not overwrite files',default=False)
filesystem.add_option('-c','--continue',
action='store_true',dest='continue_dl',help='force resume of partially downloaded files. By default, youtube-dl will resume downloads if possible.',default=True)
filesystem.add_option('--no-continue',
action='store_false',dest='continue_dl',
help='do not resume partially downloaded files (restart from beginning)')
filesystem.add_option('--no-part',
action='store_true',dest='nopart',help='do not use .part files',default=False)
filesystem.add_option('--no-mtime',
action='store_false',dest='updatetime',
help='do not use the Last-modified header to set the file modification time',default=True)
filesystem.add_option('--write-description',
action='store_true',dest='writedescription',
help='write video description to a .description file',default=False)
filesystem.add_option('--write-info-json',
action='store_true',dest='writeinfojson',
help='write video metadata to a .info.json file',default=False)
filesystem.add_option('--write-annotations',
action='store_true',dest='writeannotations',
help='write video annotations to a .annotation file',default=False)
filesystem.add_option('--write-thumbnail',
action='store_true',dest='writethumbnail',
help='write thumbnail image to disk',default=False)
filesystem.add_option('--load-info',
dest='load_info_filename',metavar='FILE',
help='json file containing the video information (created with the "--write-json" option)')
filesystem.add_option('--cookies',
dest='cookiefile',metavar='FILE',help='file to read cookies from and dump cookie jar in')
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.')
action='help',help='print this help text and exit')
general.add_option('-v','--version',
action='version',help='print program version and exit')
general.add_option('-U','--update',
action='store_true',dest='update_self',help='update this program to latest version. Make sure that you have sufficient permissions (run with sudo if needed)')
general.add_option('-i','--ignore-errors',
action='store_true',dest='ignoreerrors',help='continue on download errors, for example to skip unavailable videos in a playlist',default=False)
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',
help='display the current browser identification',default=False)
general.add_option('--list-extractors',
action='store_true',dest='list_extractors',
help='List all supported extractors and the URLs they would handle',default=False)
help='Use the specified HTTP/HTTPS proxy. Pass in an empty string (--proxy "") for direct connection')
general.add_option(
'--socket-timeout',dest='socket_timeout',
type=float,default=None,help=u'Time to wait before giving up, in seconds')
general.add_option(
'--default-search',
dest='default_search',metavar='PREFIX',
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.')
general.add_option(
'--ignore-config',
action='store_true',
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.conf (%APPDATA%/youtube-dl/config.txt on Windows)')
selection.add_option('--min-filesize',metavar='SIZE',dest='min_filesize',help="Do not download any videos smaller than SIZE (e.g. 50k or 44.6m)",default=None)
selection.add_option('--max-filesize',metavar='SIZE',dest='max_filesize',help="Do not download any videos larger than SIZE (e.g. 50k or 44.6m)",default=None)
selection.add_option('--date',metavar='DATE',dest='date',help='download only videos uploaded in this date',default=None)
help='video format code, specify the order of preference using slashes: "-f 22/17/18". "-f mp4" and "-f flv" are also supported. You can also use the special names "best", "bestvideo", "bestaudio", "worst", "worstvideo" and "worstaudio". By default, youtube-dl will pick the best quality.')
video_format.add_option('--all-formats',
action='store_const',dest='format',help='download all available video formats',const='all')
video_format.add_option('--prefer-free-formats',
action='store_true',dest='prefer_free_formats',default=False,help='prefer free video formats unless a specific one is requested')
video_format.add_option('--max-quality',
action='store',dest='format_limit',metavar='FORMAT',help='highest quality format to download')
video_format.add_option('-F','--list-formats',
action='store_true',dest='listformats',help='list all available formats')
dest='batchfile',metavar='FILE',help='file containing URLs to download (\'-\' for stdin)')
filesystem.add_option('--id',
action='store_true',dest='useid',help='use only video ID in file name',default=False)
filesystem.add_option('-A','--auto-number',
action='store_true',dest='autonumber',
help='number downloaded files starting from 00000',default=False)
filesystem.add_option('-o','--output',
dest='outtmpl',metavar='TEMPLATE',
help=('output filename template. Use %(title)s to get the title, '
'%(uploader)s for the uploader name, %(uploader_id)s for the uploader nickname if different, '
'%(autonumber)s to get an automatically incremented number, '
'%(ext)s for the filename extension, '
'%(format)s for the format description (like "22 - 1280x720" or "HD"), '
'%(format_id)s for the unique id of the format (like Youtube\'s itags: "137"), '
'%(upload_date)s for the upload date (YYYYMMDD), '
'%(extractor)s for the provider (youtube, metacafe, etc), '
'%(id)s for the video id, %(playlist)s for the playlist the video is in, '
'%(playlist_index)s for the position in the playlist and %% for a literal percent. '
'%(height)s and %(width)s for the width and height of the video format. '
'%(resolution)s for a textual description of the resolution of the video format. '
'Use - to output to stdout. Can also be used to download to a different directory, '
'for example with -o \'/my/downloads/%(uploader)s/%(title)s-%(id)s.%(ext)s\' .'))
filesystem.add_option('--autonumber-size',
dest='autonumber_size',metavar='NUMBER',
help='Specifies the number of digits in %(autonumber)s when it is present in output filename template or --auto-number option is given')
filesystem.add_option('--restrict-filenames',
action='store_true',dest='restrictfilenames',
help='Restrict filenames to only ASCII characters, and avoid "&" and spaces in filenames',default=False)
filesystem.add_option('-t','--title',
action='store_true',dest='usetitle',help='[deprecated] use title in file name (default)',default=False)
filesystem.add_option('-l','--literal',
action='store_true',dest='usetitle',help='[deprecated] alias of --title',default=False)
filesystem.add_option('-w','--no-overwrites',
action='store_true',dest='nooverwrites',help='do not overwrite files',default=False)
filesystem.add_option('-c','--continue',
action='store_true',dest='continue_dl',help='force resume of partially downloaded files. By default, youtube-dl will resume downloads if possible.',default=True)
filesystem.add_option('--no-continue',
action='store_false',dest='continue_dl',
help='do not resume partially downloaded files (restart from beginning)')
filesystem.add_option('--no-part',
action='store_true',dest='nopart',help='do not use .part files',default=False)
filesystem.add_option('--no-mtime',
action='store_false',dest='updatetime',
help='do not use the Last-modified header to set the file modification time',default=True)
filesystem.add_option('--write-description',
action='store_true',dest='writedescription',
help='write video description to a .description file',default=False)
filesystem.add_option('--write-info-json',
action='store_true',dest='writeinfojson',
help='write video metadata to a .info.json file',default=False)
filesystem.add_option('--write-annotations',
action='store_true',dest='writeannotations',
help='write video annotations to a .annotation file',default=False)
filesystem.add_option('--write-thumbnail',
action='store_true',dest='writethumbnail',
help='write thumbnail image to disk',default=False)
filesystem.add_option('--load-info',
dest='load_info_filename',metavar='FILE',
help='json file containing the video information (created with the "--write-json" option)')
filesystem.add_option('--cookies',
dest='cookiefile',metavar='FILE',help='file to read cookies from and dump cookie jar in')
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.')