You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
You are a hyper-vigilant subtitle translator and formatter. Your task is to translate an English .srt file into casual "Tenglish" (a mix of Telugu and English). Your primary directive is 100% accuracy in CONTENT MAPPING and SCRIPT & LANGUAGE RULES mentioned below. Failure to adhere to these rules is not an option.
7
+
Your task is to translate an English .srt file into casual "Tenglish" (a mix of Telugu and English). Your primary directive is 100% accuracy in CONTENT MAPPING and SCRIPT & LANGUAGE RULES mentioned below. Failure to adhere to these rules is not an option.
8
8
9
9
**Goal:** Translate the attached English .srt file for the {{Enter movie or TV show}} {{Movie/TV Show Name}} ({{Release Year}}){{Season/Episode Number in the format , S01E01}}{{Episode Title in the format , (Title)}} into casual Telugu for a native Telugu speaker who is not fluent in English.
Copy file name to clipboardExpand all lines: README.md
+12-8Lines changed: 12 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,20 +12,24 @@
12
12
13
13
A comprehensive browser-based and desktop tool that leverages Large Language Models (LLMs) to translate SRT subtitle files and automatically validate the output for common errors. Built specifically to create high-quality, script-accurate subtitles using your existing LLM subscriptions (Gemini, ChatGPT, Claude, etc.) via [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI).
14
14
15
-
Original TV Show in English | Output of translated SRT in Tenglish
15
+
Input SRT in English | Output of translated SRT in Tenglish
> Screenshots are taken from *Psych*, an American detective comedy-drama television series created by Steve Franks for USA Network.
21
21
22
22
## Motivation
23
23
24
-
My mom loves to watch movies and TV shows, but she isn't fluent in English. Properly translated subtitles are the perfect way for her to enjoy and understand the content. While Large Language Models (LLMs) are incredibly powerful and can translate subtitles in minutes, they often introduce subtle errors, such as:
24
+
My mom loves to watch movies and TV shows, but she isn't fluent in English. Properly translated subtitles are the perfect way for her to enjoy and understand the content. When I set out to find a subtitle translator powered by mainstream LLMs, I hit several roadblocks.
25
+
26
+
Existing solutions either required expensive paid API keys, charged high per-token rates (I tested commercial options like [GPT Subtitler](https://gptsubtitler.com/), but the pricing was unsustainable for my regular usage), or completely lacked the ability to detect and automatically fix the subtle formatting errors LLMs often introduce. Furthermore, I wanted a way to leverage my existing Gemini subscription rather than paying separately for API usage—which this tool achieves via [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI).
27
+
28
+
While Large Language Models are incredibly powerful and can translate subtitles in minutes, they often introduce subtle errors without strict oversight, such as:
25
29
26
30
***Timestamp Drift:** The model may slightly alter timestamps, causing subtitles to appear too early or too late.
27
31
***Character "Hallucinations":** When translating for a specific language (like Telugu), the model might mistakenly insert characters from a similar-looking but incorrect script (like Devanagari, Tamil, or Kannada).
28
-
***Incomplete Translations:** Long subtitle files may be cut off mid-translation.
32
+
***Incomplete Translations:** Long subtitle files may be cut off mid-translation due to context limits.
29
33
***Formatting Errors:** Line breaks or subtitle numbering can sometimes be corrupted.
30
34
31
35
This tool automates the entire translation workflow, validates the output, and provides one-click fixes for common LLM errors—ensuring the subtitles are perfect.
@@ -146,11 +150,11 @@ Create or edit your `config.yaml` file.
146
150
147
151
For more information, please visit: https://help.router-for.me/configuration/basic.html or use the provided example `config.yaml`.
148
152
153
+
</details>
154
+
149
155
> [!IMPORTANT]
150
156
> The `api-keys` value in `config.yaml` must match the API Key field in the web application. The key `dummy` is used by default if the field is left blank.
151
157
152
-
</details>
153
-
154
158
## Usage
155
159
156
160
### 1. Start CLIProxyAPI Server
@@ -255,7 +259,7 @@ When a configured template is imported:
255
259
256
260
**Example Non-Template Prompt:**
257
261
```markdown
258
-
You are a hyper-vigilant subtitle translator and formatter. Your task is to translate an English .srt file into casual "Tenglish" (a mix of Telugu and English). Your primary directive is 100% accuracy in CONTENT MAPPING and SCRIPT & LANGUAGE RULES mentioned below. Failure to adhere to these rules is not an option.
262
+
Your task is to translate an English .srt file into casual "Tenglish" (a mix of Telugu and English). Your primary directive is 100% accuracy in CONTENT MAPPING and SCRIPT & LANGUAGE RULES mentioned below. Failure to adhere to these rules is not an option.
259
263
260
264
**Goal:** Translate the attached English .srt file for the TV show Psych (2006), S02E02, (65 Million Years Off) into casual Telugu for a native Telugu speaker who is not fluent in English.
261
265
@@ -368,7 +372,7 @@ You can also add any custom Unicode range or character.
368
372
369
373
### Using Different Models
370
374
371
-
Edit the Model Name field to use other models. Since CLIProxyAPI supports OpenAI, Claude, and Gemini, you can input models like `gemini-3.1-pro-preview`, `gpt-5.4`, or `claude-opus-4-6`. Depending on the model selected, translation quality may vary:
375
+
Edit the Model Name field to use other models. Since CLIProxyAPI supports OpenAI, Claude, and Gemini, you can input models like `gemini-3.1-pro-preview`, `gpt-5.5`, or `claude-opus-4-7`. Depending on the model selected, translation quality may vary:
372
376
-`gemini-3-flash-preview`: Faster, cheaper, good for simple translations
373
377
-`gemini-2.5-pro`: More accurate, better for complex translations
374
378
-`gemini-3.1-pro-preview`: Latest model, best quality and reasoning
0 commit comments