Tvheadend on TV-suoratoistopalvelin, joka voi vastaanottaa IPTV-lähteitä ja jakaa niistä muodostetut kanavat kotiverkon asiakaslaitteille. Tavallinen kompastuskivi on se, että M3U-soittolistan tuominen ei vielä tarkoita valmiita katseltavia kanavia.
Tvheadend käsittelee lähteen useassa vaiheessa. IPTV-verkkoon syntyy muxeja, muxista löydetään palveluita eli services, ja nämä palvelut täytyy lopuksi kartoittaa channels-kanaviksi. Vasta kanava on se kohde, jonka esimerkiksi TV-asiakasohjelma yleensä näyttää käyttäjälle.
Kun tämän ketjun ymmärtää, myös tilanteet kuten “M3U näkyy mutta kanavia ei ole” tai “Services-välilehti täyttyi, mutta asiakasohjelma on tyhjä” muuttuvat paljon helpommiksi selvittää.
Miten Tvheadend käsittelee IPTV-lähdettä?
Tvheadendin rakenne kannattaa hahmottaa näin:
Network -> Mux -> Service -> Channel
Jokaisella tasolla on oma tehtävänsä.
Network kokoaa yhteen tietyn lähteen, esimerkiksi yhden IPTV-palveluntarjoajan M3U-listan.
Mux edustaa IPTV-käytössä yksittäistä stream-lähdettä tai playlististä luotua syötettä.
Service on Tvheadendin kyseisestä muxista tunnistama TV- tai radiopalvelu.
Channel on käyttäjälle näkyvä kanava, johon yksi tai useampi service voidaan liittää.
Jos ketju katkeaa ennen Channel-vaihetta, loppukäyttäjän sovellus ei välttämättä näe mitään katseltavaa.
Mikä ero on servicellä ja channelilla?
Tämä on Tvheadendin tärkeimpiä käsitteitä.
Service on tekninen palvelu, jonka Tvheadend on löytänyt lähteestä. Channel puolestaan on käyttäjälle tarkoitettu looginen kanava.
Esimerkiksi IPTV-lähteestä löytyvä service voisi olla nimeltään:
YLE TV1 HD
Kun se kartoitetaan channeliksi, asiakasohjelma voi näyttää saman nimen kanavalistassa.
Samaa kanavaa voidaan joissakin Tvheadend-kokoonpanoissa syöttää myös useammasta servicestä. Tämä on hyödyllistä esimerkiksi silloin, kun sama TV-kanava on saatavilla eri lähteistä ja halutaan varavaihtoehto.
Peruskäytössä yksi IPTV-service kartoitetaan yleensä yhdeksi kanavaksi.
IPTV Automatic Network on helpoin M3U-listalle
Jos IPTV-palveluntarjoaja antaa kokonaisen M3U-soittolistan, käytännöllinen vaihtoehto on yleensä IPTV Automatic Network.
Se lukee M3U-listan ja muodostaa sen perusteella muxit automaattisesti.
Yleinen käyttöönotto etenee näin:
- avaa Tvheadendin web-käyttöliittymä
- siirry kohtaan Configuration
- avaa DVB Inputs
- valitse Networks
- lisää uusi verkko
- valitse IPTV Automatic Network
- anna verkolle kuvaava nimi
- lisää M3U-soittolistan URL
- tallenna verkko
Tvheadend käsittelee tämän jälkeen listan sisältämiä stream-osoitteita.
Jos käytät Tvheadendia osana laajempaa kotiverkon TV-ratkaisua, eri IPTV-laitteiden käyttötapoja kannattaa verrata siihen, millä laitteella kanavat lopulta katsotaan.
Mitä mux tarkoittaa IPTV-käytössä?
Perinteisessä antenni- tai satelliittitelevisiossa mux eli multiplex voi sisältää useita palveluita samassa lähetyksessä.
IPTV:ssä käsite näkyy käyttäjälle hieman eri tavalla.
Automatic IPTV Network voi luoda M3U-listan jokaisesta stream-osoitteesta oman muxin. Mux sisältää URL-osoitteen, jota Tvheadend yrittää avata ja tutkia.
Configuration -> DVB Inputs -> Muxes -näkymässä voit yleensä seurata esimerkiksi:
- onko mux käytössä
- mikä sen URL on
- onko skannaus käynnissä
- onnistuiko skannaus
- kuinka monta serviceä löytyi
Jos muxin scan result näyttää virhettä, serviceä ei välttämättä koskaan synny.
Tällöin kanavien map-toimintoon siirtyminen ei vielä ratkaise ongelmaa.
Miten palvelut syntyvät muxista?
Kun Tvheadend käsittelee muxia, se yrittää tunnistaa streamin sisältämän palvelun.
Onnistuneen skannauksen jälkeen palvelu ilmestyy yleensä kohtaan:
Configuration -> DVB Inputs -> Services
Jos M3U-listassa on esimerkiksi 50 toimivaa IPTV-streamia, tavoite on tavallisesti nähdä vastaavat palvelut Services-näkymässä.
Jos mux löytyy mutta service puuttuu, tarkista:
- avaako Tvheadend stream-URL:n
- onko IPTV-lähde aktiivinen
- salliiko palvelu samanaikaisen skannauksen
- onko streamin formaatti Tvheadendin käsiteltävissä
- onko URL edelleen voimassa
Services-välilehti on siis tärkeä raja. Kun palvelu näkyy siellä, lähteen lukeminen on jo edennyt pitkälle.
Miksi suuri IPTV-lista voi skannautua huonosti?
Tvheadend voi oletusarvoisesti yrittää tutkia eli probe-toiminnolla avata IPTV-listan streamit saadakseen niiden palvelutiedot.
Suuressa soittolistassa tästä voi syntyä paljon yhteyksiä.
Jos IPTV-palvelu sallii vain rajallisen määrän samanaikaisia streameja, Tvheadendin skannaus voi käyttää rajan nopeasti loppuun. Se voi näkyä epäonnistuneina mux-skannauksina, vaikka sama kanava toimisi tavallisessa IPTV-soittimessa.
Tällaisessa tilanteessa kannattaa tarkistaa IPTV-verkon Maximum number of input streams -asetus.
Aseta arvo palvelusi salliman käytön mukaisesti. Älä määritä suurta arvoa vain skannauksen nopeuttamiseksi.
Service probing voidaan joissakin tilanteissa ohittaa
Tvheadendin IPTV Automatic Network sisältää myös edistyneemmän vaihtoehdon palvelujen luomiseen ilman jokaisen streamin normaalia probe-skannausta.
Tämä voi auttaa silloin, kun palveluntarjoaja rajoittaa nopeasti peräkkäisiä yhteyksiä.
Expert-näkymässä käytössä voi olla asetuksia kuten:
- Service ID
- Scan after creation
Joissakin yhden palvelun MPEG-TS-streamien kokoonpanoissa Service ID voidaan määrittää etukäteen ja automaattinen skannaus poistaa käytöstä.
Tätä ei kuitenkaan kannata käyttää sokkona.
Jos streamien Service ID ei vastaa määritettyä arvoa tai lähteen rakenne poikkeaa odotetusta, palvelujen muodostaminen voi epäonnistua.
Aloittelijalle tavallinen skannaus on yleensä parempi lähtökohta.
Miten servicestä tehdään katseltava channel?
Kun Services-näkymässä näkyvät halutut palvelut, ne täytyy mapata kanaviksi.
Siirry:
Configuration -> DVB Inputs -> Services
Valitse halutut servicet ja käytä Map Services -toimintoa.
Tvheadend tarjoaa kokoonpanosta riippuen vaihtoehtoja, joilla voidaan kartoittaa esimerkiksi kaikki valitut tai kaikki käytettävissä olevat palvelut.
Kun mapping onnistuu, kanavat ilmestyvät:
Configuration -> Channel / EPG -> Channels
Tämä on kohta, jossa palvelusta on tullut käyttäjälle näkyvä TV-kanava.
Jos asiakasohjelmasi ei näyttänyt mitään ennen mappingia, päivitä sen kanavalista tämän vaiheen jälkeen.
Kannattaako kaikki servicet mapata automaattisesti?
Ei aina.
Suuri IPTV-lista voi sisältää esimerkiksi:
- kanavia, joita et tarvitse
- eri maiden versioita
- radiopalveluita
- testistreameja
- samoista kanavista useita laatutasojen versioita
- VOD-tyyppisiä lähteitä
Kaikkien palveluiden automaattinen mapping voi tehdä kanavalistasta vaikeasti hallittavan.
Pienemmässä kotikäytössä voi olla järkevämpää mapata vain ne servicet, joita oikeasti käytetään.
Näin Channels-näkymä pysyy selkeämpänä ja kanavien numerointi sekä EPG-kohdistus ovat helpompia ylläpitää.

