getvideo - Download YouTube and other videos.
Version 0.103
getvideo -h|-?|--help getvideo getvideo url [url ...] getvideo -f|--file filename
The urls can be entered after calling getvideo - this is useful if urls contain shell metacharacters like &.
getvideo
&
The urls can also be passed with a file: getvideo -f|--file filename. The urls in the file have to be space separated.
getvideo -f|--file filename
With this release the format of the files created by getvideo - apart from the log file - have changed. To see where the configuration directory with these files is located call getvideo -h and select INFO.
getvideo -h
Download single videos or/and choose videos from playlists or/and channels.
When choosing from a channel or a playlist it is possible to filter the displayed video titles with a regexp.
Before the download the script shows some video info and lets you choose the video quality from the available qualities.
Instead of choosing the quality manually it is possible to set and use preferred qualities.
To set the different options call getvideo -h.
App::YTDL uses youtube-dl to get the data required for the video download.
App::YTDL
Set the option Auto quality mode to 0 or 1. Then, when downloading a video, instead of selecting the desired video quality select the entry "Menu" and then the entry "Preferred qualities".
0
1
Non mappable characters on the output are replaced with *. In file names they are replaced with &#xNNN; where NNN is the Unicode code point in a decimal number.
*
&#xNNN;
Shows this HELP text.
Shows the path and the version of the running getvideo, the path of the video and the configuration directory and the version of youtube-dl.
youtube-dl
Choose an alternative main video directory.
0 => No.
1 => Create/use extractor directories.
0 => Don't create/use channel directories.
1 => Create/use channel directories if the videos are chosen from a channel or a list.
2 => Always create/use channel directories.
Set the maximum length of the filename. Filenames longer as the maximum length are truncated.
Change the file timestamps to the upload date.
Set the auto quality mode:
mode 0: choose the video quality always manually
mode 1: keep the first quality chosen for a video of a playlist/channel for all videos of that playlist/channel if possible.
mode 2: keep the first quality chosen for a video of an extractor for all videos of that extractor if possible.
mode 3: use preferred qualities.
mode 4: use always the default (best) quality.
Prints the set preferred qualities.
See "Where to set the preferred qualities".
Set the useragent.
If entered nothing the default useragent (Mozilla/5.0) is used.
If Overwrite is enabled, existing files are overwritten.
If not enabled, getvideo appends to partially downloaded file with the same name.
Set the number of download retries.
Timeout (seconds) is used as the value for the youtube-dl parameter --socket-timeout. timeout is also used as the value for the LWP::UserAgent option timeout when fetching the data required for the video download.
--socket-timeout
timeout
Enable info logging to a log file.
If no arguments are passed to getvideo, the user can choose from the channels saved in the channel-history and the channel-sticky file.
Channel history sets the limit of the number of channels saved in the channel history file. Setting Channel history to 0 disables the channel history.
A channel can be made sticky. Channels made sticky don't count regarding the Channel history limit. If a channel is made sticky, it gets also a new timestamp.
When added to the channel history channels get the return value of time() as a timestamp. If the limit is reached, the channel with the oldest timestamp is removed first.
time()
The supported extractors are YouTube and Vimeo.
Sort the channels from the history file by name or by timestamp.
Set the maximum width of video info output.
Set the number of digits allocated for the "kilobyte per seconds" template.
If set to "YES", the latest videos from a channel/list are on top of the list menu else they are at the end of the menu.
Requires Perl version 5.10.0 or greater.
youtube-dl is required.
For a correct output it is required an appropriate encoding layer for STDOUT matching the terminal's character set.
It is required a terminal that uses a monospaced font which supports the printed characters.
Thanks to the Perl-Community.de and the people form stackoverflow for the help.
Kuerbis <cuer2s@gmail.com>
Copyright (C) 2013-2015 Kuerbis.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl 5.10.0. For details, see the full text of the licenses in the file LICENSE.
To install App::YTDL, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::YTDL
CPAN shell
perl -MCPAN -e shell install App::YTDL
For more information on module installation, please visit the detailed CPAN module installation guide.