/pyasstosrt

Convert ASS subtitle to SRT format

Primary LanguagePythonApache License 2.0Apache-2.0

pyasstosrt

alt text Downloads Coverage Status

pyasstosrt – this tool will help you convert Advanced SubStation Alpha (ASS/SSA) subtitle files to SubRip (SRT) files.

Support for str path:

from pyasstosrt import Subtitle

sub = Subtitle('sub.ass')
sub.export()

Support for all Path-like objects, instead of only pathlib's Path:

from pathlib import Path

from pyasstosrt import Subtitle

path = Path('sub.ass')
sub = Subtitle(path)
sub.export()

You can get a sheet with dialogue by specifying output_dialogues.

from pathlib import Path

from pyasstosrt import Subtitle

path = Path('sub.ass')
sub = Subtitle(path)
sub.export(output_dialogues=True)

If you want to remove effects from text, you can use the removing_effects.

from pyasstosrt import Subtitle

sub = Subtitle('sub.ass', removing_effects=True)
sub.export()

You can enable the deletion of duplicate lines with the rearrangement of start and end times.

from pyasstosrt import Subtitle

sub = Subtitle('sub.ass', remove_duplicates=True)
sub.export()

CLI

pyasstosrt --filepath=/Users/user/sub/sub.ass export

Optional You can specify an export folder.

pyasstosrt --filepath=/Users/user/sub/sub.ass export /Users/user/sub/srt

Optional If you want to remove effects from text, you can use the --removing_effects flag.

pyasstosrt --filepath=/Users/user/sub/sub.ass --removing_effects=True export /Users/user/sub/srt

Installation

Most users will want to simply install the latest version, hosted on PyPI:

$ pip install 'pyasstosrt[cli]'

If you just want to use it as a library and don't need the CLI, you can omit the [cli] extra.