Heb je je eigen dienst geïnstalleerd via de Docker-handleiding? Hier lees je hoe je
de nieuwste versie installeert en wat er veranderd is. Je gebruikers, instellingen en opnames blijven bewaard.
Eerst een back-up. Maak vóór het bijwerken een kopie van het Docker-volume data
(bij het installatiescript <naam>_data). Daarin staan je instellingen, gebruikers, opnames en de
ondertekeningssleutel van de app. Zonder die sleutel kunnen geïnstalleerde apps niet meer worden bijgewerkt.
Met Portainer
Herstart de containers. Portainer → Stacks → jouw stack → vink app en apk-builder aan →
Restart. Bij het starten halen ze zelf de nieuwste software op. Na een minuut is de website weer bereikbaar.
Staat er bij "Wat is er nieuw" een nieuwe stack-instelling? Open dan de stack → Editor, vervang de inhoud door de
actuele portainer-stack.yml en klik Update the stack.
Je omgevingsvariabelen blijven staan; voeg alleen de nieuwe toe die je wilt gebruiken.
Controleer de versie: in de logs van de container app staat bovenaan Software bijgewerkt van ….
Staat er Download mislukt; vorige versie wordt gebruikt, dan was de downloadserver even niet bereikbaar: probeer het later opnieuw.
Met het installatiescript (Docker Compose)
Ga naar de map boveniptv-webapp (waar je het pakket de eerste keer hebt uitgepakt) en voer uit:
curl -fsSL https://videoland.amsterdam2.nl/download/iptv-webapp-docker.tar.gz | tar -xz
cd iptv-webapp/docker
docker compose up -d --build
Het pakket bevat geen .env en geen gegevens: je instellingen in docker/.env en het volume blijven onaangeroerd.
Het opnieuw uitvoeren van install.sh is niet nodig (dat schrijft een nieuwe .env).
Android-app bijwerken
Na een update van de server bouw je een nieuwe app-versie, zodat ook de apps op tv-boxen en telefoons de verbeteringen krijgen:
Log in als beheerder (vanaf je thuisnetwerk) en ga naar Instellingen → Android TV-app.
Klik Nieuwe app-versie bouwen. Dat duurt 1–5 minuten.
Klaar: alle apps tonen bij de volgende start Update vereist en werken zichzelf bij. Op sommige tv-boxen moet je één keer
"installeren toestaan" bevestigen.
Niet elke serverupdate heeft een nieuwe app nodig; bij "Wat is er nieuw" staat het erbij als het wél moet.
Wat is er nieuw
Overzichtelijkere instellingen 8 oktober 2026Nieuw
Instellingen is opgedeeld in onderdelen met een menu aan de linkerkant: Bron & abonnement, Gebruikers,
Apps, Mijn account en Weergave. Je ziet nu alleen de instellingen van het onderdeel dat je kiest, in plaats
van alles onder elkaar.
Op de telefoon staan de onderdelen als knoppen bovenaan, die je opzij kunt schuiven.
Ververs je de pagina, dan blijf je in hetzelfde onderdeel.
Actie Server bijwerken (containers herstarten). Een nieuwe app-versie is niet nodig.
Nettere zenderlijst bij Live TV 7 oktober 2026, avond
Favorieten, Nederland en Alle zenders hebben nu nette, gelijke iconen (geen losse emoji's meer) en staan
netjes uitgelijnd bovenaan.
Daaronder staat een kopje Categorieën met de groepen van je provider, zodat je eigen lijsten en die van de provider
duidelijk gescheiden zijn.
Actie Server bijwerken (containers herstarten). Een nieuwe app-versie is niet nodig.
Spoelen in films met ondertitels (browser) 7 oktober 2026, middagNieuw
Films die de server voor de browser omzet (bijv. om de Nederlandse ondertitels mee te sturen) gedroegen zich als een livestream:
de tijdbalk liet alleen het al omgezette stuk zien en verder spoelen ging niet.
Nu staat er een eigen tijdbalk over de hele film. Een lichte strook laat zien welk deel al klaar is: daarbinnen spoel je
direct. Spoel je verder (of terug), dan zet de server de film opnieuw om vanaf dat punt; na een paar seconden speelt hij daar
verder, met ondertitels. Volledig scherm kan met de knop naast de balk (of F).
Na spoelen kloppen beeld, geluid, ondertitels en de getoonde tijd precies met elkaar, en wordt ook het juiste punt bewaard voor
Verder kijken.
Actie Server bijwerken (containers herstarten). Een nieuwe app-versie is niet nodig.
Verder kijken op de tv: OK ingedrukt houden 7 oktober 2026, middag
Op de tv was het kruisje bij Verder kijken met de afstandsbediening niet goed te bereiken. Nu: kies de titel en houd OK
ingedrukt. Er verschijnt een venster met Verder kijken, Verwijderen uit Verder kijken en Annuleren.
Kort op OK drukken speelt de titel gewoon af.
Op de telefoon werkt lang aantikken op dezelfde manier; op de computer blijft het kruisje (en rechtsklikken opent het venster).
Actie Server bijwerken (containers herstarten). Een nieuwe app-versie is niet nodig.
Oplossing: geen ondertitels in de browser (FFmpeg ontbrak) 7 oktober 2026, middag
Met Portainer installeert de app-container FFmpeg bij het starten. Lukte dat net niet (bijv. omdat het netwerk nog niet klaar was),
dan stond in het logboek /api/remux FFmpeg is niet geïnstalleerd (ENOENT). Films werden dan niet omgezet: in de browser
geen ondertitels, geen Dolby-geluid en geen MKV in Safari. De Android-app had er geen last van.
De server installeert FFmpeg nu zelf als het ontbreekt, en probeert het elke minuut opnieuw tot het lukt. In het logboek zie je
FFmpeg geïnstalleerd: ondertitels en omzetten werken weer in de browser.
De Portainer-stack probeert het bij het starten nu ook vijf keer in plaats van één keer.
Actie Containers herstarten. Bij Portainer optioneel: de stack bijwerken met de actuele
portainer-stack.yml (niet nodig voor de oplossing zelf).
Ondertitels in de app 7 oktober 2026, middag
De Android-app kiest het Nederlandse ondertitelspoor van een film nu ook als dat alleen op naam herkenbaar is
("Nederlands"/"Dutch") en niet met de taalcode. Zet je de ondertitels zelf uit met de knop, dan blijft dat zo.
De app meldt welke ondertitelsporen een film heeft en welke gekozen is (in het logboek van de app-container), zodat
ontbrekende ondertitels snel te verklaren zijn.
Website: ook MP4-films uit NL-categorieën lopen nu via de server, zodat hun Nederlandse ondertitels in beeld komen
(voorheen alleen MKV/AVI). Getest in Chrome/Edge: het Nederlandse spoor staat aan, andere talen niet.
Actie Server bijwerken (containers herstarten) en een nieuwe app-versie bouwen.
Logo-animatie bij opstarten en op de eigen zender 7 oktober 2026, middag
De Android-app start met een korte animatie: het HoekiTV-logo komt in beeld vanuit zwart (3 seconden). Dit alleen als de app
"HoekiTV" heet; installaties met een eigen naam houden het opstartscherm met hun eigen naam.
Op de eigen zender (kanaal 0) vervaagt het beeld om de 2 minuten even naar dezelfde logo-animatie en daarna weer terug,
zoals een zenderlogo tussendoor op tv. Het geluid loopt gewoon door. Dit werkt in de Android-app en op de website.
Actie Server bijwerken (containers herstarten) en een nieuwe app-versie bouwen.
Nieuw logo 7 oktober 2026, middag
Nieuw beeldmerk: een grijze zeshoek met een rood-oranje afspeelpijl. Op de website (tabblad, kop, inlogscherm) staat het meteen;
de naam ernaast blijft de naam van jouw installatie.
Op de telefoon kun je de website als app op het beginscherm zetten: die krijgt nu ook dit logo (iPhone en Android).
De Android-app krijgt het nieuwe logo als app-icoon, op het opstartscherm en in de tegel op het startscherm van Android TV
(met de naam van jouw installatie).
Actie Server bijwerken (containers herstarten) en een nieuwe app-versie bouwen voor het
nieuwe app-icoon en de tv-tegel.
Nederlandse ondertitels in de browser 7 oktober 2026, middag
Films en afleveringen uit NL-categorieën (bijv. NL - Bioscoop, NL | Netflix) hebben bij veel providers de Nederlandse
ondertitels als los spoor in het bestand. Een browser (Chrome/Edge op de computer, Chrome op Android-telefoons) liet die bij
direct afspelen weg. Zulke titels lopen in de browser nu via de server, die de Nederlandse ondertitels meestuurt en standaard aanzet.
Lukt dat niet, dan speelt de titel zoals voorheen direct af (zonder ondertitels). De Android-app en Safari (iPhone, iPad, Mac)
toonden de ondertitels al; daar verandert niets.
Omzetten kost de server wat rekenkracht en het starten duurt een paar seconden langer.
Actie Server bijwerken (containers herstarten). Een nieuwe app-versie is niet nodig.
Beter met andere providers 7 oktober 2026, middag
Scheidingsregels die providers als zender in de lijst zetten (bijv. ✦●✦● CINEMA ✦●✦● of #### FRANCE VIP ####)
worden niet meer getoond. Die waren niet af te spelen.
Bij Live TV kiest de app niet meer de "8K"- of "16K"-variant van een zender. Die bestaan niet echt (opgeschaald), zijn zwaar
en haperen vaak. De gewone HD-variant gaat voor, SD blijft reserve. Bij de huidige zenderindeling verandert er niets.
Een get.php-link van een provider (M3U plus) kun je gewoon plakken bij Instellingen: de app herkent die zelf als Xtream-account,
zodat films, series, programmagids en terugkijken werken.
Actie Server bijwerken (containers herstarten). Een nieuwe app-versie is niet nodig.
Nettere startpagina 7 oktober 2026, middag
De kaarten in Verder kijken zijn weer allemaal even groot en staan op gelijke afstand (sinds het ×-knopje werden ze soms
smaller of breder, afhankelijk van titel en plaatje).
Titels zonder plaatje in Verder kijken: is een afbeelding van de provider kapot, dan probeert de app de volgende
(achtergrond, poster, de afbeelding uit de catalogus) en haalt hij zo nodig de afbeelding uit de filmgegevens op.
Het jaartal klopt nu met de titel: bij "Beste Zangers (2024)" staat er 2024, niet het afwijkende jaartal van de provider
(bijv. 2009, het startjaar van het programma). Dat geldt voor de grote titel bovenaan, de kaarten, de detailpagina en de speler.
Actie Server bijwerken (containers herstarten). Een nieuwe app-versie is niet nodig.
Verder kijken opruimen 7 oktober 2026, middag
Elke titel in Verder kijken op het startscherm heeft nu een ×-knopje om hem uit de rij te halen. Op de computer
verschijnt het als je met de muis over de kaart gaat, op telefoon en tablet staat het er altijd. Op de tv: kies de kaart, druk
↑ naar het knopje en OK.
Bij series verdwijnt alleen de titel uit de rij. Welke afleveringen je al gezien hebt blijft bewaard, en zodra je de serie
weer kijkt komt hij vanzelf terug.
De Android-app is technisch bijgewerkt: volledig scherm gebruikt op nieuwere tv-boxen (Android 11 en hoger) de nieuwe
manier van Android, en de app bouwt zonder waarschuwingen.
Actie Server bijwerken (containers herstarten); het ×-knopje werkt daarna meteen, ook
in de app. Bouw daarna een nieuwe app-versie voor de bijgewerkte Android-app.
Zappen houdt de verbinding vrij 7 oktober 2026, middag
Bij een zenderwissel sluit de server nu eerst de vorige live-stream van dat apparaat en opent pas daarna de nieuwe.
Daardoor ziet de provider of Dispatcharr nooit even twee verbindingen. Met Dispatcharr blijft zappen zo op hetzelfde account
in plaats van steeds naar een tweede account te springen.
Twee tv's op hetzelfde account tellen als twee apparaten: de ene zapt de andere niet weg.
Actie Server bijwerken (containers herstarten). Een nieuwe app-versie is niet nodig.
App blijft niet meer stil op het startscherm 7 oktober 2026, middag
Kan de app de server niet bereiken, dan zegt hij nu waarom: geen antwoord, ongeldig https-certificaat, een foutcode,
of een doorverwijzing naar een inlogpagina van de reverse proxy. Het startscherm toont met welk adres hij verbindt.
OK (of tikken op de telefoon) = opnieuw proberen.
Instellingen → Android TV-app toont welk adres er in de app zit, met een waarschuwing als dat niet werkt op een tv-box
(bijv. localhost).
In het logboek van de app-container zie je nu app … opent de website vanaf … als een tv-box verbinding maakt.
Actie Server bijwerken, controleer in Instellingen → Android TV-app het adres, bouw een
nieuwe app-versie en installeer die opnieuw via Downloader (een app die op het startscherm hangt, kan zichzelf niet bijwerken).
Oplossing: app bouwen mislukt (android-35) 7 oktober 2026, middag
Bouwen van de app kon mislukken met Failed to find target with hash string 'android-35'. Dat gebeurde als de
eerste installatie van de bouwomgeving was onderbroken (bijv. door een herstart). De APK-builder controleert dit nu bij het
starten en installeert ontbrekende onderdelen opnieuw.
Actie Herstart de container apk-builder en wacht tot in de logs
Bouwomgeving klaar staat (een paar minuten). Klik daarna opnieuw op Nieuwe app-versie bouwen.
Oplossing: live-zenders via Dispatcharr 7 oktober 2026, middag
Was Dispatcharr ingesteld als Xtream Codes, dan bleven live-zenders laden en stopten ze na 20 seconden
(in het logboek: This operation was aborted). De server herkent nu zelf dat de bron live als TS-stream levert en schakelt daarop over.
Actie Server bijwerken (containers herstarten) en daarna de website één keer vernieuwen.
De eerste zender kan nog één keer kort haperen, daarna start live direct. Een nieuwe app-versie is niet nodig.
Dispatcharr en meerdere streams tegelijk 7 oktober 2026
Dispatcharr als bron. Onder Instellingen → IPTV-bron staat naast Xtream Codes en M3U-link nu ook
Dispatcharr. Dispatcharr beheert je provider(s), verbindingen en programmagids; deze dienst kijkt via Dispatcharr.
Zie Dispatcharr toevoegen.
Meerdere streams tegelijk. Heeft je abonnement (of Dispatcharr) meer dan één verbinding, dan kunnen meerdere mensen
tegelijk kijken en lopen opnames daarnaast door, ook meerdere opnames tegelijk. Kijken gaat nog steeds voor: zijn alle
verbindingen bezet, dan pauzeert alleen de laatst gestarte opname.
Instelling "Max. gelijktijdige streams" (Instellingen → IPTV-bron → Geavanceerd). Leeg = het aantal dat de provider
opgeeft. Op de overzichtspagina zie je hoeveel streams er nu in gebruik zijn.
Nieuwe omgevingsvariabelen: IPTV_TYPE en IPTV_MAX_STREAMS (alleen nodig bij een nieuwe installatie).
Actie Server bijwerken. Wil je Dispatcharr in dezelfde stack: stack bijwerken
(zie hieronder). Een nieuwe app-versie bouwen wordt aangeraden (Dispatcharr-zenders starten dan direct in het juiste formaat).
Opnemen, programmagids en meer 6 oktober 2026
Live tv opnemen vanuit de gids of de live-speler, met 2 minuten marge vooraf en 5 minuten achteraf. Opnames staan
onder Opnames en zijn al te bekijken terwijl ze nog lopen. In Docker komen ze in het data-volume
(of een eigen map via RECORD_DIR).
Programmagids (menu Gids) met een tijdlijn per zender.
Films in Safari/iPhone en films met Dolby/DTS-geluid worden automatisch omgezet (FFmpeg), met Nederlandse ondertiteling.
Zwarte zenders worden herkend; de speler schakelt automatisch naar een andere variant van dezelfde zender.
Thuis sneller zappen met LAN_URL: de app gebruikt thuis het interne adres.
Per account instelbaar welke inhoud zichtbaar is (bijv. zonder 18+), en een profielfoto via Gravatar.
Casten naar Chromecast (Chrome/Edge) en AirPlay (Safari) met uitleg als het niet lukt.
Actie Server bijwerken en een nieuwe app-versie bouwen.
Eerste versie 5 oktober 2026
Website met live tv, films, series, zoeken, Mijn lijst en Verder kijken; meerdere gebruikers.
Eigen Android-app voor tv en telefoon met automatische updates.
Installatie met Portainer of het installatiescript.
Dispatcharr toevoegen aan een bestaande installatie
Dispatcharr zit tussen je provider(s) en
deze dienst. Handig als je meerdere abonnementen combineert, zenders zelf wilt ordenen of een betere programmagids wilt.
Draait Dispatcharr al ergens in je netwerk? Sla dan stap 1 over.
Dispatcharr starten. Portainer: werk de stack bij naar de actuele portainer-stack.yml,
haal de # weg bij het blok dispatcharr én bij dispatcharr_data onderaan, en klik
Update the stack. Installatiescript: zet in docker/.env bij COMPOSE_PROFILES het woord dispatcharr
(met een komma als er al iets staat, bijv. 'https,dispatcharr') en voer docker compose up -d uit.
Dispatcharr instellen op http://<server>:9191: voeg je provider toe (M3U of Xtream), kies je zenders en
EPG, en maak onder Users een gebruiker aan met een XC-wachtwoord.
Koppelen: in deze dienst Instellingen → IPTV-bron → Dispatcharr. Server-URL http://dispatcharr:9191
(in dezelfde stack) of http://<ip>:9191, plus de gebruiker en het XC-wachtwoord. Klik Opslaan en verbinding testen.
Aantal streams invullen onder Geavanceerd → Max. gelijktijdige streams: het aantal streams dat Dispatcharr van je
provider(s) mag gebruiken.
Let op: de variabelen IPTV_* worden alleen gebruikt bij de allereerste start. Bij een bestaande
installatie stel je de bron altijd in via Instellingen → IPTV-bron.
Problemen na bijwerken
Probleem
Oplossing
Website ziet er nog oud uit
Pagina vernieuwen met Ctrl+F5 (Mac: Cmd+Shift+R)
App zegt Update vereist maar werkt niet bij
Bouw een nieuwe app-versie (Instellingen → Android TV-app) en sta installeren toe op de tv-box
App bouwen mislukt: Failed to find target … android-35
Herstart de container apk-builder; hij installeert de ontbrekende onderdelen opnieuw. Probeer daarna opnieuw te bouwen
App blijft op het startscherm
Kijk in Instellingen → Android TV-app welk adres de app opent en open dat in een browser op de tv-box. Werkt het niet: PUBLIC_URL aanpassen, container herstarten, nieuwe app-versie bouwen en opnieuw installeren
Container start niet
docker compose logs app of de logs in Portainer; staat er Download mislukt, dan draait de vorige versie gewoon door
Zenders van Dispatcharr starten niet
Controleer of de Dispatcharr-gebruiker toegang heeft tot de zendergroepen en of het XC-wachtwoord klopt
Opname pauzeert steeds
Alle verbindingen zijn in gebruik door kijkers. Verhoog Max. gelijktijdige streams als je abonnement meer toestaat