Connect an external calendar

Pikos reads your calendar straight from Google Calendar, or over CalDAV (the open standard behind iCloud and most other providers). Your events show up in the Pikos calendar as real pages. You can write notes on them, tag them, and find them in search. The schedule stays owned by your calendar, so an event always reflects what's actually on it.

It's read-only and opt-in. Nothing you write in Pikos goes back out to your provider, and only the calendars you turn on ever sync. Your notes and pages stay on your device.

Pick your provider

Find yours:

• Google Calendar: sign in, no password to make
• iCloud: app-specific password, then caldav.icloud.com
• Fastmail: app password, then caldav.fastmail.com
• Anything else: app password, then your provider's own caldav.yourprovider.com

Yahoo, mailbox.org, Posteo, Yandex, and GMX all work, as does anything you run yourself like Nextcloud. If your provider has a calendar and mentions CalDAV anywhere in its help pages, it'll almost certainly connect. If yours gives you trouble, drop me a line at [email protected] and I'll take a look.

Calendars Pikos can't reach

A few calendars don't use CalDAV at all, so there's no way for Pikos to read them:

• Outlook, Microsoft 365, and Exchange. Microsoft has never supported CalDAV.
• Proton. Proton Calendar is encrypted so that not even Proton can read it. That's the point of it, and it's why nothing else can read it either.
• Tuta. Same story.
• Notion Calendar. It reads other calendars rather than being one.

Better to know that now than after the download. If one of these is yours, I'd still like to hear from you. What people actually use is what decides where Pikos goes next.

What a synced event is

• The schedule is locked. Title, time, and recurrence come from your calendar and can't be edited or dragged in Pikos. That's how an event always matches the source, and it's a decision rather than a gap.
• The notes are yours. Anything you write, tag, or tick belongs to you, and sync never touches it. Turn the calendar off later and your notes stay put.

Any other CalDAV server

You need three things: the server URL, your username, and an app password. Pikos finds your calendars from the base server URL, so there's no need to hunt down individual calendar addresses. Your provider's help pages will have it, usually something like https://caldav.yourprovider.com.

Open Settings with Cmd+,, or Ctrl+, on Linux, go to Calendar sync, then Add account and choose CalDAV. Pikos lists the calendars holding events and you turn on the ones you want. Each gets its own folder and a color you can change, and your password goes into the system keychain rather than the app's own files.

App passwords

Most providers won't take your normal account password for CalDAV, so you make an app password instead. It's a one-off password for a single app, and you can delete it whenever you like to cut Pikos off without touching your main login. Look for "app password" or "CalDAV access" in your provider's security settings. Google doesn't need one, because you sign in instead.

Ready to try? Download Pikos, then open Settings and find Calendar sync.