Hoe lyk 'n XMLTV EPG Lêer Eintlik (Met Voorbeelde)

Die vinnigste manier om verwarring oor programgidse te verhoed, is om een oop te maak en dit te lees. XMLTV is gewone XML — uitvoerig, maar nie ingewikkeld nie — en tien minute met 'n werklike voorbeeld sal jou ure van giswerk spaar oor waarom jou gids leeg is.

Hierdie pos wys 'n werklike lêer, deskodeer dit tag vir tag, en gebruik dan daardie begrip om die mees algemene gidfout uit te lê.

Die eerlike raamwerk: Tuneline is 'n mediaspeler vir inhoud wat jy voorsien. Dit wys 'n gids uit 'n skedule-bron wat jy verskaf. Dit word gestuur sonder gids en sonder inhoud.

Die Struktuur in Een Sin

'n XMLTV lêer het presies twee soorte dinge daarin: <channel> elemente wat verklaar wat bestaan, en <programme> elemente wat sê wat aan is wanneer.

Dit is dit. Al die res is detail.

'n Minimale, Volledige Voorbeeld

<?xml version="1.0" encoding="UTF-8"?>
<tv generator-info-name="example-grabber">

  <channel id="example.news.us">
    <display-name>Example News</display-name>
    <icon src="http://logos.example/news.png" />
  </channel>

  <programme start="20260806180000 +0000"
             stop="20260806190000 +0000"
             channel="example.news.us">
    <title lang="en">Evening Report</title>
    <desc lang="en">The day's headlines and analysis.</desc>
    <category lang="en">News</category>
  </programme>

</tv>

Dit is 'n geldige, volledige gids wat een bron en een uur skedule beskryf. 'n Werklike lêer het dieselfde twee vorms duisende kere herhaal.

Deskodeer Tag vir Tag

Die tydstempel-formaat vang almal

start="20260806180000 +0000"

Lees as YYYYMMDDHHMMSS gevolg deur 'n UTC-afset. Dus dit is 6 Aug 2026, 18:00:00 UTC.

Die afset is die deel wat saak maak. As 'n lêer dit weglaat, of een verklaar wat nie met werklikheid ooreenstem nie, laai jou gids perfekt en wys alles op die verkeerde tyd. Dit is 'n heeltemal ander probleem as 'n leë gids, en dit word reggestel in jou tydsone-instellings, nie deur bronne te verander nie. (Verkeerde tye-regstelling.)

Die Verbinding: Waarom Jou Gids Leeg Is Alhoewel die Lêer Gelaai Het

Dit is die belangrike ding om te verstaan, want dit verklaar die meeste gidklagtes.

Jou afspeellys en jou gids is twee afsonderlike lêers wat moet ooreenstem. Die ooreenkoms gebeur op 'n ID.

In die M3U:

#EXTINF:-1 tvg-id="example.news.us" tvg-logo="…",Example News
http://example.com/news.m3u8

In die XMLTV:

<channel id="example.news.us">

tvg-id moet gelyk wees aan channel id. Presies — insluitend hoofletters en leestekens.

Wanneer hulle ooreenstem, wys die inskrywing sy skedule. Wanneer hulle nie ooreenstem nie, kry jy 'n inskrywing met 'n leë gids, en die lêer was nooit skuldig nie. (Die M3U kant hiervan.)

Dit is waarom "Ek het 'n gids bygevoeg en niks het gebeur nie" gewoonlik nie die afspeellys se skuld noch die gids s'n is nie. Dit is omdat niemand hulle op identifiseerders laat ooreenstem het nie. 'n Gids wat 'n ander streek as jou afspeellys dek, sal duisende programme laai wat nie een van jou inskrywings pas nie.

Hoe om 'n Gidbron te Ondersoek Voordat Jy Dit Vertrou

Voordat jy jou speler skuld gee, kyk na die lêer.

1. Is dit saamgepers? Baie bronne verskaf .xml.gz. Dit is normaal — meeste spelers hanteer dit. As jy met die hand ondersoek, dekomprimeeer eers.

2. Bevat dit werklik jou bronne? Soek die lêer vir een van jou tvg-id waardes. As dit nie daar is nie, dek daardie gids nie jou lys nie, en geen instelling sal dit verander nie.

curl -s "https://example.com/guide.xml.gz" | gunzip | grep -c "<channel "
curl -s "https://example.com/guide.xml.gz" | gunzip | grep "example.news.us"

