TaalNederlands

Artikelen

M3U-formaat: zo lees je een kanalenlijst

Lees een M3U-voorbeeld, begrijp EXTINF en tvg-id en controleer kanaaladressen veilig voordat je je eigen afspeellijst importeert.

Gepubliceerd door InoxTV · Gepubliceerd

Laatst bijgewerkt

Het M3U-afspeellijstformaat bestaat uit tekst die media-items beschrijft en aangeeft waar ze te vinden zijn. Een kort voorbeeld lezen helpt een catalogusprobleem van een afspeelprobleem te onderscheiden voordat je appinstellingen verandert. Het onderstaande voorbeeld is bewust fictief: het gereserveerde voorbeelddomein levert geen televisie en geeft geen werkende kanalen als je het naar een speler kopieert.

Begin met een klein, leesbaar voorbeeld

#EXTM3U
#EXTINF:-1 tvg-id="demo.news" group-title="Examples",Example News
https://media.example.com/news/index.m3u8
#EXTINF:-1 tvg-id="demo.documentary" group-title="Examples",Example Documentary
https://media.example.com/documentary/index.m3u8

De eerste regel kondigt een uitgebreid M3U-bestand aan. Elk item bevat daarna een regel beschrijvende informatie met daaronder een locatie. In dit voorbeeld verwijzen de locaties naar HLS-afspeellijsten, maar een M3U-item hoeft niet op die extensie te eindigen. Het adres kan een ander ondersteund mediaformaat vertegenwoordigen, of een serverendpoint dat media teruggeeft zonder duidelijke bestandsnaam.

Open een kopie in een eenvoudige teksteditor als je een bestand onderzoekt dat van jou is of dat je mag gebruiken. Vermijd tekstverwerkers die aanhalingstekens veranderen of rijke opmaak opslaan. Bewaar het oorspronkelijke bestand, zodat een experiment met een label niet de enige kopie van je werkende lijst wordt.

Wat de beschrijvende velden vertellen

De EXTINF-regel bevat informatie over het volgende item. In veel IPTV-catalogi staat een duur van min één voor een item zonder bekende vaste duur. De tekst na de komma is de weergavenaam. De attributen ervoor zijn afspraken die bepaalde spelers en aanbieders gebruiken; niet iedere applicatie ondersteunt ze op dezelfde manier.

VoorbeeldveldDoelWat het niet bewijst
tvg-id="demo.news"Kanaalidentificator die aan gidsgegevens gekoppeld kan wordenDat er een bijpassend gidsitem bestaat
group-title="Examples"Voorgestelde categorie om items te ordenenDat alle spelers groepen hetzelfde interpreteren
Example NewsLeesbare kanaalnaamDat de stream online is of een licentie heeft
De volgende URLLocatie die voor afspelen wordt opgevraagdDat het account toegang heeft

Een logoadres is, wanneer aanwezig, nog een bron die de interface kan opvragen. Een ontbrekende afbeelding betekent daarom niet noodzakelijk dat de video kapot is. Een correct getoond logo is evenmin een afspeeltest. Door namen, afbeeldingen, identificatoren en videolocaties afzonderlijk te bekijken, worden je waarnemingen veel nauwkeuriger.

Een kanalenlijst kan naar een andere afspeellijst verwijzen

Het is normaal dat de buitenste catalogus adressen bevat waarvan de antwoorden zelf weer afspeellijsten zijn. De buitenste lijst geeft aan welk kanaal de kijker koos. Een HLS-manifest kan vervolgens de mediaversies of opeenvolgende kleine segmenten beschrijven waarmee dat kanaal wordt geleverd. Dit zijn verschillende lagen, ook als ze verwante tekstsyntaxis gebruiken.

Daarom is een M3U8-achtervoegsel niet genoeg om te beslissen of een URL in een catalogusimporteur of mediaspeler thuishoort. De vergelijking tussen M3U en HLS legt de onderscheidende tags uit. Volg de instructies van je toegestane bron in plaats van bestandsextensies te wijzigen totdat een importeur ze accepteert.

Controleer identificatoren als de gids ontbreekt

In het fictieve voorbeeld kan demo.news overeenkomen met een kanaal dat in een XMLTV-gids is vastgelegd. Programmagegevens verwijzen terug naar die kanaalidentificator in de gids. Als de bron demo.news.hd gebruikt, leveren vergelijkbare weergavenamen niet noodzakelijk een koppeling op. Het precieze koppelgedrag hangt af van de applicatie en de afspraken van de bron.

Vergelijk voordat je identificatoren wijzigt de catalogus en gids die bedoeld zijn om samen te werken. Een regionale uitzending kan een andere identificator gebruiken dan een landelijke uitzending met een vergelijkbare naam. Namen overal vervangen in een groot bestand kan verkeerde koppelingen maken. Werk eerst met één duidelijk begrepen voorbeeld en lees hoe XMLTV-koppeling werkt voordat je de volledige lijst verandert.

Onderzoek de structuur zonder het account bloot te geven

Een URL kan inloggegevens in het pad bevatten en ook na een vraagteken. Alleen een parameter met de naam password verbergen is niet voldoende. Elders kan een token, accountnummer of ondertekend adres staan. Vervang bij een voorbeeld voor ondersteuning de volledige locatie door een gereserveerd voorbeeldadres en beschrijf het antwoord of de fout afzonderlijk.

Upload een privélijst niet naar een online formatter of validator alleen omdat die een handig voorbeeldvenster biedt. Een gedownloade catalogus kan ieder streamadres van het account blootleggen. Bewaar back-ups in opslag die je beheert en bedenk wie toegang heeft tot een gesynchroniseerde map. De privacyhandleiding voor afspeellijsten bevat een praktische controlelijst voor het weghalen van gevoelige gegevens.

Begrijp wat bewerken wel en niet oplost

Een tekstkopie kan een onvolledig adres, een onbedoeld regeleinde of een HTML-aanmeldpagina met een M3U-extensie onthullen. Dat zijn nuttige bevindingen. Toch kan een bestand met aannemelijke syntaxis naar onbereikbare media wijzen. Een groepsnaam, identificator of bestandsextensie wijzigen verlengt geen account, omzeilt geen serverbeperking en verleent geen toestemming om inhoud te bekijken.

Als de catalogus laadt maar één item niet speelt, noteer dan of andere items werken en of dezelfde toegestane stream ook elders in een compatibele opstelling mislukt. Bewaar bij een mislukte import het oorspronkelijke antwoord en raadpleeg de handleiding voor laadproblemen. Zodra je de structuur begrijpt, geeft de M3U-installatiehandleiding van InoxTV de daadwerkelijke importstappen. Zo koppel je een concrete bevinding aan de juiste vervolghandeling in de app.

Bronnen en verder lezen

Veelgestelde vragen

Is ieder M3U-bestand een lijst met televisiekanalen?
Nee. M3U kan andere media beschrijven, en een HLS-afspeellijst kan de segmenten van één presentatie beschrijven. Lees de inhoud van het bestand in plaats van alleen op de bestandsnaam af te gaan.
Kan een andere kanaalnaam de stream repareren?
Meestal niet. Een weergavenaam identificeert een item in de interface; de speler vraagt het adres op de volgende regel op. Een andere naam herstelt geen ontbrekende bron en verleent geen toegang.
Moet ik mijn afspeellijst publiceren als ik hulp vraag?
Nee. Streamadressen en afspeellijst-URL’s kunnen accountgegevens bevatten. Gebruik een fictief voorbeeld met dezelfde structuur en verwijder echte hosts, gebruikersnamen, wachtwoorden en tokens.