Troubleshooting·9 min

Door Shamir

EPG Werkt niet? Een volledige handleiding voor het repareren van uw IPTV TV-gids in 2026

U stelt uw IPTV-speler in. De kanalen worden geladen. U kunt tussen hen schakelen. Alles ziet er geweldig uit — totdat u de TV-gids opent en niets anders aantreft dan lege cellen zover het oog reikt. Of nog erger: cellen met verkeerde programma's, met uitzendingen die vijf jaar geleden zijn afgelopen.

EPG-problemen zijn de op twee na meest gerapporteerde IPTV-klacht na buffering, en het frustrerende is dat de symptomen identiek lijken, ongeacht de oorzaak. Deze gids behandelt de vijf echte problemen achter verbroken EPG's, in de volgorde waarin ze het waard zijn om te controleren.

Schermafbeelding: een lege EPG-raster met kanalen maar geen programma's

The fast fix

Een lege gids heeft vijf oorzaken — de meeste zijn opgelost voordat u kijkt

Tuneline is een gratis mediaspeler met gevirtualiseerde rendering die zelfs enorme gidsen snel laat werken en XMLTV-vernieuwen met één tik — planningsgegevens die oudere spelers doen stallen, werken hier vlekkeloos. Geen account vereist, breng uw eigen afspeellijst mee.

Gratis downloaden

Wat is een EPG eigenlijk?

EPG staat voor Electronic Program Guide (elektronische programmagids). Het zijn de metagegevens die uw IPTV-speler vertellen wat er momenteel op elk kanaal wordt uitgezonden, wat er volgt en wat de programmaomschrijvingen zijn. Er is niets raadselachtigs aan — uw speler downloadt een bestand of vraagt een API aan, parseert programmatitels en -tijden, en geeft ze weer in een raster naast uw kanalen.

Het standaardformaat is XMLTV: een enkel XML-bestand met elk kanaal, elk programma, elk starttijdstip, elke duur, en optioneel posters en omschrijvingen. Een typisch XMLTV-bestand voor een grote provider kan 50–500 MB ongecomprimeerd zijn en honderdduizenden programma-items bevatten.

De reden waarom EPG zo vaak verbreken is dat dit bestand het volgende moet doen:

  1. Succesvol gedownload worden van uw provider.
  2. Correct gedecomprimeerd worden (meestal zijn ze gzip).
  3. Zonder fouten geparst worden.
  4. De kanaal-id's in uw afspeellijst afstemmen — dit is waar de meeste fouten optreden.
  5. Weergegeven worden in het raster van uw speler zonder time-out.

Een fout in een van die vijf stappen geeft u een lege TV-gids. Laten we erdoorheen gaan.

Een bug die ik verzond en vervolgens zelf heb opgespoord (zodat u deze in uw eigen speler kunt opsporen): een eerdere versie van Tuneline hield de geparste EPG in het geheugen en maakte deze niet ongeldig wanneer de gebruiker tussen Xtream-bronnen schakelde. Symptoom: de gids zag er vol uit, maar de programmatitels waren voor de kanalen van de vorige provider. Als u herinstaleert of geforceerd ververst en de juiste gids verschijnt, is dit dat type bug — en het is verrassend algemeen in spelers die agressief cachen zonder de cache per bron in te perken.


Oorzaak 1: uw EPG-URL is verouderd of ontbreekt

Dit is de meest voorkomende oorzaak en het eenvoudigst op te lossen. Als u een M3U-afspeellijst gebruikt, komt uw EPG van een aparte XMLTV-URL die u handmatig in uw speler moet invoeren. Veel gebruikers doen ofwel:

  • Hebben nooit een EPG-URL ingevoerd (de M3U heeft kanalen maar geen gidsbron).
  • Voerden maanden geleden een EPG-URL in die sindsdien offline is gaan.
  • Voerden de verkeerde URL in — een gids voor de kanalenlijst van een ander provider.

Hoe op te lossen

