https://github.com/s0up4200/srtran
SRTran is a command-line tool for translating subtitle files (.srt) from one language to another using various AI language models.
https://github.com/s0up4200/srtran
Last synced: 7 months ago
JSON representation
SRTran is a command-line tool for translating subtitle files (.srt) from one language to another using various AI language models.
- Host: GitHub
- URL: https://github.com/s0up4200/srtran
- Owner: s0up4200
- License: gpl-2.0
- Created: 2025-01-29T08:11:44.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2025-03-01T20:31:58.000Z (7 months ago)
- Last Synced: 2025-03-02T02:45:33.754Z (7 months ago)
- Language: Go
- Homepage:
- Size: 5.47 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# SRTran
SRTran is a command-line tool for translating subtitle files (.srt) from one language to another using various AI language models. Written in Go.
## Features
- Translate .srt subtitle files between any language pair
- Support for multiple AI providers:
- Google AI Studio (Gemini)
- OpenAI
- OpenRouter
- LM Studio
- Easy-to-use command-line interface
## Configuration
SRTran can be configured using a TOML configuration file or environment variables.
### Using config.toml (Recommended)
Create a `config.toml` file in one of these locations:
- `./config.toml` (current directory)
- `~/.config/srtran/config.toml`
- `~/.srtran.toml`
Example configuration:
See [config.toml](config.toml)
You can also specify a custom config file location using the `-c` flag:
```bash
srtran translate -c /path/to/config.toml -i input.srt -o output.srt -s english -t norwegian
```
### Using Environment Variables
Alternatively, you can use environment variables:
```bash
# Google AI Studio
export GOOGLE_AI_API_KEY='your-key' GOOGLE_AI_MODEL='gemini-2.0-flash-exp'
# OpenRouter
export OPENROUTER_API_KEY='your-key' OPENROUTER_MODEL='anthropic/claude-3.5-sonnet'
# OpenAI
export OPENAI_API_KEY='your-key' OPENAI_MODEL='gpt-4'
```
The tool will try API keys in this order: Google AI → OpenRouter → OpenAI
## Usage
### Command-line Options
- `-i, --input`: Input subtitle file (required)
- `-o, --output`: Output subtitle file (required)
- `-s, --source-language`: Source language (required)
- `-t, --target-language`: Target language (required)
- `-c, --config`: /path/to/file
- `-v, --verbose`: Enable verbose output
### Examples
1. Translate from English to French with verbose output:
```bash
srtran translate -i movie.srt -o movie_fr.srt -s english -t french -v
```
2. Translate from Spanish to German:
```bash
srtran translate -i spanish.srt -o german.srt -s spanish -t german
```
## Supported Languages
SRTran supports translation between any language pair. The supported languages depend on the AI provider being used.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the MIT License - see the LICENSE file for details.