Arctic: Zephyr ICU – Day/Night Colors

Version 1.0.27

Dieses Kodi-Service-Add-on wechselt das Farbschema von Arctic: Zephyr ICU automatisch zwischen einer Tag- und einer Nachtfarbe. Die Umschaltung kann entweder anhand von Sonnenauf- und Sonnenuntergang oder zu festen Uhrzeiten erfolgen.

Das Add-on wurde speziell für Arctic: Zephyr ICU (skin.arctic.zephyr.icu) entwickelt. Es verändert keine Skin-Dateien und bleibt inaktiv, solange ein anderer Skin verwendet wird.

Voraussetzungen

• Kodi 22 / Piers
• Arctic: Zephyr ICU als aktiver Skin
• Internetzugang nur für die optionale Standortsuche

Nach erfolgreicher Einrichtung funktionieren sowohl der Sonnenmodus als auch der Modus mit festen Uhrzeiten ohne dauerhaft benötigte Internetverbindung.

Installation

1. Die Datei service.arctic.zephyr.icu.daynight-1.0.27.zip herunterladen bzw. auf das Kodi-Gerät kopieren.
2. In Kodi Einstellungen → Add-ons → Aus ZIP-Datei installieren öffnen.
3. Die ZIP-Datei auswählen und installieren.
4. Anschließend unter Add-ons → Meine Add-ons → Dienste → Arctic: Zephyr ICU – Day/Night Colors die Einstellungen öffnen.
5. Add-on aktivieren eingeschaltet lassen und den gewünschten Modus konfigurieren.

Der Dienst startet mit Kodi automatisch.

Umstieg von der alten Version (service.artic.zephyr.icu.daynight)

Ab Version 1.0.22 lautet die Add-on-ID service.arctic.zephyr.icu.daynight. Beim ersten Start übernimmt der Dienst einmalig alle Einstellungen der alten Version, sofern deren Einstellungsdatei noch vorhanden ist, und meldet das mit einer kurzen Benachrichtigung.

1. Die neue Version installieren, ohne die alte vorher zu deinstallieren.
2. Kodi neu starten bzw. warten, bis der Dienst gestartet ist und die Benachrichtigung erscheint.
3. Danach die alte Version deinstallieren.

Wird die alte Version zuerst deinstalliert, muss die Frage, ob auch die Add-on-Daten gelöscht werden sollen, mit Nein beantwortet werden – sonst gibt es nichts mehr zu übernehmen.

Schnellstart

Sonnenmodus

1. Unter Modus die Einstellung Sonne auswählen.
2. Standort suchen öffnen.
3. Ortsnamen eingeben und den passenden Treffer auswählen.
4. Tagfarbe auswählen und Nachtfarbe auswählen festlegen.
5. Optional den Morgen- und Abend-Offset anpassen.

Die Standortsuche speichert automatisch Standortname, Breitengrad, Längengrad und IANA-Zeitzone.

Feste Uhrzeiten

1. Unter Modus die Einstellung Feste Zeit auswählen.
2. Tag beginnt um öffnen und die gewünschte Uhrzeit einstellen.
3. Nacht beginnt um öffnen und die gewünschte Uhrzeit einstellen.
4. Tagfarbe auswählen und Nachtfarbe auswählen festlegen.

Die beiden Zeiteinträge sind absichtlich immer sichtbar. Sie werden vom Dienst nur ausgewertet, wenn Modus = Feste Zeit eingestellt ist.

Einstellungen im Detail

Direkt unter Add-on aktivieren befinden sich die beiden Schalter Automatische Farbumschaltung aktivieren und Automatische Wetter-Fanart-Umschaltung aktivieren. Die Auswahl der Tag-/Nacht- und Jahreszeiten-Packs erfolgt weiterhin im Bereich Wetter-Fanart.

Allgemein

Add-on aktivieren
Aktiviert oder deaktiviert den Add-on-Dienst. Die Farbumschaltung und die Wetter-Fanart-Umschaltung sind separat einstellbar.

Modus
Bestimmt, wie Tag und Nacht ermittelt werden:

• Sonne – anhand des lokal berechneten Sonnenauf- und Sonnenuntergangs.
• Feste Zeit – anhand der eingestellten Uhrzeiten.

Tagfarbe auswählen
Farbschema, das während des Tages verwendet wird. Voreinstellung: Light.

Nachtfarbe auswählen
Farbschema, das während der Nacht verwendet wird. Voreinstellung: Darkest.

Die verfügbaren Farbschemata werden direkt aus dem Ordner special://skin/colors/ des aktiven ICU-Skins ermittelt. Neue oder entfernte ICU-Farbschemata werden deshalb automatisch berücksichtigt.

