https://github.com/simonw/ttml-to-json

Convert TTML to JSON
https://github.com/simonw/ttml-to-json

Last synced: 27 days ago
JSON representation

Convert TTML to JSON

• Host: GitHub
• URL: https://github.com/simonw/ttml-to-json
• Owner: simonw
• License: apache-2.0
• Created: 2022-09-24T23:50:33.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2022-09-25T00:49:59.000Z (about 2 years ago)
• Last Synced: 2024-10-06T20:30:48.542Z (about 1 month ago)
• Language: Python
• Homepage:
• Size: 12.7 KB
• Stars: 5
• Watchers: 3
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# ttml-to-json

[![PyPI](https://img.shields.io/pypi/v/ttml-to-json.svg)](https://pypi.org/project/ttml-to-json/)

[![Changelog](https://img.shields.io/github/v/release/simonw/ttml-to-json?include_prereleases&label=changelog)](https://github.com/simonw/ttml-to-json/releases)

[![Tests](https://github.com/simonw/ttml-to-json/workflows/Test/badge.svg)](https://github.com/simonw/ttml-to-json/actions?query=workflow%3ATest)

[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/simonw/ttml-to-json/blob/master/LICENSE)

 Convert TTML to JSON

## Installation

Install this tool using `pip`:

    pip install ttml-to-json

## Usage

To output JSON for a TTML file:

    ttml-to-json subtitles.ttml

This will output to standard output. Use `-o filename` to send it to a specified file.

Use `-s` or `--single` to output single `"line"` keys instead of a `"lines"` array.

You can also use:

    python -m ttml_to_json ...

## Output

Regular output:

```json

[

    {

        "start": "00:00:00.000",

        "end": "00:00:04.560",

        "lines": ["my career in side projects and open"]

    }

]

```

`-s` or `--single` output:

```json

[

    {

        "start": "00:00:00.000",

        "end": "00:00:04.560",

        "line": "my career in side projects and open"

    }

]

```

## Development

To contribute to this tool, first checkout the code. Then create a new virtual environment:

    cd ttml-to-json

    python -m venv venv

    source venv/bin/activate

Now install the dependencies and test dependencies:

    pip install -e '.[test]'

To run the tests:

    pytest