Calendar and CalDAV¶
Two ways to get your tasks into a calendar. Getting somebody else's calendar into verdande is the other direction and has its own page — see Calendar.
| Feed | CalDAV | Calendars in | |
|---|---|---|---|
| Direction | Tasks out, read only | Tasks out, two-way | Events in, read only |
| Works with | Anything that subscribes to a URL | Apple Reminders, Thunderbird, DAVx⁵ | A Google account |
| You can tick things off | No | Yes | No — an event is not a task |
| Setup | Paste a URL | Username and token | Connect, then pick calendars |
Subscribing to a feed¶
Settings → Calendar feed gives you a URL. Paste it into whatever subscribes to calendars.
File → New Calendar Subscription, paste the URL, and set auto-refresh to every hour.
Other calendars → + → From URL. Google refetches on its own schedule, which can be many hours — this is Google's behaviour and nothing here can change it.
New Calendar → On the Network → iCalendar (ICS).
Tasks go out as VTODO. Google ignores those entirely, so tasks with a clock time
are also sent as events — which is what makes the feed useful in the calendar
most people actually keep.
The URL is the password
Anybody with the link can read your tasks. Calendar clients cannot log in, so there is nothing else it could be. If it ends up somewhere it should not, Settings → Calendar feed → Rotate issues a new one and breaks the old immediately.
Showing a Google calendar in verdande¶
Moved. Connecting a Google account, subscribing to an address, and what the grid does with either now live on their own page — see Calendar.
This page is the other direction: verdande's own tasks, read by something else.
Connecting a CalDAV client¶
This is the one where ticking something off in Apple Reminders ticks it off here.
First, make a token. Settings → API tokens → New token. Copy it — it is shown once.
Then:
- Server: your verdande address
- Username: your email address
- Password: the API token, not your account password
Settings → Accounts → Add Other Account → CalDAV account, choose Manual, and fill in the three fields above.
New Calendar → On the Network, enter your email as the username and the address as the location. It will find the collections itself.
Add account → Login with URL and username. Then pick which projects to sync.
Each project appears as its own calendar, so you can turn them on and off individually.
Why a token and not your password
A CalDAV client stores what you give it and sends it on every request. A token can only read and write tasks — it cannot sign in to the app or change your password — and you can revoke one without touching anything else.
What syncs¶
Task titles, notes, due dates and times, priorities, repetition, and completion — in both directions.
Not sections, labels, sub-task relationships, comments or attachments. CalDAV's VTODO has nowhere to put them, and inventing an encoding would produce something no other client could read.
Completed tasks stay in the collection. A client that stops seeing one treats it as deleted and drops its own record of having done it.