Desktop and CLI app that translates books, subtitles and documents (EPUB, SRT, DOCX, PDF, TXT) with local or cloud LLMs, resuming interrupted jobs.
Felix3322/PotPlayer_ChatGPT_Translate
A PotPlayer plugin that translates video subtitles in real time using OpenAI-compatible chat APIs, including local models such as Ollama.
- Stars
- 1,069
- Forks
- 73
- Open issues
- 2
- Last commit
- 6 days ago
What is it?
PotPlayer_ChatGPT_Translate is a subtitle translation plugin for PotPlayer, the Windows video player. It sends subtitle lines to an AI model through a chat/completions endpoint and displays the translated text while the video plays. Because the model sees the wording rather than matching words one by one, it can handle idioms, jokes and cultural references better than conventional subtitle translators.
The plugin ships in two variants. The context version passes recent subtitle lines to the model, which usually improves accuracy at the cost of more latency and tokens. The no-context version translates each line on its own, which is faster and cheaper. Users set the model name, an optional custom API base URL, and an API key in PotPlayer's plugin panel. Endpoints that need no key are supported by adding a nullkey option.
Optional settings cover retries, request delays, context caching, a prompt mode for smaller models, and a check that discards abnormally long translations. A Windows installer handles setup, and manual installation is also documented.
Key features
- 01Translates PotPlayer subtitles in real time.
- 02Offers context-aware and no-context script variants.
- 03Works with OpenAI-compatible endpoints, including custom base URLs.
- 04Supports keyless endpoints such as local Ollama servers.
- 05Includes retry, request delay and hallucination-length check options.
Use cases
- Watching foreign-language films or anime with translated subtitles in PotPlayer.
- Using a local Ollama model to translate subtitles without sending requests to a cloud service.
- Comparing literal machine translation with LLM translation on dialogue-heavy content.
In collections
Topics
FAQ
- What is PotPlayer_ChatGPT_Translate?
- A PotPlayer plugin that translates video subtitles in real time using OpenAI-compatible chat APIs, including local models such as Ollama. PotPlayer_ChatGPT_Translate is a subtitle translation plugin for PotPlayer, the Windows video player. It sends subtitle lines to an AI model through a chat/completions endpoint and displays the translated text while the video plays. Because the model sees the wording rather than matching words one by one, it can handle idioms, jokes and cultural references better than conventional subtitle translators.
- Is PotPlayer_ChatGPT_Translate free to use? What license does it have?
- PotPlayer_ChatGPT_Translate is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
- Is PotPlayer_ChatGPT_Translate still maintained?
- Actively maintained. The last commit to PotPlayer_ChatGPT_Translate was on Oct 16, 2026.
- What can I use PotPlayer_ChatGPT_Translate for?
- Watching foreign-language films or anime with translated subtitles in PotPlayer. Using a local Ollama model to translate subtitles without sending requests to a cloud service. Comparing literal machine translation with LLM translation on dialogue-heavy content.
- Where can I get PotPlayer_ChatGPT_Translate?
- The source code and installation instructions are on GitHub: https://github.com/Felix3322/PotPlayer_ChatGPT_Translate
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Chrome extension and local Python service that generates real-time English/Chinese translated captions for YouTube livestreams using Ollama.
A ready-to-go Windows translation and OCR tool built with WPF, supporting a plugin system for translation and recognition services.
A self-hosted, provider-agnostic web interface for chatting with local Ollama models and OpenAI-compatible APIs, with RAG, plugins and multi-user access control.
Self-hosted app that translates subtitle files into a target language using LibreTranslate, DeepL, or AI and cloud translation providers.
Desktop app that transcribes and translates audio and video offline on your computer, built on OpenAI's Whisper.