r/kodi • • 8d 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

  1. Settings > System > Add-ons > turn on Unknown sources
  2. File manager > Add source > https://aiemediaseo-cmyk.github.io/dragoman/
  3. Add-ons > Install from zip file > that source > repository.dragoman-1.0.0.zip
  4. 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!

6 Upvotes

5 comments sorted by

1

u/Inner_Explanation313 8d ago

Is this a Movie Addon or Subtitles Addon ?

1

u/Ahahahdhesocjd 7d ago

Its a subtitles addon.
I made that mainly because when some new movie gets released you need to wait like month or 2 cca until someone translates sub in your language. and even than will it fit. is the right recording etc..
English always has enough subs, so this thing auto translates the selected sub to your native language. and auto swap it when done.
and additionaly experimental option is to resync the titles in case of delay.

1

u/bielnoelofc 5d ago

Corrigir os travamentos quando usa o kore e o addon do youtube para transmitir videos para o kodi da google tv

1

u/Ahahahdhesocjd 2d ago

New version is out