EPG Ei lataudu? Täydellinen opas IPTV:n TV-oppaan korjaamiseen vuonna 2026

Olet määrittänyt IPTV-soittimesi. Kanavat latautuvat. Voit vaihtaa niiden välillä. Kaikki näyttää hyvältä – kunnes avaat TV-oppaan ja näet pelkkiä tyhjiä ruutuja. Tai mikä pahempaa: ruuduissa näkyy vääriä ohjelmia, esimerkiksi viisi vuotta sitten päättyneitä lähetyksiä.

EPG-ongelmat ovat IPTV:n toiseksi yleisin valituksen aihe pätkimisen jälkeen. Turhauttavaa on se, että oireet näyttävät samoilta syystä riippumatta. Tässä oppaassa käydään läpi rikkinäisten EPG-oppaiden viisi todellista ongelmaa siinä järjestyksessä, jossa ne kannattaa tarkistaa.

Mikä EPG oikeastaan on

EPG on lyhenne sanoista Electronic Program Guide eli sähköinen ohjelmaopas. Se on metatietoa, joka kertoo IPTV-soittimellesi, mitä kullakin kanavalla esitetään parhaillaan, mitä on tulossa seuraavaksi ja mitä ohjelmakuvauksissa sanotaan. Siinä ei ole mitään mystistä: soitin lataa tiedoston tai tekee kyselyn ohjelmointirajapintaan, poimii ohjelmien nimet ja ajat ja näyttää ne ruudukossa kanavien vieressä.

Tavallinen formaatti on XMLTV: yksi XML-tiedosto, jossa luetellaan kaikki kanavat, ohjelmat, alkamisajat ja kestot sekä mahdollisesti julisteet ja kuvaukset. Suuren palveluntarjoajan tyypillinen XMLTV-tiedosto voi olla pakkaamattomana 50–500 Mt, ja se voi sisältää satojatuhansia ohjelmatietoja.

Syy siihen, että EPG menee niin usein rikki, on se, että tiedoston täytyy:

1. Latautua palveluntarjoajalta onnistuneesti.
2. Purkaa pakkaus oikein (useimmat ovat gzip-pakattuja).
3. Jäsentyä ilman virheitä.
4. Yhdistää kanavatunnukset soittolistasi kanaviin – useimmat ongelmat syntyvät tässä vaiheessa.
5. Näkyä soittimesi ruudukossa ilman aikakatkaisua.

Yksikin virhe näistä viidestä vaiheesta johtaa tyhjään TV-oppaaseen. Käydään vaiheet läpi.

Yksi bugi, jonka julkaisin ja jonka sitten itse jäljitin (jotta osaat tunnistaa sen omasta soittimestasi): Tuneline:n aiempi versio piti jäsennetyn EPG-tiedon muistissa eikä mitätöinyt sitä, kun käyttäjä vaihtoi Xtream-lähteiden välillä. Oire: opas näytti täydeltä, mutta ohjelmien nimet kuuluivat edellisen palveluntarjoajan kanaville. Jos uudelleenasennus tai pakotettu päivitys tuo näkyviin oikean oppaan, kyse on tämän luokan bugista – ja se on yllättävän yleinen soittimissa, jotka käyttävät aggressiivista välimuistia rajaamatta sitä lähdekohtaisesti.

---

Syy 1: EPG-osoitteesi on vanhentunut tai puuttuu

Tämä on yleisin syy ja helpoin korjata. Jos käytät M3U-soittolistaa, EPG tulee erillisestä XMLTV-osoitteesta, joka sinun on syötettävä soittimeen manuaalisesti. Monet käyttäjät joko:

• Eivät ole koskaan syöttäneet EPG-osoitetta lainkaan (M3U sisältää kanavat, mutta ei oppaan lähdettä).
• Syöttivät EPG-osoitteen kuukausia sitten, mutta se on sittemmin poistunut käytöstä.
• Syöttivät väärän osoitteen – jonkin toisen palveluntarjoajan kanavalistan oppaan.

Näin korjaat ongelman

Etsi palveluntarjoajasi ohjesivu. Lähes kaikki maksulliset IPTV-palveluntarjoajat julkaisevat sekä M3U-osoitteen että XMLTV-osoitteen. Ne näyttävät yleensä tältä:

http://your-provider.example/xmltv.php?username=USER&password=PASS

Tai:

http://your-provider.example/epg.xml.gz

