Calendar subscriptions - Liturgical-Calendar/LiturgicalCalendarAPI GitHub Wiki

The API can return liturgical calendar data in ICS format (text/calendar), which allows calendar applications to subscribe to the liturgical calendar and receive automatic updates. Subscription URLs can be obtained from the usage page.

Google Calendar on a desktop computer

Get the link for the desired calendar subscription from the usage page and copy it to the clipboard.

Navigate to calendar.google.com on a desktop computer.

At the bottom left corner of the screen, next to Other calendars, click on the + icon to add a new calendar, and choose From URL.

Paste in the URL that you copied earlier.

Once subscribed, your calendar will be populated with the events from the Liturgical Calendar. Google Calendar will poll the calendar URL every 8 hours, so any updates in the API will be propagated to your subscription.

You will only see events for the current year. On the first day of a new year, new events will be created automatically for the new year.

Once the calendar has been added from a desktop, it will become available for the same Gmail account on the Google Calendar app on a smartphone.

Calendar apps on an Android device

If you have not yet added the calendar subscription from the desktop version of Google Calendar, please do so now (see Google Calendar on a desktop computer).

Open the Google Calendar app.

Go to Settings, then under the account which you used for the desktop version, click on the Calendar subscription name.

Make sure Synchronization is turned on.

Once subscribed, your calendar will be populated with the events from the Liturgical Calendar. Google Calendar will poll the calendar URL every 8 hours.

iPhone

Get the link for the desired calendar subscription from the usage page and copy it to the clipboard.

Go to Phone Settings → Accounts → Add account → Other → Add Calendar.

Paste in the URL that you copied earlier.

Once subscribed, your calendar will be populated with the events from the subscription URL.

The iPhone Calendar app will poll the calendar URL based on the settings at Phone Settings → Accounts → Fetch New Data → Fetch.

Microsoft Outlook

Get the link for the desired calendar subscription from the usage page and copy it to the clipboard.

At the bottom of the screen, switch from Email view to Calendar view.

On the ribbon of the Home menu item, click on Open calendar → From the internet.

Paste in the URL that you copied earlier.

On the following screen, check the checkbox along the lines of "Poll this calendar in the interval suggested by the creator".

Outlook Calendar should now poll the calendar URL once a day.

Once subscribed, your calendar will be populated with the events from the Liturgical Calendar.

Make sure the Calendar is created in the Other calendars folder; if you find it under the Personal calendars folder, drag it and drop it onto the Other calendars folder, so as to ensure that it is treated as a subscription internet calendar.

You can manually fetch new data by clicking on Send/receive all (from the SEND/RECEIVE menu item).

Outlook Calendar supports a minimal amount of HTML in the event description, so the event descriptions for the Liturgical Calendar are a little bit more "beautified" for Outlook.

---

For Users | Home