A set of tools (API + script) to read, write and transform captions from/to many formats
Project description
Introduction
This package is a set of tools to transform captions from one format to another. You will find Writer and Reader for each format and a script if you want to use it in command line.
Supported Format:
sbv Reader and Writer
srt Reader and Writer
ttml Reader and Writer
transcript Reader and Writer
How to use (API)
You can read the provided unittest to have complete examples:
from captionstransformer.sbv import Reader from captionstransformer.ttml import Writer from StringIO import StringIO test_content = StringIO(u""" 0:00:03.490,0:00:07.430 >> FISHER: All right. So, let's begin. This session is: Going Social 0:00:07.430,0:00:11.600 with the YouTube APIs. I am Jeff Fisher, 0:00:11.600,0:00:14.009 and this is Johann Hartmann, we're presenting today. 0:00:14.009,0:00:15.889 [pause] """) reader = Reader(test_content) captions = reader.read() len(captions) == 4 first = captions[0] type(first.text) == unicode first.text == u">> FISHER: All right. So, let's begin.\nThis session is: Going Social\n" # next get a writer filelike = StringIO() writer = Writer(filelike) writer.set_captions(captions) text = writer.captions_to_text() text.startswith(u"""<tt xml:lang="" xmlns="http://www.w3.org/ns/ttml"><body><div>""") writer.write() writer.close()
About Formats
This quite hard to find simple documentation about existing caption format. Here is a set of existing named caption format:
SubViewer (SUB):
00:04:35.03,00:04:38.82 Hello guys... please sit down... 00:05:00.19,00:05:03.47 M. Franklin,[br]are you crazy?
Youtube (SBV):
0:00:03.490,0:00:07.430 FISHER: All right. So, let's begin. This session is: Going Social 0:00:07.430,0:00:11.600 with the YouTube APIs. I am Jeff Fisher, 0:00:11.600,0:00:14.009 and this is Johann Hartmann, we're presenting today. 0:00:14.009,0:00:15.889 [pause]
SubRip (SRT):
1 00:00:03,490 --> 00:00:07,430 FISHER: All right. So, let's begin. This session is: Going Social 00:00:07,430 --> 00:00:11,600 with the YouTube APIs. I am Jeff Fisher, 2 00:00:11,600 --> 00:00:14,009 and this is Johann Hartmann, we're presenting today. 3 00:00:14,009 --> 00:00:15,889 [pause]
Timed Text Markup Language (TTML):
<tt xml:lang="" xmlns="http://www.w3.org/ns/ttml">
<body region="subtitleArea">
<div>
<p xml:id="subtitle1" begin="0.76s" end="3.45s">
It seems a paradox, does it not,
</p>
<p xml:id="subtitle2" begin="5.0s" end="10.0s">
that the image formed on<br/>
the Retina should be inverted?
</p>
</div>
</body>
</tt>
Transcript
<?xml version="1.0" encoding="utf-8" ?>
<transcript>
<text start="10" dur="2">Hi, I&#39;m Emily from Nomensa</text>
<text start="12" dur="3">and today I&#39;m going to be talking about the order of content on your pages.</text>
<text start="16" dur="6">Making sure the content on your web pages is presented logically is a really important part of web accessibility.</text>
<text start="23" dur="2">Page content should be ordered so it makes sense</text>
</transcript>
Microsoft SAMI (SAMI, SMI):
<SAMI>
<Head>
<Title>President John F. Kennedy Speech</Title>
<SAMIParam>
Copyright {(C)Copyright 1997, Microsoft Corporation}
Media {JF Kennedy.wav}
Metrics {time:ms; duration: 73000;}
Spec {MSFT:1.0;}
</SAMIParam>
</Head>
<Body>
<SYNC Start=0>
<P Class=ENUSCC ID=Source>Pres. John F. Kennedy
<SYNC Start=10>
<P Class=ENUSCC>Let the word go forth,
from this time and place to friend and foe
alike that the torch
</Body>
</SAMI>
Credits
Companies
Authors
JeanMichel FRANCOIS aka toutpt <toutpt@gmail.com>
Changelog
1.2.1 (2012-08-07)
force rawcontent to be unicode
1.2 (2012-08-06)
add support for time format like start=”1.8” in transcript
add youtube download captions: captionstransformer.youtube.get_captions & get_reader
1.1 (2012-08-05)
add extension and mimetype info into REGISTRY
add id info into REGISTRY
1.0 (2012-07-23)
Initial release
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
