Cycles Smart-Home-Integration, kostenlos und Open Source

Wechselmodell und Schichtarbeit als Gladys-Kalender: wer die Kinder hat, heutige Schicht.

• Veröffentlicht von guim31
• Geräte
• Version 1.0.0
• Erfordert Gladys >=5.2.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Wechselmodell und Schichtarbeit als Gladys-Kalender. Wähle ein Modell (jede zweite Woche, 2-2-3, 5-Schicht, 12-Stunden-Schichten, Bereitschaftswochen…) und das Datum seines ersten Tages: Die Integration erzeugt den Kalender Monate im Voraus und hält ihn jede Nacht aktuell. Nichts wird heruntergeladen, kein Konto ist nötig: Jeder Termin wird in Gladys berechnet.

Was du bekommst

• Ein Kalender pro Zyklus, bis zu drei pro Benutzer: „Kinder bei mir“ / „Kinder beim anderen Elternteil“ von einer Übergabe zur nächsten, oder „Frühschicht“, „Nachtschicht“, „Bereitschaft“… mit ihren Zeiten. Diese Kalender erscheinen in der Kalenderansicht von Gladys wie jeder andere Kalender.
• Zwei Szenen-Auslöser: Die Kinder kommen oder gehen, eine Schicht beginnt oder endet.
• Eine Szenen-Aktion, die sagt, wo ein Zyklus steht: Kinder zu Hause oder nicht, heutige Schicht, nächste Änderung und die Minuten bis dahin.
• Ein Dashboard-Widget: wer die Kinder hat, die laufende Schicht und die nächsten Wechsel.
• Da es gewöhnliche Kalender sind, funktionieren auch die eingebauten Szenen von Gladys: „ein Termin steht bevor“, „läuft gerade ein Termin“.

Zyklen einrichten

Jeder Benutzer richtet seine eigenen Zyklen ein: Öffne Integrationen → Cycles, dann den Block Meine Kalender. Fülle einen Platz aus, dann Aktivieren (oder Speichern). Für jeden Zyklus:

• Modell: siehe die Listen unten. „Nicht genutzt“ lässt den Platz leer (und entfernt seinen Kalender).
• Kalendername: optional. Szenen und Widget sprechen den Zyklus mit diesem Namen an.
• Startdatum: der erste Tag des Modells, zum Beispiel der Freitag, an dem die Kinder für die erste Woche zu dir kamen. Es darf Jahre zurückliegen: Die Integration zählt die Tage. Schreibe es 04.09.2026 oder 2026-09-04.
• Übergabezeit: wann die Kinder wechseln oder eine Bereitschaftswoche beginnt. Leer: 18:00 beim Wechselmodell, 08:00 bei Bereitschaft. 18:00, 18h und 18h30 werden verstanden.
• Am Startdatum: nur Wechselmodell, wer die Kinder am Startdatum hat. Bei den Wochenend-Modellen tauscht „Beim anderen Elternteil“ die Rollen.
• Eigene Folge und Schichtzeiten: siehe unten.

Dann teile den Kalender in der Liste unter dem Formular: Ein geteilter Kalender ist für den ganzen Haushalt sichtbar, auf dem Dashboard und für die Szenen. Ein privater Kalender erscheint nur in deiner eigenen Kalenderansicht.

Modelle für das Wechselmodell

Modell	Folge (ab dem Startdatum)
Jede zweite Woche	7 Tage bei dir, 7 Tage beim anderen Elternteil
2-2-3	2, 2, 3 Tage im Wechsel: Das lange Wochenende wechselt jede Woche den Elternteil
2-2-5-5	2 Tage bei dir, 2 beim anderen, 5 bei dir, 5 beim anderen Elternteil
3-4-4-3	3 Tage bei dir, 4 beim anderen, 4 bei dir, 3 beim anderen Elternteil
1., 3. und 5. Wochenende	Freitag bis Sonntag, die Wochenenden, deren Samstag der 1., 3. oder 5. im Monat ist
2. und 4. Wochenende	dasselbe mit dem 2. und 4. Samstag

