sub-tools 🎬

A robust Python toolkit powered by Google's Gemini API for converting video content into accurate, multilingual subtitles.

✨ Features

• 📝 Subtitle generation from HLS video streams.
• 📚 Subtitle validation and quality control.
• 🎵 Audio fingerprinting and analysis using Shazam (macOS only).

🚀 Quick Start

Prerequisites

• Python 3.10 or higher
• FFmpeg installed on your system

Installation

pip install sub-tools

Usage

export GEMINI_API_KEY={your_api_key}
sub-tools --hls-url https://example.com/hls/video.m3u8 --languages en es fr

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/{feature-name})
3. Commit your changes (git commit -m 'Add some feature')
4. Push to the branch (git push origin feature/{feature-name})
5. Open a Pull Request

Prerequisites

• uv

Development Setup

git clone https://github.com/dohyeondk/sub-tools.git
cd sub-tools
uv sync

🧪 Testing

uv run pytest

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

⭐ Star History