1. Első beállítás és IPTV források

Az IPTV AiSubs nem tartalmaz csatornalistát és nem üzemeltet IPTV szolgáltatást. A lejátszáshoz saját IPTV szolgáltató adataira van szükség.

1. Nyisd meg a drawerben az IPTV szolgáltatók képernyőt, vagy a Beállítások tetején lévő szolgáltató parancsot.
2. Válassz forrástípust: M3U URL vagy Xtream Codes.
3. M3U esetén add meg a playlist URL-t. Xtream esetén add meg a szervert, felhasználónevet és jelszót.
4. Mentsd a szolgáltatót, majd importáld/frissítsd a listát.

A frissítés újra letölti az aktuális csatornákat, filmeket, sorozatokat és catchup metaadatokat. A kedvencek és mappák megőrzésére az app törekszik, ha a frissített listában újra azonosítani tudja ugyanazokat az elemeket.

2. Fő navigáció

• Élő TV: normál live csatornák.
• Kedvencek: mentett csatornák és kedvenc mappák.
• EPG: műsorújság, aktuális műsorok és visszanézhető tartalmak.
• Filmek/Sorozatok: Xtream VOD tartalmak, ha a szolgáltató ad ilyen listát.
• Előzmények: legutóbb nézett csatornák és VOD elemek.
• Beállítások: lejátszófelület, nyelv, webes felület, AI, felirat, szinkron és mentés.

Android TV-n a bal oldali rail és a drawer távirányítóra optimalizált. Telefonon az alsó navigáció és a keresők segítik a gyorsabb használatot.

Kedvencek és mappák

A csatornák csillaggal kedvencnek jelölhetők. Kedvenc mappákkal saját, kisebb csatornalisták hozhatók létre. A webes felületen ezek kényelmesebben szerkeszthetők böngészőből.

3. Lejátszó és távirányító

OK gombbal vagy a videóra tapizva megjelenik a lejátszó overlay. A felső chipsor sorrendje: csatornaváltó, AI, képarány, képinfo.

• Csatornaváltó: az aktuális lista megnyitása, gyors váltás másik csatornára.
• AI: AI lenyíló, ki/be kapcsolás, gyors beállítás, nyelvválasztás és presetek.
• Képarány: Fit, Fill, Zoom, 16:9, 4:3, 21:9 és csatornához mentés.
• Képinfo: felbontás, video/audio codec, képfrekvencia, képarányadat és stream trackek.

A számgombok csatornaszámra ugranak. A Channel Up/Down vagy Előző/Következő az aktuális listában lép. VOD és visszanézés esetén a stream támogatásától függően időben is lehet keresni.

4. EPG, catchup és visszanézés

Az EPG adat a szolgáltatói playlistből, Xtream metaadatból vagy XMLTV adatból érkezhet. A catchup elérhetősége a szolgáltató által adott visszajátszási URL-től és archívumablaktól függ.

• A múltbeli visszajátszható műsorok az EPG-ből indíthatók.
• Visszanézés közben az Előző/Következő műsorblokkok között lép, az Élőre gomb visszavisz az élő adásra.
• Ha egy catchup csatornának nincs EPG-je, az app 30 perces dummy blokkokat készít a múltbeli archívumra, hogy a visszajátszás így is kipróbálható legyen.
• Visszanézés közbeni csatornaváltásnál a lista első sora a Load all / Összes catchup csatorna kapcsoló. Ezzel az aktuális csoport és az összes catchup csatorna között lehet váltani.

A szolgáltató jelölhet műsorokat visszanézhetőnek akkor is, ha a videó a valóságban már nem érhető el. Az app ilyenkor nem tiltja le automatikusan a műsort, mert szolgáltatónként eltérő, hogy a hiba átmeneti vagy végleges.

5. Filmek, sorozatok és előzmények

Xtream szolgáltatóknál a filmek és sorozatok külön listaként jelenhetnek meg. Ezek nem élő csatornák, hanem VOD tartalmak. Az app a támogatott streameknél folytatást és keresést is biztosíthat, az Előzmények pedig segít visszatérni a legutóbb nézett tartalmakhoz.

6. AI feliratok

Az AI felirat beszédfelismerést és szükség esetén fordítást használ. A szolgáltatók API kulcsait a felhasználó adja meg, az app helyben, titkosított tárolóban menti őket.

• STT szolgáltatók: Soniox, Gladia, OpenAI, Gemini, Deepgram.
• Fordítás: provider-native fordítás, OpenAI vagy Gemini, a választott beállítástól függően.
• Nyelvek: forrásnyelv és célnyelv a kiválasztott szolgáltató támogatott listájából választható. Ahol támogatott, automatikus forrásnyelv is használható.
• Modellek: a normál beállításokhoz hasonló lenyílók listázzák a támogatott modelleket, de egyedi modellnév is megadható.

AI gyorsmenü