Jede Periode läuft von der Übergabezeit ihres ersten Tages bis zur Übergabezeit des Tages nach ihrem letzten Tag: Mit dem Modell 2-2-3 ab einem Montag um 18:00 sind die Kinder von Montag 18:00 bis Mittwoch 18:00 bei dir. Die Wochenend-Modelle brauchen kein Startdatum: Die Wochenenden zählen nach ihrem Samstag, die übliche Regel französischer Urteile.

Modelle für Schichtarbeit

Modell	Folge	Standardzeiten
2-Schicht	5 Früh, 2 frei, 5 Spät, 2 frei	06:00-14:00, 14:00-22:00
3-Schicht wochenweise	5 Früh, 2 frei, 5 Spät, 2 frei, 5 Nacht, 2 frei	Nacht 22:00-06:00
5-Schicht vollkontinuierlich	2 Früh, 2 Spät, 2 Nacht, 4 frei	ebenso
12 h Tag / Nacht	2 Tage, 2 Nächte, 4 frei	07:00-19:00, 19:00-07:00
Bereitschaft jede N-te Woche	7 Tage Bereitschaft, dann N-1 Wochen frei	ab der Übergabezeit, 24 h

Eine Nachtschicht gehört zu dem Tag, an dem sie beginnt: Im Kalender und für die „heutige Schicht“ läuft die Montagnacht von Montag 22:00 bis Dienstag 06:00. Aufeinanderfolgende Bereitschaftstage bilden einen einzigen Termin.

Eigene Folgen

• Wechselmodell, eigene Folge: die Tage jedes Blocks, die Eltern wechseln bei jedem Block, beginnend mit dem unter „Am Startdatum“ gewählten. 2/2/5/5 ist das Modell 2-2-5-5; 7 ist jede zweite Woche; bei einer ungeraden Zahl von Blöcken (2/2/3) tauschen die Eltern in der nächsten Runde. Blöcke von 1 bis 31 Tagen.
• Schichten, eigene Folge: Tage und Buchstaben, M Früh, A Spät, N Nacht, D (oder J) 12-Stunden-Tag, O Bereitschaft, R frei. 2M 2A 2N 4R und MMAANNRRRR sind dieselbe Folge. Bis zu 140 Tage.
• Schichtzeiten: nur was abweicht von M=06:00-14:00; A=14:00-22:00; N=22:00-06:00; D=07:00-19:00, zum Beispiel M=05:00-13:00; N=21:00-05:00. Ein Ende vor dem Beginn liegt am nächsten Tag.

Einstellungen des Administrators

• Termine erzeugen bis: 3, 6 oder 12 Monate im Voraus (Standard 6). Die Kalender rücken jede Nacht weiter: Die vergangene Woche bleibt, dieser Horizont liegt immer voraus. Ältere Termine bleiben als Verlauf.
• Sprache der Szenentexte: Bezeichnungen und Daten, die an Szenen übergeben werden. Die Kalender selbst folgen der Sprache ihres Besitzers.

In Gladys

Die Kalender tragen eine Beschreibung: Startdatum und Übergabezeit, oder warum der Kalender leer ist, wenn ein Feld unlesbar ist. Eine geänderte Einstellung erzeugt den Kalender sofort neu, ohne Doppelungen. Schaltest du die Synchronisierung eines Kalenders unter „Meine Kalender“ aus, wird er geleert; schaltest du sie wieder ein, wird er wieder gefüllt.

Dashboard-Widget

Füge das Widget Cycles zu einem Dashboard hinzu. Es zeigt eine Zeile pro geteiltem Zyklus (grün, wenn die Kinder bei dir sind oder eine Schicht läuft), dann die Wechsel der nächsten 3, 7 oder 14 Tage. Einstellungen: die anzuzeigenden Kalender (Namen durch Kommas getrennt, leer: alle), der Zeitraum und ein Schalter, um die nächsten Wechsel auszublenden.

Szenen-Auslöser

• Kinder kommen oder gehen: zur Übergabezeit eines geteilten Wechselmodell-Kalenders. Filter: der Kalender, Kommen und/oder Gehen. Variablen: der Kalender, sein Besitzer, die Änderung, „Kinder bei mir“ (1 oder 0) und die nächste Übergabe.
• Schicht beginnt oder endet: Eine Schicht oder Bereitschaft eines geteilten Kalenders beginnt oder endet. Filter: der Kalender, Beginn und/oder Ende, die Art der Schicht (nur Nacht…). Variablen: der Kalender, sein Besitzer, die Änderung, die Schicht, ihr Beginn und ihr Ende.

