Mikä on M3U-soittolista? Muoto, esimerkit ja soittimen asetukset

M3U-soittolista on tavallinen tekstitiedosto. Siinä koko määritelmä. Sekaannus sen ympärillä johtuu siitä, että kaksi eri yhteisöä on laajentanut samaa yksinkertaista muotoa eri suuntiin.

Suoratoistoinsinöörit käyttävät M3U8-muotoa juuri niin kuin RFC 8216 sen määrittelee: HLS-videotoiston taustalla olevana soittolistamuotona. IPTV-palveluntarjoajat käyttävät tavallista M3U:ta epävirallisesti, lisäten omia merkintöjään kanavien nimille ja logoille — merkintöjä, joita ei koskaan ollut missään virallisessa määrityksessä. Molemmat ovat muodon oikeita käyttötapoja. Tämä opas erottaa ne selkeästi toisistaan, näyttää kummastakin merkityn esimerkin ja selittää, mihin tiedosto asettuu, kun olet valmis lataamaan sen soittimeen.

Tiiviisti

• M3U-soittolista on tavallinen tekstiluettelo suoratoistomerkinnöistä, joka alkaa tunnisteella #EXTM3U.
• M3U8 tarkoittaa nimenomaan, että tiedosto on UTF-8-koodattu, RFC 8216:n luvun 4.1 mukaisesti. Se on käytännön ero tavalliseen M3U:hun.
• IPTV-tyyliset merkinnät kuten tvg-id ja group-title ovat laajalti käytetty käytäntö, eivät osa virallista HLS-määritystä.

Mikä M3U-soittolista tarkalleen ottaen on?

M3U-soittolista on tekstitiedosto, joka kertoo mediasoittimelle, mitä toistaa ja missä järjestyksessä, yksi merkintä riviä kohden. Laajennetussa muodossaan tiedosto alkaa rivillä #EXTM3U, mikä on vaatimus, joka määritellään kohdassa RFC 8216, luku 4.3.1.1.

Jokaista merkintää voi edeltää #EXTINF-tunniste, jonka sama RFC määrittelee luvussa 4.3.2.1 muodossa #EXTINF:<kesto>,[<otsikko>]: kestoarvo, jota seuraa valinnainen otsikko. Siinä koko ydinmuoto: otsikkorivi ja sen jälkeen pareja metadataa ja osoitteita. Kaikki muu, mitä näet oikeassa soittolistassa, on tämän minimaalisen rakenteen päälle rakennettu laajennus.

M3U vai M3U8: mikä oikeasti on eri?

M3U8 tarkoittaa nimenomaan, että soittolista on koodattu UTF-8:lla, vaatimus, jonka RFC 8216 ilmaisee suoraan luvussa 4.1. Tavallisella M3U:lla sen sijaan ei ole kiinteää koodauskäytäntöä. Se on peräisin ajalta ennen virallista vaatimusta ja sitä on historiallisesti käsitelty joko Latin-1-koodauksena tai paikallisen järjestelmän oletuksena.

Koodausero näkyy selvimmin, kun kanavan nimessä on aksenttimerkkejä tai ei-latinalaista kirjoitusta. Jos soitin odottaa UTF-8:aa mutta saa toisin koodatun tiedoston, nämä merkit voivat näkyä vääristyneinä symboleina, vaikka soittolista muuten toimisikin. Kun näet rikkinäisiä merkkejä kanavien nimissä mutta kaikki silti toistuu, syy on yleensä koodauksessa, ei itse soittolistan rakenteessa.

Merkitty esimerkki — tavallinen HLS-M3U8-soittolista

RFC 8216 määrittelee tämän muodon suoraan: soittolista, joka koostuu segmenttiviittauksista, joilla kullakin on oma #EXTINF-kestonsa, ja jota käytetään yhden suoratoiston toimittamiseen paloina. Tämä on muoto, joka oikeasti kantaa nimeä "M3U8" itse määrityksessä.

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:10
#EXT-X-MEDIA-SEQUENCE:0
#EXTINF:9.009,
segment-000.ts
#EXTINF:9.009,
segment-001.ts
#EXTINF:9.009,
segment-002.ts
#EXT-X-ENDLIST

Joka rivillä on merkitystä. #EXT-X-VERSION ja #EXT-X-TARGETDURATION ovat saman RFC:n HLS-kohtaisia tunnisteita, ja jokainen .ts-tiedosto on lyhyt videosegmentti, jonka soitin hakee peräkkäin. Tämä on muoto, jonka päällä verkon videoinfrastruktuuri oikeasti toimii. Se on harvoin sitä, mitä IPTV-palveluntarjoaja antaa sinulle suoraan, mutta usein juuri sitä, mitä soittimesi hakee taustalla, kun lähde toistuu.

Oikeat HLS-toteutukset lisäävät yleensä vielä yhden kerroksen: pääsoittolistan, joka on merkitty tunnisteella #EXT-X-STREAM-INF ja joka listaa saman suoratoiston useita versioita eri bittinopeuksilla tai tarkkuuksilla, jolloin soitin voi vaihtaa niiden välillä verkko-olosuhteiden mukaan. Sinulle annettu yksittäinen osoite saattaa osoittaa juuri tähän pääsoittolistaan yllä näytetyn segmenttilistan sijaan; soitin ratkaisee loput automaattisesti.

