XMLTV forklaret

Sådan ser en XMLTV-fil ud

<tv generator-info-name="example">
  <channel id="nyheder.example">
    <display-name>Example Nyheder</display-name>
  </channel>
  <programme start="20261002180000 +0200" stop="20261002183000 +0200" channel="nyheder.example">
    <title>Aftennyhederne</title>
    <desc>Dagens vigtigste nyheder.</desc>
  </programme>
</tv>

Er tv-guider nyt for dig, så start med tv-guiden (EPG) i IPTV. XMLTV-projektets DTD, den formelle definition af formatet, beskriver strukturen:

• <tv> omslutter det hele: først kanalerne, derefter programmerne.
• <channel> skal have et id og mindst ét <display-name>; den kan også have et ikon og en webadresse.
• <programme> skal have et starttidspunkt (start) og en kanal (channel); et sluttidspunkt (stop) er valgfrit. Indeni er der mindst én <title>, og derefter valgfrie undertitler, beskrivelser, kategorier, afsnitsnumre og mere.

Tider og tidszoner

DTD'en siger, at tider følger ét format, der løst bygger på ISO 8601: YYYYMMDDhhmmss, eller en kortere begyndelse af det, med en valgfri tidszone til sidst, for eksempel +0200. Mangler tidszonen, antages UTC.

Den regel forklarer mange guider med forkert tid. En guide, der er skrevet i dansk tid, men uden tidszone, læses som UTC, så alle programmer ligger en time forkert om vinteren og to timer forkert om sommeren. Indstil først enhedens ur og tidszone, og ret derefter det, der er tilbage, med afspillerens guideforskydning eller playlistens tvg-shift. Se forkert tid i tv-guiden.

Kanal-id: forbindelsen til din playliste

Hver kanals id skal være unikt, og DTD'en anbefaler et navn i DNS-stil. M3U-playlisten forbindes med det gennem tvg-id, som Kodis IPTV Simple Client beskriver som den identifikator, der bruges til at forbinde en kanal med EPG-dataene.

• Match tegn for tegn. Regn ikke med, at en afspiller ser bort fra forskelle i store bogstaver eller mellemrum.
• Ét forkert match, én tom kanal. Har en kanal i playlisten intet tvg-id, eller et, som guiden ikke indeholder, vises der ingen programmer. Se M3U-tags forklaret og tv-guiden virker ikke.

Hvor XMLTV-filerne kommer fra

• Din tjeneste. De fleste IPTV-tjenester udgiver en guideadresse sammen med playlisten; med et Xtream Codes-login henter mange afspillere den automatisk. Se tilføj EPG.
• Andre guidekilder. Frivillige og kommercielle kilder udgiver XMLTV-filer for mange lande.
• Egne værktøjer. XMLTV-projektet udgiver værktøjer til at hente, lave og bearbejde oversigter, og hjemmeservere som Jellyfin kan modtage guidedata i XMLTV-format.

Størrelse og hastighed

En guide til tusindvis af kanaler over en uge er en stor fil, og store filer komprimeres ofte til download. Store guider indlæses langsomt på billige sticks. Skjul kanalgrupper, du ikke ser, og sæt antallet af guidedage ned, hvis afspilleren tillader det. Se tv-guiden virker ikke.

Hvor guidedataene kommer fra

XMLTV-filen kan komme fra udbyderen, fra udsendelsen eller fra værktøjer, du selv kører. Se EPG-kilder til IPTV.