Matter

Features·Calendar

Add a feed

A feed brings a calendar into Matter from an iCal link. Matter only reads the link, so nothing you do in Matter changes your calendar.

You need a read-only iCal link to the calendar, sometimes called an ICS link. It has to be the feed itself: a link to a calendar's web page gives no events and no warning.

Anyone who has the link can see what it shares, so keep it to yourself. Each service below lets you replace the link if it gets out, and the old one then stops working, in Matter too.

Google Calendar

Do this on a computer, at calendar.google.com.

  1. Click the gear at the top right, then Settings.
  2. Under Settings for my calendars on the left, click the calendar you want.
  3. Click Integrate calendar.
  4. Copy the link under Secret address in iCal format.

Each calendar has its own link, so repeat this for every calendar you want in Matter. If you don't see the secret address on a work or school account, your admin has turned it off, and only they can turn it back on. Reset gives the calendar a new address.

iCloud and Apple Calendar

On iCloud.com:

  1. Go to icloud.com/calendar and sign in.
  2. Hover over the calendar in the sidebar and click its info button.
  3. Turn on Public Calendar.
  4. Click Copy.

On the iPhone, in Apple's Calendar app: tap Calendars, tap the info button beside an iCloud calendar, turn on Public Calendar, then tap Share Link and copy it.

The link starts with webcal://. The iPhone takes it as it is. On the Mac, change webcal:// to https:// before you add it. Turning Public Calendar off stops the link working.

Outlook and Microsoft 365

In Outlook on the web, at outlook.com or outlook.office.com:

  1. Open the calendar, then click the gear for Settings.
  2. Go to Calendar, then Shared calendars.
  3. Under Publish a calendar, pick the calendar and how much detail to share, then click Publish.
  4. Copy the ICS link that appears. The HTML link is a web page and won't work in Matter.

On a work or school account, your organisation may not allow publishing. If Publish a calendar isn't there, ask your IT admin. Unpublish in the same place stops the link working.

Fastmail

  1. Go to Settings, then Calendars, and click the calendar to edit it.
  2. In the Publish section, turn on Full event details. Free/busy information shares only when you are busy, with no titles.
  3. Copy the link that appears, then click Save. The link works from then on.

Reset URL on the same screen replaces the link.

Proton Calendar

Sharing a link needs a paid Proton plan, and it only works in the web app, not Proton's phone apps.

  1. Sign in at calendar.proton.me.
  2. Go to Settings, then All settings, then Calendars, and pick the calendar.
  3. Under Share with anyone, click Create link.
  4. Choose Full view for titles and places, or Limited view for busy times only.
  5. Click Copy link.

To stop a link working, delete it in the same place.

Other calendars

Look for an option called iCal, ICS, subscribe, publish or share with a link. A link that ends in .ics is usually the right one. If your calendar only offers a web page, or only lets you download a file once, it can't be a feed.

Add a feed

On the Mac

  1. Open Settings ▸ Calendars and click Add a feed….
  2. Type a Name, and paste the link into iCal URL.
  3. Click Add, or press Return in the link field. Esc cancels.

Use a link that starts with https://. If yours starts with webcal://, change that part to https://, because the Mac keeps the link as you typed it and a webcal:// one will say Couldn't load.

On the iPhone

  1. On Calendar, tap the circle beside the tab bar, then Add a calendar. You can also get there from Settings ▸ Calendars.
  2. Fill in Name and Feed URL.
  3. Tap Add feed.

A webcal:// link works here. Matter changes it to https:// for you. Anything that can't be a link is refused with That does not look like a calendar URL.

On both

  • Matter fetches the new feed straight away.
  • A feed you leave unnamed is called Calendar.
  • A new feed has Treat as tasks on. Events that count says what that does.
  • A link you have already added is refused, and Matter tells you the name it is under.
  • Feeds sync through iCloud, so a feed added on one device arrives on the other. Each device then fetches the feed itself.

Change a feed

  • Colour. Events are a light tint of this colour on the Calendar page, and on the Mac's Tasks page their calendar symbol takes it. On the Mac, click the swatch at the start of the row. On the iPhone, pick from the swatches under the feed.
  • Name and link. On the Mac, double-click the row, or right-click it and choose Edit. Return or clicking away saves, and Esc leaves it as it was. On the iPhone, type in the fields under the feed. After changing a link, refresh to fetch it straight away.
  • Treat as tasks. A checkbox on the Mac and a switch on the iPhone.

Pause a feed

On the Mac, click the eye on the row. On the iPhone, turn off Active.

Matter then stops fetching that feed. Its events stay where they are, and they count as they did before, but changes in your calendar no longer reach Matter. They leave once they are more than 30 days old.

Delete a feed

On the Mac, hover over the row and click the trash, or right-click it and choose Delete feed. On the iPhone, tap Remove feed. Both ask first, and say how many events go with it.

The events leave Matter with any notes, tags and done marks you added. Time you tracked on them stays in Analysis, under Untracked instead of the event's name. Your calendar is not touched.

When feeds refresh

On the Mac:

  • About every ten minutes while Matter is running.
  • When you come back to Matter, if the last sync was over a minute ago.
  • When you click Refresh all in Settings ▸ Calendars, or Refresh on the Calendar page (⌘R).

On the iPhone:

  • When you open Matter, and when you open Calendar.
  • When you pull down on Calendar or on Settings ▸ Calendars, tap Refresh now there, or tap Refresh in Calendar's circle.
  • From time to time while Matter is closed, when iOS allows it.

An automatic refresh may reuse what Matter fetched in the last ten minutes. A refresh you ask for always goes to your calendar's server.

Settings ▸ Calendars shows when the feeds last synced on that device. So does the title of the Mac's Calendar page, and the range menu on the iPhone's.

If a feed says Couldn't load

The feed answered with an error, such as not found or not allowed, or its address leads nowhere, or what came back couldn't be read. A Refresh that couldn't get through says it too.

  • On the Mac, it shows under the feed's name, and in a line at the top of the Calendar page.
  • On the iPhone, it shows beside the feed's name in Settings ▸ Calendars, and under the range at the top of Calendar.

The feed's events stay as they were, and the next sync tries again. Check the link first. Each device reports for itself, so a feed can load on one and not on the other.

Losing your network doesn't count against a feed. An automatic sync keeps trying for about twenty seconds, then says nothing and waits for the next one. The same goes for trouble on the calendar's own server.

What comes in

Matter keeps events from the last 30 days and the next 30 days. Later events arrive as the days pass.

What Matter reads is each event's title, place, times and repeats. It doesn't read whether an event is marked free, tentative or cancelled, so a cancelled event your calendar still lists shows up as a normal one.

Repeating events become a separate event for each time they fall:

  • A note, tag or done mark goes on that one occurrence, and the others don't get it.
  • Daily, weekly, monthly and yearly repeats all work, including ones like the third Tuesday or the last weekday of the month.
  • A monthly event on the 31st only lands in months with a 31st.
  • A single occurrence you moved or edited in your calendar shows as you changed it, and one you removed stays out.

What you add in Matter stays there. Your notes, tags and done mark survive every refresh, with three exceptions, and in each your tracked time stays in Analysis:

  • An event moved to another day in your calendar counts as a new event, so they don't move with it. A new time on the same day keeps them.
  • An event removed from your calendar leaves Matter with them.
  • An event more than 30 days old leaves Matter with them.

To change an event's title or time, change it in your calendar. The next refresh brings it in.

Matter

To-do list that fits life

For the Mac and iPhone. It works offline, with no account.

Download for MacDownload for iPhone