Google Gemini
With Google Gemini on your own API key, IPTV Deck can translate subtitles into any language, write subtitles for a downloaded film from its audio, and show live subtitles of a channel or a film as you watch.
Getting a key
Section titled “Getting a key”- Open aistudio.google.com/apikey and sign in with a Google account.
- Create an API key and copy it. A free key works; Google’s own limits for that key apply.
Connecting it
Section titled “Connecting it”Settings → Integrations → Google Gemini, paste the key under API key and choose Sign in. The app checks the key with Google before it saves it, and the card then shows Key ending in its last four characters. On a television, enter it on your phone (below), paste it in the account panel (Integrations), or send it from your phone, rather than typing it with a remote.
Entering the key from your phone
Section titled “Entering the key from your phone”On a television the key does not have to be typed with the remote:
- Choose Enter it on your phone in Settings → Integrations → Google Gemini, or Enter the key on your phone in the subtitle menu of the player.
- Scan the code the TV shows with your phone. No camera? On the phone open Settings → Devices → Connect a device and type the code.
- Paste the key on your phone and send it. If the phone already has Gemini connected, Send the one from this phone does it in one step.
The key goes to the TV end-to-end encrypted, and the TV checks it with Google before it saves it. The phone has to be signed in to IPTV Deck.
The key is one for the whole account, not per profile. With Keep my passwords in my account on, your other devices get it by themselves.
Translating subtitles
Section titled “Translating subtitles”In the subtitle menu of a film or an episode, open the translation of the track you want: hold OK on it on a television, right-click it on a computer, or tap the translate button next to it on a phone or tablet. Then pick the language.
- The whole film is translated at once, so names and tone stay the same from start to end.
- A film translated once plays again without a new translation.
- It translates downloaded subtitles, your own subtitle file, subtitles from a media server, text subtitles of an HLS stream and earlier translations.
It works on every device. See Translating one subtitle track.
Subtitles from the audio
Section titled “Subtitles from the audio”A downloaded film or episode, or a recording, also gets Generate from audio in its subtitle menu: Gemini listens to it and writes subtitles in your language. The track is marked Made from the audio with Gemini. It works on phones and tablets, Android TV, Fire TV, Apple TV, Windows and the Mac, not on LG and Samsung TVs.
Live subtitles
Section titled “Live subtitles”Choose Live subtitles and a language in the subtitle menu of a channel, film or episode. Gemini listens to the sound as you watch and shows subtitles in that language. The menu says what it costs before you start: about 23 US cents an hour on a paid key, or about 44 with More accurate, which you choose in the Live subtitles row of Settings → Player or in the account panel.
On Android phones and tablets, Android TV and Fire TV the picture and the sound run a few seconds later while live subtitles are on, so each subtitle appears together with its words: about 9 seconds, or 10 with More accurate, then as long as Gemini needs on your connection, set again at each channel change. Most HLS channels start playing within a few seconds; other channels wait those seconds on their first picture. On Windows and the Mac the picture is not held, and the subtitles come a few seconds after the voice.
While live subtitles are on, a small note at the top corner of the picture says so, with the language and, while the picture runs later, by how many seconds. The player controls show it too.
It works on Android phones, tablets, Android TV and Fire TV with the built-in engine (ExoPlayer), not on VLC, and on Windows and the Mac for channels, and for films too on Windows 11. The iPhone, iPad, Apple TV and LG and Samsung TVs do not have it. See Live subtitles with Gemini.
What is sent
Section titled “What is sent”The subtitle text, or the audio when you make subtitles from it or use live subtitles, goes to Google under your key, and Google’s terms for that key apply. Nothing goes to Google until you translate a track, choose Generate from audio or start Live subtitles.
If it does not work
Section titled “If it does not work”| Message | What to do |
|---|---|
| Connect your Google Gemini account in Settings → Integrations. | No key yet, see above |
| Paste your Gemini API key first. | The field is empty |
| Gemini refused the API key. Check it in Settings → Integrations. | The key is wrong or was deleted in Google AI Studio. Paste a new one |
| Gemini is not available in your country. | Google does not offer it where you are |
| Your Gemini key has used up its allowance for today. Try again tomorrow or raise the limit in Google AI Studio. | The daily limit of the key is used up |
| Your Gemini key has no credit left. Add credit to its project in Google AI Studio. | The paid key has run out of credit |
| Gemini is limiting requests from your key right now. Try again in a minute. / Gemini is busy right now. Try again in a moment. | Wait and try again |
| Live subtitles stopped: Gemini did not answer. | Start Live subtitles again |
| Gemini heard no speech in this film. | Nothing to write subtitles from |
Disconnect on the card removes the key from this device, and from your account when it is kept there.
