- Video format
- Uploader video list
- Info output
- Youtube-dl config file
- List extractors
- Extractor descriptions
- LICENSE AND COPYRIGHT
getvideo - Download YouTube and other videos.
getvideo -h|-?|--help getvideo getvideo url [url ...] getvideo -f|--file filename
Download single videos or choose videos from a playlist or an uploader.
getvideo followed by the space separated urls or enter the urls after calling
getvideo. If the urls are entered after calling
getvideo, shell metacharacters are escaped automatically.
The urls can also be passed with a file:
getvideo -f|--file filename. The urls in the file have to be space separated.
If a passed url results in more than one video, it is shown a menu with the video titles. The user can then choose from the menu which videos to download. It is possible to filter the video titles of the list menu with a regexp. The filter can be inverted by adding
!~ and a space in front of the regexp. Use the
SpaceBar to select more than one video - see "USAGE-AND-RETURN-VALUES" in Term::Choose.
The different options of
getvideo can be reached by calling
App::YTDL uses youtube-dl to get the info data and to download the videos. To list the extractors supported by
getvideo -h and select the entry List extractors.
Shows this HELP text.
Shows the path and the version of the running
getvideo, the path of the video and configuration directories and the version of
ffprobe are available, their version is also shown.
Choose an alternative main video directory.
Create/use extractor directories.
Create/use uploader directories
- if chosen from an uploader or a playlist
Which format info should be added to the filename.
- none (unsafe)
- video-height (unsafe)
- format-id and video-height
none and video-height are unsafe because the don't result in an unambiguous filename and could therefore overwrite previously downloaded files.
Set the video height.
If set to manually:
+ => "merge",
, => "and",
/ => "or". See
youtube-dl documentation format section.
Download videos whose height is unknown.
Prefer free video formats (--prefer-free-formats).
Set the useragent string (--user-agent).
Set the number of download retries (--retries).
Connection timeout in seconds (--socket-timeout).
If no arguments are passed to
getvideo, the user can choose videos from uploaders saved in the history file and the sticky file.
Size history sets the limit of the number of uploaders saved in the history file. Setting size history to
0 disables the uploader-history.
An uploader can be made sticky. Uploaders made sticky don't count regarding the size history limit. An uploader made sticky gets also a new timestamp.
When added to the uploader-history an uploader gets the current timestamp. If the size history limit is reached, the uploader with the oldest timestamp is removed first.
The supported extractors are YouTube and Vimeo.
Sort the history
- by name
- by timestamp
- all standard (list all uploader/playlist videos in the menu).
- all fast (list all uploader/playlist videos in the menu).
- latest (list only the latest videos in the menu - Vimeo: 48, YouTube: 50).
If all fast or latest fast is chosen, the download of the required data for the list-menu takes less time since the data required for the video downloads is fetched later only for the chosen videos.
With all fast or latest fast enabled a progress info is shown.
- Vimeo (no view-count available).
- YouTube (the upload-date is relative to now).
Sort the videos in the list-menu by
- upload date (fallback title);
- view count (fallback upload date)
- duration (fallback upload date)
Fallback is used, if the chosen entry is not available.
- if sorted by view count
youtube-dl warnings (--no-warnings).
Set the maximum width of the video info output.
Location of the
youtube-dl configuration file (--config-location).
Do not read
youtube-dl configuration files (--ignore-config).
List the extractors supported by
Output descriptions of supported extractors.
Requires Perl version 5.10.0 or greater.
A recent version of youtube-dl is required.
The merge feature requires
It is required a terminal that uses a monospaced font which supports the printed characters.
App::YTDL uses youtube-dl to get the data required for the video download.
Copyright (C) 2013-2020 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.