homebridge-ac-freedom 2.2.1 → 2.2.3

package/README.md

@@ -1,82 +1,85 @@
 <p align="center">
-  <a href="https://homebridge.io"><img src="https://raw.githubusercontent.com/homebridge/branding/master/logos/homebridge-wordmark-logo-horizontal.png" height="60"></a>
+  <img src="https://raw.githubusercontent.com/azadaydinli/homebridge-ac-freedom/main/banner.svg" width="800">
 </p>
 
-# homebridge-ac-freedom
+<span align="center">
+
+# Homebridge AC Freedom
+
+A [Homebridge](https://homebridge.io) plugin for controlling **AUX-based air conditioners** via **Apple HomeKit**. Works with any AC that uses the **AC Freedom** app. Supports **Cloud** (AUX API) and **Local** (Broadlink UDP) connections — no extra hub required.
 
 [![verified-by-homebridge](https://img.shields.io/badge/homebridge-verified-blueviolet?color=%23491F59&style=flat&logoColor=%23FFFFFF&logo=homebridge)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
 [![npm](https://img.shields.io/npm/v/homebridge-ac-freedom)](https://www.npmjs.com/package/homebridge-ac-freedom)
+[![npm](https://img.shields.io/npm/dw/homebridge-ac-freedom)](https://www.npmjs.com/package/homebridge-ac-freedom)
 [![npm](https://img.shields.io/npm/dt/homebridge-ac-freedom)](https://www.npmjs.com/package/homebridge-ac-freedom)
-[![GitHub](https://img.shields.io/github/license/azadaydinli/homebridge-ac-freedom)](https://github.com/azadaydinli/homebridge-ac-freedom/blob/main/LICENSE)
+[![Ko-fi](https://img.shields.io/badge/Support%20on-Ko--fi-FF5E5B?logo=ko-fi&logoColor=white)](https://ko-fi.com/azadaydinli)
+[![GitHub Sponsors](https://img.shields.io/badge/Sponsor-%E2%9D%A4-ea4aaa?logo=github)](https://github.com/sponsors/azadaydinli)
 
-A [Homebridge](https://homebridge.io) plugin for controlling **AUX-based air conditioners** (AUX, Ballu, Centek, Dunham Bush, Kenwood, Rinnai, Rcool, Tornado, and other brands using the **AC Freedom** app) via **Apple HomeKit**.
+</span>
 
-Supports both **Cloud** (AUX Cloud API) and **Local** (Broadlink UDP) connections.
+---
 
 ## Features
 
-- **HeaterCooler** service with Auto, Cool, and Heat modes
-- **Fan speed** control (Auto, Mute, Low, Medium, High, Turbo) via linked Fanv2 service
-- **Swing** mode (vertical + horizontal)
+- **HeaterCooler** tile — Auto, Heat, Cool modes
+- **Fan speed** control — Auto / Low / Medium / High / Turbo (25% steps)
+- **Swing** mode — vertical + horizontal
 - **Preset switches** inside the climate card:
   - Sleep Mode
   - Health / Ionizer
   - Eco / Mildew Prevention
   - Self Clean
   - Comfortable Wind
-- **Display** switch (LED display on/off)
-- **Dual connection modes:**
-  - **Cloud** -- AUX Cloud API (AC Freedom app account), no local network access needed
-  - **Local** -- Direct Broadlink UDP control, no internet required
-- **Auto-discovery** of cloud devices (or specify a Device ID)
-- **Temperature step** selection (0.5 or 1 degree)
-- **Configurable poll interval** (5--300 seconds)
+- **Display** switch — LED display on/off
+- **Auto-reset** — fan and sleep reset to default when AC turns on or off
+- **Cloud** — AUX Cloud API via AC Freedom app credentials
+- **Local** — Direct Broadlink UDP, no internet required
+- **Multi-device** — configure as many ACs as needed
+- Homebridge v1 & v2 compatible
+
+---
 
 ## Supported Brands
 
-Any air conditioner that works with the **AC Freedom** app is supported. Known brands include:
+Any air conditioner compatible with the **AC Freedom** app is supported:
 
-| Brand | Brand | Brand |
-|-------|-------|-------|
-| AUX | Ballu | Centek |
-| Dunham Bush | Kenwood | Rinnai |
-| Rcool | Tornado | Akai |
-| Hyundai | Hisense | Royal Clima |
+| | | | |
+|---|---|---|---|
+| AUX | Ballu | Centek | Dunham Bush |
+| Kenwood | Rinnai | Rcool | Tornado |
+| Akai | Hyundai | Hisense | Royal Clima |
+
+---
 
 ## Requirements
 
-- [Homebridge](https://homebridge.io) v1.6.0 or later
+- [Homebridge](https://homebridge.io) v1.6.0 or later (v2 supported)
 - Node.js v18.0.0 or later
 - An AUX-compatible AC with Wi-Fi (Broadlink module)
-- **Cloud mode:** AC Freedom app account (email registration)
-- **Local mode:** AC's IP and MAC address on your local network
+- **Cloud:** AC Freedom app account (email registration)
+- **Local:** AC's IP and MAC address on your local network
+
+---
 
 ## Installation
 
-### Via Homebridge UI (Recommended)
+**Via Homebridge UI (recommended):**
 
-1. Open the Homebridge UI
-2. Go to **Plugins**
-3. Search for `homebridge-ac-freedom`
-4. Click **Install**
+1. Open the Homebridge UI → **Plugins**
+2. Search for `homebridge-ac-freedom`
+3. Click **Install**
 
-### Via Command Line
+**Via terminal:**
 
 ```bash
 npm install -g homebridge-ac-freedom
 ```
 
-## Configuration
+---
 
-### Using Homebridge UI
-
-The easiest way to configure the plugin is through the Homebridge UI settings page. All options are available with descriptions.
-
-### Manual Configuration
-
-Add the following to your Homebridge `config.json`:
+## Configuration
 
-#### Cloud Mode
+### Cloud Mode
 
 ```json
 {
@@ -84,15 +87,12 @@ Add the following to your Homebridge `config.json`:
     {
       "platform": "AcFreedom",
       "name": "AC Freedom",
-      "devices": [
+      "cloudDevices": [
         {
           "name": "Living Room AC",
-          "connection": "cloud",
-          "cloud": {
-            "email": "your-email@example.com",
-            "password": "your-password",
-            "region": "eu"
-          }
+          "email": "your-email@example.com",
+          "password": "your-password",
+          "region": "eu"
         }
       ]
     }
@@ -100,7 +100,7 @@ Add the following to your Homebridge `config.json`:
 }
 ```
 
-#### Local Mode
+### Local Mode
 
 ```json
 {
@@ -108,14 +108,11 @@ Add the following to your Homebridge `config.json`:
     {
       "platform": "AcFreedom",
       "name": "AC Freedom",
-      "devices": [
+      "localDevices": [
         {
           "name": "Bedroom AC",
-          "connection": "local",
-          "local": {
-            "ip": "192.168.1.100",
-            "mac": "AA:BB:CC:DD:EE:FF"
-          }
+          "ip": "192.168.1.100",
+          "mac": "AA:BB:CC:DD:EE:FF"
         }
       ]
     }
@@ -123,91 +120,109 @@ Add the following to your Homebridge `config.json`:
 }
 ```
 
-### Configuration Options
-
-#### Device Options
+---
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `name` | string | `"AC Freedom"` | Device name shown in HomeKit |
-| `connection` | string | `"cloud"` | Connection mode: `"cloud"` or `"local"` |
-| `pollInterval` | integer | `30` | State polling interval in seconds (5--300) |
-| `tempStep` | number | `0.5` | Temperature adjustment step: `0.5` or `1` |
+## Configuration Options
 
-#### Cloud Options
+### Cloud Device Options
 
-| Option | Type | Required | Description |
-|--------|------|----------|-------------|
-| `email` | string | Yes | AC Freedom app email |
-| `password` | string | Yes | AC Freedom app password |
-| `region` | string | No | Server region: `"eu"`, `"usa"`, `"cn"`, `"rus"` (default: `"eu"`) |
-| `deviceId` | string | No | Specific device endpoint ID (leave empty for auto-detect) |
+| Option | Type | Required | Default | Description |
+|--------|------|----------|---------|-------------|
+| `name` | string | Yes | — | Device name in HomeKit |
+| `email` | string | Yes | — | AC Freedom app email |
+| `password` | string | Yes | — | AC Freedom app password |
+| `region` | string | No | `"eu"` | Server region: `eu`, `usa`, `cn`, `rus` |
+| `deviceId` | string | No | — | Specific device ID (leave empty to auto-detect) |
+| `showExtras` | boolean | No | `false` | Show fan, sleep, and extra switches |
+| `pollInterval` | integer | No | `30` | Polling interval in seconds (5–300) |
 
-#### Local Options
+### Local Device Options
 
-| Option | Type | Required | Description |
-|--------|------|----------|-------------|
-| `ip` | string | Yes | AC unit's IP address on your local network |
-| `mac` | string | Yes | AC unit's MAC address (`AA:BB:CC:DD:EE:FF` format) |
+| Option | Type | Required | Default | Description |
+|--------|------|----------|---------|-------------|
+| `name` | string | Yes | — | Device name in HomeKit |
+| `ip` | string | Yes | — | AC unit's local IP address |
+| `mac` | string | Yes | — | AC unit's MAC address (`AA:BB:CC:DD:EE:FF`) |
+| `showExtras` | boolean | No | `false` | Show fan, sleep, and extra switches |
+| `pollInterval` | integer | No | `30` | Polling interval in seconds (5–300) |
 
-#### Feature Switches
+### Feature Switches
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `presets.sleep` | boolean | `true` | Show Sleep Mode switch |
-| `presets.health` | boolean | `true` | Show Health / Ionizer switch |
-| `presets.eco` | boolean | `true` | Show Eco / Mildew Prevention switch |
-| `presets.clean` | boolean | `true` | Show Self Clean switch |
-| `showComfWind` | boolean | `true` | Show Comfortable Wind switch |
-| `showDisplay` | boolean | `true` | Show Display (LED) switch |
+| `presets.sleep` | boolean | `true` | Sleep Mode switch |
+| `presets.health` | boolean | `true` | Health / Ionizer switch |
+| `presets.eco` | boolean | `true` | Eco / Mildew Prevention switch |
+| `presets.clean` | boolean | `true` | Self Clean switch |
+| `showComfWind` | boolean | `true` | Comfortable Wind switch |
+| `showDisplay` | boolean | `true` | Display (LED) switch |
+| `showFan` | boolean | `true` | Fan speed slider |
+
+---
 
 ## HomeKit Climate Card
 
-Once configured, the AC appears as a **HeaterCooler** tile in the Home app. Tapping on it reveals:
+Once configured, the AC appears as a **HeaterCooler** tile. Tapping it reveals:
 
-- **Temperature control** with heating/cooling thresholds
-- **Mode selector** (Auto / Heat / Cool)
-- **Fan speed** slider
-- **Swing** toggle
-- **Preset switches** (Sleep, Health, Eco, Clean, Comfortable Wind, Display)
+- Temperature control with heating/cooling thresholds
+- Mode selector — Auto / Heat / Cool
+- Fan speed slider — 0% Auto · 25% Low · 50% Medium · 75% High · 100% Turbo
+- Swing toggle
+- Preset switches — Sleep, Health, Eco, Clean, Comfortable Wind, Display
 
-All linked services appear as tiles inside the climate card for quick access.
+All linked services appear as tiles inside the climate card.
+
+---
 
 ## Cloud vs Local
 
-| Feature | Cloud | Local |
-|---------|-------|-------|
+| | Cloud | Local |
+|---|---|---|
 | Internet required | Yes | No |
-| Setup complexity | Easy (email + password) | Moderate (IP + MAC) |
-| Response speed | ~1-2 seconds | ~0.5 seconds |
-| Works outside home | Yes | No |
-| Firmware updates | Via AC Freedom app | N/A |
+| Setup | Easy (email + password) | Moderate (IP + MAC) |
+| Response time | ~1–2 s | ~0.5 s |
+| Works remotely | Yes | No |
+
+---
 
 ## Troubleshooting
 
-### Cloud login fails
-- Verify your credentials work in the **AC Freedom** app
-- Make sure you registered with an **email** (phone number login is not supported)
-- Check the **region** setting matches your account
-- Logging in via the AC Freedom app may invalidate the plugin session -- restart Homebridge after using the app
+**Cloud login fails**
+- Verify credentials work in the AC Freedom app
+- Phone number login is not supported — use email registration
+- Check the `region` matches your account region
+- Logging into the AC Freedom app may invalidate the plugin session — restart Homebridge after using the app
 
-### Device not found
-- For cloud: leave `deviceId` empty to auto-detect, or find it in Homebridge logs
-- For local: ensure the AC is connected to your Wi-Fi and the IP/MAC are correct
+**Device not found**
+- Cloud: leave `deviceId` empty for auto-detect, or find it in Homebridge logs
+- Local: confirm the AC is on your Wi-Fi and the IP/MAC are correct
 
-### Poll errors ("server busy")
-- Transient cloud server errors are automatically suppressed
-- If persistent, try increasing `pollInterval` to 60 or higher
+**"Server busy" errors**
+- These are transient and automatically suppressed
+- If persistent, increase `pollInterval` to 60 or higher
 
-### AC not responding to commands
-- Check if the AC is powered on and connected to Wi-Fi
-- For local mode: ensure Homebridge and the AC are on the same network
+**AC not responding**
+- Check the AC is powered on and connected to Wi-Fi
+- Local mode: Homebridge and AC must be on the same network
 - Try restarting Homebridge
 
+---
+
+## Support
+
+If this plugin is useful to you, consider supporting its development:
+
+[![Ko-fi](https://img.shields.io/badge/Support%20on-Ko--fi-FF5E5B?logo=ko-fi&logoColor=white)](https://ko-fi.com/azadaydinli)
+[![GitHub Sponsors](https://img.shields.io/badge/Sponsor-%E2%9D%A4-ea4aaa?logo=github)](https://github.com/sponsors/azadaydinli)
+
+---
+
 ## Contributing
 
 Contributions are welcome! Please open an [issue](https://github.com/azadaydinli/homebridge-ac-freedom/issues) or submit a pull request.
 
+---
+
 ## License
 
-MIT -- see [LICENSE](LICENSE) for details.
+MIT © [Azad Aydınlı](https://github.com/azadaydinli)

package/banner.svg

@@ -0,0 +1,161 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 360">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#1e1433"/>
+      <stop offset="100%" stop-color="#0d1b3e"/>
+    </linearGradient>
+    <linearGradient id="panelGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="rgba(255,255,255,0.05)"/>
+      <stop offset="100%" stop-color="rgba(255,255,255,0.02)"/>
+    </linearGradient>
+    <pattern id="dots" x="0" y="0" width="32" height="32" patternUnits="userSpaceOnUse">
+      <circle cx="16" cy="16" r="1" fill="rgba(255,255,255,0.04)"/>
+    </pattern>
+    <!-- Glow for active arc — wide region to avoid clipping -->
+    <filter id="gC" x="-50%" y="-50%" width="200%" height="200%">
+      <feGaussianBlur stdDeviation="11" result="b"/>
+      <feMerge><feMergeNode in="b"/><feMergeNode in="SourceGraphic"/></feMerge>
+    </filter>
+  </defs>
+
+  <!-- Background -->
+  <rect width="1200" height="360" rx="24" fill="url(#bg)"/>
+  <rect width="1200" height="360" rx="24" fill="url(#dots)"/>
+
+  <!-- Atmospheric rings centred on thermostat -->
+  <circle cx="918" cy="180" r="310" fill="none" stroke="rgba(0,180,216,0.03)" stroke-width="1.5"/>
+  <circle cx="918" cy="180" r="210" fill="none" stroke="rgba(0,180,216,0.04)" stroke-width="1"/>
+
+  <!-- ═══════════════ LEFT: Typography ═══════════════ -->
+
+  <!-- Homebridge badge pill -->
+  <rect x="60" y="62" width="210" height="30" rx="15"
+    fill="rgba(73,31,89,0.55)" stroke="rgba(200,130,255,0.35)" stroke-width="1"/>
+  <circle cx="82" cy="77" r="5" fill="#c084e8"/>
+  <text x="152" y="82"
+    font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif"
+    font-size="13" fill="#c084e8" text-anchor="middle" font-weight="600" letter-spacing="0.4">
+    homebridge plugin
+  </text>
+
+  <!-- Plugin name -->
+  <text x="60" y="172"
+    font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif"
+    font-size="64" fill="white" font-weight="800" letter-spacing="-1.5">AC</text>
+  <text x="60" y="245"
+    font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif"
+    font-size="64" fill="white" font-weight="800" letter-spacing="-1.5">Freedom</text>
+
+  <!-- Subtitle -->
+  <text x="60" y="283"
+    font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif"
+    font-size="18" fill="rgba(255,255,255,0.45)">
+    AUX air conditioner control for HomeKit
+  </text>
+
+  <!-- Feature pills -->
+  <rect x="60" y="305" width="118" height="26" rx="13"
+    fill="rgba(255,255,255,0.07)" stroke="rgba(255,255,255,0.11)" stroke-width="1"/>
+  <text x="119" y="322"
+    font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif"
+    font-size="12" fill="rgba(255,255,255,0.65)" text-anchor="middle">Cloud + Local</text>
+
+  <rect x="188" y="305" width="112" height="26" rx="13"
+    fill="rgba(255,255,255,0.07)" stroke="rgba(255,255,255,0.11)" stroke-width="1"/>
+  <text x="244" y="322"
+    font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif"
+    font-size="12" fill="rgba(255,255,255,0.65)" text-anchor="middle">Fan Control</text>
+
+  <rect x="310" y="305" width="130" height="26" rx="13"
+    fill="rgba(255,255,255,0.07)" stroke="rgba(255,255,255,0.11)" stroke-width="1"/>
+  <text x="375" y="322"
+    font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif"
+    font-size="12" fill="rgba(255,255,255,0.65)" text-anchor="middle">Homebridge v2</text>
+
+  <!-- ═══════════════ RIGHT: Climate panel ═══════════════ -->
+
+  <!-- Glass panel -->
+  <rect x="690" y="38" width="456" height="284" rx="20"
+    fill="url(#panelGrad)" stroke="rgba(255,255,255,0.07)" stroke-width="1"/>
+
+  <!-- ── Thermostat dial ──
+       r=110, circumference=691.15
+       270° track = 518.4 ≈ 518  |  90° gap = 172.8 ≈ 173
+       rotate(135°) → gap centred at 6-o'clock (bottom)            -->
+
+  <!-- Outer track (dim) -->
+  <circle cx="918" cy="180" r="110"
+    fill="none" stroke="rgba(255,255,255,0.08)" stroke-width="14"
+    stroke-linecap="round" stroke-dasharray="518 173"
+    transform="rotate(135, 918, 180)"/>
+
+  <!-- Active arc glow (22 °C in 16–32 range → 37.5 % → 194 units) -->
+  <g filter="url(#gC)">
+    <circle cx="918" cy="180" r="110"
+      fill="none" stroke="#00b4d8" stroke-width="10" stroke-linecap="round"
+      stroke-dasharray="194 497" opacity="0.55"
+      transform="rotate(135, 918, 180)"/>
+  </g>
+
+  <!-- Active arc (solid, on top of glow) -->
+  <circle cx="918" cy="180" r="110"
+    fill="none" stroke="#00b4d8" stroke-width="14" stroke-linecap="round"
+    stroke-dasharray="194 497"
+    transform="rotate(135, 918, 180)"/>
+
+  <!-- Inner circle (frosted glass) -->
+  <circle cx="918" cy="180" r="88"
+    fill="rgba(13,27,62,0.55)" stroke="rgba(255,255,255,0.06)" stroke-width="1"/>
+
+  <!-- Temperature value -->
+  <text x="918" y="163"
+    font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif"
+    font-size="52" fill="white" font-weight="700" text-anchor="middle">22°</text>
+
+  <!-- Mode label -->
+  <text x="918" y="192"
+    font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif"
+    font-size="11" fill="#00b4d8" text-anchor="middle" font-weight="700" letter-spacing="3">COOL</text>
+
+  <!-- Current ambient temp -->
+  <text x="918" y="214"
+    font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif"
+    font-size="11" fill="rgba(255,255,255,0.28)" text-anchor="middle">Current 24°</text>
+
+  <!-- Fan speed label -->
+  <text x="918" y="269"
+    font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif"
+    font-size="9" fill="rgba(255,255,255,0.22)" text-anchor="middle" letter-spacing="2.5">FAN SPEED</text>
+
+  <!-- Fan speed dots: 5 dots centred at x=918, 22 px apart → start x=874 -->
+  <circle cx="874" cy="288" r="5" fill="#00b4d8"/>
+  <circle cx="896" cy="288" r="5" fill="#00b4d8" opacity="0.65"/>
+  <circle cx="918" cy="288" r="5" fill="#00b4d8" opacity="0.38"/>
+  <circle cx="940" cy="288" r="5" fill="rgba(255,255,255,0.12)"/>
+  <circle cx="962" cy="288" r="5" fill="rgba(255,255,255,0.12)"/>
+
+  <!-- ── Snowflake (upper-left of panel, x=730 y=85) ── -->
+  <!-- Arms -->
+  <line x1="730" y1="72" x2="730" y2="98" stroke="rgba(0,180,216,0.42)" stroke-width="2" stroke-linecap="round"/>
+  <line x1="717" y1="85" x2="743" y2="85" stroke="rgba(0,180,216,0.42)" stroke-width="2" stroke-linecap="round"/>
+  <line x1="721" y1="76" x2="739" y2="94" stroke="rgba(0,180,216,0.42)" stroke-width="2" stroke-linecap="round"/>
+  <line x1="739" y1="76" x2="721" y2="94" stroke="rgba(0,180,216,0.42)" stroke-width="2" stroke-linecap="round"/>
+  <!-- Branch tips — top -->
+  <line x1="730" y1="72" x2="726" y2="76" stroke="rgba(0,180,216,0.32)" stroke-width="1.5" stroke-linecap="round"/>
+  <line x1="730" y1="72" x2="734" y2="76" stroke="rgba(0,180,216,0.32)" stroke-width="1.5" stroke-linecap="round"/>
+  <!-- Branch tips — bottom -->
+  <line x1="730" y1="98" x2="726" y2="94" stroke="rgba(0,180,216,0.32)" stroke-width="1.5" stroke-linecap="round"/>
+  <line x1="730" y1="98" x2="734" y2="94" stroke="rgba(0,180,216,0.32)" stroke-width="1.5" stroke-linecap="round"/>
+  <!-- Branch tips — left -->
+  <line x1="717" y1="85" x2="721" y2="81" stroke="rgba(0,180,216,0.32)" stroke-width="1.5" stroke-linecap="round"/>
+  <line x1="717" y1="85" x2="721" y2="89" stroke="rgba(0,180,216,0.32)" stroke-width="1.5" stroke-linecap="round"/>
+  <!-- Branch tips — right -->
+  <line x1="743" y1="85" x2="739" y2="81" stroke="rgba(0,180,216,0.32)" stroke-width="1.5" stroke-linecap="round"/>
+  <line x1="743" y1="85" x2="739" y2="89" stroke="rgba(0,180,216,0.32)" stroke-width="1.5" stroke-linecap="round"/>
+
+  <!-- ── Wind lines (right of panel) ── -->
+  <line x1="1082" y1="152" x2="1128" y2="152" stroke="rgba(0,180,216,0.28)" stroke-width="2.5" stroke-linecap="round"/>
+  <line x1="1088" y1="170" x2="1134" y2="170" stroke="rgba(0,180,216,0.20)" stroke-width="2"   stroke-linecap="round"/>
+  <line x1="1078" y1="188" x2="1124" y2="188" stroke="rgba(0,180,216,0.13)" stroke-width="1.5" stroke-linecap="round"/>
+  <line x1="1085" y1="206" x2="1128" y2="206" stroke="rgba(0,180,216,0.07)" stroke-width="1"   stroke-linecap="round"/>
+</svg>

package/config.schema.json

@@ -2,6 +2,7 @@
   "pluginAlias": "AcFreedom",
   "pluginType": "platform",
   "singular": true,
+  "customUi": true,
   "headerDisplay": "AUX Air Conditioner control via Broadlink (local) or AUX Cloud API.",
   "schema": {
     "type": "object",

package/homebridge-ui/public/i18n/ar.json

@@ -0,0 +1,42 @@
+{
+  "devices": "الأجهزة",
+  "deviceName": "اسم الجهاز",
+  "connection": "الاتصال",
+  "cloud": "السحابة",
+  "local": "محلي",
+  "cloudSettings": "إعدادات السحابة",
+  "email": "البريد الإلكتروني",
+  "emailHint": "بريد حساب تطبيق AC Freedom",
+  "password": "كلمة المرور",
+  "passwordHint": "كلمة مرور تطبيق AC Freedom",
+  "region": "المنطقة",
+  "regionHint": "منطقة الخادم لحسابك",
+  "regionEu": "أوروبا",
+  "regionUsa": "الولايات المتحدة",
+  "regionCn": "الصين",
+  "regionRus": "روسيا",
+  "deviceId": "معرّف الجهاز",
+  "deviceIdOptional": "اختياري",
+  "deviceIdHint": "اتركه فارغاً للكشف التلقائي عن الجهاز الأول",
+  "localSettings": "الإعدادات المحلية",
+  "ip": "عنوان IP",
+  "ipHint": "عنوان IP المحلي للمكيف (مثال: 192.168.1.100)",
+  "mac": "عنوان MAC",
+  "macHint": "الصيغة: AA:BB:CC:DD:EE:FF",
+  "features": "الميزات",
+  "fan": "مروحة",
+  "sleep": "نوم",
+  "display": "شاشة",
+  "health": "صحة",
+  "clean": "تنظيف",
+  "eco": "اقتصادي",
+  "comfWind": "رياح مريحة",
+  "settings": "الإعدادات",
+  "tempStep": "خطوة الحرارة",
+  "tempStepHint": "أدنى تعديل لدرجة الحرارة",
+  "pollInterval": "فترة الاستطلاع (ثانية)",
+  "pollIntervalHint": "تكرار جلب حالة المكيف (5–300)",
+  "addDevice": "إضافة جهاز",
+  "remove": "إزالة",
+  "featuresHint": "للحصول على مظهر HomeKit أنيق، يُوصى بتفعيل المروحة ووضع إعداد مسبق واحد فقط — يُقترح اختيار النوم."
+}

package/homebridge-ui/public/i18n/de.json

@@ -0,0 +1,42 @@
+{
+  "devices": "Geräte",
+  "deviceName": "Gerätename",
+  "connection": "Verbindung",
+  "cloud": "Cloud",
+  "local": "Lokal",
+  "cloudSettings": "Cloud-Einstellungen",
+  "email": "E-Mail",
+  "emailHint": "E-Mail des AC Freedom App-Kontos",
+  "password": "Passwort",
+  "passwordHint": "Passwort der AC Freedom App",
+  "region": "Region",
+  "regionHint": "Server-Region Ihres Kontos",
+  "regionEu": "Europa",
+  "regionUsa": "USA",
+  "regionCn": "China",
+  "regionRus": "Russland",
+  "deviceId": "Geräte-ID",
+  "deviceIdOptional": "optional",
+  "deviceIdHint": "Leer lassen für automatische Erkennung",
+  "localSettings": "Lokale Einstellungen",
+  "ip": "IP-Adresse",
+  "ipHint": "Lokale IP des Klimageräts (z.B. 192.168.1.100)",
+  "mac": "MAC-Adresse",
+  "macHint": "Format: AA:BB:CC:DD:EE:FF",
+  "features": "Funktionen",
+  "fan": "Lüfter",
+  "sleep": "Schlaf",
+  "display": "Display",
+  "health": "Gesundheit",
+  "clean": "Reinigung",
+  "eco": "Eco",
+  "comfWind": "Komfortwind",
+  "settings": "Einstellungen",
+  "tempStep": "Temperaturschritt",
+  "tempStepHint": "Minimale Temperaturanpassung",
+  "pollInterval": "Abfrageintervall (Sekunden)",
+  "pollIntervalHint": "Wie oft der AC-Status abgerufen wird (5–300)",
+  "addDevice": "Gerät hinzufügen",
+  "remove": "Entfernen",
+  "featuresHint": "Für ein übersichtliches HomeKit-Layout wird empfohlen, nur den Lüfter und einen einzigen Voreinstellungsmodus zu aktivieren — empfohlen wird Schlaf."
+}

package/homebridge-ui/public/i18n/en.json

@@ -0,0 +1,42 @@
+{
+  "devices": "Devices",
+  "deviceName": "Device Name",
+  "connection": "Connection",
+  "cloud": "Cloud",
+  "local": "Local",
+  "cloudSettings": "Cloud Settings",
+  "email": "Email",
+  "emailHint": "AC Freedom app account email",
+  "password": "Password",
+  "passwordHint": "AC Freedom app password",
+  "region": "Region",
+  "regionHint": "Server region for your account",
+  "regionEu": "Europe",
+  "regionUsa": "USA",
+  "regionCn": "China",
+  "regionRus": "Russia",
+  "deviceId": "Device ID",
+  "deviceIdOptional": "optional",
+  "deviceIdHint": "Leave empty to auto-detect first device",
+  "localSettings": "Local Settings",
+  "ip": "IP Address",
+  "ipHint": "AC unit's local IP (e.g. 192.168.1.100)",
+  "mac": "MAC Address",
+  "macHint": "Format: AA:BB:CC:DD:EE:FF",
+  "features": "Features",
+  "fan": "Fan",
+  "sleep": "Sleep",
+  "display": "Display",
+  "health": "Health",
+  "clean": "Clean",
+  "eco": "Eco",
+  "comfWind": "Comf. Wind",
+  "settings": "Settings",
+  "tempStep": "Temperature Step",
+  "tempStepHint": "Minimum temperature adjustment increment",
+  "pollInterval": "Poll Interval (seconds)",
+  "pollIntervalHint": "How often to fetch the AC state (5–300)",
+  "addDevice": "Add Device",
+  "remove": "Remove",
+  "featuresHint": "For a clean HomeKit appearance, it is recommended to enable Fan and only one preset mode — Sleep is the suggested choice."
+}