NAME¶
gcap - Youtube closed caption downloader
SYNOPSIS¶
gcap [-i] [-t] [-r <regexp>] [--proxy=<addr> | --no-proxy]
[--help] <url> | <video_id>
DESCRIPTION¶
gcap is a command line tool for downloading Youtube closed captions. The
downloaded closed captions are saved in SubRip (srt) file format. The srt
files are saved as "$videoid_$langid.srt" by default.
OPTIONS¶
- --help
- Print help and exit.
- --version
- Print version and exit.
- -q, --quiet
- Be quiet.
- -i, --interactive
- Open the interactive prompt which can be used to select the
items. gcap selects all items by default. See also
"INTERACTIVE PROMPT".
- -t, --title
- Parse video title and use it in the output filename(s)
instead of video ID. The default is no.
- -r, --regexp=arg
- Cleanup video title using the specified arg regular
expression. The default is "/(\w|\s)/g".
- --proxy arg
- Use arg for HTTP proxy, e.g.
"http://foo:1234". Overrides the http_proxy environment
setting.
- --no-proxy
- Disable use of HTTP proxy. Overrides both
"--proxy" and http_proxy environment settings.
INTERACTIVE PROMPT¶
Use the "--interactive" switch to open the prompt. Note that gcap uses
(as of 0.1.0) the Umph::Prompt module for this. Once the prompt opens, type
"help" to get a list of commands available to the prompt.
EXAMPLES¶
- gcap 0QRO3gKj3qw
- gcap
"http://www.youtube.com/watch?v=0QRO3gKj3qw"
- Both yield the same results.
- gcap -ti 0QRO3gKj3qw
- Same as above two but use video title in the filename and
choose which of the closed captions should be downloaded.
EXIT STATUS¶
Exits 0 on success, otherwise 1.
FILES¶
- $HOME/.gcaprc, for example:
- echo "--interactive" >> ~/.gcaprc
NOTES¶
- Availability
- The following error message produced by gcap (or the
XML::DOM module) typically indicates that the video does not have any
closed captions available for it (URL omitted for brewity):
Couldn't parsefile [...] with LWP: no element found at line 1,
column 0, byte -1 at [...]/XML/Parser.pm [...]
- http_proxy
- gcap depends on XML::DOM which uses LWP::UserAgent to
download the data. Note that LWP::UserAgent reads http_proxy environment
setting. e.g.:
env http_proxy=http://foo:1234 gcap video_id
WWW¶
<
http://gcap.googlecode.com/>
<
http://repo.or.cz/w/gcap.git>
AUTHOR¶
Toni Gundogdu <legatvs at sign cpan org>