release 2014.01.22.5

This commit is contained in:
Philipp Hagemeister 2014-01-22 21:57:17 +01:00
parent 4919603f66
commit 780083dbc6
2 changed files with 206 additions and 179 deletions

255
README.md
View File

@ -16,123 +16,142 @@ which means you can modify it, redistribute it or use it however you like.
# OPTIONS # OPTIONS
-h, --help print this help text and exit -h, --help print this help text and exit
--version print program version and exit --version print program version and exit
-U, --update update this program to latest version. Make sure -U, --update update this program to latest version. Make
that you have sufficient permissions (run with sure that you have sufficient permissions
sudo if needed) (run with sudo if needed)
-i, --ignore-errors continue on download errors, for example to to -i, --ignore-errors continue on download errors, for example to
skip unavailable videos in a playlist to skip unavailable videos in a playlist
--abort-on-error Abort downloading of further videos (in the --abort-on-error Abort downloading of further videos (in the
playlist or the command line) if an error occurs playlist or the command line) if an error
occurs
--dump-user-agent display the current browser identification --dump-user-agent display the current browser identification
--user-agent UA specify a custom user agent --user-agent UA specify a custom user agent
--referer REF specify a custom referer, use if the video access --referer REF specify a custom referer, use if the video
is restricted to one domain access is restricted to one domain
--list-extractors List all supported extractors and the URLs they --list-extractors List all supported extractors and the URLs
would handle they would handle
--extractor-descriptions Output descriptions of all supported extractors --extractor-descriptions Output descriptions of all supported
--proxy URL Use the specified HTTP/HTTPS proxy. Pass in an extractors
empty string (--proxy "") for direct connection --proxy URL Use the specified HTTP/HTTPS proxy. Pass in
an empty string (--proxy "") for direct
connection
--no-check-certificate Suppress HTTPS certificate validation. --no-check-certificate Suppress HTTPS certificate validation.
--cache-dir DIR Location in the filesystem where youtube-dl can --cache-dir DIR Location in the filesystem where youtube-dl
store some downloaded information permanently. By can store some downloaded information
default $XDG_CACHE_HOME/youtube-dl or ~/.cache permanently. By default $XDG_CACHE_HOME
/youtube-dl . At the moment, only YouTube player /youtube-dl or ~/.cache/youtube-dl . At the
files (for videos with obfuscated signatures) are moment, only YouTube player files (for
videos with obfuscated signatures) are
cached, but that may change. cached, but that may change.
--no-cache-dir Disable filesystem caching --no-cache-dir Disable filesystem caching
--socket-timeout None Time to wait before giving up, in seconds --socket-timeout None Time to wait before giving up, in seconds
--bidi-workaround Work around terminals that lack bidirectional --bidi-workaround Work around terminals that lack
text support. Requires bidiv or fribidi bidirectional text support. Requires bidiv
executable in PATH or fribidi executable in PATH
--default-search PREFIX Use this prefix for unqualified URLs. For example --default-search PREFIX Use this prefix for unqualified URLs. For
"gvsearch2:" downloads two videos from google example "gvsearch2:" downloads two videos
videos for youtube-dl "large apple". By default from google videos for youtube-dl "large
(with value "auto") youtube-dl guesses. apple". By default (with value "auto")
youtube-dl guesses.
## Video Selection: ## Video Selection:
--playlist-start NUMBER playlist video to start at (default is 1) --playlist-start NUMBER playlist video to start at (default is 1)
--playlist-end NUMBER playlist video to end at (default is last) --playlist-end NUMBER playlist video to end at (default is last)
--match-title REGEX download only matching titles (regex or caseless --match-title REGEX download only matching titles (regex or
sub-string) caseless sub-string)
--reject-title REGEX skip download for matching titles (regex or --reject-title REGEX skip download for matching titles (regex or
caseless sub-string) caseless sub-string)
--max-downloads NUMBER Abort after downloading NUMBER files --max-downloads NUMBER Abort after downloading NUMBER files
--min-filesize SIZE Do not download any videos smaller than SIZE --min-filesize SIZE Do not download any videos smaller than
SIZE (e.g. 50k or 44.6m)
--max-filesize SIZE Do not download any videos larger than SIZE
(e.g. 50k or 44.6m) (e.g. 50k or 44.6m)
--max-filesize SIZE Do not download any videos larger than SIZE (e.g.
50k or 44.6m)
--date DATE download only videos uploaded in this date --date DATE download only videos uploaded in this date
--datebefore DATE download only videos uploaded on or before this --datebefore DATE download only videos uploaded on or before
date (i.e. inclusive) this date (i.e. inclusive)
--dateafter DATE download only videos uploaded on or after this --dateafter DATE download only videos uploaded on or after
date (i.e. inclusive) this date (i.e. inclusive)
--min-views COUNT Do not download any videos with less than COUNT --min-views COUNT Do not download any videos with less than
views COUNT views
--max-views COUNT Do not download any videos with more than COUNT --max-views COUNT Do not download any videos with more than
views COUNT views
--no-playlist download only the currently playing video --no-playlist download only the currently playing video
--age-limit YEARS download only videos suitable for the given age --age-limit YEARS download only videos suitable for the given
--download-archive FILE Download only videos not listed in the archive age
file. Record the IDs of all downloaded videos in --download-archive FILE Download only videos not listed in the
it. archive file. Record the IDs of all
--include-ads Download advertisements as well (experimental) downloaded videos in it.
--include-ads Download advertisements as well
(experimental)
## Download Options: ## Download Options:
-r, --rate-limit LIMIT maximum download rate in bytes per second (e.g. -r, --rate-limit LIMIT maximum download rate in bytes per second
50K or 4.2M) (e.g. 50K or 4.2M)
-R, --retries RETRIES number of retries (default is 10) -R, --retries RETRIES number of retries (default is 10)
--buffer-size SIZE size of download buffer (e.g. 1024 or 16K) --buffer-size SIZE size of download buffer (e.g. 1024 or 16K)
(default is 1024) (default is 1024)
--no-resize-buffer do not automatically adjust the buffer size. By --no-resize-buffer do not automatically adjust the buffer
default, the buffer size is automatically resized size. By default, the buffer size is
from an initial value of SIZE. automatically resized from an initial value
of SIZE.
## Filesystem Options: ## Filesystem Options:
-t, --title use title in file name (default) -t, --title use title in file name (default)
--id use only video ID in file name --id use only video ID in file name
-l, --literal [deprecated] alias of --title -l, --literal [deprecated] alias of --title
-A, --auto-number number downloaded files starting from 00000 -A, --auto-number number downloaded files starting from 00000
-o, --output TEMPLATE output filename template. Use %(title)s to get -o, --output TEMPLATE output filename template. Use %(title)s to
the title, %(uploader)s for the uploader name, get the title, %(uploader)s for the
%(uploader_id)s for the uploader nickname if uploader name, %(uploader_id)s for the
different, %(autonumber)s to get an automatically uploader nickname if different,
incremented number, %(ext)s for the filename %(autonumber)s to get an automatically
extension, %(format)s for the format description incremented number, %(ext)s for the
(like "22 - 1280x720" or "HD"), %(format_id)s for filename extension, %(format)s for the
the unique id of the format (like Youtube's format description (like "22 - 1280x720" or
itags: "137"), %(upload_date)s for the upload "HD"), %(format_id)s for the unique id of
date (YYYYMMDD), %(extractor)s for the provider the format (like Youtube's itags: "137"),
(youtube, metacafe, etc), %(id)s for the video %(upload_date)s for the upload date
id, %(playlist)s for the playlist the video is (YYYYMMDD), %(extractor)s for the provider
in, %(playlist_index)s for the position in the (youtube, metacafe, etc), %(id)s for the
playlist and %% for a literal percent. Use - to video id, %(playlist)s for the playlist the
output to stdout. Can also be used to download to video is in, %(playlist_index)s for the
a different directory, for example with -o '/my/d position in the playlist and %% for a
ownloads/%(uploader)s/%(title)s-%(id)s.%(ext)s' . literal percent. Use - to output to stdout.
--autonumber-size NUMBER Specifies the number of digits in %(autonumber)s Can also be used to download to a different
when it is present in output filename template or directory, for example with -o '/my/downloa
--auto-number option is given ds/%(uploader)s/%(title)s-%(id)s.%(ext)s' .
--restrict-filenames Restrict filenames to only ASCII characters, and --autonumber-size NUMBER Specifies the number of digits in
avoid "&" and spaces in filenames %(autonumber)s when it is present in output
-a, --batch-file FILE file containing URLs to download ('-' for stdin) filename template or --auto-number option
is given
--restrict-filenames Restrict filenames to only ASCII
characters, and avoid "&" and spaces in
filenames
-a, --batch-file FILE file containing URLs to download ('-' for
stdin)
--load-info FILE json file containing the video information --load-info FILE json file containing the video information
(created with the "--write-json" option) (created with the "--write-json" option)
-w, --no-overwrites do not overwrite files -w, --no-overwrites do not overwrite files
-c, --continue force resume of partially downloaded files. By -c, --continue force resume of partially downloaded files.
default, youtube-dl will resume downloads if By default, youtube-dl will resume
possible. downloads if possible.
--no-continue do not resume partially downloaded files (restart --no-continue do not resume partially downloaded files
from beginning) (restart from beginning)
--cookies FILE file to read cookies from and dump cookie jar in --cookies FILE file to read cookies from and dump cookie
jar in
--no-part do not use .part files --no-part do not use .part files
--no-mtime do not use the Last-modified header to set the --no-mtime do not use the Last-modified header to set
file modification time the file modification time
--write-description write video description to a .description file --write-description write video description to a .description
file
--write-info-json write video metadata to a .info.json file --write-info-json write video metadata to a .info.json file
--write-annotations write video annotations to a .annotation file --write-annotations write video annotations to a .annotation
file
--write-thumbnail write thumbnail image to disk --write-thumbnail write thumbnail image to disk
## Verbosity / Simulation Options: ## Verbosity / Simulation Options:
--youtube-include-dash-manifest Try to download the DASH manifest on
YouTube videos (experimental)
-q, --quiet activates quiet mode -q, --quiet activates quiet mode
-s, --simulate do not download the video and do not write -s, --simulate do not download the video and do not write
anything to disk anything to disk
@ -150,34 +169,37 @@ which means you can modify it, redistribute it or use it however you like.
--no-progress do not print progress bar --no-progress do not print progress bar
--console-title display progress in console titlebar --console-title display progress in console titlebar
-v, --verbose print various debugging information -v, --verbose print various debugging information
--dump-intermediate-pages print downloaded pages to debug problems (very --dump-intermediate-pages print downloaded pages to debug problems
verbose) (very verbose)
--write-pages Write downloaded intermediary pages to files in --write-pages Write downloaded intermediary pages to
the current directory to debug problems files in the current directory to debug
problems
--print-traffic Display sent and read HTTP traffic
## Video Format Options: ## Video Format Options:
-f, --format FORMAT video format code, specify the order of -f, --format FORMAT video format code, specify the order of
preference using slashes: "-f 22/17/18". "-f mp4" preference using slashes: "-f 22/17/18".
and "-f flv" are also supported. You can also use "-f mp4" and "-f flv" are also supported.
the special names "best", "bestaudio", "worst", You can also use the special names "best",
and "worstaudio" "bestaudio", "worst", and "worstaudio"
--all-formats download all available video formats --all-formats download all available video formats
--prefer-free-formats prefer free video formats unless a specific one --prefer-free-formats prefer free video formats unless a specific
is requested one is requested
--max-quality FORMAT highest quality format to download --max-quality FORMAT highest quality format to download
-F, --list-formats list all available formats -F, --list-formats list all available formats
## Subtitle Options: ## Subtitle Options:
--write-sub write subtitle file --write-sub write subtitle file
--write-auto-sub write automatic subtitle file (youtube only) --write-auto-sub write automatic subtitle file (youtube
--all-subs downloads all the available subtitles of the
video
--list-subs lists all available subtitles for the video
--sub-format FORMAT subtitle format (default=srt) ([sbv/vtt] youtube
only) only)
--sub-lang LANGS languages of the subtitles to download (optional) --all-subs downloads all the available subtitles of
separated by commas, use IETF language tags like the video
'en,pt' --list-subs lists all available subtitles for the video
--sub-format FORMAT subtitle format (default=srt) ([sbv/vtt]
youtube only)
--sub-lang LANGS languages of the subtitles to download
(optional) separated by commas, use IETF
language tags like 'en,pt'
## Authentication Options: ## Authentication Options:
-u, --username USERNAME account username -u, --username USERNAME account username
@ -186,24 +208,29 @@ which means you can modify it, redistribute it or use it however you like.
--video-password PASSWORD video password (vimeo, smotri) --video-password PASSWORD video password (vimeo, smotri)
## Post-processing Options: ## Post-processing Options:
-x, --extract-audio convert video files to audio-only files (requires -x, --extract-audio convert video files to audio-only files
ffmpeg or avconv and ffprobe or avprobe) (requires ffmpeg or avconv and ffprobe or
--audio-format FORMAT "best", "aac", "vorbis", "mp3", "m4a", "opus", or avprobe)
"wav"; best by default --audio-format FORMAT "best", "aac", "vorbis", "mp3", "m4a",
--audio-quality QUALITY ffmpeg/avconv audio quality specification, insert "opus", or "wav"; best by default
a value between 0 (better) and 9 (worse) for VBR --audio-quality QUALITY ffmpeg/avconv audio quality specification,
or a specific bitrate like 128K (default 5) insert a value between 0 (better) and 9
--recode-video FORMAT Encode the video to another format if necessary (worse) for VBR or a specific bitrate like
(currently supported: mp4|flv|ogg|webm) 128K (default 5)
-k, --keep-video keeps the video file on disk after the post- --recode-video FORMAT Encode the video to another format if
processing; the video is erased by default necessary (currently supported:
--no-post-overwrites do not overwrite post-processed files; the post- mp4|flv|ogg|webm)
processed files are overwritten by default -k, --keep-video keeps the video file on disk after the
post-processing; the video is erased by
default
--no-post-overwrites do not overwrite post-processed files; the
post-processed files are overwritten by
default
--embed-subs embed subtitles in the video (only for mp4 --embed-subs embed subtitles in the video (only for mp4
videos) videos)
--add-metadata write metadata to the video file --add-metadata write metadata to the video file
--xattrs write metadata to the video file's xattrs (using --xattrs write metadata to the video file's xattrs
dublin core and xdg standards) (using dublin core and xdg standards)
--prefer-avconv Prefer avconv over ffmpeg for running the --prefer-avconv Prefer avconv over ffmpeg for running the
postprocessors (default) postprocessors (default)
--prefer-ffmpeg Prefer ffmpeg over avconv for running the --prefer-ffmpeg Prefer ffmpeg over avconv for running the

View File

@ -1,2 +1,2 @@
__version__ = '2014.01.22.4' __version__ = '2014.01.22.5'