Zoek de documentatiepagina van uw provider. Bijna alle betaalde IPTV-providers publiceren zowel een M3U-URL als een XMLTV-URL. Ze zien er meestal als volgt uit:

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

Of:

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

Plak dit in de EPG-instellingen van uw speler, dwing een vernieuwen af en bekijk hoe de gids wordt ingevuld. In Tuneline is dit Instellingen → EPG → XMLTV-URL, met daarnaast een vernieuwknop, en de gids wordt meestal binnen enkele seconden na het vernieuwen ingevuld.

Schermafbeelding: Tuneline EPG-instellingen met XMLTV-URL en vernieuwknop

Als u op Xtream Codes bent, hoeft u doorgaans helemaal geen EPG-URL in te stellen — de EPG komt via dezelfde API als de kanalen. Als uw gids op Xtream leeg is, ga naar Oorzaak 3.


Oorzaak 2: de EPG is gedownload maar de kanaal-id's komen niet overeen

Dit is de meest frustrerende EPG-fout omdat het lijkt alsof de EPG heeft gewerkt — uw speler zegt dat het succesvol is geladen — maar het raster is nog steeds leeg.

Wat gebeurde: uw XMLTV-bestand bevat duizenden kanalen, elk geïdentificeerd door een tvg-id zoals news.us of sport.de. Uw M3U-afspeellijst heeft zijn eigen tvg-id-waarden. Als de id's niet overeenkomen, kan de speler een programma niet aan zijn kanaal koppelen. U eindigt met een volledig geladen EPG die nutteloos is omdat niets verbonden is.

Hoe het op te sporen

Kijk naar een kanaal-item in uw M3U-bestand. De regel ziet er als volgt uit:

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

Kijk nu naar uw XMLTV-bestand (de meeste providers laten u het rechtstreeks downloaden). Zoek naar de kanaal-id. Is er een overeenkomend <channel id="cnn.us">-item? Zo niet — of als de id's iets anders zijn (bijv. CNN.us versus cnn.us) — dat is uw probleem.

Hoe op te lossen

Een paar opties, afhankelijk van uw speler:

  • Beste oplossing: Gebruik een speler die fuzzy matching doet — dus kanalen afstemmen op genormaliseerde naam wanneer de tvg-id ontbreekt of verkeerd wordt geschreven. De matcher van Tuneline zet beide zijden in kleine letters, verwijdert veelvoorkomende achtervoegsels zoals "HD"/"FHD"/"4K" en regiocodes aan het einde, en verwijdert extra spaties voordat het vergelijkt. Het is niet perfect (twee kanalen met dezelfde naam zullen botsen), maar het redt 70–80% van afspeellijsten waar de id's van de provider gewoon slecht zijn.
  • Handmatige oplossing: Bewerk uw M3U-bestand en wijzig de tvg-id-waarden zodat ze overeenkomen met het XMLTV-bestand. Dit is vervelend maar werkt.
  • Providerreparatie: Stuur een e-mail naar uw IPTV-provider en vertel hen dat hun M3U-id's en XMLTV-id's niet overeenkomen. Opvallend genoeg zullen ze het bestand regelmatig opnieuw genereren — ze krijgen deze klacht voortdurend.

Oorzaak 3: de EPG-server van uw provider is traag of beperkt het tarief

Grote XMLTV-bestanden vergen echte downloadtijd. Als de EPG-server van uw provider overbelast is (zeer gebruikelijk tijdens piekuren), kan uw speler een time-out geven voordat de download is voltooid. Sommige providers beperken ook het aantal EPG-downloads — als u de EPG in het afgelopen uur vijf keer hebt vernieuwd, kan het volgende verzoek zwijzend worden genegeerd.

Symptomen

  • EPG wordt soms geladen maar niet altijd.
  • De eerste vernieuwen na installatie werkt, daarna retourneren volgende vernieuwingen leeg.
  • EPG werkt om 3 uur 's ochtends maar mislukt om 20:00 uur.

