Update — v0.0.28 als App Store-testversie
14-11-2026
De Ziggo Next-integratie is beschikbaar als experimentele testversie via:
De certificeringsaanvraag bij Athom loopt nog. De app vereist Homey Pro met Homey 10 of nieuwer, internet en een Ziggo Nederland-account met precies één toegewezen Mediabox.
Geteste modellen
Mijn eigen praktijktests met v0.0.28 zijn uitgevoerd op een Ziggo Next Mini. Daarnaast wordt bevestigd dat op een Ziggo Next met v0.0.23 (de cli versie van versie de app v0.028) aan/uitbediening, statusupdates via de afstandsbediening, zenderkeuze en navigatie goed werken; met dank aan Fred. Hij meldt ook stabiel dagelijks gebruik zonder opnieuw aanmelden of herstarten. De v0.0.28 (app versie) is op de gewone Next nog niet afzonderlijk bevestigd maar verwacht ook daar geen problemen.
Installeren en aanmelden
Na installatie voeg je de box apart toe via Apparaten → apparaat toevoegen → Ziggo Next → Ziggo Next Mini → Verbinden. Daar meld je je bij Ziggo aan. Dit kan volledig in je eigen Homey-app of webapp. Schakel de box daarna één keer met de Ziggo-afstandsbediening en wacht totdat Homey de live status volgt.
Overstappen vanaf de CLI-versie
De App Store-testversie gebruikt dezelfde app-ID als de CLI-versie en is dus geen tweede, parallelle installatie. Werkt jouw huidige versie goed, dan hoef je niet over te stappen.
Een schone overstap door verwijderen en opnieuw installeren is inmiddels op mijn Homey getest. Opnieuw aanmelden en koppelen was nodig. De Mini kreeg een nieuwe apparaat-ID, waardoor ik tien Ziggo-kaartverwijzingen die ik in vier Flows heb staan opnieuw moesten worden gekoppeld. Daarna werkten aan/uit, televisie volgen via de bestaande Flows en automatische zenderkeuze.
Dit is één geslaagde praktijktest, geen garantie voor iedere installatie. Rechtstreeks vervangen van de CLI-versie door de Store-versie met automatisch behoud van apparaat, instellingen en Flow-verwijzingen heb ik niet getest. Verwijder je bestaande CLI installatie daarom niet zomaar voor de APP zonder dat je weet dat je de bestaande (CLI) kaarten na installatie van de APP moet vervangen.
Ervaringen zijn welkom in dit topic. Vermeld bij problemen je appversie, Homey-versie, Mediabox-model en foutmelding. Onderzoek problemen eerst voordat je opnieuw installeert of apparaten verwijdert. Deel geen inloggegevens of ongeschoonde logs.
De oudere GitHub-informatie hieronder beschrijft de eerdere handmatige releases.
Ziggo Next / Next Mini voor Homey Pro
Met deze community-app kun je een Ziggo Mediabox Next of Next Mini rechtstreeks vanuit Homey Pro bedienen. Homey communiceert met de Ziggo-diensten. Een internetverbinding is vereist; Home Assistant, Homebridge of een andere bridge is niet nodig.
Ik heb deze app voor privégebruik ontwikkeld en deel de broncode met andere Homey-gebruikers die ermee willen experimenteren.
In dit eerste bericht houd ik de actuele versie, installatie-informatie, bekende problemen en wijzigingen bij. Vragen en ervaringen zijn welkom in de reacties hieronder.
Actuele stand — bijgewerkt op 7 november 2026
-
Beschikbaar op GitHub: v0.0.26, als prerelease.
-
Praktijktest: geïnstalleerd op mijn Homey Pro met een Ziggo Next Mini.
-
Basisbediening: aan- en uitschakelen vanuit Homey werkt. Homey volgt ook het aan- en uitschakelen met de fysieke Ziggo-afstandsbediening.
-
Duurtest: de langere test van v0.0.26 loopt nog.
-
Installatie: handmatig via de Homey CLI.
-
Homey App Store: deze community-app staat daar momenteel niet in.
Broncode en installatiehandleiding v0.0.26
De voorafgaande lokale versie v0.0.25 heeft bij mij ongeveer een week stabiel gedraaid. v0.0.26 bouwt daarop voort en voegt vooral betere MQTT-diagnostiek toe. De geslaagde eerste controles geven vertrouwen, maar bewijzen nog geen langdurige stabiliteit. Daarom is v0.0.26 als prerelease gepubliceerd.
Wat kan de app?
-
De mediabox aan- en in standby schakelen vanuit Homey.
-
De aan/uitstatus van de mediabox in Homey bijwerken.
-
Statuswijzigingen door de fysieke Ziggo-afstandsbediening volgen zolang de statusverbinding werkt.
-
Zender omhoog en omlaag.
-
Rechtstreeks naar een zender schakelen via een Homey Flow.
-
Cijfertoetsen 0–9 versturen.
-
OK, Terug en navigatietoetsen bedienen.
-
Automatisch de Ziggo-sessie vernieuwen.
-
Automatisch proberen de MQTT-statusverbinding te herstellen.
-
Opnieuw aanmelden via Repareren, zonder het bestaande Homey-apparaat te verwijderen.
-
Verbindingsgebeurtenissen bewaren voor latere analyse.
Let op: na opstarten, Repareren of verbindingsverlies kan de aan/uitbediening wachten op een actuele live status van Ziggo. Een eerder opgeslagen statusbericht is daarvoor niet voldoende. Hiermee voorkomt de app dat een onzekere beginstatus tot een ongewenste Power-opdracht leidt.
De app volgt de status van de mediabox. Hij stelt niet zelfstandig vast of een aangesloten televisie of receiver daadwerkelijk aanstaat.
Nieuw in v0.0.26: MQTT-gebeurtenisgeschiedenis
Naast het bestaande diagnoselog van maximaal 250 regels is er nu een afzonderlijke geschiedenis van maximaal 50 MQTT-verbindingsgebeurtenissen.
Daarin worden onder meer vastgelegd:
-
Start van de statusmonitor.
-
Verbinden en reconnectpogingen.
-
Het aanvragen en gereedkomen van de status-subscription.
-
Afzonderlijke meldingen voor
offline,errorenclose. -
Verbindingsverlies en daaropvolgend herstel.
Elke gebeurtenis bevat een UTC-tijdstempel en gegevens waarmee opeenvolgende verbindingspogingen kunnen worden onderscheiden. Een willekeurige run-identificatie maakt zichtbaar welke gebeurtenissen bij dezelfde app-start horen.
Bekijken en kopiëren
De geschiedenis staat in de app-instellingen. Je kunt deze verversen, bekijken en als JSON kopiëren. Wanneer automatisch kopiëren niet beschikbaar is, kun je de tekst handmatig selecteren en kopiëren.
Bewaren en wissen
-
De geschiedenis blijft behouden na een app-herstart.
-
Nieuwe gebeurtenissen vervangen de oudste zodra de grens van 50 is bereikt.
-
De grens geldt voor alle gekoppelde apparaten samen.
-
Er is geen automatische vervaldatum in dagen.
-
Diagnose wissen wist deze afzonderlijke MQTT-geschiedenis niet.
-
Er is geen aparte MQTT-wisknop toegevoegd.
Bij veel herhaalde storingen kan de geschiedenis sneller vollopen. Vijftig gebeurtenissen garanderen dus geen volledige nachtdekking. Bij een crash of opslagfout kunnen recente gebeurtenissen ontbreken.
Ready of connection.restored betekent dat de status-subscription gereed is. Dat is nog geen bevestiging dat er ook al een actuele live aan/uitstatus is ontvangen.
Privacy
Deze MQTT-geschiedenis bewaart geen tokens, cookies, wachtwoorden, account- of apparaat-ID’s, MQTT-topics, berichtinhoud of ruwe foutteksten.
Controleer diagnosegegevens en schermafbeeldingen altijd voordat je ze openbaar deelt.
Compatibiliteit
Mijn eigen praktijktests vinden plaats met:
-
Homey Pro.
-
Ziggo Nederland.
-
Ziggo Mediabox Next Mini.
De app vereist Homey-software 10.0.0 of nieuwer.
In dit topic is ook een werkende installatie met een Ziggo Next gemeld. Andere modellen en accountconfiguraties zijn niet uitgebreid getest.
De huidige aanmeldprocedure verwacht precies één toegewezen mediabox op het Ziggo-account.
Installeren en bijwerken
De volledige installatiehandleiding staat op GitHub:
Open de installatiehandleiding voor v0.0.26
Lees deze eerst. De handleiding beschrijft de benodigde software, de Homey CLI-commando’s en aandachtspunten voor Windows PowerShell.
Nieuwe installatie
Na installatie voeg je de mediabox als apparaat toe in Homey en meld je je aan met je Ziggo-account.
Het Ziggo-wachtwoord wordt gebruikt voor het aanmelden en wordt niet door de app opgeslagen. De sessiegegevens die nodig zijn om de verbinding te onderhouden, worden wel in de Homey-apparaatopslag bewaard.
Bestaande installatie bijwerken
Verwijder het bestaande Homey-apparaat niet alleen om de app bij te werken.
Bij mijn upgrade naar v0.0.26 zijn het bestaande apparaat en de instellingen behouden. De apparaat-ID, capabilities en Flow-definities zijn niet gewijzigd.
Opnieuw aanmelden via Repareren is niet standaard nodig voor deze upgrade. Het kan wel nodig zijn wanneer Ziggo de sessie ongeldig maakt of wanneer de opgeslagen sessiegegevens niet veilig kunnen worden gebruikt.
Aandachtspunt bij installatieproblemen
In de onderzochte Homey CLI-versies is een uploadprobleem gereproduceerd: na een autorisatiefout kan een automatische uploadherhaling mislukken met bijvoorbeeld Missing File.
Een nieuwere CLI installeren bleek op zichzelf geen bewezen oplossing. Controleer na een mislukte upload welke appversie daadwerkelijk op Homey staat en wat de foutmelding is. Herhaal de installatie niet blind en beschouw alleen een afsluitcode niet als bewijs dat de installatie is geslaagd.
Meer informatie staat in de README op GitHub.
Bekende problemen en tijdelijke oplossingen
Aan/uitbediening wacht na opstarten, Repareren of reconnect
De app kan verbonden zijn terwijl er nog geen actuele live status van de mediabox is ontvangen. Aan/uitbediening vanuit Homey kan dan wachten of eindigen met bijvoorbeeld:
Timeout after 10000 ms
Dit is eerder bij v0.0.23 waargenomen na Repareren. De bescherming die een actuele beginstatus vereist, blijft ook in v0.0.26 aanwezig.
Deze stappen herstelden de bediening in mijn installatie:
-
Zet de Mini aan met de fysieke Ziggo-afstandsbediening.
-
Wacht totdat het apparaat in Homey AAN aangeeft.
-
Probeer daarna de Mini via Homey uit en weer aan te zetten.
Dit helpt wanneer een actuele beginstatus ontbreekt. Het is geen algemene oplossing voor authenticatie- of netwerkproblemen.
Automatische sessievernieuwing
Bij v0.0.23 heb ik een situatie gezien waarin opnieuw aanmelden nodig was. De oorspronkelijke oorzaak is niet volledig vastgesteld.
De lokaal ontwikkelde verbeteringen uit v0.0.24 en v0.0.25 zijn opgenomen in de gepubliceerde v0.0.26. Ze richten zich onder meer op:
-
Samenhangende opslag van vernieuwde tokens en cookies.
-
Het delen van gelijktijdige authenticatieverzoeken.
-
Gecontroleerd herstel na tijdelijke fouten.
-
Het voorkomen van onveilige herhaling bij een onzekere sessievernieuwing.
-
Correcte verwerking van bestaande sessiegegevens.
Mijn v0.0.25-installatie heeft ongeveer een week stabiel gedraaid. Of v0.0.26 langdurig dezelfde stabiliteit behoudt, moet de lopende duurtest uitwijzen.
Gewiste diagnoseregels kunnen terugkomen
Het gewone diagnoselog heeft nog een bekende beperking: gewiste regels kunnen opnieuw verschijnen wanneer de app een nieuwe diagnoseregel opslaat.
Dit staat los van de nieuwe MQTT-gebeurtenisgeschiedenis.
Teruggaan naar een oudere versie
Oudere versies blijven op GitHub beschikbaar. Teruggaan naar v0.0.23 kan opnieuw aanmelden via Repareren vereisen, omdat die versie de nieuwere sessieopslag niet gebruikt. Ook opnieuw upgraden kan daarna Repareren vereisen.
Een probleemloze terugkeer naar iedere oudere versie is niet gegarandeerd.
Ontwikkeling en wijzigingsgeschiedenis
Nieuwste informatie staat bovenaan.
7 november 2026 — v0.0.26 beschikbaar als prerelease
v0.0.26 is gepubliceerd en op mijn Homey Pro geïnstalleerd.
Belangrijkste toevoeging is de afzonderlijke, blijvend opgeslagen MQTT-gebeurtenisgeschiedenis van maximaal 50 gebeurtenissen. De verbeteringen aan authenticatie en sessieopslag uit de lokale v0.0.24- en v0.0.25-ontwikkeling zijn eveneens opgenomen.
Uitgevoerde controles:
-
Alle 152 geautomatiseerde lokale tests slagen.
-
De lokale Homey-validatie slaagt.
-
Het bestaande Homey-apparaat is bij de upgrade behouden.
-
De MQTT-statusverbinding wordt opgebouwd en de subscription komt gereed.
-
Na een echte app-herstart blijven de eerdere MQTT-gebeurtenissen behouden.
-
Homey volgt zowel aan- als uitschakelen met de fysieke Ziggo-afstandsbediening.
-
Aan- en uitschakelen vanuit Homey werkt in mijn installatie.
De langere duurtest en het beoordelen van nachtelijke reconnects lopen nog.
Release notes en download v0.0.26
30 oktober 2026 — v0.0.25 in lokale praktijktest
Deze versie richtte zich op authenticatie, automatische sessievernieuwing, betrouwbare opslag van sessiegegevens en een correctie bij het overzetten van bestaande authenticatiegegevens.
v0.0.25 is niet afzonderlijk gepubliceerd. De verbeteringen zijn opgenomen in v0.0.26.
30 oktober 2026 — tijdelijke oplossing na Repareren
Bij v0.0.23 kon de aan/uitbediening na Repareren blijven wachten op een actuele status. Eenmalig inschakelen met de fysieke Ziggo-afstandsbediening herstelde dit in mijn installatie.
De stappen staan hierboven bij de bekende problemen.
23 oktober 2026 — v0.0.23 beschikbaar
Deze versie introduceerde onder meer:
-
Centrale afhandeling van Power-opdrachten.
-
Bescherming tegen dubbele Power-opdrachten bij gelijktijdige verzoeken.
-
Betere verwerking van statusmeldingen bij opstarten en verbindingsherstel.
-
Geen automatische herhaling van een Power-opdracht waarvan de uitvoering onzeker is.
-
Uitgebreidere diagnose-informatie.
-
Een kleiner installatiepakket door ontwikkelgereedschappen buiten de productieafhankelijkheden te houden.
18 oktober 2026 — installatiehandleiding uitgebreid
De installatiehandleiding is uitgebreid naar aanleiding van gebruikerservaringen, onder meer met uitleg over de benodigde software en aandachtspunten voor Windows PowerShell.
Eerdere versie — v0.0.22
Deze versie blijft beschikbaar als eerdere broncodereferentie.
Achtergrond en toekomst
Dit is een hobbyproject, ontstaan vanuit mijn eigen wens om de Ziggo Next Mini via Homey te bedienen. Ik ben geen professionele appontwikkelaar. Met hulp van AI, experimenteren en testen heb ik deze integratie ontwikkeld.
Ik heb Athom op het project gewezen. Daarmee is geen samenwerking, overname of officiële publicatie toegezegd.
Ervaren ontwikkelaars zijn welkom om de broncode te bekijken, verbeteringen voor te stellen of aan de verdere ontwikkeling bij te dragen.
Dit is geen officiële Ziggo- of Athom-app. Mijn tijd is beperkt. Ik bied geen persoonlijke ondersteuning en kan toekomstig onderhoud of blijvende compatibiliteit met Ziggo niet garanderen.
Vragen en ervaringen
Ervaringen zijn welkom, ook wanneer alles goed werkt.
Vermeld bij een probleem graag:
-
De appversie.
-
Je Homey-softwareversie.
-
Je Mediabox-model.
-
Welke handeling je uitvoerde.
-
Wat er gebeurde en welke foutmelding je kreeg.
-
Of het probleem ontstond na opstarten, verbindingsverlies of Repareren.
De nieuwe MQTT-geschiedenis kan helpen om verbindingsproblemen achteraf te onderzoeken. Vermeld bij tijdstippen dat deze geschiedenis UTC gebruikt.
Deel geen wachtwoorden, tokens, cookies of andere aanmeldgegevens. Controleer logbestanden en schermafbeeldingen op persoonlijke informatie voordat je ze plaatst.
GitHub — broncode en documentatie
Bedankt voor het testen en meedenken!