Programmagids (EPG)

Wat het doet

Een gast die op de gidsknop drukt, verwacht te zien wat er nu is, wat er straks komt en wat er vanavond op tv is. Zonder programma-informatie toont de televisie een leeg raster, en dat valt op een manier op zoals de meeste storingen in een kopstation dat niet doen.

Castmux vult die vanuit XMLTV, het gangbare uitwisselingsformaat voor gidsgegevens. U voegt een of meer XMLTV-bronnen toe en koppelt elke zender aan de bijbehorende vermelding in de gids. Vanaf dat moment houdt het apparaat de gidsgegevens actueel en stuurt het ze naar de televisies als DVB Event Information Tables (EIT), op dezelfde manier als een omroep. Een settopbox heeft geen configuratie nodig om ze te tonen.

Alles wordt ingesteld op de pagina EPG van de webinterface.

Een gidsbron toevoegen

Een bron is de URL van een XMLTV-bestand, zoals gepubliceerd door een gidsaanbieder. Gecomprimeerde gidsen (.gz) worden zonder meer geaccepteerd.

Wanneer een bron wordt toegevoegd, haalt Castmux die op en leest de zenderlijst: de gidsidentificatie van elke zender (bijvoorbeeld rtl.de) en de weergavenaam. De programma’s worden dan nog niet opgeslagen. Een XMLTV-bestand kan honderden megabytes groot zijn, en programma’s voor zenders die niemand heeft gekoppeld, zijn de opslag niet waard.

Een bron kan worden hernoemd, naar een nieuwe URL worden verwezen of worden verwijderd. Het verwijderen van een bron verwijdert de opgeslagen gidsgegevens ervan. Zenders die eraan gekoppeld zijn, houden hun gidsidentificatie tot u die wist, zodat een vervangende bron met dezelfde identificaties verdergaat waar de oude ophield.

Zenders koppelen

Elke zender wordt gekoppeld aan een gidsidentificatie uit de geïmporteerde lijsten. De EPG-pagina stelt de identificaties voor terwijl u typt. De koppeling wordt op de zender zelf opgeslagen, als epg_id in het configuratiebestand, zodat ze samen met de overige instellingen van de zender wordt geback-upt en teruggezet.

Een zender zonder koppeling bevat geen gidsgegevens. Koppelen gebeurt per zender, dus een locatie kan de zenders koppelen waarvoor gidsgegevens bestaan en de rest met rust laten.

De gids actueel houden

Elke bron wordt eens per uur opnieuw opgehaald. Bij elke synchronisatie worden programma’s alleen opgeslagen voor gidsidentificaties waaraan ten minste één zender is gekoppeld. Al het andere in het bestand wordt gelezen en weggegooid zonder de schijf aan te raken. Afgelopen programma’s worden opgeruimd, zodat de opslag alleen bevat wat er nu is en wat nog komt.

Sync now bij een bron haalt die direct op en meldt het werkelijke resultaat; dat is de knop die u gebruikt na het toevoegen van een bron of het wijzigen van een koppeling. Bij een grote gids kan het een paar minuten duren.

Gidsgegevens worden opgeslagen in een klein databasebestand, epg.db, naast het configuratiebestand.

Wat de televisies ontvangen

Voor elke gekoppelde zender schrijft het apparaat de huidige en komende programma’s als EIT en voegt die toe aan de transportstream van de zender. Dat omvat zowel de nu-en-straks-informatie als de planning verder vooruit. Het werkt op de multicastuitgang en op DVB-C: een zender die in een multiplex wordt meegestuurd, behoudt zijn EIT, hernummerd naar zijn service in die multiplex.

De details die u moet kennen:

De tijden in de gids komen van de klok van het apparaat. Houd de tijd van het apparaat juist, bijvoorbeeld met NTP. Een verkeerde systeemklok toont op elke televisie het verkeerde programma als “nu”.
Updates bereiken draaiende zenders zonder herstart. De EIT wordt opnieuw ingelezen zodra de gidsgegevens veranderen, dus een synchronisatie per uur staat binnen enkele seconden op het scherm en geen enkele zender wordt onderbroken.
Een nieuw gekoppelde zender stuurt EIT mee vanaf zijn volgende start. Koppel de zender, voer Sync now uit en herstart de zender: zet hem uit en weer aan, of roep POST /api/channels/{id}/restart aan.
Een gekoppelde zender zonder programma’s toont een gelabeld gat. Heeft de gids nog niets voor een zender, of vermeldt ze die niet meer, dan toont de televisie “No information available” in blokken van vier uur in plaats van een lege gids, en de zender blijft spelen.
Tekens met accenten vereisen de juiste tekenset. Standaard wordt gidstekst gecodeerd in de standaard-DVB-tekenset, die sommige ontvangers verkeerd decoderen, meestal als kapotte umlauts. Stel in Settings de EPG-tekenset in (epg_charset onder global.dvb) op wat de ontvangers op de locatie verwachten. ISO-8859-15 is geschikt voor West-Europa, en een modern ontvangerpark kan UTF-8 gebruiken.

In de webinterface

De kaart van elke gekoppelde zender op de pagina Channels toont wat er nu is en wat er straks komt, zodat u een koppeling kunt controleren zonder een televisie bij de hand. Een zender die gekoppeld is maar op dit moment niets uitzendt, toont dat ook, en dat is geen storing: gidsen hebben gaten.

De EPG-pagina toont elke bron met het tijdstip van de laatste ophaalactie en of die gelukt is; dat is de eerste plek om te kijken wanneer de gids op de televisies niet meer doorloopt.