Liitä tämä soittimesi EPG-asetuksiin, pakota päivitys ja seuraa, kuinka opas täyttyy. Tuneline:ssa tämä löytyy kohdasta Asetukset → EPG → XMLTV-osoite, jonka vieressä on päivityspainike, ja opas täyttyy yleensä muutamassa sekunnissa päivityksen jälkeen.

Jos käytät Xtream Codes:tä, EPG-osoitetta ei yleensä tarvitse määrittää lainkaan – EPG tulee saman ohjelmointirajapinnan kautta kuin kanavat. Jos opas on Xtreamissa tyhjä, siirry syyhyn 3.

---

Syy 2: EPG latautui, mutta kanavatunnukset eivät täsmää

Tämä on turhauttavin EPG-ongelma, koska se näyttää siltä, että EPG toimi – soitin ilmoittaa latauksen onnistuneen – mutta ruudukko on silti tyhjä.

Mitä tapahtui: XMLTV-tiedosto sisältää tuhansia kanavia, joista jokaisella on tvg-id-tunnus, kuten news.us tai sport.de. M3U-soittolistallasi on omat tvg-id-arvonsa. Jos tunnukset eivät täsmää, soitin ei pysty yhdistämään ohjelmaa kanavaan. Lopputuloksena on kokonaan latautunut EPG, josta ei ole hyötyä, koska mikään ei yhdisty.

Näin tunnistat ongelman

Katso yhden kanavan merkintää M3U-tiedostossasi. Rivi näyttää tältä:

#EXTINF:-1 tvg-id="cnn.us" tvg-name="CNN" tvg-logo="...",CNN

Katso seuraavaksi XMLTV-tiedostoasi (useimmat palveluntarjoajat antavat ladata sen suoraan). Hae kanavatunnusta. Löytyykö vastaavaa <channel id="cnn.us">-merkintää? Jos ei – tai jos tunnukset eroavat hieman toisistaan (esimerkiksi CNN.us ja cnn.us) – ongelma on tässä.

Näin korjaat ongelman

Vaihtoehtoja on muutama soittimestasi riippuen:

• Paras ratkaisu: Käytä soitinta, joka tukee sumeaa hakua – eli siirtyy vertaamaan kanavia normalisoidun nimen perusteella, jos tvg-id puuttuu tai sen kirjainkoko on väärä. Tuneline:n hakutoiminto muuttaa molemmat puolet pieniksi kirjaimiksi, poistaa yleiset päätetunnisteet, kuten "HD"/"FHD"/"4K", ja aluekoodit sekä yhdistää ylimääräiset välilyönnit ennen vertailua. Se ei ole täydellinen (kaksi aidosti samannimistä kanavaa voivat mennä päällekkäin), mutta se pelastaa 70–80 % soittolistoista, joissa palveluntarjoajan tunnukset ovat vain huolimattomasti määritetty.
• Manuaalinen ratkaisu: Muokkaa M3U-tiedostoa ja muuta tvg-id-arvot vastaamaan XMLTV-tiedostoa. Tämä on työlästä, mutta toimii.
• Palveluntarjoajan korjaus: Lähetä IPTV-palveluntarjoajallesi sähköpostia ja kerro, etteivät heidän M3U- ja XMLTV-tunnuksensa täsmää. Yllättävän usein he luovat tiedoston uudelleen – he saavat tästä valituksia jatkuvasti.

---

Syy 3: Palveluntarjoajasi EPG-palvelin on hidas tai rajoittaa pyyntöjä

Suuret XMLTV-tiedostot vievät oikeasti aikaa latautua. Jos palveluntarjoajasi EPG-palvelin on ylikuormittunut (erityisen yleistä ruuhka-aikoina), soitin saattaa aikakatkaista yhteyden ennen kuin lataus valmistuu. Jotkin palveluntarjoajat rajoittavat myös EPG-latauksia – jos olet päivittänyt EPG:n viisi kertaa viimeisen tunnin aikana, seuraava pyyntö voidaan hylätä ilman ilmoitusta.

Oireet

• EPG latautuu toisinaan, mutta ei aina.
• Ensimmäinen päivitys asennuksen jälkeen toimii, mutta seuraavat päivitykset palauttavat tyhjän oppaan.
• EPG toimii kello kolmelta aamuyöllä, mutta ei kello kahdeksalta illalla.

Näin korjaat ongelman

