2011-02-22 22:28:51 +08:00
|
|
|
# youtube-dl
|
|
|
|
|
|
|
|
|
|
Allows you to download and transcode video from supported sites. Needs ffmpeg for transcoding to work.
|
|
|
|
|
|
|
|
|
|
## Supported sites
|
|
|
|
|
|
|
|
|
|
* Youtube
|
|
|
|
|
* Metacafe
|
|
|
|
|
* Dailymotion
|
|
|
|
|
* Google
|
|
|
|
|
* Photobucket
|
|
|
|
|
* Yahoo
|
|
|
|
|
* DepositFiles
|
|
|
|
|
* Facebook
|
|
|
|
|
* Sites with JW Player
|
2011-02-22 22:31:07 +08:00
|
|
|
|
2011-02-22 22:28:51 +08:00
|
|
|
## Installation
|
|
|
|
|
|
|
|
|
|
$ sudo apt-get install ffmpeg # for Ubuntu
|
|
|
|
|
$ sudo wget --no-check-certificate https://github.com/dz0ny/youtube-dl/raw/master/youtube-dl -O /usr/local/bin/youtube-dl && sudo chmod a+x /usr/local/bin/youtube-dl
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
$ youtube-dl [options] url...
|
|
|
|
|
|
|
|
|
|
Options:
|
|
|
|
|
-h, --help print this help text and exit
|
|
|
|
|
-v, --version print program version and exit
|
|
|
|
|
-U, --update update this program to latest stable version
|
|
|
|
|
-i, --ignore-errors continue on download errors
|
|
|
|
|
-r LIMIT, --rate-limit=LIMIT
|
|
|
|
|
download rate limit (e.g. 50k or 44.6m)
|
|
|
|
|
-R RETRIES, --retries=RETRIES
|
|
|
|
|
number of retries (default is 10)
|
|
|
|
|
--playlist-start=NUMBER
|
|
|
|
|
playlist video to start at (default is 1)
|
|
|
|
|
--playlist-end=NUMBER
|
|
|
|
|
playlist video to end at (default is last)
|
|
|
|
|
--dump-user-agent display the current browser identification
|
|
|
|
|
|
|
|
|
|
Authentication Options:
|
|
|
|
|
-u USERNAME, --username=USERNAME
|
|
|
|
|
account username
|
|
|
|
|
-p PASSWORD, --password=PASSWORD
|
|
|
|
|
account password
|
|
|
|
|
-n, --netrc use .netrc authentication data
|
|
|
|
|
|
|
|
|
|
Video Format Options:
|
|
|
|
|
-f FORMAT, --format=FORMAT
|
|
|
|
|
video format code
|
|
|
|
|
--all-formats download all available video formats
|
|
|
|
|
--max-quality=FORMAT
|
|
|
|
|
highest quality format to download
|
|
|
|
|
|
|
|
|
|
Verbosity / Simulation Options:
|
|
|
|
|
-q, --quiet activates quiet mode
|
|
|
|
|
-s, --simulate do not download video
|
|
|
|
|
-g, --get-url simulate, quiet but print URL
|
|
|
|
|
-e, --get-title simulate, quiet but print title
|
|
|
|
|
--get-thumbnail simulate, quiet but print thumbnail URL
|
|
|
|
|
--get-description simulate, quiet but print video description
|
|
|
|
|
--get-filename simulate, quiet but print output filename
|
|
|
|
|
--no-progress do not print progress bar
|
|
|
|
|
--console-title display progress in console titlebar
|
|
|
|
|
|
|
|
|
|
Filesystem Options:
|
|
|
|
|
-t, --title use title in file name
|
|
|
|
|
-l, --literal use literal title in file name
|
|
|
|
|
-A, --auto-number number downloaded files starting from 00000
|
|
|
|
|
-o TEMPLATE, --output=TEMPLATE
|
|
|
|
|
output filename template
|
|
|
|
|
-a FILE, --batch-file=FILE
|
|
|
|
|
file containing URLs to download ('-' for stdin)
|
|
|
|
|
-w, --no-overwrites
|
|
|
|
|
do not overwrite files
|
|
|
|
|
-c, --continue resume partially downloaded files
|
|
|
|
|
--cookies=FILE file to dump cookie jar to
|
|
|
|
|
--no-part do not use .part files
|
|
|
|
|
--no-mtime do not use the Last-modified header to set the file
|
|
|
|
|
modification time
|
|
|
|
|
|
|
|
|
|
Transcoding Options (uses ffmpeg):
|
|
|
|
|
-T FILE_TYPE, --transcode_to=FILE_TYPE
|
|
|
|
|
transcode to specific video or audio format (example:
|
|
|
|
|
mp3 mp4 mov mkv)
|
|
|
|
|
--transcode_extra=ARGS
|
|
|
|
|
pass additional parameters to ffmpeg (example: -vcodec
|
|
|
|
|
libx264 -vpre slow -vpre ipod640 -b 2048k -acodec
|
|
|
|
|
libfaac -ab 96k)
|
|
|
|
|
|
|
|
|
|
# License
|
|
|
|
|
|
|
|
|
|
Public domain code
|
|
|
|
|
|
|
|
|
|
# Authors
|
|
|
|
|
|
|
|
|
|
* Ricardo Garcia Gonzalez
|
|
|
|
|
* Danny Colligan
|
|
|
|
|
* Benjamin Johnson
|
|
|
|
|
* Vasyl' Vavrychuk
|
|
|
|
|
* Witold Baryluk
|
|
|
|
|
* Paweł Paprota
|
|
|
|
|
* Gergely Imreh
|
|
|
|
|
* Janez Troha
|
