Soittolistan päivitys
Soittolista päivittyy oletuksena kerran vuorokaudessa. Väliksi voi valita jokaisen käynnistyksen, 6, 12, 24 tai 48 tuntia tai pelkän käsin päivityksen.
IPTV-opas
M3U-soittolista ja XMLTV-ohjelmaopas: näin ne toimivat Virekossa
IPTV-palvelu antaa yleensä kaksi osoitetta: M3U-soittolistan, jossa ovat kanavat, ja XMLTV-ohjelmaoppaan, jossa ovat ohjelmatiedot. Tässä oppaassa kerromme, mitä tiedostoissa on, miten Vireko yhdistää kanavat oppaaseen ja miten korjaat yleisimmät ongelmat, kuten puuttuvat ohjelmatiedot ja väärät kellonajat.
Lyhyt vastaus
M3U-soittolista on tekstitiedosto, jossa jokaisella kanavalla on tietorivi ja osoite. XMLTV on XML-muotoinen ohjelmaopas, jossa on kanavat ja niiden ohjelmat alkamis- ja päättymisaikoineen. Vireko yhdistää kanavan oppaaseen, kun soittolistan tvg-id vastaa oppaan kanavatunnusta. Jos ohjelmatiedot puuttuvat, yhdistä kanava oppaaseen käsin. Jos kellonajat ovat väärin, korjaa ne aikasiirrolla. Opas päivittyy oletuksena kuuden tunnin välein.
Vireko IPTV PlayeriOS · Mac · Apple TV · Android · Android TV
M3U
Mikä on M3U-soittolista?
M3U on yksinkertainen tekstimuotoinen soittolista. IPTV-palvelut käyttävät sitä kanavien, elokuvien ja sarjojen listaamiseen.
Rakenne
Laajennettu M3U-tiedosto alkaa rivillä #EXTM3U. Jokaisella kanavalla on #EXTINF-rivi, jossa on kanavan tiedot ja nimi, ja sen alla rivi, jossa on lähetyksen osoite. Sama muoto on käytössä myös HLS-suoratoistossa, jonka määrittely on julkaistu RFC 8216 -dokumenttina.
Kanavan lisätiedot
IPTV-soittolistoissa #EXTINF-riville lisätään yleensä tietoja, kuten tvg-id, tvg-name, tvg-logo ja group-title. Vireko käyttää tvg-id:tä oppaan yhdistämiseen, tvg-nameä kanavan nimenä, tvg-logoa kanavan logona ja group-titleä kategoriana. Jos group-title puuttuu, Vireko käyttää #EXTGRP-riviä. Lisäksi Vireko lukee catch-up-tiedot, kuten catchup, catchup-source ja catchup-days.
Ohjelmaopas suoraan soittolistasta
Jos #EXTM3U-rivillä on url-tvg- tai x-tvg-url-määre, Vireko ottaa sen ohjelmaoppaan osoitteeksi automaattisesti. Jos itse lisäämäsi oppaan osoite on annettu, se on etusijalla.
Elokuvat ja sarjat
Vireko tunnistaa soittolistan elokuvat ja sarjat automaattisesti esimerkiksi osoitteen polusta (/movie/, /series/), jakson nimestä (S01E02), tiedostopäätteestä (esimerkiksi .mp4 tai .mkv) tai kategorian nimestä. Muut rivit näytetään live-kanavina.
XMLTV
Mikä on XMLTV-ohjelmaopas?
XMLTV on XML-muotoinen tiedosto televisio-ohjelmien tiedoille. Sen ylläpidosta vastaa XMLTV-projekti.
Kanavat ja ohjelmat
Tiedostossa on channel-elementtejä, joilla on tunnus (id) ja nimi, sekä programme-elementtejä, joissa on kanavan tunnus, alkamis- ja päättymisaika, nimi ja kuvaus. Ajat merkitään esimerkiksi muodossa 20260106200000 +0200, eli päivämäärä ja kellonaika ja niiden perässä aikavyöhykkeen ero.
Mitä Vireko lukee
Vireko käyttää kanavista tunnusta ja ensimmäistä nimeä ja ohjelmista nimeä, alaotsikkoa ja kuvausta. Aikavyöhyke luetaan ajan perästä. Jos se puuttuu, aika tulkitaan laitteen paikalliseksi ajaksi.
Pakatut tiedostot
Opas voi olla tavallinen XML-tiedosto tai gzip-pakattu (.xml.gz tai .gz). Vireko tunnistaa pakkauksen tiedoston sisällöstä. ZIP-tiedostoja Vireko ei tue. Myös gzip-pakattu soittolista puretaan automaattisesti.
Yhdistäminen
Miten kanavat yhdistetään ohjelmaoppaaseen?
Ohjelmatiedot näkyvät vain, jos soittolistan kanava ja oppaan kanava on yhdistetty. Vireko tekee sen näin.
- tvg-id ensinKun soittolistan tvg-id on täsmälleen sama kuin oppaan kanavan tunnus, kanava yhdistyy automaattisesti.
- Nimen perusteella, kun osuma on varmaJos kanavalla ei ole opasta, Vireko vertaa nimiä. Vertailussa ohitetaan esimerkiksi maatunnukset, kanavanumerot, kirjainkoko ja sanat kuten HD tai 4K. Yhdistys tehdään automaattisesti vain, jos täsmäävä kanava on yksi ja sillä on ohjelmia.
- Automaattinen yhdistäminenYhdistämisnäkymä etsii vastineita myös muiden soittolistojesi oppaista ja valitsee varmat osumat valmiiksi. Mitään ei muuteta, ennen kuin vahvistat valinnat.
- Käsin yhdistäminenValitse kanava ja hae oppaasta oikea kanava nimellä. Käsin tehty yhdistys säilyy, kunnes muutat sen.
- Oma opas yhdelle kanavalleKanavalle voi antaa oman XMLTV-osoitteen. Käytä siihen pientä, yhden kanavan opasta, koska kaikki sen ohjelmat liitetään tälle kanavalle.
Ongelmat
Yleisimmät ongelmat ja ratkaisut
Vireko kertoo virheilmoituksessa, mikä soittolistan tai oppaan latauksessa meni vikaan. Näin korjaat yleisimmät tilanteet.
- Ohjelmat näkyvät väärään aikaanOpas on yleensä eri aikavyöhykkeessä. Korjaa ajat aikasiirrolla, jonka voi asettaa yhdelle kanavalle tai kaikille kanaville puolen tunnin askelin enintään 12 tuntia kumpaankin suuntaan. Kanavan ja koko oppaan aikasiirrot lasketaan yhteen.
- Opas latautuu, mutta ohjelmia ei näySoittolistan kanavilta puuttuu luultavasti tvg-id, tai se ei vastaa oppaan tunnuksia. Käytä automaattista yhdistämistä tai yhdistä kanavat käsin.
- Linkki palauttaa verkkosivunJos soittolistan tai oppaan osoite avaa verkkosivun eikä tiedostoa, käytä suoraa latauslinkkiä. Esimerkiksi Google Driven jakolinkit avaavat usein verkkosivun.
- Soittolista on tyhjä tai palvelin antaa virheenTarkista osoite ja tunnukset ja se, että tilauksesi on voimassa. Vireko kertoo palvelimen HTTP-virhekoodin, josta näkee, oliko vika palvelimessa vai osoitteessa.
- Suosikki katosi päivityksen jälkeenM3U-kanavan suosikit, katseluhistoria ja jatka katselua -kohta säilyvät päivityksessä, koska ne on sidottu lähetyksen osoitteeseen. Jos palveluntarjoaja vaihtaa kanavan osoitteen, suosikki katoaa ja se pitää lisätä uudelleen.
- Catch-up ei toimiCatch-up toimii vain, jos soittolistassa on catch-up-tiedot ja palvelu arkistoi kanavan. Vireko tukee muun muassa flussonic-, append-, shift- ja Xtream-tyyppejä. Jos catchup-days puuttuu, arkiston pituudeksi oletetaan seitsemän päivää.
Asetukset
Päivitykset, lisäoppaat ja Xtream Codes
Oppaan päivitys
Opas päivittyy oletuksena kuuden tunnin välein. Väliksi voi valita jokaisen käynnistyksen, tunnin, 3, 6, 12 tai 24 tuntia tai pelkän käsin päivityksen. Vireko lataa oppaan uudelleen vain, jos se on muuttunut.
Lisäoppaat
Lähteeseen voi lisätä muita XMLTV-oppaita, jotka yhdistetään sen omaan oppaaseen. Itse lisätty oppaan osoite korvaa palveluntarjoajan oppaan.
Xtream Codes
Xtream Codes -lähteelle Vireko muodostaa oppaan osoitteen (xmltv.php) automaattisesti samoilla tunnuksilla, ellet ole antanut omaa osoitetta. Jos XMLTV-opasta ei ole, Vireko hakee kanaville lyhyen oppaan palvelimelta.
UKK
Usein kysyttyä
Mikä ero on M3U- ja M3U8-tiedostolla?
Molemmat ovat samaa soittolistamuotoa. M3U8-pääte kertoo, että tiedosto on UTF-8-merkistössä. HLS-suoratoisto käyttää .m3u8-tiedostoja. Vireko hyväksyy soittolistaksi sekä .m3u- että .m3u8-tiedostot.
Mistä saan XMLTV-ohjelmaoppaan?
Yleensä IPTV-palvelultasi. Oppaan osoite voi olla soittolistan alussa url-tvg-määreenä, jolloin Vireko käyttää sitä automaattisesti. Xtream Codes -lähteelle Vireko muodostaa oppaan osoitteen itse.
Miksi kanavalla ei ole ohjelmatietoja?
Kanavaa ei ole yhdistetty oppaaseen, koska soittolistan tvg-id puuttuu tai ei vastaa oppaan tunnusta. Käytä automaattista yhdistämistä tai yhdistä kanava käsin. On myös mahdollista, ettei oppaassa ole tietoja kyseiselle kanavalle.
Miksi ohjelmat näkyvät väärään aikaan?
Oppaan aikavyöhyke on luultavasti eri kuin odotit. Korjaa ajat aikasiirrolla yhdelle kanavalle tai koko oppaalle puolen tunnin askelin.
Tukeeko Vireko pakattuja soittolistoja ja oppaita?
Tukee gzip-pakattuja tiedostoja, ja pakkaus tunnistetaan tiedoston sisällöstä. ZIP-tiedostoja Vireko ei tue.
Kuinka usein ohjelmaopas päivittyy?
Oletuksena kuuden tunnin välein. Väliksi voi valita jokaisen käynnistyksen, tunnin, 3, 6, 12 tai 24 tuntia tai pelkän käsin päivityksen.
Toimiiko catch-up M3U-soittolistalla?
Toimii, jos soittolistassa on catch-up-tiedot ja palvelu arkistoi kanavan. Vireko tukee muun muassa flussonic-, append-, shift- ja Xtream-tyyppejä, ja catchup-days kertoo, kuinka monta päivää taaksepäin arkistoa voi katsoa. Lue lisää Virekon käyttöönotosta oppaasta IPTV Apple TV:llä, iPhonella ja Macilla.
Lähteet
Formaattien yleistiedot perustuvat näihin lähteisiin, jotka tarkistettiin 6.11.2026. Virekon toiminta on tarkistettu sovelluksen iPhone-, iPad-, Mac- ja Apple TV -versioiden lähdekoodista.
Oppaat
Lue myös
Vireko-opas
IPTV Apple TV:llä, iPhonella ja Macilla: näin otat Virekon käyttöön
Opas kertoo, mitä IPTV:n katsomiseen tarvitaan ja miten lisäät soittolistan, ohjelmaoppaan tai mediapalvelimen Vireko IPTV Playeriin.
Sähköopas 2026Pörssisähkön hinta: näin seuraat sitä ja ajoitat sähkönkäytön
Opas kertoo, miten pörssisähkön hinta muodostuu, mitä sähkö maksaa veroineen ja siirtoineen ja miten seuraat hintaa Päivän Sähkö -sovelluksella.
Säästöopas 2026Pörssisähkö talvella: näin säästät, kun hinnat vaihtelevat
Opas kertoo, miksi pörssisähkö vaihtelee talvella, miten ajoitat suurimmat kulut halvoille tunneille ja milloin kiinteä hinta voi olla parempi.
Yhteydenotto
Rakennetaan jotain hienoa yhdessä.
Tarvitsetko nettisivut yrityksellesi, arvion nykyisestä sivustostasi tai apua sovellusidean kanssa? Kerro siitä, niin palaamme asiaan pian.