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

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 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

@@ -187,8 +187,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
 

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/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) {
@@ -286,12 +580,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 +592,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 +609,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.4",
   "description": "Homebridge plugin for Tuya and Smart Life devices using QR cloud authentication without a Tuya IoT developer account.",
   "license": "MIT",
   "author": "Kosztyk",