Ein Auslöser kommt innerhalb von 30 Sekunden nach dem Wechsel. Nichts wird ausgelöst, wenn die Integration startet oder du eine Einstellung änderst.

Szenen-Aktion

Stand eines Zyklus abfragen (optional nach Kalendername, sonst der erste geteilte Zyklus) gibt zurück: found (1/0), active (1, wenn die Kinder bei dir sind oder eine Schicht läuft), den aktuellen Zustand, die heutige Schicht (oder wer die Kinder mittags hat), den nächsten Zustand, die nächste Änderung und die Minuten bis dahin (-1, wenn es keine gibt).

Beispielszenen

• Kinder kommen → Heizung in ihren Zimmern auf Komfort; sie gehen → zurück auf Eco.
• Jeden Abend um 21:00 den Stand des Zyklus „Arbeit“ abfragen: Ist die heutige Schicht eine Frühschicht, die Weckszene auf 05:00 stellen.
• Nachtschicht beginnt → Hausbenachrichtigungen stumm bis zu ihrem Ende.
• Mittwoch 17:00, Kinder nicht da (active = 0) → die Szene „zurück von der Schule“ auslassen.

Fehlerbehebung

• Der Kalender ist leer: Lies seine Beschreibung in der Kalenderansicht, sie nennt das unlesbare Feld. Prüfe das Startdatum (04.09.2026 oder 2026-09-04) und die eigene Folge.
• Der Kalender ist um eine Periode verschoben: Das Startdatum ist der erste Tag des Modells, der Tag, an dem die Kinder kamen (sonst muss „Am Startdatum“ den anderen Elternteil nennen). Korrigiere es und speichere.
• Keine Szene startet: Der Kalender muss geteilt sein, und der Filter eines Auslösers braucht den genauen Kalendernamen (die Szenen-Aktion ignoriert Groß- und Kleinschreibung und Akzente).
• Das Widget sagt, dass nichts geteilt ist: Teile den Kalender unter „Meine Kalender“.

Grenzen

• Hälftig geteilte Schulferien werden nicht berücksichtigt: Die Regeln (welche Hälfte, welches Jahr, welche Zone) unterscheiden sich zu stark von Urteil zu Urteil. Ändere in den Ferien das Startdatum oder das Modell, oder trage die Ferien von Hand ein.
• Eine Übergabezeit pro Zyklus (bei den Wochenend-Modellen dieselbe am Freitag und am Sonntag).
• Feiertage verschieben nichts: Die Zyklen laufen weiter.
• Bis zu drei Zyklen pro Benutzer; drei Monate bis ein Jahr im Voraus.

Datenschutz

Nichts verlässt Gladys: Die Integration stellt keine Netzwerkanfrage außerhalb von Gladys und speichert nichts in ihrem Volume. Die Zyklen stehen in deinen Kontoeinstellungen, die Kalender bleiben privat, bis du sie teilst. Ohne Verbindung zu einem Arbeitgeber oder Gericht.

Konfigurationseinstellungen

Diese Einstellungen fragt Cycles in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
So funktioniert es	section	Nein	Jeder Benutzer richtet seine eigenen Zyklen unten unter „Meine Kalender“ ein: Nichts wird heruntergeladen, jeder Termin wird hier berechnet. Diese Einstellungen gelten für alle.
Termine erzeugen bis	select	Nein	Die Kalender rücken jede Nacht weiter: Die vergangene Woche bleibt, dieser Horizont liegt immer voraus.
Sprache der Szenentexte	select	Nein	An Szenen übergebene Bezeichnungen und Daten. Kalender folgen der Sprache ihres Besitzers.

So installierst du Cycles in Gladys

1. Öffne in Gladys Integrationen: Cycles erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-cycles:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-cycles.

Cycles benötigt Gladys >=5.2.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen

Cycles ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

• Alle Integrationen durchsuchen, native und aus der Community
• Deine eigene externe Integration bauen und veröffentlichen
• Quellcode auf GitHub — Quelle dieser Dokumentation

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