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.
| Voorbeeldveld | Doel | Wat het niet bewijst |
|---|---|---|
tvg-id="demo.news" | Kanaalidentificator die aan gidsgegevens gekoppeld kan worden | Dat er een bijpassend gidsitem bestaat |
group-title="Examples" | Voorgestelde categorie om items te ordenen | Dat alle spelers groepen hetzelfde interpreteren |
Example News | Leesbare kanaalnaam | Dat de stream online is of een licentie heeft |
| De volgende URL | Locatie die voor afspelen wordt opgevraagd | Dat 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.
