X-Git-Url: https://git.rapsys.eu/youtubedl/blobdiff_plain/bd15199ded03c9c60ee785f280f561fda87b56d2..9e819b7edb7bafddb753fd66e8417c76d9ae6616:/debian/youtube-dl.pod?ds=inline diff --git a/debian/youtube-dl.pod b/debian/youtube-dl.pod deleted file mode 100644 index 78f44eb..0000000 --- a/debian/youtube-dl.pod +++ /dev/null @@ -1,297 +0,0 @@ -# -*- pod -*- -=head1 NAME - -youtube-dl - download videos from youtube.com or other video platforms - -=head1 SYNOPSIS - - youtube-dl [options] url ... - -=head1 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 C in that example. Many -YouTube.com videos are in Flash Video format and their extension would -be C. Other videos are encoded in H.264 and these usually have the -extension C. In Linux and other unices, video players using a -recent version of ffmpeg can play them. That includes MPlayer, VLC, -xine, among others. - -=head1 OPTIONS - -B accepts options in the following categories - -=over - -=item -h, --help - -Print help text and exit. - -=item -v, --version - -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. - -=item -r B, --rate-limit=B - -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 -account to be downloaded, mostly because they're flagged as mature -content. - -=item -p B, --password=B - -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 regarding this usage. - -=item -f B, --format=B - -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: - -=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 - -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. - -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. - -=item --all-formats - -Downloads all formats for which a video may be available. - -=item --max-quality=B - -Limit the maximum quality of the videos to downloads to B. - -=item -q, --quiet - -Activates quiet mode, avoiding many messages being written to the -terminal. - -=item -s, --simulate - -Simulate the operation, but do not download the video. Useful for -testing. - -=item -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. - -=item -e, --get-title - -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. - -=item -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. - -=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 -they are downloaded. The default filename is video_id.flv. But you can -also use the video title in the filename with the C<-t> or C<--title> -option, or preserve the literal title in the filename with the C<-l> or -C<--literal> option. - -=item -a B, --batch-file=B - -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. - -=item -w, --no-overwrites - -Do no overwrite already existing files. - -=item -c, --continue - -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 - -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 C<%(NAME)s>. To clarify, that's a -percent symbol followed by a name in parenthesis, followed by a -lowercase S. Allowed names are: - -=over - -=item id - -The sequence will be replaced by the video identifier. - -=item url - -The sequence will be replaced by the video URL. - -=item uploader - -The sequence will be replaced by the nickname of the person who uploaded -the video. - -=item title - -The sequence will be replaced by the literal video title. - -=item stitle - -The sequence will be replaced by a simplified video title, restricted to -alphanumeric characters and dashes. - -=item ext - -The sequence will be replaced by the appropriate extension (like C -or C). - -=item epoch - -The sequence will be replaced by the Unix epoch when creating the file. - -=back - -As you may have guessed, the default template is C<%(id)s.%(ext)s>. When -some command line options are used, it's replaced by other templates -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 Rogerio Brito -. - -=cut