HomeFace
Putting a family calendar on an Apple TV, and what tvOS will not let you do
You have an Apple TV in the living room. It is already connected to a big screen and already signed into your iCloud account. So the obvious thought is: why can't that screen show the family calendar when nobody is watching anything?
It is a fair question, and the honest answer is that Apple TV is the most restricted of the four Apple devices you could use for this. Below is what Apple's own developer documentation says, with every claim sourced, so you can decide whether the TV is the right screen for your family.
An Apple TV cannot read your calendar at all. EventKit and WidgetKit are not available on tvOS, so the TV can only show a copy pushed from an iPhone or iPad over iCloud. For a permanent wall calendar, use an iPad.
The short version
Apple TV can show a family calendar, but only while a calendar app is open and in front. It cannot show one as a widget, it cannot take over the screen saver, and it cannot read your calendar directly from the TV. An Apple TV app has to be handed the calendar data by another device you own.
If you want a screen that shows the family calendar all day without anyone touching it, an iPad on a stand is the simpler answer. The TV is the right choice when you want the family's day on a big screen on purpose, at a moment you choose, rather than permanently.
There are no widgets on tvOS
The first thing people reach for is a widget. On iPhone and iPad you put a calendar widget on the Home Screen and it stays current without opening anything.
tvOS is not in the list. Apple's WidgetKit documentation gives the framework's availability as iOS 14.0, iPadOS 14.0, Mac Catalyst 14.0, macOS 11.0, visionOS 26.0 and watchOS 9.0. tvOS does not appear in that table, and the word tvOS does not appear anywhere on the WidgetKit page. That page also lists every place a widget can live: Today View, Home Screen, Lock Screen, the Mac desktop and Notification Center, CarPlay, the Apple Watch Smart Stack, and pinned surfaces on Apple Vision Pro. The Apple TV Home Screen is not among them.
So the usual trick of putting a small always-visible widget on the Home Screen has no equivalent here. There is nothing to put it in.
The TV cannot read your calendar by itself
This is the real constraint, and it surprises developers, let alone parents.
EventKit is the framework every Apple app uses to read and write calendar events. Apple's EventKit documentation lists its availability as iOS 4.0, iPadOS 4.0, Mac Catalyst 13.1, macOS 10.8, visionOS 1.0 and watchOS 2.0. The EKEventStore class, which Apple describes as an app's point of contact for accessing calendar and reminder data, carries the same list. tvOS is absent from both.
In plain terms: there is no documented way for an Apple TV app to open your calendar and read the events out of it. Not with permission, not with a prompt, not at all. Apple TV also has no Calendar app of its own and no calendar permission screen in Settings, which follows from the same absence.
That changes the shape of the problem. A family calendar on Apple TV cannot be an app that reads your calendar. It has to be an app that receives a copy from a device that is allowed to read it.
So the data has to arrive from an iPhone, iPad or Mac
The frameworks for that part do support tvOS, and this is almost certainly how any working Apple TV family calendar is built. CloudKit, Apple's framework for storing app data in a user's iCloud, lists tvOS 9.0. CKDatabaseSubscription, which lets an app be told when iCloud data changes, lists tvOS 10.0. User Notifications lists tvOS 10.0. Background downloads via URLSessionConfiguration.background list tvOS 9.0.
Together that gives an architecture Apple does document: your iPhone or iPad reads the family calendar with EventKit, writes a copy into your family's own iCloud with CloudKit, and the Apple TV app reads that copy. The TV is a display for data gathered elsewhere. It is not a participant.
The practical consequence is simple. The Apple TV screen is only as fresh as the last time a phone or iPad in the house pushed an update. If everyone's phone is out of the house, the TV is showing yesterday.
Apple TV apps do not keep running, and the TV goes to sleep
The next hope is that the app could run quietly in the background and keep itself current. Apple's reference for background execution modes gives a table of which modes each platform supports. tvOS supports four: Audio, AirPlay and Picture in Picture; Background fetch; Remote notifications; and Background processing. Nothing resembling staying on screen. Apple's own description of the background state is blunt: typically, an app is in a suspended state when it is in the background.
Worth flagging as an inconsistency rather than a capability: Apple's Information Property List page for the UIBackgroundModes key lists only iOS, iPadOS, visionOS and watchOS, while the Xcode background-modes page clearly lists tvOS for four modes. Those two Apple pages disagree, and neither should be relied on alone. The Background Tasks framework does list tvOS 13.0.
Then there is sleep. Apple's support guide describes two separate idle behaviours in Settings: a Sleep Now item, and a Sleep After setting under General for how long Apple TV waits before sleeping on its own. Separately, Settings then Screen Saver then Start After sets how long Apple TV is idle before the screen saver begins. Apple notes that delaying or preventing sleep may increase power consumption.
An app can push back on the idle timer. UIApplication.isIdleTimerDisabled does list tvOS, and Apple describes it as a way to disable the idle timer to avert system sleep. But Apple does not document how that interacts with the Apple TV Sleep After setting, so treat as unverified any claim that it keeps an Apple TV awake overnight.
The screen saver and the Top Shelf are not open to apps
If an app cannot stay on screen, the two places that are on screen when nothing is happening look tempting. Neither is open to third parties for live information.
The screen saver is closed. Apple's Screen Saver framework, the one that lets a developer write a custom screen saver, lists macOS 10.0 and nothing else. There is no tvOS equivalent in Apple's documentation. Apple's support page lists the Apple TV screen saver types as Aerials, Snoopy, Memories and Slideshows, and Portraits, plus Memories or albums from the Photos app. It does not mention third-party apps supplying content, because there is no documented way to do it.
The Top Shelf is real but it is not a dashboard. TVTopShelfContentProvider has been available since tvOS 13.0 and lets an app supply content for the top of the Home Screen. But Apple's design guidance says the system shows that content when your app is in the Dock and in focus, and frames it as a showcase for content people jump into. It only appears when someone is already on the Home Screen looking at your app, so it cannot serve as an always-on calendar.
Which device is actually best, and where HomeFace fits
For a family wall calendar the iPad is the better device, and it is not close. It can read your calendar directly with EventKit, it supports widgets, and it can sit on a stand in the kitchen with the app in front. An old iPad you already own, a cheap stand and a cable is the standard answer for a reason. A Mac in the kitchen works for the same reasons. Apple TV earns its place in one case: you want everyone looking at the week on a big screen at a moment you choose, such as Sunday evening planning or breakfast before school. Then the TV goes back to being a TV.
HomeFace runs on iPad, iPhone, Apple TV and Mac. Its App Store description says it turns a device you already own into the family screen that runs your home, that households sync through your family's own iCloud, and that Apple TV and Mac are part of the paid HomeFace Plus tier with a 14-day free trial on each. Those are the developer's claims from the listing, not things verified by reading the app's code.
What the platform tells you, whichever app you pick, is this: on iPad and iPhone an app can read your calendar itself and offer widgets. On Apple TV it can do neither, so the TV is showing a copy that arrived through iCloud from another device, and only while the app is open. If your plan is a permanent kitchen wall screen, set it up on an iPad and treat the Apple TV as the big-screen view you open when the family is together.
Questions
Can I put a calendar widget on my Apple TV Home Screen?
No. Apple's WidgetKit documentation lists the framework as available on iOS, iPadOS, Mac Catalyst, macOS, visionOS and watchOS. tvOS is not in that availability table, and the Apple TV Home Screen is not among the places Apple lists where widgets can appear. There is no widget surface on tvOS to put one in.
Why can't an Apple TV app just read my iCloud calendar?
Because the framework for reading calendars is not available on tvOS. Apple's EventKit documentation lists iOS, iPadOS, Mac Catalyst, macOS, visionOS and watchOS. tvOS is absent, as it is from the EKEventStore class page. Apple TV also has no Calendar app and no calendar permission screen. An Apple TV app has to be sent a copy by an iPhone, iPad or Mac that is allowed to read it, which in practice means syncing through your own iCloud with CloudKit, which Apple does support on tvOS 9.0 and later.
Can an app show the family calendar as my Apple TV screen saver?
No. Apple's Screen Saver framework, which lets developers write custom screen savers, is documented for macOS only. There is no tvOS equivalent in Apple's documentation. Apple's support page lists the Apple TV screen saver options as Aerials, Snoopy, Memories and Slideshows, and Portraits, plus Memories or albums from the Photos app. It does not mention third-party content.
What about the Top Shelf at the top of the Home Screen?
The Top Shelf is a real API, available since tvOS 13.0, but it is not a live dashboard. Apple's design guidance says the system shows your Top Shelf content when your app is in the Dock and in focus, and describes it as a way to showcase content people can jump into. It only appears when someone is already on the Home Screen looking at your app, so it cannot serve as an always-on calendar display.
Will the Apple TV stay awake showing the calendar all day?
Not reliably, and Apple does not document it working that way. Apple TV has a Sleep After setting under General and a separate Screen Saver Start After setting, both triggered by idle time. An app can set UIApplication.isIdleTimerDisabled, which Apple does list for tvOS and describes as averting system sleep, but Apple does not document how that interacts with the Apple TV Sleep After setting. That it keeps an Apple TV awake overnight is unverified, so do not plan around it.
So which device should I actually use for a family wall calendar?
An iPad on a stand, for most families. It can read your calendar directly, it supports widgets, it sits in the kitchen where coordination happens, and an old one you already own works fine. A Mac in the kitchen is a reasonable alternative for the same reasons. Use the Apple TV when you want the whole family looking at the week on a big screen at a moment you choose, rather than as a permanent display.
Every platform claim on this page is taken from Apple's own documentation. Key sources: WidgetKit availability (developer.apple.com/documentation/widgetkit), EventKit and EKEventStore availability (developer.apple.com/documentation/eventkit, /eventkit/ekeventstore), CloudKit and CKDatabaseSubscription availability (developer.apple.com/documentation/cloudkit, /cloudkit/ckdatabasesubscription), background execution modes per platform (developer.apple.com/documentation/xcode/configuring-background-execution-modes), the UIBackgroundModes key (developer.apple.com/documentation/bundleresources/information-property-list/uibackgroundmodes), Background Tasks (developer.apple.com/documentation/backgroundtasks), app suspension in the background (developer.apple.com/documentation/uikit/about-the-background-execution-sequence), isIdleTimerDisabled (developer.apple.com/documentation/uikit/uiapplication/isidletimerdisabled), the Screen Saver framework (developer.apple.com/documentation/screensaver), TVTopShelfContentProvider (developer.apple.com/documentation/tvservices/tvtopshelfcontentprovider), Top Shelf design guidance (developer.apple.com/design/human-interface-guidelines/top-shelf), and Apple support pages for Apple TV screen savers (support.apple.com/en-us/106002) and sleep (support.apple.com/guide/tv/sleep-or-wake-apple-tv-atvb7a7550e3/tvos). Not verified: whether isIdleTimerDisabled overrides the Apple TV Sleep After setting, which Apple does not document; the exact Sleep After and Start After duration options, which Apple's support pages do not list; whether tvOS has any undocumented widget support; and whether tvOS imposes a local storage limit on apps, for which no current Apple page was found. Apple's UIBackgroundModes page and its Xcode background-modes page disagree about tvOS, and both are reported rather than one being chosen. Statements about HomeFace's features are the developer's claims from the App Store listing; the app's source code was not read, and the CloudKit architecture described is an inference from what the platform allows plus the listing's statement that households sync through the family's own iCloud.