iobroker.govee-smart 2.16.2 → 2.17.0

package/README.md

@@ -56,7 +56,7 @@ For details and how to disable it, see the [Sentry plugin documentation](https:/
 ## Requirements
 
 - Node.js >= 22
-- ioBroker js-controller >= 7.1.2
+- ioBroker js-controller >= 7.2.2
 - ioBroker Admin >= 7.8.23
 - A Govee account and at least one Govee WiFi device. LAN control needs a light with LAN mode enabled in the Govee Home app — see Govee's [LAN-supported device list](https://app-h5.govee.com/user-manual/wlan-guide).
 
@@ -64,7 +64,7 @@ For details and how to disable it, see the [Sentry plugin documentation](https:/
 
 ## Getting started
 
-The adapter works LAN-only without any credentials. Adding an API key unlocks scenes, segments, sensors and appliances. Adding your Govee email and password adds real-time status push and full group control. See the [Setup page](https://github.com/krobipd/ioBroker.govee-smart/wiki/Setup) for credential levels, how to get an API key, and network requirements.
+The adapter works LAN-only without any credentials. Adding an API key unlocks scenes, segments and appliance control. Adding your Govee email and password adds sensor readings (temperature/humidity via the App API), real-time status push and full group control. See the [Setup page](https://github.com/krobipd/ioBroker.govee-smart/wiki/Setup) for credential levels, how to get an API key, and network requirements.
 
 ---
 
@@ -78,7 +78,7 @@ Each device shows its test status under `diag.tier`. The [Devices page](https://
 
 Common issues (no devices discovered, empty scenes dropdown, segment colors not changing, limited group commands, delayed status updates) are covered on the Wiki [Behavior](https://github.com/krobipd/ioBroker.govee-smart/wiki/Behavior) / [Verhalten](https://github.com/krobipd/ioBroker.govee-smart/wiki/Verhalten) page.
 
-For anything else, press **`diag.export`** on the affected device, copy the JSON from `diag.result`, and open a [GitHub Issue](https://github.com/krobipd/ioBroker.govee-smart/issues).
+For anything else, set **`diag.export`** to `true` on the affected device, copy the JSON from `diag.result`, and open a [GitHub Issue](https://github.com/krobipd/ioBroker.govee-smart/issues).
 
 ---
 
@@ -94,7 +94,45 @@ This adapter's MQTT authentication and BLE-over-LAN (ptReal) protocol implementa
     Placeholder for the next version (at the beginning of the line):
     ### **WORK IN PROGRESS**
 -->
-### 2.16.2 (2026-06-16)
+### 2.17.0 (2026-07-01)
+
+- **Breaking:** colour datapoints renamed to snake_case — e.g. `control.colorRgb` → `control.color_rgb`, and the colour-temperature one likewise (devices + groups). Update your scripts.
+- Security: the Govee Cloud API key can no longer leak into the ioBroker log — it was written in plaintext on the cloud-events connection and is now masked.
+- Security: the diagnostics export (the JSON you paste into a GitHub issue) no longer contains device or gateway secrets — a gateway's secret key and push topic are now masked.
+- Security: a spoofed LAN discovery reply can no longer redirect a device's commands to another IP — the device address is taken from the real network source, not the packet.
+- Robustness: the Admin "Test login" button is now rate-limited, so repeated clicks can no longer trigger a burst of Govee logins that could get your account temporarily locked.
+- Security: a hostile or misbehaving device on your network can no longer flood the adapter with fake device announcements and slow it down — new devices are now bounded.
+- Fixed: a device you delete from your Govee account is now removed from the adapter on the next cloud refresh (e.g. after a restart), instead of lingering as a phantom device for up to two weeks.
+- New: a "Manually sync devices" button (`info.manual_sync_devices`) — set it to true to sync the device list with your Govee account on demand (add new, drop deleted) without a restart.
+- Fixed: multi-colour DIY scenes activated over the local network now load correctly — longer scenes could previously be corrupted and silently fail to apply.
+- Fixed: after you remove a device and add it again, its info states (name, model, …) are recreated correctly instead of leaving "has no existing object" warnings until the next restart.
+- Fixed: if a Govee push/cloud-events connection connects but can't subscribe (a rare server hiccup), the adapter no longer reconnects every few seconds — the retry now backs off normally.
+- Fixed: the admin "Test login" button now waits for the real MQTT connection before reporting — valid Govee account credentials no longer show a false "MQTT not up, restart the adapter" message.
+- Fixed: on lamps whose music modes start at zero, the first mode was unreachable and "off" was missing — the music-mode selector is fixed. **Breaking:** its numbers shift by one, adjust scripts.
+- Fixed: cloud snapshots whose value is a plain number are no longer dropped from the snapshot dropdown, and an entry with an empty value no longer shows up as a phantom option.
+- Fixed: clearing the preset-scene selector no longer fires a spurious empty scene command.
+- Fixed: DIY scenes you create in the Govee app now show up in the DIY dropdown after a reload, instead of only on the very first load.
+- Fixed: a malformed `segments.command` (e.g. `;` instead of `:`) now logs a clear warning with the expected syntax instead of being silently ignored.
+- Fixed: a command to a group with no reachable members (or where every member fails) is no longer reported as successful — it warns and leaves the state un-acknowledged, like a single device.
+- Fixed: setting music sensitivity or auto-color on a LAN-controlled light no longer silently appears to succeed — the adapter now makes clear only the music mode applies locally.
+- Fixed: an out-of-range segment range in `segments.command` (e.g. `0-2000000000`) is now clamped to the protocol limit instead of briefly freezing the adapter while it expands the range.
+- Fixed: the segment-detection wizard now leaves your light off after it finishes or is cancelled if it was off before — it no longer leaves a light on that you had switched off.
+- Fixed: the segment-detection wizard now restores your strip's original per-segment gradient on finish/abort instead of flattening it to a single colour — a uniformly-coloured strip is unaffected.
+- Fixed: starting the segment-detection wizard twice in quick succession can no longer open two overlapping sessions.
+- Fixed: the Govee account email field no longer shows a "valid email" error when you leave it empty — LAN-only and API-key-only setups no longer see a false validation error.
+- Fixed: per-segment colour and brightness now show a default value instead of reading as null in visualizations before the first change.
+- Fixed: sensor readings (temperature/humidity/battery/CO₂) now default to 0 instead of null in visualizations before the first reading arrives.
+- Fixed: device groups no longer expose a meaningless "verified" trust-tier datapoint (the trust tier only applies to real devices, not groups).
+- Fixed: cleaner shutdown/restart — the adapter no longer opens a cloud connection or reports a stray error after it has been told to stop.
+- Fixed: a broken rate-limit reply from Govee no longer causes rapid repeated retries — the adapter now waits at least 5 seconds before trying again.
+- Fixed: under heavy cloud load a fresh control command (power/brightness) is no longer dropped in favour of queued scene activations.
+- Fixed: a LAN light no longer loses its power and colour controls after a cloud data refresh.
+- Added: device catalog entries for the H5109 Pool Thermometer and H1630 Lantern Floor Lamp (user-reported) — they are now recognised instead of logging a "not supported" warning.
+- Fixed: a sensor sending fresh readings now shows `info.online = true` even when Govee's cloud wrongly reports it offline (e.g. gateway thermometers) — online is derived from data freshness.
+- Fixed: temperature-only sensors no longer keep a phantom humidity datapoint stuck at 0 — a device with no humidity sensor drops it, while a real thermo-hygrometer keeps its humidity.
+- Fixed: a rejected Govee API key is now always reported as "API key rejected — check Govee API key" and stops the retry loop, instead of a generic error and retrying a bad key forever.
+
+### 2.16.2 (2026-06-16) — stable
 - On hosts with multiple network interfaces, LAN device discovery now uses the selected interface for outgoing traffic, so it no longer misses devices by scanning on the wrong one.
 
 ### 2.16.1 (2026-06-11)
@@ -108,16 +146,12 @@ This adapter's MQTT authentication and BLE-over-LAN (ptReal) protocol implementa
 - Lights and appliances without a local connection can now be controlled through the Cloud and report their correct online status; devices that support local control keep using it first.
 - When account verification, the Cloud API key or the Govee password needs your attention, the adapter now flags it once clearly and as an ioBroker notification instead of repeating the same error.
 - Added many more supported device models to the catalog, including Curtain Lights v1 and v2, the TV Backlight 3 Pro and the DreamView T1.
-- Requires ioBroker js-controller 7.1.2 or newer.
+- Requires ioBroker js-controller 7.2.2 or newer.
 
 ### 2.15.0 (2026-06-07)
 
 - Added optional Sentry error reporting: crashes are sent to the developer so issues get fixed faster. Active only with ioBroker diagnostics enabled; anonymous.
 
-### 2.14.1 (2026-06-05)
-
-- Corrected the ioBroker role of the scene, mode and snapshot selector states (no change to how they work)
-
 [Older changelogs can be found there](CHANGELOG_OLD.md)
 
 ## Support

package/admin/i18n/de.json

@@ -82,11 +82,7 @@
   "localSnapshotDesc": "Snapshots, die dieser Adapter lokal auf dem ioBroker-Server gespeichert hat. Unabhängig von der Govee-Home-App.",
   "localSnapshotsFolder": "Vom Benutzer gespeicherte lokale Snapshots",
   "logAbortFailed": "Abbruch des Assistenten nach Timeout fehlgeschlagen: {msg}",
-  "logDetected": "Segment-Assistent für {name}: {count} Segmente erkannt{gaps}",
-  "logGapsSuffix": ", Lücken erkannt (manual_list=\"{list}\")",
-  "logIdleTimeout": "Segment-Assistent für {name}: Idle-Timeout (5 Min), abgebrochen",
-  "logNoGapsSuffix": ", keine Lücken",
-  "manualListDesc": "manualListDesc",
+  "manualListDesc": "Indizes und Bereiche durch Kommas getrennt, z. B. „0-9\" oder „0-8,10-14\" (nur wenn manual_mode=true)",
   "manualSegmentList": "Manuelle Segmentliste",
   "manualSegmentsActive": "Manuelle Segmente aktiv",
   "manualSegmentsDesc": "Manuelle Segmentliste aktivieren (z.B. für gekürzte LED-Strips mit weniger physischen Segmenten als gemeldet)",
@@ -126,6 +122,7 @@
   "scene": "Szene",
   "sceneSpeed": "Szenen-Geschwindigkeit",
   "seenSoFar": "Bisher als sichtbar markiert: [{list}]",
+  "segmentCount": "Segment-Anzahl",
   "segmentFlashing": "► Segment {idx} leuchtet jetzt WEISS.",
   "segmentWizardDeviceOption": "%s (%s, bisher %s Segmente)",
   "supportHeader": "Unterstützung",

package/admin/i18n/en.json

@@ -82,11 +82,7 @@
   "localSnapshotDesc": "Snapshots saved by this adapter on the ioBroker server. Independent of the Govee Home app.",
   "localSnapshotsFolder": "User-saved local snapshots",
   "logAbortFailed": "Wizard abort after timeout failed: {msg}",
-  "logDetected": "Segment wizard for {name}: {count} segments detected{gaps}",
-  "logGapsSuffix": ", gaps detected (manual_list=\"{list}\")",
-  "logIdleTimeout": "Segment wizard for {name}: idle timeout (5 min), aborted",
-  "logNoGapsSuffix": ", no gaps",
-  "manualListDesc": "manualListDesc",
+  "manualListDesc": "Indices and ranges separated by commas, e.g. \"0-9\" or \"0-8,10-14\" (only if manual_mode=true)",
   "manualSegmentList": "Manual Segment List",
   "manualSegmentsActive": "Manual Segments Active",
   "manualSegmentsDesc": "Enable manual segment list (e.g. for cut LED strips with fewer physical segments than reported)",
@@ -126,6 +122,7 @@
   "scene": "Scene",
   "sceneSpeed": "Scene Speed",
   "seenSoFar": "Marked visible so far: [{list}]",
+  "segmentCount": "Segment Count",
   "segmentFlashing": "► Segment {idx} is now lit WHITE.",
   "segmentWizardDeviceOption": "%s (%s, currently %s segments)",
   "supportHeader": "Support",

package/admin/i18n/es.json

@@ -59,7 +59,7 @@
   "finishDone": "✓ ¡LISTO!",
   "finishGaps": "Lista de espacios: {list}: modo manual activo.",
   "finishNoGaps": "Sin espacios: modo manual desactivado.",
-  "finishTreeRebuilt": "El árbol estatal ha sido reconstruido.",
+  "finishTreeRebuilt": "El árbol de estados ha sido reconstruido.",
   "groups": "Grupos",
   "groupsStatus": "Estado de grupos",
   "humidity": "Humedad",
@@ -82,11 +82,7 @@
   "localSnapshotDesc": "Snapshots guardados por este adaptador en el servidor ioBroker. Independiente de la app Govee Home.",
   "localSnapshotsFolder": "Instantáneas locales guardadas por el usuario",
   "logAbortFailed": "Error en la cancelación del asistente después del tiempo de espera: {msg}",
-  "logDetected": "Asistente de segmentos para {name}: {count} segmentos detectados{gaps}",
-  "logGapsSuffix": ", lagunas detectadas (manual_list=\"{list}\")",
-  "logIdleTimeout": "Asistente de segmentos para {name}: tiempo de espera de inactividad (5 minutos), cancelado",
-  "logNoGapsSuffix": ", sin espacios",
-  "manualListDesc": "manualListDesc",
+  "manualListDesc": "Índices y rangos separados por comas, p. ej. \"0-9\" o \"0-8,10-14\" (solo si manual_mode=true)",
   "manualSegmentList": "Lista de segmentos manuales",
   "manualSegmentsActive": "Segmentos manuales activos",
   "manualSegmentsDesc": "Activa la lista manual de segmentos (p. ej. para tiras LED cortadas con menos segmentos físicos)",
@@ -126,6 +122,7 @@
   "scene": "Escena",
   "sceneSpeed": "Velocidad de escena",
   "seenSoFar": "Marcado visible hasta el momento: [{list}]",
+  "segmentCount": "Número de segmentos",
   "segmentFlashing": "► El segmento {idx} ahora está iluminado en BLANCO.",
   "segmentWizardDeviceOption": "%s (%s, actualmente %s segmentos)",
   "supportHeader": "Apoyo",

package/admin/i18n/fr.json

@@ -82,10 +82,6 @@
   "localSnapshotDesc": "Snapshots enregistrés par cet adaptateur sur le serveur ioBroker. Indépendants de l'app Govee Home.",
   "localSnapshotsFolder": "Snapshots locaux enregistrés par l'utilisateur",
   "logAbortFailed": "Abandon de l'assistant après échec du délai d'attente : {msg}",
-  "logDetected": "Assistant de segment pour {name} : {count} segments détectés{gaps}",
-  "logGapsSuffix": ", lacunes détectées (manual_list=\"{list}\")",
-  "logIdleTimeout": "Assistant de segment pour {name} : délai d'inactivité (5 minutes), abandonné",
-  "logNoGapsSuffix": ", pas de lacunes",
   "manualListDesc": "Indices + plages séparés par des virgules, p. ex. « 0-9 » ou « 0-8,10-14 » (seulement si manual_mode=true)",
   "manualSegmentList": "Liste des segments manuels",
   "manualSegmentsActive": "Segments manuels actifs",
@@ -126,6 +122,7 @@
   "scene": "Scène",
   "sceneSpeed": "Vitesse de la scène",
   "seenSoFar": "Marqué visible jusqu'à présent : [{list}]",
+  "segmentCount": "Nombre de segments",
   "segmentFlashing": "► Le segment {idx} est maintenant allumé en BLANC.",
   "segmentWizardDeviceOption": "%s (%s, actuellement %s segments)",
   "supportHeader": "Soutien",

package/admin/i18n/it.json

@@ -82,11 +82,7 @@
   "localSnapshotDesc": "Snapshot salvati da questo adattatore sul server ioBroker. Indipendenti dall'app Govee Home.",
   "localSnapshotsFolder": "Snapshot locali salvati dall'utente",
   "logAbortFailed": "Interruzione della procedura guidata dopo timeout non riuscita: {msg}",
-  "logDetected": "Procedura guidata per i segmenti per {name}: {count} segmenti rilevati{gaps}",
-  "logGapsSuffix": ", lacune rilevate (manual_list=\"{list}\")",
-  "logIdleTimeout": "Procedura guidata per il segmento per {name}: timeout di inattività (5 min), interrotto",
-  "logNoGapsSuffix": ", senza lacune",
-  "manualListDesc": "manualListDesc",
+  "manualListDesc": "Indici e intervalli separati da virgole, es. \"0-9\" o \"0-8,10-14\" (solo se manual_mode=true)",
   "manualSegmentList": "Elenco segmenti manuali",
   "manualSegmentsActive": "Segmenti manuali attivi",
   "manualSegmentsDesc": "Abilita la lista manuale dei segmenti (es. per strisce LED tagliate con meno segmenti fisici)",
@@ -126,6 +122,7 @@
   "scene": "Scena",
   "sceneSpeed": "Velocità scena",
   "seenSoFar": "Contrassegnato come visibile finora: [{list}]",
+  "segmentCount": "Numero di segmenti",
   "segmentFlashing": "► Il segmento {idx} ora è illuminato in BIANCO.",
   "segmentWizardDeviceOption": "%s (%s, attualmente %s segmenti)",
   "supportHeader": "Supporto",

package/admin/i18n/nl.json

@@ -1,7 +1,7 @@
 {
   "abortRestart": "U kunt de wizard op elk gewenst moment opnieuw starten.",
   "abortRestored": "De strip is in de oude staat hersteld.",
-  "abortTitle": "Tovenaar afgebroken.",
+  "abortTitle": "Assistent afgebroken.",
   "aboutInfo": "Deze adapter is gratis en open source. Als u het nuttig vindt, overweeg dan om de ontwikkeling te ondersteunen.",
   "advancedHeader": "Geavanceerde opties",
   "apiKeyLabel": "API-sleutel",
@@ -59,7 +59,7 @@
   "finishDone": "✓ KLAAR!",
   "finishGaps": "Gap-lijst: {list} — handmatige modus actief.",
   "finishNoGaps": "Geen gaten - handmatige modus uitgeschakeld.",
-  "finishTreeRebuilt": "De staatsboom is opnieuw opgebouwd.",
+  "finishTreeRebuilt": "De statusboom is opnieuw opgebouwd.",
   "groups": "Groepen",
   "groupsStatus": "Groepsstatus",
   "humidity": "Luchtvochtigheid",
@@ -82,11 +82,7 @@
   "localSnapshotDesc": "Snapshots die deze adapter op de ioBroker-server opslaat. Onafhankelijk van de Govee Home-app.",
   "localSnapshotsFolder": "Door gebruiker opgeslagen lokale snapshots",
   "logAbortFailed": "Wizard afbreken na time-out mislukt: {msg}",
-  "logDetected": "Segmentwizard voor {name}: {count} segmenten gedetecteerd{gaps}",
-  "logGapsSuffix": ", hiaten gedetecteerd (manual_list=\"{list}\")",
-  "logIdleTimeout": "Segmentwizard voor {name}: time-out bij inactiviteit (5 min), afgebroken",
-  "logNoGapsSuffix": ", geen gaten",
-  "manualListDesc": "manualListDesc",
+  "manualListDesc": "Indexen en bereiken gescheiden door komma's, bijv. \"0-9\" of \"0-8,10-14\" (alleen als manual_mode=true)",
   "manualSegmentList": "Handmatige segmentlijst",
   "manualSegmentsActive": "Handmatige segmenten actief",
   "manualSegmentsDesc": "Handmatige segmentlijst inschakelen (bv. voor ingekorte LED-strips met minder fysieke segmenten)",
@@ -126,6 +122,7 @@
   "scene": "Scène",
   "sceneSpeed": "Scènesnelheid",
   "seenSoFar": "Tot nu toe als zichtbaar gemarkeerd: [{list}]",
+  "segmentCount": "Aantal segmenten",
   "segmentFlashing": "► Segment {idx} is nu WIT verlicht.",
   "segmentWizardDeviceOption": "%s (%s, momenteel %s segmenten)",
   "supportHeader": "Steun",

package/admin/i18n/pl.json

@@ -1,7 +1,7 @@
 {
   "abortRestart": "Możesz ponownie uruchomić kreatora w dowolnym momencie.",
   "abortRestored": "Pasek został przywrócony do poprzedniego stanu.",
-  "abortTitle": "Czarodziej przerwany.",
+  "abortTitle": "Kreator przerwany.",
   "aboutInfo": "Ten adapter jest darmowy i open source. Jeśli uznasz to za przydatne, rozważ wsparcie rozwoju.",
   "advancedHeader": "Opcje zaawansowane",
   "apiKeyLabel": "Klucz API",
@@ -82,11 +82,7 @@
   "localSnapshotDesc": "Snapshoty zapisane przez ten adapter na serwerze ioBroker. Niezależne od aplikacji Govee Home.",
   "localSnapshotsFolder": "Lokalne migawki zapisane przez użytkownika",
   "logAbortFailed": "Kreator przerwał pracę po nieudanym przekroczeniu limitu czasu: {msg}",
-  "logDetected": "Kreator segmentów dla {name}: wykryto {count} segmentów{gaps}",
-  "logGapsSuffix": ", wykryto luki (manual_list=\"{list}\")",
-  "logIdleTimeout": "Kreator segmentów dla {name}: przekroczenie limitu czasu bezczynności (5 min), przerwane",
-  "logNoGapsSuffix": ", brak luk",
-  "manualListDesc": "manualListDesc",
+  "manualListDesc": "Indeksy i zakresy oddzielone przecinkami, np. \"0-9\" lub \"0-8,10-14\" (tylko jeśli manual_mode=true)",
   "manualSegmentList": "Lista ręcznych segmentów",
   "manualSegmentsActive": "Ręczne segmenty aktywne",
   "manualSegmentsDesc": "Włącz ręczną listę segmentów (np. dla skróconych LED-strips z mniejszą liczbą fizycznych segmentów)",
@@ -126,6 +122,7 @@
   "scene": "Scena",
   "sceneSpeed": "Prędkość sceny",
   "seenSoFar": "Oznaczono jako widoczne do tej pory: [{list}]",
+  "segmentCount": "Liczba segmentów",
   "segmentFlashing": "► Segment {idx} świeci się teraz na BIAŁO.",
   "segmentWizardDeviceOption": "%s (%s, obecnie %s segmentów)",
   "supportHeader": "Wsparcie",

package/admin/i18n/pt.json

@@ -82,11 +82,7 @@
   "localSnapshotDesc": "Snapshots guardados por este adaptador no servidor ioBroker. Independente da app Govee Home.",
   "localSnapshotsFolder": "Snapshots locais salvos pelo utilizador",
   "logAbortFailed": "Falha na interrupção do assistente após tempo limite: {msg}",
-  "logDetected": "Assistente de segmento para {name}: {count} segmentos detectados{gaps}",
-  "logGapsSuffix": ", lacunas detectadas (manual_list=\"{list}\")",
-  "logIdleTimeout": "Assistente de segmento para {name}: tempo limite de inatividade (5 min), abortado",
-  "logNoGapsSuffix": ", sem lacunas",
-  "manualListDesc": "manualListDesc",
+  "manualListDesc": "Índices e intervalos separados por vírgulas, ex. \"0-9\" ou \"0-8,10-14\" (apenas se manual_mode=true)",
   "manualSegmentList": "Lista de segmentos manuais",
   "manualSegmentsActive": "Segmentos manuais ativos",
   "manualSegmentsDesc": "Ativar lista manual de segmentos (p.ex. para LED-strips cortadas com menos segmentos físicos do que reportado)",
@@ -126,6 +122,7 @@
   "scene": "Cena",
   "sceneSpeed": "Velocidade da cena",
   "seenSoFar": "Marcado como visível até agora: [{list}]",
+  "segmentCount": "Número de segmentos",
   "segmentFlashing": "► O segmento {idx} agora está aceso em BRANCO.",
   "segmentWizardDeviceOption": "%s (%s, atualmente %s segmentos)",
   "supportHeader": "Apoiar",

package/admin/i18n/ru.json

@@ -82,11 +82,7 @@
   "localSnapshotDesc": "Снапшоты, сохранённые этим адаптером на сервере ioBroker. Независимо от приложения Govee Home.",
   "localSnapshotsFolder": "Сохранённые пользователем локальные снимки",
   "logAbortFailed": "Прерывание работы мастера после истечения времени ожидания: {msg}",
-  "logDetected": "Мастер сегментирования для {name}: обнаружено {count} сегментов{gaps}",
-  "logGapsSuffix": ", обнаружены пробелы (manual_list=\"{list}\")",
-  "logIdleTimeout": "Мастер сегментирования для {name}: тайм-аут простоя (5 минут), прервано",
-  "logNoGapsSuffix": ", без пробелов",
-  "manualListDesc": "manualListDesc",
+  "manualListDesc": "Индексы и диапазоны через запятую, напр. «0-9» или «0-8,10-14» (только если manual_mode=true)",
   "manualSegmentList": "Список ручных сегментов",
   "manualSegmentsActive": "Ручные сегменты активны",
   "manualSegmentsDesc": "Включить ручной список сегментов (например, для обрезанных LED-strip с меньшим числом физических сегментов)",
@@ -126,6 +122,7 @@
   "scene": "Сцена",
   "sceneSpeed": "Скорость сцены",
   "seenSoFar": "Отмечено как видимое на данный момент: [{list}]",
+  "segmentCount": "Количество сегментов",
   "segmentFlashing": "► Сегмент {idx} теперь горит БЕЛЫМ.",
   "segmentWizardDeviceOption": "%s (%s, в настоящее время сегментов %s)",
   "supportHeader": "Поддерживать",

package/admin/i18n/uk.json

@@ -59,7 +59,7 @@
   "finishDone": "✓ ГОТОВО!",
   "finishGaps": "Список пропусків: {list} — ручний режим активний.",
   "finishNoGaps": "Без пропусків — ручний режим вимкнено.",
-  "finishTreeRebuilt": "Державне дерево відбудовано.",
+  "finishTreeRebuilt": "Дерево станів відбудовано.",
   "groups": "Групи",
   "groupsStatus": "Статус груп",
   "humidity": "Вологість",
@@ -82,11 +82,7 @@
   "localSnapshotDesc": "Знімки, збережені цим адаптером на сервері ioBroker. Незалежно від додатка Govee Home.",
   "localSnapshotsFolder": "Збережені користувачем локальні знімки",
   "logAbortFailed": "Майстер припинив роботу після тайм-ауту: {msg}",
-  "logDetected": "Майстер сегментів для {name}: {count} сегментів виявлено{gaps}",
-  "logGapsSuffix": ", виявлено прогалини (manual_list=\"{list}\")",
-  "logIdleTimeout": "Майстер сегментів для {name}: тайм-аут простою (5 хв), перервано",
-  "logNoGapsSuffix": ", без пропусків",
-  "manualListDesc": "manualListDesc",
+  "manualListDesc": "Індекси та діапазони через кому, напр. «0-9» або «0-8,10-14» (лише якщо manual_mode=true)",
   "manualSegmentList": "Список ручних сегментів",
   "manualSegmentsActive": "Ручні сегменти активні",
   "manualSegmentsDesc": "Увімкнути ручний перелік сегментів (наприклад, для обрізаних LED-strips із меншою кількістю сегментів)",
@@ -126,6 +122,7 @@
   "scene": "Сцена",
   "sceneSpeed": "Швидкість сцени",
   "seenSoFar": "Позначено як видимий: [{list}]",
+  "segmentCount": "Кількість сегментів",
   "segmentFlashing": "► Сегмент {idx} тепер світиться БІЛИМ.",
   "segmentWizardDeviceOption": "%s (%s, наразі %s сегментів)",
   "supportHeader": "Підтримка",

package/admin/i18n/zh-cn.json

@@ -1,7 +1,7 @@
 {
   "abortRestart": "您可以随时重新启动向导。",
   "abortRestored": "该地带已恢复到之前的状态。",
-  "abortTitle": "向导失败了。",
+  "abortTitle": "向导已中止。",
   "aboutInfo": "该适配器是免费且开源的。如果您觉得有用，请考虑支持开发。",
   "advancedHeader": "高级选项",
   "apiKeyLabel": "API密钥",
@@ -82,11 +82,7 @@
   "localSnapshotDesc": "由本适配器保存在 ioBroker 服务器上的快照。与 Govee Home 应用无关。",
   "localSnapshotsFolder": "用户保存的本地快照",
   "logAbortFailed": "超时失败后向导中止：{msg}",
-  "logDetected": "{name} 的分段向导：检测到 {count} 个分段{gaps}",
-  "logGapsSuffix": "，检测到间隙（manual_list=\"{list}\"）",
-  "logIdleTimeout": "{name} 的分段向导：空闲超时（5 分钟），已中止",
-  "logNoGapsSuffix": "，无间隙",
-  "manualListDesc": "manualListDesc",
+  "manualListDesc": "以逗号分隔的索引和范围，例如 \"0-9\" 或 \"0-8,10-14\"（仅当 manual_mode=true 时）",
   "manualSegmentList": "手动分段列表",
   "manualSegmentsActive": "手动分段已启用",
   "manualSegmentsDesc": "启用手动分段列表（例如剪短的 LED 灯带，物理分段数少于报告值）",
@@ -126,6 +122,7 @@
   "scene": "场景",
   "sceneSpeed": "场景速度",
   "seenSoFar": "到目前为止标记为可见：[{list}]",
+  "segmentCount": "分段数量",
   "segmentFlashing": "► 段 {idx} 现在呈白色亮起。",
   "segmentWizardDeviceOption": "%s（%s，当前有 %s 个段）",
   "supportHeader": "支持",

package/admin/jsonConfig.json

@@ -119,7 +119,7 @@
           "md": 4,
           "lg": 4,
           "xl": 4,
-          "validator": "data.goveeEmail.includes('@')",
+          "validator": "!data.goveeEmail || data.goveeEmail.includes('@')",
           "validatorErrorText": "validatorEmailError"
         },
         "goveePassword": {

package/build/lib/capability-mapper.js

@@ -23,9 +23,11 @@ __export(capability_mapper_exports, {
   buildCloudStateDefs: () => buildCloudStateDefs,
   buildLanStateDefs: () => buildLanStateDefs,
   getDefaultLanStates: () => getDefaultLanStates,
+  getMusicModeOptions: () => getMusicModeOptions,
   hasDynamicSceneCapability: () => hasDynamicSceneCapability,
   mapCapabilities: () => mapCapabilities,
   mapCloudStateValue: () => mapCloudStateValue,
+  musicModeNameUsesRgb: () => musicModeNameUsesRgb,
   planCloudCapabilityWrites: () => planCloudCapabilityWrites
 });
 module.exports = __toCommonJS(capability_mapper_exports);
@@ -94,7 +96,7 @@ function hasDynamicSceneCapability(capabilities, instance) {
     (cap) => typeof (cap == null ? void 0 : cap.type) === "string" && typeof (cap == null ? void 0 : cap.instance) === "string" && (cap.type === import_govee_constants.GOVEE_CAP_TYPE.DYNAMIC_SCENE || cap.type === "dynamic_scene") && cap.instance === instance
   );
 }
-const LAN_STATE_IDS = /* @__PURE__ */ new Set(["power", "brightness", "colorRgb", "colorTemperature"]);
+const LAN_STATE_IDS = /* @__PURE__ */ new Set(["power", "brightness", "color_rgb", "color_temperature"]);
 function getDefaultLanStates() {
   return [
     {
@@ -121,7 +123,7 @@ function getDefaultLanStates() {
       capabilityInstance: "brightness"
     },
     {
-      id: "colorRgb",
+      id: "color_rgb",
       name: (0, import_i18n.tName)("colorRgb"),
       type: "string",
       role: "level.color.rgb",
@@ -131,7 +133,7 @@ function getDefaultLanStates() {
       capabilityInstance: "colorRgb"
     },
     {
-      id: "colorTemperature",
+      id: "color_temperature",
       name: (0, import_i18n.tName)("colorTemperature"),
       type: "number",
       role: "level.color.temperature",
@@ -252,7 +254,7 @@ function mapColorSetting(cap) {
   if (cap.instance === "colorRgb") {
     return [
       {
-        id: "colorRgb",
+        id: "color_rgb",
         name: (0, import_i18n.tName)("colorRgb"),
         type: "string",
         role: "level.color.rgb",
@@ -267,7 +269,7 @@ function mapColorSetting(cap) {
     const range = (_a = cap.parameters) == null ? void 0 : _a.range;
     return [
       {
-        id: "colorTemperature",
+        id: "color_temperature",
         name: (0, import_i18n.tName)("colorTemperature"),
         type: "number",
         role: "level.color.temperature",
@@ -336,6 +338,8 @@ function mapProperty(cap) {
       role,
       write: false,
       unit: (_b = normalizeUnit((_a = cap.parameters) == null ? void 0 : _a.unit)) != null ? _b : unit,
+      def: 0,
+      // avoid null in vis until the first sensor reading (consistency — B11)
       capabilityType: cap.type,
       capabilityInstance: cap.instance,
       channel: "sensor"
@@ -496,6 +500,25 @@ function mapEvent(cap) {
     }
   ];
 }
+function musicModeNameUsesRgb(name) {
+  if (typeof name !== "string") {
+    return false;
+  }
+  const n = name.trim().toLowerCase();
+  return n === "spectrum" || n === "rolling";
+}
+function getMusicModeOptions(cap) {
+  var _a;
+  const fields = (_a = cap.parameters) == null ? void 0 : _a.fields;
+  if (!Array.isArray(fields)) {
+    return [];
+  }
+  const modeField = fields.find((f) => f && typeof f.fieldName === "string" && f.fieldName === "musicMode");
+  if (!(modeField == null ? void 0 : modeField.options) || !Array.isArray(modeField.options)) {
+    return [];
+  }
+  return modeField.options.filter((o) => !!o && typeof o.name === "string");
+}
 function mapMusicSetting(cap) {
   var _a;
   const fields = (_a = cap.parameters) == null ? void 0 : _a.fields;
@@ -503,22 +526,15 @@ function mapMusicSetting(cap) {
     return [];
   }
   const states = [];
-  const modeField = fields.find((f) => f && typeof f.fieldName === "string" && f.fieldName === "musicMode");
-  if ((modeField == null ? void 0 : modeField.options) && Array.isArray(modeField.options) && modeField.options.length > 0) {
-    const modeStates = { 0: "---" };
-    for (const opt of modeField.options) {
-      if (!opt || typeof opt.name !== "string") {
-        continue;
-      }
-      modeStates[safeStringify(opt.value)] = opt.name;
-    }
+  const modeOptions = getMusicModeOptions(cap);
+  if (modeOptions.length > 0) {
     states.push({
       id: "music_mode",
       name: (0, import_i18n.tName)("musicMode"),
       type: "mixed",
       role: "state",
       write: true,
-      states: modeStates,
+      states: (0, import_types.buildUniqueLabelMap)(modeOptions),
       def: "0",
       capabilityType: cap.type,
       capabilityInstance: cap.instance
@@ -560,11 +576,11 @@ function mapMusicSetting(cap) {
 }
 function applyQuirksToStates(sku, states, log) {
   for (const state of states) {
-    if (state.id === "colorTemperature" && state.min != null && state.max != null) {
+    if (state.id === "color_temperature" && state.min != null && state.max != null) {
       const corrected = (0, import_device_registry.applyColorTempQuirk)(sku, state.min, state.max);
       if (corrected.min !== state.min || corrected.max !== state.max) {
         log.debug(
-          `Quirk applied for ${sku}: colorTemperature range ${state.min}-${state.max}K \u2192 ${corrected.min}-${corrected.max}K`
+          `Quirk applied for ${sku}: color_temperature range ${state.min}-${state.max}K \u2192 ${corrected.min}-${corrected.max}K`
         );
       }
       state.min = corrected.min;
@@ -617,7 +633,7 @@ function mapCloudStateValue(cap) {
       if (cap.instance === "colorRgb") {
         const num = (_b = coerceNum(raw)) != null ? _b : 0;
         return {
-          stateId: "colorRgb",
+          stateId: "color_rgb",
           value: (0, import_types.rgbToHex)(num >> 16 & 255, num >> 8 & 255, num & 255)
         };
       }
@@ -626,7 +642,7 @@ function mapCloudStateValue(cap) {
         if (n === null) {
           return null;
         }
-        return { stateId: "colorTemperature", value: n };
+        return { stateId: "color_temperature", value: n };
       }
       return null;
     case "toggle":
@@ -640,6 +656,9 @@ function mapCloudStateValue(cap) {
       }
       return null;
     case "dynamic_scene":
+      if (cap.instance === "snapshot") {
+        return null;
+      }
       return {
         stateId: sanitizeId(cap.instance),
         value: safeStringify(raw)
@@ -737,7 +756,7 @@ function buildLanStateDefs(device, log) {
   return stateDefs;
 }
 function buildDiagStateDefs(tierDef) {
-  return [
+  const defs = [
     {
       id: "export",
       name: (0, import_i18n.tName)("exportDiagnostics"),
@@ -759,8 +778,10 @@ function buildDiagStateDefs(tierDef) {
       capabilityType: "local",
       capabilityInstance: "diagnosticsResult",
       channel: "diag"
-    },
-    {
+    }
+  ];
+  if (tierDef !== null) {
+    defs.push({
       id: "tier",
       name: (0, import_i18n.tName)("deviceTier"),
       type: "string",
@@ -776,8 +797,9 @@ function buildDiagStateDefs(tierDef) {
       capabilityType: "local",
       capabilityInstance: "diagnosticsTier",
       channel: "diag"
-    }
-  ];
+    });
+  }
+  return defs;
 }
 function buildCloudStateDefs(device, log, localSnapshots, memberDevices) {
   if (device.sku === "BaseGroup") {
@@ -974,7 +996,7 @@ function buildGroupStateDefs(members) {
       });
     }
   }
-  stateDefs.push(...buildDiagStateDefs("verified"));
+  stateDefs.push(...buildDiagStateDefs(null));
   return stateDefs;
 }
 // Annotate the CommonJS export names for ESM import in node:
@@ -984,9 +1006,11 @@ function buildGroupStateDefs(members) {
   buildCloudStateDefs,
   buildLanStateDefs,
   getDefaultLanStates,
+  getMusicModeOptions,
   hasDynamicSceneCapability,
   mapCapabilities,
   mapCloudStateValue,
+  musicModeNameUsesRgb,
   planCloudCapabilityWrites
 });
 //# sourceMappingURL=capability-mapper.js.map