subtitle-generator 2.0.0

Open-source subtitle generation for seamless content translation.

Subtitle

Open-source subtitle generation for seamless content translation.

Key Features:

• Open-source - Freely available for use, modification, and distribution
• Self-hosted - Run on your own servers for enhanced control and privacy
• AI-powered - Leverage Whisper for accurate, natural-sounding subtitles
• Multilingual - Generate subtitles in a wide range of languages
• Fast - Uses whisper.cpp for high-performance inference

Installation

Prerequisites

Ensure you have the following installed:

• git, make, cmake
• ffmpeg (Required for video processing)
• conda (Anaconda or Miniconda)

Setup

1. Clone and setup Whisper.cpp:

   ./setup_whisper.sh
   

2. Create and activate conda environment:

   conda env create -f environment.yml
   conda activate subtitle
   

Usage

Generate Subtitles

# Basic usage (generates VTT subtitle file)
python subtitle.py video.mp4

# Generate and embed subtitles into video
python subtitle.py video.mp4 --merge

# Use a specific model
python subtitle.py video.mp4 --model base

# Generate SRT format
python subtitle.py video.mp4 --format srt

# From URL
python subtitle.py "https://example.com/video.mp4"

Model Management

# List all available models
python subtitle.py models --list

# Download a specific model
python subtitle.py models --download large

View Supported Formats

python subtitle.py formats

Options

Option	Description
--model, -m	Model to use (default: base)
--format, -f	Output format: vtt, srt, txt, json, lrc (default: vtt)
--merge	Embed subtitles into video
--threads, -t	Number of threads (default: 4)
--verbose, -v	Verbose output

Available Models

Model	Size	Speed	Best For
tiny	~75MB	Fastest	Quick previews
base	~140MB	Fast	General use (default)
small	~460MB	Medium	Quality output
medium	~1.5GB	Slow	Professional work
large	~3GB	Slowest	Maximum accuracy

Tip: Use .en models (e.g., base.en) for English-only content.

Documentation

• Usage Examples - CLI and Python API examples
• API Reference - Programmatic API documentation
• Troubleshooting - Common issues and solutions
• Contributing - Contribution guidelines

License

MIT

Reference & Credits

• OpenAI Whisper
• whisper.cpp

Author

• Ved Gupta

Support

For support, email [e-mail]