homebridge-tuya-without-developer-account 1.0.2 → 1.0.6

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 1.0.6
+
+- Fixed a Homebridge UI issue where clicking **Save Configuration** could leave the custom settings page spinner running indefinitely even when QR authentication data had already been saved.
+- Added timeout handling around the custom UI save flow.
+- Added post-save verification of the plugin config so users receive a clear success or recovery message instead of a permanent spinner.
+
+
+## 1.0.5
+
+- Added support for DP10 / category `tgq` Tuya dimmer plugs that expose `switch_led` + `bright_value_v2`.
+- Fixed dimmer validation so devices using `bright_value_v2` are exposed as HomeKit Lightbulb accessories with On and Brightness instead of being marked unsupported.
+- Fixed dimmer on/off schema matching so `bright_value_v2` no longer incorrectly searches for `switch_v2` / `switch_led_v2`.
+
+## 1.0.4
+
+- Added a Homebridge settings UI helper for air conditioner temperature overrides.
+- Users can now select a detected Tuya device by name instead of manually finding and pasting the device ID.
+- Added a backend UI endpoint that reads the cached Tuya device list from Homebridge `persist/TuyaDeviceList*.json`.
+- AC-looking devices are listed first when metadata suggests they are air conditioners.
+- The UI writes the correct `deviceOverrides[].id` automatically and saves `airConditioner.minTemperature`, `airConditioner.maxTemperature`, and `airConditioner.temperatureStep`.
+
+## 1.0.3
+
+- Added user-friendly air conditioner temperature limit overrides under `deviceOverrides[].airConditioner`.
+- Allows per-device HomeKit AC setpoint limits such as 16-31 °C or 17-31 °C.
+- Allows `temperatureStep: 1` to suppress 0.5 °C steps in the Home app.
+- Values are always configured in Celsius; Fahrenheit users see the Home app converted values automatically.
+
 ## 1.0.2
 
 - Fixed startup abort when Homebridge UI saves an empty or incomplete `deviceOverrides` row. Invalid override rows without `id` are now skipped with a warning instead of stopping QR cloud startup.

package/README.md

@@ -4,6 +4,9 @@
 
 # Tuya without developer account for Homebridge
 
+Current release: **1.0.6**
+
+
 A Homebridge platform plugin for Tuya and Smart Life devices that uses **Home Assistant-style Tuya QR Cloud Authentication**.
 
 This plugin is designed for users who want to add Tuya / Smart Life devices to HomeKit through Homebridge **without creating a Tuya IoT Developer Platform account** and without entering Tuya cloud project credentials.
@@ -187,8 +190,62 @@ Optional. Use only when a device is discovered with the wrong category or requir
 }
 ```
 
-Use `
-`global` as the override ID to apply an override globally.
+Use `global` as the override ID to apply an override globally.
+
+### Air conditioner temperature limits
+
+Optional. For Wi-Fi AC units, you can limit the Home app setpoint range and step size. Values are always configured in Celsius. If the iPhone/Home app is set to Fahrenheit, HomeKit converts the values automatically.
+
+The preferred method is the Homebridge plugin settings UI:
+
+1. Authenticate and let the plugin discover devices at least once.
+2. Open **Plugins → Tuya without developer account for Homebridge → Settings**.
+3. In **Air Conditioner Temperature Overrides**, click **Load Detected Devices**.
+4. Select the AC device by name, for example **Bedroom AC**.
+5. Enter:
+
+```text
+Min Temperature: 17
+Max Temperature: 31
+Step: 1
+```
+
+6. Click **Add / Update AC Override**.
+7. Click **Save Configuration** and restart Homebridge.
+
+The UI automatically saves the correct Tuya device ID. Users no longer need to manually find and paste the device ID for this AC override.
+
+The saved config looks like this internally:
+
+```json
+{
+  "options": {
+    "userCode": "YOUR_TUYA_USER_CODE",
+    "deviceOverrides": [
+      {
+        "id": "THE_SELECTED_AC_DEVICE_ID",
+        "airConditioner": {
+          "minTemperature": 17,
+          "maxTemperature": 31,
+          "temperatureStep": 1
+        }
+      }
+    ]
+  }
+}
+```
+
+For ACs that support 16 °C minimum, set **Min Temperature** to `16`.
+
+Fahrenheit display examples:
+
+```text
+16 °C ≈ 61 °F
+17 °C ≈ 63 °F
+31 °C ≈ 88 °F
+```
+
+HomeKit stores temperature characteristic metadata in Celsius. Do not enter Fahrenheit values in the plugin config.
 
 ## Troubleshooting
 