Die eerste sê jou hoeveel bronne dit verklaar. Die tweede sê jou of joune een van hulle is.

3. Dek dit 'n bruikbare tydsbestek? Kontroleer die vroegste en jongste start waardes. Sommige gratis gidse dra slegs 24 uur; sommige dra twee weke. 'n Gids wat gister geëindig het, lyk identies aan een wat gebroke is.

4. Hoe groot is dit? Volledige nasionale gidse loop tot tientalle of honderde megagrepe ongesaamgepers. Dit is normaal, en dit is waarom die eerste laai minute op 'n TV-boks kan neem. (Gratis XMLTV bronne.)

Algemene Misvormings

Werklike gidfêers breek op voorspelbare maniere:

• 'n HTML-foutblad wat as .xml gered is. Maak dit oop. As die eerste lyn <!DOCTYPE html> is, het die aflaai misluk en die fout gered.
• Onontsnappte ampersands. 'n Kaal & in plaas van & in 'n titel is ongeldig XML en kan die hele ontleding afbreek. Een slegte titel, helemaal geen gids.
• Dupliseer <channel id> inskrywings. Twee verklarings van dieselfde ID; gedrag hang af van die speler.
• Programme met geen ooreenstemmende kanaal nie. Skedule-inskrywings wie se channel eienskap geen verklaarde <channel id> pas nie. Hulle word stilweg weggelaat.
• Ontbrekende stop tye. Sommige grabbers laat dit weg en verwag dat die volgende program se begin die einde impliseer. Sommige spelers trek dat nie af nie, wat gapings agterlaat.

Kan ek Een Self Skryf of Wysig?

Ja. Dit is XML, dus enige teksteditor werk, en vir 'n klein gekureerde opstelling is dit heeltemal prakties.

Nuttige wysigings:

• Verander 'n <channel id> om die tvg-id wat jou afspeellys reeds gebruik, te pas — dikwels makliker as die wysig van honderde afspeellys-lyne.
• Snoei dit af. Skrap <channel> en <programme> elemente wat jy nie nodig het nie. 'n Kleiner lêer laai baie vinniger op beperkte toestelle.
• Regstellings die afset as elke tyd eenvormig verkeerd is.

Twee reëls: stoor as UTF-8, en hou dit goed gevorm — een onontsnappte & kan jou die hele gids kos.

Algemeen Gestelde Vrae

Hoe lyk 'n EPG lêer?

Gewone XML met twee soorte element: <channel> wat elke bron verklaar, en <programme> wat 'n starttyd, stoptyd en titel gee vir elke ingeskeduleerde item.

In watter formaat is XMLTV?

XML, tipies bedien as .xml of gzip-gesaamgepers .xml.gz. Tydstempels is YYYYMMDDHHMMSS plus 'n UTC-afset.

Waarom laai my gids maar wys niks nie?

Byna altyd omdat jou afspeellys se tvg-id waardes nie die gids se <channel id> waardes pas nie. Die lêer het goed gelaai; daar was niks om dit aan te verbind nie.

Hoe kontroleer ek of 'n gids my bronne dek?

Laai dit af, dekomprimeeer indien nodig, en soek een van jou tvg-id stringe. As dit nie in die lêer is nie, beskryf daardie gids nie jou lys nie.

Waarom is my gidfêer so groot?

'n Nasionale gids met twee weke skedule vir honderde bronne is werklik tientalle of honderde megagrepe. Dit word verwag, en dit is waarom eerste laai stadig is.

Kan ek 'n XMLTV lêer wysig?

Ja, in enige teksteditor. Stoor as UTF-8 en hou die XML goed gevorm — 'n enkele onontsnappte & kan die hele ontleding breek.

Onderste Lyn

• XMLTV hou presies twee dinge: <channel> verklarings en <programme> inskrywings.
• Tydstempels is YYYYMMDDHHMMSS + UTC-afset — 'n verkeerde afset beteken regte data, verkeerde tye.
• Die gids verbind aan jou afspeellys op tvg-id = channel id, presies. Wanverhouding is die top-oorsaak van 'n leë gids.
• Ondersoek voordat jy skuld gee: dekomprimeeer, soek jou ID, kontroleer die datumreeks.
• Een onontsnappte & kan 'n hele gidfêer ongeldig maak.

Het jy 'n afspeellys en 'n gids-URL? Laai Tuneline af — voeg beide by en die rooster vul in. Gratis en sonder advertensies.

— Shamir