CalDAV Community-Integration, kostenlos und Open Source
Sync your CalDAV calendars (Nextcloud, iCloud, Fastmail…) into Gladys.
Veröffentlicht von bertrandda
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.2.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
This integration copies your CalDAV calendars (Nextcloud, iCloud, Fastmail, Baïkal, Radicale, SOGo, Synology Calendar…) into the Gladys calendar. The events show up in the calendar view, can trigger scenes ("an event is coming") and are known by the assistant.
The sync is one way: Gladys reads your CalDAV server and never writes to it. An event created or edited in Gladys on a synced calendar is not sent back to the server.
Enable the integration for your account
Every Gladys user enables the integration for themselves: your calendars are personal data, nothing is synced until you enable it.
- Open the CalDAV integration, Configuration tab.
- In the My calendars block, fill in:
- the CalDAV server URL (see the table below);
- your username;
- your password — use an app password when your provider offers one.
- Click Enable. Your calendars show up a few seconds later.
| Provider | Server URL | Notes |
|---|---|---|
| Nextcloud | https://cloud.example.com/remote.php/dav | App password: Settings → Security |
| iCloud | https://caldav.icloud.com | Apple ID + app-specific password (mandatory) |
| Fastmail | https://caldav.fastmail.com | App password with CalDAV access |
| Baïkal | https://dav.example.com/dav.php | |
| Radicale | https://dav.example.com (or http://ip:5232) | |
| SOGo | https://mail.example.com/SOGo/dav | |
| Synology | https://nas.example.com:5001/caldav |
The integration discovers your calendars from that URL (principal and calendar home): no need to enter the address of each calendar. Task lists are ignored.
Choose what to sync and share
Every synced calendar shows up in Gladys with two toggles:
- Sync — switch it off to skip a calendar: its events are removed from Gladys. Switched back on, it is refilled by the next sync.
- Share — a calendar starts private. Shared, it becomes visible to the whole household, and usable by the scenes.
The name, description and color of a calendar follow the server's.
Settings (administrator)
These settings apply to every user:
- Sync interval — every 15 minutes by default (from 5 minutes to 24 hours).
- Days of history — past events older than 30 days (by default) are not synced.
- Days ahead — 365 days by default (up to 730): recurring events are expanded up to that horizon.
The Sync now button reads every account right away and shows how many calendars and events were synced.
Good to know
- An event deleted on the server disappears from Gladys at the next sync; a calendar deleted on the server is deleted from Gladys with its events.
- Recurring events (exceptions and moved occurrences included) are expanded into individual occurrences.
- Cancelled events (
STATUS:CANCELLED) are not imported. - A "floating" time event (without time zone) is read as UTC.
- Gladys limits: 50 calendars per user, 10,000 events per calendar; texts too long are truncated.
- Disabling the integration for your account deletes your synced calendars from Gladys (they stay untouched on the server).
Troubleshooting
The Configuration screen shows how many accounts fail. The most common causes:
- Wrong URL — check the URL in a CalDAV client (Thunderbird, DAVx⁵); try
the root URL of the server, the
/.well-known/caldavdiscovery is automatic. - Credentials refused — with two-factor authentication enabled, an app password is required.
- Self-signed certificate — the server must present a valid HTTPS certificate (or be reached over HTTP on the local network).
The administrator finds the details of the errors in the integration logs (the integration page, supervision tab). Passwords never show up there.
Konfigurationseinstellungen
Diese Einstellungen fragt CalDAV in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| How it works | section | Nein | Each user enables the integration for themselves in the "My calendars" block below, with their own CalDAV server and credentials. Their calendars and events are copied into Gladys, one way: Gladys never writes to the CalDAV server. The settings here apply to every user. |
| Sync interval (minutes) | number | Nein | How often each user's calendars are read from their CalDAV server. |
| Days of history | number | Nein | Past events older than this are not synced. |
| Days ahead | number | Nein | Horizon of the sync: recurring events are expanded up to this many days ahead. |
So installierst du CalDAV in Gladys
- Öffne in Gladys Integrationen: CalDAV erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/bertrandda/gladys-caldav-sync: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/bertrandda/gladys-caldav-sync.
CalDAV 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
CalDAV 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 bertrandda 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