• Pidennä soittimesi EPG-aikakatkaisua. Useimpien soitinten oletusarvo on 30 sekuntia. Nosta se 120 sekuntiin.
• Päivitä EPG harvemmin. Kerran 12 tai 24 tunnissa riittää hyvin ajantasaisille ohjelmatiedoille.
• Käytä gzip-pakattua versiota. Jos palveluntarjoajasi tarjoaa sekä epg.xml- että epg.xml.gz-version, käytä aina gzip-pakattua osoitetta – se on yleensä 5–10 kertaa pienempi.
• Jos palveluntarjoaja rajoittaa pyyntöjä, odota tunti. Päivitä sitten äläkä yritä päivittää uudelleen vuorokauteen.

---

Syy 4: XMLTV-tiedostosi on vioittunut

Joidenkin palveluntarjoajien XMLTV-tiedostot sisältävät virheellisiä merkintöjä – vääränlaisia päivämäärämuotoja, rikkinäisiä UTF-8-merkkejä ja sulkemattomia tageja. Tiukka XML-jäsennin kieltäytyy lataamasta koko tiedostoa yhdenkin rikkinäisen merkinnän vuoksi, jolloin EPG jää tyhjäksi.

Näin tunnistat ongelman

Jos soittimesi lokissa (kaikissa vakavasti otettavissa soittimissa on loki) näkyy esimerkiksi virheitä "XML parse error at line 47291" tai "unexpected end of input", tiedosto on vioittunut.

Näin korjaat ongelman

Vaihtoehtoja on yleensä kolme:

• Käytä sallivampaa soitinta. Jotkin soittimet (myös Tuneline) on määritetty ohittamaan virheelliset merkinnät ja lataamaan loput. Tiukat soittimet luovuttavat koko tiedoston kanssa.
• Käytä toista EPG-lähdettä. Monet ilmaiset julkiset EPG-koontipalvelut julkaisevat palveluntarjoajien tiedot uudelleen siistimmin muotoiltuina. Huomioi lisenssiehdot.
• Ilmoita viallisesta tiedostosta palveluntarjoajallesi. He pystyvät yleensä korjaamaan sen vuorokauden sisällä.

---

Syy 5: Soittimesi ei yksinkertaisesti osaa näyttää suuria EPG-oppaita

Jotkin soittimet väittävät tukevansa EPG:tä, mutta hyytyvät, kun ruudukossa on yli muutama sata kanavaa. Tiedot ovat olemassa ja jäsennys onnistui, mutta käyttöliittymä joko jäätyy tai näyttää tyhjiä ruutuja, koska tuhansien ohjelmatietojen samanaikainen piirtäminen on liian hidasta.

Oireet

• EPG-oppaan vierittäminen tökkii.
• Ruudut ilmestyvät ja katoavat vierittäessä.
• Ensimmäisillä 50 kanavalla näkyvät ohjelmat, mutta niiden alapuolella kaikki on tyhjää.

Näin korjaat ongelman

Tämä on soittimen rajoitus. Vaihtoehdot ovat:

• Käytä soitinta, jossa on virtualisoitu EPG-renderöinti. Nykyaikaiset soittimet renderöivät vain solut, jotka todella näkyvät, joten 5 000 kanavan ohjelmaopas vierii yhtä nopeasti kuin 50 kanavan opas. Tuneline:n EPG-ruudukko on virtualisoitu, ja se on testattu yli 10 000 kanavan soittolistoilla – suuri ohjelmaopas ei saisi hidastaa television katselua.
• Suodata kanavaluettelosi. Jos katsot säännöllisesti vain 30 kanavaa, piilota kaikki muut. EPG renderöityy paljon nopeammin pienemmästä luettelosta.
• Vaihda soitinta. Tämä on usein oikea ratkaisu, jos olet paininut EPG:n kanssa kuukausien ajan.

---

Vianmääritysjärjestys, joka säästää aikaa

Kun joku kysyy meiltä "miksi EPG ei lataudu", käymme nämä kohdat läpi tässä järjestyksessä:

1. Onko EPG-URL-osoite määritetty? (Jos käytät M3U:tä.) Useimmat käyttäjät ohittavat tämän vaiheen.
2. Toimiiko URL-osoite edelleen? Avaa se selaimessa – sinun pitäisi nähdä XML-tiedosto tai saada lataus käyntiin.
3. Vastaavatko M3U:n kanavatunnukset XMLTV:n tunnuksia? Valitse yksi kanava ja tarkista asia käsin.
4. Vastaako palveluntarjoajasi EPG-palvelin juuri nyt? Kokeile päivittämistä eri aikaan päivästä.
5. Jäsentyykö XMLTV-tiedosto? Tarkista soittimen lokit jäsennysvirheiden varalta.
6. Kestääkö soittimesi tämän ohjelmaoppaan koon? Kokeile pienempää osajoukkoa.

