Arctic: Zephyr ICU – Day/Night Colors

Version 1.0.23

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.23.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

Allgemein

Add-on aktivieren
Schaltet die automatische Farbumschaltung ein oder aus.

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.