Connecting your Outlook 365 Calendar to TRMNL takes just a few seconds.

Inside TRMNL, navigate to Plugins > Outlook Calendar.

Note: Enabling this plugin requires publishing your Outlook calendar to an anonymized "ICS" style format. This is similar to publishing an unlisted YouTube video or "view with link" permission Google Docs file. If your calendar has sensitive data you may limit the published permissions to only expose timestamps, not event details.

First log in to your Outlook email at outlook.office365.com. Visit your calendar on the left side navigation, then click the settings gear cog in the top right corner.

Click the "Shared calendars" link, then underneath the "Publish a calendar" heading you can select a calendar + set permissions.

Click Publish, then click to copy the 2nd link labeled ICS.

Troubleshooting

If you don't see the ability to Share or Publish a calendar, first make sure that calendar sharing is enabled at the administrator level. The following view is accessible from your Office 356 admin area:

After confirming that users may share their calendars, retry the beginning of Step 2 above.

Back inside TRMNL, paste your published calendar link into the ICS input field.

Next you may set a few preferences.

Sync Recurring Events

This is a quirk of ICS style calendars in general -- when you make a recurring event, only 1 record exists. Since TRMNL only fetches recent events to generate your screens by default, we need to manually sync much older events that have recurring schedules in order for their future occurences to appear. After clicking to Save your new plugin, click the "Perform" link underneath this section and TRMNL will store old, recurring events. You only need to do this once.

Time Format

24 hours vs 12 hour (AM/PM) style.

Include Description

If "Yes," a truncated preview of the event's description field will be shown beneath the event title. Note that on the "default" Layout (explained below), setting this option to "No" will ~double the number of events shown thanks to saved space.

First Day of Week

Applies only to the "month" view. Similar to native Outlook Calendar (month view), this allows you to set which day of the week is represented by the first column, furthest to the left. Defaults to Sunday.

Ignored Phrases

Supports a list of words that will be used to ignore events based on title or description content.

Layout

Note that only "Week" and "Month" layouts support multi-day events, but every layout supports all-day events.

Example - Week layout with multi-day event ("Michael OOO")

Example - Default layout with all-day event ("Michael OOO")

Example - Month layout with multi-day event:

Based on your device's refresh settings, you'll begin seeing Outlook Calendar events very soon.

Note: while we fetch data according to your refresh interval, TRMNL only generates new screen renders if the data fetched contains changes. Thus setting your layout to "Default" (which shows 2-3 days) but updating an event 4+ days in the future will not trigger a screen refresh.

Stay focused.