subconv 1.1.0

Async SRT subtitle translator using OpenAI

SRT Translator

A tool that translates SRT subtitle files to any language using OpenAI's API. It processes subtitles asynchronously in batches for efficient translation while preserving timing and formatting.

CLI

subconv input.srt output.srt

Examples

subconv input.srt output.srt -t "Spanish"
subconv input.srt output.srt -s "English" -t "Japanese"
subconv input.srt output.srt --target-language "French" --source-language "German"

Options

Option	Description	Default
-t, --target-language	Target language for translation	Brazilian Portuguese
-s, --source-language	Source language (optional)	Auto-detected
-m, --model	OpenAI model	gpt-4o-mini
-c, --concurrent	Max concurrent requests	5
-b, --batch-size	Subtitles per batch	15

Library

import asyncio
from pathlib import Path
from subconv import TranslationConfig, TranslationService

config = TranslationConfig(
    input_path=Path("input.srt"),
    output_path=Path("output.srt"),
    target_language="Spanish",
    source_language="English",
)

asyncio.run(TranslationService(config).run())

Environment

export OPENAI_API_KEY=your-key

License

MIT

---

Tests and documentation generated by Claude xD