Connecting your Apple Calendar to TRMNL takes just a few seconds.
Step 1 - Visit the Apple Calendar Plugin
Inside TRMNL, navigate to Plugins > Apple Calendar.
Step 2 - Connect Apple Calendar
Note: You may enable this plugin either by a) publishing your Apple calendar to an anonymized "ICS" style format, or b) using the TRMNL Companion iOS App.
Option A (published ICS link)
From an iPhone or iPad (if you don't use a Mac computer):
Open the Calendar app
Tape Calendars, then tap the (i) next to the iCloud calendar you want to share
Turn on Public Calendar, then tap Share Link to copy or send the URL
(source)
From a Mac computer, open your Apple Calendar client.
Ctrl-click on the calendar and check the Public Calendar box. After a moment (you may need to navigate away, then re-open this pane) a URL will appear below.
Copy this long URL value to your clipboard.
Option B (iPhone / iPad app)
Download and install the TRMNL Companion iOS App to your phone or iPad, then move ahead to Step 3.
Step 3 - Configure Plugin
Back inside TRMNL, paste your published calendar link into the ICS input field. Important: replace the "webcal" text with "https" so your full URL looks like https://p44-caldav.icloud.com/published.....
Next you may set a few preferences.
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
Default (upcoming events for today, tomorrow, next day)
Week (5-7 days upcoming)
Month (this calendar month)
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:
Step 4 - You're Done!
Based on your device's refresh settings, you'll begin seeing Apple 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.