https://github.com/ivanxuu/getyoutubecc

it fetch closed captions from youtube videos if available
https://github.com/ivanxuu/getyoutubecc

Last synced: 6 days ago
JSON representation

it fetch closed captions from youtube videos if available

• Host: GitHub
• URL: https://github.com/ivanxuu/getyoutubecc
• Owner: ivanxuu
• Created: 2011-10-27T11:34:13.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2015-02-07T08:58:42.000Z (almost 10 years ago)
• Last Synced: 2023-08-01T10:11:42.184Z (over 1 year ago)
• Language: Python
• Homepage:
• Size: 221 KB
• Stars: 30
• Watchers: 4
• Forks: 8
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
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  -l  [-t ] [-T ]

            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