Sublib

Python library for easier management and processing of subtitle files. Easily manage their content and conveniently use it in your own projects.

Features

Read files data
Convert subtitles formats
Process content separated into lines
Search for strings in data
Acquire specific lines
Detect used format

Installation

Download the latest version from PyPi

python -m pip install sublib

Testing

Perform the tests with pytest and pytest-mock

python -m pytest tests

Basic usage

First of all, import the package

import sublib

Each of the supported formats of subtitles is represent by its class

# Create a subtitle instance
subtitle = sublib.SubRip("subtitle.srt", "utf-8")

All subtitles classes have a few methods and attributes

# Get object content in a universal format
general = subtitle.get_general_format()

# Set a new object from this format
another_subtitle = sublib.MicroDVD()
another_subtitle.set_from_general_format(general)

# Print subtitle lines
print(another_subtitle.content)

Advanced usage

Please, take a look if you need more details

Contributing

Pull requests are welcome!