XMLTV forklart

Slik ser en XMLTV-fil ut

<tv generator-info-name="example">
  <channel id="nyheter.example">
    <display-name>Example Nyheter</display-name>
  </channel>
  <programme start="20261002180000 +0200" stop="20261002183000 +0200" channel="nyheter.example">
    <title>Kveldsnytt</title>
    <desc>Dagens viktigste nyheter.</desc>
  </programme>
</tv>

Er TV-guider nytt for deg, start med TV-guiden (EPG) i IPTV. XMLTV-prosjektets DTD, den formelle definisjonen av formatet, beskriver strukturen:

• <tv> omslutter alt: først kanalene, deretter programmene.
• <channel> må ha en id og minst ett <display-name>; den kan også ha et ikon og en nettadresse.
• <programme> må ha en starttid (start) og en kanal (channel); en sluttid (stop) er valgfri. Inni finnes minst én <title>, og deretter valgfrie undertitler, beskrivelser, kategorier, episodenumre og mer.

Tider og tidssoner

DTD-en sier at tider følger ett format som løst bygger på ISO 8601: YYYYMMDDhhmmss, eller en kortere begynnelse av det, med en valgfri tidssone på slutten, for eksempel +0200. Mangler tidssonen, antas UTC.

Den regelen forklarer mange guider med feil tid. En guide som er skrevet i norsk tid, men uten tidssone, leses som UTC, så alle programmer havner én time feil om vinteren og to timer feil om sommeren. Still først enhetens klokke og tidssone, og rett deretter det som gjenstår, med spillerens guideforskyvning eller spillelistens tvg-shift. Se feil tid i TV-guiden.

Kanal-id: koblingen til spillelisten

Hver kanals id må være unik, og DTD-en anbefaler et navn i DNS-stil. M3U-spillelisten kobles til den gjennom tvg-id, som Kodis IPTV Simple Client beskriver som identifikatoren som brukes til å koble en kanal til EPG-dataene.

• Match tegn for tegn. Ikke regn med at en spiller ser bort fra forskjeller i store bokstaver eller mellomrom.
• Én feilmatch, én tom kanal. Har en kanal i spillelisten ingen tvg-id, eller en som guiden ikke inneholder, vises ingen programmer. Se M3U-taggene forklart og TV-guiden laster ikke.

Hvor XMLTV-filene kommer fra

• Tjenesten din. De fleste IPTV-tjenester publiserer en guideadresse sammen med spillelisten; med en Xtream Codes-innlogging henter mange spillere den automatisk. Se legg til EPG.
• Andre guidekilder. Frivillige og kommersielle kilder publiserer XMLTV-filer for mange land.
• Egne verktøy. XMLTV-prosjektet publiserer verktøy for å hente, lage og behandle oversikter, og hjemmeservere som Jellyfin tar imot guidedata i XMLTV-format.

Størrelse og hastighet

En guide for tusenvis av kanaler over en uke er en stor fil, og store filer komprimeres ofte for nedlasting. Store guider laster tregt på billige stikk. Skjul kanalgrupper du ikke ser på, og reduser antall guidedager hvis spilleren tillater det. Se TV-guiden laster ikke.

Hvor guidedataene kommer fra

XMLTV-filen kan komme fra leverandøren, fra sendingen eller fra verktøy du kjører selv. Se EPG-kilder for IPTV.