# -*- pod -*-
=head1 NAME
-youtube-dl - download videos from youtube.com
+youtube-dl - download videos from youtube.com or other video platforms
=head1 SYNOPSIS
=head1 DESCRIPTION
-youtube-dl is a script to download videos from youtube.com.
+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
Print program version and exit.
+=item -U, --update
+
+Update this program to the latest stable version.
+
=item -i, --ignore-errors
Ignore errors during download and continue processing.
Limit the download speed to the specified maximum B<L> (e.g., 50k or 44.6m).
+=item -R B<R>, --retries=B<R>
+
+Number B<R> of retries for a given download (default is 10).
+
+=item --playlist-start=B<N>
+
+The number B<N> of the video in a playlist where we should start downlading
+(default is 1).
+
+=item --playlist-end=B<N>
+
+The number B<N> of the video in a playlist where we should stop downloading
+(default is -1, which stands for the last video in the playlist).
+
+=item --dump-user-agent
+
+Display how youtube-dl will identify itself (the User-Agent string) to the
+remote server.
+
=item -u B<UN>, --username=B<UN>
Specify the youtube account username B<UN>. Some videos require an
=item -n, --netrc
Get authentication data from the standard unix .netrc file on the user's
-home directory. The machine name is youtube in regarding this usage.
+home directory. The machine name is youtube regarding this usage.
+
+=item -f B<FMT>, --format=B<FMT>
-=item -f FMT, --format=FMT
+Specify the video format (quality) in which to download the video.
-Specify the video format (quality) in which to download the video. Note
-that not all videos are available in all formats.
+For youtube.com, in particular, the meaning of the format codes is given as:
-=item -b, --best-quality
+=over
+
+=item WebM video at 480p: 43
+
+=item WebM video at 720p: 45
+
+=item H264 video in MP4 container at 480p: 18
+
+=item H264 video in MP4 container at 720p: 22
+
+=item H264 video in MP4 container at 1080p: 37
+
+=item H264 video in FLV container at 360p: 34
+
+=item H264 video in FLV container at 480p: 35
+
+=item H263 video at 240p: 5
+
+=item 3GP video: 17
+
+=back
-Download the best video quality available for the video(s) specified by
-the user.
+Note that not all videos are available in all formats and that other
+sites supported by B<youtube-dl> may have different conventions for
+their video formats.
-=item -m, --mobile-version
+By default, youtube-dl will download the best available format; if you want
+to download the worst format to save bandwidth and time, use C<-f> I<worst>.
-Synonymous to the option "-f 17", to download videos playable on some
-mobile phones.
+=item --all-formats
-=item -d, --high-def
+Downloads all formats for which a video may be available.
-Synonymous to the option "-f 37", to download videos in HD quality
-(1080p).
+=item --max-quality=B<FMT>
+
+Limit the maximum quality of the videos to downloads to B<FMT>.
=item -q, --quiet
Simulate the operation, like quiet mode, but show the title of the video
that would be downloaded.
+=item --get-thumbnail
+
+Simulate the operation, like quiet mode, but print the URL of of the video's
+thumbnail.
+
+=item --get-description
+
+Simulate the operation, like quiet mode, but print the description of the
+video.
+
+=item --get-filename
+
+Simulate the operation, like quiet mode, but print the output filename.
+
+=item --no-progress
+
+Do not print the progress bar during downloads.
+
+=item --console-title
+
+If possible, set the title of the console window with the progress of the
+download.
+
=item -t, --title
Use the title of the video in the file name used to download the video.
video. Can contain "weird" characters that are not filtered like with
the -t option.
+=item -A, --auto-number
+
+When downloading multiple videos from a playlist, automatically number them,
+in sequence, starting from 00000.
+
=item -o B<TPL>, --output=B<TPL>
Specify a template B<TPL> for the names of the files to be created when
Resume partially downloaded files.
+=item --cookies=B<F>
+
+Store the received cookies to file B<F> (the "cookie jar").
+
+=item --no-part
+
+Do not append the I<.part> suffix do files that have not yet been completed.
+
+=item --no-mtime
+
+Do not use the I<Last-modified> header to set the file modification time.
+
+=item --extract-audio
+
+Create an audio-only file extracted from the video downloaded. Requires that
+ffmpeg and ffprobe be installed.
+
+=item --audio-format=B<FORMAT>
+
+Set the audio format to be used for the extraction. Possible values are
+I<best>, I<aac>, I<mp3>, with I<best> being the default.
+
=back
=head1 OUTPUT TEMPLATE
=head1 AUTHOR
youtube-dl was written by Ricardo Garcia Gonzalez and many contributors
-from all around the internet. This manpage was written by Rogério Brito
+from all around the internet. This manpage was written by Rogerio Brito
<rbrito@users.sf.net>.
=cut
Rapsys Git / youtubedl / blobdiff