Sonnenmodus

Standort suchen

Die Standortsuche verwendet den Open-Meteo-Geocoding-Dienst. Nach Auswahl eines Treffers werden folgende Werte gespeichert:

• Standortname
• Breitengrad
• Längengrad
• IANA-Zeitzone, z. B. Europe/Berlin

Die eigentliche Berechnung von Sonnenauf- und Sonnenuntergang erfolgt anschließend lokal im Add-on. Für den normalen Betrieb ist danach keine Online-Abfrage erforderlich.

Standort manuell eintragen

Alternativ können Standortname, Breitengrad, Längengrad und Zeitzone manuell eingetragen werden. Für eine korrekte Berechnung muss die Zeitzone als gültiger IANA-Name angegeben werden.

Morgen-Offset

Verschiebt den Beginn der Tagfarbe relativ zum berechneten Sonnenaufgang.

Beispiele:

• 30 = Tagfarbe 30 Minuten nach Sonnenaufgang
• -30 = Tagfarbe 30 Minuten vor Sonnenaufgang
• 0 = exakt zum berechneten Sonnenaufgang

Abend-Offset

Verschiebt den Beginn der Nachtfarbe relativ zum berechneten Sonnenuntergang.

Beispiele:

• 30 = Nachtfarbe 30 Minuten nach Sonnenuntergang
• -30 = Nachtfarbe 30 Minuten vor Sonnenuntergang
• 0 = exakt zum berechneten Sonnenuntergang

Für Tage bzw. Regionen ohne normalen Sonnenauf- oder Sonnenuntergang nimmt das Add-on keine erratene Umschaltung vor und lässt die aktuelle Farbe unverändert.

Fester Zeitmodus

Tag beginnt um
Voreinstellung: 07:00.

Nacht beginnt um
Voreinstellung: 20:00.

Beim Öffnen eines Eintrags erscheint der Kodi-Zeitdialog. Die Zeit wird intern im Format HH:MM gespeichert.

Zeitbereiche über Mitternacht werden unterstützt. Beispiel:

• Tag beginnt um 20:00
• Nacht beginnt um 06:00

Dann ist die Tagfarbe von 20:00 Uhr bis 05:59:59 Uhr aktiv.

Sind beide Startzeiten identisch, findet keine automatische Umschaltung über den festen Zeitplan statt.

Verhalten während Wiedergabe und Bildschirmschoner

Standardmäßig wird eine anstehende Umschaltung verschoben, wenn:

• gerade Medien wiedergegeben werden;
• der Kodi-Bildschirmschoner aktiv ist.

Über folgende Optionen kann dieses Verhalten geändert werden:

Wechsel während Medienwiedergabe erlauben
Erlaubt einen Skin-Farbwechsel auch während einer laufenden Wiedergabe.

Wechsel bei aktivem Bildschirmschoner erlauben
Erlaubt einen Wechsel, obwohl der Bildschirmschoner aktiv ist.

Eine verschobene Umschaltung geht nicht verloren. Der Dienst prüft den Zustand beim nächsten Prüfintervall erneut.

Erweitert

Prüfintervall

Legt fest, wie oft der Dienst prüft, ob ein Wechsel erforderlich ist.

• Standard: 30 Sekunden
• Minimum: 10 Sekunden
• Maximum: 300 Sekunden

Eine Umschaltung kann deshalb bis ungefähr zum eingestellten Prüfintervall verzögert erfolgen.

Debug-Protokollierung

Bei aktivierter Debug-Protokollierung schreibt das Add-on zusätzliche Informationen in das Kodi-Log, darunter:

• verwendeter Modus;
• ermittelter Tag-/Nachtstatus;
• Sonnenzeiten und Offsets;
• aktuell aktives und gewünschtes Farbschema;
• verschobene Umschaltungen;
• Fallback-Entscheidungen und Fehler.

Diese Option ist insbesondere für die Fehlersuche hilfreich.

Was passiert beim Farbwechsel?

Das Add-on setzt Kodis Einstellung lookandfeel.skincolors auf das gewünschte ICU-Farbschema und lädt anschließend den Skin neu. Ein kurzer sichtbarer Skin-Reload während des Wechsels ist daher normal.

Falls das konfigurierte Farbschema nicht mehr vorhanden ist, versucht das Add-on eine sichere Alternative. Bevorzugt werden dabei das jeweilige Standard-Tag-/Nachtfarbschema und SKINDEFAULT; andernfalls wird ein vorhandenes Farbschema verwendet.

Offline-Betrieb

Nach gespeicherten Standortdaten arbeitet das Add-on im normalen Betrieb offline:

