homebridge-eosstb 2.4.0-alpha.47 → 2.4.0-beta.2

package/CHANGELOG.md

@@ -4,274 +4,45 @@ All notable changes to this project will be documented in this file.
 See the [Readme file](https://github.com/jsiegenthaler/homebridge-eosstb/blob/master/README.md) for full plugin documentation.
 Please restart Homebridge after every plugin update.
 
-# Bug Fixes and Improvements
 
-## Current To-Do and In-Work List (For Future Releases, in rough order of priority):
+## 2.4.0-beta.2 (2026-05-09)
 
-TODO
-review all http endpoints, make sure a suitable log entry is being made so I can check the data is plausible
+This release focusses on ensuring mqtt long-term stability, and fixes an issue where the channel name was not shown on startup.
 
-configsvc
-authorizationService DONE
-personalizationService DONE
-purchaseService
-recordingService
-linearService
-sessionService
+- Rescheduled nightly channel list refresh to 0000-0400 instead of 0000-0600
+- Added an automatic daily mqtt reconnect at a random time between 0400-0600 to avoid long running mqtt sessions. Only restarts if settop box is turned off
+- Fixed issue where current channel was not displayed on plugin startup
 
-IMPORTANR
-Implement setTargetMediaState to send the Play/Pause/Stop functions, so that Eve can control the media state. Watch out for sending commands twice when using the remote control. maybe the sendKey redirects to the setmediaState?
 
-Behavious: SetMediaState from 0 to 1 will start playing.
-Behavious: SetMediaState from 0 to 1 will start playing.
-Behavious: SetMediaState from 2 to 1 will start playing.
-Behavious: SetMediaState from 1 to 2 will start playing.
-unreliable, compare to webclient... this is driving me crazy!
-might have to revert to sendKeys to set Play and Stop/Pause
+## 2.4.0-beta.1 (2026-05-09)
 
+This release represents a major rewrite of the plugin, significantly improving robustness, HAP compliance, and code quality throughout, and making it work for Switzerland.
 
+- Added CH login support: Adapted the login sequence and updated config.schema.json to support the new Switzerland login method
+- Overhauled HAP compliance: Full audit and rewrite of all HAP code for strict compliance
+- Added support for Homebridge v2: Plugin now fully supports Homebridge 2.0.0+ and Node.js 24+; resolved breaking changes introduced by HAP-NodeJS v1 shipped with Homebridge v2
+- Improved MQTT handling: Optimised mqtt code and added clean unsubscribe on plugin shutdown
+- Improved channel list management: Master channel list refresh now runs once daily at a random time between 00:00–06:00
+- Updated channel ConfiguredName to read-only
+- Optimised handling of remote control and media control
+- Improved robustness and startup
+- Improved overall code quality
+- Updated dependencies to current versions
 
-CHECK
-make sendKey logging consistent
+## 2.3.9 (2026-05-09)
 
-CHECK
-what are my issues with persistence?
-Persisting the input state visibility between restarts would be good
-Visibility cannot be set if the user has no WriteAccess to the channel list!!
-Persistance test:
-1. Hide the channel SRF info using Home app
-2. Force-close and reopen  the home app. Confirm channel is still hidden
-3. Confirm the current visibility state in the plugin logs is correct
-3. Restart the plugin
-4. Observe the current visibility state in the plugin logs - does it get the right value from HomeKit HAP? If so, no persistance required.
-
-Device name: this comes from backend
-Channel name: overwrite not allowed - can we disable in HomeKit. Yes, but prevents setting visibility
-
-CHALLENGE
-The mostWatchedChannelList is not working
-
-## 2.4.0-alpha.47 (2026-05-09)
-- Improved the startup default setting of media state when a power-on transition is detected
-
-## 2.4.0-alpha.46 (2026-05-09)
-- Fixed the issue with volume commands
-
-## 2.4.0-alpha.45 (2026-05-09)
-- Added some debugging to the volume commands to trace an issue
-
-## 2.4.0-alpha.44 (2026-05-09)
-- Fixed some log level issues
-- Fixed issue with Remove volumeDown causing Unhandled error thrown inside write handler for characteristic
-
-## 2.4.0-alpha.43 (2026-05-09)
-- Bumped dependency "semver": "^7.8.0",
-
-## 2.4.0-alpha.42 (2026-05-07)
-- changed the name of hidden channels from HIDDEN_xx to HIDDENxx to stop the HAP-NodeJS WARNING: The accessory 'HIDDEN_32' has an invalid 'Name' characteristic 
-
-## 2.4.0-alpha.42 (2026-05-07)
-- changed the name of hidden channels from HIDDEN_xx to HIDDENxx to stop the HAP-NodeJS WARNING: The accessory 'HIDDEN_32' has an invalid 'Name' characteristic 
-
-## 2.4.0-alpha.41 (2026-05-07)
-- fixed typos in this change log
-
-## 2.4.0-alpha.40 (2026-05-07)
-- Changes to code to support HAP-NodeJS still works with Homebridge v1.11.x
-- Reinstated engine "homebridge": "^1.11.4||^2.0.0",
-
-## 2.4.0-alpha.39 (2026-05-07)
-- fixed issues caused by HAP-NodeJS v1 released with Homebridge v2 where use of enums off the Characteristic class is no longer supported
-- due to these HAP-NodeJS changes, support for Homebridge versions below 2.0.0 is no longer provided
-- Bumped engine "homebridge": "^2.0.0",
+- Fixed Error on Homebridge v2: Cannot read properties of undefined (reading 'STRING')
+- Adapted hidden channel name to reduce warning messages with Homebridge v2
+- Updated iOS and Homebridge version references in Readme
+- Bumped engine "^1.11.4||^2.0.0",
 - Bumped engine "node": "^24.15.0"
 - Bumped dependency "axios": "^1.16.0",
 - Bumped dependency "axios-cookiejar-support": "^7.0.0",
 - Bumped dependency "mqtt": "^5.15.1",
-- Bumped dependency "puppeteer-core": "^24.43.0",
 - Bumped dependency "qs": "^6.15.1",
+- Bumped dependency "semver": "^7.8.0",
 - Bumped dependency "tough-cookie": "^6.0.1",
-- Bumped dependency "ws": "^8.20.0"
-
-## 2.4.0-alpha.38 (2026-03-07)
-
-- changes to settargetmediastate & setMediaState
-
-## 2.4.0-alpha.37 (2026-03-07)
-
-- changes to settargetmediastate
-
-## 2.4.0-alpha.36 (2026-03-07)
-
-- changes to settargetmediastate
-
-## 2.4.0-alpha.35 (2026-03-07)
-
-- changes to settargetmediastate
-
-## 2.4.0-alpha.34 (2026-03-07)
-
-- changes to settargetmediastate
-
-## 2.4.0-alpha.33 (2026-03-07)
-
-- optimised getmqtttoken
-- checked function of setTargetMediaState , needs testing, controlled by Eve
-
-## 2.4.0-alpha.32 (2026-03-07)
-
-- made all urls into proper url objects
-- fixed issue with getMostWatchedChannels
-
-## 2.4.0-alpha.31 (2026-03-07)
-
-- change the master channel list refresh to once a day at a random time between 0000 and 0600. The user setting has no impact and can be removed
-- cleaned up some more diagnostic logging
-
-## 2.4.0-alpha.30 (2026-03-07)
-
-- cleaned up some diagnostic logging
-
-## 2.4.0-alpha.29 (2026-03-06)
-
-- optimised refreshDeviceChannelList
-
-## 2.4.0-alpha.28 (2026-03-06)
-
- - fixed issue with detecting status, introduce 2 versions ago
-
-## 2.4.0-alpha.27 (2026-03-06)
-
--- removed test code to detect plugin shutdown
-
-## 2.4.0-alpha.26 (2026-03-06)
-
--- added test code to detect plugin shutdown
-- added clean unsubscribe on plugin shutdown
-
-## 2.4.0-alpha.25 (2026-03-05)
-
- - fixed introduced bug in setRemoteKey
-
-## 2.4.0-alpha.24 (2026-03-05)
-
- - made channel ConfiguredName read only as the backend defines the channel name
-
-## 2.4.0-alpha.23 (2026-03-05)
-
- - optimised setRemoteKey
-
-## 2.4.0-alpha.22 (2026-03-05)
-
- - fixed error handling in refreshMasterChannelList
-
-## 2.4.0-alpha.21 (2026-03-05)
-
- - fixed logging bug in sendKey
-
-## 2.4.0-alpha.20 (2026-03-05)
-
- - improved accessory information display to show a better serialnumber
- - updated set-top box model name for 2008C
- - added more robustness to many calls in case we never get a configsvc response
- - optimised the mqttDeviceStateHandler
- - improved refreshMasterChannelList
- - improved a lot of webservice calls, removing promises and going to try-catch
-
-## 2.4.0-alpha.19 (2026-03-04)
-
- - removed some dead code
- - enabled handler for setClosedCaptions and setPictureMode, test control from Eve app
- - improved send key logging
-
-## 2.4.0-alpha.18 (2026-03-03)
-
-- Fixed dislayOrder crash on startup - check this!
-- Optimised post publishExternalAccessories HAP updates
-- Changed all updateValue to updateCharacteristic post-publish to be more HAP compliant
-
-## 2.4.0-alpha.17 (2026-03-03)
-
-- Cleaned up the platform code
-- Changed all get/set handlers to async
-- Optimised all get/set handlers
-- More HAP minor bug fixes and optimisations
-
-## 2.4.0-alpha.16 (2026-03-03)
-
-- Fixed bug: TypeError: this.prepareinputSourceServices is not a function
-
-## 2.4.0-alpha.15 (2026-03-03)
-
-- Renamed Current Channnel Id and Current Channel Name to Active Channel Id and Active Channel Name for consistency with Active Identifier
-
-## 2.4.0-alpha.14 (2026-03-03)
-
-- Optimised HAP code for strict compliance
-- Removed debug logging
-
-## 2.4.0-alpha.13 (2026-03-03)
-
-- Fixes to logging of getInputName for diagnostics
-
-## 2.4.0-alpha.12 (2026-03-03)
-
-- More improvements to get ConfiguredName working properly on the Eve app (needs testing for both TV and Inputs)
-
-## 2.4.0-alpha.11 (2026-03-03)
-
-- Fixed logging bug in setInputName
-
-## 2.4.0-alpha.10 (2026-03-03)
-
-## 2.4.0-alpha.9 (2026-03-03)
-
-## 2.4.0-alpha.8 (2026-03-03)
-
-- More improvements to get ConfiguredName working properly on the Eve app (needs testing for both TV and Inputs)
-
-## 2.4.0-alpha.7 (2026-03-03)
-
-- Corrected some debug log levels
-- Fixed ConfiguredName being empty on the Eve app (needs testing for both TV and Inputs)
-
-## 2.4.0-alpha.6 (2026-03-02)
-
-- Removed getMute and getVolume, these are not supported
-- More code optimisations
-
-## 2.4.0-alpha.5 (2026-03-02)
-
-- More code performance improvements
-- Improved all HAP code
-
-## 2.4.0-alpha.4 (2026-03-02)
-
-- Fixed self bug in volume control
-
-## 2.4.0-alpha.4 (2026-03-02)
-
-- Fixed self bug in volume control
-
-## 2.4.0-alpha.3 (2026-03-02)
-
-- Fixed new introduced bug with displayed channel being incorrect (offset by 1)
-- Added "devMode": true support to config.json
-
-## 2.4.0-alpha.2 (2026-03-01)
-
-- Improved README.md text
-- Improved config.schema.json description text
-- Improved discovery of devices and accessory setup
-- Improved mqtt handling
-- Improved overall code robustness and fixed many small bugs
-- Fixed spelling mistakes in comments
-
-## 2.4.0-alpha.1 (2026-02-27)
-
-- Adapted login sequence for CH
-- Updated config.schema.json to support new CH login method and improced description texts
-- Bumped dependency "axios": "^1.13.6",
+- Bumped dependency "ws": "^8.20.0"   
 
 ## 2.3.8 (2026-02-27)
 

package/index.js

@@ -357,6 +357,7 @@ class StbPlatform {
     this.masterChannelList = [];
     this.masterChannelListExpiryDate = 0; // epoch = always expired on first run
     this.checkChannelListTimeout = null; // nightly scheduler handler
+    this.mqttReconnecting = false; // nightly reconnect indicator
     this.isDev = config.devMode === true;
     this.debugLevel = this.config.debugLevel || 0; // debugLevel defaults to 0 (minimum)
 
@@ -822,7 +823,7 @@ class StbPlatform {
 
   /**
    * Schedule the next nightly master channel list refresh.
-   * Picks a random time between 00:00 and 06:00 the following day,
+   * Picks a random time between 00:00 and 04:00 the following day,
    * then reschedules itself so the pattern repeats indefinitely.
    *
    * Using setTimeout (not setInterval) means each day gets a fresh
@@ -834,9 +835,9 @@ class StbPlatform {
     tomorrow.setDate(tomorrow.getDate() + 1);
     tomorrow.setHours(0, 0, 0, 0);
 
-    // Add a random offset: anywhere from 0 ms up to (but not including) 6 hours
-    const SIX_HOURS_MS = 6 * 60 * 60 * 1000;
-    const randomOffsetMs = Math.floor(Math.random() * SIX_HOURS_MS);
+    // Add a random offset: anywhere from 0 ms up to (but not including) 4 hours
+    const FOUR_HOURS_MS = 4 * 60 * 60 * 1000;
+    const randomOffsetMs = Math.floor(Math.random() * FOUR_HOURS_MS);
 
     const nextRefreshAt = new Date(tomorrow.getTime() + randomOffsetMs);
     const msUntilRefresh = nextRefreshAt.getTime() - Date.now();
@@ -850,11 +851,121 @@ class StbPlatform {
     // Store the timer handle so shutdown can cancel it
     this.checkChannelListTimeout = setTimeout(async () => {
       if (this.isShuttingDown) return; // bail out if we're going down
+
+      // if an MQTT reconnect is in progress, wait a few minutes before
+      // refreshing to avoid a race condition during session startup
+      if (this.mqttReconnecting) {
+        const THREE_MIN_MS = 3 * 60 * 1000;
+        const retryDelayMs = THREE_MIN_MS + Math.floor(Math.random() * THREE_MIN_MS);
+        this.log.info(
+          'StbPlatform: channel list refresh deferred - MQTT reconnect in progress, retrying in a few minutes',
+        );
+        this.checkChannelListTimeout = setTimeout(async () => {
+          if (this.isShuttingDown) return;
+          await this._refreshChannelList();
+          this._scheduleNightlyChannelListRefresh();
+        }, retryDelayMs);
+        return;
+      }
+
       await this._refreshChannelList();
       this._scheduleNightlyChannelListRefresh(); // reschedule for the next day
     }, msUntilRefresh);
   } // end of _scheduleNightlyChannelListRefresh
 
+  /**
+   * Schedule the next nightly MQTT reconnect.
+   * Picks a random time between 04:00 and 06:00 the following day
+   * to avoid overlapping with the channel list refresh (00:00–04:00).
+   * Reschedules itself so the pattern repeats indefinitely.
+   */
+  _scheduleNightlyMqttReconnect() {
+    const tomorrow = new Date();
+    tomorrow.setDate(tomorrow.getDate() + 1);
+    tomorrow.setHours(4, 0, 0, 0);
+
+    const TWO_HOURS_MS = 2 * 60 * 60 * 1000;
+    const randomOffsetMs = Math.floor(Math.random() * TWO_HOURS_MS);
+
+    const nextReconnectAt = new Date(tomorrow.getTime() + randomOffsetMs);
+    const msUntilReconnect = nextReconnectAt.getTime() - Date.now();
+
+    if (this.debugLevel > 0) {
+      this.log.warn(
+        `StbPlatform: next nightly MQTT reconnect scheduled for ${nextReconnectAt.toLocaleString()}`,
+      );
+    }
+
+    this.mqttReconnectTimeout = setTimeout(async () => {
+      if (this.isShuttingDown) return;
+      await this._attemptNightlyMqttReconnect();
+      // _attemptNightlyMqttReconnect reschedules for the next night once done
+    }, msUntilReconnect);
+  } // end of _scheduleNightlyMqttReconnect
+
+
+  /**
+   * Attempt the nightly MQTT reconnect.
+   * If any STB is currently online (user may be watching), defers by 1 hour
+   * plus a random offset and tries again, rather than interrupting the session.
+   * Once the reconnect completes (or fails), reschedules for the next night.
+   * Retries 3 times then gives up, and the next reconnect will be the next day.
+   */
+  async _attemptNightlyMqttReconnect(retryCount = 0) {
+    if (this.isShuttingDown) return;
+
+    const MAX_RETRIES = 3; // give up after 3 deferrals (~3-4.5 hours past 04:00)
+
+    // check if any STB is currently active - if so, defer to avoid
+    // interrupting a user who may be watching TV and using the remote
+    const anyStbOnline = this.devices.some(
+      (device) => device.currentPowerState === Characteristic.Active.ACTIVE,
+    );
+
+    if (anyStbOnline) {
+      // give up if max retries reached
+      if (retryCount >= MAX_RETRIES) {
+        this.log.info(
+          'StbPlatform: nightly MQTT reconnect skipped - STB still active after max retries, rescheduling for next night',
+        );
+        this._scheduleNightlyMqttReconnect();
+        return;
+      }
+
+      // retry in 1 hour plus a random 0–30 min buffer
+      const ONE_HOUR_MS = 60 * 60 * 1000;
+      const THIRTY_MIN_MS = 30 * 60 * 1000;
+      const retryDelayMs = ONE_HOUR_MS + Math.floor(Math.random() * THIRTY_MIN_MS);
+      const retryAt = new Date(Date.now() + retryDelayMs);
+
+      this.log.info(
+        `StbPlatform: nightly MQTT reconnect deferred - STB is active (attempt ${retryCount + 1}/${MAX_RETRIES}). Retrying at ${retryAt.toLocaleString()}`,
+      );
+
+      // store handle so shutdown can cancel the deferred retry too
+      this.mqttReconnectTimeout = setTimeout(async () => {
+        if (this.isShuttingDown) return;
+        await this._attemptNightlyMqttReconnect(retryCount + 1);
+      }, retryDelayMs);
+      return; // don't reschedule for next night yet - that happens after a successful reconnect
+    }
+
+    // no STB is active - safe to reconnect
+    try {
+      this.mqttReconnecting = true; // signal to channel list refresh to pause
+      this.log.info('StbPlatform: nightly MQTT reconnect starting...');
+      await this.endMqttSession();
+      await this.startMqttClient();
+      this.log.info('StbPlatform: nightly MQTT reconnect completed');
+    } catch (err) {
+      this.log.error('StbPlatform: nightly MQTT reconnect failed:', err.message);
+    } finally {
+      this.mqttReconnecting = false; // always clear the flag, even on failure
+    }
+
+    this._scheduleNightlyMqttReconnect(); // reschedule for next night
+  } // end of _attemptNightlyMqttReconnect
+
   /**
    * _runFullStartupSequence
    *
@@ -4278,12 +4389,8 @@ class StbPlatform {
           // ------ device subscriptions ------
           // subscribe only to what we need
 
-          // turn on our clientId. This is similar to turning on a box, it tells the server we are online
-          // our clientId must be up and running to send commands (power, channel, etc) to the physical device
-          // this.setHgoOnlineRunning(householdId, mqttClientId);
-
           // householdId/mqttClientId: subscribe to own clientId to get data for ourselves
-          // subscribe to all devices after the setHgoOnlineRunning is sent
+          // subscribe to all devices before the setHgoState is sent
           this.mqttSubscribeToTopic(
             householdId + "/" + this.mqttClient.options.clientId,
           ); // subscribe to our own mqttClientId to get all data
@@ -4320,32 +4427,36 @@ class StbPlatform {
           // reset so the 10-second retry fires correctly if the box doesn't respond
           this.lastMqttUiStatusMessageReceived = null;
 
+          // announce ourselves as an active HGO client before requesting UI status
+          // the STB uses this retained presence message to decide which clients to respond to
+          this.setHgoState(householdId, this.mqttClient.options.clientId, 'ONLINE_RUNNING');
+
+          // request initial UI status for each device, with a short delay to allow
+          // the STB to process the HGO presence announcement first
           // CPE.uiStatus messages are received via the householdId and mqttClientId
           // topics which are already subscribed above.
           // getUiStatus is called here to request the initial UI state from each device.
           // retain: false is used (see getUiStatus) so a retry is scheduled in case the box
           // is temporarily unreachable when the initial request is sent.
-          this.devices.forEach((device) => {
-            // request the initial UI status for each device
-            this.getUiStatus(device.deviceId, this.mqttClient.options.clientId);
-
-            // retry getUiStatus after 10 seconds if no CPE.uiStatus response has arrived yet
-            // (handles case where box is briefly offline when the initial request is sent)
-            setTimeout(() => {
-              if (!this.lastMqttUiStatusMessageReceived) {
-                if (this.debugLevel > 0) {
-                  this.log.warn(
-                    "getUiStatus: no CPE.uiStatus received yet for %s, retrying",
-                    device.deviceId,
-                  );
+          setTimeout(() => {
+            this.devices.forEach((device) => {
+              // request the initial UI status for each device
+              this.getUiStatus(device.deviceId, this.mqttClient.options.clientId);
+
+              // retry after 10 seconds if no CPE.uiStatus response has arrived yet
+              setTimeout(() => {
+                if (!this.lastMqttUiStatusMessageReceived) {
+                  if (this.debugLevel > 0) {
+                    this.log.warn(
+                      "getUiStatus: no CPE.uiStatus received yet for %s, retrying",
+                      device.deviceId,
+                    );
+                  }
+                  this.getUiStatus(device.deviceId, this.mqttClient.options.clientId);
                 }
-                this.getUiStatus(
-                  device.deviceId,
-                  this.mqttClient.options.clientId,
-                );
-              }
-            }, 10 * 1000); // 10 second retry delay
-          });
+              }, 10 * 1000); // 10 second retry delay
+            });
+          }, 500); // 500ms for STB to register our HGO presence before we request status
 
           resolve(true); // all subscriptions registered — session is ready
         } catch (err) {
@@ -4462,7 +4573,7 @@ class StbPlatform {
                     currMediaState = Characteristic.CurrentMediaState.PLAY;
                     if (this.debugLevel > 0) {
                       this.log.warn(
-                        "mqttClient: STB status: power-on transition for %s, setting mediaState to PLAY",
+                        "mqttClient: STB status: Power-on transition detected for %s, setting mediaState to PLAY",
                         deviceId,
                       );
                     }
@@ -4496,6 +4607,12 @@ class StbPlatform {
                 this.log.warn("mqttClient: %s %s", deviceId, stbState);
               }
             }
+
+            // After the switch, if box is running, request current UI state
+            //if (stbState === 'ONLINE_RUNNING') {
+              // Small delay gives the STB a moment to settle before responding
+              //setTimeout(() => this.mqttRequestUiStatus(deviceId), 500);
+            //}            
           }
 
           // handle CPE UI status messages for the STB
@@ -4878,16 +4995,26 @@ class StbPlatform {
         return resolve(true);
       }
 
-      // unsubscribe from all subscribedTopics before tearing down the session
+      // get all subscribed topics
       const topics = this.subscribedTopics ?? [];
+
+      // announce HGO offline while the connection is still live, before any teardown
+      this.setHgoState(
+        this.session.householdId,
+        this.mqttClient.options.clientId,
+        'OFFLINE',
+      );
+
+      // unsubscribe from all subscribedTopics before tearing down the session
       if (topics.length === 0) {
         this.log.info(
           "mqttClient: No topics to unsubscribe from, skipping unsubscribe.",
         );
-        this.mqttClient.end(false, {}, (err) => {
-          if (err) {
-            this.log.error("MQTT end error:", err);
-            return reject(err);
+        
+        this.mqttClient.end(false, {}, (endErr) => {
+          if (endErr) {
+            this.log.error("MQTT end error:", endErr);
+            return reject(endErr);
           }
           this.log.info(
             "mqttClient: Disconnected cleanly. No topics found to unsubscribe from.",
@@ -4897,15 +5024,15 @@ class StbPlatform {
         return;
       }
 
-      this.mqttClient.unsubscribe(topics, (err) => {
-        if (err) {
-          this.log.error("MQTT unsubscribe error:", err);
+      this.mqttClient.unsubscribe(topics, (unsubErr) => {
+        if (unsubErr) {
+          this.log.error("MQTT unsubscribe error:", unsubErr);
           // still attempt to end even if unsubscribe failed
         }
-        this.mqttClient.end(false, {}, (err) => {
-          if (err) {
-            this.log.error("MQTT end error:", err);
-            return reject(err);
+        this.mqttClient.end(false, {}, (endErr) => {
+          if (endErr) {
+            this.log.error("MQTT end error:", endErr);
+            return reject(endErr);
           }
           this.log.info(
             "mqttClient: Disconnected cleanly. All topics unsubscribed.",
@@ -4990,7 +5117,7 @@ class StbPlatform {
           "mqttPublishMessage: Publish Message:\r\nTopic: %s\r\nMessage: %s\r\nOptions: %s",
           Topic,
           Message,
-          Options,
+          JSON.stringify(Options),
         );
       }
       this.mqttClient.publish(Topic, Message, Options, (err) => {
@@ -5081,23 +5208,25 @@ class StbPlatform {
     });
   }
 
-  // start the HGO session (switch on)
-  setHgoOnlineRunning(householdId, mqttClientId) {
-    // {"source":"fd29b575-5f2b-49a0-8efe-62a844ac2b40","state":"ONLINE_RUNNING","deviceType":"HGO","mac":"","ipAddress":""}
+  // set the HGO session state (online or offline)
+  // called on mqtt connect (ONLINE_RUNNING) and on mqtt disconnect (OFFLINE)
+  // retain: true ensures the broker overwrites any previous retained state
+  setHgoState(householdId, mqttClientId, state) {
     const topic = `${householdId}/${mqttClientId}/status`;
     const message = JSON.stringify({
       source: mqttClientId,
-      state: "ONLINE_RUNNING",
-      deviceType: "HGO",
-      mac: "",
-      ipAddress: "",
+      state: state,
+      deviceType: 'HGO',
+      mac: '',
+      ipAddress: '',
     });
     if (this.debugLevel > 0) {
-      this.log.warn("setHgoOnlineRunning: publishing to topic:", topic);
+      this.log.warn('setHgoState: publishing %s to topic: %s', state, topic);
     }
     this.mqttPublishMessage(topic, message, { qos: 2, retain: true });
   }
 
+
   // send a channel change request to the settopbox via mqtt
   // using the CPE.pushToTV message
   // the friendlyDeviceName appears on the TV in a popup window
@@ -5151,6 +5280,37 @@ class StbPlatform {
     }
   }
 
+  // Request the current UI status from the STB.
+  // The STB responds with a CPE.uiStatus message on the household channel.
+  // @param {string} deviceId - The STB device ID (e.g. "000378-EOS2STB-00852052xxxx")
+  mqttRequestUiStatus(deviceId) {
+    if (!this.mqttClient?.connected) {
+      this.log.warn('%s: mqttRequestUiStatus: MQTT not connected, skipping', deviceId);
+      return;
+    }
+    if (this.debugLevel > 0) {
+      this.log.warn(
+        "mqttRequestUiStatus: Requesting UI status for %s",
+        deviceId,
+      );
+    }
+
+    const payload = JSON.stringify({
+      version: '1.3.18',
+      type: 'CPE.pullFromTV',
+      source: this.mqttClient.options.clientId,  // your mqttClientId
+      messageTimeStamp: Date.now(),
+    });
+
+    const topic = `${this.session.householdId}/${deviceId}`;
+
+    this.mqttPublishMessage(topic, payload, {
+      qos: 1,
+      retain: false,
+    });
+
+  }  
+
   // set the media state of the settopbox via mqtt
   // media state is controlled by speedRate
   // speedRate can be one of: -64 -30 -6 -2 0 2 6 30 64. 0=Paused, 1=Play, >1=FastForward, <0=Rewind

package/package.json

@@ -3,7 +3,7 @@
   "displayName": "Homebridge EOSSTB",
   "description": "Add your set-top box to Homekit (for Telenet BE, Sunrise CH, UPC SK, Virgin Media GB & IE, Ziggo NL)",
   "author": "Jochen Siegenthaler (https://github.com/jsiegenthaler/)",
-  "version": "2.4.0-alpha.47",
+  "version": "2.4.0-beta.2",
   "platformname": "eosstb",
   "dependencies": {
     "axios": "^1.16.0",