Hoe op te lossen

  • Verhoog de EPG time-out in uw speler. De meeste spelers hebben standaard 30 seconden ingesteld. Stel dit in op 120.
  • Vernieuw de EPG minder vaak. Eenmaal per 12 of 24 uur is voldoende voor live programmagegevens.
  • Gebruik de gzip-versie. Als uw provider zowel epg.xml als epg.xml.gz beschikbaar stelt, gebruik altijd de gzip-URL — deze is meestal 5–10× kleiner.
  • Als de provider het tarief beperkt, wacht u een uur. Vernieuw dan en vernieuw niet opnieuw gedurende een dag.

Oorzaak 4: uw XMLTV-bestand is beschadigd

Sommige providers' XMLTV-export bevat onjuist gevormde items — ongeldige datumnotaties, onderbroken UTF-8-tekens, niet-gesloten tags. Een strikte XML-parser weigert het gehele bestand te laden vanwege één onderbroken item, zodat u met een lege EPG achterblijft.

Hoe het op te sporen

Als de logs van uw speler (elke serieuze speler heeft deze) fouten tonen zoals "XML parse error at line 47291" of "unexpected end of input", bent u op een beschadigd bestand gestuit.

Hoe op te lossen

U hebt over het algemeen drie opties:

  • Gebruik een beter verdraagzamere speler. Sommige spelers (Tuneline inbegrepen) zijn geconfigureerd om onjuist gevormde items over te slaan en de rest te laden. Strikte spelers geven het hele bestand op.
  • Gebruik een ander EPG-bron. Veel gratis openbare EPG-aggregators publiceren providergegevens opnieuw met schonere opmaak. Wees voorzichtig met licentievoorwaarden.
  • Rapporteer het slechte bestand aan uw provider. Ze kunnen het meestal binnen een dag repareren.

Oorzaak 5: uw speler is gewoon slecht in het renderen van grote EPG's

Sommige spelers beweren EPG te ondersteunen, maar haperen wanneer het raster meer dan enkele honderden kanalen bevat. De gegevens zijn er, parsering is geslaagd, maar de gebruikersinterface bevriest of toont lege cellen omdat het gelijktijdig renderen van duizenden programma-items te langzaam is.

Symptomen

  • Door de EPG scrollen gaat traag.
  • Cellen verschijnen en verdwijnen terwijl u scrolt.
  • De eerste 50 kanalen tonen programma's maar alles daaronder is leeg.

Hoe op te lossen

Dit is een spelerbeperking. De oplossingen zijn:

  • Gebruik een speler met gevirtualiseerde EPG-rendering. Moderne spelers renderen alleen de cellen die je echt kunt zien, dus een gids met 5.000 kanalen scrollt even snel als een gids met 50 kanalen. Tuneline's EPG grid is gevirtualiseerd en getest op afspeellijsten met 10.000+ kanalen — grote gidsen hoeven niet de reden te zijn dat je tv-kijken traag voelt.
  • Filter je kanaallijst. Als je maar 30 kanalen regelmatig bekijkt, verberg dan alles anders. De EPG rendert veel sneller op een kleinere lijst.
  • Wissel van speler. Dit is vaak het juiste antwoord als je maanden lang met EPG worstelt.

Een diagnostische volgorde die tijd bespaart

Wanneer iemand ons vraagt "waarom laadt mijn EPG niet," lopen we dit met ze door in deze volgorde:

  1. Is er een EPG URL geconfigureerd? (Indien op M3U.) De meeste gebruikers slaan deze stap over.
  2. Werkt de URL nog? Open het in een browser — je zou XML moeten zien of een download krijgen.
  3. Komen de kanaal-ID's in de M3U overeen met de ID's in de XMLTV? Kies één kanaal en verifieer handmatig.
  4. Reageert de EPG-server van je provider nu goed? Probeer op een ander moment van de dag te vernieuwen.
  5. Parseert het XMLTV-bestand? Controleer de speler-logs op parsefouten.
  6. Kan je speler de grootte van deze gids aan? Probeer een kleiner deel.

Als je deze systematisch doorwerkt, vind je de oorzaak elke keer.


Hoe een "goede EPG" er eigenlijk uitziet

