Installation    How to use    Troubleshooting    Manual download   

Installation

1. Verify your system has Java version 1.6 or higher installed. You can download it from http://www.java.com.
2. Run the installation package for your platform or decompress the ZIP file.
3. That's all! From now on you only need to remember that:
   a. If you use Windows, you should open Google2SRT.exe file.
   b. If you use GNU/Linux, you should open run.sh file.
   c. If you use Mac OS X, you should open Google2SRT.jar file.
   d. If you use another system, you should run on a shell or similar this command: "java -jar Google2SRT.jar".

How to use

• Change the language: click on the flags: , , ...


• Choose the source:
  
  
  • Web: you may provide one video address (URL) to convert subtitles from one video.
    
  • URL list: you may provide a list of URL in a text file (one URL per line) to convert subtitles from multiple videos.
  • XML file: you may provide a single XML subtitles file (manually downloaded) to convert it to SRT.


• Choose the output directory where you want to save subtitles on via SRT subtitles.
  Note: you should choose an empty directory. Files will be overwritten without asking for confirmation.


• Tracks: select what subtitles you want to convert from the list:
  
  
  • You may select individual subtitles.
  • All: all subtitles are selected.
  • Invert: current selection is inverted.


• Translations: select what translations you want to convert from the list:
  Note: you must select at least one source from Tracks. Suggestion: avoid an ASR source when possible.
  
  
  • You may select individual translations.
  • All: all translations are selected.
  • Invert: current selection is inverted.


• +Track: output file name will include the track name.


• +Title: output file name will include the video title.


• Delay (seconds): subtitles are delayed an amount of seconds (if the value is positive). You can obtain the opposite effect, move forward the subtitles, by writing negative values.
  Example: if subtitles appear 6.25 seconds too early, you should delay them 6.25 seconds. If subtitles appear 3.70 seconds too late, you should move them forward adding a delay of -3.70 seconds.


• Go!: it starts conversion process. If there are many subtitles (one or two hours of video, approximately 180 KB in SRT) it needs 5 seconds approximately (a single local XML file).


• Usage examples:

Subtitles from one single video (URL)		Translations from one single video (URL)
Subtitles from multiple videos (URL list)		One single XML subtitles file

Troubleshooting

• Problem: I use Web method and I write a valid URL with subtitles but it doesn't appear any subtitles list, appears a subtitles list but I can't convert them, I receive an unknown error or application finishes suddenly...
  Solution: Maybe subtitles obtaining method has changed. You should wait for a newer version or you can try to download subtitles manually (being helped by an sniffer).


• Problem: I receive meaningless error messages when an URL it's not correct or there is a network error.
  Solution: For now, you must be patient until appears a newer version...

Manual download



What can we do when Google2SRT cannot download the subtitles? We will have to manually download and convert them by choosing the "XML file" option. Currently, it is necessary to use this method if we want to download the subtitles that YouTube automatically translates from the original subtitles.

YouTube
Our video address is like this:


1. We will pay attention to the v parameter and we will see the available real subtitles list by browsing this address:


2a. We will see a XML code like this:


2b. If subtitles exist in our desired language, we can go to the step 3. If they do not exist, we also can load the available translated subtitles list by browsing this address:


2c. We will see a XML code like this:

Subtitles with <track> and cantran="true" are real; the other ones (with <target>) are languages which are available to translate the real subtitles to. It means that we will have to choose the real subtitle we want to use as source (for the translation) and the language that we really want.

3. We will pay attention to the name and lang_code parameters of the subtitle that we are interested in and we will go to:
Example: Spanish subtitles (real subtitles):

Example: Catalan subtitles (translated subtitles from Spanish):

Note that lang_code from the previous XML file is lang (real subtitle) or tlang (translated subtitle) in the URL address.
If some of the name or lang_code parameters are empty in the XML code that appeared in the step 2/2c, i.e., there is name="" or lang_code="", we will pass these parameters as empty parameters. See Google Video English subtitles example.

4. We will see a XML file like this:

5. We will save it with XML extension and it is ready to be converted to SRT by Google2SRT.


Google Video
Our video address is like this:


1. We will pay attention to the docid parameter and we will see the available subtitles list by browsing this address:


2. We will see a XML code like this:


3. We will pay attention to the name i lang_code parameters of the subtitle that we are interested in and we will go to:
Example: Spanish subtitles:

Example: English subtitles (name is empty):

Note that lang_code from the previous XML file is lang in the URL address.
If some of the name or lang_code parameters are empty in the XML code that appeared in the step 2, i.e., there is name="" or lang_code="", we will pass these parameters as empty parameters, like in the example of the English subtitles, where name does not have any value.

4. We will see a XML file like this:

5. We will save it with XML extension and it is ready to be converted to SRT by Google2SRT.