A lejátszó AI chipje lenyílót nyit. Itt található a ki/be kapcsoló, a beállítások, a nyelvválasztások és a preset lista. Ha az AI ki van kapcsolva, a chip csak AI. Ha aktív preset illeszkedik, a chip az AI Preset neve formát mutatja.

AI presetek

A preset szolgáltatókat, fordítót, nyelveket, modelleket, provider finomhangolást, AI kontextust, feliratmegjelenítést, puffer- és időzítési értékeket ment. API kulcsot nem tartalmaz. Preset menthető a gyorsmenüből és a webes felületről; a weben szerkeszteni, alkalmazni, törölni, kijelölten exportálni és visszatölteni is lehet.

AI kontextus

Az AI kontextus segíti a felismerést és fordítást. Használható általános leírásra, nevek és kifejezések listájára, valamint preferált fordítási párokra. Beküldéskor a futó AI session mezőtől függően frissülhet vagy újraindulhat.

Felirat stílus és időzítés

Állítható a méret, szín, megjelenítési mód, háttér opacitás, kitartás, dinamikus olvasási idő, feliratcsúsztatás és a Media3/LibVLC puffer. A két lejátszómotor külön pufferértéket használhat, mert eltérően viselkednek időzítésben.

7. AI költségkövetés

A webes felület az AI használatot dátum/idő, komponens, szolgáltató, modell, fordító és forrás szerint listázza. Az STT és a fordítás külön komponens, ha külön szolgáltatást használsz, például Soniox STT és OpenAI fordítás esetén.

• Helyi becslés: az app saját számítása a használati adatok és publikus árak alapján.
• Hivatalos API: provider usage API-ból érkező adat, ha az adott szolgáltatónál elérhető és egyeztethető a sessionnel.
• Szűrés: modell és idő szerint szűrhető, például utolsó óra, nap, hét vagy egyedi intervallum.

Ha több eszköz ugyanazt az API kulcsot használja, a szolgáltatói számlán az összes eszköz használata összeadódhat. Az app helyi statisztikája az adott eszközön futó sessionöket látja.

8. Webes felület

A webes felület a Beállításokban kapcsolható be. A megjelenő LAN URL-t nyisd meg ugyanazon a hálózaton lévő telefonon vagy számítógépen, vagy olvasd be a QR-kódot.

• Áttekintés az aktív szolgáltatóról, AI állapotról és napi költségről.
• Playlist és kedvenc mappa kezelés.
• AI beállítások, modellek, nyelvek, kontextus és presetek.
• AI költségoldal hivatalos/becsült jelölésekkel és szűréssel.
• Titkosított backup export/import.
• Webes nyelvválasztó, amely ugyanazt az appnyelvet állítja, mint az Android UI.

A webes URL tokent tartalmaz. Csak saját, megbízható hálózaton és eszközön nyisd meg.

9. Szinkron, mentés és visszaállítás

Az eszközszinkron közeli készülékek közötti átvitelre való. A titkosított backup hosszabb távú mentésre vagy kézi átvitelre használható.

• Szinkron: playlist metaadatok, kedvencek, kedvenc mappák, AI beállítások és API kulcsok átvitele másik készülékre.
• Titkosított backup: jelszóval védett fájlba menti a playlist metaadatokat, kedvenceket, mappákat és AI beállításokat API kulcsokkal együtt.
• Visszaállítás: merge vagy replace stratégia használható. A csatornalista nincs a backupban; a visszatöltött adatok meglévő listákhoz kötődnek vissza.
• Preset export/import: csak az AI preset lista is külön átvihető JSON fájlban.

10. Diagnosztika, adatvédelem és támogatás

A diagnosztikai naplók és crash riportok helyben készülnek, és csak akkor kerülnek ki az eszközről, ha kézzel megosztod őket. Adatvédelmi részletek: Adatvédelmi tájékoztató.

Támogatási email: iptv.aisubs@noahqsoft.com. Hibajegyek és ötletek: GitHub Issues.

IPTV AiSubs / User guide

IPTV AiSubs user guide

Updated: June 8, 2026

This guide covers the main app features: IPTV sources, channel lists, favorites, EPG and replay, player controls, AI subtitles, presets, cost tracking, web interface, sync, backup and troubleshooting.

1. First setup and IPTV sources

IPTV AiSubs does not include a channel list and does not operate an IPTV service. You need your own IPTV provider data before playback.

1. Open IPTV providers from the drawer or from the shortcut at the top of Settings.
2. Choose the source type: M3U URL or Xtream Codes.
3. For M3U, enter the playlist URL. For Xtream, enter server, username and password.
4. Save the provider, then import or refresh the list.

Refresh downloads the current channels, movies, series and catchup metadata again. The app tries to preserve favorites and folders when it can match the same items after refresh.

2. Main navigation

