Advertisement
Not a member of Pastebin yet?
Sign Up,
it unlocks many cool features!
- YOUTUBE-DL(1) User Contributed Perl Documentation YOUTUBE-DL(1)
- NAME
- youtube-dl - download videos from youtube.com
- SYNOPSIS
- youtube-dl [options] url ...
- DESCRIPTION
- youtube-dl is a script to download videos from youtube.com.
- 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.
- --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 <rbrito@users.sf.net>.
- perl v5.12.4 2011-08-05 YOUTUBE-DL(1)
Advertisement
Add Comment
Please, Sign In to add comment
Advertisement