Skip to main content

Calendar feeds

A calendar feed is a group's or an animal's calendar, read by an application outside Kinkeep: the calendar already on your phone or your computer. There are two ways to get one. Subscribe, which keeps it up to date, and download, which takes a copy.

Subscribing​

Make a feed where the calendar is. A group, an animal and an organisation each have a Feeds screen, reached from their menu, listing the feeds that calendar hands out and making a new one in a press. Settings → Calendars lists every feed you hold, across every calendar, and makes one too, asking which calendar it carries. An organisation's feed gathers the groups affiliated with it.

A row is edited where it stands: open it to correct its name or its time zone. The address is there as well, and it stays there, so you can come back and copy it again whenever you need it.

Copy that address into your calendar application as a subscribed calendar, not as a one-off import:

  • Google Calendar: Other calendars, then From URL.
  • Apple Calendar: File, then New Calendar Subscription.
  • Thunderbird: New Calendar, then On the network.

The application reads it on its own from then on. A feed carries the recent past as well as what is coming, and every series as its rule, so the application expands a course for as long as it runs.

The address is the whole credential. Anybody who has it can read that calendar, so treat it like a link you share: whoever holds it reads the calendar, and nothing else. If one leaks, end it on the same row; the next read is refused, and nothing else about the calendar changes.

You can make more than one feed for the same calendar, which is what you want when one address goes on your phone and another into a shared calendar: ending one leaves the other working.

Downloading a copy​

From a group's or an animal's menu, or from an organisation's screen, Download calendar saves the same document as a file. Use it when the calendar is going somewhere that does not subscribe to an address.

What is in it, and what is not​

In: the group or the animal, and its entries of every kind, with a series' exceptions and the people who take part.

Not in: the ledger. Money is read by coordination and management alone, and a feed is read by whoever holds its address.

Not in either: any credential. A feed names the people who take part and nothing that could sign in as one of them.