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>