Utility to extract the contents of a subtitle file
Project description
pysub-parser
Utility to extract the contents of a subtitle file.
Supported types:
ass
: Advanced SubStation Alphassa
: SubStation Alphasrt
: SubRipsub
: MicroDVDtxt
: Sub Viewer
For more information: http://write.flossmanuals.net/video-subtitling/file-formats
Usage
The method parse requires the following parameters:
path
: location of the subtitle file.subtype
: one of the supported file types, by default file extension is used.encoding
: encoding of the file,utf-8
by default.**kwargs
: optional parameters.fps
: framerate (only used bysub
files),23.976
by default.
from pysubparser import parser
subtitles = parser.parse('./files/space-jam.srt')
for subtitle in subtitles:
print(subtitle)
Output:
0 > [BALL BOUNCING]
1 > Michael?
2 > What are you doing out here, son? It's after midnight.
3 > MICHAEL: Couldn't sleep, Pops.
Subtitle Class
Each line of a dialogue is represented with a Subtitle
object with the following properties:
index
: position in the file.start
: timestamp of the start of the dialog.end
: timestamp of the end of the dialog.text
: dialog contents.
for subtitle in subtitles:
print(f'{subtitle.start} > {subtitle.end}')
print(subtitle.text)
print()
Output:
00:00:36.328000 > 00:00:38.329000
[BALL BOUNCING]
00:01:03.814000 > 00:01:05.189000
Michael?
00:01:08.402000 > 00:01:11.404000
What are you doing out here, son? It's after midnight.
00:01:11.572000 > 00:01:13.072000
MICHAEL: Couldn't sleep, Pops.
Cleaners
Currently, 4 cleaners are provided:
ascii
will translate every unicode character to its ascii equivalent.brackets
will remove anything between them (e.g.,[BALL BOUNCING]
)formatting
will remove formatting keys like<i>
and</i>
.lower_case
will lower case all text.
from pysubparser.cleaners import ascii, brackets, formatting, lower_case
subtitles = brackets.clean(
lower_case.clean(
subtitles
)
)
for subtitle in subtitles:
print(subtitle)
0 >
1 > michael?
2 > what are you doing out here, son? it's after midnight.
3 > michael: couldn't sleep, pops.
Writers
Given any list of Subtitle
and a path it will output those subtitles in a srt
format.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pysub-parser-1.4.tar.gz
(6.1 kB
view hashes)
Built Distribution
pysub_parser-1.4-py3-none-any.whl
(10.9 kB
view hashes)
Close
Hashes for pysub_parser-1.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7eef1d7df22c398da6443b291dcb038a93c8d864c093b9e520c359ec65396ea3 |
|
MD5 | 4314b0b707ab068787d02473d0c05346 |
|
BLAKE2b-256 | 2511bc845475f6e769988d0a03e4e6f4e1bff2ff76004206d88e9f6cf5d79278 |