EPG en XMLTV uitgelegd: zo werkt de tv-gids

Wat is een EPG?

EPG staat voor Electronic Program Guide: de elektronische tv-gids. Het is de lijst met programma’s per zender, met begintijd, eindtijd, titel en vaak een korte beschrijving. Daarmee zie je wat er nu op is en wat er straks komt.

De gids zit niet in de videostream zelf. Je dienst levert hem apart, naast de zenderlijst. Een speler haalt die gids op, legt hem naast je zenders en toont hem in beeld.

Lounjy levert geen content. Geen zenders, films, series, playlists of tv-gids. Gebruik alleen je eigen dienst, en alleen een dienst die de rechten heeft op wat hij aanbiedt. Lounjy speelt af en toont de gids die die dienst levert.

Waar de gids vandaan komt, hangt af van hoe je je playlist laadt:

Xtream Codes: de server van je dienst heeft een vast adres voor de gids. Lounjy haalt de gids daar zelf op, met dezelfde inloggegevens. Je hoeft niets in te vullen.
M3U: de gidslink staat bovenaan in de playlist, in de eerste regel. Bijvoorbeeld #EXTM3U url-tvg="http://dienst.example:8080/gids.xml.gz". Lounjy leest zowel url-tvg als x-tvg-url. Staat er geen link in, dan heeft de playlist geen gids. Vraag je dienst dan om een playlist waarin de gidslink staat.

Na het laden zie je bij je playlist in Instellingen de rij Tv-gids. Daar staat hoeveel zenders een gids hebben en wanneer hij is bijgewerkt. Met Gids bijwerken haal je hem meteen opnieuw op. Standaard werkt Lounjy de gids elke 12 uur zelf bij, en nooit terwijl je kijkt.

Het XMLTV-bestand

XMLTV is het gangbare formaat voor zo’n gids. Het is een tekstbestand in XML, vaak ingepakt als .xml.gz om het kleiner te maken. Lounjy pakt het zelf uit, ook als de bestandsnaam dat niet laat zien.

Het bestand heeft twee soorten blokken:

Zenders: <channel id="zender1.example"> met een of meer namen in <display-name>.
Programma’s: <programme start="20261009200000 +0200" stop="20261009210000 +0200" channel="zender1.example"> met daarin een <title> en soms een <desc>.

Het attribuut channel bij een programma verwijst naar de id van een zender in de gids. Dat is de sleutel waar alles om draait.

Lounjy bewaart de programma’s van de afgelopen 24 uur tot drie dagen vooruit. De oude gids blijft staan tot de nieuwe helemaal binnen is. Mislukt het ophalen, dan houd je dus je laatste gids.

Koppelen op tvg-id en naam

De zenders in je playlist en de zenders in de gids zijn twee aparte lijsten. Een speler moet ze aan elkaar koppelen. Lounjy doet dat in deze volgorde:

Jouw eigen koppeling. Heb je een zender zelf gekoppeld, dan wint die altijd.
De tvg-id. In een M3U staat bij elke zender vaak tvg-id="zender1.example". Bij Xtream Codes levert de server zo’n id mee. Is die gelijk aan een id in de gids, dan is de koppeling er. Staat er een toevoeging achter de id, zoals @SD, dan probeert Lounjy het ook zonder.
De naam. Lukt het niet op id, dan vergelijkt Lounjy de zendernaam met de namen in de gids. Eerst wordt de naam opgeschoond: een landvoorvoegsel, toevoegingen als HD, FHD of 4K, tekst tussen haakjes en leestekens tellen niet mee. Zo wordt | NL | Zender 1 HD gewoon zender1.

Bij echte playlists blijven er vaak zenders over: de id ontbreekt, of de naam wijkt te veel af. Dan zie je bij die zender Geen tv-gids voor deze zender. Daarvoor is Tv-gids koppelen:

Ga naar Instellingen en kies in de rij Tv-gids van je playlist de knop Koppelen. Staat er een getal achter, dan is dat het aantal zenders zonder gids.
Per zender zie je een voorstel uit de gids, met hoe zeker het is, bijvoorbeeld 92% zeker. Kies Koppelen om het over te nemen, of Zoeken om zelf de juiste zender in de gids te vinden.
Met Alle zekere voorstellen koppelen neem je in één keer alle voorstellen over die minstens 85% zeker zijn en niet twijfelen tussen twee even goede gidszenders.
Kies Nu toepassen of Toepassen en sluiten. Lounjy haalt de gids dan opnieuw op, met je nieuwe koppelingen.

Klopt een koppeling niet, kies dan Ontkoppelen. Je eigen koppelingen blijven staan als de zenderlijst wordt bijgewerkt, en ze gaan mee in een back-up.

Tijdverschuiving

In XMLTV hoort bij elke tijd te staan hoe ver die van de wereldtijd (UTC) af ligt, bijvoorbeeld +0200. Lounjy rekent alles om naar de tijd van je apparaat. Gaat dat goed, dan klopt de gids vanzelf, ook bij zomer- en wintertijd.

Soms gaat het mis bij de bron. De tijdzone ontbreekt, of er staat een verkeerde. Ontbreekt hij, dan neemt Lounjy aan dat de tijd in UTC is. Het gevolg: alle programma’s staan een vast aantal uren te vroeg of te laat. Je ziet bijvoorbeeld het nieuws van acht uur om tien uur staan.

Zo zet je het recht:

Open Tv-gids koppelen.
Gebruik bij Tijden in de gids de knoppen 30 min eerder of 30 min later tot het verschil weg is. Staat de gids twee uur te laat, kies dan vier keer 30 min eerder.
Kies Nu toepassen. De gids wordt opnieuw opgehaald met de nieuwe tijden.

De verschuiving geldt voor de hele playlist, niet per zender. In de rij Tv-gids zie je hem terug, bijvoorbeeld als tijd +1:00 uur. Krijg je de melding dat de gids alleen programma’s van buiten de komende dagen bevat? Dan is de gids verouderd, of de verschuiving klopt niet.

Korte gids als terugval

Sommige diensten met Xtream Codes leveren wel een zenderlijst in hun gids, maar geen programma’s. Of ze laten een deel van de zenders leeg. Levert de gids helemaal geen programma’s, dan meldt Lounjy dat in gewone taal in de rij Tv-gids. Ontbreekt de gids maar bij een deel van de zenders, dan zie je dat aan het aantal zenders met gids.

Voor zulke zenders valt Lounjy terug op de korte gids. Dat is een kleine lijst per zender die de server van je dienst apart levert: wat er nu op is en wat er daarna komt. Lounjy vraagt die alleen op voor zenders die je in beeld hebt, en onthoudt hem tien minuten.

De korte gids is er alleen bij Xtream Codes. Bij een M3U-playlist ben je afhankelijk van de XMLTV-link in de playlist. Geeft je dienst tijdelijk geen gids, dan blijft je laatste gids staan.

Verder lezen

Lounjy uitproberen met je eigen dienst? Kijk op de downloadpagina.