Kun käyt nämä kohdat järjestelmällisesti läpi, löydät syyn joka kerta.

---

Miltä "hyvä EPG" oikeasti näyttää

Tällaista tasoa IPTV-soittimelta pitäisi edellyttää:

• Ensimmäinen lataus < 60 sekunnissa 200 Mt:n ohjelmaoppaalle Wi-Fi-yhteydellä.
• Taustapäivitys, joka ei keskeytä toistoa.
• Joustava tunnusten yhdistäminen, jotta hieman poikkeavatkin soittolistat yhdistyvät oikein.
• Nyt/seuraavaksi-palkki, joka näyttää parhaillaan esitettävän ja seuraavan ohjelman avaamatta koko ruudukkoa.
• Haku koko EPG:sta – löydä vastaus kysymykseen "mihin aikaan peli tulee?" vierittämättä.
• Muistutukset – saat ilmoituksen, kun tietty ohjelma on alkamassa.
• Jälkikatselun integrointi – kolme tuntia sitten esitetyn ohjelman napsauttaminen käynnistää jälkikatselun, jos palveluntarjoajasi tukee sitä.

Jos nykyinen soittimesi ei pysty useimpiin näistä, se ei ole normaalia. Se on merkki siitä, että soittimesi on jäänyt kehityksestä jälkeen.

---

Usein kysyttyä

Miksi EPG näyttää vuosia vanhoja ohjelmia?

XMLTV-tiedostosi on vanhentunut. Soittimesi latasi ohjelmaoppaan kerran eikä ole päivittänyt sitä sen jälkeen. Pakota manuaalinen päivitys ja tarkista sitten, että automaattinen päivitys on käytössä päivittäisen aikataulun mukaisesti.

Miksi EPG toimii joillakin kanavilla mutta ei toisilla?

Lähes aina kyse on tvg-id-tunnusten yhdistämisongelmasta (syy 2). Kanavilla, joilla on EPG, on XMLTV-tiedostoa vastaavat tunnukset; muilla kanavilla ei ole.

Onko olemassa ilmaista julkista EPG-lähdettä, jota voin käyttää?

Kyllä – iptv-org/epg:n kaltaiset projektit ylläpitävät yhteisön koostamia XMLTV-vientejä monille maille. Laatu vaihtelee. Ne sopivat parhaiten palveluntarjoajasi EPG:n täydennykseksi, eivät sen korvaajaksi.

Onko Tuneline:ssä parempi EPG-tuki kuin vanhemmissa IPTV-soittimissa?

Rakensimme EPG-tuen nimenomaan siksi, että jokainen kokeilemamme muu soitin epäonnistui yhdessä edellä mainituista viidestä kohdasta. Tuneline tarjoaa joustavan tunnusten yhdistämisen, virtualisoidun ruudukon renderöinnin, taustapäivityksen, haun, muistutukset ja jälkikatselun integroinnin silloin, kun palvelu sitä tukee. Mikään näistä ei ole taikuutta – tällaista TV-ohjelmaoppaan kuuluukin tehdä vuonna 2026.

Kuinka usein minun pitäisi päivittää EPG?

Kerran päivässä riittää reaaliaikaisille ohjelmatiedoille. Useimmat palveluntarjoajat päivittävät XMLTV:n kerran tai kaksi päivässä. Päivittäminen 15 minuutin välein ei anna uudempia tietoja – se vain kuormittaa palveluntarjoajaasi ja johtaa todennäköisesti nopeusrajoituksiin.

---

Lyhyesti

EPG-ongelmat vaikuttavat mystisiltä, mutta lähes aina niiden taustalla on yksi viidestä korjattavissa olevasta syystä: puuttuva URL-osoite, ristiriitaiset kanavatunnukset, hidas palveluntarjoaja, vioittunut tiedosto tai soittimen heikko renderöinti. Käy syyt läpi tässä järjestyksessä, niin saat ohjelmaoppaan toimimaan alle tunnissa.

Jos olet kyllästynyt taistelemaan samojen EPG-ongelmien kanssa muutaman viikon välein, kokeile Tuneline – joustava tunnusten yhdistäminen, virtualisoitu renderöinti ja taustapäivitys kuuluvat vakiovarusteisiin. Ohjelmaoppaan pitäisi vain toimia.