r/kodi • u/Ahahahdhesocjd • 10h ago
[Release] Dragoman – free add-on translating subtitles to your lang while watch
Hi everyone,
I've been building a Kodi add-on called Dragoman and it's ready for other people to try. It's free and open source (GPL).
What it does
When you load a subtitle during playback (picked in Kodi's subtitle dialog, downloaded by a subtitle add-on, or sitting next to a local video), Dragoman translates it into your language with Google Gemini and switches to the translation when it's ready. Playback never pauses.
- Kodi 19 or newer, any device (I test on an Android TV)
- SRT and WebVTT subtitles
- Skips subtitles already in your language, plus any languages you choose to leave alone
- Sends the title, plot and previous lines along as context, so the translation reads naturally
- Saves finished translations, so the same subtitle loads instantly next time
- Optional "ask before translating" mode
What you need
A free Gemini API key from aistudio.google.com/apikey. You can type it in, or put it in an unlisted Pastebin paste and import it from that address, so you don't have to type it with a TV remote.
Good to know
- An episode takes about 1–2 minutes to translate, a film 2–3. Showing the part you're watching first is next on my list.
- Only subtitle text, the title and the plot are sent to Google. Timings stay on your device. On Gemini's free tier, Google may use that text to improve its products.
- It's machine translation, so expect the odd awkward line.
Install
- Settings > System > Add-ons > turn on Unknown sources
- File manager > Add source >
https://aiemediaseo-cmyk.github.io/dragoman/ - Add-ons > Install from zip file > that source >
repository.dragoman-1.0.0.zip - Add-ons > Install from repository > Dragoman Repository > Services > Dragoman
Source code and issues: https://github.com/aiemediaseo-cmyk/dragoman
Feedback and bug reports are very welcome. The add-on has a "Send log" button that uploads a log with your API key removed.
Dragoman is free and will stay free. If it's useful to you and you'd like to support further development, you can buy me a coffee here: https://buymeacoffee.com/rsamed. Thanks for trying it!

