---
name: "gcap"
section: "1p"
platform: "linux"
package: "gcap"
version: "0.1.1-2.1"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/gcap"
---

# gcap(1p)

Youtube closed caption downloader

## 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\>