Zum Hauptinhalt springen

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

CardDAV Birthdays-Integration für Gladys Assistant

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=debug fü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.

EinstellungTypPflichtfeldBeschreibung
So funktioniert essectionNeinJeder 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 lesenselectNeinNur Geändertes wird geladen. Eine Kontoänderung wird sofort gelesen.
Uhrzeit der Szenen-ErinnerungenselectNeinWann der Auslöser „Geburtstagserinnerung“ jeden Tag auslöst.
Sprache der SzenentexteselectNeinAn Szenen übergebene Sätze und Daten. Kalender folgen der Sprache ihres Besitzers.

So installierst du CardDAV Birthdays in Gladys​

  1. Öffne in Gladys Integrationen: CardDAV Birthdays 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-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).
  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-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.

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 🙂