Dit is de standaard waaraan je je IPTV-speler moet toetsen:

  • Laad < in 60 seconden voor een gids van 200 MB op Wi-Fi.
  • Achtergrondvernieuwing die het afspelen niet onderbreekt.
  • Fuzzy ID-matching zodat enigszins niet-overeenkomende afspeellijsten toch koppelen.
  • Now/Next-balk die toont wat nu uitzendt en wat volgt zonder het volledige grid te openen.
  • Zoek in de EPG — vind "hoe laat is de wedstrijd?" zonder te scrollen.
  • Herinneringen — waarschuw me wanneer een specifiek programma gaat beginnen.
  • Catch-up-integratie — als je op een programma klikt dat 3 uur geleden werd uitgezonden, wordt de catch-up afgespeeld als je provider dit ondersteunt.

Als je huidige speler dit voor het merendeel niet doet, is dat niet normaal. Het is een teken dat je speler achterloopt op de stand van de techniek.

Schermafbeelding: een volledig ingevuld EPG grid in Tuneline


Veelgestelde vragen

Waarom toont mijn EPG oude shows van jaren geleden?

Je XMLTV-bestand is verouderd. Je speler heeft een gids één keer gedownload en heeft deze sindsdien niet vernieuwd. Forceer een handmatige vernieuwing en controleer vervolgens of automatische vernieuwing op een dagelijks schema is ingeschakeld.

Waarom werkt de EPG voor sommige kanalen maar niet voor anderen?

Bijna altijd een tvg-id matching-probleem (Oorzaak 2). De kanalen met EPG hebben ID's die overeenkomen met het XMLTV-bestand; de kanalen zonder niet.

Is er een gratis openbare EPG-bron die ik kan gebruiken?

Ja — projecten zoals iptv-org/epg onderhouden door de gemeenschap samengestelde XMLTV-exports voor veel landen. De kwaliteit varieert. Ze zijn het beste als aanvulling op je provider's EPG, niet als vervanger.

Heeft Tuneline betere EPG-ondersteuning dan oudere IPTV-spelers?

We hebben EPG-ondersteuning speciaal gebouwd omdat elke andere speler die we probeerden één van de vijf oorzaken hierboven faalde. Tuneline doet fuzzy ID-matching, gevirtualiseerde grid-rendering, achtergrondvernieuwing, zoeken, herinneringen en catch-up-integratie waar ondersteund. Niets daarvan is magie — het is gewoon wat een tv-gids in 2026 zou moeten doen.

Hoe vaak moet ik mijn EPG vernieuwen?

Eenmaal per dag is voldoende voor live programmagegevens. De meeste providers werken hun XMLTV eenmaal of tweemaal per dag bij. Elke 15 minuten vernieuwen biedt je geen nieuwere gegevens — het zal je provider alleen belasten en je waarschijnlijk rate-limited maken.


De korte versie

EPG-problemen zien er mysterieus uit, maar worden bijna altijd veroorzaakt door een van vijf oplosbare problemen: ontbrekende URL, niet-overeenkomende kanaal-ID's, trage provider, beschadigd bestand of zwakke speler-rendering. Loop ze in volgorde door en je lost de gids in minder dan een uur op.

Als je het zat bent om elke paar weken dezelfde EPG-eigenaardigheden te bestrijden, probeer Tuneline — fuzzy ID-matching, gevirtualiseerde rendering en achtergrondvernieuwing zijn standaard. Je gids zou gewoon moeten werken.

Deel dit artikel

The fast fix

Rather not troubleshoot? Tuneline handles this for you.

A free media player with hardware-accelerated playback and automatic reconnect built in — the two things most players leave off. Bring your existing playlist.

Download free

The cross-platform media player behind these answers — new platforms, sync updates, the honest build story. No spam, unsubscribe anytime.

Lees dit artikel in een andere taal

Tuneline is een mediaspeler-applicatie. Het levert, host of verspreidt geen enkele content. Je neemt je eigen afspeellijst mee, precies zoals bij VLC.