CardDAV Birthdays Smart-Home-Integration, kostenlos und Open Source

Die Geburtstage deiner CardDAV-Kontakte (Nextcloud, iCloud…) im Kalender von Gladys.
Die Geburtstage deiner Kontakte im Kalender von Gladys. Verbinde das CardDAV-Adressbuch, mit dem dein Telefon schon synchronisiert (Nextcloud, iCloud, Radicale, Baïkal…): Jeder Kontakt mit Geburtsdatum wird zu einem jährlichen Termin, „Geburtstag von Marie Martin (34 Jahre)“, der mit deinen Kontakten aktuell bleibt. Hochzeitstage können in einem zweiten Kalender folgen.
Mit einem echten Radicale-Server getestet. Nextcloud, iCloud und Baïkal folgen demselben Standard, wurden aber nicht mit einem echten Konto ausprobiert: Rückmeldungen willkommen.
Was du bekommst
- Einen Kalender „Geburtstage“ pro Benutzer, ein Jahr im Voraus mit einem ganztägigen Termin pro Geburtstag gefüllt, mit dem Alter, wenn das Geburtsjahr bekannt ist. Er erscheint in der Kalenderansicht von Gladys wie jeder andere Kalender.
- Einen Kalender „Hochzeitstage“, wenn du ihn möchtest, aus dem
ANNIVERSARY-Datum der Kontakte. - Einen Szenen-Auslöser jeden Morgen zur gewählten Uhrzeit: ein Geburtstag heute, morgen oder in 2, 3, 7, 14 oder 30 Tagen, mit einem fertigen Satz zum Senden oder Vorlesen.
- Eine Szenen-Aktion mit dem nächsten Geburtstag: wer, in wie vielen Tagen, wie alt, und die Geburtstage des Tages.
- Ein Dashboard-Widget mit den nächsten Geburtstagen.
- Da es gewöhnliche Kalender sind, funktionieren auch die eingebauten Szenen von Gladys: „ein Termin steht bevor“.
Dein Adressbuch verbinden
Jeder Benutzer verbindet sein eigenes Adressbuch: Öffne Integrationen → CardDAV Birthdays, dann den Block Meine Kalender, fülle die Felder aus und aktiviere.
- CardDAV-Serveradresse: die Adresse des Servers (die Integration findet die Adressbücher selbst) oder die Adresse eines Adressbuchs.
- Benutzername und Passwort oder App-Passwort: Nutze ein App-Passwort, wann immer der Dienst eines anbietet. Das Passwort wird von Gladys verwahrt und nie in die Protokolle geschrieben.
- Adressbücher: Namen der zu lesenden Adressbücher, durch Kommas getrennt. Leer: alle.
- Auch Hochzeitstage hinzufügen: ein zweiter Kalender mit den
ANNIVERSARY-Daten. - Alter im Terminnamen anzeigen: „Geburtstag von Marie Martin (34 Jahre)“ oder nur „Geburtstag von Marie Martin“.
Dann teile den Kalender (Schalter im selben Block): Nur geteilte Kalender erreichen das Dashboard, die Szenen und die anderen Mitglieder des Haushalts.
Nextcloud
Adresse https://cloud.example.com/remote.php/dav, dein Benutzername und ein App-Passwort, erstellt
unter Einstellungen → Sicherheit → Geräte & Sitzungen. Das System-Adressbuch von Nextcloud (alle
Konten der Instanz) wird ausgelassen, außer du nennst es.
iCloud
Adresse https://contacts.icloud.com, die E-Mail deiner Apple-ID und ein app-spezifisches Passwort,
erstellt auf appleid.apple.com (Anmeldung und Sicherheit → App-spezifische Passwörter). Dein
normales Passwort wird abgelehnt.
Radicale, Baïkal und andere Server
Die Adresse des Servers, zum Beispiel http://192.168.1.10:5232/ für Radicale oder
https://dav.example.com/dav.php für Baïkal. Basic- und Digest-Authentifizierung werden beide
unterstützt.
Google Kontakte
Nicht unterstützt: Das CardDAV von Google akzeptiert nur die OAuth-Anmeldung, die Kalender-Integrationen von Gladys noch nicht anbieten. Deine Google-Kontakte können über einen anderen Server kommen, der sie synchronisiert.
Einstellungen des Administrators
- Adressbücher lesen: stündlich, alle 6 Stunden (Standard) oder einmal am Tag. Nur Geändertes wird geladen; eine Kontoänderung wird sofort gelesen.
- Uhrzeit der Szenen-Erinnerungen: wann der Auslöser „Geburtstagserinnerung“ jeden Tag auslöst (standardmäßig 08:00).
- Sprache der Szenentexte: die an Szenen übergebenen Sätze und Daten. Kalender folgen der Sprache ihres Besitzers, das Widget der Sprache der Person, die es ansieht.
In Gladys
Die Termine sind ganztägig, von einer Woche zurück bis ein Jahr voraus; das Fenster rückt jede Nacht weiter. Ein Geburtstag am 29. Februar wird in Nicht-Schaltjahren am 28. Februar gefeiert. Ein fehlendes oder als Platzhalter geschriebenes Geburtsjahr (Apples 1604, 0000, 1900) ergibt einen Termin ohne Alter.
Dashboard-Widget
Füge das Widget Geburtstage zu einem Dashboard hinzu: die nächsten Geburtstage der geteilten Kalender, die des Tages mit „Heute“ markiert. Einstellungen: wie viele (3, 5 oder 8), Hochzeitstage anzeigen oder nicht, Alter anzeigen oder nicht.
Szenen-Auslöser
Geburtstagserinnerung: jeden Tag zur gewählten Uhrzeit, einmal pro Geburtstag eines geteilten Kalenders.
- Wann: am Tag selbst oder 1, 2, 3, 7, 14 oder 30 Tage vorher.
- Art: Geburtstage, Hochzeitstage oder beide.
- Kontakt: der genaue Name eines Kontakts, oder leer für alle.
Variablen: der Name, ein fertiger Satz („Geburtstag von Marie Martin (34 Jahre): Morgen, Montag, 16. November.“), die verbleibenden Tage, das Alter, das Datum, die Art und der Besitzer des Adressbuchs.
Szenen-Aktion
Nächsten Geburtstag abfragen (Art optional): gefunden (1 oder 0), Name, Art, verbleibende Tage, Datum, ein fertiger Satz, das Alter (0, wenn unbekannt), die Zahl der Geburtstage heute und ihre Namen.
Szenen-Beispiele
- Jeden Morgen um 08:00, „Geburtstagserinnerung“ am Tag selbst → den Satz per Telegram senden.
- „Geburtstagserinnerung“ 7 Tage vorher, Art „Geburtstage“ → „An das Geschenk für {{name}} denken“.
- Beim Heimkommen „Nächsten Geburtstag abfragen“, dann wenn „Geburtstage heute“ größer als 0 ist → den Lautsprecher die Namen sagen lassen.
Fehlerbehebung
- Der Kalender ist leer: Seine Beschreibung unter Meine Kalender sagt, warum das letzte Lesen fehlschlug (Passwort abgelehnt, Server antwortet nicht, kein Adressbuch dieses Namens).
- Benutzername oder Passwort abgelehnt: iCloud und Nextcloud mit Zwei-Faktor-Anmeldung brauchen ein App-Passwort.
- Nichts im Widget oder in den Szenen: Teile den Kalender unter Meine Kalender.
- Protokolle: Integrationen → CardDAV Birthdays → Protokolle;
LOG_LEVEL=debugfür die Details jedes Lesens.
Grenzen
- Nur lesend: In dein Adressbuch wird nie etwas geschrieben.
- Ein CardDAV-Konto pro Benutzer; mehrere Adressbücher dieses Kontos können gelesen werden.
- Kontakte werden höchstens stündlich gelesen: Ein auf dem Telefon hinzugefügter Geburtstag erscheint beim nächsten Lesen.
- Google Kontakte werden nicht unterstützt (siehe oben).
- Nur mit Radicale getestet. Nextcloud, iCloud und Baïkal: Rückmeldungen willkommen.
Datenschutz
Nur der Anzeigename und die Daten eines Kontakts werden gelesen und behalten, im Arbeitsspeicher;
Telefonnummern, Adressen, E-Mails und Notizen verlassen die Integration nie. Die Kalender bleiben
privat, bis ihr Besitzer sie teilt. Serveradresse, Benutzername und Passwort werden von Gladys wie
jede andere Einstellung gespeichert; die Integration schreibt in ihr /data-Volume nur das Datum der
letzten Erinnerungen.
Konfigurationseinstellungen
Diese Einstellungen fragt CardDAV Birthdays in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| So funktioniert es | section | Nein | Jeder Benutzer verbindet unten unter „Meine Kalender“ sein eigenes Adressbuch und erhält einen Geburtstagskalender. Nur Name und Daten eines Kontakts werden gelesen. Diese Einstellungen gelten für alle. |
| Adressbücher lesen | select | Nein | Nur Geändertes wird geladen. Eine Kontoänderung wird sofort gelesen. |
| Uhrzeit der Szenen-Erinnerungen | select | Nein | Wann der Auslöser „Geburtstagserinnerung“ jeden Tag auslöst. |
| Sprache der Szenentexte | select | Nein | An Szenen übergebene Sätze und Daten. Kalender folgen der Sprache ihres Besitzers. |
So installierst du CardDAV Birthdays in Gladys
- Öffne in Gladys Integrationen: CardDAV Birthdays erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-carddav-birthdays:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-carddav-birthdays.
CardDAV Birthdays 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
CardDAV Birthdays 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