release 2013.04.11

This commit is contained in:
Philipp Hagemeister 2013-04-11 18:42:57 +02:00
parent f4381ab88a
commit b625bc2c31
2 changed files with 108 additions and 102 deletions

208
README.md
View File

@ -14,119 +14,125 @@ your Unix box, on Windows or on Mac OS X. It is released to the public domain,
which means you can modify it, redistribute it or use it however you like. 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 -U, --update update this program to latest version
-i, --ignore-errors continue on download errors -i, --ignore-errors continue on download errors
-r, --rate-limit LIMIT maximum download rate (e.g. 50k or 44.6m) -r, --rate-limit LIMIT maximum download rate (e.g. 50k or 44.6m)
-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) (default --buffer-size SIZE size of download buffer (e.g. 1024 or 16k)
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 size. By
default, the buffer size is automatically resized default, the buffer size is automatically resized
from an initial value of SIZE. from an initial value of SIZE.
--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
--list-extractors List all supported extractors and the URLs they --list-extractors List all supported extractors and the URLs they
would handle would handle
## 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 caseless
sub-string) 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 (e.g. --min-filesize SIZE Do not download any videos smaller than SIZE
50k or 44.6m) (e.g. 50k or 44.6m)
--max-filesize SIZE Do not download any videos larger than SIZE (e.g. --max-filesize SIZE Do not download any videos larger than SIZE (e.g.
50k or 44.6m) 50k or 44.6m)
## Filesystem Options: ## Filesystem Options:
-t, --title use title in file name -t, --title use title in file name
--id use video ID in file name --id use 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 the -o, --output TEMPLATE output filename template. Use %(title)s to get
title, %(uploader)s for the uploader name, the title, %(uploader)s for the uploader name,
%(uploader_id)s for the uploader nickname if %(uploader_id)s for the uploader nickname if
different, %(autonumber)s to get an automatically different, %(autonumber)s to get an automatically
incremented number, %(ext)s for the filename incremented number, %(ext)s for the filename
extension, %(upload_date)s for the upload date extension, %(upload_date)s for the upload date
(YYYYMMDD), %(extractor)s for the provider (YYYYMMDD), %(extractor)s for the provider
(youtube, metacafe, etc), %(id)s for the video id (youtube, metacafe, etc), %(id)s for the video id
and %% for a literal percent. Use - to output to and %% for a literal percent. Use - to output to
stdout. Can also be used to download to a different stdout. Can also be used to download to a
directory, for example with -o '/my/downloads/%(upl different directory, for example with -o '/my/dow
oader)s/%(title)s-%(id)s.%(ext)s' . nloads/%(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 %(autonumber)s
avoid "&" and spaces in filenames when it is present in output filename template or
-a, --batch-file FILE file containing URLs to download ('-' for stdin) --autonumber option is given
-w, --no-overwrites do not overwrite files --restrict-filenames Restrict filenames to only ASCII characters, and
-c, --continue resume partially downloaded files avoid "&" and spaces in filenames
--no-continue do not resume partially downloaded files (restart -a, --batch-file FILE file containing URLs to download ('-' for stdin)
from beginning) -w, --no-overwrites do not overwrite files
--cookies FILE file to read cookies from and dump cookie jar in -c, --continue resume partially downloaded files
--no-part do not use .part files --no-continue do not resume partially downloaded files (restart
--no-mtime do not use the Last-modified header to set the file from beginning)
modification time --cookies FILE file to read cookies from and dump cookie jar in
--write-description write video description to a .description file --no-part do not use .part files
--write-info-json write video metadata to a .info.json file --no-mtime do not use the Last-modified header to set the
file modification time
--write-description write video description to a .description file
--write-info-json write video metadata to a .info.json file
## Verbosity / Simulation Options: ## Verbosity / Simulation Options:
-q, --quiet activates quiet mode -q, --quiet activates quiet mode
-s, --simulate do not download the video and do not write anything -s, --simulate do not download the video and do not write
to disk anything to disk
--skip-download do not download the video --skip-download do not download the video
-g, --get-url simulate, quiet but print URL -g, --get-url simulate, quiet but print URL
-e, --get-title simulate, quiet but print title -e, --get-title simulate, quiet but print title
--get-thumbnail simulate, quiet but print thumbnail URL --get-thumbnail simulate, quiet but print thumbnail URL
--get-description simulate, quiet but print video description --get-description simulate, quiet but print video description
--get-filename simulate, quiet but print output filename --get-filename simulate, quiet but print output filename
--get-format simulate, quiet but print output format --get-format simulate, quiet but print output format
--newline output progress bar as new lines --newline output progress bar as new lines
--no-progress do not print progress bar --no-progress do not print progress bar
--console-title display progress in console titlebar --console-title display progress in console titlebar
-v, --verbose print various debugging information -v, --verbose print various debugging information
--dump-intermediate-pages print downloaded pages to debug problems(very
verbose)
## Video Format Options: ## Video Format Options:
-f, --format FORMAT video format code -f, --format FORMAT video format code
--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 is --prefer-free-formats prefer free video formats unless a specific one
requested 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 (currently youtube only) -F, --list-formats list all available formats (currently youtube
--write-sub write subtitle file (currently youtube only) only)
--only-sub downloads only the subtitles (no video) --write-sub write subtitle file (currently youtube only)
--all-subs downloads all the available subtitles of the video --only-sub downloads only the subtitles (no video)
(currently youtube only) --all-subs downloads all the available subtitles of the
--list-subs lists all available subtitles for the video video (currently youtube only)
(currently youtube only) --list-subs lists all available subtitles for the video
--sub-format LANG subtitle format [srt/sbv] (default=srt) (currently (currently youtube only)
youtube only) --sub-format LANG subtitle format [srt/sbv] (default=srt)
--sub-lang LANG language of the subtitles to download (optional) (currently youtube only)
use IETF language tags like 'en' --sub-lang LANG language of the subtitles to download (optional)
use IETF language tags like 'en'
## Authentication Options: ## Authentication Options:
-u, --username USERNAME account username -u, --username USERNAME account username
-p, --password PASSWORD account password -p, --password PASSWORD account password
-n, --netrc use .netrc authentication data -n, --netrc use .netrc authentication data
## 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 (requires
ffmpeg or avconv and ffprobe or avprobe) ffmpeg or avconv and ffprobe or avprobe)
--audio-format FORMAT "best", "aac", "vorbis", "mp3", "m4a", "opus", or --audio-format FORMAT "best", "aac", "vorbis", "mp3", "m4a", "opus", or
"wav"; best by default "wav"; best by default
--audio-quality QUALITY ffmpeg/avconv audio quality specification, insert a --audio-quality QUALITY ffmpeg/avconv audio quality specification, insert
value between 0 (better) and 9 (worse) for VBR or a a value between 0 (better) and 9 (worse) for VBR
specific bitrate like 128K (default 5) or a specific bitrate like 128K (default 5)
--recode-video FORMAT Encode the video to another format if necessary --recode-video FORMAT Encode the video to another format if necessary
(currently supported: mp4|flv|ogg|webm) (currently supported: mp4|flv|ogg|webm)
-k, --keep-video keeps the video file on disk after the post- -k, --keep-video keeps the video file on disk after the post-
processing; the video is erased by default processing; the video is erased by default
--no-post-overwrites do not overwrite post-processed files; the post- --no-post-overwrites do not overwrite post-processed files; the post-
processed files are overwritten by default processed files are overwritten by default
# CONFIGURATION # CONFIGURATION

View File

@ -1,2 +1,2 @@
__version__ = '2013.04.03' __version__ = '2013.04.11'