Miksi IPTV-listan nimi ei aina siirry kanavalle oikein?
M3U-listassa voidaan käyttää metatietoja, joilla palveluille annetaan nimiä, kanavanumeroita, ryhmiä ja logoja.
Kaikki listat eivät kuitenkaan sisällä näitä tietoja samalla tavalla.
Siksi mappingin jälkeen kannattaa tarkistaa Channels-näkymästä:
- Channel Name
- Number
- Icon
- Tags
- Services
Jos kanavan nimi on epäselvä, sen voi muokata Tvheadendissa.
Tämä ei muuta varsinaista IPTV-streamia. Se muuttaa vain sitä, millä nimellä käyttäjä näkee kanavan Tvheadendissa ja sen asiakasohjelmissa.
Miten kanavat järjestetään ryhmiin?
Tvheadend käyttää Channel Tags -toimintoa kanavien ryhmittelyyn.
Voit luoda esimerkiksi ryhmät:
- Suomi
- Pohjoismaat
- Urheilu
- Uutiset
- Lapset
- Elokuvat
Tämän jälkeen yhteensopiva asiakasohjelma voi näyttää kanavat ryhmittäin.
Hyvin rakennettu kanavalista on erityisen hyödyllinen, jos alkuperäinen M3U sisältää satoja palveluita.
Kaikkien IPTV-lähteen ryhmien ei tarvitse näkyä sellaisinaan loppukäyttäjälle.
Miten EPG liitetään Tvheadend-kanaviin?
EPG eli sähköinen ohjelmaopas käsitellään erikseen varsinaisesta service-to-channel-mappingista.
Kanava voi siis toimia täydellisesti, vaikka sillä ei olisi lainkaan ohjelmatietoja.
IPTV-käytössä EPG tulee usein XMLTV-lähteestä.
Tyypillinen kokonaisuus on:
M3U -> muxit -> services -> channels
ja erikseen:
XMLTV -> EPG-tiedot -> channel mapping
Jos kanavat näkyvät mutta ohjelmaopas on tyhjä, ongelma ei yleensä ole enää IPTV-muxissa.
Tarkista EPG Grabber Modules -asetukset, XMLTV-lähde ja se, onko ohjelmaopas kohdistettu oikeisiin Tvheadend-kanaviin.
EPG-tunnisteen täytyy vastata oikeaa kanavaa
M3U-listan tvg-id ja XMLTV-lähteen channel ID voivat auttaa ohjelmatietojen automaattisessa kohdistamisessa.
Jos tunnisteet poikkeavat toisistaan, Tvheadend ei välttämättä tiedä, mille kanavalle EPG kuuluu.
Esimerkiksi näkyvä kanavanimi voi olla sama molemmissa lähteissä, mutta tekninen tunniste eri.
Silloin EPG voidaan joutua kohdistamaan manuaalisesti Channels-asetuksissa.
Jos ohjelmatiedot puuttuvat vain muutamalta kanavalta, koko XMLTV-lähdettä ei kannata heti vaihtaa. Tarkista ensin juuri näiden kanavien EPG mapping.
Mitä asiakasohjelma tarvitsee Tvheadendilta?
Tvheadend toimii palvelimena, ei ensisijaisesti television käyttöliittymänä.
Varsinainen katselu tehdään yleensä toisella laitteella tai asiakasohjelmalla.
Tvheadend voi jakaa kanavia esimerkiksi kotiverkon laitteille, jotka osaavat käyttää sen stream- tai HTSP-rajapintoja.
Kokonaisuus voi näyttää esimerkiksi tältä:
IPTV-lähde -> Tvheadend-palvelin -> Android TV / tietokone / muu TV-asiakas
Tvheadend voi samalla keskittää kanavalistan, EPG:n ja tallennuksen yhteen palvelimeen.
Tämä on hyödyllistä, jos kotona on useita katselulaitteita.
Maximum Input Streams vaikuttaa myös normaaliin katseluun
Samanaikaisten streamien raja ei koske vain skannausta.
Jos IPTV-palvelu sallii esimerkiksi vain yhden samanaikaisen yhteyden, Tvheadend ei voi turvallisesti avata useita kanavia yhtä aikaa saman tilauksen kautta.
Useita yhteyksiä voivat käyttää esimerkiksi:
- kaksi yhtäaikaista katselulaitetta
- yksi katselu ja yksi tallennus
- aktiivinen kanava ja taustalla tapahtuva skannaus
Määritä Tvheadendin rajat oman IPTV-palvelusi ehtojen mukaan.
Älä yritä kiertää palveluntarjoajan yhteysrajoituksia.
Miksi kanava toimii IPTV-soittimessa mutta ei Tvheadendissa?
Tämä voi johtua useasta asiasta.
Tarkista ensin, mitä URL-osoitetta Tvheadend yrittää avata.
Mahdollisia syitä ovat:
- stream käyttää formaattia, jota kokoonpano ei käsittele odotetusti
- URL vaatii muuttuvia tunnisteita
- palveluntarjoaja rajoittaa probe-yhteyksiä
- soittimen ja Tvheadendin HTTP-käyttäytyminen eroaa
- stream käynnistyy hitaasti ja timeout tulee vastaan
- samanaikaisen käytön raja täyttyy
Jos M3U toimii tavallisessa soittimessa, mutta Tvheadendin mux jää Failed-tilaan, tarkista Tvheadendin loki ennen asetusten laajempaa muuttamista.
Yleisiä M3U-, verkko- ja IPTV-yhteysongelmia käsitellään myös IPTV:n usein kysytyissä kysymyksissä.
Miksi M3U-listan päivitys voi muuttaa muxeja?
IPTV Automatic Network käyttää playlistiä muxien lähteenä.
Jos M3U-listan stream-URL muuttuu myöhemmin, Tvheadend voi tulkita sen uudeksi muxiksi.
Tämä on tärkeää palveluissa, joissa URL sisältää muuttuvia parametreja tai väliaikaisia tunnisteita.
Seurauksena voi olla:
- uuden muxin luominen
- vanhan muxin poistuminen
- uusia servicejä
- tarve mapata uudet servicet kanaviksi
Siksi muuttuva playlist kannattaa tarkistaa päivitysten jälkeen erityisesti silloin, jos kanavia katoaa Channels-näkymästä.
Milloin Manual IPTV Network on parempi?
Jos sinulla on vain yksi tai muutama IPTV-stream, koko M3U-listan automaattinen tuonti ei ole välttämätön.
Manual IPTV Networkissa voit luoda muxit itse ja antaa jokaiselle suoran stream-osoitteen.
Tämä antaa enemmän hallintaa, mutta lisää käsityötä.
Automatic Network sopii paremmin esimerkiksi kymmenien kanavien listalle.
Manual Network voi olla hyödyllinen testauksessa, erityisesti kun haluat selvittää yhden streamin Service ID:n tai nähdä, onnistuuko juuri tietyn URL:n skannaus.
Tvheadend ei muuta IPTV-lähteen käyttöoikeuksia
Tvheadend toimii teknisenä välipalvelimena.
Se ei muuta IPTV-palvelun tilauksen ehtoja, kanavaoikeuksia tai samanaikaisten yhteyksien määrää.
Käytä vain M3U-, MPEG-TS- ja muita lähteitä, joihin sinulla on asianmukainen käyttöoikeus.
Pohjoismaista IPTV-palvelua voi tarkastella vertailun vuoksi myös Rapid IPTV -sivustolla. Tvheadend-yhteensopivuutta arvioitaessa olennaista on tarkistaa, millaisen lähteen palvelu toimittaa ja sallitaanko sen käyttö omassa palvelinkokoonpanossa.
Käytännöllinen vianrajausjärjestys
Jos kanavaa ei saada näkyviin, etene Tvheadendin oman rakenteen mukaan:
- tarkista Network
- varmista, että M3U on luettu
- tarkista Muxes
- katso Scan Status ja Scan Result
- tarkista syntyvätkö Services
- mapita halutut Services Channels-kanaviksi
- tarkista Channels-näkymä
- lisää EPG erikseen
- päivitä asiakasohjelman kanavalista
Tämä on tehokkaampi tapa kuin asetusten muuttaminen satunnaisesti.
Jos Network ja Mux ovat kunnossa mutta Service puuttuu, ongelma on skannausvaiheessa.
Jos Service löytyy mutta Channel puuttuu, ongelma on mappingissa.
Jos Channel toimii mutta EPG puuttuu, ongelma on ohjelmaoppaassa.
Usein kysytyt kysymykset Tvheadendista
Miksi Tvheadend näyttää servicet mutta ei kanavia?
Servicet täytyy mapata channels-kanaviksi. Tee tämä Configuration -> DVB Inputs -> Services -näkymän Map Services -toiminnolla.
Mikä IPTV Automatic Network on?
Se on Tvheadendin verkkotyyppi, joka lukee M3U-soittolistan ja luo sen perusteella IPTV-muxit automaattisesti.
Mikä mux on IPTV:ssä?
Tvheadendissa mux edustaa lähdettä, jonka kautta yksi tai useampi service voidaan vastaanottaa. Automatic IPTV Networkissa M3U-listan streamit muodostavat tyypillisesti omia muxejaan.
Tarvitaanko EPG ennen kanavan katselua?
Ei. Kanavaa voidaan katsoa ilman EPG:tä. Ohjelmaopas on erillinen tietokerros.
Miksi IPTV-skannaus epäonnistuu suuren M3U-listan kanssa?
Palveluntarjoaja voi rajoittaa samanaikaisia yhteyksiä tai probe-skannauksia. Tarkista Maximum number of input streams ja Tvheadendin loki.
Voiko Tvheadendilla käyttää useita IPTV-lähteitä?
Kyllä. Eri lähteille voidaan luoda omat networkit, joiden servicet voidaan lopuksi mapata halutuiksi channels-kanaviksi.
Yhteenveto
Tvheadendissa IPTV-lähteen lisääminen on vasta ensimmäinen vaihe. Automatic IPTV Network lukee M3U-listan ja muodostaa muxit, joista Tvheadend tunnistaa servicet. Nämä servicet täytyy sen jälkeen mapata channels-kanaviksi ennen kuin ne näkyvät normaalisti asiakasohjelmissa. EPG lisätään vielä erillisenä kerroksena. Kun vianrajaus tehdään järjestyksessä Network -> Mux -> Service -> Channel, on helppo nähdä, missä kohdassa IPTV-lähteen käsittely pysähtyy.
Jos haluat tutustua IPTV-palveluun Suomessa sekä eri katselulaitteiden ja IPTV-ratkaisujen käyttöönottoon, voit tutustua Nordic One IPTV -sivustoon.