@homebridge-plugins/homebridge-tado 8.7.8 → 8.8.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## v8.8.1 - 2026-02-14
+- Update dependencies
+- Update qs due to vulnerability
+- Update eslint and drop obsolete dev dependencies
+
+## v8.8.0 - 2026-01-31
+- Add `addJitter` option to introduce a ±10% random variation in the polling interval
+- Add `nightPolling` option to optionally use a longer interval overnight, lowering polling activity between 00:00–06:00
+- Change: Schedule the next polling cycle after the previous poll completes, using the configured interval
+- Change: Set timeout for tado api requests to 15 seconds
+- Update dependencies
+
 ## v8.7.8 - 2026-01-13
 - Fix: Match zones by name and type when updating zone states (#192)
 - Add more debug logs for accessory state updates

package/README.md

@@ -38,6 +38,7 @@ After [Homebridge](https://github.com/nfarina/homebridge) has been installed:
 - [Configuration](#configuration)
   - [Authentication](#authentication)
     - [Custom API Configuration](#custom-api-configuration)
+  - [Polling Behavior Configuration](#polling-behavior-configuration)
   - [Thermostat](#thermostat)
     - [Open Window](#open-window)
   - [Air Conditioning](#air-conditioning)
@@ -124,6 +125,14 @@ Additionally, it is possible to disable the built-in authentication flow entirel
 For further details and configuration examples, refer to the related discussion:  
 [homebridge-tado issue #176 – Authentication Options](https://github.com/homebridge-plugins/homebridge-tado/issues/176#issuecomment-3419839118)
 
+## Polling Behavior Configuration
+
+To better control API usage and reduce unnecessary load, the plugin provides additional polling-related options:
+
+When `addJitter` is enabled, a random ±10% jitter is applied to the polling interval.
+
+The setting `nightPolling` optionally defines a longer polling interval during nighttime hours (00:00–06:00, local time). This reduces overnight API activity while maintaining normal polling behavior during the day.
+
 ## Thermostat
 
 Each zone in the config.json with ``"type": "HEATING"`` and ``"easyMode": false`` is exposed to Apple Home as a thermostat accessory with the following features:

package/config.schema.json

@@ -51,6 +51,11 @@
               "type": "boolean",
               "description": "Optional: Skip authentication for tado API."
             },
+            "addJitter": {
+              "title": "Add Jitter",
+              "type": "boolean",
+              "description": "Optional: Add a ±10% random variation in the polling interval."
+            },
             "polling": {
               "title": "Polling",
               "description": "The polling interval in seconds (recommended value: 300).",
@@ -58,6 +63,13 @@
               "default": 300,
               "minimum": 30
             },
+            "nightPolling": {
+              "title": "Night Polling",
+              "description": "Optional: The polling interval in seconds used during night between 00:00 - 06:00.",
+              "type": "integer",
+              "default": 300,
+              "minimum": 30
+            },
             "temperatureUnit": {
               "title": "Temperature Unit",
               "description": "Temperature Unit for accessories in Apple Home exposed by this plugin.",
@@ -595,6 +607,7 @@
       "items": [
         "homes[].name",
         "homes[].polling",
+        "homes[].nightPolling",
         "homes[].temperatureUnit",
         {
           "key": "homes[]",
@@ -607,6 +620,7 @@
             "homes[].id",
             "homes[].tadoApiUrl",
             "homes[].skipAuth",
+            "homes[].addJitter",
             "homes[].username"
           ]
         },

package/homebridge-ui/public/js/main.js

@@ -1107,7 +1107,9 @@ async function fetchDevices(auth, refresh, resync) {
             username: foundHome.username,
             tadoApiUrl: foundHome.tadoApiUrl,
             skipAuth: foundHome.skipAuth,
+            addJitter: false,
             polling: 300,
+            nightPolling: 300,
             zones: [],
             presence: {
               anyone: false,
@@ -1265,7 +1267,9 @@ async function fetchDevices(auth, refresh, resync) {
             username: auth.username,
             tadoApiUrl: auth.tadoApiUrl,
             skipAuth: auth.skipAuth,
+            addJitter: false,
             polling: 300,
+            nightPolling: 300,
             zones: [],
             presence: {
               anyone: false,
@@ -1435,6 +1439,7 @@ async function fetchDevices(auth, refresh, resync) {
   try {
 
     //check version before load ui
+    //eslint-disable-next-line no-undef
     if (window.homebridge.serverEnv.env && window.compareVersions(window.homebridge.serverEnv.env.packageVersion, '4.34.0') < 0) {
       await showOldSchema(true);
       return;

package/homebridge-ui/public/js/schema.js

@@ -44,6 +44,11 @@ const schema = {
           'type': 'boolean',
           'description': 'Optional: Skip authentication for tado API.'
         },
+        'addJitter': {
+          'title': 'Add Jitter',
+          'type': 'boolean',
+          'description': 'Optional: Add a ±10% random variation in the polling interval.'
+        },
         'polling': {
           'title': 'Polling',
           'description': 'The polling interval in seconds (recommended value: 300).',
@@ -51,6 +56,13 @@ const schema = {
           'default': 300,
           'minimum': 30
         },
+        'nightPolling': {
+          'title': 'Night Polling',
+          'description': 'Optional: The polling interval in seconds used during night between 00:00 - 06:00.',
+          'type': 'integer',
+          'default': 300,
+          'minimum': 30
+        },
         'temperatureUnit': {
           'title': 'Temperature Unit',
           'description': 'Temperature Unit for accessories in Apple Home exposed by this plugin.',
@@ -580,6 +592,7 @@ const schema = {
     'preferSiriTemperature',
     'homes.name',
     'homes.polling',
+    'homes.nightPolling',
     'homes.temperatureUnit',
     {
       'key': 'homes',
@@ -592,6 +605,7 @@ const schema = {
         'homes.id',
         'homes.tadoApiUrl',
         'homes.skipAuth',
+        'homes.addJitter',
         'homes.username'
       ]
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homebridge-plugins/homebridge-tado",
-  "version": "8.7.8",
+  "version": "8.8.1",
   "description": "Homebridge plugin for controlling tado° devices.",
   "main": "index.js",
   "scripts": {
@@ -33,7 +33,7 @@
     "homebridge": "^1.6.0||^2.0.0-beta.0"
   },
   "dependencies": {
-    "@homebridge/plugin-ui-utils": "^2.1.2",
+    "@homebridge/plugin-ui-utils": "^2.2.0",
     "fakegato-history": "^0.6.7",
     "form-data": "^4.0.5",
     "fs-extra": "^11.3.3",
@@ -41,15 +41,9 @@
     "moment": "^2.30.1"
   },
   "devDependencies": {
-    "@babel/core": "7.28.6",
-    "@babel/eslint-parser": "7.28.6",
-    "@babel/eslint-plugin": "7.27.1",
-    "@eslint/js": "^9.39.2",
-    "eslint": "^9.39.2",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-prettier": "^5.5.4",
-    "globals": "^17.0.0",
-    "prettier": "^3.7.4"
+    "eslint": "^10.0.0",
+    "@eslint/js": "^10.0.1",
+    "globals": "^17.3.0",
+    "prettier": "^3.8.1"
   }
 }

package/src/accessories/lightsensor.js

@@ -27,6 +27,7 @@ export default class SolarLightsensorAccessory {
 
     if (!service) {
       Logger.info('Adding LightSensor service', this.accessory.displayName);
+      // eslint-disable-next-line no-useless-assignment
       service = this.accessory.addService(
         this.api.hap.Service.LightSensor,
         this.accessory.displayName,
@@ -34,4 +35,4 @@ export default class SolarLightsensorAccessory {
       );
     }
   }
-}
+}

package/src/helper/handler.js

@@ -13,7 +13,6 @@ export default (api, accessories, config, tado, telegram) => {
     helpers[config.homeId] = {
       activeSettingStateRuns: {},
       tasksInitialized: false,
-      lastGetStates: 0,
       lastPersistZoneStates: 0,
       persistPromise: Promise.resolve(),
       updateZonesRunning: false,
@@ -21,6 +20,8 @@ export default (api, accessories, config, tado, telegram) => {
       delayTimer: {},
       refreshHistoryHandlers: [],
       statesIntervalTime: Math.max(config.polling, 30) * 1000,
+      statesIntervalTimeNight: config.nightPolling ? Math.max(config.nightPolling, config.polling, 30) * 1000 : undefined,
+      nextPollingTime: 0,
       storagePath: api.user.storagePath(),
     }
   }
@@ -568,9 +569,7 @@ export default (api, accessories, config, tado, telegram) => {
     } finally {
       delete helpers[config.homeId].activeSettingStateRuns[runId];
       //update zones to ensure correct state in Apple Home
-      const timeSinceLastGetStates = helpers[config.homeId].lastGetStates === 0 ? 0 : (Date.now() - helpers[config.homeId].lastGetStates);
-      const statesIntervalTimeLeft = helpers[config.homeId].statesIntervalTime - timeSinceLastGetStates;
-      if (!settingStates() && zoneUpdated && statesIntervalTimeLeft > (10 * 1000)) await updateZones();
+      if (!settingStates() && zoneUpdated && _getTimeUntilNextPolling() > (10 * 1000)) await updateZones();
     }
   }
 
@@ -761,16 +760,42 @@ export default (api, accessories, config, tado, telegram) => {
     }
   }
 
+  function _getTimeUntilNextPolling() {
+    return Math.max(0, (helpers[config.homeId].nextPollingTime ?? 0) - Date.now());
+  }
+
+  function _getPollingInterval() {
+    const hour = helpers[config.homeId].statesIntervalTimeNight ? new Date().getHours() : undefined;
+    let interval;
+    if (helpers[config.homeId].statesIntervalTimeNight && hour >= 0 && hour < 6) {
+      interval = helpers[config.homeId].statesIntervalTimeNight;
+    } else {
+      interval = helpers[config.homeId].statesIntervalTime;
+    }
+    const addJitter = config.addJitter?.toString() === "true";
+    if (!addJitter) return interval;
+    //use 10 percent jitter
+    const jitter = interval * 0.1;
+    const randomOffset = Math.round((Math.random() * 2 - 1) * jitter);
+    return interval + randomOffset;
+  }
+
   function initTasks() {
     if (helpers[config.homeId].tasksInitialized) return;
     helpers[config.homeId].tasksInitialized = true;
-
-    void getStates();
-    setInterval(() => void getStates(), helpers[config.homeId].statesIntervalTime);
+    async function poll() {
+      try {
+        await getStates();
+      } finally {
+        const interval = _getPollingInterval();
+        helpers[config.homeId].nextPollingTime = Date.now() + interval;
+        setTimeout(poll, interval);
+      }
+    }
+    void poll();
   }
 
   async function getStates() {
-    helpers[config.homeId].lastGetStates = Date.now();
     try {
       //ME
       if (!config.homeId) await updateMe();

package/src/tado/tado-api.js

@@ -258,13 +258,15 @@ export default class Tado {
     const access_token = this.skipAuth ? undefined : await this.getToken();
     const url = `${tado_url_dif || this.tadoApiUrl}${path}`;
 
-    const config = {
+    const options = {
       method,
       responseType: 'json',
       headers: access_token ?
         { Authorization: `Bearer ${access_token}` } :
         undefined,
-      timeout: { request: 30000 },
+      timeout: {
+        request: 15000
+      },
       retry: {
         limit: 2,
         statusCodes: [408, 429, 503, 504],
@@ -272,12 +274,12 @@ export default class Tado {
       },
     };
 
-    // Only add data to config for non-GET methods and when data has content
+    //only add data to options for non-GET methods and when data has content
     if (data && typeof data === 'object' && Object.keys(data).length > 0 && method !== 'GET') {
-      config.json = data;
+      options.json = data;
     }
 
-    if (Object.keys(params).length) config.searchParams = params;
+    if (Object.keys(params).length) options.searchParams = params;
 
     Logger.debug('API request start', {
       name: this.name,
@@ -288,7 +290,7 @@ export default class Tado {
     });
 
     try {
-      const response = await got(url, config);
+      const response = await got(url, options);
       await this._increaseCounter();
       Logger.debug('API request success', {
         name: this.name,

package/src/tado/tado-config.js

@@ -42,7 +42,9 @@ export default {
             username: auth.username,
             tadoApiUrl: auth.tadoApiUrl,
             skipAuth: auth.skipAuth,
+            addJitter: false,
             polling: 300,
+            nightPolling: 300,
             zones: [],
             presence: {
               anyone: false,
@@ -513,6 +515,7 @@ export default {
             username: home.username,
             tadoApiUrl: home.tadoApiUrl,
             skipAuth: home.skipAuth,
+            addJitter: home.addJitter,
             temperatureUnit: home.temperatureUnit || 'CELSIUS',
             geolocation: home.geolocation,
             tado: tado,
@@ -527,7 +530,8 @@ export default {
               home.extras && home.extras.childLockSwitches
                 ? home.extras.childLockSwitches.filter((childLockSwitch) => childLockSwitch && childLockSwitch.active)
                 : [],
-            polling: Number.isInteger(home.polling) ? (home.polling < 30 ? 30 : home.polling) : 300,
+            polling: Number.isInteger(home.polling) ? Math.max(home.polling, 30) : 300,
+            nightPolling: home.nightPolling && Number.isInteger(home.nightPolling) ? Math.max(home.nightPolling, home.polling, 30) : undefined
           };
 
           if (home.zones && home.zones.length) {