jcgruenhage/youtube-dl
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

release 2014.01.22.5

Browse source
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
Show stats Download patch file Download diff file Expand all files Collapse all files

383
README.md
View file

@ -14,200 +14,227 @@ 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. 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
--dump-user-agent display the current browser identification occurs
--user-agent UA specify a custom user agent --dump-user-agent display the current browser identification
--referer REF specify a custom referer, use if the video access --user-agent UA specify a custom user agent
is restricted to one domain --referer REF specify a custom referer, use if the video
--list-extractors List all supported extractors and the URLs they access is restricted to one domain
would handle --list-extractors List all supported extractors and the URLs
--extractor-descriptions Output descriptions of all supported extractors they would handle
--proxy URL Use the specified HTTP/HTTPS proxy. Pass in an --extractor-descriptions Output descriptions of all supported
empty string (--proxy "") for direct connection extractors
--no-check-certificate Suppress HTTPS certificate validation. --proxy URL Use the specified HTTP/HTTPS proxy. Pass in
--cache-dir DIR Location in the filesystem where youtube-dl can an empty string (--proxy "") for direct
store some downloaded information permanently. By connection
default $XDG_CACHE_HOME/youtube-dl or ~/.cache --no-check-certificate Suppress HTTPS certificate validation.
/youtube-dl . At the moment, only YouTube player --cache-dir DIR Location in the filesystem where youtube-dl
files (for videos with obfuscated signatures) are can store some downloaded information
cached, but that may change. permanently. By default $XDG_CACHE_HOME
--no-cache-dir Disable filesystem caching /youtube-dl or ~/.cache/youtube-dl . At the
--socket-timeout None Time to wait before giving up, in seconds moment, only YouTube player files (for
--bidi-workaround Work around terminals that lack bidirectional videos with obfuscated signatures) are
text support. Requires bidiv or fribidi cached, but that may change.
executable in PATH --no-cache-dir Disable filesystem caching
--default-search PREFIX Use this prefix for unqualified URLs. For example --socket-timeout None Time to wait before giving up, in seconds
"gvsearch2:" downloads two videos from google --bidi-workaround Work around terminals that lack
videos for youtube-dl "large apple". By default bidirectional text support. Requires bidiv
(with value "auto") youtube-dl guesses. or fribidi executable in PATH
--default-search PREFIX Use this prefix for unqualified URLs. For
example "gvsearch2:" downloads two videos
from google videos for youtube-dl "large
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
(e.g. 50k or 44.6m) SIZE (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
50k or 44.6m) (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
--load-info FILE json file containing the video information is given
(created with the "--write-json" option) --restrict-filenames Restrict filenames to only ASCII
-w, --no-overwrites do not overwrite files characters, and avoid "&" and spaces in
-c, --continue force resume of partially downloaded files. By filenames
default, youtube-dl will resume downloads if -a, --batch-file FILE file containing URLs to download ('-' for
possible. stdin)
--no-continue do not resume partially downloaded files (restart --load-info FILE json file containing the video information
from beginning) (created with the "--write-json" option)
--cookies FILE file to read cookies from and dump cookie jar in -w, --no-overwrites do not overwrite files
--no-part do not use .part files -c, --continue force resume of partially downloaded files.
--no-mtime do not use the Last-modified header to set the By default, youtube-dl will resume
file modification time downloads if possible.
--write-description write video description to a .description file --no-continue do not resume partially downloaded files
--write-info-json write video metadata to a .info.json file (restart from beginning)
--write-annotations write video annotations to a .annotation file --cookies FILE file to read cookies from and dump cookie
--write-thumbnail write thumbnail image to disk jar in
--no-part do not use .part files
--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
--write-annotations write video annotations to a .annotation
file
--write-thumbnail write thumbnail image to disk
## Verbosity / Simulation Options: ## Verbosity / Simulation Options:
-q, --quiet activates quiet mode --youtube-include-dash-manifest Try to download the DASH manifest on
-s, --simulate do not download the video and do not write YouTube videos (experimental)
anything to disk -q, --quiet activates quiet mode
--skip-download do not download the video -s, --simulate do not download the video and do not write
-g, --get-url simulate, quiet but print URL anything to disk
-e, --get-title simulate, quiet but print title --skip-download do not download the video
--get-id simulate, quiet but print id -g, --get-url simulate, quiet but print URL
--get-thumbnail simulate, quiet but print thumbnail URL -e, --get-title simulate, quiet but print title
--get-description simulate, quiet but print video description --get-id simulate, quiet but print id
--get-duration simulate, quiet but print video length --get-thumbnail simulate, quiet but print thumbnail URL
--get-filename simulate, quiet but print output filename --get-description simulate, quiet but print video description
--get-format simulate, quiet but print output format --get-duration simulate, quiet but print video length
-j, --dump-json simulate, quiet but print JSON information --get-filename simulate, quiet but print output filename
--newline output progress bar as new lines --get-format simulate, quiet but print output format
--no-progress do not print progress bar -j, --dump-json simulate, quiet but print JSON information
--console-title display progress in console titlebar --newline output progress bar as new lines
-v, --verbose print various debugging information --no-progress do not print progress bar
--dump-intermediate-pages print downloaded pages to debug problems (very --console-title display progress in console titlebar
verbose) -v, --verbose print various debugging information
--write-pages Write downloaded intermediary pages to files in --dump-intermediate-pages print downloaded pages to debug problems
the current directory to debug problems (very verbose)
--write-pages Write downloaded intermediary pages to
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 only)
video --all-subs downloads all the available subtitles of
--list-subs lists all available subtitles for the video the video
--sub-format FORMAT subtitle format (default=srt) ([sbv/vtt] youtube --list-subs lists all available subtitles for the video
only) --sub-format FORMAT subtitle format (default=srt) ([sbv/vtt]
--sub-lang LANGS languages of the subtitles to download (optional) youtube only)
separated by commas, use IETF language tags like --sub-lang LANGS languages of the subtitles to download
'en,pt' (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
-p, --password PASSWORD account password -p, --password PASSWORD account password
-n, --netrc use .netrc authentication data -n, --netrc use .netrc authentication data
--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
--embed-subs embed subtitles in the video (only for mp4 post-processing; the video is erased by
videos) default
--add-metadata write metadata to the video file --no-post-overwrites do not overwrite post-processed files; the
--xattrs write metadata to the video file's xattrs (using post-processed files are overwritten by
dublin core and xdg standards) default
--prefer-avconv Prefer avconv over ffmpeg for running the --embed-subs embed subtitles in the video (only for mp4
postprocessors (default) videos)
--prefer-ffmpeg Prefer ffmpeg over avconv for running the --add-metadata write metadata to the video file
postprocessors --xattrs write metadata to the video file's xattrs
(using dublin core and xdg standards)
--prefer-avconv Prefer avconv over ffmpeg for running the
postprocessors (default)
--prefer-ffmpeg Prefer ffmpeg over avconv for running the
postprocessors
# CONFIGURATION # CONFIGURATION

2
youtube_dl/version.py
View file

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