Connect Google Calendar

Sync is read-only and opt-in. Your events come into Pikos as pages you can write on, and nothing you do in Pikos is ever sent back to Google. Connecting it cannot change your calendar.

Connect

Open Settings with Cmd+, (Ctrl+, on Linux), go to the Calendar sync tab, click Add account and choose Google Calendar. Your browser opens, you approve, and you're back.

Pikos asks for read-only access to your calendar list and your events, and nothing else. It cannot create, edit, or delete anything in Google Calendar, because it never asks for permission to.

Pick the calendars you want

Pikos lists the calendars on the account that hold events. Turn on the ones you want. Each gets its own folder and a color you can change. The token goes into the system keychain, not a file Pikos owns.

What to expect afterwards

Pikos brings in the past week and everything ahead of it. Older events stay in Google and don't come across, so a freshly connected account looks thinner than the calendar you're used to.

The title, time, and recurrence of a synced event are locked, so it always matches the source. The notes you add are yours and sync never overwrites them. Recurring events, their exceptions, and cancelled occurrences all come across.

Disconnecting

Disconnecting deletes the token and asks Google to revoke it. If you happen to be offline at the time, the local half still happens, so Pikos loses access either way. The grant can linger in your Google account until it next reaches them, and you can always clear it yourself from Google's permissions page.

Turning off a calendar removes the mirrored events and keeps anything you wrote on them, in the folder it was already in.