Configuratie
Opbouw van een M3U-bestand: de anatomie van een IPTV-afspeellijst
Begrijp de opbouw van een M3U-bestand voor IPTV: kopregel #EXTM3U, #EXTINF-regels, group-title en logo's. De 3 onderdelen van een afspeellijst uitgelegd.
Als u de interne opbouw van een M3U-bestand begrijpt, kunt u weergaveproblemen zoals een ontbrekend logo of een zender in de verkeerde categorie beter onderzoeken. U ziet dan ook wat de app precies doet wanneer deze een lijst 'laadt'. Deze gids legt iedere regel uit zonder technische voorkennis te veronderstellen.
Wat is een M3U-bestand precies?
Een M3U-bestand is een bestand met platte tekst, geen video. Het verwijst naar een reeks streams of mediabestanden. Het formaat bestaat al sinds de begintijd van MP3 en werd later ook gebruikt voor videostreaming. Volgens de documentatie op Wikipedia is het nog steeds een van de breedst ondersteunde afspeellijstformaten. Wanneer een app een M3U-URL 'opent', downloadt zij dit tekstbestand en verwerkt ze iedere regel om de zenderlijst op het scherm op te bouwen, zoals in het diagram hierboven.
Wat doet de kopregel #EXTM3U?
Iedere uitgebreide M3U-lijst begint op de eerste regel met de kop #EXTM3U. Daaraan herkent de speler een uitgebreid bestand dat namen, logo's en categorieën kan bevatten. Zonder deze regel op de eerste positie behandelen de meeste spelers het bestand als een kale lijst URL's, of laden ze het helemaal niet. De kop ziet er zo uit:
#EXTM3U
Wat staat er in de regel #EXTINF?
Elke #EXTINF-regel beschrijft één zender: de duur, een aantal optionele attributen en de getoonde naam, gevolgd op de volgende regel door de stream-URL. Voor iedere invoer in de afspeellijst staat zo'n regel. Een typische invoer ziet er zo uit:
#EXTINF:-1 tvg-id="zender1" tvg-logo="https://exemplo.pt/logotipo.png" group-title="Sport",Zendernaam
https://servidor-exemplo.pt/direto/canal1/index.m3u8
Deze regel bestaat uit drie onderdelen:
- De duur (
-1voor een live-uitzending zonder vaste lengte; een positief getal geeft bij on-demand inhoud de duur in seconden aan). - De optionele attributen:
tvg-id(de ID waarmee een programmagids wordt gekoppeld),tvg-logo(de URL van het logo) engroup-title(de getoonde categorie, zoals Sport of Film). - De getoonde naam, na de laatste komma.
De volgende regel bevat de URL van de stream zelf. Dit is het adres dat de speler gebruikt om het afspelen te starten zodra u de zender kiest.
Waarvoor dient group-title in een M3U-lijst?
Het attribuut group-title bepaalt in welke categorie een zender verschijnt in apps die dit attribuut gebruiken. Ontbreekt het of ondersteunt de speler het niet, dan worden alle zenders doorgaans in één lijst zonder categorieën getoond. Dezelfde M3U-lijst kan in de ene app dus overzichtelijker ogen dan in de andere. Dat ligt aan de manier waarop de speler het attribuut verwerkt en niet aan de afspeellijst zelf.
Wat is het verschil tussen M3U en M3U8?
Het verschil tussen beide extensies zit alleen in de tekencodering. Een .m3u8-bestand gebruikt UTF-8, dat nodig is om accenten en niet-Latijnse tekens in zendernamen correct weer te geven. Het uitgebreide M3U8-formaat wordt ook gebruikt voor adaptieve HLS-streaming, oftewel HTTP Live Streaming. Daarbij verwijst iedere afspeellijst naar opeenvolgende videosegmenten in plaats van één doorlopende stream, zoals Wikipedia beschrijft. Bij normaal IPTV-gebruik merkt u weinig van dit onderscheid: vrijwel alle moderne apps ondersteunen beide extensies.
Hoe opent een speler een M3U-URL?
Apps zoals VLC kunnen een M3U-URL rechtstreeks vanuit het menu voor netwerkweergave openen, zonder speciaal IPTV-aanmeldscherm. Deze werkwijze staat in de officiële VideoLAN-documentatie. Andere IPTV-apps, zoals IPTV Smarters Pro, hebben een apart scherm voor de M3U-URL en plaatsen hun eigen interface over de beschreven structuur.
Welke problemen herkent u aan de structuur?
Met kennis van de opbouw herleidt u de meeste weergaveproblemen tot één regel of attribuut. Een ontbrekend logo, een zender in de verkeerde categorie of een lijst die niet laadt: elk symptoom wijst naar een ander onderdeel. De drie meest voorkomende gevallen:
- Logo ontbreekt: de URL in
tvg-logois niet beschikbaar of niet bereikbaar vanaf uw netwerk. - Zender staat in de verkeerde of geen categorie: het attribuut
group-titleontbreekt in de#EXTINF-regel of de speler gebruikt het niet. - De lijst wordt niet geladen: meestal ligt het aan de hoofd-URL of de verbinding en niet aan de interne bestandsstructuur. Lees wat u kunt doen als de M3U-lijst niet wordt geladen.
Nu u de structuur kent, leest u in ons artikel over een M3U-lijst beheren hoe u de lijst ordent, bijwerkt en overzichtelijk houdt.
Samenvatting
Een M3U-bestand is een tekstbestand met een eenvoudige structuur: een kop, gevolgd door paren van #EXTINF- en URL-regels voor iedere zender. Als u deze opbouw begrijpt, kunt u het gedrag van de app verklaren en een probleem met de afspeellijst onderscheiden van een netwerkprobleem. Lees M3U of Xtream Codes om tussen beide verbindingsmethoden te kiezen.
Veelgestelde vragen
Wat is het verschil tussen .m3u en .m3u8?
Beide hebben dezelfde structuur. De extensie .m3u8 geeft alleen aan dat het bestand UTF-8-codering gebruikt. Die is nodig om accenten en speciale tekens correct te tonen, bijvoorbeeld in zendernamen uit verschillende talen. De meeste moderne IPTV-apps ondersteunen beide formaten op dezelfde manier.
Waarvoor dient de regel #EXTM3U aan het begin van het bestand?
Dit is de verplichte kopregel die het bestand herkenbaar maakt als uitgebreide M3U-lijst. Zonder deze regel op de eerste positie herkennen de meeste spelers het bestand niet als geldige afspeellijst.
Wat betekent de groepstitel in een #EXTINF-regel?
Dit is een optioneel attribuut dat de categorie van een zender aangeeft, bijvoorbeeld Sport, Film of Nieuws. Geschikte apps gebruiken het om de lijst automatisch per onderwerp te ordenen in plaats van alle zenders bij elkaar te tonen.
Waarom worden sommige zenderlogo's niet getoond?
Het logo wordt geladen via een URL in het attribuut tvg-logo van de #EXTINF-regel. Ontbreekt die URL, is deze verlopen of wordt deze door het netwerk geblokkeerd, dan toont de speler een standaardpictogram.
Kan ik een M3U-bestand in een eenvoudige teksteditor openen en afspelen?
U kunt het bestand wel openen, maar niet afspelen. Een M3U-bestand is platte tekst die in iedere editor kan worden bekeken. Alleen een geschikte app, zoals VLC, TiviMate of IPTV Smarters Pro, kan de streams afspelen waarnaar het bestand verwijst.
Staat de video zelf in het M3U-bestand?
Nee. Het bestand bevat alleen URL's naar videostreams op een externe server en metadata zoals de naam, het logo en de categorie. Het bestand zelf is maar enkele kilobytes groot, ongeacht de omvang van de catalogus waarnaar het verwijst.