• Sonnenberechnung lokal
• feste Zeitpläne lokal
• Ermittlung der ICU-Farbschemata lokal
• Prüfung von Wiedergabe und Bildschirmschoner lokal
• Umschaltung des Kodi-Farbschemas lokal

Nur Standort suchen benötigt eine Internetverbindung.

Datenschutz bei der Standortsuche

Bei der optionalen Standortsuche wird der eingegebene Ortsname an den Open-Meteo-Geocoding-Endpunkt übertragen. Das Add-on übermittelt dabei keine Kodi-Bibliotheksdaten, Wiedergabehistorie oder ausgewählten Farbschemata.

Scheitert die Suche oder wird sie abgebrochen, bleiben bereits gespeicherte Standortdaten erhalten.

Fehlerbehebung

Die Farbe wechselt nicht

Prüfen:

1. Ist Arctic: Zephyr ICU der aktive Skin?
2. Ist Add-on aktivieren eingeschaltet?
3. Ist der gewünschte Modus ausgewählt?
4. Sind Tag- und Nachtfarbe noch im ICU-Skin vorhanden?
5. Blockiert gerade eine Medienwiedergabe oder der Bildschirmschoner den Wechsel?
6. Im Modus Feste Zeit: Sind Tag- und Nachtstart unterschiedlich?
7. Im Modus Sonne: Sind Breitengrad, Längengrad und Zeitzone korrekt gespeichert?
8. Falls nötig Debug-Protokollierung aktivieren und das Kodi-Log prüfen.

Standortsuche funktioniert nicht

• Internetverbindung prüfen.
• Einen einfacheren Ortsnamen verwenden.
• Alternativ Breitengrad, Längengrad und Zeitzone manuell eintragen.

Die Standortsuche ist für den späteren Sonnenmodus nicht dauerhaft erforderlich.

Eine ausgewählte Farbe existiert nicht mehr

Das Add-on liest bei jedem Prüfvorgang die aktuell verfügbaren ICU-Farbschemata ein und verwendet bei Bedarf einen Fallback, anstatt einen ungültigen Wert zu erzwingen.

Technische Daten

• Add-on-ID: service.arctic.zephyr.icu.daynight
• Ziel-Skin: skin.arctic.zephyr.icu
• Add-on-Typ: Kodi-Service
• Kodi-Version: 22 / Piers
• Python-API: xbmc.python 3.0.3
• Standard-Prüfintervall: 30 Sekunden
• Standortsuche: Open-Meteo Geocoding

Lizenz

Dieses Projekt steht unter GPL-3.0-only. Siehe LICENSE.

Die optionale Standortsuche verwendet Open-Meteo Geocoding auf Basis von GeoNames-Daten.

Wetter-Fanart-Automatik (Erweiterung)

Der Dienst kann zusätzlich zur Skin-Farbe auch das im ICU-Skin ausgewählte Wetter-Fanart-Pack automatisch wechseln. Die bisherigen Sonnen- und Uhrzeit-Einstellungen gelten für beides. Die Optionen können getrennt ein- und ausgeschaltet werden.

1. Zwei unterschiedliche Wetter-Fanart-Ressourcen in Kodi installieren: eins für Tagmotive, eins für Nachtmotive.
2. Sicherstellen, dass script.image.resource.select installiert/aktiviert ist.
3. In den Einstellungen des Day/Night-Diensts Wetter-Fanart automatisch umschalten aktivieren.
4. Wetter-Fanart-Pack für den Tag auswählen und ... für die Nacht auswählen ausführen.
5. Den vorhandenen Sonnenmodus oder den Modus mit festen Uhrzeiten verwenden.

Die Auswahl erfolgt mit dem Kodi-Resource-Selector und wird als Skin-Einstellung daynight.weather.day.* bzw. daynight.weather.night.* gespeichert. Während der Umschaltung aktualisiert der Dienst die bestehenden Skin-Strings weather.fanart.path und weather.fanart.name. Das ICU-Fanart-Pack v1.0.4 enthält derzeit nur ein Bild je Wettercode und bietet daher keinen zweiten vollständigen Motivsatz: Für sichtbar unterschiedliche Tag-/Nacht-Fanarts werden tatsächlich zwei unterschiedliche Packs benötigt.

Wie beim Farbwechsel gelten Wiedergabe-/Bildschirmschoner-Sperren. Wenn für eine Tagesphase kein Pack gewählt wurde, bleibt das aktuelle Wetter- Fanart unverändert. Ohne aktivierte Wetterautomatik ist das bisherige Verhalten vollständig unverändert.

Hinweis: Diese Änderung ist als Quellcode-Erweiterung gedacht. Sie setzt eine funktionierende Kodi-22-Installation samt ICU-Skin voraus und wurde nicht auf einem Kodi-Gerät live getestet. Add-on-Version vor einem Release anheben.

