NOTE: NOT WORKING!!!!!!

Youtube changed the API so this script is outdated and not working... Not planing on fixing it anytime soon. Sorry

As an alternative use youtube-dl with the --write-auto-sub option (thanks to coderholic)

DESCRIPTION

This class allows you to download the caption from a video from you tube It support: - Downloading a track if video has multiple tracks (you have to know the name of the track) - Automatic translation to another language

PYTHON CLASS USAGE

Example:
        >>> import getyoutubecc
        #import the library
        >>> cc = getyoutubecc.getyoutubecc('2XraaWefBd8','en')
        # Now in cc.caption_obj are the parsed captions, its syntax is like:
        # [{'texlines': [u"caption first line", 'caption second line'],
        #    'time': {'hours':'1', 'min':'2','sec':44,'msec':232} }]
        # Modify the caption as you want if desired
        >>> cc.writeSrtFile('captionsfile.srt')
        #write the contents to a srt file
     
     Notes:
       MULTITRACK VIDEO
       if video is a multitrack video (or the track has a name) you need
       to specify the name of the track:
        >>> cc = getyoutubecc.getyoutubecc('pNiFoYt69-w','fr','french')
       TRANSLATE VIDEO
       if you prefer the automatic translation to another language use 
       the lang code
        >>> cc = getyoutubecc.getyoutubecc('pNiFoYt69-w','fr','french', tlang:'es')

COMMAND LINE USAGE

If you prefer the command line version of this, or just to test it:

        $ ./getyoutubecc.py -h
        getyoutubecc -v <video_id> -l <language_id> [-t <track_name>] [-T <translate_to>]
        Example: getyoutubecc -v pNiFoYt69-w -l fr -t french -T es
        Example: getyoutubecc -v 2XraaWefBd8 -l en 
        NOTE: if video has a track name, the -t argument is mandatory

OPTIONS:

-v --videoid        Video id. Like 2XraaWefBd8. It appears in every youtube URL
-l --language       iso lang code. Like en, es, fr..
-t --track          The name of the track if video has several. You will have to find out
                    this name in the youtube page of the video
-T --translate      iso lang code. Like en,es, fr of the language you want to tranlate to

COPYRIGHT

this code is released into the public domain by the copyright holders.

TODO

Test the code, different languages in diferent videos for instance
Improve regular expresion
Add support for the automatic generate captions service in youtube

ivanxuu / getyoutubecc