Apple iCalendar

How it works, no detour

Let's be upfront: there is no native Apple integration in Kilevo. Apple doesn't offer the direct connection that Google and Outlook do. But Apple's Calendar app can publish a calendar: it turns it into a web address, an ICS feed. You copy that address, paste it into Kilevo, and your iCloud events become trips. It's a standard mechanism Apple has supported for years, and it works.

On a Mac

Open the Calendar app. In the list on the left, find the iCloud calendar you want to track. Right-click it and choose Share Calendar. Check Public Calendar: Apple then generates a link. Click the button next to the link to copy it.

On an iPhone

Open the Calendar app, tap Calendars at the bottom, then the info button (the "i" in a circle) next to the calendar you want. Turn on Public Calendar, then tap Copy Link. The link is now on your clipboard, ready to paste.

Pasting the link into Kilevo

In Kilevo, open the calendar connection, choose the ICS feed, and paste the link. The link Apple gives you often starts with webcal:// — that's fine, Kilevo reads it without any change on your part. No Apple account is connected and no permission is requested: Kilevo simply reads the address.

What Kilevo reads in your events

For each event that has a location, Kilevo reads the title, the location, and the times. The title becomes the trip's purpose; the location is used to compute the distance from your default address, round trip by default. Attendees are never read or stored.

An event with no location creates no trip. A video call yields zero miles. When a location is incomplete — a street with no city — Kilevo keeps the address closest to your home, marks the trip "guessed address," and shows you its choice; one click on Confirm applies to every event with the same title.

Read-only, and freshness up to iCloud

The feed is read-only. Kilevo never changes your iCloud calendar, adds nothing, deletes nothing. Removing the URL in Kilevo doesn't touch your calendar.

If you're a subscriber, Kilevo re-reads the feed every night at 3:30 a.m.; anyone can trigger it on demand. It isn't real time: a public iCloud calendar is updated by Apple on its own schedule, and Kilevo reads whatever the feed contains when it checks it. An event you just added may take a while to appear in the published feed.

One limit worth knowing

A public iCloud calendar is accessible to anyone who has the link: it isn't password-protected. That's a property of iCloud, not of Kilevo, and you should know it. Publish only a calendar whose content can be read, and keep the URL to yourself. If you ever want to cut off access, turn off "Public Calendar": the old link stops working.

This iCloud sharing is just one case of ICS feeds, all of which Kilevo reads the same way. The calendar sync page explains how the rest works, and the security and privacy page covers what Kilevo keeps.

Create an account, publish your iCloud calendar, and paste the link: a full year of trips rebuilds itself.