Saisonale Wetter-Fanart (4 Jahreszeiten × Tag/Nacht)

Unter Jahreszeitliche Wetter-Fanart kann zwischen Nur Tag/Nacht (2 Packs) und Vier Jahreszeiten + Tag/Nacht (8 Packs) gewählt werden. Für Frühling, Sommer, Herbst und Winter stehen jeweils eigene Auswahldialoge für Tag- und Nacht-Wetter-Fanart-Ressourcen zur Verfügung. Dasselbe Pack darf in mehreren Feldern ausgewählt werden.

Die meteorologischen Jahreszeiten gelten für die Nordhalbkugel: Frühling: 1. März–31. Mai, Sommer: 1. Juni–31. August, Herbst: 1. September–30. November, Winter: 1. Dezember–28./29. Februar. Bei Südhalbkugel verschieben sich die Jahreszeiten um sechs Monate. Es werden keine astronomischen Tagundnachtgleichen berechnet.

Ob Tag oder Nacht aktiv ist, wird weiterhin durch den bestehenden Sonnenmodus oder die festen Uhrzeiten bestimmt. Im Sonnenmodus wird für den Jahreszeitenwechsel die eingerichtete Standort-Zeitzone berücksichtigt. Sind die beiden Auswahlen eines bestimmten Saison-Zeitfensters nicht gesetzt, versucht das Add-on das allgemeine Tag-/Nacht-Pack als Fallback. Ist auch das nicht konfiguriert, bleibt das aktuelle Pack unverändert.

Die Wetter-Automatik bleibt standardmäßig ausgeschaltet; die Farbumschaltung bleibt standardmäßig eingeschaltet. Wer aus dem früheren 2-Pack-Patch aktualisiert, behält seine Tag-/Nacht-Zuordnungen und startet standardmäßig mit dem einfachen Modus. script.image.resource.select und installierte Wetter-Fanart-Add-ons sind für die Auswahldialoge erforderlich. Die vom Skin bereits verwendeten weather.fanart.path und weather.fanart.name werden aktualisiert. Ein Kodi-22-Lauftest mit dem Skin ist vor der Veröffentlichung erforderlich.

Beim Wechsel werden auch die vom Kodi-Resource-Selector gelieferten Metadaten .ext und .multi übernommen, damit Packs mit unterschiedlichen Bildformaten oder Mehrfachbildern korrekt ausgewählt werden.

Wetter-Fanart-Diagnose (v1.0.25)

Der Dienst prüft vor dem Aktivieren eines Wetter-Packs, ob alle 49 Wetterbedingungen (0 bis 47 sowie na) unter einem einheitlichen Bildformat vorhanden sind. Unterstützt werden JPG, PNG, JPEG und WebP; alternativ 49 Wettercode-Unterordner (Multi-Fanart). Fehlende Packs werden nicht mehr als gültig übernommen.

Stehen die Bilder nicht unter dem vom Auswahldialog gespeicherten resource://-Pfad, prüft der Dienst alternative Standardverzeichnisse (resources/, images/, fanart/, media/). Nur ein vollständiger Ordner wird verwendet. Ein beschädigtes JPEG oder fehlende Dateien können durch den Dienst nicht repariert werden.

Bei fehlerhaften saisonalen Packs erfolgt der Rückgriff auf ein konfiguriertes, gültiges allgemeines Tag-/Nacht-Pack. Falls kein gültiges Pack vorhanden ist, wird das bisherige Fanart nicht überschrieben und einmalig ein ausführlicher Fehler im Kodi-Log ausgegeben: weather fanart invalid: slot=... found=x/49; missing codes=....

Für den 24. Oktober ist auf der Nordhalbkugel Herbst aktiv. Falls Kodi dennoch das Winter-Day-Pack lädt, prüfen, ob der Modus Vier Jahreszeiten + Tag/Nacht aktiviert wurde oder das Wetter-Pack manuell im Skin ausgewählt ist.

v1.0.26 – Visible selection names

The 10 weather fanart pack selection buttons now show the name of the selected pack on the right, like the time/color selectors. Each slot opens the list of installed resource.images.weatherfanart.* resources and offers an option to clear that slot. The selection is stored in the active skin's original daynight.weather.* properties, while the readable name is saved as a Kodi add-on string setting. After updating from v1.0.24/25 the new string settings are populated from the existing skin selections at service startup.

The image-file verification added in v1.0.25 remains active: a selected but incomplete pack will be shown in the settings, but will not be activated until all 49 required condition images are available. A warning is displayed at selection time and a diagnostic is written to kodi.log by the service.