Useimmat IPTV-keskeiset oppaat jättävät tämän kerroksellisen rakenteen kokonaan käsittelemättä, koska IPTV-soittolistat käyttävät sitä harvoin. Se on silti tärkeää tietää: se on todellinen rakenne, jota videosoitin on rakennettu ymmärtämään, vaikka saamasi M3U-tiedosto ei näyttäisi siltä lainkaan.

Merkitty esimerkki — tyypillinen IPTV-tyylinen M3U-soittolista

IPTV-palveluntarjoajat laajentavat perusmuotoa epävirallisesti lisäämällä jokaiseen merkintään attribuutteja kuten tvg-id, tvg-logo ja group-title. Mitään näistä ei määritellä RFC 8216:ssa. Ne ovat käytännössä syntynyt käytäntö, joka levisi IPTV-soittimiin ja -palveluntarjoajiin, koska ne ovat hyödyllisiä — ei siksi, että jokin standardielin olisi määritellyt ne.

#EXTM3U
#EXTINF:-1 tvg-id="channel.one" tvg-logo="https://example-provider.test/logo1.png" group-title="News",Channel One
https://example-provider.test/stream/CHANNEL_TOKEN_1
#EXTINF:-1 tvg-id="channel.two" tvg-logo="https://example-provider.test/logo2.png" group-title="Sports",Channel Two
https://example-provider.test/stream/CHANNEL_TOKEN_2

Yllä olevat osoitteet ja tunnisteet ovat paikkamerkkejä — älä koskaan julkaise tai jaa oikeaa soittolistaosoitetta julkisesti. Kuka tahansa, jolla on todellinen linkki, voi käyttää lähdettäsi, samalla tavalla kuin kuka tahansa salasanan omistava pääsee kirjautumaan tilille.

Huomaa kesto -1: se on suoratoistokäytäntö, joka tarkoittaa "ei kiinteää kestoa", eri asia kuin yllä olevan HLS-esimerkin äärelliset segmenttikestot. Sama tunniste, eri käytännön merkitys riippuen siitä, kumpi kahdesta perinteestä tiedoston tuotti.

Mihin EPG sopii mukaan?

Jotkin M3U-tiedostot sisältävät url-tvg=-otsikon, joka osoittaa erilliseen ohjelmaopastiedostoon, mutta itse opastiedot elävät soittolistan ulkopuolella. Soittolista kertoo soittimelle, mitä suoratoistoja on olemassa; erillinen XMLTV-tiedosto kertoo, mitä kullakin on ohjelmassa.

Tämä on tarkoituksellinen erottelu, ei rajoitus. Palveluntarjoajat voivat päivittää opastietoja omalla aikataulullaan, jopa useita kertoja päivässä ohjelmiston muuttuessa, koskematta itse soittolistaan. Kanavaluettelo ja aikataulu ovat kaksi itsenäisesti ylläpidettyä tiedostoa, jotka sattuvat toimimaan yhdessä.

Jos M3U:ssasi on url-tvg=-otsikko, sitä tukeva soitin voi hakea opastiedot automaattisesti ilman, että syötät toista osoitetta käsin. Jos otsikkoa ei ole, opas täytyy lisätä erikseen — se on eri asennusvaihe kuin soittolistan lisääminen ja tämän artikkelin ulkopuolella.

Miten soitin kuten IPTV Expert käyttää M3U-tiedostoa?

Soitin tarvitsee M3U-lähteen käyttöön vain kaksi asiaa: valitsemasi nimen ja itse soittolistan osoitteen. Juuri tätä IPTV Expertin lähteenlisäyslomake kysyy, ei mitään enempää, eikä käsin tehtävää erillistä vaihetta tunnisteiden kuten tvg-logo jäsentämiseen.

Kun tallennat nämä kaksi kenttää, sovellus lataa tiedoston kyseisestä osoitteesta ja jäsentää sen ennen kuin lähde käsitellään aktiivisena. Se lukee #EXTINF-merkinnät, poimii matkalla mahdollisen group-title- ja tvg-logo-metadatan ja rakentaa kanavaluettelosi löytämästään sisällöstä. Jos haluat tarkat vaihe vaiheelta -ohjeet laitteellesi, Näin lisäät M3U-soittolistan IPTV Expertiin käsittelee Androidin, iOS:n, Windowsin, Macin, Linuxin, Android TV:n ja Fire TV:n erikseen.

Jos et ole vielä asentanut IPTV Expertiä, aloita koko latausvalikosta ja valitse laitteesi versio, tai katso Parhaat ilmaiset IPTV-soittimet 2026, jos vertailet vielä vaihtoehtoja.

Yhteenveto

Kolme asiaa kulkee mukana kaiken edellä olevan läpi: M3U-soittolista on tavallista tekstiä, joka rakentuu tunnisteiden #EXTM3U ja #EXTINF ympärille; M3U8 tarkoittaa nimenomaan UTF-8-koodausta; ja IPTV-tyyliset tunnisteet, joita näet oikeissa soittolistoissa — tvg-id, tvg-logo, group-title — ovat laajalti omaksuttu käytäntö muodon päällä, eivät jotain, mitä RFC 8216 määrittelee. Kun se on selvää, soittolistan asettaminen soittimeen on vain kaksi kenttää: nimi ja osoite.