• Live TV: regular live channels.
• Favorites: saved channels and favorite folders.
• EPG: programme guide, current programmes and replayable content.
• Movies/Series: Xtream VOD content when provided by the service.
• History: recently watched channels and VOD entries.
• Settings: playback UI, language, web interface, AI, subtitles, sync and backup.

On Android TV, the side rail and drawer are optimized for remote control. On phones, bottom navigation and search fields make navigation faster.

Favorites and folders

Channels can be marked as favorites with the star action. Favorite folders let you create smaller custom channel groups. The web interface is often more comfortable for editing folders from a browser.

3. Player and remote control

Press OK or tap the video to show the player overlay. The top chip row is ordered as channel picker, AI, aspect ratio, picture info.

• Channel picker: opens the current list and switches quickly to another channel.
• AI: opens the AI dropdown with on/off, quick settings, language choices and presets.
• Aspect ratio: Fit, Fill, Zoom, 16:9, 4:3, 21:9 and save-for-channel.
• Picture info: resolution, video/audio codec, frame rate, aspect data and stream tracks.

Number keys jump to channel numbers. Channel Up/Down or Previous/Next moves inside the current list. For VOD and replay, seeking depends on stream support.

4. EPG, catchup and replay

EPG data can come from the provider playlist, Xtream metadata or XMLTV data. Catchup availability depends on the provider replay URL and archive window.

• Past replayable programmes can be opened from EPG.
• During replay, Previous/Next moves between programme blocks and Go live returns to live TV.
• If a catchup channel has no EPG, the app creates 30-minute dummy blocks for the past archive window so replay can still be tried.
• In replay channel picker, the first list row is the Load all catchup channels toggle. It switches between the current group and all catchup channels.

A provider may mark programmes as replayable even when the video is no longer available. The app does not automatically blacklist these programmes because provider behavior differs.

5. Movies, series and history

Xtream providers may expose movies and series as separate lists. These are VOD entries rather than live channels. The app can provide resume and seeking when the stream supports it, and History helps you return to recently watched items.

6. AI subtitles

AI subtitles use speech recognition and, when needed, translation. Provider API keys are entered by the user and stored locally in encrypted storage.

• STT providers: Soniox, Gladia, OpenAI, Gemini, Deepgram.
• Translation: provider-native translation, OpenAI or Gemini depending on the selected setup.
• Languages: source and target language are chosen from the selected provider's supported language list. Automatic source language is available where supported.
• Models: model dropdowns list supported models like normal settings screens, while still allowing custom model names.

AI quick menu

The player AI chip opens a dropdown. It contains on/off, settings, language choices and the preset list. When AI is disabled, the chip shows only AI. When a preset matches the current setup, it shows AI Preset name.

AI presets

A preset saves providers, translator, languages, models, provider tuning, AI context, subtitle display, buffer and timing values. It never contains API keys. Presets can be saved from the quick menu and the web interface; the web interface can also edit, apply, delete, export selected presets and restore them.

AI context

AI context improves recognition and translation. Use it for general event/channel description, names and terms, and preferred translation pairs. Submitting context may update or restart the running AI session depending on the field.

Subtitle display and timing

You can change size, color, display mode, background opacity, hold time, dynamic reading time, subtitle sync offset and Media3/LibVLC buffer values. The two playback engines can use different buffer values because their timing behavior differs.

7. AI cost tracking

The web interface lists AI usage by date/time, component, provider, model, translator and source. STT and translation are separate components when separate services are used, for example Soniox STT plus OpenAI translation.

• Local estimate: calculated by the app from local usage measurements and public prices.
• Official API: data received from a provider usage API when available and matchable to the local session.
• Filtering: filter by model and time, such as last hour, day, week or custom interval.

If multiple devices use the same API key, the provider's bill may include all devices together. The app's local statistics show sessions recorded on the current device.

8. Web interface

Enable the web interface in Settings. Open the displayed LAN URL from a phone or computer on the same network, or scan the QR code.

• Overview of active provider, AI state and today's cost.
• Playlist and favorite folder management.
• AI settings, models, languages, context and presets.
• AI cost page with official/estimated source labels and filtering.
• Encrypted backup export/import.
• Web language selector that changes the same app language used by the Android UI.

The web URL contains an access token. Open it only on trusted devices on your own network.

9. Sync, backup and restore

Device sync is for nearby-device transfer. Encrypted backup is for long-term storage or manual transfer.

• Sync: transfers provider metadata, favorites, favorite folders, AI settings and API keys to another device.
• Encrypted backup: saves provider metadata, favorites, folders and AI settings including API keys into a password-protected file.
• Restore: merge or replace strategy is available. Channel lists are not part of the backup; restored data is linked back to already imported provider lists.
• Preset export/import: only the AI preset list can also be moved separately as a JSON file.

10. Diagnostics, privacy and support

Diagnostic logs and crash reports are created locally and leave the device only if you share them manually. Privacy details: Privacy Policy.

Support email: iptv.aisubs@noahqsoft.com. Bugs and ideas: GitHub Issues.