@@ -251,3 +308,8 @@ Version 1.0.1 and later persist refreshed Tuya QR tokens back to the Homebridge
 ```
 
 If this still happens after upgrading, open the plugin settings, clear the saved authentication, generate a new QR code, scan it with the Tuya Smart or Smart Life app, save the configuration, and restart Homebridge. Also confirm the Homebridge host clock is synchronized, because Tuya signed requests depend on the current time.
+
+### DP10 Smart Dimmer Plug / `bright_value_v2` dimmers
+
+Version **1.0.5** adds support for DP10-style Tuya dimmer plugs that expose `switch_led` and `bright_value_v2`. These are exposed in HomeKit as Lightbulb accessories with On and Brightness. If the accessory was previously shown as **Not Supported**, remove only that cached accessory in Homebridge UI and restart Homebridge after upgrading.
+

package/SUPPORTED_DEVICES.md

@@ -204,3 +204,13 @@ Most category code is pinyin abbreviation of Chinese name.
 
 
 For the undocumented product category, you can try override it to the most similar one. See [ADVANCED_OPTIONS.md](./ADVANCED_OPTIONS.md).
+
+### DP10 / Treatlife Smart Dimmer Plug
+
+Supported from **v1.0.5**. These devices normally report category `tgq` and expose:
+
+- `switch_led` for On/Off
+- `bright_value_v2` for Brightness
+
+They are exposed to HomeKit as a Lightbulb with On and Brightness. After upgrading from an older version where the device showed as unsupported, remove the affected cached accessory from Homebridge UI and restart Homebridge.
+

package/config.schema.json

@@ -81,6 +81,35 @@
                       }
                     }
                   }
+                },
+                "airConditioner": {
+                  "type": "object",
+                  "title": "Air Conditioner Temperature Limits",
+                  "description": "Optional HomeKit temperature range override for Wi-Fi air conditioners. Values are always Celsius; Home app converts to Fahrenheit automatically for users using \u00b0F.",
+                  "properties": {
+                    "minTemperature": {
+                      "type": "number",
+                      "title": "Minimum temperature (\u00b0C)",
+                      "description": "Lowest setpoint exposed to HomeKit. Common values are 16 or 17. Leave empty to use Tuya schema.",
+                      "minimum": 0,
+                      "maximum": 50
+                    },
+                    "maxTemperature": {
+                      "type": "number",
+                      "title": "Maximum temperature (\u00b0C)",
+                      "description": "Highest setpoint exposed to HomeKit. Common value is 31. Leave empty to use Tuya schema.",
+                      "minimum": 0,
+                      "maximum": 60
+                    },
+                    "temperatureStep": {
+                      "type": "number",
+                      "title": "Temperature step (\u00b0C)",
+                      "description": "Set to 1 to suppress 0.5 \u00b0C steps. Values are Celsius even when Home app displays Fahrenheit.",
+                      "minimum": 0.1,
+                      "maximum": 5,
+                      "default": 1
+                    }
+                  }
                 }
               },
               "required": [

package/dist/platform.js

@@ -95,6 +95,33 @@ class TuyaPlatform {
         continue;
       }
       item.id = id;
+      if (item.airConditioner && typeof item.airConditioner === 'object') {
+        const normalizedAirConditioner = {};
+        const minTemperature = Number(item.airConditioner.minTemperature);
+        const maxTemperature = Number(item.airConditioner.maxTemperature);
+        const temperatureStep = Number(item.airConditioner.temperatureStep);
+        if (Number.isFinite(minTemperature)) {
+          normalizedAirConditioner.minTemperature = minTemperature;
+        }
+        if (Number.isFinite(maxTemperature)) {
+          normalizedAirConditioner.maxTemperature = maxTemperature;
+        }
+        if (Number.isFinite(temperatureStep) && temperatureStep > 0) {
+          normalizedAirConditioner.temperatureStep = temperatureStep;
+        }
+        if (Number.isFinite(normalizedAirConditioner.minTemperature) && Number.isFinite(normalizedAirConditioner.maxTemperature) && normalizedAirConditioner.minTemperature > normalizedAirConditioner.maxTemperature) {
+          this.log.warn('[Tuya QR] Air conditioner override for id "%s" has minTemperature greater than maxTemperature. Swapping values.', id);
+          const oldMin = normalizedAirConditioner.minTemperature;
+          normalizedAirConditioner.minTemperature = normalizedAirConditioner.maxTemperature;
+          normalizedAirConditioner.maxTemperature = oldMin;
+        }
+        if (Object.keys(normalizedAirConditioner).length > 0) {
+          item.airConditioner = normalizedAirConditioner;
+        } else {
+          this.log.warn('[Tuya QR] Ignoring invalid airConditioner override for id "%s" because no numeric temperature values were provided.', id);
+          delete item.airConditioner;
+        }
+      }
       seenIds.add(id);
       validOverrides.push(item);
     }
@@ -221,6 +248,7 @@ class TuyaPlatform {
         customCategory: deviceConfig?.category,
         unbridged: deviceConfig?.unbridged ?? false,
         schemaOverrides: deviceConfig?.schema ? JSON.stringify(deviceConfig.schema) : undefined,
+        airConditioner: deviceConfig?.airConditioner ? JSON.stringify(deviceConfig.airConditioner) : undefined,
         adaptiveLighting: deviceConfig?.adaptiveLighting ?? false,
       };
       const { changed: configChanged } = this.configHash.hasConfigChanged(device.id, configToHash);

package/dist/shared/accessories/AirConditionerAccessory.js

@@ -234,18 +234,49 @@ class AirConditionerAccessory extends BaseAccessory_1.default {
         })
             .setProps({ validValues });
     }
+    getAirConditionerTemperatureProps(schema) {
+        const property = schema.property || {};
+        const multiple = Math.pow(10, property.scale || 0);
+        const props = {
+            minValue: Number.isFinite(Number(property.min)) ? Number(property.min) / multiple : 16,
+            maxValue: Number.isFinite(Number(property.max)) ? Number(property.max) / multiple : 31,
+            minStep: Math.max(0.1, Number.isFinite(Number(property.step)) ? Number(property.step) / multiple : 1),
+        };
+        const deviceConfig = this.platform.getDeviceConfig?.(this.device);
+        const airConditioner = deviceConfig?.airConditioner;
+        if (airConditioner && typeof airConditioner === 'object') {
+            const minTemperature = Number(airConditioner.minTemperature);
+            const maxTemperature = Number(airConditioner.maxTemperature);
+            const temperatureStep = Number(airConditioner.temperatureStep);
+            if (Number.isFinite(minTemperature)) {
+                props.minValue = minTemperature;
+            }
+            if (Number.isFinite(maxTemperature)) {
+                props.maxValue = maxTemperature;
+            }
+            if (Number.isFinite(temperatureStep) && temperatureStep > 0) {
+                props.minStep = Math.max(0.1, temperatureStep);
+            }
+            if (props.minValue > props.maxValue) {
+                this.log.warn('Invalid airConditioner temperature override: minTemperature %s is greater than maxTemperature %s. Swapping values.', props.minValue, props.maxValue);
+                const oldMin = props.minValue;
+                props.minValue = props.maxValue;
+                props.maxValue = oldMin;
+            }
+            this.log.info('Using air conditioner HomeKit temperature override: min=%s°C, max=%s°C, step=%s°C. Fahrenheit users will see the Home app converted values automatically.', props.minValue, props.maxValue, props.minStep);
+        }
+        return { props, multiple };
+    }
+    normalizeTemperatureCommandValue(value, props, multiple) {
+        const clamped = (0, util_1.limit)(Number(value), props.minValue, props.maxValue);
+        return Math.round(clamped * multiple);
+    }
     configureCoolingThreshouldTemp() {
         const schema = this.getSchema(...SCHEMA_CODE.TARGET_TEMP);
         if (!schema) {
             return;
         }
-        const property = schema.property;
-        const multiple = Math.pow(10, property.scale);
-        const props = {
-            minValue: property.min / multiple,
-            maxValue: property.max / multiple,
-            minStep: Math.max(0.1, property.step / multiple),
-        };
+        const { props, multiple } = this.getAirConditionerTemperatureProps(schema);
         this.log.debug('Set props for CoolingThresholdTemperature:', props);
         this.mainService().getCharacteristic(this.Characteristic.CoolingThresholdTemperature)
             .onGet(() => {
@@ -264,7 +295,7 @@ class AirConditionerAccessory extends BaseAccessory_1.default {
                     .updateValue(props.minValue);
                 return;
             }
-            await this.sendCommands([{ code: schema.code, value: value * multiple }], true);
+            await this.sendCommands([{ code: schema.code, value: this.normalizeTemperatureCommandValue(value, props, multiple) }], true);
         })
             .setProps(props);
     }
@@ -273,13 +304,7 @@ class AirConditionerAccessory extends BaseAccessory_1.default {
         if (!schema) {
             return;
         }
-        const property = schema.property;
-        const multiple = Math.pow(10, property.scale);
-        const props = {
-            minValue: property.min / multiple,
-            maxValue: property.max / multiple,
-            minStep: Math.max(0.1, property.step / multiple),
-        };
+        const { props, multiple } = this.getAirConditionerTemperatureProps(schema);
         this.log.debug('Set props for HeatingThresholdTemperature:', props);
         this.mainService().getCharacteristic(this.Characteristic.HeatingThresholdTemperature)
             .onGet(() => {
@@ -298,7 +323,7 @@ class AirConditionerAccessory extends BaseAccessory_1.default {
                     .updateValue(props.maxValue);
                 return;
             }
-            await this.sendCommands([{ code: schema.code, value: value * multiple }], true);
+            await this.sendCommands([{ code: schema.code, value: this.normalizeTemperatureCommandValue(value, props, multiple) }], true);
         })
             .setProps(props);
     }

package/dist/shared/accessories/DimmerAccessory.js

@@ -9,7 +9,7 @@ const Name_1 = require("./characteristic/Name");
 const On_1 = require("./characteristic/On");
 const SCHEMA_CODE = {
     ON: ['switch', 'switch_led', 'switch_1', 'switch_led_1'],
-    BRIGHTNESS: ['bright_value', 'bright_value_1'],
+    BRIGHTNESS: ['bright_value', 'bright_value_v2', 'bright_value_1', 'bright_value_2', 'brightness'],
 };
 class DimmerAccessory extends BaseAccessory_1.default {
     requiredSchema() {
@@ -28,10 +28,31 @@ class DimmerAccessory extends BaseAccessory_1.default {
             const service = this.accessory.getService(_schema.code)
                 || this.accessory.addService(this.Service.Lightbulb, name, _schema.code);
             (0, Name_1.configureName)(this, service, name);
-            (0, On_1.configureOn)(this, service, this.getSchema('switch' + suffix, 'switch_led' + suffix));
+            const onSchema = this.resolveOnSchemaForBrightness(suffix);
+            if (!onSchema) {
+                this.log.warn(`No on/off schema found for brightness DP ${_schema.code}. Tried switch/switch_led variants.`);
+            }
+            (0, On_1.configureOn)(this, service, onSchema);
             this.configureBrightness(service, suffix);
         }
     }
+
+    resolveOnSchemaForBrightness(suffix) {
+        const candidates = [];
+        if (suffix) {
+            candidates.push('switch' + suffix, 'switch_led' + suffix);
+        }
+        // bright_value_v2 is a schema generation/version marker, not a separate channel suffix.
+        // Devices such as the Treatlife/DP10 Smart dimmer Plug expose:
+        //   switch_led + bright_value_v2
+        // The older logic looked for switch_v2/switch_led_v2 and marked the device unsupported.
+        if (suffix === '_v2') {
+            candidates.push('switch_led', 'switch');
+        }
+        candidates.push('switch', 'switch_led', 'switch_1', 'switch_led_1');
+        return this.getSchema(...candidates);
+    }
+
     configureBrightness(service, suffix) {
         const schema = this.getSchema('bright_value' + suffix);
         if (!schema) {

package/homebridge-ui/public/index.html

@@ -39,7 +39,8 @@
     font-size: 0.875rem;
     opacity: 0.85;
   }
-  .tuya-nodev-status {
+  .tuya-nodev-status,
+  .tuya-nodev-ac-status {
     margin-top: 12px;
   }
   .tuya-nodev-raw {
@@ -49,6 +50,32 @@
     font-size: 0.8rem;
     margin-top: 8px;
   }
+  .tuya-nodev-grid {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
+    gap: 12px;
+  }
+  .tuya-nodev-table-wrap {
+    overflow-x: auto;
+    margin-top: 12px;
+  }
+  .tuya-nodev-table {
+    width: 100%;
+    border-collapse: collapse;
+    font-size: 0.9rem;
+  }
+  .tuya-nodev-table th,
+  .tuya-nodev-table td {
+    border-bottom: 1px solid rgba(127, 127, 127, 0.2);
+    padding: 8px;
+    vertical-align: middle;
+  }
+  .tuya-nodev-table th {
+    text-align: left;
+  }
+  .tuya-nodev-muted-option {
+    opacity: 0.75;
+  }
 </style>
 
 <div class="tuya-nodev-card">
@@ -87,12 +114,71 @@
   </div>
 </div>
 
+<div class="tuya-nodev-card">
+  <div class="tuya-nodev-title">Air Conditioner Temperature Overrides</div>
+  <p class="tuya-nodev-small mb-3">
+    Select a discovered Tuya AC device and set the Home app temperature range. Values are always Celsius; iOS/Home automatically displays Fahrenheit for users who use °F.
+  </p>
+
+  <div class="form-group">
+    <label for="tuyaNodevAcDevice">Select Device</label>
+    <select id="tuyaNodevAcDevice" class="form-control">
+      <option value="">Load devices first...</option>
+    </select>
+    <small class="form-text text-muted">AC-looking devices are listed first when the cached Tuya device list contains enough metadata.</small>
+  </div>
+
+  <div class="tuya-nodev-grid">
+    <div class="form-group">
+      <label for="tuyaNodevAcMin">Min Temperature (°C)</label>
+      <input id="tuyaNodevAcMin" class="form-control" type="number" min="0" max="50" step="0.1" value="17">
+    </div>
+    <div class="form-group">
+      <label for="tuyaNodevAcMax">Max Temperature (°C)</label>
+      <input id="tuyaNodevAcMax" class="form-control" type="number" min="0" max="60" step="0.1" value="31">
+    </div>
+    <div class="form-group">
+      <label for="tuyaNodevAcStep">Step (°C)</label>
+      <input id="tuyaNodevAcStep" class="form-control" type="number" min="0.1" max="5" step="0.1" value="1">
+    </div>
+  </div>
+
+  <div class="tuya-nodev-actions">
+    <button id="tuyaNodevLoadDevices" class="btn btn-outline-primary" type="button">Load Detected Devices</button>
+    <button id="tuyaNodevApplyAc" class="btn btn-primary" type="button">Add / Update AC Override</button>
+    <button id="tuyaNodevRemoveAc" class="btn btn-outline-danger" type="button">Remove Selected AC Override</button>
+  </div>
+
+  <div id="tuyaNodevAcStatus" class="tuya-nodev-ac-status alert alert-secondary">
+    Load detected devices after the plugin has authenticated and discovered your Tuya devices at least once.
+  </div>
+
+  <div class="tuya-nodev-table-wrap">
+    <table class="tuya-nodev-table">
+      <thead>
+        <tr>
+          <th>Device</th>
+          <th>Device ID</th>
+          <th>Min</th>
+          <th>Max</th>
+          <th>Step</th>
+          <th></th>
+        </tr>
+      </thead>
+      <tbody id="tuyaNodevAcOverrideRows">
+        <tr><td colspan="6" class="tuya-nodev-small">No AC overrides configured.</td></tr>
+      </tbody>
+    </table>
+  </div>
+</div>
+
 <script>
 (() => {
   const PLATFORM = 'TuyaNoDeveloperAccount';
   let currentConfig = null;
   let pollTimer = null;
   let isAuthenticated = false;
+  let detectedDevices = [];
 
   const $ = (id) => document.getElementById(id);
 
@@ -102,6 +188,12 @@
     el.textContent = message;
   }
 
+  function setAcStatus(message, type = 'secondary') {
+    const el = $('tuyaNodevAcStatus');
+    el.className = `tuya-nodev-ac-status alert alert-${type}`;
+    el.textContent = message;
+  }
+
   function getUserCode() {
     return $('tuyaNodevUserCode').value.trim();
   }
@@ -110,13 +202,20 @@
     return $('tuyaNodevName').value.trim() || 'Tuya without developer account';
   }
 
+  function clone(value) {
+    return value && typeof value === 'object' ? JSON.parse(JSON.stringify(value)) : value;
+  }
+
   function normaliseConfig(base) {
-    const cfg = base && typeof base === 'object' ? JSON.parse(JSON.stringify(base)) : {};
+    const cfg = base && typeof base === 'object' ? clone(base) : {};
     cfg.platform = PLATFORM;
     cfg.name = getPlatformName();
     cfg.options = cfg.options && typeof cfg.options === 'object' ? cfg.options : {};
     cfg.options.userCode = getUserCode();
     cfg.options.projectType = '3';
+    if (!Array.isArray(cfg.options.deviceOverrides)) {
+      cfg.options.deviceOverrides = [];
+    }
     delete cfg.options.accessId;
     delete cfg.options.accessKey;
     delete cfg.options.username;
@@ -128,9 +227,15 @@
     return cfg;
   }
 
-  async function syncConfigToUi() {
+  function ensureConfig() {
     currentConfig = normaliseConfig(currentConfig);
+    return currentConfig;
+  }
+
+  async function syncConfigToUi() {
+    ensureConfig();
     await homebridge.updatePluginConfig([currentConfig]);
+    renderAcOverrides();
   }
 
   function stopPolling() {
@@ -150,6 +255,195 @@
     if (homebridge.enableSaveButton) homebridge.enableSaveButton();
   }
 
+  function getDeviceName(id) {
+    const device = detectedDevices.find((item) => item.id === id);
+    return device ? device.name : '';
+  }
+
+  function getAcOverrides() {
+    const cfg = ensureConfig();
+    return (cfg.options.deviceOverrides || []).filter((item) => item && item.id && item.airConditioner && typeof item.airConditioner === 'object');
+  }
+
+  function isOnlyAcOverride(item) {
+    const keys = Object.keys(item || {}).filter((key) => item[key] !== undefined && item[key] !== null && item[key] !== '');
+    return keys.every((key) => ['id', 'airConditioner'].includes(key));
+  }
+
+  function renderAcOverrides() {
+    const tbody = $('tuyaNodevAcOverrideRows');
+    const overrides = getAcOverrides();
+    if (!overrides.length) {
+      tbody.innerHTML = '<tr><td colspan="6" class="tuya-nodev-small">No AC overrides configured.</td></tr>';
+      return;
+    }
+
+    tbody.innerHTML = overrides.map((override) => {
+      const ac = override.airConditioner || {};
+      const name = getDeviceName(override.id) || 'Unknown / not in detected cache';
+      return `
+        <tr>
+          <td>${escapeHtml(name)}</td>
+          <td><code>${escapeHtml(override.id)}</code></td>
+          <td>${escapeHtml(ac.minTemperature ?? '')} °C</td>
+          <td>${escapeHtml(ac.maxTemperature ?? '')} °C</td>
+          <td>${escapeHtml(ac.temperatureStep ?? '')} °C</td>
+          <td><button class="btn btn-sm btn-outline-secondary tuya-nodev-edit-ac" type="button" data-id="${escapeHtml(override.id)}">Edit</button></td>
+        </tr>`;
+    }).join('');
+
+    tbody.querySelectorAll('.tuya-nodev-edit-ac').forEach((button) => {
+      button.addEventListener('click', () => editAcOverride(button.getAttribute('data-id')));
+    });
+  }
+
+  function escapeHtml(value) {
+    return String(value ?? '')
+      .replace(/&/g, '&amp;')
+      .replace(/</g, '&lt;')
+      .replace(/>/g, '&gt;')
+      .replace(/"/g, '&quot;')
+      .replace(/'/g, '&#039;');
+  }
+
+  function parseNumberInput(id, label) {
+    const raw = $(id).value;
+    const value = Number(raw);
+    if (!Number.isFinite(value)) {
+      throw new Error(`${label} must be a number.`);
+    }
+    return value;
+  }
+
+  function populateDeviceSelect(devices) {
+    const select = $('tuyaNodevAcDevice');
+    const current = select.value;
+    if (!devices.length) {
+      select.innerHTML = '<option value="">No detected devices found</option>';
+      return;
+    }
+
+    select.innerHTML = '<option value="">Select a Tuya device...</option>' + devices.map((device) => {
+      const tag = device.likelyAirConditioner ? 'AC candidate' : (device.category || 'device');
+      const text = `${device.name} — ${tag} — ${device.id}`;
+      return `<option value="${escapeHtml(device.id)}">${escapeHtml(text)}</option>`;
+    }).join('');
+
+    if (current && devices.some((device) => device.id === current)) {
+      select.value = current;
+    }
+  }
+
+  async function loadDetectedDevices(showToast = true) {
+    try {
+      homebridge.showSpinner();
+      const res = await homebridge.request('/devices/list', {});
+      detectedDevices = Array.isArray(res.devices) ? res.devices : [];
+      populateDeviceSelect(detectedDevices);
+      renderAcOverrides();
+      const acCount = detectedDevices.filter((device) => device.likelyAirConditioner).length;
+      setAcStatus(`${res.message || 'Device list loaded.'} ${acCount ? `${acCount} AC candidate(s) listed first.` : ''}`.trim(), detectedDevices.length ? 'success' : 'warning');
+      if (showToast) homebridge.toast.success(`Loaded ${detectedDevices.length} detected Tuya device(s).`, 'Tuya');
+    } catch (e) {
+      setAcStatus(e.message || 'Failed to load detected devices.', 'danger');
+      if (showToast) homebridge.toast.error(e.message || 'Failed to load detected devices.', 'Tuya');
+    } finally {
+      homebridge.hideSpinner();
+    }
+  }
+
+  function editAcOverride(id) {
+    const override = getAcOverrides().find((item) => item.id === id);
+    if (!override) {
+      return;
+    }
+    const device = detectedDevices.find((item) => item.id === id);
+    if (!device) {
+      const select = $('tuyaNodevAcDevice');
+      const option = document.createElement('option');
+      option.value = id;
+      option.textContent = `${id} — not currently in detected device cache`;
+      select.appendChild(option);
+    }
+    $('tuyaNodevAcDevice').value = id;
+    $('tuyaNodevAcMin').value = override.airConditioner.minTemperature ?? 17;
+    $('tuyaNodevAcMax').value = override.airConditioner.maxTemperature ?? 31;
+    $('tuyaNodevAcStep').value = override.airConditioner.temperatureStep ?? 1;
+    setAcStatus(`Editing AC override for ${device?.name || id}.`, 'info');
+  }
+
+  async function addOrUpdateAcOverride() {
+    try {
+      const id = $('tuyaNodevAcDevice').value.trim();
+      if (!id) {
+        setAcStatus('Select a Tuya device first.', 'warning');
+        return;
+      }
+      const minTemperature = parseNumberInput('tuyaNodevAcMin', 'Minimum temperature');
+      const maxTemperature = parseNumberInput('tuyaNodevAcMax', 'Maximum temperature');
+      const temperatureStep = parseNumberInput('tuyaNodevAcStep', 'Temperature step');
+      if (temperatureStep <= 0) {
+        throw new Error('Temperature step must be greater than 0.');
+      }
+      if (minTemperature > maxTemperature) {
+        throw new Error('Minimum temperature cannot be greater than maximum temperature.');
+      }
+
+      const cfg = ensureConfig();
+      const overrides = cfg.options.deviceOverrides;
+      let override = overrides.find((item) => item && String(item.id || '').trim() === id);
+      if (!override) {
+        override = { id };
+        overrides.push(override);
+      }
+      override.id = id;
+      override.airConditioner = { minTemperature, maxTemperature, temperatureStep };
+
+      await syncConfigToUi();
+      const name = getDeviceName(id) || id;
+      setAcStatus(`AC override saved in plugin config for ${name}: ${minTemperature}–${maxTemperature} °C, step ${temperatureStep} °C. Click Save Configuration when ready.`, 'success');
+      homebridge.toast.success('AC temperature override added to config.', 'Tuya');
+      if (isAuthenticated) {
+        enableSaving();
+      }
+    } catch (e) {
+      setAcStatus(e.message || 'Failed to add AC override.', 'danger');
+    }
+  }
+
+  async function removeSelectedAcOverride() {
+    const id = $('tuyaNodevAcDevice').value.trim();
+    if (!id) {
+      setAcStatus('Select a Tuya device first.', 'warning');
+      return;
+    }
+
+    const cfg = ensureConfig();
+    const before = cfg.options.deviceOverrides.length;
+    cfg.options.deviceOverrides = cfg.options.deviceOverrides.flatMap((item) => {
+      if (!item || String(item.id || '').trim() !== id) {
+        return [item];
+      }
+      if (isOnlyAcOverride(item)) {
+        return [];
+      }
+      const copy = clone(item);
+      delete copy.airConditioner;
+      return [copy];
+    });
+
+    await syncConfigToUi();
+    if (cfg.options.deviceOverrides.length === before) {
+      setAcStatus('No AC override existed for the selected device.', 'warning');
+    } else {
+      setAcStatus('Selected AC override was removed from the plugin config. Click Save Configuration when ready.', 'success');
+      homebridge.toast.success('AC temperature override removed from config.', 'Tuya');
+    }
+    if (isAuthenticated) {
+      enableSaving();
+    }
+  }
+
   async function checkAuth(showSuccessToast = false) {
     const userCode = getUserCode();
     if (!userCode) {
@@ -260,15 +554,92 @@
     }
   }
 
+
+  function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+
+  async function withTimeout(promise, timeoutMs, timeoutMessage) {
+    let timer;
+    try {
+      return await Promise.race([
+        promise,
+        new Promise((_, reject) => {
+          timer = setTimeout(() => reject(new Error(timeoutMessage)), timeoutMs);
+        }),
+      ]);
+    } finally {
+      if (timer) {
+        clearTimeout(timer);
+      }
+    }
+  }
+
+  async function verifySavedConfig(userCode) {
+    const blocks = await withTimeout(
+      homebridge.getPluginConfig(),
+      8000,
+      'Configuration save timed out while verifying the saved plugin config.'
+    );
+    const block = Array.isArray(blocks) && blocks.length > 0 ? blocks[0] : blocks;
+    return !!(block && block.platform === PLATFORM && block.options && block.options.userCode === userCode);
+  }
+
   async function saveConfig() {
     if (!isAuthenticated) {
       setStatus('Scan and approve the QR code before saving.', 'warning');
       return;
     }
+
+    const userCode = getUserCode();
+    if (!userCode) {
+      setStatus('User Code is required before saving.', 'warning');
+      return;
+    }
+
     try {
       homebridge.showSpinner();
-      await syncConfigToUi();
-      await homebridge.savePluginConfig();
+      $('tuyaNodevSave').disabled = true;
+
+      await withTimeout(
+        syncConfigToUi(),
+        8000,
+        'Timed out while preparing the plugin configuration for saving.'
+      );
+
+      // Some Homebridge UI versions have been observed to save the config but never resolve
+      // savePluginConfig(), which leaves the custom UI spinner running forever. Timeout the
+      // UI call, then verify the saved config before showing the final result.
+      let saveTimedOut = false;
+      try {
+        await withTimeout(
+          homebridge.savePluginConfig(),
+          15000,
+          'Homebridge UI did not finish the save request in time.'
+        );
+      } catch (e) {
+        saveTimedOut = true;
+      }
+
+      let verified = false;
+      try {
+        await delay(750);
+        verified = await verifySavedConfig(userCode);
+      } catch (e) {
+        verified = false;
+      }
+
+      if (saveTimedOut && !verified) {
+        throw new Error('Save did not complete. The QR auth token is saved, but the plugin configuration could not be verified. Close this window, refresh Homebridge UI, and check whether the config was saved.');
+      }
+
+      if (saveTimedOut && verified) {
+        const message = 'Configuration appears to be saved, but Homebridge UI did not return a save confirmation. Close this settings window and restart Homebridge.';
+        homebridge.toast.success(message, 'Tuya');
+        setStatus(message, 'success');
+        return;
+      }
+
       homebridge.toast.success('Configuration saved. Restart Homebridge to load devices.', 'Tuya');
       setStatus('Configuration saved. Restart Homebridge to load devices.', 'success');
     } catch (e) {
@@ -276,6 +647,9 @@
       homebridge.toast.error(e.message || 'Failed to save configuration.', 'Tuya');
     } finally {
       homebridge.hideSpinner();
+      if (isAuthenticated) {
+        $('tuyaNodevSave').disabled = false;
+      }
     }
   }
 
@@ -286,12 +660,9 @@
         platform: PLATFORM,
         name: 'Tuya without developer account',
         mode: 'cloud',
-        options: { projectType: '3' },
+        options: { projectType: '3', deviceOverrides: [] },
       };
-      currentConfig.platform = PLATFORM;
-      currentConfig.mode = 'cloud';
-      currentConfig.options = currentConfig.options || {};
-      currentConfig.options.projectType = '3';
+      ensureConfig();
       $('tuyaNodevName').value = currentConfig.name || 'Tuya without developer account';
       $('tuyaNodevUserCode').value = currentConfig.options?.userCode || '';
 
@@ -301,12 +672,10 @@
         const block = Array.isArray(data) ? data[0] : data;
         if (block && typeof block === 'object') {
           currentConfig = block;
-          currentConfig.platform = PLATFORM;
-          currentConfig.mode = 'cloud';
-          currentConfig.options = currentConfig.options || {};
-          currentConfig.options.projectType = '3';
+          ensureConfig();
           if (block.name) $('tuyaNodevName').value = block.name;
           if (block.options?.userCode) $('tuyaNodevUserCode').value = block.options.userCode;
+          renderAcOverrides();
         }
       });
 
@@ -320,8 +689,12 @@
         disableSaving();
         syncConfigToUi();
       });
+      $('tuyaNodevLoadDevices').addEventListener('click', () => loadDetectedDevices(true));
+      $('tuyaNodevApplyAc').addEventListener('click', addOrUpdateAcOverride);
+      $('tuyaNodevRemoveAc').addEventListener('click', removeSelectedAcOverride);
 
       await syncConfigToUi();
+      await loadDetectedDevices(false);
       if (getUserCode()) {
         await checkAuth(false);
       } else {

package/homebridge-ui/server.js

@@ -13,6 +13,161 @@ function normaliseUserCode(userCode) {
   return String(userCode || '').trim();
 }
 
+function firstString(...values) {
+  for (const value of values) {
+    if (value === undefined || value === null) {
+      continue;
+    }
+    const text = String(value).trim();
+    if (text) {
+      return text;
+    }
+  }
+  return '';
+}
+
+function looksLikeAirConditioner(device) {
+  const haystack = [
+    device.name,
+    device.category,
+    device.productName,
+    device.productId,
+    device.model,
+  ].filter(Boolean).join(' ').toLowerCase();
+
+  return [
+    'air conditioner',
+    'airconditioner',
+    'aircon',
+    'a/c',
+    'ac ',
+    ' ac',
+    'clima',
+    'climă',
+    'aer conditionat',
+    'aer condiționat',
+    'hvac',
+  ].some((needle) => haystack.includes(needle))
+    || ['kt', 'wk', 'air_conditioner', 'airconditioner'].includes(String(device.category || '').toLowerCase());
+}
+
+function collectDevicesFromObject(root) {
+  const byId = new Map();
+
+  function addDevice(obj) {
+    if (!obj || typeof obj !== 'object' || Array.isArray(obj)) {
+      return;
+    }
+
+    const id = firstString(
+      obj.id,
+      obj.devId,
+      obj.dev_id,
+      obj.deviceId,
+      obj.device_id,
+      obj.uid,
+    );
+
+    const name = firstString(
+      obj.name,
+      obj.deviceName,
+      obj.device_name,
+      obj.customName,
+      obj.custom_name,
+      obj.title,
+    );
+
+    if (!id || !name) {
+      return;
+    }
+
+    // Avoid adding automation scenes as selectable devices.
+    if (obj.scene_id || obj.sceneId || obj.rule_id || obj.ruleId) {
+      return;
+    }
+
+    const category = firstString(
+      obj.category,
+      obj.categoryCode,
+      obj.category_code,
+      obj.productCategory,
+      obj.product_category,
+    );
+
+    const productName = firstString(
+      obj.productName,
+      obj.product_name,
+      obj.product,
+      obj.productTitle,
+    );
+
+    const productId = firstString(
+      obj.productId,
+      obj.product_id,
+      obj.pid,
+    );
+
+    const model = firstString(obj.model, obj.modelId, obj.model_id);
+
+    const status = Array.isArray(obj.status) ? obj.status : [];
+    const statusCodes = status
+      .map((item) => item && typeof item === 'object' ? firstString(item.code) : '')
+      .filter(Boolean);
+
+    const schema = Array.isArray(obj.schema) ? obj.schema : Array.isArray(obj.schemas) ? obj.schemas : [];
+    const schemaCodes = schema
+      .map((item) => item && typeof item === 'object' ? firstString(item.code) : '')
+      .filter(Boolean);
+
+    const existing = byId.get(id) || {};
+    const merged = {
+      id,
+      name: existing.name || name,
+      category: existing.category || category || null,
+      productName: existing.productName || productName || null,
+      productId: existing.productId || productId || null,
+      model: existing.model || model || null,
+      online: typeof obj.online === 'boolean' ? obj.online : existing.online,
+      statusCodes: Array.from(new Set([...(existing.statusCodes || []), ...statusCodes])).sort(),
+      schemaCodes: Array.from(new Set([...(existing.schemaCodes || []), ...schemaCodes])).sort(),
+    };
+    merged.likelyAirConditioner = looksLikeAirConditioner(merged)
+      || merged.statusCodes.includes('temp_set')
+      || merged.schemaCodes.includes('temp_set');
+    merged.label = `${merged.name} (${merged.id})`;
+    byId.set(id, merged);
+  }
+
+  function walk(value) {
+    if (Array.isArray(value)) {
+      for (const item of value) {
+        walk(item);
+      }
+      return;
+    }
+    if (!value || typeof value !== 'object') {
+      return;
+    }
+
+    addDevice(value);
+
+    for (const child of Object.values(value)) {
+      if (child && typeof child === 'object') {
+        walk(child);
+      }
+    }
+  }
+
+  walk(root);
+
+  return Array.from(byId.values()).sort((a, b) => {
+    if (a.likelyAirConditioner !== b.likelyAirConditioner) {
+      return a.likelyAirConditioner ? -1 : 1;
+    }
+    return String(a.name).localeCompare(String(b.name));
+  });
+}
+
 (async () => {
   const { HomebridgePluginUiServer, RequestError } = await import('@homebridge/plugin-ui-utils');
 
@@ -24,6 +179,7 @@ function normaliseUserCode(userCode) {
       this.onRequest('/qr/status', this.qrStatus.bind(this));
       this.onRequest('/auth/status', this.authStatus.bind(this));
       this.onRequest('/auth/clear', this.clearAuth.bind(this));
+      this.onRequest('/devices/list', this.listDevices.bind(this));
       this.ready();
     }
 
@@ -58,6 +214,63 @@ function normaliseUserCode(userCode) {
       return file;
     }
 
+    async listDevices() {
+      const persistDir = path.join(this.homebridgeStoragePath, 'persist');
+      let entries;
+      try {
+        entries = await fs.promises.readdir(persistDir, { withFileTypes: true });
+      } catch (err) {
+        if (err && err.code === 'ENOENT') {
+          return { devices: [], files: [], message: 'No Homebridge persist directory found yet. Authenticate and restart Homebridge once so the plugin can save a device list.' };
+        }
+        throw err;
+      }
+
+      const candidates = [];
+      for (const entry of entries) {
+        if (!entry.isFile()) {
+          continue;
+        }
+        if (!/^TuyaDeviceList.*\.json$/i.test(entry.name)) {
+          continue;
+        }
+        const file = path.join(persistDir, entry.name);
+        const stat = await fs.promises.stat(file);
+        candidates.push({ file, mtimeMs: stat.mtimeMs });
+      }
+
+      candidates.sort((a, b) => b.mtimeMs - a.mtimeMs);
+
+      const allDevices = new Map();
+      const errors = [];
+      for (const candidate of candidates) {
+        try {
+          const data = JSON.parse(await fs.promises.readFile(candidate.file, 'utf8'));
+          for (const device of collectDevicesFromObject(data)) {
+            if (!allDevices.has(device.id)) {
+              allDevices.set(device.id, device);
+            }
+          }
+        } catch (err) {
+          errors.push({ file: candidate.file, message: err.message });
+        }
+      }
+
+      const devices = Array.from(allDevices.values()).sort((a, b) => {
+        if (a.likelyAirConditioner !== b.likelyAirConditioner) {
+          return a.likelyAirConditioner ? -1 : 1;
+        }
+        return String(a.name).localeCompare(String(b.name));
+      });
+
+      return {
+        devices,
+        files: candidates.map((item) => item.file),
+        errors,
+        message: devices.length ? `Loaded ${devices.length} Tuya device(s) from Homebridge persist cache.` : 'No devices found in TuyaDeviceList cache yet. Authenticate and restart Homebridge once, then reopen this settings page.',
+      };
+    }
+
     async authStatus(payload = {}) {
       const userCode = normaliseUserCode(payload.userCode);
       if (!userCode) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-tuya-without-developer-account",
   "displayName": "Tuya without developer account for Homebridge",
-  "version": "1.0.2",
+  "version": "1.0.6",
   "description": "Homebridge plugin for Tuya and Smart Life devices using QR cloud authentication without a Tuya IoT developer account.",
   "license": "MIT",
   "author": "Kosztyk",