auto-subs 0.1.0

A powerful, local-first library and CLI for video transcription and subtitle generation using Whisper.

Auto-Subs

A powerful, local-first library and CLI for video transcription and subtitle generation using Whisper.

This project is currently in early development.

Installation

pip install auto-subs

Usage (CLI)

Get the application version:

auto-subs --version

Generate subtitles from a Whisper JSON output:

auto-subs generate path/to/transcription.json

Options

• --output, -o: Specify the output file path. (Defaults to the same name as the input file)
• --format, -f: Choose the output format (srt, ass, txt). (Defaults to srt)
• --max-chars: Set the maximum characters per subtitle line. (Defaults to 35)

Example with options:

auto-subs generate input.json -o subtitles.ass -f ass --max-chars 40

Outputs

The CLI can generate subtitles in the following formats:

• SRT (.srt): The most common subtitle format, compatible with most video players.
• ASS (.ass): Advanced SubStation Alpha, allowing for rich styling (word-level highlighting coming soon).
• Text (.txt): A plain text transcript.

---

This project is maintained by Mateusz Kowalski.