iobroker.miele-unbound 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 meistermopper <meister.mopper@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,166 @@
+<p align="center">
+  <img src="admin/miele-unbound.png" alt="Logo" width="200" />
+</p>
+
+# ioBroker.miele-unbound
+
+[![NPM version](https://img.shields.io/npm/v/iobroker.miele-unbound.svg)](https://www.npmjs.com/package/iobroker.miele-unbound)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+*Read this in another language: [Deutsche Dokumentation](README_de.md).*
+
+A high-performance, local-first ioBroker adapter connecting modern **Miele@Home** appliances
+directly over your local area network (LAN) without continuous cloud reliance.
+
+By leveraging the local `MieleH256` / DOP2 protocol on port 80, `ioBroker.miele-unbound` provides
+sub-second state updates, maximum privacy, and complete independence from internet outages or Miele
+cloud rate limits. At the same time, it incorporates comprehensive device-type profiles and data point
+definitions for over 30 appliance classes.
+
+## Key Features
+
+- **100% Local Operation:** Speaks directly to appliance communication modules (e.g. EK037, EK057).
+- **Sub-second Response Times:** Instant state updates without third-party cloud polling delays.
+- **Rich Device Profiles:** Over 30 appliance types with dedicated states, roles, and units.
+- **Human-Readable & Raw Values:** Enriched plain-text statuses, program names, and phases.
+- **Hardware-Safe Polling:** Strict sequential request queue per appliance to prevent XKM crashes.
+- **Painless Credential Migration:** Encrypted export/import and manual entry for scratch installs.
+- **Remote Control (Opt-in):** Start, stop, pause, power, and lighting controls via DOP2 opcodes.
+
+## Quick Start & Setup Guide
+
+1. Install the adapter and create an instance.
+2. In the **Login & Pairing** tab, select your country and follow the step-by-step login below.
+3. Paste the captured `miele://...` address into the **miele:// Redirect URL** field and click **Fetch GroupKey**.
+4. Save settings. The adapter discovers your appliances and creates their states.
+
+If running in Docker with bridge networking, auto-discovery cannot receive multicast packets — enter appliance IP addresses manually on the **Appliances** tab. See [Network & Docker](#network-ports--docker).
+
+### The Login, Step by Step
+
+The final redirect address uses the `miele://` mobile app scheme. Desktop web browsers cannot handle this custom scheme, causing the browser to halt on a spinning wheel or a loading error. **This interruption is expected and indicates success.**
+
+1. **Prepare Browser DevTools:**
+   - Click **Open Login Page** (a new browser tab opens).
+   - Press **F12** (or right-click and select *Inspect*) to open Developer Tools.
+   - Switch to the **Network** tab.
+   - Ensure network requests are retained:
+     - **Chrome / Edge / Brave:** Check **Preserve log**.
+     - **Firefox:** Click the gear icon ⚙️ and check **Persist Logs**.
+2. **Sign In:**
+   - Enter your standard Miele app account email and password.
+   - Complete the sign-in. The browser will halt on a spinning circle or display a navigation error.
+3. **Copy Redirect URL:**
+   - In the DevTools **Network** tab, scroll to the last recorded request (often highlighted in red).
+   - Look for an entry starting with `redirect?redirect_uri=miele...` or `miele://oauth2-code/...`.
+   - Right-click the request ➔ **Copy** ➔ **Copy URL**.
+   - Paste the copied address into the adapter's **miele:// Redirect URL** field and click **Fetch GroupKey**.
+
+The household GroupID and GroupKey are stored in the instance configuration (with the GroupKey safely encrypted). This pairing process is only required once.
+
+### Alternative: Encrypted Backup & Manual Credentials
+
+In the **Credentials & Backup** tab, the adapter provides two flexible options for server migrations, fresh installs, or disaster recovery:
+
+#### What does "Encrypted Backup" do?
+The local `GroupKey` is the master cryptographic key granting local LAN access to all Miele appliances in your household. With the encrypted backup feature, you can safely export your credentials and migrate them to another system **without ever needing to repeat the Miele cloud login or DevTools token capture**:
+* **What is included in the backup?**
+  * The household **GroupID** and the secret **GroupKey**.
+  * All manually configured appliances and IP addresses (**Appliances table**).
+  * Creation timestamp.
+* **How is it encrypted?**
+  * Strong industry-standard **AES-256-GCM** (authenticated encryption with built-in tampering protection).
+  * Key derivation from your chosen **Passphrase** via **PBKDF2** with 100,000 rounds (SHA-256) and a cryptographically random 16-byte salt.
+  * This guarantees that your sensitive local LAN key is never exported or stored in plain text and can safely be stored in external notes or backups.
+* **Exporting:** Enter a strong passphrase ➔ click **Export Backup** ➔ copy and store the generated backup string safely.
+* **Restoring:** On a new or reinstalled instance, simply paste the backup string and enter your passphrase ➔ click **Import Backup** ➔ your credentials and manual appliance IPs are immediately restored.
+
+#### Manual Entry
+Alternatively, if you already have your household GroupID and 64-character hexadecimal GroupKey saved from a previous installation, you can paste them directly into the respective fields.
+
+## Network: Ports & Docker
+
+| Direction | Port | Purpose | Required |
+|---|---|---|---|
+| In/Out | UDP 5353 (mDNS) | Automatic LAN device discovery | For auto-discovery |
+| Outbound | TCP 80 ➔ appliances | Local DOP2/H256 polling and controls | Yes |
+| Outbound | TCP 443 ➔ miele-iot.com | Fetch initial GroupKey pairing token | One-time login only |
+
+**Docker & Bridge Networking:**
+Containers with bridge networking do not forward multicast UDP traffic. In this configuration, automatic mDNS discovery will not find appliances. You can either:
+1. Run the container with `network_mode: host` to enable multicast auto-discovery.
+2. Or enter the IP addresses of your Miele appliances manually in the **Appliances** tab.
+
+## Privacy & Local Operation
+
+The adapter operates **strictly local-first**. The one-time Miele account login only serves to retrieve the household encryption key (`GroupKey`). During normal day-to-day operation:
+- The adapter does not communicate with any cloud service.
+- No user passwords or access tokens are stored or sent anywhere.
+- Device state changes, energy metrics, and telemetry remain entirely inside your local network.
+
+## Object Hierarchy
+
+Each appliance is represented by its serial number as the device object:
+
+- **`<serial>.info`**: Reachability, technical model name, material number, firmware version, IP.
+- **`<serial>.state`**: Operating status, program ID and name, phase, remaining time, door, errors.
+- **`<serial>.sensors`**: Temperature zones, spin speeds, drying steps, battery, ventilation.
+- **`<serial>.eco`**: Targeted EcoFeedback energy (kWh/Wh), water consumption, and heating metrics.
+- **`<serial>.control`**: Remote actions (start, stop, pause, power, lighting) when enabled.
+
+## Legal Disclaimer
+
+This is an **unofficial, community-developed** project and is **not affiliated with or endorsed by [Miele & Cie. KG](https://www.miele.com/)**. "Miele", "Miele@home", and related trademarks belong to Miele & Cie. KG and are used solely for identification and compatibility purposes.
+
+The adapter utilizes local communication protocols reverse-engineered by the open-source community. Usage is at your own risk. The software is distributed under the MIT license without warranty of any kind.
+
+## Changelog
+
+### **WORK IN PROGRESS**
+- Fix auto-translate GitHub workflow by granting contents write permission
+- Add dedicated read-only backup export field with copy to clipboard button
+- Do not persist transient backup credentials on save and restore clear button adornment
+- Fix backup import by using jsonData parameter injection in jsonConfig sendTo buttons
+- Auto-populate encrypted backup to UI field with one-click copy to clipboard
+- Require password confirmation for backupPassphrase with repeat and visibility toggle
+- Remove rounded corners from adapter logo to provide seamless solid background
+- Expand setup guide with detailed step-by-step browser DevTools and Docker instructions
+- Initial development combining local MieleH256 LAN engine with device profiles
+- Added AES-256-GCM encrypted backup and restore for migrations and scratch installs
+- Implemented device profile engine covering washers, dryers, dishwashers, and ovens
+- Integrated targeted EcoFeedback readings without destructive leaf scanning
+- Fixed OAuth authorization popup and enabled messagebox communication for sendTo
+- Enhanced GroupKey pairing response with UI form sync and clean adapter unload
+- Fix mDNS discovery resolving IP addresses across multiple network interfaces
+- Persist OAuth PKCE challenge to disk to prevent CSRF state mismatch on reload
+- Display active Household GroupID directly in pairing setup tab
+- Add dynamic device route discovery and fix X-Signature response header parsing
+- Add clear button styling (contained/outlined) for all JSONConfig sendTo actions
+- Add detailed step-by-step pairing guide with browser DevTools instructions
+- Add comprehensive program mappings for all Miele appliances and modern 200-series
+- Add automated i18n translation script and full 11-language admin dictionaries
+- Add automated documentation sync script mirroring READMEs into docs/ directory
+- Redesign adapter logo featuring Miele red background and unchained emblem
+- Adjust logo display size and centering in README files
+- Expand .gitignore with IDE, OS, and package manager log exclusions
+- Clean redundant test devDependencies and update io-package dependencies
+- Add responsive breakpoint sizes in jsonConfig and deduplicate dependencies
+- Add standard integration test and re-enable integration testing in CI
+- Add release config, check-wip and manage-changelogs scripts for release automation
+- Add GitHub Actions CI/CD workflows for multi-OS testing and auto-translation
+- Add Dependabot configuration and auto-merge workflow for dependency updates
+- Add GitHub issue templates for bug reports and feature requests
+- Add iob.bat developer shortcut and devServerCli.md command reference
+- Add commitlint configuration, husky Git hooks and AI commit message helper
+- Document async robustness, hardware protection and lifecycle rules in AGENTS.md
+
+Older changelog entries can be found in [CHANGELOG_OLD.md](CHANGELOG_OLD.md).
+
+## License
+
+MIT License
+
+Copyright (c) 2026 meistermopper <meister.mopper@gmail.com>
+
+See [LICENSE](LICENSE) for more details.
+

package/README_de.md

@@ -0,0 +1,165 @@
+<p align="center">
+  <img src="admin/miele-unbound.png" alt="Logo" width="200" />
+</p>
+
+# ioBroker.miele-unbound
+
+[![NPM version](https://img.shields.io/npm/v/iobroker.miele-unbound.svg)](https://www.npmjs.com/package/iobroker.miele-unbound)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+*Hier geht es zur englischen Version: [English Documentation](README.md).*
+
+Ein leistungsfähiger, lokaler ioBroker-Adapter zur direkten Einbindung moderner **Miele@Home**-Geräte
+über das lokale Netzwerk (LAN) – komplett ohne dauerhafte Cloud-Verbindung.
+
+Durch die Nutzung des lokalen `MieleH256` / DOP2-Protokolls auf Port 80 bietet `ioBroker.miele-unbound`
+Reaktionszeiten im Millisekundenbereich, maximale Privatsphäre und Unabhängigkeit von
+Internetausfällen oder Miele-Cloud-Limits. Gleichzeitig vereint er umfassende Geräteprofile und
+exakte Datenpunkte für über 30 Geräteklassen.
+
+## Hauptmerkmale
+
+- **100 % Lokaler Betrieb:** Spricht direkt mit den WLAN-Modulen der Geräte (z. B. EK037, EK057).
+- **Schnelle Reaktionszeiten:** Sofortige Statusaktualisierungen ohne Cloud-Latenzen.
+- **Umfassende Geräteprofile:** Über 30 Gerätetypen mit spezifischen Datenpunkten, Rollen und Einheiten.
+- **Klartexte & Rohwerte:** Selbsterklärende Statustexte, Programmnamen und Phasen für VIS und Skripte.
+- **Schonendes Polling:** Strenge serielle Warteschlange je Gerät zur Vermeidung von XKM-Abstürzen.
+- **Einfache Migration:** Verschlüsselter Export/Import und Direkteingabe für Neuinstallationen.
+- **Gerätesteuerung (Opt-in):** Start, Stopp, Pause, Ein-/Ausschalten und Lichtsteuerung via DOP2.
+
+## Schnellstart & Einrichtung
+
+1. Adapter installieren und eine Instanz anlegen.
+2. Im Reiter **Anmeldung & Pairing** das Land wählen und der folgenden Schritt-für-Schritt-Anleitung folgen.
+3. Die abgefangene `miele://...`-Adresse in das Feld **miele://-Redirect-URL** einfügen und auf **GroupKey abrufen** klicken.
+4. Speichern. Der Adapter findet die Geräte im LAN und legt die Datenpunkte an.
+
+Läuft ioBroker in einem Docker-Container mit Bridge-Netzwerk, werden Multicast-Pakete nicht durchgeleitet — in diesem Fall die IP-Adressen der Geräte im Reiter **Geräte** manuell eintragen. Siehe [Netzwerk & Docker](#netzwerk--docker).
+
+### Die Anmeldung, Schritt für Schritt
+
+Die letzte Zieladresse nutzt das `miele://`-Schema der offiziellen Miele-App. Desktop-Browser können dieses Schema nicht öffnen, weshalb der Vorgang bei einem drehenden Ladekreis oder einer Fehlermeldung stehen bleibt. **Genau das ist das erwartete Zeichen für einen erfolgreichen Login.**
+
+1. **Entwicklertools vorbereiten:**
+   - Auf **Login-Seite öffnen** klicken (ein neuer Browser-Tab öffnet sich).
+   - **F12** drücken (oder Rechtsklick ➔ *Untersuchen*), um die Entwicklertools zu öffnen.
+   - Auf den Tab **Netzwerk** (Network) wechseln.
+   - Sicherstellen, dass das Netzwerkprotokoll erhalten bleibt:
+     - **Chrome / Edge / Brave:** Haken bei **Log beibehalten** (*Preserve log*) setzen.
+     - **Firefox:** Zahnrad-Symbol ⚙️ ➔ **Protokolle dauerhaft anzeigen** (*Persist Logs*) aktivieren.
+2. **Anmelden:**
+   - E-Mail-Adresse und Passwort des gewohnten Miele-App-Kontos eingeben und anmelden.
+   - Nach dem Absenden bleibt die Seite bei einem Ladekreis stehen oder meldet einen Ladefehler.
+3. **Redirect-URL kopieren:**
+   - Im Netzwerk-Tab ganz nach unten zur letzten erfassten Zeile scrollen (oft rot markiert).
+   - Nach einem Eintrag suchen, der mit `redirect?redirect_uri=miele...` oder `miele://oauth2-code/...` beginnt.
+   - Zeile mit der rechten Maustaste anklicken ➔ **Adresse kopieren** (*Copy* ➔ *Copy URL*).
+   - Die kopierte Adresse im ioBroker-Admin in das Feld **miele://-Redirect-URL** einfügen und auf **GroupKey abrufen** klicken.
+
+GroupID und GroupKey werden anschließend in der Konfiguration gespeichert (der GroupKey sicher verschlüsselt). Dieser Vorgang ist nur ein einziges Mal notwendig.
+
+### Alternative: Verschlüsseltes Backup & Manuelle Zugangsdaten
+
+Im Reiter **Zugangsdaten & Sicherung** bietet der Adapter zwei flexible Wege für Server-Umzüge, Neuinstallationen oder Sicherheitskopien:
+
+#### Was bewirkt das „Verschlüsselte Backup“?
+Der lokale `GroupKey` ist der kryptografische Generalschlüssel für die Steuerung und Statusabfrage aller Miele-Geräte in deinem Haushalt. Mit der Backup-Funktion kannst du deine Konfiguration sichern und auf ein anderes System übertragen, **ohne den Miele-Login jemals wiederholen zu müssen**:
+* **Was wird gesichert?** 
+  * Die Haushalts-**GroupID** und der geheime **GroupKey**.
+  * Alle manuell eingepflegten Geräte und IP-Adressen (**Geräte-Tabelle**).
+  * Zeitstempel der Sicherung.
+* **Wie wird verschlüsselt?** 
+  * Sicherer Industriestandard **AES-256-GCM** (authentifizierte Verschlüsselung mit Manipulationsschutz).
+  * Schlüsselableitung aus deiner gewählten **Passphrase** via **PBKDF2** mit 100.000 Runden (SHA-256) und zufälligem 16-Byte Salt.
+  * Dadurch kann der erzeugte Backup-String bedenkenlos extern abgespeichert werden, ohne dass der geheime LAN-Schlüssel im Klartext vorliegt.
+* **Exportieren:** Eigene Passphrase vergeben ➔ Klick auf **Backup exportieren** ➔ Den generierten Backup-Text kopieren und sicher aufbewahren.
+* **Wiederherstellen:** Auf der neuen oder zurückgesetzten Instanz einfach den Backup-Text und die Passphrase eingeben ➔ Klick auf **Backup importieren** ➔ Alle Zugangsdaten und manuellen IPs sind sofort wieder aktiv.
+
+#### Manuelle Eingabe
+Alternativ kannst du die Haushalts-GroupID und den 64-stelligen hexadezimalen GroupKey auch direkt aus einer Textnotiz oder einer früheren Instanz von Hand in die entsprechenden Felder eintragen.
+
+## Netzwerk & Docker
+
+| Richtung | Port | Zweck | Erforderlich |
+|---|---|---|---|
+| Ein-/Ausgehend | UDP 5353 (mDNS) | Automatische Geräteerkennung im LAN | Für Auto-Discovery |
+| Ausgehend | TCP 80 ➔ Geräte | Lokale DOP2/H256-Abfragen und Steuerbefehle | Ja |
+| Ausgehend | TCP 443 ➔ miele-iot.com | Einmaliger Abruf des GroupKeys | Nur beim Login |
+
+**Docker & Container:**
+In Containern mit Bridge-Netzwerk werden Multicast-Pakete (mDNS) nicht durchgeleitet. Die automatische Gerätesuche findet dort keine Geräte. Es gibt zwei Lösungen:
+1. Den Container mit `network_mode: host` betreiben, damit mDNS direkt funktioniert.
+2. Oder die IP-Adressen der Miele-Geräte im Reiter **Geräte** manuell eintragen.
+
+## Datenschutz & Lokaler Betrieb
+
+Der Adapter arbeitet **vollständig lokal** (*local-first*). Die einmalige Anmeldung dient ausschließlich dazu, den haushaltsweiten Verschlüsselungsschlüssel (`GroupKey`) abzurufen. Im laufenden Normalbetrieb:
+- Kommuniziert der Adapter mit keinem externen Cloud-Dienst.
+- Werden weder Passwörter noch Tokens gespeichert oder übertragen.
+- Bleiben alle Gerätezustände, Energiedaten und Steuerbefehle ausschließlich in deinem Heimnetzwerk.
+
+## Objektstruktur
+
+Jedes Gerät wird durch seine Seriennummer als Device im Objektbaum abgebildet:
+
+- **`<seriennummer>.info`**: Erreichbarkeit, Modellname, Materialnummer, Firmware-Version, IP-Adresse.
+- **`<seriennummer>.state`**: Betriebsstatus, Programm-ID und Name, Phase, Restzeiten, Tür, Fehler.
+- **`<seriennummer>.sensors`**: Temperaturzonen, Schleuderdrehzahl, Trockenstufe, Akku, Lüfterstufe.
+- **`<seriennummer>.eco`**: Gezieltes EcoFeedback für Energie (kWh/Wh), Wasserverbrauch und Heizdauer.
+- **`<seriennummer>.control`**: Steuerbefehle (Start, Stopp, Pause, Power, Licht), falls aktiviert.
+
+## Rechtliche Hinweise / Disclaimer
+
+Dies ist ein **inoffizielles, privat entwickeltes Community-Projekt** und steht in **keiner Verbindung zu der [Miele & Cie. KG](https://www.miele.com/)**. „Miele“, „Miele@home“ und zugehörige Markennamen sind eingetragene Warenzeichen der Miele & Cie. KG und werden hier ausschließlich beschreibend zur Kennzeichnung der Kompatibilität verwendet.
+
+Der Adapter nutzt ein durch Reverse Engineering offengelegtes lokales Protokoll. Die Nutzung erfolgt auf eigene Verantwortung. Die Software wird unter der MIT-Lizenz ohne jede Mängelgewähr bereitgestellt.
+
+## Changelog
+
+### **WORK IN PROGRESS**
+- Auto-Translate GitHub Workflow durch Schreibberechtigung (contents write) behoben
+- Eigenes schreibgeschütztes Export-Feld mit Kopier-Button für Zwischenablage ergänzt
+- Flüchtige Backup-Felder beim Speichern verwerfen und Leeren-Button (X) wiederherstellen
+- Backup-Import durch jsonData-Parameterübergabe in jsonConfig sendTo-Buttons behoben
+- Verschlüsseltes Backup wird direkt ins UI-Feld befüllt mit 1-Klick-Zwischenablage
+- Passwort-Bestätigung (repeat) und Sichtbarkeits-Toggle für backupPassphrase ergänzt
+- Runde Ecken aus Adapter-Logo entfernt für vollflächigen Miele-Rot-Hintergrund
+- Ausführliche Schritt-für-Schritt-Anleitung mit DevTools und Docker-Hinweisen ergänzt
+- Erstentwicklung des Crossover-Adapters mit MieleH256-Engine und Profilen
+- Verschlüsselte Sicherung und Wiederherstellung via AES-256-GCM
+- Geräteprofile für Waschmaschinen, Trockner, Spülmaschinen und Backöfen
+- Gezielte EcoFeedback-Auswertung ohne Brute-Force-Registerabfragen
+- OAuth-Autorisierungs-Popup und Messagebox-Kommunikation für Admin behoben
+- GroupKey-Pairing mit Formularübernahme und sauberem Unload optimiert
+- mDNS-Erkennung über mehrere Netzwerkschnittstellen und direkte A-Record-Abfrage
+- OAuth PKCE Challenge zwischengespeichert gegen State-Mismatch bei Neustart
+- Aktive Haushalts-GroupID wird direkt im Pairing-Tab angezeigt
+- Dynamische Geräte-Routenerkennung und X-Signature-Header-Parsing korrigiert
+- Klare Button-Gestaltung (contained/outlined) für alle JSONConfig-Aktionen
+- Detaillierte Schritt-für-Schritt-Anleitung mit Entwicklertools im Pairing-Tab
+- Vollständige Programmkataloge für alle Miele-Geräte und moderne 200er-IDs
+- Automatischer Übersetzungs-Workflow und 11 ioBroker-Sprachdateien ergänzt
+- Automatischer sync-docs Workflow spiegelt README-Dateien in docs/ Verzeichnis
+- Release-Konfiguration, check-wip und manage-changelogs Skripte ergänzt
+- Adapter-Logo mit Miele-Roten Hintergrund und Kettenglied-Emblem überarbeitet
+- Anzeigegröße und Zentrierung des Logos in den README-Dateien angepasst
+- .gitignore um Verzeichnisse, IDE- und Logdateien erweitert
+- Redundante Test-Dependencies bereinigt und Abhängigkeiten aktualisiert
+- Responsive Breakpoint-Größen in jsonConfig ergänzt und Abhängigkeiten dedupliziert
+- Standard-Integrationstest hinzugefügt und in CI reaktiviert
+- GitHub Actions CI/CD-Workflows für Multi-OS-Tests und Auto-Übersetzung ergänzt
+- Dependabot-Konfiguration und Auto-Merge-Workflow für Updates integriert
+- GitHub Issue-Templates für Fehlerberichte und Feature-Wünsche eingerichtet
+- iob.bat Entwickler-Shortcut und devServerCli.md Befehlsreferenz ergänzt
+- Commitlint-Konfiguration, Husky Git-Hooks und KI-Commit-Helfer ergänzt
+- Regeln für asynchrone Robustheit, Hardware-Schutz und Lifecycle in AGENTS.md
+
+Ältere Changelog-Einträge sind in [CHANGELOG_OLD.md](CHANGELOG_OLD.md) zu finden.
+
+## Lizenz
+
+MIT License
+
+Copyright (c) 2026 meistermopper <meister.mopper@gmail.com>
+
+Weitere Details siehe [LICENSE](LICENSE).

package/admin/i18n/de.json

@@ -0,0 +1,49 @@
+{
+  "Active Poll Interval (Seconds)": "Aktives Abfrageintervall (Sekunden)",
+  "Allow remote control commands (Start, Stop, Pause, Power, Light)": "Steuerbefehle zulassen (Start, Stop, Pause, Power, Licht)",
+  "Appliances": "Geräte & Netzwerk",
+  "Auto-Discovery via mDNS (_mieleathome._tcp)": "Automatische Geräteerkennung via mDNS (_mieleathome._tcp)",
+  "Country": "Land",
+  "Credentials & Backup": "Schlüssel & Datensicherung",
+  "EcoFeedback & Measurement": "EcoFeedback & Energiemessung",
+  "Enable EcoFeedback readings (Water & Energy)": "EcoFeedback-Abfragen aktivieren (Wasser & Strom)",
+  "Enable automatic detection on the local network (may not work across Docker bridge)": "Automatische Erkennung im Heimnetz aktivieren (funktioniert meist nicht über Docker-Bridge hinweg)",
+  "Encrypted Backup Data (Paste here to restore)": "Verschlüsselte Backup-Daten (zum Wiederherstellen hier einfügen)",
+  "Encrypted Export & Import (AES-256-GCM)": "Verschlüsselter Export & Import (AES-256-GCM)",
+  "Export Encrypted Backup": "Verschlüsseltes Backup erstellen",
+  "Fetch GroupKey": "GroupKey abrufen",
+  "Household Credentials (GroupId & GroupKey)": "Haushalts-Zugangsdaten (GroupId & GroupKey)",
+  "Household GroupID": "Haushalts-GroupID",
+  "Household GroupKey (64 Bytes Hex)": "Haushalts-GroupKey (64 Byte Hex)",
+  "Idle Poll Interval (Seconds)": "Ruhe-Abfrageintervall (Sekunden)",
+  "Import / Restore": "Importieren / Wiederherstellen",
+  "Interval when a machine is running or programmed (Recommended: 5)": "Intervall während ein Programm läuft oder programmiert ist (Empfohlen: 5 s)",
+  "Interval when machines are switched off or on standby (Recommended: 20-30)": "Intervall wenn Geräte ausgeschaltet oder im Standby sind (Empfohlen: 20-30 s)",
+  "Login & Pairing": "Anmeldung & Pairing",
+  "Master Passphrase for Encryption/Decryption": "Master-Passwort zur Ver-/Entschlüsselung",
+  "Miele Account Pairing (One-time Setup)": "Miele-Konto koppeln (Einmalige Einrichtung)",
+  "Network & Appliances": "Netzwerk & Geräte",
+  "Open Login Page": "Login-Seite öffnen",
+  "Paste the captured miele:// or redirect URL here": "Hier die abgefangene miele:// oder redirect-URL einfügen",
+  "Polling & Intervals": "Abfrageintervalle",
+  "Reads targeted DOP2 registers where supported without brute-force scanning": "Liest gezielte Register nur bei verifizierten Geräten ohne belastende Dauerscans",
+  "Remote Appliance Control": "Gerätesteuerung (Remote Control)",
+  "Settings": "Einstellungen",
+  "Static IP Addresses (e.g. for Docker / VLAN)": "Feste IP-Adressen (z. B. für Docker oder getrennte VLANs)",
+  "Text State Language": "Sprache der Klartext-Datenpunkte",
+  "WARNING: Only works if MobileStart is physically enabled on the machine": "HINWEIS: Funktioniert nur, wenn 'MobileStart' / Fernsteuerung am Gerät aktiviert ist",
+  "backup_desc": "Erstelle ein passwortgeschütztes Backup deiner Zugangsdaten und Geräte. Die Export-Zeichenkette kann gefahrlos aufbewahrt werden, da sie ohne dein Master-Passwort unlesbar ist.",
+  "credentials_desc": "Diese beiden Schlüssel werden jedem Haushalt einmalig zugewiesen und ändern sich nicht. Du kannst sie kopieren und in deinem Passwortmanager sichern oder hier manuell eintragen (z. B. nach einer Neuinstallation).",
+  "miele:// redirect URL": "miele:// Weiterleitungs-URL",
+  "pairing_instruction": "Die einmalige Anmeldung dient nur dazu, den haushaltsweiten Schlüssel (GroupID und GroupKey) zu erhalten. Danach arbeitet der Adapter 100% lokal ohne Internet. 1. Klicke auf 'Login-Seite öffnen' (DevTools F12 / Netzwerk-Tab geöffnet halten). 2. Melde dich mit deinen Miele-App-Zugangsdaten an. 3. Kopiere die Zieladresse ('miele://...' oder '.../redirect?...') und füge sie unten ein.",
+  "pairing_status_info": "Status: Nach dem Klick auf 'GroupKey abrufen' werden GroupID und GroupKey automatisch eingetragen und verschlüsselt gespeichert.",
+  "step1_header": "Schritt 1: Entwicklertools im Browser vorbereiten",
+  "step1_text": "1. Oben auf „Login-Seite öffnen“ klicken (ein neuer Browser-Tab öffnet sich).\n2. Im neuen Tab Taste F12 drücken und auf den Reiter „Netzwerk“ (Network) wechseln.\n3. Protokollierung dauerhaft aktivieren:\n   • Chrome / Edge / Brave: Haken bei „Log beibehalten“ (Preserve log) setzen.\n   • Firefox: Zahnrad ⚙️ ➔ „Protokolle dauerhaft anzeigen“ (Persist Logs) aktivieren.",
+  "step2_header": "Schritt 2: Bei Miele anmelden",
+  "step2_text": "1. E-Mail und Passwort deines Miele-App-Kontos eingeben und auf „Anmelden“ klicken.\n2. Wichtig: Nach dem Login bleibt die Seite bei einem sich drehenden Laderad stehen (oder meldet einen Fehler). Das ist völlig normal und bedeutet, dass die Anmeldung erfolgreich war!",
+  "step3_header": "Schritt 3: Weiterleitungs-URL kopieren & GroupKey abrufen",
+  "step3_text": "1. Im Netzwerk-Tab (F12) ganz nach unten zur letzten (meist rot markierten) Zeile scrollen. Sie beginnt mit „redirect?redirect_uri=miele...“ oder „miele://oauth2-code/...“.\n2. Rechtsklick auf diese Zeile ➔ „URL kopieren“ (bzw. „Adresse des Links kopieren“).\n3. Die kopierte Adresse unten in das Feld einfügen und auf „GroupKey abrufen“ klicken.",
+  "backup_note": "⚠️ WICHTIG: Sichere die Backup-Zeichenkette in deinem Passwortmanager! Aus Sicherheitsgründen wird sie nach dem Speichern und Schließen hier nicht mehr angezeigt.",
+  "Exported Backup String (Click icon to copy to clipboard)": "Exportierte Backup-Zeichenkette (Icon zum Kopieren anklicken)",
+  "Restore Backup": "Backup wiederherstellen"
+}

package/admin/i18n/en.json

@@ -0,0 +1,49 @@
+{
+  "Login & Pairing": "Login & Pairing",
+  "Miele Account Pairing (One-time Setup)": "Miele Account Pairing (One-time Setup)",
+  "pairing_instruction": "The one-time login only serves to obtain the household-wide key (GroupID and GroupKey). After that, the adapter runs 100% locally without the internet. 1. Click 'Open Login Page' (keep DevTools F12 / Network tab open). 2. Sign in with your Miele app account. 3. Copy the destination URL ('miele://...' or '.../redirect?...') and paste it below.",
+  "Country": "Country",
+  "Open Login Page": "Open Login Page",
+  "miele:// redirect URL": "miele:// redirect URL",
+  "Paste the captured miele:// or redirect URL here": "Paste the captured miele:// or redirect URL here",
+  "Fetch GroupKey": "Fetch GroupKey",
+  "pairing_status_info": "Status: Clicking 'Fetch GroupKey' automatically populates and encrypts your GroupID and GroupKey.",
+  "Credentials & Backup": "Credentials & Backup",
+  "Household Credentials (GroupId & GroupKey)": "Household Credentials (GroupId & GroupKey)",
+  "credentials_desc": "These two keys are assigned once per household and do not change. You can copy them to your password manager or enter them manually here (e.g. after a scratch install).",
+  "Household GroupID": "Household GroupID",
+  "Household GroupKey (64 Bytes Hex)": "Household GroupKey (64 Bytes Hex)",
+  "Encrypted Export & Import (AES-256-GCM)": "Encrypted Export & Import (AES-256-GCM)",
+  "backup_desc": "Create a password-protected backup of your credentials and device list. The exported data string can be safely stored anywhere, as it cannot be read without your master passphrase.",
+  "Master Passphrase for Encryption/Decryption": "Master Passphrase for Encryption/Decryption",
+  "Export Encrypted Backup": "Export Encrypted Backup",
+  "Encrypted Backup Data (Paste here to restore)": "Encrypted Backup Data (Paste here to restore)",
+  "Import / Restore": "Import / Restore",
+  "Appliances": "Appliances",
+  "Network & Appliances": "Network & Appliances",
+  "Auto-Discovery via mDNS (_mieleathome._tcp)": "Auto-Discovery via mDNS (_mieleathome._tcp)",
+  "Enable automatic detection on the local network (may not work across Docker bridge)": "Enable automatic detection on the local network (may not work across Docker bridge)",
+  "Static IP Addresses (e.g. for Docker / VLAN)": "Static IP Addresses (e.g. for Docker / VLAN)",
+  "Settings": "Settings",
+  "Polling & Intervals": "Polling & Intervals",
+  "Active Poll Interval (Seconds)": "Active Poll Interval (Seconds)",
+  "Interval when a machine is running or programmed (Recommended: 5)": "Interval when a machine is running or programmed (Recommended: 5)",
+  "Idle Poll Interval (Seconds)": "Idle Poll Interval (Seconds)",
+  "Interval when machines are switched off or on standby (Recommended: 20-30)": "Interval when machines are switched off or on standby (Recommended: 20-30)",
+  "Text State Language": "Text State Language",
+  "EcoFeedback & Measurement": "EcoFeedback & Measurement",
+  "Enable EcoFeedback readings (Water & Energy)": "Enable EcoFeedback readings (Water & Energy)",
+  "Reads targeted DOP2 registers where supported without brute-force scanning": "Reads targeted DOP2 registers where supported without brute-force scanning",
+  "Remote Appliance Control": "Remote Appliance Control",
+  "Allow remote control commands (Start, Stop, Pause, Power, Light)": "Allow remote control commands (Start, Stop, Pause, Power, Light)",
+  "WARNING: Only works if MobileStart is physically enabled on the machine": "WARNING: Only works if MobileStart is physically enabled on the machine",
+  "step1_header": "Step 1: Prepare browser developer tools",
+  "step1_text": "1. Click 'Open Login Page' above (a new browser tab opens).\n2. In the new tab, press F12 and switch to the 'Network' tab.\n3. Enable persistent logging:\n   • Chrome / Edge / Brave: Check 'Preserve log'.\n   • Firefox: Click gear ⚙️ ➔ check 'Persist Logs'.",
+  "step2_header": "Step 2: Sign in with Miele",
+  "step2_text": "1. Enter your Miele app account email and password and click 'Sign in'.\n2. Note: After login, the page will hang on a spinning loading wheel (or show an error). This is completely normal and indicates success!",
+  "step3_header": "Step 3: Copy redirect URL & fetch GroupKey",
+  "step3_text": "1. In the Network tab (F12), scroll to the very last (often red) request starting with 'redirect?redirect_uri=miele...' or 'miele://oauth2-code/...'.\n2. Right-click that entry ➔ 'Copy URL' / 'Copy link address'.\n3. Paste the captured address into the field below and click 'Fetch GroupKey'.",
+  "backup_note": "⚠️ IMPORTANT: Save this backup string to your password manager now! For security reasons, it is not stored permanently and will disappear after saving and closing.",
+  "Exported Backup String (Click icon to copy to clipboard)": "Exported Backup String (Click icon to copy to clipboard)",
+  "Restore Backup": "Restore Backup"
+}

package/admin/i18n/es.json

@@ -0,0 +1,49 @@
+{
+  "Active Poll Interval (Seconds)": "Intervalo de encuesta activa (segundos)",
+  "Allow remote control commands (Start, Stop, Pause, Power, Light)": "Permitir comandos de control remoto (Inicio, Parada, Pausa, Encendido, Luz)",
+  "Appliances": "Accesorios",
+  "Auto-Discovery via mDNS (_mieleathome._tcp)": "Descubrimiento automático a través de mDNS (_mieleathome._tcp)",
+  "Country": "País",
+  "Credentials & Backup": "Credenciales y copia de seguridad",
+  "EcoFeedback & Measurement": "EcoRetroalimentación y Medición",
+  "Enable EcoFeedback readings (Water & Energy)": "Habilitar lecturas de EcoFeedback (Agua y Energía)",
+  "Enable automatic detection on the local network (may not work across Docker bridge)": "Habilite la detección automática en la red local (es posible que no funcione en el puente Docker)",
+  "Encrypted Backup Data (Paste here to restore)": "Datos de copia de seguridad cifrados (pegue aquí para restaurar)",
+  "Encrypted Export & Import (AES-256-GCM)": "Exportación e importación cifradas (AES-256-GCM)",
+  "Export Encrypted Backup": "Exportar copia de seguridad cifrada",
+  "Fetch GroupKey": "Obtener clave de grupo",
+  "Household Credentials (GroupId & GroupKey)": "Credenciales del hogar (Id. de grupo y clave de grupo)",
+  "Household GroupID": "ID de grupo del hogar",
+  "Household GroupKey (64 Bytes Hex)": "Clave de grupo del hogar (64 bytes hexadecimal)",
+  "Idle Poll Interval (Seconds)": "Intervalo de sondeo inactivo (segundos)",
+  "Import / Restore": "Importar/Restaurar",
+  "Interval when a machine is running or programmed (Recommended: 5)": "Intervalo cuando una máquina está en funcionamiento o programada (Recomendado: 5)",
+  "Interval when machines are switched off or on standby (Recommended: 20-30)": "Intervalo en el que las máquinas están apagadas o en standby (Recomendado: 20-30)",
+  "Login & Pairing": "Iniciar sesión y emparejar",
+  "Master Passphrase for Encryption/Decryption": "Frase de contraseña maestra para cifrado/descifrado",
+  "Miele Account Pairing (One-time Setup)": "Emparejamiento de cuentas Miele (configuración única)",
+  "Network & Appliances": "Redes y electrodomésticos",
+  "Open Login Page": "Abrir página de inicio de sesión",
+  "Paste the captured miele:// or redirect URL here": "Pegue el miele:// capturado o redireccione la URL aquí",
+  "Polling & Intervals": "Sondeos e intervalos",
+  "Reads targeted DOP2 registers where supported without brute-force scanning": "Lee registros DOP2 específicos cuando son compatibles sin escaneo de fuerza bruta",
+  "Remote Appliance Control": "Control remoto de dispositivos",
+  "Settings": "Ajustes",
+  "Static IP Addresses (e.g. for Docker / VLAN)": "Direcciones IP estáticas (por ejemplo, para Docker/VLAN)",
+  "Text State Language": "Idioma del estado del texto",
+  "WARNING: Only works if MobileStart is physically enabled on the machine": "ADVERTENCIA: Solo funciona si MobileStart está físicamente habilitado en la máquina",
+  "backup_desc": "Cree una copia de seguridad protegida con contraseña de sus credenciales y lista de dispositivos. La cadena de datos exportada se puede almacenar de forma segura en cualquier lugar, ya que no se puede leer sin su frase de contraseña maestra.",
+  "credentials_desc": "Estas dos claves se asignan una vez por hogar y no cambian. Puede copiarlos a su administrador de contraseñas o ingresarlos manualmente aquí (por ejemplo, después de una instalación desde cero).",
+  "miele:// redirect URL": "miele:// URL de redireccionamiento",
+  "pairing_instruction": "El inicio de sesión único sólo sirve para obtener la clave de todo el hogar (GroupID y GroupKey). Después de eso, el adaptador funciona 100% localmente sin Internet. 1. Haga clic en 'Abrir página de inicio de sesión' (mantenga abierta la pestaña DevTools F12/Red). 2. Inicie sesión con su cuenta de la aplicación Miele. 3. Copie la URL de destino ('miele://...' o '.../redirect?...') y péguela a continuación.",
+  "pairing_status_info": "Estado: Al hacer clic en 'Obtener clave de grupo', se completa y cifra automáticamente su ID de grupo y clave de grupo.",
+  "step1_header": "Paso 1: preparar las herramientas de desarrollo del navegador",
+  "step1_text": "1. Haga clic en 'Abrir página de inicio de sesión' arriba (se abre una nueva pestaña del navegador).\n2. En la nueva pestaña, presione F12 y cambie a la pestaña 'Red'.\n3. Habilite el registro persistente:\n   • Chrome/Edge/Brave: marque 'Conservar registro'.\n   • Firefox: haga clic en el engranaje ⚙️ ➔ marque 'Persistir registros'.",
+  "step2_header": "Paso 2: Inicia sesión con Miele",
+  "step2_text": "1. Ingrese el correo electrónico y la contraseña de su cuenta de la aplicación Miele y haga clic en \"Iniciar sesión\".\n2. Nota: Después de iniciar sesión, la página se colgará en una rueda de carga giratoria (o mostrará un error). ¡Esto es completamente normal e indica éxito!",
+  "step3_header": "Paso 3: copie la URL de redireccionamiento y obtenga GroupKey",
+  "step3_text": "1. En la pestaña Red (F12), desplácese hasta la última solicitud (a menudo roja) que comienza con 'redirect?redirect_uri=miele...' o 'miele://oauth2-code/...'.\n2. Haga clic derecho en esa entrada ➔ 'Copiar URL' / 'Copiar dirección de enlace'.\n3. Pegue la dirección capturada en el campo siguiente y haga clic en 'Obtener clave de grupo'.",
+  "backup_note": "⚠️ IMPORTANTE: ¡Guarde esta cadena de copia de seguridad en su gestor de contraseñas! Por razones de seguridad, no se almacena de forma permanente y desaparecerá después de guardar y cerrar.",
+  "Exported Backup String (Click icon to copy to clipboard)": "Cadena de copia de seguridad exportada (Haga clic en el icono para copiar al portapapeles)",
+  "Restore Backup": "Restaurar copia de seguridad"
+}

package/admin/i18n/fr.json

@@ -0,0 +1,49 @@
+{
+  "Active Poll Interval (Seconds)": "Intervalle d'interrogation active (secondes)",
+  "Allow remote control commands (Start, Stop, Pause, Power, Light)": "Autoriser les commandes de télécommande (Démarrer, Arrêter, Pause, Alimentation, Lumière)",
+  "Appliances": "Appareils électroménagers",
+  "Auto-Discovery via mDNS (_mieleathome._tcp)": "Découverte automatique via mDNS (_mieleathome._tcp)",
+  "Country": "Pays",
+  "Credentials & Backup": "Identifiants et sauvegarde",
+  "EcoFeedback & Measurement": "EcoFeedback & Mesure",
+  "Enable EcoFeedback readings (Water & Energy)": "Activer les lectures EcoFeedback (Eau et Énergie)",
+  "Enable automatic detection on the local network (may not work across Docker bridge)": "Activer la détection automatique sur le réseau local (peut ne pas fonctionner sur le pont Docker)",
+  "Encrypted Backup Data (Paste here to restore)": "Données de sauvegarde cryptées (Coller ici pour restaurer)",
+  "Encrypted Export & Import (AES-256-GCM)": "Exportation et importation cryptées (AES-256-GCM)",
+  "Export Encrypted Backup": "Exporter une sauvegarde chiffrée",
+  "Fetch GroupKey": "Récupérer la clé de groupe",
+  "Household Credentials (GroupId & GroupKey)": "Informations d'identification du foyer (GroupId et GroupKey)",
+  "Household GroupID": "ID de groupe de foyer",
+  "Household GroupKey (64 Bytes Hex)": "Clé de groupe de foyer (64 octets hexadécimaux)",
+  "Idle Poll Interval (Seconds)": "Intervalle d'interrogation en veille (secondes)",
+  "Import / Restore": "Importer / Restaurer",
+  "Interval when a machine is running or programmed (Recommended: 5)": "Intervalle pendant lequel une machine est en marche ou programmée (Recommandé : 5)",
+  "Interval when machines are switched off or on standby (Recommended: 20-30)": "Intervalle lorsque les machines sont éteintes ou en veille (Recommandé : 20-30)",
+  "Login & Pairing": "Connexion et couplage",
+  "Master Passphrase for Encryption/Decryption": "Phrase secrète principale pour le cryptage/déchiffrement",
+  "Miele Account Pairing (One-time Setup)": "Couplage de compte Miele (configuration unique)",
+  "Network & Appliances": "Réseau et appareils électroménagers",
+  "Open Login Page": "Ouvrir la page de connexion",
+  "Paste the captured miele:// or redirect URL here": "Collez le miele:// capturé ou l'URL de redirection ici",
+  "Polling & Intervals": "Sondages et intervalles",
+  "Reads targeted DOP2 registers where supported without brute-force scanning": "Lit les registres DOP2 ciblés là où ils sont pris en charge sans analyse par force brute",
+  "Remote Appliance Control": "Contrôle des appareils à distance",
+  "Settings": "Paramètres",
+  "Static IP Addresses (e.g. for Docker / VLAN)": "Adresses IP statiques (par exemple pour Docker / VLAN)",
+  "Text State Language": "Langue d'état du texte",
+  "WARNING: Only works if MobileStart is physically enabled on the machine": "AVERTISSEMENT : fonctionne uniquement si MobileStart est physiquement activé sur la machine",
+  "backup_desc": "Créez une sauvegarde protégée par mot de passe de vos informations d'identification et de votre liste d'appareils. La chaîne de données exportée peut être stockée en toute sécurité n'importe où, car elle ne peut pas être lue sans votre phrase secrète principale.",
+  "credentials_desc": "Ces deux clés sont attribuées une fois par foyer et ne changent pas. Vous pouvez les copier dans votre gestionnaire de mots de passe ou les saisir manuellement ici (par exemple après une installation temporaire).",
+  "miele:// redirect URL": "miele://URL de redirection",
+  "pairing_instruction": "La connexion unique sert uniquement à obtenir la clé du foyer (GroupID et GroupKey). Après cela, l'adaptateur fonctionne à 100 % localement sans Internet. 1. Cliquez sur « Ouvrir la page de connexion » (gardez l'onglet DevTools F12 / Réseau ouvert). 2. Connectez-vous avec votre compte d'application Miele. 3. Copiez l'URL de destination (\"miele://...\" ou \".../redirect?...\") et collez-la ci-dessous.",
+  "pairing_status_info": "Statut : Cliquer sur « Récupérer GroupKey » remplit et crypte automatiquement votre GroupID et GroupKey.",
+  "step1_header": "Étape 1 : Préparer les outils de développement du navigateur",
+  "step1_text": "1. Cliquez sur « Ouvrir la page de connexion » ci-dessus (un nouvel onglet de navigateur s'ouvre).\n2. Dans le nouvel onglet, appuyez sur F12 et passez à l'onglet « Réseau ».\n3. Activez la journalisation persistante :\n   • Chrome / Edge / Brave : cochez « Conserver le journal ».\n   • Firefox : cliquez sur l'engrenage ⚙️ ➔ cochez « Conserver les journaux ».",
+  "step2_header": "Étape 2 : Connectez-vous avec Miele",
+  "step2_text": "1. Saisissez l'e-mail et le mot de passe de votre compte d'application Miele et cliquez sur « Se connecter ».\n2. Remarque : Après la connexion, la page se bloquera sur une roue de chargement en rotation (ou affichera une erreur). C'est tout à fait normal et cela indique un succès !",
+  "step3_header": "Étape 3 : Copiez l'URL de redirection et récupérez GroupKey",
+  "step3_text": "1. Dans l'onglet Réseau (F12), faites défiler jusqu'à la toute dernière requête (souvent rouge) commençant par 'redirect?redirect_uri=miele...' ou 'miele://oauth2-code/...'.\n2. Cliquez avec le bouton droit sur cette entrée ➔ « Copier l'URL » / « Copier l'adresse du lien ».\n3. Collez l'adresse capturée dans le champ ci-dessous et cliquez sur « Récupérer la clé de groupe ».",
+  "backup_note": "⚠️ IMPORTANT : Enregistrez cette chaîne de sauvegarde dans votre gestionnaire de mots de passe ! Pour des raisons de sécurité, elle n'est pas conservée de manière permanente et disparaîtra après l'enregistrement et la fermeture.",
+  "Exported Backup String (Click icon to copy to clipboard)": "Chaîne de sauvegarde exportée (Cliquez sur l'icône pour copier dans le presse-papiers)",
+  "Restore Backup": "Restaurer la sauvegarde"
+}

package/admin/i18n/it.json

@@ -0,0 +1,49 @@
+{
+  "Active Poll Interval (Seconds)": "Intervallo di polling attivo (secondi)",
+  "Allow remote control commands (Start, Stop, Pause, Power, Light)": "Consenti comandi da telecomando (Avvio, Stop, Pausa, Accensione, Luce)",
+  "Appliances": "Elettrodomestici",
+  "Auto-Discovery via mDNS (_mieleathome._tcp)": "Rilevamento automatico tramite mDNS (_mieleathome._tcp)",
+  "Country": "Paese",
+  "Credentials & Backup": "Credenziali e backup",
+  "EcoFeedback & Measurement": "EcoFeedback e misurazione",
+  "Enable EcoFeedback readings (Water & Energy)": "Abilita letture EcoFeedback (Acqua ed Energia)",
+  "Enable automatic detection on the local network (may not work across Docker bridge)": "Abilita il rilevamento automatico sulla rete locale (potrebbe non funzionare sul bridge Docker)",
+  "Encrypted Backup Data (Paste here to restore)": "Dati di backup crittografati (incolla qui per ripristinare)",
+  "Encrypted Export & Import (AES-256-GCM)": "Esportazione e importazione crittografate (AES-256-GCM)",
+  "Export Encrypted Backup": "Esporta backup crittografato",
+  "Fetch GroupKey": "Recupera GroupKey",
+  "Household Credentials (GroupId & GroupKey)": "Credenziali del nucleo familiare (GroupId e GroupKey)",
+  "Household GroupID": "ID gruppo famiglia",
+  "Household GroupKey (64 Bytes Hex)": "Chiave gruppo famiglia (64 byte esadecimali)",
+  "Idle Poll Interval (Seconds)": "Intervallo di polling inattivo (secondi)",
+  "Import / Restore": "Importa/Ripristina",
+  "Interval when a machine is running or programmed (Recommended: 5)": "Intervallo in cui una macchina è in funzione o programmata (consigliato: 5)",
+  "Interval when machines are switched off or on standby (Recommended: 20-30)": "Intervallo di spegnimento o stand-by delle macchine (consigliato: 20-30)",
+  "Login & Pairing": "Accesso e abbinamento",
+  "Master Passphrase for Encryption/Decryption": "Passphrase principale per la crittografia/decrittografia",
+  "Miele Account Pairing (One-time Setup)": "Associazione all'account Miele (configurazione unica)",
+  "Network & Appliances": "Rete ed elettrodomestici",
+  "Open Login Page": "Apri la pagina di accesso",
+  "Paste the captured miele:// or redirect URL here": "Incolla qui il miele:// catturato o l'URL di reindirizzamento",
+  "Polling & Intervals": "Polling e intervalli",
+  "Reads targeted DOP2 registers where supported without brute-force scanning": "Legge i registri DOP2 mirati dove supportato senza scansione a forza bruta",
+  "Remote Appliance Control": "Controllo remoto degli apparecchi",
+  "Settings": "Impostazioni",
+  "Static IP Addresses (e.g. for Docker / VLAN)": "Indirizzi IP statici (ad es. per Docker / VLAN)",
+  "Text State Language": "Lingua di stato del testo",
+  "WARNING: Only works if MobileStart is physically enabled on the machine": "ATTENZIONE: funziona solo se MobileStart è fisicamente abilitato sulla macchina",
+  "backup_desc": "Crea un backup protetto da password delle tue credenziali e dell'elenco dei dispositivi. La stringa di dati esportata può essere archiviata in modo sicuro ovunque, poiché non può essere letta senza la passphrase principale.",
+  "credentials_desc": "Queste due chiavi vengono assegnate una volta per nucleo familiare e non cambiano. Puoi copiarli nel tuo gestore di password o inserirli manualmente qui (ad esempio dopo un'installazione zero).",
+  "miele:// redirect URL": "miele://URL di reindirizzamento",
+  "pairing_instruction": "Il login unico serve solo per ottenere la chiave domestica (GroupID e GroupKey). Successivamente, l'adattatore funziona al 100% localmente senza Internet. 1. Fare clic su \"Apri pagina di accesso\" (mantenere aperta la scheda DevTools F12/Rete). 2. Accedi con il tuo account dell'app Miele. 3. Copia l'URL di destinazione ('miele://...' o '.../redirect?...') e incollalo qui sotto.",
+  "pairing_status_info": "Stato: facendo clic su \"Recupera GroupKey\" si popolano e crittografano automaticamente GroupID e GroupKey.",
+  "step1_header": "Passaggio 1: preparare gli strumenti per sviluppatori del browser",
+  "step1_text": "1. Fai clic su \"Apri pagina di accesso\" in alto (si apre una nuova scheda del browser).\n2. Nella nuova scheda, premere F12 e passare alla scheda \"Rete\".\n3. Abilita la registrazione persistente:\n   • Chrome/Edge/Brave: seleziona 'Conserva registro'.\n   • Firefox: fai clic sull'ingranaggio ⚙️ ➔ seleziona \"Mantieni registri\".",
+  "step2_header": "Passaggio 2: accedi con Miele",
+  "step2_text": "1. Inserisci l'e-mail e la password del tuo account dell'app Miele e fai clic su \"Accedi\".\n2. Nota: dopo l'accesso, la pagina si bloccherà su una rotella di caricamento che gira (o mostrerà un errore). Questo è del tutto normale e indica il successo!",
+  "step3_header": "Passaggio 3: copia l'URL di reindirizzamento e recupera GroupKey",
+  "step3_text": "1. Nella scheda Rete (F12), scorri fino all'ultima richiesta (spesso rossa) che inizia con 'redirect?redirect_uri=miele...' o 'miele://oauth2-code/...'.\n2. Fare clic con il pulsante destro del mouse sulla voce ➔ \"Copia URL\" / \"Copia indirizzo collegamento\".\n3. Incolla l'indirizzo catturato nel campo sottostante e fai clic su \"Recupera GroupKey\".",
+  "backup_note": "⚠️ IMPORTANTE: Salva questa stringa di backup nel tuo gestore di password! Per motivi di sicurezza, non viene memorizzata in modo permanente e scomparirà dopo il salvataggio e la chiusura.",
+  "Exported Backup String (Click icon to copy to clipboard)": "Stringa di backup esportata (Fai clic sull'icona per copiare negli appunti)",
+  "Restore Backup": "Ripristina backup"
+}