X-Git-Url: https://git.rapsys.eu/youtubedl/blobdiff_plain/46ef599ac108f9d54c9d505ef1ac1c62dde6bbbe..dcdd785ff55b06ac83ee1001689739f8ee68f0c5:/debian/youtube-dl.pod diff --git a/debian/youtube-dl.pod b/debian/youtube-dl.pod index db8eb67..78f44eb 100644 --- a/debian/youtube-dl.pod +++ b/debian/youtube-dl.pod @@ -1,7 +1,7 @@ # -*- pod -*- =head1 NAME -youtube-dl - download videos from youtube.com +youtube-dl - download videos from youtube.com or other video platforms =head1 SYNOPSIS @@ -9,7 +9,13 @@ youtube-dl - download videos from youtube.com =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 @@ -38,6 +44,10 @@ Print help text and exit. 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. @@ -46,6 +56,25 @@ Ignore errors during download and continue processing. Limit the download speed to the specified maximum B (e.g., 50k or 44.6m). +=item -R B, --retries=B + +Number B of retries for a given download (default is 10). + +=item --playlist-start=B + +The number B of the video in a playlist where we should start downlading +(default is 1). + +=item --playlist-end=B + +The number B 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, --username=B Specify the youtube account username B. Some videos require an @@ -59,27 +88,50 @@ Like the username, specifies the account password to be B. =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, --format=B -=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 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. -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 + +Limit the maximum quality of the videos to downloads to B. =item -q, --quiet @@ -102,6 +154,29 @@ wget or aria2c. 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. @@ -112,6 +187,11 @@ 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. +=item -A, --auto-number + +When downloading multiple videos from a playlist, automatically number them, +in sequence, starting from 00000. + =item -o B, --output=B Specify a template B for the names of the files to be created when @@ -133,6 +213,28 @@ Do no overwrite already existing files. Resume partially downloaded files. +=item --cookies=B + +Store the received cookies to file B (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 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 + +Set the audio format to be used for the extraction. Possible values are +I, I, I, with I being the default. + =back =head1 OUTPUT TEMPLATE @@ -189,7 +291,7 @@ like C<%(title)s-%(id)s.%(ext)s>. You can specify your own. =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 . =cut