iobroker.miele-local 0.2.1 → 0.3.5

package/CHANGELOG_OLD.md

@@ -0,0 +1,7 @@
+# Older changes
+
+## 0.1.1 (2026-08-17)
+* (Immanuel) Released via GitHub Actions with npm provenance (trusted publishing). Published under former package name `iobroker.miele-lokal`.
+
+## 0.1.0 (2026-08-17)
+* (Immanuel) Initial release: login/GroupKey retrieval, mDNS discovery, state polling with enum decoding, optional SuperVision push, optional control. Published under former package name `iobroker.miele-lokal`.

package/README.md

@@ -5,6 +5,8 @@
 [![NPM version](https://img.shields.io/npm/v/iobroker.miele-local.svg)](https://www.npmjs.com/package/iobroker.miele-local)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
+*Read this in another language: [Deutsche Dokumentation](README_de.md).*
+
 This adapter connects modern **Miele@Home** appliances **locally, without the internet**.
 It speaks the local Miele protocol (`MieleH256` / DOP2) directly over the LAN — no cloud
 account during operation, no detour through the Miele 3rd-party API.
@@ -29,29 +31,28 @@ account during operation, no detour through the Miele 3rd-party API.
 ## Installation
 
 1. Install the adapter and create an instance.
-2. On the **Login** tab, choose your country and click **Open login page** — sign in with
-   your Miele account in the browser. At the end the browser is redirected to a
-   `miele://…` address (which fails to open — that is expected); copy that full address.
-3. Paste the `miele://…` address and click **Fetch GroupKey**. GroupID/GroupKey are stored
-   (GroupKey encrypted).
-4. Save. The adapter discovers the devices via mDNS and creates the states.
-
-### Capturing the redirect URL
-
-The browser cannot open the final `miele://` address itself — that is expected. You obtain
-the full address (`miele://oauth2-code/?code=…&state=…`) as follows — **one method is
-enough**:
-
-- **Easy — via the "Open with" dialog:** When the browser asks to open the address "with an
-  application", it hands the complete `miele://` address to that app. If you open it with a
-  text editor (Linux: kate/gedit; Windows: Notepad; macOS: TextEdit), the full address
-  appears in the title/file name or in the text — copy it from there. You can cancel the
-  actual open action.
-- **Reliable — via DevTools:** Open DevTools before logging in (F12) → tab "Network",
-  enable "Preserve log". After logging in, find the last request whose address begins with
-  `miele://` or contains `…/de/redirect?…&code=…` → right-click → "Copy link address".
-
-Both yield the same text with `code=` and `state=`; the adapter accepts both forms.
+2. On the **Login** tab, choose your country and follow the 3-step login guide below.
+3. Paste the captured `miele://…` redirect address and click **Fetch GroupKey**. GroupID and
+   GroupKey are stored securely (GroupKey encrypted).
+4. Save. The adapter discovers your devices and creates the states.
+
+### Step-by-step: Capturing the redirect URL
+
+Because the final `miele://` address is a custom mobile-app scheme, desktop browsers cannot open
+it automatically and will hang on a spinning wheel. Capture the URL using browser DevTools:
+
+1. **Prepare DevTools:** Click **Open login page** to open the Miele login in a new tab. In that
+   new tab, press **F12** to open Developer Tools and switch to the **Network** tab. Enable
+   persistent logging:
+   - **Chrome / Edge / Brave:** Check **Preserve log**.
+   - **Firefox:** Click the gear icon ⚙️ and check **Persist Logs**.
+2. **Sign In:** Enter the email and password of your Miele app account and submit the login.
+   *Note:* The page will remain on a spinning wheel (or report a failed load) — this is completely
+   expected and indicates success.
+3. **Copy & Submit:** In the Network tab (F12), scroll to the very last (usually red) request. It
+   starts with `redirect?redirect_uri=miele...` or `miele://oauth2-code/...`. Right-click this
+   entry → **Copy URL** (or **Copy link address**). Paste it into the **miele:// redirect URL**
+   field in ioBroker and click **Fetch GroupKey**.
 
 ## Required ports / firewall
 
@@ -95,17 +96,20 @@ transmitted to third parties; in normal operation there is no cloud connection.
 
 ## States (excerpt)
 
-Per device under `<serial>.info` (static) and `<serial>.state` (live):
+Per device under `<serial>.info` (static/connectivity), `<serial>.state` (live) and `<serial>.eco`:
 
+- `info.connected` — connectivity status (true when appliance responds)
 - `state.statusText` / `state.status` — operating state (plain text + raw value)
 - `state.programText` / `state.programId` — running program
 - `state.programPhaseText` / `state.programPhase` — program phase
 - `state.remainingMinutes`, `state.elapsedMinutes`, `state.startInMinutes`
+- `state.remainingSeconds`, `state.elapsedSeconds` (optional second-precise DOP2 values)
 - `state.estimatedEndTime` / `state.estimatedEndTimeText` — projected finish time
 - `state.temperature[Zone2/3]`, `state.targetTemperature[Zone2/3]`
 - `state.signalDoor`, `state.signalInfo`, `state.signalFailure`
 - `state.mobileStart` — whether remote control is enabled on the device
 - `state.light`, `state.spinningSpeed` (washing machine), `state.dryingStepText` (dryer)
+- `eco.energy` (kWh), `eco.energyWh` (Wh), `eco.water` (l) (where supported)
 - `info.techType`, `info.fabNumber`, `info.xkmType`, `info.xkmVersion`, `info.deviceType`
 
 With control enabled, additionally `<serial>.control.*` (start, stop, pause, powerOn,
@@ -136,12 +140,92 @@ consequences of use.
 
 ## Acknowledgements
 
+Special thanks to **[meistermopper](https://github.com/meistermopper)**, an experienced
+ioBroker adapter developer, who reviewed this adapter unprompted and contributed substantial
+improvements: periodic background discovery for appliances waking from standby, a per-device
+connectivity state, corrected state roles and units, explicit defaults for all states, and
+German documentation. His work went into release 0.3.0.
+
 The local protocol (`MieleH256`, DOP2, provisioning) is based on the public reverse
 engineering work of the projects `MieleRESTServer` (akappner),
 `home-assistant-miele-mobile` and `ha-miele-at-lan`.
 
 ## Changelog
 
+### 0.3.5
+- **Fix: appliance status no longer flips to "off" during a running program.** A failed status
+  request was reported as a state change instead of being retried; every twenty-fifth poll
+  produced a spurious "off". Requests now get a second attempt, and an implausible jump from
+  "running" to "off" is discarded when the remaining time says the program is still going.
+  The retry count is exposed as `info.pollRetries`.
+- **Fix: remaining time was read from the wrong field.** `remainingSeconds` carries only the
+  seconds component - at "2:01" it reads 0. The plausibility check now uses
+  `remainingMinutes`.
+- **Fix: frozen EcoFeedback values are no longer booked as consumption.** When an appliance
+  keeps reporting the previous cycle's figures, the unchanged value is skipped instead of
+  being added to the new cycle.
+- Requests are serialised per appliance, and a cycle now survives an adapter restart.
+- **EcoFeedback is only requested while an appliance is actually running.** The DOP2 leaf
+  only answers while the appliance is awake - a switched-off machine returns HTTP 500. The
+  washing machine's last reading came in mid-programme; afterwards every poll ran into the
+  void, one per minute for days, each one occupying the XKM module that answers only one
+  request at a time. Polling now happens while a programme runs, during a ten-minute
+  follow-up afterwards (the final reading is not settled the moment the status flips), and
+  once at startup so that appliances without the leaf can still be identified. The follow-up
+  ends early once two consecutive readings are identical.
+- **All object names are complete in eleven languages.** The repository check reported 147
+  W1001 warnings for `common.name`; channels, EcoFeedback data points, appliance names and the
+  instance objects were still English- or German-only. Appliance categories are translated
+  while model and serial number stay untouched - they are proper names.
+
+### 0.3.4
+- **New: cycle history.** Every completed program is recorded with duration, program name,
+  energy and water. The appliances do not keep finished cycles themselves, so the history
+  starts when the feature is enabled - it cannot be filled retroactively. Recent cycles are
+  kept as JSON in `<serial>.history.cyclesJson`, alongside running totals for cycle count,
+  runtime, energy and water. Optionally each cycle is also written to the history adapter,
+  timestamped at the end of the cycle, so charts can cover any period.
+  Configurable on the new **History** tab: ring buffer size (default 50), retention in days
+  (default 730) and the history instance.
+- The step-by-step login instructions were stored in English in nine of the eleven language
+  files. All eight texts are now translated into es, fr, it, nl, pl, pt, ru, uk and zh-cn.
+- `common.news` no longer lists versions that were never published to npm.
+- Dependabot: raised the PR limit, spread the schedule over a cron slot, added automerge.
+
+### 0.3.3
+- Fix E3005: states declared as `number` no longer receive `null` when the appliance does not
+  report a value - the datapoint keeps its default instead. `estimatedEndTime` is cleared with
+  0 rather than null.
+- Fix E1011: `state.light` is read-only and now carries role `sensor.light`; switching happens
+  through `control.lightOn`/`lightOff`.
+
+### 0.3.2
+- EcoFeedback conversion moved into `dop2.ecoValues()` and covered by unit tests against the
+  cloud-verified reference values (1991 Wh = 1.991 kWh, 953 = 95.3 l).
+
+### 0.3.1
+- Fix: `applyIdent` threw on the new `connected` field, which has no ident path. Because that
+  entry comes first, **all** device data stayed empty - model, serial number, firmware.
+- Eco polling now logs why it skips a device instead of failing silently.
+
+### 0.3.0
+- Adopt ioBroker development guidelines and conformity rules.
+- Translate internal log messages to pure English.
+- Add explicit default metadata values (`def`) to all state definitions.
+- Sanitize dynamic object IDs against forbidden characters.
+- Add local verification test script (`npm run test:local`).
+- Add German documentation (`README_de.md`).
+- Fix dev-server packaging issue by removing redundant prepare script.
+- Clarify step-by-step login instructions and i18n translations.
+- Add CHANGELOG_OLD.md for historical pre-rename versions.
+- Add per-device connectivity state (`info.connected`).
+- Add periodic background discovery for waking/standby appliances.
+- Add admin UI configuration for second-precise remaining time polling.
+- Refine EcoFeedback state roles and measurement units.
+- mDNS auto-discovery is no longer marked experimental - confirmed working.
+
+Most of the above was contributed by [meistermopper](https://github.com/meistermopper).
+
 ### 0.2.1
 - Released via GitHub Actions with npm provenance (trusted publishing). No functional
   changes.
@@ -150,13 +234,7 @@ engineering work of the projects `MieleRESTServer` (akappner),
 - Renamed from `miele-lokal` to `miele-local`: English adapter name and title.
   First release under the new package name.
 
-### 0.1.1
-- Released via GitHub Actions with npm provenance (trusted publishing). No functional
-  changes. Published under the former name `iobroker.miele-lokal`.
-
-### 0.1.0
-- Initial release: login/GroupKey retrieval, mDNS discovery, state polling with enum
-  decoding, optional SuperVision push, optional control.
+[Older changelog entries can be found here](CHANGELOG_OLD.md)
 
 ## License
 

package/README_de.md

@@ -0,0 +1,179 @@
+![Logo](admin/miele-local.png)
+
+# ioBroker.miele-local
+
+[![NPM version](https://img.shields.io/npm/v/iobroker.miele-local.svg)](https://www.npmjs.com/package/iobroker.miele-local)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+*Diese Dokumentation in einer anderen Sprache lesen: [English documentation](README.md).*
+
+Dieser Adapter verbindet moderne **Miele@Home**-Geräte **lokal ohne Internet**.
+Er spricht das lokale Miele-Protokoll (`MieleH256` / DOP2) direkt über das LAN – kein
+Cloud-Konto im laufenden Betrieb, kein Umweg über die Miele 3rd-Party-Cloud-API.
+
+> Der einmalige **Login** mit dem Miele-Konto dient nur dazu, den haushaltsweiten
+> lokalen Schlüssel (GroupID/GroupKey) abzurufen. Danach läuft der Adapter komplett
+> offline, und die Miele-App funktioniert unverändert weiter.
+
+## Funktionen
+
+- **Automatischer Abruf der Zugangsdaten** über einen geführten Login (Cloud-OAuth), ohne
+  die Geräte neu anlernen zu müssen.
+- **Automatische Geräteerkennung** über mDNS (`_mieleathome._tcp`).
+- **Live-Zustände** aller unterstützten Geräteklassen (Waschmaschine, Trockner,
+  Spülmaschine, Backofen, Dampfgarer, Kochfeld, Kaffeevollautomat u. v. m.) mit Klartext-Dekodierung
+  von Status, Programm und Phase.
+- **Echtzeit-Aktualisierungen** über den SuperVision-Push-Kanal (optional), mit Polling als
+  zuverlässigem Fallback.
+- **Steuerung** (optional): Start/Stop/Pause, Licht, Ein/Aus über beschreibbare Datenpunkte –
+  sofern „MobileStart / Fernsteuerung" am Gerät aktiviert ist.
+
+## Installation
+
+1. Adapter installieren und Instanz anlegen.
+2. Im Tab **Login** das Land wählen und der folgenden 3-Schritte-Anleitung folgen.
+3. Die abgefangene `miele://…`-Weiterleitungsadresse einfügen und auf **GroupKey abrufen** klicken.
+   GroupID und GroupKey werden sicher gespeichert (GroupKey verschlüsselt).
+4. Speichern. Der Adapter findet die Geräte per mDNS und legt die Datenpunkte an.
+
+### Schritt-für-Schritt: Weiterleitungs-URL abfangen
+
+Da die finale `miele://`-Adresse ein mobiles App-Protokoll ist, können Desktop-Browser sie nicht
+automatisch öffnen und bleiben bei einem sich drehenden Laderad stehen. Fange die URL mit den
+Entwicklertools (DevTools) deines Browsers ab:
+
+1. **Entwicklertools vorbereiten:** Klicke auf **Login-Seite öffnen**, um den Login in einem neuen Tab
+   zu öffnen. Drücke in dem neuen Tab **F12** (Entwicklertools) und wechsle auf den Reiter **Netzwerk**
+   (Network). Aktiviere die dauerhafte Protokollierung:
+   - **Chrome / Edge / Brave:** Haken bei **Log beibehalten** (*Preserve log*) setzen.
+   - **Firefox:** Auf das Zahnrad-Symbol ⚙️ klicken und **Protokolle dauerhaft anzeigen** (*Persist Logs*) aktivieren.
+2. **Anmelden:** E-Mail und Passwort deines Miele-App-Kontos eingeben und die Anmeldung abschicken.
+   *Hinweis:* Die Seite bleibt bei einem Laderad stehen (oder meldet einen Ladefehler) – das ist völlig
+   normal und signalisiert Erfolg.
+3. **Kopieren & Einbinden:** 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/...`.
+   Mache einen Rechtsklick auf diese Zeile → **URL kopieren** (bzw. **Link-Adresse kopieren**). Füge sie
+   in das Feld **miele://-Redirect-URL** im ioBroker ein und klicke auf **GroupKey abrufen**.
+
+## Benötigte Ports / Firewall
+
+| Richtung | Port | Zweck | Erforderlich |
+|---|---|---|---|
+| Eingehend | TCP *Push-Port* (Standard 18082) | Geräte senden Echtzeit-Updates an ioBroker | nur bei aktivem Push |
+| Ein/Aus | UDP 5353 (mDNS) | Geräteerkennung und Push-Registrierung | ja |
+| Ausgehend | TCP 80 → Geräte | Zustände lesen / Steuerbefehle senden | ja |
+| Ausgehend | TCP 443 → miele-iot.com | nur beim Login (GroupKey abrufen) | nur beim Login |
+
+Ohne Push ist **kein eingehender Port** erforderlich. ioBroker und die Geräte müssen sich im
+selben Broadcast-Segment befinden (keine VLAN-/Docker-Bridge-Trennung), damit mDNS funktioniert.
+
+### Betrieb in Docker (wichtig)
+
+Wenn ioBroker in einem **Docker-Container mit Bridge-Netzwerk** läuft (Standard, z. B. buanet-Image),
+kann die automatische **mDNS-Erkennung die Geräte nicht erreichen** – Multicast wird nicht
+gebrückt. Die direkte Kommunikation (TCP 80) funktioniert, da sie geroutet wird. In diesem Fall:
+
+- **Geräte-IPs manuell im Tab „Geräte & Polling" eintragen.** Das Polling funktioniert dann normal.
+- **Push** funktioniert im Bridge-Netzwerk nicht (die Geräte können den Container nicht erreichen). Für
+  Push den Container im **Host-Netzwerk** betreiben (`network_mode: host`) – der Push-Port ist
+  dann automatisch erreichbar.
+
+### Wie Push technisch funktioniert
+
+Bei aktiviertem Push führt der Adapter ein **Enrollment** je Gerät durch: `PUT
+/Devices/<series>/SuperVision/<own-fab>` (registriert den Adapter als Haushalts-Peer) sowie mehrere
+`POST /Subscriptions` mit einer **Callback-URL** `http://<ioBroker-LAN-IP>:<push-port>/…`. Das
+Gerät sendet Zustandsänderungen dann unaufgefordert (sub-sekündlich) an diese URL. Die Subscriptions
+werden periodisch erneuert. Erreicht das Gerät die Callback-URL nicht, greift der Adapter automatisch
+auf Polling zurück.
+
+## Datenschutz
+
+Es werden **keine personenbezogenen Daten** im Adapter gespeichert. GroupID, GroupKey und
+Refresh-Token verbleiben ausschließlich in der (verschlüsselten) Instanzkonfiguration bzw. in
+ioBroker-Objekten. Es erfolgt keine Datenübertragung an Dritte; im laufenden Betrieb besteht
+keine Cloud-Verbindung.
+
+## Datenpunkte (Auszug)
+
+Je Gerät unter `<serial>.info` (statisch/Verbindung), `<serial>.state` (live) und `<serial>.eco`:
+
+- `info.connected` – Erreichbarkeitsstatus (true, wenn Gerät antwortet)
+- `state.statusText` / `state.status` – Betriebszustand (Klartext + Rohwert)
+- `state.programText` / `state.programId` – Laufendes Programm
+- `state.programPhaseText` / `state.programPhase` – Programmphase
+- `state.remainingMinutes`, `state.elapsedMinutes`, `state.startInMinutes`
+- `state.remainingSeconds`, `state.elapsedSeconds` (sekundengenau via DOP2)
+- `state.estimatedEndTime` / `state.estimatedEndTimeText` – Voraussichtliches Programmende
+- `state.temperature[Zone2/3]`, `state.targetTemperature[Zone2/3]`
+- `state.signalDoor`, `state.signalInfo`, `state.signalFailure`
+- `state.mobileStart` – Gibt an, ob MobileStart/Fernsteuerung am Gerät aktiv ist
+- `state.light`, `state.spinningSpeed` (Waschmaschine), `state.dryingStepText` (Trockner)
+- `eco.energy` (kWh), `eco.energyWh` (Wh), `eco.water` (l) (wo unterstützt)
+- `info.techType`, `info.fabNumber`, `info.xkmType`, `info.xkmVersion`, `info.deviceType`
+
+Bei aktivierter Steuerung zusätzlich `<serial>.control.*` (start, stop, pause, powerOn,
+powerOff, lightOn, lightOff).
+
+## Kompatibilität / Grenzen
+
+- Getestet an Waschmaschine (WCR860/EK037), Spülmaschine (G5840/EK037) und Backofen (H2469BP/EK057).
+- Kühl- und Gefriergeräte sind lokal meist **nur lesbar** (die Firmware lehnt Schreibbefehle ab).
+- Steuerbefehle setzen „MobileStart / Fernsteuerung" am Gerät voraus; manche Firmware-Versionen
+  beantworten DOP2-Schreibbefehle mit HTTP 404/500.
+- Der SuperVision-Push ist eine Best-Effort-Ergänzung; Polling ist der zuverlässige Standardpfad.
+
+## Rechtliche Hinweise / Haftungsausschluss
+
+Dies ist ein **inoffizielles, privat entwickeltes** Projekt und steht in **keiner Verbindung zu
+Miele & Cie. KG**. „Miele", „Miele@home" und zugehörige Bezeichnungen sind eingetragene
+Marken der Miele & Cie. KG und werden hier nur beschreibend zur Kompatibilitätsangabe verwendet.
+
+Der Adapter nutzt ein lokales Protokoll, das durch **Reverse Engineering** dokumentiert wurde.
+Die Nutzung erfolgt **auf eigene Verantwortung**. Die Software wird unter MIT-Lizenz
+**ohne Mängelgewähr** bereitgestellt (siehe LICENSE).
+
+## Danksagung
+
+Besonderer Dank gilt **[meistermopper](https://github.com/meistermopper)**, einem erfahrenen
+Entwickler von ioBroker-Adaptern, der diesen Adapter unaufgefordert durchgesehen und
+erhebliche Verbesserungen beigesteuert hat: die periodische Gerätesuche im Hintergrund für
+Geräte, die aus dem Standby aufwachen, einen Erreichbarkeits-Datenpunkt je Gerät, korrigierte
+Rollen und Einheiten, explizite Vorgabewerte für alle Datenpunkte sowie die deutsche
+Dokumentation. Seine Arbeit ist in Version 0.3.0 eingeflossen.
+
+Das lokale Protokoll (`MieleH256`, DOP2, Provisioning) basiert auf der Vorarbeit der
+Open-Source-Projekte `MieleRESTServer` (akappner), `home-assistant-miele-mobile` und
+`ha-miele-at-lan`.
+
+## Changelog
+
+### **WORK IN PROGRESS**
+
+### 0.2.1 (2026-08-18)
+- Adopt ioBroker development guidelines and conformity rules.
+- Translate internal log messages to pure English.
+- Add explicit default metadata values (`def`) to all state definitions.
+- Sanitize dynamic object IDs against forbidden characters.
+- Add local verification test script (`npm run test:local`).
+- Add German documentation (`README_de.md`).
+- Fix dev-server packaging issue by removing redundant prepare script.
+- Clarify step-by-step login instructions and i18n translations.
+- Add CHANGELOG_OLD.md for historical pre-rename versions.
+- Add per-device connectivity state (`info.connected`).
+- Add periodic background discovery for waking/standby appliances.
+- Add admin UI configuration for second-precise remaining time polling.
+- Refine EcoFeedback state roles and measurement units.
+
+### 0.2.1
+- Veröffentlichung über GitHub Actions mit npm-Provenance (Trusted Publishing). Keine funktionalen Änderungen.
+
+### 0.2.0
+- Umbenennung von `miele-lokal` in `miele-local`: englischer Adaptername und Titel.
+  Erste Version unter dem neuen Paketnamen.
+
+[Ältere Einträge sind hier zu finden](CHANGELOG_OLD.md)
+
+## Lizenz
+
+MIT License - Copyright (c) 2026 Immanuel

package/admin/i18n/de/translations.json

@@ -39,6 +39,26 @@
   "Datenpunkt-Namen auf Deutsch": "Datenpunkt-Namen auf Deutsch",
   "EcoFeedback (Energie/Wasser) abrufen": "EcoFeedback (Energie/Wasser) abrufen",
   "EcoFeedback-Intervall in Sekunden": "EcoFeedback-Intervall in Sekunden",
-  "Geräte automatisch per mDNS finden (experimentell)": "Geräte automatisch per mDNS finden (experimentell)",
-  "SuperVision-Push aktivieren (experimentell, Echtzeit)": "SuperVision-Push aktivieren (experimentell, Echtzeit)"
+  "SuperVision-Push aktivieren (experimentell, Echtzeit)": "SuperVision-Push aktivieren (experimentell, Echtzeit)",
+  "Schritt 1: Entwicklertools im Browser vorbereiten": "Schritt 1: Entwicklertools im Browser vorbereiten",
+  "1. Oben auf „Login-Seite öffnen“ klicken (ein neuer Browser-Tab öffnet sich).\n2. Im neuen Tab 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.": "1. Oben auf „Login-Seite öffnen“ klicken (ein neuer Browser-Tab öffnet sich).\n2. Im neuen Tab 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.",
+  "Schritt 2: Bei Miele anmelden": "Schritt 2: Bei Miele anmelden",
+  "1. E-Mail und Passwort deines Miele-App-Kontos eingeben und auf „Anmeldung“ 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!": "1. E-Mail und Passwort deines Miele-App-Kontos eingeben und auf „Anmeldung“ 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!",
+  "Schritt 3: Adresse kopieren & GroupKey ermitteln": "Schritt 3: Adresse kopieren & GroupKey ermitteln",
+  "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 ermitteln“ klicken.": "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 ermitteln“ klicken.",
+  "Der Adapter ermittelt die lokalen Zugangsdaten (GroupID/GroupKey) einmalig über eine Anmeldung mit Ihrem Miele-Konto. Die Miele-App funktioniert danach unverändert weiter. Es werden keine Zugangsdaten an Dritte übertragen.": "Der Adapter ermittelt die lokalen Zugangsdaten (GroupID/GroupKey) einmalig über eine Anmeldung mit Ihrem Miele-Konto. Die Miele-App funktioniert danach unverändert weiter. Es werden keine Zugangsdaten an Dritte übertragen.",
+  "Nach erfolgreicher Ermittlung stehen GroupID und (verschlüsselt gespeicherter) GroupKey unten im Tab „Erweitert\". Speichern nicht vergessen.": "Nach erfolgreicher Ermittlung stehen GroupID und (verschlüsselt gespeicherter) GroupKey unten im Tab „Erweitert\". Speichern nicht vergessen.",
+  "Hintergrund-Suche Intervall in Minuten": "Hintergrund-Suche Intervall in Minuten",
+  "Sekundengenaue Rest-/Laufzeit abrufen (DOP2)": "Sekundengenaue Rest-/Laufzeit abrufen (DOP2)",
+  "Sekunden-Abfrageintervall in Sekunden": "Sekunden-Abfrageintervall in Sekunden",
+  "Verlauf": "Verlauf",
+  "Programme mitschreiben": "Programme mitschreiben",
+  "Einträge im Ringpuffer": "Einträge im Ringpuffer",
+  "Wie viele der letzten Programme in cyclesJson stehen. Für die Schnellanzeige gedacht; Langzeitdaten kommen aus dem History-Adapter.": "Wie viele der letzten Programme in cyclesJson stehen. Für die Schnellanzeige gedacht; Langzeitdaten kommen aus dem History-Adapter.",
+  "Aufbewahrung in Tagen": "Aufbewahrung in Tagen",
+  "Ältere Einträge fallen aus dem Ringpuffer. 730 Tage sind zwei Jahre.": "Ältere Einträge fallen aus dem Ringpuffer. 730 Tage sind zwei Jahre.",
+  "Zusätzlich in den History-Adapter schreiben": "Zusätzlich in den History-Adapter schreiben",
+  "Energie, Wasser und Dauer je Programm mit dem Zeitpunkt des Programmendes – damit lassen sich Diagramme über beliebige Zeiträume bauen.": "Energie, Wasser und Dauer je Programm mit dem Zeitpunkt des Programmendes – damit lassen sich Diagramme über beliebige Zeiträume bauen.",
+  "History-Instanz": "History-Instanz",
+  "Der Adapter schreibt jedes abgeschlossene Programm mit: Dauer, Programm, Energie und Wasser. Die Geräte selbst heben abgeschlossene Programme nicht auf, der Verlauf beginnt also mit dem Einschalten dieser Funktion – rückwirkend lässt er sich nicht füllen. Die letzten Programme stehen als JSON unter <Seriennummer>.history.cyclesJson, die Summen daneben.": "Der Adapter schreibt jedes abgeschlossene Programm mit: Dauer, Programm, Energie und Wasser. Die Geräte selbst heben abgeschlossene Programme nicht auf, der Verlauf beginnt also mit dem Einschalten dieser Funktion – rückwirkend lässt er sich nicht füllen. Die letzten Programme stehen als JSON unter <Seriennummer>.history.cyclesJson, die Summen daneben."
 }

package/admin/i18n/en/translations.json

@@ -9,7 +9,7 @@
   "Login-Seite öffnen": "Open login page",
   "miele://-Redirect-URL": "miele:// redirect URL",
   "GroupKey ermitteln": "Fetch GroupKey",
-  "Geräte automatisch per mDNS finden": "Discover devices automatically via mDNS",
+  "Geräte automatisch per mDNS finden": "Find devices automatically via mDNS",
   "Jetzt suchen": "Search now",
   "Manuelle Geräte-IPs (optional, zusätzlich)": "Manual device IPs (optional, additional)",
   "IP-Adresse": "IP address",
@@ -39,6 +39,26 @@
   "Datenpunkt-Namen auf Deutsch": "State names in German",
   "EcoFeedback (Energie/Wasser) abrufen": "Fetch EcoFeedback (energy/water)",
   "EcoFeedback-Intervall in Sekunden": "EcoFeedback interval in seconds",
-  "Geräte automatisch per mDNS finden (experimentell)": "Find devices automatically via mDNS (experimental)",
-  "SuperVision-Push aktivieren (experimentell, Echtzeit)": "Enable SuperVision push (experimental, real-time)"
+  "SuperVision-Push aktivieren (experimentell, Echtzeit)": "Enable SuperVision push (experimental, real-time)",
+  "Schritt 1: Entwicklertools im Browser vorbereiten": "Step 1: Prepare browser developer tools",
+  "1. Oben auf „Login-Seite öffnen“ klicken (ein neuer Browser-Tab öffnet sich).\n2. Im neuen Tab 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.": "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'.",
+  "Schritt 2: Bei Miele anmelden": "Step 2: Sign in with Miele",
+  "1. E-Mail und Passwort deines Miele-App-Kontos eingeben und auf „Anmeldung“ 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!": "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!",
+  "Schritt 3: Adresse kopieren & GroupKey ermitteln": "Step 3: Copy redirect address & fetch GroupKey",
+  "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 ermitteln“ klicken.": "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 URL into the field below and click 'Fetch GroupKey'.",
+  "Der Adapter ermittelt die lokalen Zugangsdaten (GroupID/GroupKey) einmalig über eine Anmeldung mit Ihrem Miele-Konto. Die Miele-App funktioniert danach unverändert weiter. Es werden keine Zugangsdaten an Dritte übertragen.": "The adapter retrieves local credentials (GroupID/GroupKey) once by signing in with your Miele account. The Miele app continues to work as before. No credentials are transmitted to third parties.",
+  "Nach erfolgreicher Ermittlung stehen GroupID und (verschlüsselt gespeicherter) GroupKey unten im Tab „Erweitert\". Speichern nicht vergessen.": "Once retrieved, GroupID and encrypted GroupKey appear on the 'Advanced' tab. Don't forget to save.",
+  "Hintergrund-Suche Intervall in Minuten": "Background discovery interval in minutes",
+  "Sekundengenaue Rest-/Laufzeit abrufen (DOP2)": "Fetch second-precise remaining/elapsed time (DOP2)",
+  "Sekunden-Abfrageintervall in Sekunden": "Second polling interval in seconds",
+  "Verlauf": "History",
+  "Programme mitschreiben": "Record cycles",
+  "Einträge im Ringpuffer": "Entries in the ring buffer",
+  "Wie viele der letzten Programme in cyclesJson stehen. Für die Schnellanzeige gedacht; Langzeitdaten kommen aus dem History-Adapter.": "How many recent cycles are kept in cyclesJson. Meant for quick display; long-term data comes from the history adapter.",
+  "Aufbewahrung in Tagen": "Retention in days",
+  "Ältere Einträge fallen aus dem Ringpuffer. 730 Tage sind zwei Jahre.": "Older entries drop out of the ring buffer. 730 days is two years.",
+  "Zusätzlich in den History-Adapter schreiben": "Also write to the history adapter",
+  "Energie, Wasser und Dauer je Programm mit dem Zeitpunkt des Programmendes – damit lassen sich Diagramme über beliebige Zeiträume bauen.": "Energy, water and duration per cycle, timestamped at the end of the cycle – so charts can cover any period.",
+  "History-Instanz": "History instance",
+  "Der Adapter schreibt jedes abgeschlossene Programm mit: Dauer, Programm, Energie und Wasser. Die Geräte selbst heben abgeschlossene Programme nicht auf, der Verlauf beginnt also mit dem Einschalten dieser Funktion – rückwirkend lässt er sich nicht füllen. Die letzten Programme stehen als JSON unter <Seriennummer>.history.cyclesJson, die Summen daneben.": "The adapter records every completed cycle: duration, program, energy and water. The appliances do not keep finished cycles themselves, so the history starts when you enable this – it cannot be filled retroactively. Recent cycles are available as JSON under <serial>.history.cyclesJson, the totals next to it."
 }

package/admin/i18n/es/translations.json

@@ -39,6 +39,26 @@
   "Datenpunkt-Namen auf Deutsch": "Nombres de estados en alemán",
   "EcoFeedback (Energie/Wasser) abrufen": "Obtener EcoFeedback (energía/agua)",
   "EcoFeedback-Intervall in Sekunden": "Intervalo de EcoFeedback en segundos",
-  "Geräte automatisch per mDNS finden (experimentell)": "Detectar dispositivos automáticamente por mDNS (experimental)",
-  "SuperVision-Push aktivieren (experimentell, Echtzeit)": "Activar push SuperVision (experimental, tiempo real)"
+  "SuperVision-Push aktivieren (experimentell, Echtzeit)": "Activar push SuperVision (experimental, tiempo real)",
+  "Schritt 1: Entwicklertools im Browser vorbereiten": "Paso 1: preparar las herramientas de desarrollo del navegador",
+  "1. Oben auf „Login-Seite öffnen“ klicken (ein neuer Browser-Tab öffnet sich).\n2. Im neuen Tab 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.": "1. Haga clic arriba en «Abrir página de inicio de sesión» (se abre una pestaña nueva).\n2. En la pestaña nueva pulse F12 y cambie a la pestaña «Red» (Network).\n3. Active el registro persistente:\n   • Chrome / Edge / Brave: marque «Conservar registro» (Preserve log).\n   • Firefox: engranaje ⚙️ ➔ active «Conservar registros» (Persist Logs).",
+  "Schritt 2: Bei Miele anmelden": "Paso 2: iniciar sesión en Miele",
+  "1. E-Mail und Passwort deines Miele-App-Kontos eingeben und auf „Anmeldung“ 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!": "1. Introduzca el correo y la contraseña de su cuenta de la app Miele y haga clic en «Iniciar sesión».\n2. Importante: después del inicio de sesión la página se queda con una rueda girando (o muestra un error). Es completamente normal y significa que el acceso ha funcionado.",
+  "Schritt 3: Adresse kopieren & GroupKey ermitteln": "Paso 3: copiar la dirección y obtener la GroupKey",
+  "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 ermitteln“ klicken.": "1. En la pestaña Red (F12) desplácese hasta la última petición (suele estar en rojo) que empieza por «redirect?redirect_uri=miele...» o «miele://oauth2-code/...».\n2. Haga clic derecho en esa línea ➔ «Copiar URL» (o «Copiar dirección del enlace»).\n3. Pegue la dirección copiada en el campo de abajo y haga clic en «Obtener GroupKey».",
+  "Der Adapter ermittelt die lokalen Zugangsdaten (GroupID/GroupKey) einmalig über eine Anmeldung mit Ihrem Miele-Konto. Die Miele-App funktioniert danach unverändert weiter. Es werden keine Zugangsdaten an Dritte übertragen.": "El adaptador obtiene una sola vez las credenciales locales (GroupID/GroupKey) mediante un inicio de sesión con su cuenta Miele. La app de Miele sigue funcionando igual. No se transmiten credenciales a terceros.",
+  "Nach erfolgreicher Ermittlung stehen GroupID und (verschlüsselt gespeicherter) GroupKey unten im Tab „Erweitert\". Speichern nicht vergessen.": "Tras obtenerlos, la GroupID y la GroupKey (guardada cifrada) aparecen en la pestaña «Avanzado». No olvide guardar.",
+  "Hintergrund-Suche Intervall in Minuten": "Intervalo de descubrimiento en segundo plano en minutos",
+  "Sekundengenaue Rest-/Laufzeit abrufen (DOP2)": "Obtener tiempo restante/transcurrido exacto en segundos (DOP2)",
+  "Sekunden-Abfrageintervall in Sekunden": "Intervalo de consulta en segundos",
+  "Verlauf": "Historial",
+  "Programme mitschreiben": "Registrar los programas",
+  "Einträge im Ringpuffer": "Entradas en el búfer circular",
+  "Wie viele der letzten Programme in cyclesJson stehen. Für die Schnellanzeige gedacht; Langzeitdaten kommen aus dem History-Adapter.": "Cuántos programas recientes se guardan en cyclesJson. Pensado para la vista rápida; los datos a largo plazo vienen del adaptador history.",
+  "Aufbewahrung in Tagen": "Conservación en días",
+  "Ältere Einträge fallen aus dem Ringpuffer. 730 Tage sind zwei Jahre.": "Las entradas más antiguas salen del búfer circular. 730 días son dos años.",
+  "Zusätzlich in den History-Adapter schreiben": "Escribir también en el adaptador history",
+  "Energie, Wasser und Dauer je Programm mit dem Zeitpunkt des Programmendes – damit lassen sich Diagramme über beliebige Zeiträume bauen.": "Energía, agua y duración por programa, con la marca de tiempo del final del programa, para poder crear gráficos de cualquier periodo.",
+  "History-Instanz": "Instancia de history",
+  "Der Adapter schreibt jedes abgeschlossene Programm mit: Dauer, Programm, Energie und Wasser. Die Geräte selbst heben abgeschlossene Programme nicht auf, der Verlauf beginnt also mit dem Einschalten dieser Funktion – rückwirkend lässt er sich nicht füllen. Die letzten Programme stehen als JSON unter <Seriennummer>.history.cyclesJson, die Summen daneben.": "El adaptador registra cada programa terminado: duración, programa, energía y agua. Los aparatos no conservan los programas finalizados, así que el historial empieza al activar esta opción; no puede rellenarse con datos pasados. Los últimos programas están como JSON en <número de serie>.history.cyclesJson, junto a los totales."
 }

package/admin/i18n/fr/translations.json

@@ -39,6 +39,26 @@
   "Datenpunkt-Namen auf Deutsch": "Noms des états en allemand",
   "EcoFeedback (Energie/Wasser) abrufen": "Récupérer EcoFeedback (énergie/eau)",
   "EcoFeedback-Intervall in Sekunden": "Intervalle EcoFeedback en secondes",
-  "Geräte automatisch per mDNS finden (experimentell)": "Détecter les appareils automatiquement via mDNS (expérimental)",
-  "SuperVision-Push aktivieren (experimentell, Echtzeit)": "Activer le push SuperVision (expérimental, temps réel)"
+  "SuperVision-Push aktivieren (experimentell, Echtzeit)": "Activer le push SuperVision (expérimental, temps réel)",
+  "Schritt 1: Entwicklertools im Browser vorbereiten": "Étape 1 : préparer les outils de développement du navigateur",
+  "1. Oben auf „Login-Seite öffnen“ klicken (ein neuer Browser-Tab öffnet sich).\n2. Im neuen Tab 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.": "1. Cliquez ci-dessus sur « Ouvrir la page de connexion » (un nouvel onglet s'ouvre).\n2. Dans le nouvel onglet, appuyez sur F12 et passez à l'onglet « Réseau » (Network).\n3. Activez la journalisation persistante :\n   • Chrome / Edge / Brave : cochez « Conserver le journal » (Preserve log).\n   • Firefox : roue dentée ⚙️ ➔ activez « Conserver les journaux » (Persist Logs).",
+  "Schritt 2: Bei Miele anmelden": "Étape 2 : se connecter à Miele",
+  "1. E-Mail und Passwort deines Miele-App-Kontos eingeben und auf „Anmeldung“ 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!": "1. Saisissez l'adresse e-mail et le mot de passe de votre compte de l'application Miele, puis cliquez sur « Connexion ».\n2. Important : après la connexion, la page reste bloquée sur une roue qui tourne (ou affiche une erreur). C'est tout à fait normal et signifie que la connexion a réussi.",
+  "Schritt 3: Adresse kopieren & GroupKey ermitteln": "Étape 3 : copier l'adresse de redirection et récupérer la GroupKey",
+  "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 ermitteln“ klicken.": "1. Dans l'onglet Réseau (F12), faites défiler jusqu'à la dernière requête (souvent en rouge) commençant par « redirect?redirect_uri=miele... » ou « miele://oauth2-code/... ».\n2. Clic droit sur cette ligne ➔ « Copier l'URL » (ou « Copier l'adresse du lien »).\n3. Collez l'adresse copiée dans le champ ci-dessous et cliquez sur « Récupérer la GroupKey ».",
+  "Der Adapter ermittelt die lokalen Zugangsdaten (GroupID/GroupKey) einmalig über eine Anmeldung mit Ihrem Miele-Konto. Die Miele-App funktioniert danach unverändert weiter. Es werden keine Zugangsdaten an Dritte übertragen.": "L'adaptateur récupère une seule fois les identifiants locaux (GroupID/GroupKey) via une connexion à votre compte Miele. L'application Miele continue de fonctionner comme avant. Aucun identifiant n'est transmis à des tiers.",
+  "Nach erfolgreicher Ermittlung stehen GroupID und (verschlüsselt gespeicherter) GroupKey unten im Tab „Erweitert\". Speichern nicht vergessen.": "Une fois récupérées, la GroupID et la GroupKey (stockée chiffrée) apparaissent dans l'onglet « Avancé ». N'oubliez pas d'enregistrer.",
+  "Hintergrund-Suche Intervall in Minuten": "Intervalle de découverte en arrière-plan en minutes",
+  "Sekundengenaue Rest-/Laufzeit abrufen (DOP2)": "Récupérer le temps restant/écoulé précis à la seconde (DOP2)",
+  "Sekunden-Abfrageintervall in Sekunden": "Intervalle d'interrogation en secondes",
+  "Verlauf": "Historique",
+  "Programme mitschreiben": "Enregistrer les cycles",
+  "Einträge im Ringpuffer": "Entrées dans le tampon circulaire",
+  "Wie viele der letzten Programme in cyclesJson stehen. Für die Schnellanzeige gedacht; Langzeitdaten kommen aus dem History-Adapter.": "Nombre de cycles récents conservés dans cyclesJson. Prévu pour l’affichage rapide ; les données à long terme proviennent de l’adaptateur history.",
+  "Aufbewahrung in Tagen": "Conservation en jours",
+  "Ältere Einträge fallen aus dem Ringpuffer. 730 Tage sind zwei Jahre.": "Les entrées plus anciennes sortent du tampon circulaire. 730 jours correspondent à deux ans.",
+  "Zusätzlich in den History-Adapter schreiben": "Écrire aussi dans l’adaptateur history",
+  "Energie, Wasser und Dauer je Programm mit dem Zeitpunkt des Programmendes – damit lassen sich Diagramme über beliebige Zeiträume bauen.": "Énergie, eau et durée par cycle, horodatés à la fin du cycle – pour des graphiques sur n’importe quelle période.",
+  "History-Instanz": "Instance history",
+  "Der Adapter schreibt jedes abgeschlossene Programm mit: Dauer, Programm, Energie und Wasser. Die Geräte selbst heben abgeschlossene Programme nicht auf, der Verlauf beginnt also mit dem Einschalten dieser Funktion – rückwirkend lässt er sich nicht füllen. Die letzten Programme stehen als JSON unter <Seriennummer>.history.cyclesJson, die Summen daneben.": "L’adaptateur enregistre chaque cycle terminé : durée, programme, énergie et eau. Les appareils ne conservent pas les cycles achevés, l’historique commence donc à l’activation – il ne peut pas être rempli rétroactivement. Les derniers cycles sont disponibles en JSON sous <numéro de série>.history.cyclesJson, avec les totaux."
 }

package/admin/i18n/it/translations.json

@@ -39,6 +39,26 @@
   "Datenpunkt-Namen auf Deutsch": "Nomi degli stati in tedesco",
   "EcoFeedback (Energie/Wasser) abrufen": "Recupera EcoFeedback (energia/acqua)",
   "EcoFeedback-Intervall in Sekunden": "Intervallo EcoFeedback in secondi",
-  "Geräte automatisch per mDNS finden (experimentell)": "Rileva dispositivi automaticamente via mDNS (sperimentale)",
-  "SuperVision-Push aktivieren (experimentell, Echtzeit)": "Abilita push SuperVision (sperimentale, tempo reale)"
+  "SuperVision-Push aktivieren (experimentell, Echtzeit)": "Abilita push SuperVision (sperimentale, tempo reale)",
+  "Schritt 1: Entwicklertools im Browser vorbereiten": "Passo 1: preparare gli strumenti di sviluppo del browser",
+  "1. Oben auf „Login-Seite öffnen“ klicken (ein neuer Browser-Tab öffnet sich).\n2. Im neuen Tab 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.": "1. Fare clic sopra su «Apri pagina di accesso» (si apre una nuova scheda).\n2. Nella nuova scheda premere F12 e passare alla scheda «Rete» (Network).\n3. Attivare la registrazione persistente:\n   • Chrome / Edge / Brave: spuntare «Conserva registro» (Preserve log).\n   • Firefox: ingranaggio ⚙️ ➔ attivare «Mantieni i log» (Persist Logs).",
+  "Schritt 2: Bei Miele anmelden": "Passo 2: accedere con Miele",
+  "1. E-Mail und Passwort deines Miele-App-Kontos eingeben und auf „Anmeldung“ 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!": "1. Inserire e-mail e password dell'account dell'app Miele e fare clic su «Accedi».\n2. Importante: dopo l'accesso la pagina resta ferma su una rotellina che gira (o mostra un errore). È del tutto normale e significa che l'accesso è riuscito.",
+  "Schritt 3: Adresse kopieren & GroupKey ermitteln": "Passo 3: copiare l'indirizzo e ottenere la GroupKey",
+  "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 ermitteln“ klicken.": "1. Nella scheda Rete (F12) scorrere fino all'ultima richiesta (spesso in rosso) che inizia con «redirect?redirect_uri=miele...» o «miele://oauth2-code/...».\n2. Fare clic con il tasto destro su quella riga ➔ «Copia URL» (o «Copia indirizzo del link»).\n3. Incollare l'indirizzo copiato nel campo sottostante e fare clic su «Ottieni GroupKey».",
+  "Der Adapter ermittelt die lokalen Zugangsdaten (GroupID/GroupKey) einmalig über eine Anmeldung mit Ihrem Miele-Konto. Die Miele-App funktioniert danach unverändert weiter. Es werden keine Zugangsdaten an Dritte übertragen.": "L'adapter ottiene una sola volta le credenziali locali (GroupID/GroupKey) tramite un accesso al proprio account Miele. L'app Miele continua a funzionare come prima. Nessuna credenziale viene trasmessa a terzi.",
+  "Nach erfolgreicher Ermittlung stehen GroupID und (verschlüsselt gespeicherter) GroupKey unten im Tab „Erweitert\". Speichern nicht vergessen.": "Una volta ottenute, GroupID e GroupKey (memorizzata cifrata) compaiono nella scheda «Avanzate». Non dimenticare di salvare.",
+  "Hintergrund-Suche Intervall in Minuten": "Intervallo di rilevamento in background in minuti",
+  "Sekundengenaue Rest-/Laufzeit abrufen (DOP2)": "Recupera tempo rimanente/trascorso preciso al secondo (DOP2)",
+  "Sekunden-Abfrageintervall in Sekunden": "Intervallo di polling in secondi",
+  "Verlauf": "Cronologia",
+  "Programme mitschreiben": "Registrare i programmi",
+  "Einträge im Ringpuffer": "Voci nel buffer circolare",
+  "Wie viele der letzten Programme in cyclesJson stehen. Für die Schnellanzeige gedacht; Langzeitdaten kommen aus dem History-Adapter.": "Quanti programmi recenti restano in cyclesJson. Pensato per la visualizzazione rapida; i dati a lungo termine arrivano dall’adapter history.",
+  "Aufbewahrung in Tagen": "Conservazione in giorni",
+  "Ältere Einträge fallen aus dem Ringpuffer. 730 Tage sind zwei Jahre.": "Le voci più vecchie escono dal buffer circolare. 730 giorni corrispondono a due anni.",
+  "Zusätzlich in den History-Adapter schreiben": "Scrivere anche nell’adapter history",
+  "Energie, Wasser und Dauer je Programm mit dem Zeitpunkt des Programmendes – damit lassen sich Diagramme über beliebige Zeiträume bauen.": "Energia, acqua e durata per programma, con l’orario di fine – così i grafici possono coprire qualsiasi periodo.",
+  "History-Instanz": "Istanza history",
+  "Der Adapter schreibt jedes abgeschlossene Programm mit: Dauer, Programm, Energie und Wasser. Die Geräte selbst heben abgeschlossene Programme nicht auf, der Verlauf beginnt also mit dem Einschalten dieser Funktion – rückwirkend lässt er sich nicht füllen. Die letzten Programme stehen als JSON unter <Seriennummer>.history.cyclesJson, die Summen daneben.": "L’adapter registra ogni programma concluso: durata, programma, energia e acqua. Gli apparecchi non conservano i programmi terminati, quindi la cronologia inizia con l’attivazione e non può essere riempita a posteriori. Gli ultimi programmi sono in JSON sotto <numero di serie>.history.cyclesJson, accanto ai totali."
 }

package/admin/i18n/nl/translations.json

@@ -39,6 +39,26 @@
   "Datenpunkt-Namen auf Deutsch": "Statusnamen in het Duits",
   "EcoFeedback (Energie/Wasser) abrufen": "EcoFeedback (energie/water) ophalen",
   "EcoFeedback-Intervall in Sekunden": "EcoFeedback-interval in seconden",
-  "Geräte automatisch per mDNS finden (experimentell)": "Apparaten automatisch via mDNS vinden (experimenteel)",
-  "SuperVision-Push aktivieren (experimentell, Echtzeit)": "SuperVision-push inschakelen (experimenteel, realtime)"
+  "SuperVision-Push aktivieren (experimentell, Echtzeit)": "SuperVision-push inschakelen (experimenteel, realtime)",
+  "Schritt 1: Entwicklertools im Browser vorbereiten": "Stap 1: ontwikkelaarstools van de browser voorbereiden",
+  "1. Oben auf „Login-Seite öffnen“ klicken (ein neuer Browser-Tab öffnet sich).\n2. Im neuen Tab 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.": "1. Klik hierboven op 'Inlogpagina openen' (er opent een nieuw tabblad).\n2. Druk in het nieuwe tabblad op F12 en ga naar het tabblad 'Netwerk' (Network).\n3. Zet blijvende logging aan:\n   • Chrome / Edge / Brave: vink 'Log behouden' (Preserve log) aan.\n   • Firefox: tandwiel ⚙️ ➔ zet 'Logs behouden' (Persist Logs) aan.",
+  "Schritt 2: Bei Miele anmelden": "Stap 2: aanmelden bij Miele",
+  "1. E-Mail und Passwort deines Miele-App-Kontos eingeben und auf „Anmeldung“ 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!": "1. Voer het e-mailadres en wachtwoord van uw Miele-app-account in en klik op 'Aanmelden'.\n2. Belangrijk: na het aanmelden blijft de pagina hangen op een draaiend laadwiel (of toont een fout). Dat is volkomen normaal en betekent dat het aanmelden is gelukt.",
+  "Schritt 3: Adresse kopieren & GroupKey ermitteln": "Stap 3: adres kopiëren en GroupKey ophalen",
+  "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 ermitteln“ klicken.": "1. Scroll in het tabblad Netwerk (F12) naar de allerlaatste (vaak rode) aanvraag die begint met 'redirect?redirect_uri=miele...' of 'miele://oauth2-code/...'.\n2. Klik met rechts op die regel ➔ 'URL kopiëren' (of 'Linkadres kopiëren').\n3. Plak het gekopieerde adres in het veld hieronder en klik op 'GroupKey ophalen'.",
+  "Der Adapter ermittelt die lokalen Zugangsdaten (GroupID/GroupKey) einmalig über eine Anmeldung mit Ihrem Miele-Konto. Die Miele-App funktioniert danach unverändert weiter. Es werden keine Zugangsdaten an Dritte übertragen.": "De adapter haalt de lokale inloggegevens (GroupID/GroupKey) eenmalig op via een aanmelding met uw Miele-account. De Miele-app blijft ongewijzigd werken. Er worden geen gegevens aan derden doorgegeven.",
+  "Nach erfolgreicher Ermittlung stehen GroupID und (verschlüsselt gespeicherter) GroupKey unten im Tab „Erweitert\". Speichern nicht vergessen.": "Na het ophalen staan GroupID en de (versleuteld opgeslagen) GroupKey op het tabblad 'Geavanceerd'. Vergeet niet op te slaan.",
+  "Hintergrund-Suche Intervall in Minuten": "Achtergrond detectie interval in minuten",
+  "Sekundengenaue Rest-/Laufzeit abrufen (DOP2)": "Exacte resterende/verstreken tijd in seconden ophalen (DOP2)",
+  "Sekunden-Abfrageintervall in Sekunden": "Seconden poll-interval in seconden",
+  "Verlauf": "Historie",
+  "Programme mitschreiben": "Programma’s vastleggen",
+  "Einträge im Ringpuffer": "Items in de ringbuffer",
+  "Wie viele der letzten Programme in cyclesJson stehen. Für die Schnellanzeige gedacht; Langzeitdaten kommen aus dem History-Adapter.": "Hoeveel recente programma’s in cyclesJson blijven staan. Bedoeld voor snelle weergave; langetermijndata komt uit de history-adapter.",
+  "Aufbewahrung in Tagen": "Bewaartermijn in dagen",
+  "Ältere Einträge fallen aus dem Ringpuffer. 730 Tage sind zwei Jahre.": "Oudere items vallen uit de ringbuffer. 730 dagen is twee jaar.",
+  "Zusätzlich in den History-Adapter schreiben": "Ook naar de history-adapter schrijven",
+  "Energie, Wasser und Dauer je Programm mit dem Zeitpunkt des Programmendes – damit lassen sich Diagramme über beliebige Zeiträume bauen.": "Energie, water en duur per programma, met het tijdstip van het programma-einde – zo kunnen grafieken elke periode beslaan.",
+  "History-Instanz": "History-instantie",
+  "Der Adapter schreibt jedes abgeschlossene Programm mit: Dauer, Programm, Energie und Wasser. Die Geräte selbst heben abgeschlossene Programme nicht auf, der Verlauf beginnt also mit dem Einschalten dieser Funktion – rückwirkend lässt er sich nicht füllen. Die letzten Programme stehen als JSON unter <Seriennummer>.history.cyclesJson, die Summen daneben.": "De adapter legt elk afgerond programma vast: duur, programma, energie en water. De apparaten bewaren afgeronde programma’s niet zelf, de historie begint dus bij het inschakelen – met terugwerkende kracht vullen kan niet. De laatste programma’s staan als JSON onder <serienummer>.history.cyclesJson, met de totalen ernaast."
 }