youtube-dl - download videos from youtube.com or other video platforms

Name: 
youtube-dl
Rank: 
5 626
Installed: 
62 339
Vote: 
1 159
Štítky: 
English

YOUTUBE-DL(1) User commands YOUTUBE-DL(1)

NAME
youtube-dl - download videos from youtube.com or other video platforms

SYNOPSIS
youtube-dl [options] url ...

DESCRIPTION
youtube-dl is a script to download videos from youtube.com or any other
of the supported video platforms.

Currently supported sites are: CollegeHumor, Comedy Central,
Dailymotion, Facebook, Metacafe, MyVideo, Photobucket, The Escapist,
Vimeo, Yahoo!, YouTube, blip.tv, depositfiles.com, video.google.com,
xvideos, Soundcloud, InfoQ, Mixcloud, OpenClassRoom.

Once it is installed in your system, you should be able to call it from
the command line. Usage instructions are easy. Use youtube-dl followed
by a video URL or identifier. As an example, consider:

youtube-dl "http://www.youtube.com/watch?v=foobar"

The video will be saved to the file "foobar.flv" in that example. Many
YouTube.com videos are in Flash Video format and their extension would
be "flv". Other videos are encoded in H.264 and these usually have the
extension "mp4". In Linux and other unices, video players using a
recent version of ffmpeg can play them. That includes MPlayer, VLC,
xine, among others.

OPTIONS
youtube-dl accepts options in the following categories

-h, --help
Print help text and exit.

-v, --version
Print program version and exit.

-U, --update
Update this program to the latest stable version.

-i, --ignore-errors
Ignore errors during download and continue processing.

-r L, --rate-limit=L
Limit the download speed to the specified maximum L (e.g., 50k or
44.6m).

-R R, --retries=R
Number R of retries for a given download (default is 10).

--playlist-start=N
The number N of the video in a playlist where we should start
downlading (default is 1).

--playlist-end=N
The number N of the video in a playlist where we should stop
downloading (default is -1, which stands for the last video in the
playlist).

--dump-user-agent
Display how youtube-dl will identify itself (the User-Agent string)
to the remote server.

-u UN, --username=UN
Specify the youtube account username UN. Some videos require an
account to be downloaded, mostly because they're flagged as mature
content.

-p PW, --password=PW
Like the username, specifies the account password to be PW.

-n, --netrc
Get authentication data from the standard unix .netrc file on the
user's home directory. The machine name is youtube regarding this
usage.

-f FMT, --format=FMT
Specify the video format (quality) in which to download the video.

For youtube.com, in particular, the meaning of the format codes is
given as:

WebM video at 480p: 43
WebM video at 720p: 45
H264 video in MP4 container at 480p: 18
H264 video in MP4 container at 720p: 22
H264 video in MP4 container at 1080p: 37
H264 video in FLV container at 360p: 34
H264 video in FLV container at 480p: 35
H263 video at 240p: 5
3GP video: 17

Note that not all videos are available in all formats and that
other sites supported by youtube-dl may have different conventions
for their video formats.

By default, youtube-dl will download the best available format; if
you want to download the worst format to save bandwidth and time,
use "-f" worst.

--all-formats
Downloads all formats for which a video may be available.

--max-quality=FMT
Limit the maximum quality of the videos to downloads to FMT.

-q, --quiet
Activates quiet mode, avoiding many messages being written to the
terminal.

-s, --simulate
Simulate the operation, but do not download the video. Useful for
testing.

-g, --get-url
Simulate the operation, like quiet mode, but show the URL that
would be used to download the video. Can be used with other
download tools like wget or aria2c.

-e, --get-title
Simulate the operation, like quiet mode, but show the title of the
video that would be downloaded.

--get-thumbnail
Simulate the operation, like quiet mode, but print the URL of of
the video's thumbnail.

--get-description
Simulate the operation, like quiet mode, but print the description
of the video.

--get-filename
Simulate the operation, like quiet mode, but print the output
filename.

--no-progress
Do not print the progress bar during downloads.

--console-title
If possible, set the title of the console window with the progress
of the download.

-t, --title
Use the title of the video in the file name used to download the
video.

-l, --literal
Use the literal title of the video in file name used to download
the video. Can contain "weird" characters that are not filtered
like with the -t option.

-A, --auto-number
When downloading multiple videos from a playlist, automatically
number them, in sequence, starting from 00000.

-o TPL, --output=TPL
Specify a template TPL for the names of the files to be created
when they are downloaded. The default filename is video_id.flv. But
you can also use the video title in the filename with the "-t" or
"--title" option, or preserve the literal title in the filename
with the "-l" or "--literal" option.

-a F, --batch-file=F
Specify the name of a file containing URLs of videos to download
from youtube in batch mode. The file must contain one URL per line.

-w, --no-overwrites
Do no overwrite already existing files.

-c, --continue
Resume partially downloaded files.

--cookies=F
Store the received cookies to file F (the "cookie jar").

--no-part
Do not append the .part suffix do files that have not yet been
completed.

--no-mtime
Do not use the Last-modified header to set the file modification
time.

--extract-audio
Create an audio-only file extracted from the video downloaded.
Requires that ffmpeg and ffprobe be installed.

--audio-format=FORMAT
Set the audio format to be used for the extraction. Possible values
are best, aac, mp3, with best being the default.

OUTPUT TEMPLATE
The -o option allows users to indicate a template for the output file
names. The basic usage is not to set any template arguments when
downloading a single file, like in youtube-dl -o funny_video.flv
"http://some/video". However, it may contain special sequences that
will be replaced when downloading each video.

The special sequences have the format "%(NAME)s". To clarify, that's a
percent symbol followed by a name in parenthesis, followed by a
lowercase S. Allowed names are:

id The sequence will be replaced by the video identifier.

url The sequence will be replaced by the video URL.

uploader
The sequence will be replaced by the nickname of the person who
uploaded the video.

title
The sequence will be replaced by the literal video title.

stitle
The sequence will be replaced by a simplified video title,
restricted to alphanumeric characters and dashes.

ext The sequence will be replaced by the appropriate extension (like
"flv" or "mp4").

epoch
The sequence will be replaced by the Unix epoch when creating the
file.

As you may have guessed, the default template is "%(id)s.%(ext)s". When
some command line options are used, it's replaced by other templates
like "%(title)s-%(id)s.%(ext)s". You can specify your own.

AUTHOR
youtube-dl was written by Ricardo Garcia Gonzalez and many contributors
from all around the internet. This manpage was written by Rogerio
Brito .

youtube-dl 2012-03-17 YOUTUBE-DL(1)