User manual · Version 2.0 · October 2026

How to use Excalibur AI TV

Excalibur is a live TV player for Apple TV, iPhone, iPad and the foldable iPhone, with an assistant called Merlin built in. It plays the channels, guides and on-demand catalogs of accounts you already have. This manual covers every feature that ships in version 2.0: where to find it, how to use it, and how it works.

Devices
Apple TV, iPhone, iPad, Duo, and a recorder for Mac
Plans
Free trial, then $24 a year or $89 once (US prices)

Platform chips

  • Apple TV The tvOS app, with the Siri Remote.
  • iPad TV interface The Apple TV screens on an iPad, by touch. An option in Settings.
  • iPhone The iPhone app.
  • iPad The iPad app in its standard interface, which matches the iPhone's.
  • Duo The foldable iPhone: the iPhone app, with layouts that follow the fold.
  • Mac Excalibur Recorder, a menu-bar app that records for your Apple TVs.

Remote words

  • Select A click of the touch surface or the center button.
  • Hold Select Press and hold it.
  • Menu The Back button.
  • Play/Pause The play and pause button.
  • Up Down Left Right The arrows, or swipes on the touch surface.

How text is set

  • Watch on A label exactly as it appears on screen.
  • Settings › Playback Where a setting lives.
  • “Playing on another of your devices.” A message the app shows.
Section 1

Getting started

Choose a plan, add the accounts your provider gave you, and learn where everything lives.

Plans and the free trial

Apple TViPhoneiPadDuo

Excalibur has two plans. Yearly is a subscription that opens with a 7-day free trial when the App Store offers your Apple Account one. Lifetime is a single payment. In the US the prices are $24 a year and $89 once; the App Store shows the price in your own currency. One purchase covers Apple TV, iPhone and iPad.

How to use it

  1. Add your first provider account. The purchase screen appears once that account's channels have loaded. On Apple TV it waits until you press Open the guide at the end of setup.
  2. On Apple TV, under CHOOSE HOW TO PAY, choose 7-day free trial (“Then $24 a year. Cancel before it ends to pay nothing.”) or Purchase Lifetime (“Pay once. Yours for good.”).
  3. On iPhone and iPad, pick the Yearly or Lifetime card, then press the button under it. It reads Start 7-day free trial, Subscribe for $24 a year or Purchase Lifetime for $89.
  4. Confirm in Apple's purchase sheet. As the Apple TV footer says, “The App Store asks before anything is charged.”
Restore a purchase
Settings › General › Restore Purchases. The purchase screen has it too.
Check your plan
Settings › General › Excalibur shows Lifetime, Yearly, the trial, Free trial available, Not bought or Trial ended. Press it to open the purchase screen.
On iPhone and iPad
The purchase screen also has Show all N features, Manage Subscription (once subscribed), Terms of Use and Privacy Policy.

How it works

Purchases are App Store purchases on your Apple Account. Lifetime outranks Yearly, so if you own both you keep access when the subscription lapses. Someone on the free week or on Yearly can still buy Lifetime. If the App Store has an outage and offers nothing for sale, Excalibur lets you watch instead of locking you out.

The purchase screen lists what a plan includes: one guide, Rewind, Multi-View, Sports, Home Hub, iPhone and Apple TV (“One purchase covers both”), Merlin, and Synced through iCloud.

LimitsThe free trial is once per Apple Account, and its length is set in the App Store. Channels play once a plan or the trial is active.

First-time setup on Apple TV

Apple TViPad TV interface

Five short screens on the first launch, before any provider is added.

How to use it

  1. Add a source. The screen asks “Where do your channels come from?” and reminds you: “Excalibur is a player. It includes no channels or subscriptions. Add only playlists and accounts you're authorized to use.” Choose Xtream Codes (a server, username and password) or M3U / M3U8 (a playlist address, with an optional guide address).
  2. Sign in. For Xtream Codes, fill in Server, Username and Password, then press Connect. For M3U, fill in Name (optional), Playlist address and Guide address (optional), then press Add playlist.
  3. Building your guide shows “Guide coverage: N of M channels have listings”, with tiles for channels found, channels with listings, channels that play without listings, and listings ahead. Press Continue.
  4. What do you watch? Pick genre tiles (Sports, Movies, News, Kids, Documentary, Drama, Comedy, Reality, Music, Lifestyle, Religion, Entertainment), then press Continue with N, or Skip.
  5. Your local stations. Choose your area. The app shows “N stations in” your area, with Star all or None. Press Open the guide.

Faster sign-in

Paste the whole account message your provider sent into Paste, or into any field. Every field fills in and you see “Filled in from what you pasted”. The pasted text is cleared about a second later. The easiest way: copy the message on your iPhone, choose Paste on the Apple TV, and paste with the iPhone keyboard that Apple TV offers for typing.

The Server field is forgiving. A port number, a trailing slash, a panel path or a full pasted address all come down to the same server.

How it works

Your sign-in details go to your provider and nowhere else. Excalibur matches channels to their listings and keeps about two days of listings. An M3U playlist without a guide address still plays, but the guide has no listings for it.

LimitsThere is no QR-code sign-in.

Adding a provider on iPhone, iPad and Duo

iPhoneiPadDuo

The phone has its own form for adding an account. You may not need it: accounts added on your Apple TV appear on your iPhone through iCloud.

How to use it

  1. Open Settings › Providers › Add a playlist. With no provider yet, the guide also offers Add a provider: “Add a provider to start watching, or sign in on your Apple TV and it will appear here.”
  2. Paste the whole account message into Paste the account your provider sent. Or fill in the form yourself: Account type (Xtream Codes or M3U playlist), Provider name (optional), then Server address with Username and Password, or Playlist URL with Guide URL (optional).
  3. Press Add provider or the checkmark. You see “Provider added”.

Several provider accounts

Apple TViPad TV interfaceiPhoneiPadDuo

Add as many Xtream Codes or M3U accounts as you like and use them together.

How to use it

  • Add one on Apple TV: Settings › Providers › Add a playlist (“Xtream Codes or an M3U URL”), then choose Xtream or M3U8.
  • Account rooms on Apple TV: each switched-on account gets its own sidebar item, named with its short name. The room's header shows the channel count, N streams at once, and Expired when that applies. Its cards are Favorites, Home, Guide, Multi-View, Films and Series; each opens the usual screen showing only that account.
  • Account rooms on iPad: the sidebar's Accounts section lists each account, with the same six rooms.
  • On iPhone: Home lists Your providers.

How it works

Guides, Top 200, Sports and Multi-View use every account at once. When several accounts carry the same station, Excalibur plays the best copy. Each account gets its own block of channel numbers.

LimitsEach account has its own connection limit.

Managing an account

Apple TViPad TV interfaceiPhoneiPadDuo

Each account has its own page in Settings. Open Settings › Providers and press the account.

The account's name
Switches the account On or Off on this device. The line under it shows the account type, the channel count, “numbered X to Y”, and the connection limit.
Check <name>
For Xtream Codes accounts. Asks your provider for the expiry date and the connections in use, then shows “Expires in N days” or “Expired”, and “X of Y connections in use”. An expired account is marked Expired in amber and may still serve a blank picture.
Make primary
Shown with two or more accounts. Channels open on this account whenever it carries them, and the row then reads Primary account. Press again to clear it.
Channel guide
Xtream Codes accounts, Apple TV and iPad TV interface. Uses a different guide address for this account only: Save, Use the provider's or Cancel.
Playback rows
Decoder for <name>, Stream format for <name> and Rewind on .ts for <name>. See Advanced account playback and Rewind on .ts.
Name <name>
Apple TV and iPad TV interface. Opens Name this account (for example Sports, Backup, Dad's). The name travels to your other devices.
Remove <name>
On Apple TV, press twice (Press again). On iPhone, confirm Remove from This iPhone and iCloud. Deletes the account's channels, listings and stored password.
Remove all providers
Under Advanced. Returns to the welcome screen and keeps your favorites, recordings and purchase.

How it works

On Apple TV each press of a row steps to its next value. On or Off is each device's own choice and does not sync. A removal, and Remove all providers, reach every device through iCloud.

Accounts follow you through iCloud

Apple TViPad TV interfaceiPhoneiPadDuo

Your accounts, with their names and passwords, appear on every device signed in to the same Apple Account.

How to use it

There is nothing to set up. Settings › Providers › Synced through iCloud shows N accounts, or N arriving while some are on their way. Press it to adopt any accounts still waiting.

How it works

The account list travels in your private iCloud storage. It is not end-to-end encrypted unless Advanced Data Protection is turned on for your Apple Account. A removal is recorded in iCloud, and every other device deletes its own copy at its next sync. Adding the same login again by hand lifts the removal.

Your settings can travel too. Settings › Providers › Sync settings with iCloud, on to start, keeps captions, audio, commercial skipping, radio sync, channel numbers, your guide, the Best feed order and each provider's stream format and numbering the same on every device signed in to your iCloud. Playback engine, picture, buffer and recording settings stay with each device.

LimitsSwitching an account On or Off stays on that device.

Adding an extra program guide

Apple TViPad TV interface

Extra listings for channels your provider's guide does not cover.

How to use it

  1. Open Settings › Providers › Add a guide.
  2. Enter one or more guide (XMLTV) addresses, separated by spaces. Plain and compressed files both work, and https:// is assumed.
  3. Press Add. Each added guide gets an On/Off row and Remove <name>.

How it works

Your provider's own guide always wins. The extra guide fills in channels it says nothing about.

LimitsThere is no extra-guide form on iPhone, iPad or Duo. An M3U account can take a guide address when you add it, on any device.

Channel numbers

Apple TViPad TV interfaceiPhoneiPadDuo

Every channel has its own number, even across several accounts.

How to use it

Numbers show on guide rows and cards while Settings › Guide › Show channel numbers is On, which is the default. On Apple TV, type a number with Go to channel.

How it works

The primary account keeps your provider's own numbers. Every other account moves into its own block of 10,000, with room to grow, so channel 405 becomes 30,405. Numbers never move once set, and an account switched on later takes the next free block. The account's Settings row says “numbered X to Y”.

LimitsThe primary account is chosen on each device, so one account can carry different numbers on different devices. If two accounts still share a number, Go to channel asks which one you mean.

Keeping channels and listings fresh

Apple TViPad TV interfaceiPhoneiPadDuo

Excalibur refreshes each provider's channel list and program listings by itself. You can also refresh by hand.

How to use it

  • Settings › Providers › Update channel list: 1h, 3h (the default), 6h, 12h or Daily. Apple TV and iPad TV interface.
  • Refresh channel list re-reads every playlist now.
  • Guide coverage shows the share of channels with listings. Press it to fetch listings again.
  • In the guide, More › Refresh listings.

How it works

Listings refresh on their own once they are 6 hours old, and a failed refresh is retried after 30 minutes. The iPhone refreshes listings on the half hour. If the app closed unexpectedly during two refreshes in a row, automatic refresh pauses until you choose Refresh listings. An empty answer from a provider never wipes an account.

LimitsHow many channels have listings depends on your provider. Many channels have none.

Adult channels and the PIN

Apple TViPad TV interfaceiPhoneiPadDuo

Adult channels stay hidden until you set a PIN and unlock them.

How to use it

  1. Open Settings › Adult channels › Set a PIN and enter four or more digits, twice.
  2. Use Show adult channels to switch between Locked and Unlocked. Unlocking lasts until the app closes.
  3. Change PIN and Remove the PIN ask for the current PIN first.

The same pane has Clear watch history, which clears Continue watching.

How it works

Adult channels are found from your provider's adult flag, or from words in category and channel names in several languages. Detection leans toward locking. Until a PIN exists they are hidden everywhere.

Even unlocked, they never appear in your last channel, Continue watching, On now, search, Multi-View, Top Shelf, widgets, previews, or the Live TV panel's saved pictures, and the Lock Screen names them only as Excalibur. Opening one from a link or from Siri asks for the PIN.

LimitsThe PIN stays on the device where you set it and never syncs, so set one on each device. Five wrong entries lock the pad for a minute, doubling each time up to 32 minutes (“Too many wrong entries. Try again in N minutes.”). The count survives a relaunch.

Getting around

Apple TViPad TV interfaceiPhoneiPadDuo
Apple TV sidebar
On the left; it expands when you move into it. From the top: Home Hub, Live TV, AI Search, Guide, Sports, Movies (the screen is titled Films), Series, Favorites (your guide showing only starred channels), Multi-View, one item per switched-on account, Cameras (when HomeKit cameras are on), and Settings, always last. The Library opens from the guide, Home and Settings.
Menu on Apple TV
Closes whatever is open first, then leaves the player. On a screen from the sidebar it goes to the top of the page, then to the sidebar, then back to the Apple TV Home Screen.
iPhone
The tab bar reads Home, Live TV, Guide, Multi-View and More at first. More holds Sports, AI Search, Films, Series and Settings. Settings › Tabs changes the order: Home stays first, you drag the others, and those past the bar wait under More. Standard order puts them back. Home and Live TV each have an AI Search button. The app opens on Home.
iPad
A sidebar lists Home, Live TV, Guide, Sports, AI Search, Films, Series, Multi-View and Settings, with an Accounts section below.
Duo
The iPhone tabs. When the Duo is open they sit in a rail beside the content: Home and the next four of your tabs, then More. Settings › Tabs chooses the four.

What's new

Apple TViPad TV interfaceiPhoneiPadDuo

The notes for the build you have installed.

  • Apple TV: Settings › General › What's new in build N.
  • iPhone and iPad: Settings › About & Legal.

LimitsNo pop-up appears after an update; open the notes from Settings.

Section 2

Watching

The player, changing channels, sound and captions, pausing and rewinding live TV, films and series, and how Excalibur picks the best copy of a channel.

The Apple TV player screen

Apple TViPad TV interface

Full-screen live TV, with an information overlay that fades away.

Top left
A LIVE badge (REPLAY during a catch-up replay), the channel logo and name, and a format badge measured from the actual picture.
Under the name
The channel number, Source: <account>, resolution, frame rate, Mbps, and the audio the feed declares.
Top right
An UP NEXT · <time> card when the channel has listings.
Bottom
The program title, subtitle and time range. When you can rewind, a timeline ending in LIVE or the time behind live.
Sometimes
A recording notice while a recording runs, and a Sound only card on radio channels.

How it works

The overlay fades after 4 seconds without a press, and any press brings it back. There is no separate Info button; the overlay is the information.

The control bar

Apple TViPad TV interface

One glass capsule of 16 controls under the picture. The name of the control you are on shows beneath it. From left to right:

Pause / Play (the only control with a written label), Audio, Subtitles (shown as CC Off or CC On), Favorite, What's on?, Watch on, Multi-View, Picture in Picture, Guide, Record, Stats, Timeline, From the beginning, Back 30s, Forward 30s and Jump to live.

How to use it

Left and Right move along the bar and Select presses. A hint line under the bar explains each control.

How it works

Controls never disappear. One you cannot use right now is dimmed, focus skips it, and the hint says why, for example “No other account carries this channel”, “This stream carries no subtitles”, “This channel has no rewind window” or “Wait for this live channel to connect, then choose Record”. Films and recordings dim Jump to live, What's on?, Watch on, Multi-View, Guide and Record.

Guide opens the guide over the channel you are watching, and one Back from the guide returns you to that channel.

LimitsOn the bar, Left and Right move between controls and never seek. With nothing on screen they go straight to the timeline; see The remote in the player.

The remote in the player

Apple TV
Play/Pause
Pauses and resumes.
Up
Opens the Live TV panel.
Down
The first press shows the controls; a second press opens the panel.
Left Right
With nothing on screen, go straight to the timeline: 10 seconds a press, more as you keep pressing, and the picture goes there by itself half a second after you stop. Down then moves to the control bar, keeping where you went, and a second Down opens the panel. On a channel with no rewind, the controls come up and say why.
Select
With the controls hidden, shows them.
Hold Select
About 0.7 seconds: goes back to the previous live channel.
Menu
Closes what is open, in this order: a picker or prompt, the sources list, the panel, the What's on answer, Stats, an armed timeline. With nothing open, it leaves the player.
Next and previous track
From Control Center's remote, Siri and some other remotes. Changes channel, walking your favorites when the current channel is one, otherwise the guide section. Wraps at the ends.

The hint line reads “Up and Down to browse channels · Timeline to scrub” when you can rewind, and “Up and Down to browse channels” otherwise. On the timeline it reads “◀ ▶ to move · ▼ Controls · ▲ Channels”, and on a film “▲ Timeline”, which Up opens.

NoteThe iPad TV interface maps these to touch; see iPad TV interface.

Changing channel: the Live TV panel

Apple TViPad TV interface

A strip of channels over the picture you are watching, with a large picture of the highlighted channel above it. Nothing changes until you choose.

How to use it

  1. In the player, press Up (or Down twice).
  2. Move along the channels with Left and Right.
  3. For more, press Up to reach the actions: Watch / Watching; Watch the better copy (for example Watch the 4K copy) when another account has a better picture; Sources N when there are several copies; Add to Multi-View / In Multi-View, window N; Add to Favorites / Remove from Favorites.
  4. Press Select to tune. Down returns to the row and Menu closes the panel. It also closes by itself after 10 seconds.

The key line reads “◀ ▶ Channels · ▲ Actions · Select to watch”.

How it works

Which channels it walks: the run you came from (search results, a Sports row), otherwise your favorites, otherwise the guide section.

The large picture is a fresh frame of the channel you are watching, marked WATCHING; or the last frame this Apple TV kept of that channel, with a pill showing its age; or the channel's logo if you have never watched it. A frame is kept once a minute while you watch, for your last 300 channels, never for adult channels.

Live preview: rest on a channel for 0.8 seconds and it plays silently on a spare connection (LOADING PREVIEW…, then LIVE PREVIEW).

Beside the picture are the name and number, LIVE or No listing from the provider, and the listing with minutes left. For a channel with no listing, Merlin describes the picture.

LimitsLive previews need a free connection to your provider. Without one the panel says “No spare connection for a live preview”.

Back to the previous channel

Apple TViPad TV interface

A one-press jump back to the last live channel you watched.

How to use it

In the player, hold Select for about 0.7 seconds, with the controls hidden or with Play/Pause focused.

LimitsIt does not work in a film, a replay, the Live TV panel or while scrubbing. With no earlier channel it says “Watch another live channel first to switch back.”

Watch on: other copies of a channel

Apple TViPad TV interfaceiPhoneiPadDuo

Every copy of the current channel across your accounts, so you can move to a better one or one that works.

How to use it

  1. In the player, press Watch on. On iPhone it is in the bar, or under More.
  2. Pick a copy. Rows are tagged BEST, PLAYING or OFF AIR, with badges for resolution, frame rate, and 5.1 or Stereo.
  3. Optional: the 5.1 only switch (Copies in 5.1 surround / Every copy) hides copies not known to carry 5.1 sound. It is Off by default and each device keeps its own choice.

How it works

Solid badges were measured on this device; outlined badges are your provider's own label. The legend says so: “Solid: measured on this Apple TV · Outlined: the provider's label”. The list has two headings: Other copies of this channel, and Also showing <program> for other channels carrying the same program.

LimitsOnly switched-on accounts are listed, and only one account's copies while the guide shows that account (Account…). When no copy qualifies under 5.1 only, the sheet says “No copy here is known to carry 5.1 yet…”

Sound: tracks, language and mute

Apple TViPad TV interfaceiPhoneiPadDuo

Choose the soundtrack, set a default language, or mute Excalibur.

How to use it

  • Apple TV: press Audio in the bar and pick a track; a checkmark marks the current one. Done closes it. During a game with radio calls, a RADIO WITH THE PICTURE section appears here too (Radio with the picture).
  • iPhone and iPad: the Audio sheet shows Playing on <output>, then SOUNDTRACK, RADIO CALLS (with TV sound) and SUBTITLES.
  • Default language: Settings › Video & Audio › Audio language: Automatic (the device's language), English, Spanish, French, German, Italian, Portuguese or Arabic. It applies from the next channel.
  • Mute: Settings › Video & Audio › Audio: On or Muted. Muted lasts while the app stays open; Excalibur starts with sound On.

How it works

A track you pick is remembered for that channel and wins over the default language. Stats names the output, such as SURROUND 5.1, DOLBY 5.1 or DOLBY ATMOS. Dolby Digital plays when the channel carries it.

LimitsThere is no Off track. With nothing to choose, the list says “This stream has one soundtrack.” or “This stream has not reported selectable audio tracks.” Many channels come from the provider in stereo only.

Captions and subtitles

Apple TViPad TV interfaceiPhoneiPadDuo

Captions carried in the stream, including closed captions inside the video.

How to use it

  • Apple TV: press Subtitles (CC Off / CC On). Captions come on in the device's language, otherwise the first track.
  • iPhone and iPad: Captions On / Captions Off in the bar, or the SUBTITLES list (with Off) in the Audio sheet.
  • Captions when muted: Settings › Video & Audio › Captions when muted (default Off) shows captions while Excalibur's own Audio setting is Muted.

How it works

Turning captions off on a channel keeps them off on that channel. Turning captions on or off overall carries over to other channels.

LimitsOn Apple TV the button switches captions on or off; there is no list for choosing among several subtitle tracks. Muting the TV or receiver is not detected.

Stats and Diagnostics

Apple TViPad TV interfaceiPhoneiPadDuo

Technical readouts of the stream you are watching.

  • Apple TV: Stats in the bar opens a panel titled Stream, with VIDEO, AUDIO, PERFORMANCE, NETWORK and STREAM. Throughput is the rate your provider sends the stream, whichever decoder plays it. Menu closes it.
  • iPhone: Stats in the bar, or More › Stats, shows Picture, Frames, Bitrate, Buffer, Dropped, Decoder and Engine.
  • Diagnostics (Apple TV and iPad TV interface): Settings › Playback › Diagnostics › Open. It shows Frames on screen, BUFFER AHEAD and bitrate panels, a THE LAST 90 SECONDS chart with stalls marked, fact tiles, and Check this channel, which asks each account what it serves. Done closes it.

How it works

A row appears only when its value is actually known.

LimitsThe readouts cannot be exported.

Picture in Picture on Apple TV

Apple TViPad TV interface

The channel keeps playing in a small window while you browse.

How to use it

  1. In the player, press Picture in Picture. Excalibur goes to Home with the channel in a window in the corner.
  2. To go back, choose a channel, or open the guide, which takes the picture into its own window. In the iPad TV interface, select the window to return to full screen.

How it works

On Apple TV the window is tvOS's own Picture in Picture, the same one Keep playing while browsing uses, and leaving Excalibur closes it. In the iPad TV interface, Excalibur draws the window itself, badged LIVE, OFF AIR or NOT PLAYING.

LimitsIn the iPad TV interface, the window has no close button.

Keep playing while browsing

Apple TV

Back from a live channel keeps it playing in a corner window on screens with no room for the picture, such as Sports, Settings and Search.

How to use it

  • In the player, press Menu and go on browsing. The channel carries on in the corner.
  • Open the guide to take the channel back into the guide's window, or choose another channel or Multi-View to replace it.
  • To turn it off: Settings › Playback › Keep playing while browsing (On by default).

How it works

Home Hub and Live TV keep the channel behind the page, and the guide keeps it in its window, so they need no corner window. Going back from full screen to the guide keeps the show playing in the guide's window. Films and replays stop when you leave them.

LimitsLeaving Excalibur closes the window and stops the channel. Not in the iPad TV interface.

The iPhone and iPad player

iPhoneiPadDuo

A touch player with a full-screen layout and an upright layout.

Sideways, and iPad
At the top: Close (a down arrow), LIVE, the logo, the number and channel name, a format pill such as 1080p60, the title, and a line such as “7:20 to 10:30 PM · 42 min left”. A timeline appears where you can rewind. The bar holds Pause/Play, Favorite, Watch on, Multi-View (live only), Channels, Stats, Back 30 Seconds, Forward 30 Seconds, Jump to Live, Audio, and Captions On/Off. On narrow screens, such as a folded Duo, the bar shrinks to a More menu, then to icons, then to a row that scrolls sideways.
Upright iPhone
A 16:9 picture at the top, then Audio, Radio call, Back 30s, Multi-View and More (favorites, Watch on, Channels and captions). Below: ALSO ON NOW (up to 10 channels; a tap tunes at once), NEXT ON <CHANNEL>, and “Turn sideways for the whole screen”.
Gestures
Tap shows or hides the controls, which hide again after 4 seconds. Double-tap switches between Fill and Fit; Fit is the default. Swipe left or right to open the channel panel one channel along. Swipe up to open the panel. Swipe down to close the player.
Channel panel
A band such as Favorites · 3 of 20. Tap a card, then Watch <channel>. It closes after 10 seconds.
Dimmed buttons
Still answer a tap with the reason, for example “This channel has no rewind window”. Errors offer Try Again and Close.

LimitsNo channel up and down buttons, no pinch to zoom, no From the beginning and no catch-up replays. The iPad always uses the full-screen layout.

Picture in Picture and background play

iPhoneiPadDuo

Keep watching, or keep listening, outside the app.

How to use it

While a channel plays, swipe up to the Home Screen. The system Picture in Picture window starts by itself once the stream has played steadily for 1.5 seconds.

How it works

Where Picture in Picture is not available, the picture is hidden and the sound keeps playing. That includes a radio call, and it plays even with the silent switch on. Closing the Picture in Picture window while the app is in the background pauses playback. Ten seconds after the app goes to the background, the guide trims itself to now and next to save memory, and fills in again when you return.

With sound, a channel plays where your other video apps play: on the HomePod or Apple TV you send video to, or on the device. Home, the guide and their previews stay on the device and never take a speaker another app is using.

LimitsThere is no Picture in Picture button and no AirPlay button in the app; choose a speaker or TV in Control Center as usual. There is no CarPlay app; the sound plays through the car. Not in the iPad TV interface.

Lock Screen and Control Center

Apple TViPad TV interfaceiPhoneiPadDuo

Excalibur tells the system what is playing.

How it works

The program title, channel name and logo show on the Lock Screen and in Control Center. Live channels are marked live; films get a scrubber. Play/Pause always works, and 30-second skips and scrubbing work where you can rewind. On Apple TV, next and previous track change channel. Adult channels show only Excalibur.

LimitsYou cannot change channel from the iPhone's Lock Screen.

Pause and rewind live TV (Live buffer)

Apple TViPad TV interfaceiPhoneiPadDuo

Excalibur records what you watch to the device, so you can pause and rewind live TV.

How to use it

  1. Turn it on: Settings › Playback › Live buffer. Choose 30 min, or 1 to 6 hr. It is Off by default.
  2. Watch a channel. Rewind becomes possible as the buffer fills.
  • Apple TV: Play/Pause pauses. With nothing on screen, Left or Right goes straight to the timeline, 10 seconds a press and more as you keep pressing, and the picture goes there half a second after you stop. Down moves to the control bar and keeps where you went; Menu leaves the timeline. Timeline on the control bar opens it too. Back 30s, Forward 30s and Jump to live do what they say.
  • iPhone, iPad and Duo: drag the timeline, or use Back 30 Seconds, Forward 30 Seconds and Jump to Live.
  • Settings › Playback › Rewind window shows how far back the current channel can go.

How it works

The buffer fills from the moment you tune, at about 2.2 GB an hour for a 5 Mbps channel. Channels your provider sends in the .ts format also need Rewind on .ts. When rewind is not possible, the hint says why:

  • “Live only · turn on Live buffer in Settings to rewind”
  • “Live only · your provider refused the recording”
  • “Live only · the recording did not start on this channel”
  • “Live only so far · recording, rewind opens as it fills”

If your provider refuses, the Settings row shows Unavailable for 7 days; pressing it tries again.

LimitsThe buffer lives in the device's cache, which the system can clear. Channels in .ts format that use HEVC video, which includes most 4K channels, cannot rewind. Without the buffer you can rewind only as far as your provider allows.

Rewind on .ts channels

Apple TViPad TV interfaceiPhoneiPadDuo

An account switch that lets channels sent in the .ts format use the Live buffer.

How to use it

Open Settings › Providers › <account> › Rewind on .ts for <name>. It is Off by default. It needs the Live buffer on; otherwise the row reads “On, but the Live buffer is off: turn it on to record”.

How it works

With it On, that account's .ts channels are recorded as you watch and played through Apple's player, so you can pause and rewind them. With it Off, they play on Excalibur's own player and cannot be rewound.

Limits.ts channels that use HEVC video cannot rewind.

From the beginning

Apple TViPad TV interface

Jump back to the start of the program on now, using the Live buffer.

How to use it

In the player, press From the beginning.

How it works

If the buffer does not reach back that far, the player says so: “The buffer starts at <time>, after <program> began at <time>”.

LimitsOnly as far back as the Live buffer holds. Not on iPhone.

Start Over: replays from your provider

Apple TViPad TV interface

Replays of programs that have finished, on channels where your provider keeps an archive.

How to use it

Choose it on a program that has ended:

  • In the Prism guide's action strip, Start Over; in Prism's Details, From the Start.

How it works

The replay plays with a REPLAY badge on the program's own timeline. Jump to live leaves it. If your provider fails to send it, the app says “Your provider did not have this recording” and stops offering that channel for 7 days.

LimitsOnly programs that have ended, within the channel's archive, on channels that offer one. Many channels have no archive: “This program has finished. Your provider does not offer replays on this channel.” Not on iPhone.

Films and series

Apple TViPad TV interfaceiPhoneiPadDuo

Your providers' on-demand catalogs.

Apple TV
Open Movies or Series in the sidebar, or an account's Films or Series room. The header shows ON DEMAND (or SERIES), N collections and Describe what you want. Poster rows load as you reach them.
A film's page
Year, genre and length, the account, time left or Watched, the plot, then Play movie / Resume movie, Start over, Other sources, Director and Cast.
A series
Opens its episodes by season, on the episode up next. Other copies of <series> lists the same series on other accounts.
Hold Select
On a poster or episode: Mark as Watched / Mark as Unwatched, Start From Beginning, Remove from Continue Watching.
iPhone, iPad, Duo
Films and Series are under More (in the iPad sidebar), in rows with See all N. A tap on a film plays it. A series opens a list of episodes. The sparkles button opens Ask Merlin.

LimitsOn iPhone, iPad and Duo there is no details page, no resume point and no watched marks. Adult collections appear only when unlocked.

Resume and watched marks

Apple TViPad TV interface

Excalibur remembers where you stopped in a film or episode, and what you finished.

How it works

A position is saved after 30 seconds of play. A title counts as watched at 95%, or with 2 minutes or less left (for titles of 4 minutes or more); the resume point is then cleared and the title shows Watched. Cards show Watched, 23m left, Almost done or a progress bar. A series opens on the episode you left part way, or the one after the last you finished.

Positions and watched marks sync between your Apple TVs through iCloud, and the newest wins. Mark as Unwatched is remembered for 90 days.

LimitsThe next episode never plays by itself.

Continue watching across devices

Apple TViPad TV interfaceiPhoneiPadDuo

Pick up on one device the live channel you were watching on another.

How to use it

Look for From <device> cards, then press or tap one to watch:

  • Apple TV: the Home Hub's Continue from row, Live TV's Jump back in, and a badge on Live TV's tiles.
  • iPhone: the Home Hub's main card, the Continue from row, Live TV's Jump back in, and the Last Channel widget.

To stop sharing, switch off Settings › Playback › Continue watching across devices (On by default, set on each device). Off writes nothing and shows nothing from your other devices.

How it works

Each device writes its last live channel to iCloud, and your other devices offer it for 8 hours.

LimitsLive channels only. Adult channels are never shared.

Commercials: lower the sound during breaks

Apple TViPad TV interfaceiPhoneiPadDuo

Excalibur can turn the sound down when a channel goes to commercials.

How to use it

  1. Open Settings › Video & Audio › Commercials and choose Down 20 dB or Muted. The default, Full volume, leaves the sound alone.
  2. Optional: set Break detection to Strict (the mark must be seen 90% of the show), Normal (80%, the default) or Relaxed (70%).

During a break a notice reads “Commercials · sound down 20 dB” or “Commercials · muted”.

How it works

For about 75 seconds the app learns the channel's own on-screen mark, such as a logo or scoreboard, and remembers it across launches. The sound goes down when the mark has been gone for 25 seconds, or 8 seconds after a black frame while it is gone. It comes back within about a second of the mark returning, and after 240 seconds it comes back regardless. On Apple TV, a sports channel also needs a fade to black. A halftime or studio look that stays on screen is learned as a second mark.

LimitsWorks in the single-channel player only, not on Home, in the guide or in Multi-View. Channels with no steady on-screen mark never lower. The first break on a new channel can play loud while the mark is being learned.

Commercial Escape

Apple TViPad TV interface

During a break, watch your last channel, and come back when the program returns.

How to use it

  1. Turn on Settings › Video & Audio › Commercial Escape (Off by default).
  2. Set Back to the program to Ask first or Automatically.
  3. About 8 seconds into a break, a prompt offers “Escape the break. Watch <your last channel> until <channel> is back” for 12 seconds. Press Select to take it.

How it works

The original channel keeps playing silently on a spare connection, and Excalibur watches it for up to 10 minutes. When the program is back, Ask first shows “Back to <channel>. The program is on again” for 20 seconds; Automatically takes you straight back.

LimitsNeeds a spare connection; otherwise “No spare connection to watch X. Staying here.” Sometimes it says “Couldn't tell if the program is back.”

Buffer profile

Apple TViPad TV interfaceiPhoneiPadDuo

How much of the stream is held ahead of the picture.

How to use it

Settings › Playback › Buffer profile: Adaptive (the default, about 1.5 to 12 seconds, adjusting to your network), Minimal 1s, Balanced 3s, Stable 8s or Deep 16s (which starts once 4 seconds are in hand).

How it works

A bigger buffer rides out network hiccups. The cost is a slower start and more delay behind live.

Picture quality: resolution, Match Content and HDR

Apple TViPad TV interfaceiPhoneiPadDuo
Maximum resolution
Settings › Video & Audio: Automatic (the default), 4K, 1080p or 720p. All devices.
Match Content
Apple TV. Excalibur follows the Apple TV's own Settings › Video and Audio › Match Content for frame rate and dynamic range, including Dolby Vision; there is no separate switch in the app. It switches only in the full-screen player, after 4 seconds on the same channel, so flipping through channels causes no blank screens. It skips the switch when the TV's current rate already fits, such as 30 frames on a 60 Hz TV. Going from an HDR channel to an SDR one while you watch takes the TV out of HDR.
Keep HDR in menus
Apple TV, Settings › Video & Audio, Off by default. Keeps the TV in HDR after you leave an HDR channel.

Best copy, Best feed order and Prefer 5.1 surround

Apple TViPad TV interfaceiPhoneiPadDuo

When several accounts or feeds carry the same station, Excalibur ranks the copies and plays the best one.

How it works

Copies known to be off the air or busy are skipped. The rest are ranked in this order:

  1. Copies that recently dropped seconds of picture, or kept going quiet, go last.
  2. Your Best feed order. With Smoothest first, the default: 4K, 1080p and 720p at 50 to 60 frames a second, then copies never played, then 4K, 1080p and 720p at 25 to 30, then anything smaller than 720p.
  3. A taller picture.
  4. 5.1 sound before stereo.
  5. A clearly higher bitrate.
  6. A faster frame rate.

In the Apple TV player, a channel whose stream goes quiet for 6 seconds or more twice within 5 minutes moves to a steadier copy of the same channel. The quiet copy then ranks last for 6 hours, so Watch best feed does not send you back to it.

Best feed order
Settings › Video & Audio › Best feed order, and Best feed order… under a game's Sources. Smoothest first (the default: 60 fps before anything sharper, made for sports), Sharpest first (the biggest picture, then the frame rate, for films and shows) or Custom, your own order of eight rows from 4K · 60 fps to Smaller than 720p. On Apple TV, choose Custom, then Select a row to pick it up and move it with Up and Down. On iPhone, iPad and Duo, drag a row. Sports, Watch on and the copy a channel opens on all follow it, and it travels with Sync settings with iCloud.
Prefer 5.1 surround
Settings › Video & Audio, Off by default. On, a smooth 5.1 copy beats a sharper stereo one.
Copies
Settings › Guide: Grouped (one row per station) or All (every copy, the default). Top 200 and Sports always show one row per station.

Connections and your provider's limits

Apple TViPad TV interfaceiPhoneiPadDuo

How Excalibur stays within the number of streams your provider allows.

How it works

Each login allows the number of streams your provider states. Previews, Multi-View windows, radio calls and recordings each use one. Your devices tell each other through iCloud what they have open, so they do not knock each other off.

A provider plays a given channel to only one device per login. Excalibur avoids a copy another of your devices is playing and moves to another account's copy when there is one. Otherwise it says “Playing on another of your devices.” A recording's connection is never taken.

On Apple TV, a channel that had to move to another account's copy stays there unless your own copy is a clearly better picture, smoother or sharper, so the picture does not jump in the middle of a game.

On Apple TV, a game whose stream arrives in bursts stays on its copy: Excalibur moves to another copy only when the picture actually freezes.

A copy your provider refuses is remembered and not tried again right away. On Apple TV, on an account that allows more than one stream, a refusal moves you to another account, and a channel you leave lets go of its stream at once, even one still starting.

On Apple TV, a preview that cannot open says why: every stream that account allows is in use, one is kept free for your next channel, or you just left that channel.

LimitsAn account with one connection cannot show previews, play radio calls with the picture, or fill more than one Multi-View window from that login.

Advanced account playback

Apple TViPad TV interfaceiPhoneiPadDuo

Options for an account whose channels misbehave. The defaults suit most accounts.

Decoder for <name>
Automatic (the default), Native playback, or AVFoundation (Apple's player). With AVFoundation, channels it cannot play are hidden, and the row's detail line says how many.
Stream format for <name>
Automatic, M3U8 or TS. Changing it re-reads the account. M3U8 carries Dolby Vision and Atmos and rewinds with the Live buffer. TS changes channels faster and matches the TV's frame rate and HDR; it rewinds when Rewind on .ts is On.
User agent
Settings › Providers, Apple TV and iPad TV interface. The name Excalibur gives your provider: Excalibur (the default), one of several common media-player names, or Web browser. Takes effect from the next channel.

WhereDecoder and Stream format are on each account's page in Settings › Providers.

Screen saver held off while you watch

Apple TViPad TV interface

The tvOS screen saver, or the iPad's Auto-Lock, stays away while you watch.

How it works

It is held off in the full-screen player, in Multi-View and on the On watch tonight screen, and allowed again 3 seconds after you leave them. There is no setting.

Section 3

Guides

Prism is the guide on every device: with the remote on Apple TV, and by touch on iPhone, iPad and Duo. Favorites, Top 200 and the guide sections work across all of them.

Prism, the only look

Apple TV

Prism is the only guide and the only look on Apple TV: smoked glass, cream type and a serif title face, in the guide, the pop-ups and the Home Hub. Spotlight, Live Canvas and the Classic look are gone, Settings no longer has a Look row, and an Apple TV that had one of them chosen now opens in Prism.

NoteThe iPad TV interface offers Prism only, always in the Prism look. iPhone, iPad and Duo have their own touch Prism guide.

The Prism guide on Apple TV

Apple TViPad TV interface

The channel under the cursor plays full screen behind the guide. Its program is written large in a smoked-glass panel, over a glass grid of three hours.

The top bar
Top 200, Sports, Favorites, More (it takes the name of the section you are in), Library (with a red badge counting new episodes), Search (a magnifier) and the clock.
Up Down
Move between channels. Up from the first row reaches the bar.
Left Right
Move between listings. Right past a row's last listing moves an hour later, up to 5 hours ahead. Left off the first listing of a later page goes back an hour, and Menu on a later page returns to now. At now, Left off the first listing opens the sidebar.
Select
Watches that channel live, even from a later listing.
The cursor
The show under it is a solid blue tile, and its channel is boxed in blue. The line at the current time runs between shows rather than through them, and a show's progress bar runs from green to red as it ends.
Hold Select
Half a second: opens the action strip.
Play/Pause
Opens Details.

How it works

The highlighted channel starts playing behind the guide 1.5 seconds after you stop moving. Top 200 and Sports rows play the best copy. The large panel shows the title, the time, minutes left, a NEW badge, FOLLOWING, and a red dot when the program will record. The grid opens on the current half hour and pages an hour at a time. Going back from full screen to the guide keeps the show playing in the guide's window.

LimitsNo preview plays for adult channels while locked, for copies recently off the air, or when Preview while browsing is Off. Previews use a connection to your provider.

The action strip

Apple TViPad TV interface

The row of buttons that replaces a listing's description when you hold Select on it in the Prism guide.

  • Watch Now (Watch live on a later listing).
  • Start Over, where the channel offers replays.
  • One record button whose label follows the state: Record, Record from the start, Schedule recording, Cancel recording, Skip this one, Stop & Save, Saving… (see Recording).
  • Follow / Following (Follow a show).
  • Favorite / Favorited.
  • Multiview: adds the channel and opens Multi-View.
  • Sources (N), when more than one copy exists.
  • Details.
  • More: Save what has played, Recordings, Go to channel… and Refresh listings.

How it works

A note can appear under the strip, such as Merlin's suggestion to follow a show or where a recording will happen. When space runs short, the less-used buttons shrink to icons. The iPad TV interface adds Close.

Details

Apple TViPad TV interface

A full panel about one listing.

How to use it

Press Play/Pause on a listing. Play/Pause or Menu closes it.

  • The logo, number, title and subtitle.
  • Watch Live, From the Start (where replays exist) and Record.
  • WATCH ON: each account's copy, with its quality.
  • ALSO SHOWING: other channels with the same program.
  • NEXT ON: the next two programs.

Guide sections: the More panel

Apple TViPad TV interfaceiPhoneiPadDuo

The sections the Prism guide can show.

How to use it

Select the More pill. The panel lists For You, Recents, All Channels, Your guide (once built), News, Local, Categories…, Go to channel…, Later today… (now, or any hour up to 5 hours ahead), Account… (with two or more accounts switched on), Ask Merlin (opens AI Search) and Refresh listings.

On iPhone, iPad and Duo, More sits at the end of the guide's bar and opens the same choices as a menu.

How it works

The last section you chose is remembered. Empty sections explain themselves: Recents says “Channels you watch will appear here.” and Favorites says “Favorite a channel to see it here.”

Account… shows one account's channels: choose All accounts, or an account by its short name. With one account chosen, the sources number and Watch on show only that account's copies.

LimitsInside a single account's room, or with one account chosen, For You and Recents are hidden.

Go to channel

Apple TViPad TV interface

A number pad for jumping straight to a channel.

How to use it

  1. In the guide, open More › Go to channel… GO TO CHANNEL appears, with keys 0 to 9, delete and close.
  2. Type a number. It matches as you type, and offers the nearest number that starts with your digits (marked · nearest).
  3. Press Watch.

How it works

When nothing matches: “No channel numbered N”. When two accounts share the number: “N is on 2 accounts. Choose one below.”, with one button for each account.

LimitsAvailable in the guide, not in the player. On iPhone, iPad and Duo, Go to channel… is in the guide's More menu.

The Prism guide on iPhone, iPad and Duo

iPhoneiPadDuo

The touch version of Prism.

Narrow screens
The picture and its title on top, and a glass grid below showing 1 to 3 hours, depending on the width.
Wide screens
On iPad, an iPhone on its side, or an open Duo, the guide splits side by side. The left pane holds the picture, title, Watch, the description and LATER ON; the right pane holds the bar, search and grid. On an open Duo the split sits exactly at the fold.

How to use it

  • The bar holds Top 200, Sports, Favorites and, at its end, More: For You, Recents, All Channels, News, Local, Categories…, Go to channel…, Later today, Account, Ask Merlin and Refresh listings (Guide sections).
  • Tap a listing to light it and play its channel behind the title. Tap the lit listing to watch full screen.
  • Touch and hold a listing for about half a second to open its details: “Listings from <station>”, the time and minutes left, the description, Watch / Watch live, Favorite / Favorited, Watch on (N), and LATER ON <CHANNEL>.
  • Swipe sideways to move an hour at a time, up to 5 hours ahead. Now / Back returns to now.
  • The magnifier searches all visible channels by name and by what is on (Search N channels). Type a team and its game comes first. A chosen result plays.

How it works

The preview is silent unless Settings › Home Hub › Preview sound is On. On its side, the iPhone hides the tab bar.

LimitsThe details window has no Record, Follow or Multiview.

Favorites

Apple TViPad TV interfaceiPhoneiPadDuo

Your starred channels.

How to use it

  • Star a channel with Favorite in the Prism action strip, the player's bar or the Live TV panel; with Add to Favorites when you hold a Live TV tile; or from the iPhone details window, or the heart in the iPhone guide.
  • See them with the Favorites pill, the Favorites sidebar item, or an account's Favorites room.

How it works

Favorites sync between your devices through iCloud. Removing a favorite removes every copy of that station. Favorites also steer the player's channel panel, Siri's channel matching and Top Shelf.

Recents and All Channels

Apple TViPad TV interfaceiPhoneiPadDuo
Recents
Channels you watched, newest first.
All Channels
The whole lineup for your country setting, or for one account inside its room.

On iPhone, both are under More in the guide.

Top 200 and the Sports pill

Apple TViPad TV interfaceiPhoneiPadDuo

Top 200 is a built-in list of 200 popular US channels, one row per station, whichever account or spelling carries it. Broadcast networks come first (shown as your local stations when Your area is set), then news, sports, entertainment, lifestyle, kids, films, premium, music and Spanish-language channels. The Sports pill shows sports channels the same way.

How to use it

Select the Top 200 or Sports pill in the guide.

How it works

Choosing a row plays the best copy across all your accounts. Copies recently off the air come last and copies from another country are left out. Smooth beats sharp, and measured beats claimed. The East feed comes before the West feed, and a copy with listings before one without.

LimitsTop 200 is built for a US lineup. A station your accounts do not carry simply does not appear.

For You

Apple TViPad TV interface

A guide section of up to 40 channels Merlin picks for you.

How to use it

In the guide, More › For You.

How it works

Only channels from your own country are considered, and other towns' local stations are removed before Merlin sees the list. Merlin ranks them from your recent viewing, your taste, and What you follow. An answer is reused for 30 minutes unless your lineup, area or country changes.

The status line reads “For You • N channels picked by Merlin from what you watch”. On an Apple TV without a key it reads “For You • from what you watch • Add your OpenAI key in Settings for Merlin's picks”, and when Merlin cannot answer, “Merlin unavailable • Showing what you watch”. Without Merlin, Excalibur ranks the list itself: things you follow, then channels you watched, then starred ones, then your top genre.

LimitsNot inside a single account's room, or while the guide shows one account. On iPhone, iPad and Duo, For You is in the guide's More menu.

Your guide

Apple TViPad TV interface

Your own guide section, built from the categories you choose.

How to use it

  1. Open Categories… and choose Build your guide.
  2. Pick categories. The counter shows N chosen.
  3. Press Done. A Your guide section appears in More.

Edit your guide changes it and Clear your guide removes it.

How it works

Choices are kept for each account, and for all accounts together. Your guide never narrows anything else: “All Channels still shows every channel.”

Categories

Apple TViPad TV interface

Your provider's own channel groups, as guide sections.

How to use it

Open More › Categories… A searchable list (“Sports, news, USA…”) shows each category with its channel count. Your standing choices are pinned at the top.

Country and your area

Apple TViPad TV interfaceiPhoneiPadDuo

Filter the lineup by country, and put your town's stations first.

How to use it

  • Settings › Guide › Show channels from: your country (set on first run from the device) or All countries.
  • Settings › Guide › Your area: on Apple TV, a list of towns found in your lineup's channel names, each with a channel count; on iPhone, a searchable sheet (Find your town). Choose Not set to clear it.

How it works

Your area puts your local stations first, fills the Local section, shows broadcast networks in Top 200 as your local stations, and helps pick a game's best feed.

Some provider sections carry no country label. On an Apple TV with a Merlin key, Merlin works out which country each of those sections serves. Without a key, those sections show to everyone.

LimitsThe town list comes only from what your lineup carries.

Guide display options

Apple TViPad TV interfaceiPhoneiPadDuo

All four are in Settings › Guide.

Copies
Grouped (one row per station) or All (the default). See Best copy.
Channel names
Clean (the default; removes provider tags) or Full. Search finds either.
Show channel numbers
On (the default) or Off. Apple TV and iPad TV interface.
Preview while browsing
On (the default) or Off. Plays the highlighted channel behind the guide.
Section 4

Home and Live TV

Home Hub is a dashboard: the clock, weather, what you are watching, your other devices and your home. Live TV is a wall of your channels as they last looked, with rows of things to watch.

The opening screen

Apple TViPad TV interface

Choose which screen Excalibur opens on.

How to use it

Settings › Home Hub › Open on: Home Hub, Live TV or Guide. A new install opens on Home Hub.

NoteThe iPhone always opens on Home.

Home Hub on Apple TV

Apple TViPad TV interface

A home dashboard: clock, weather, what you are watching, your other devices, your home and your recordings.

How to use it

Select Home Hub in the sidebar. Settings › Home Hub › Hub layout chooses Scrolling (the default) or At a glance.

The scrolling page, from the top (cards with nothing to show are left out):

  • The date, a large clock, the item beside the clock, and a weather chip with the week ahead.
  • The Watching card: the program, or “Choose a channel to start watching”, with LIVE, minutes left, and Watch, Guide and Multi-View.
  • Continue from: what your other devices last played (Continue watching across devices).
  • For you, which shows On now until What you like is set.
  • A row of cards: Recordings, a music card while the Music app is playing, and your calendar.
  • Your home: Cameras, Climate, then each room's lights, fans and locks (Home control).

LimitsWeather is shown in Fahrenheit only.

At a glance layout

Apple TViPad TV interface

The whole Home Hub on one screen instead of a scrolling page: the time, the weather, WATCHING, Calendar, DVR · Recordings, For you / On now, Climate, House and Cameras.

How to use it

Settings › Home Hub › Hub layout › At a glance. Each device keeps its own choice.

LimitsThis layout does not use Beside the clock.

Beside the clock

Apple TViPad TV interface

One live item next to the Home Hub's clock.

How to use it

Choose it in Settings › Home Hub › Beside the clock. The row appears with the Scrolling layout.

Radar
The default. A national weather radar over a dark map, refreshed every 5 minutes. Press it for full screen, with pan and zoom. US only.
Climate
Up to three thermostats, with minus and plus.
Cameras
Camera stills. Press for the camera wall.
Heart rate
Your Apple Watch's latest heart rate (“From <device>”), your resting rate, and a LAST 2 HOURS line. Set it up on your iPhone (Heart rate and Stocks).
Stocks
Up to six stock symbols, refreshed every minute. Set them up on your iPhone.

Weather, and rain, snow and leaves

Apple TViPad TV interfaceiPhoneiPadDuo
Weather on the hub
Apple TV and iPad TV interface. Settings › Home Hub, On by default; turning it on asks for your location. Forecasts come from Apple Weather, refreshed every 10 minutes. When that is unavailable, the National Weather Service fills in (US only). The credit line reads Apple Weather · Legal or National Weather Service.
iPhone weather
The iPhone Hub has its own Weather button, which asks for your location only when you tap it.
Rain, snow and leaves
All devices. Settings › Home Hub, On by default. Live weather falls behind the hub, or the season's effect when the weather is calm.

LimitsFahrenheit only.

Preview sound, and the channel behind Home

Apple TViPad TV interfaceiPhoneiPadDuo
Preview sound
Settings › Home Hub, Off by default. Whether the Watching card's picture and the guide previews keep their sound. All devices.
Play the channel behind Home
Settings › Playback, On by default. Live TV's lead tile plays its channel silently, using one connection to your provider. Apple TV and iPad TV interface.

Music on the hub

Apple TViPad TV interface

A card showing what this device's Music app is playing (NOW PLAYING or PAUSED), with Play/Pause and Skip.

How to use it

Settings › Home Hub › Music on the hub reads Not allowed until you press it. Pressing it asks for access to Apple Music.

LimitsMusic sent to a HomePod straight from a phone is not shown.

Calendar

Apple TViPad TV interface

A Home Hub card with your next four appointments in the coming seven days.

How to use it

  1. Open Settings › Home Hub › Calendar. The Your calendar sheet opens.
  2. Paste a published (subscription) calendar link into Address.
  3. Press Use it. The sheet also has Remove and Cancel.

How it works

The calendar is read again every 30 minutes. The address syncs to your other Apple TVs.

LimitsOnly a published calendar link works. You cannot sign in to a calendar account.

Heart rate and Stocks

Apple TViPad TV interfaceiPhoneDuo

Two Beside the clock items for Apple TV whose data comes from your iPhone.

How to use it

  1. On your iPhone, open Settings › Home Hub and find Beside the clock on your Apple TVs.
  2. For heart rate, switch on Share heart rate (Off by default). Health asks once to read your heart rate and resting heart rate. The footer then shows “Your Apple TVs show N BPM, measured …”
  3. For stocks, open Stocks, enter a stock-data key (the field asks for a free Finnhub key) and up to six symbols separated by commas, then press Save and check.
  4. On each Apple TV, choose Settings › Home Hub › Beside the clock › Heart rate or Stocks.

How it works

Readings travel through iCloud. Health wakes the iPhone app in the background when new readings arrive. Excalibur only reads from Health and never writes to it. Turning sharing off removes what was shared.

LimitsHeart rate needs an Apple Watch.

Live TV on Apple TV

Apple TViPad TV interface

A wall of your channels as they last looked, with rows of things to watch below. The hint reads “Your channels as they last looked · Select to watch, hold for more”.

How to use it

Select Live TV in the sidebar. At the top is Live now:

  • The lead tile shows what is playing, or the best thing on the air. It plays silently when Play the channel behind Home is On. Hold Select on it for Watch, Add to Multi-View, Ask Merlin and Open Guide.
  • Four tiles beside it: your last channel (here, or from another device, with a device badge), then your channels. Hold Select on one for Add to Multi-View and Add to Favorites / Remove from Favorites.

The rows below, from the top:

  • Your teams, live: up to 4 games. Select goes to Sports.
  • Jump back in: films and episodes to resume, plus your other devices' channels. Hold for Start From Beginning or Remove.
  • Recordings, with a Library button.
  • PICKED FOR YOU, with Your interests and Refresh picks (or Enable Merlin picks).
  • Your channels: your local stations and main networks, with All channels to open the guide (Channels on Home).
  • On now.

How it works

The small tiles show saved still frames; no streams are opened to fill them. A channel listing several games shows the games and their scores.

Channels on Home

Apple TViPad TV interface

Merlin chooses your local stations and the main networks for Live TV's Your channels row.

How to use it

Open Settings › Guide › Channels on Home. The row shows its state: Not set up, Choose, Working, Curated or Retry.

LimitsNeeds Merlin. Without it, the row keeps its usual order.

Home on iPhone, iPad and Duo

iPhoneiPadDuo

A Home Hub, followed by your channels. Open the Home tab.

Top
The date with an AI Search button, a large clock, and the weather under it (Weather until you allow location).
This week
Five days, with today ringed.
Radar
A still map. Full screen › opens a map you can move around.
The main card
Titled Last watched, From <device> or On now. A silent live preview, a ring with minutes left, and tiles for CHANNEL, ENDS and NEXT, with Watch, Multi-View and Guide ›.
Continue from
Each other device's last channel, how long ago, and Watch.
Your home
Connect HomeKit until allowed, then Cameras (All N › opens a two-across wall), Climate (Lower / Raise) and House: each room's lights, fans, locks, plugs, HomePods and Apple TVs.
After the hub
Your providers, then rows of channels by your provider's categories. Tap a channel to play it. Tap a provider to open its rooms: Favorites, Home, Guide, Multi-View, Films and Series, each showing only that account.
Empty states
Add your channels, Loading your channels…, Your providers are off or No channels yet, each with a Settings button.

Live TV on iPhone, iPad and Duo

iPhoneiPadDuo

The Live wall by touch. Open the Live TV tab, headed Live now (“Your channels as they last looked · Tap to watch, hold for more”).

  • The wall: one lead tile and two columns of saved pictures, each with an age or LIVE pill. Hold the lead for Watch, Add to Multi-View or Open Guide. Hold a tile for Add to Multi-View or Favorites.
  • Rows below: Your teams, live; Jump back in (hold for Start From Beginning or Remove); PICKED FOR YOU (Refresh picks / Enable Merlin picks); Your channels with All channels; and ON NOW ACROSS YOUR LINEUP.
  • On an open Duo: Live TV puts your live channels beside the one you pick, playing, with Watch on and its Sound. Stood up like a laptop, the lower screen becomes a deck (Duo layouts).

LimitsNo Recordings row.

Wide Home on iPad and the open Duo

iPadDuo

A two-column Home Hub when the screen is wide enough (a window 800 points wide or more).

How it works

The clock and weather sit at the left and the week at the right. The Watching card puts its words on the left and its picture on the right. Below, the cards (radar, Continue from, Your teams today, cameras, climate, each room, Picked for you, On now) go into whichever column is shorter, so the columns stay balanced.

On an open Duo the two columns split exactly at the fold, with a 40-point gap. Folding the Duo returns to one column.

LimitsYour teams today, Picked for you and On now appear on the hub only in this wide layout.

Section 5

Sports

Today's scores and races, with every game matched to the channels you have. Follow your teams, hear about their big moments, play the best feed in one press, and keep the score on your iPhone's Lock Screen.

The Sports screen

Apple TViPad TV interfaceiPhoneiPadDuo

Scores for the day, with each game matched to your channels.

How to use it

Open Sports in the Apple TV sidebar, or the Sports tab on iPhone. With no teams chosen, Scores fills the screen. Once you follow teams, a Your teams page sits above Scores. A line at the top notes that Excalibur is not affiliated with any league or team.

The leagues are the NFL, college football, MLB, the NBA, the WNBA and the NHL, and in soccer MLS, the Premier League, the Champions League, La Liga, Serie A, the Bundesliga, Ligue 1, the Eredivisie, Primeira Liga, Liga MX and the Europa League. A soccer league is listed once one of its games is found in your channels, so a league your lineup doesn't carry stays off the page.

Scores on Apple TV

Apple TViPad TV interface

Game cards for each sport and league, with live games first.

Tools, top right
A sport menu, a day menu from 3 days back to 6 ahead (Yesterday, Today, Tomorrow, then dates), Refresh, Find a game, and Your teams while you follow none.
Sport menu
Choose a sport from the menu at the top right, beside the day menu. Both menus open as panels of their own, and the live preview keeps playing under them. Every sport is listed every day, with how many games are live or on that day, or No games. Racing and Horse racing are chosen here too; choosing Racing goes straight to the live race.
League rows
One row of cards for each league: live, then upcoming, then finished.
The chosen game
A picture (a LIVE PREVIEW of its best feed when the game is live), the box score and a status line. Baseball adds an at-bat row.
Card status
For example LIVE · 2ND 4:44, TONIGHT 7:20 PM, FINAL or CANCELED.
Card foot
“Finding it in your channels…” while matching; “<best feed> · N sources” once found; “on <network> · not found in your channels” when nothing matches; “aired on <network>” for finished games.

How to use it

  1. Move to a card. Focus alone chooses the game and fills the box above.
  2. Press Select on a live or upcoming card to reach Watch best feed, Sources N and Pick for Multi-View.
  3. Press Watch best feed. The player opens with the whole league row as its channel list: Up brings the channel panel, Left and Right walk the other games, and the panel's actions include Watch, Sources N, Add to Multi-View and Favorites.

How it works

Today's scores update every 30 seconds from a free public scoreboard, with no sign-in. Where your lineup carries a league's whip-around channel, a card for it leads that league's row on game days.

Racing

Apple TViPad TV interfaceiPhoneiPadDuo

Formula 1, IndyCar, NASCAR and dirt racing, each race with its laps, the leader while it runs and the winner once it ends.

How to use it

  • Apple TV: choose Racing from the sport menu at the top right. Watch best feed, Sources N and Pick for Multi-View work as they do for games.
  • iPhone, iPad and Duo: tap the Racing chip, then a race for Watch best feed and its FEEDS list.

How it works

Formula 1, IndyCar and NASCAR come from a free public racing scoreboard, like the day's scores. Dirt racing comes from your own lineup: event channels and listings that name a race.

Horse racing

Apple TViPad TV interfaceiPhoneiPadDuo

The day's races and big race days, and the 24/7 horse racing channels in your lineup.

How to use it

  • Apple TV: choose Horse racing from the sport menu at the top right.
  • iPhone, iPad and Duo: tap the Horse racing chip.
  • Choose a race to watch it on its best feed. A horse racing channel's card plays that channel at once.

How it works

Races are found in your own lineup, from listings and event channels that name them, so what you see depends on what your accounts carry. Each 24/7 horse racing channel gets one card, however many accounts and qualities carry it.

Watch best feed, and Sources

Apple TViPad TV interfaceiPhoneiPadDuo

One press plays the best channel showing the game. Sources lists every feed that carries it.

How to use it

Press Watch best feed. Or press Sources N: on Apple TV the game stays at the left with its score and clock, and the Sources panel at the right lists its feeds. When the game is on more than one broadcast, the panel lists the broadcasts: a team you follow first, marked Your team, then each team's own broadcast, the network's, alternate broadcasts, other languages, studio shows, the mobile view, radio calls, and Not labeled for feeds named for the game but not for whose broadcast they are. Each shows its best copy's quality and how many copies it has. Select plays a broadcast's best working copy (a radio call plays with the best picture), Right lists its copies, best first, and Left or Menu goes back.

Each copy shows the feed's name; why it was found (“In its listings”, “Named for this game”, “Your <network> station”, “Carries <network>”, or “Named for the <team>” for a radio feed); its quality, such as 1080p · 60 fps · 5.1; and badges such as Best feed, IN YOUR GUIDE, or LISTEN WITH THE PICTURE on radio rows. A copy that just failed or is off the air says “Not answering”. A game on one broadcast, a race and RedZone list their copies straight away. Select plays a feed and Menu closes the list. Best feed order… at the foot of the panel opens the same order as Settings › Video & Audio.

With more than one account switched on, each feed names its account, so the same channel on two accounts is easy to tell apart.

How it works

Feeds that failed during this visit, or are off the air or busy, are skipped. The rest are ordered like this:

  1. TV pictures before radio.
  2. Feeds whose listing shows the game. With Smoothest first, the default, anything measured below 50 frames a second goes last; then 4K comes first, then the game's own network, then HD before SD. With Sharpest first or Custom, the rows of your Best feed order decide, then the game's own network.
  3. Your own town's station.
  4. The general best-copy ranking.

Your team's own broadcast

Apple TViPad TV interface

For a team in Your teams, a game's first button plays that team's own broadcast, with its own announcers, from the copy that plays best.

How to use it

  • In Scores, choose the game. The first button reads Watch the <team> broadcast, with Watch best feed beside it. Select on the game's card goes there, and the card and the status line name the broadcast.
  • On Your teams, Watch plays the team's broadcast too, and the big card's tile reads BROADCAST.

How it works

Excalibur reads whose broadcast a feed is from the label your provider puts in its name, such as Home Feed, Road Feed, or a team's name before In-Arena or Feed. A network's feed, a mobile view, a studio show and a name with no label are nobody's team broadcast.

LimitsOnly where your provider labels a team's own feed. Without one, Watch best feed comes first.

How Excalibur finds a game in your channels

Apple TViPad TV interfaceiPhoneiPadDuo

The matching behind “Finding it in your channels…”

How it works

Where it looks: only your switched-on accounts. Adult channels are left out.

What counts as a match: a guide listing near the start time that names both teams; a radio feed named for a team; a channel whose own name names the game; or the game's network (any copy, or your local station of a broadcast network).

Team names: pro teams match by city or nickname, and European soccer clubs by their short names too, such as Bayern or PSG. College teams match by school only, because many colleges share nicknames. A match is rejected if the listing names a different sport.

Left out: channels marked for another country, paid streaming-service slots, free streaming channels unless they name the game, and any channel whose listing shows something else at game time.

LimitsA game that no channel lists or names shows “not found in your channels”.

Picking several games for Multi-View

Apple TViPad TV interfaceiPhoneiPadDuo

Choose several games in Scores and open them side by side.

How to use it

  1. Hold Select on a card for half a second, or press Pick for Multi-View. A numbered badge shows the order of your picks.
  2. Select more cards to add or remove them (“Select a game to add or remove it”).
  3. Press Watch N in Multi-View. Clear, or Menu, clears the picks.

On iPhone, iPad and Duo, touch and hold a game for about half a second. While games are picked, a tap picks another. Then press Watch N in Multi-View, or the X to clear the picks.

How it works

One or two games open in 2 up, three or four in 2 × 2, and five to eight in 4 × 2. The first pick gets window 1 and the sound. Each game gets a feed that suits the grid, and only one window plays 4K at a time (Multi-View limits). A game with no usable feed is left out, and the grid says “No channel carries …”

On Apple TV, a league's whip-around channel can go in Multi-View with the games: hold its card, press Pick for Multi-View above it, or select it while you are picking. On iPhone, iPad and Duo, if two picks are on the same channel, Multi-View says which game it left out.

LimitsUp to 8 games (“Multi-View shows 8 at most”). Finished games cannot be picked (“<away> at <home> is over”). An iPhone or a folded Duo shows two windows at a time (Multi-View on iPhone).

Find a game

Apple TViPad TV interface

Search your feeds for upcoming football games over the next seven days.

How to use it

  1. Open Find a game from Scores, or from the guide's search.
  2. Type a team or a matchup.
  3. Optional: switch on 4K candidates only.
  4. On a feed, choose Open channel now, or Favorite / Unfavorite.

LimitsCollege and pro football only. On iPhone, the Scores magnifier opens the general channel search instead.

Your teams

Apple TViPad TV interfaceiPhoneiPadDuo

A page for the teams you follow, with each one's next game, radio call and recording.

How to use it

  • Choose teams with Your teams in Scores, the gear (Choose your teams), or Add a team. On Apple TV the editor shows leagues on the left and teams on the right; Select toggles a team (a check means followed) and Done closes. On iPhone a Your teams sheet opens. Every team in each league is listed, playing this week or not, and college football lists every Division I school. A soccer club you follow in its league brings its Champions League and Europa League games too. Search all teams finds a team, a school or a city.
  • Team pills: up to 8, each in the team's colors with its nickname, ordered by soonest game. A radio icon means you saved a radio sync for its call. More teams show as N more.
  • Select a pill: a live game plays (with the radio call, if it is ready); an upcoming game fills the big card; a team with no game this week opens the editor.
  • On Apple TV: Right moves from team to team, and holding Select on a team opens its next game. The page says so: “Hold to select team”.
  • The big card shows a status (“Your radio call is ready.”, “Finding the radio call…”, “Not found in your channels.” or “No radio call in your lineup for this game.”), tiles for BEST FEED, RADIO SYNC and NEXT, and buttons: Watch with the radio and Watch with TV sound, or Watch, or Look again. On Apple TV it also has Save every game.
  • Coming up lists your teams' games over the next several days.

How it works

The first time, your teams are filled in from Merlin's What you follow, for teams that play this week. Scores refresh every 30 seconds. Your teams also appear in Live TV's Your teams, live, in Your teams today on the wide iPad and Duo Home, and under Teams in the Library. They follow you through iCloud between your Apple TVs, iPhone and iPad: choose them once, and a team you remove on one device goes from the others too.

Never Miss a Moment

Apple TViPad TV interfaceiPhoneiPadDuo

When one of your teams scores, a game reaches its final minutes, or a game starts, Excalibur says so over whatever is on.

How to use it

  • Apple TV, in the player: press Select to switch to the game. Any other press lets it go.
  • Apple TV, anywhere else: a notice at the top right. Press Play/Pause to watch.
  • iPhone, iPad and Duo: a banner over every screen, the player and Multi-View included. Watch switches to the game.
  • To turn it off: Settings › Playback › Never Miss a Moment (On by default, set on each device).

How it works

Only your teams count, and never a game you can already see on any screen, so a score never shows up before the picture does. Streams run about a minute behind the scoreboard. Each notice stays up for 12 seconds.

LimitsNeeds teams chosen in Your teams. On iPhone, iPad and Duo, Settings › Playback › Moment notifications (Off by default) sends moments as notifications while Excalibur plays out of sight, in Picture in Picture or with the radio. Once Excalibur is closed, none come.

Sports on iPhone, iPad and Duo

iPhoneiPadDuo

Your teams, then Scores, on one page.

How to use it

  • The Scores tools: a day picker (3 days back to 6 ahead), sport chips (Racing and Horse racing among them) and a magnifier.
  • Tap a game to open a sheet, or a side panel on wide screens, with the line score, Watch best feed, a FEEDS list marked Best feed and Listen with the picture, Best feed order… under the feeds, Open in Multi-View (one game) and Done.
  • Finished games show “Aired on …”
  • Wide screens (an open Duo, a phone on its side, an iPad) use two columns.
  • A game or race with nothing left to play says “Off the air” instead of offering a Watch button that does nothing. A copy that is only busy is never called off the air.

NoteTouch and hold a game to pick several for Multi-View (Picking several games).

Live Activity: the score on your Lock Screen

iPhoneDuo

A live scoreboard on the Lock Screen and in the Dynamic Island.

How to use it

Watch a game from Sports or Scores with Watch, Watch best feed, a feed row, or a radio-call button. The Live Activity starts by itself.

  • It shows the league, team marks in team colors, and the score with the leader in bold.
  • Below: the status (for example ● LIVE · 2ND 4:44 or FINAL), a line about the last play, and Updated h:mm.
  • The Dynamic Island has compact, minimal and expanded layouts. On a Duo, each team sits over its score.

How it works

The score refreshes every 30 seconds while Excalibur is running, including while it plays in the background. After 90 seconds without an update the card offers Refresh the score. It ends 30 minutes after the final.

LimitsOne game at a time, with no sound. Open in Multi-View does not start one. To turn Live Activities off, use the iPhone's own Live Activities setting. iPads do not show Live Activities.

Section 6

Multi-View

Several channels at once: up to 8 windows on Apple TV and in the iPad TV interface, 2 on iPhone, and more on an iPad or an open Duo.

Multi-View on Apple TV

Apple TViPad TV interface

Up to 8 channels on screen together.

Ways in
The Multi-View sidebar item; the player's Multi-View button or Add to Multi-View in the Live TV panel; the guide's Multiview; Live TV's hold menu; the Hub's Multi-View button; Merlin (Build with Merlin, or a search answer's Several in Multi-View); Siri (“Open Multi-View”); and picks from Scores.
Layouts
2 up (2 windows), 2 × 2 (4), 1 + 3 (one large window and three small) and 4 × 2 (8).
Select
On a window, fills the screen with it and moves the sound there (“OK or Back returns to Multi-View”).
Hold Select
On a window: Change channel, Listen to this, Window layout… (with a diagram of each layout), Volume (Mute, 25%, 50%, 75%, 100%), Follow the guide again, Close window (leaves an empty square) and Remove window (the grid shrinks to fit). On a closed window: Choose a channel, Window layout… and Remove window.
Play/Pause
Moves the sound (Multi-View sound).
The channel picker
Choose a channel · Window N. Its search finds a game by either team's name or nickname, a show on now, or a channel; anything else goes to Merlin, right there. HomeKit cameras are listed first.
The look
A game's window wears both teams' colors with a live scoreboard, and the screen behind glows with the window you are hearing.

How it works

A new grid fills with the channel you were watching plus its neighbors in the lineup, skipping extra 4K channels and channels known to be off the air. Saved Sets keep their own layout. A window that keeps freezing while the others play moves to a steadier copy of the same channel, and says so.

Sets, Add channel and Build with Merlin

Apple TViPad TV interface

The tools in the Multi-View header. The header shows when the grid opens; Up from a top-row window brings it back.

SETS
Grids you saved for this account. Hold Select on one to Remove it.
Save as Set
Saves the current grid, with its layout.
Build with Merlin
“Name the things you want side by side and Merlin fills the tiles.”
Add channel
Fills a closed window first, otherwise adds a window.

LimitsWith all 8 windows in use: “The grid is full. Hold Select on a window to change its channel.” A channel you choose for a window stays there until Follow the guide again.

Multi-View sound

Apple TViPad TV interface

Which window you hear.

How it works

Play/Pause moves the sound: to the full-screen window if there is one, otherwise to the focused window, otherwise to the next window.

Settings › Multi-View › Background audio is On by default: the selected window plays at full volume and the others at 18%. Off plays only the selected window.

NoteOn iPhone, iPad and Duo each window has its own volume (Multi-View on iPhone).

Ghost Screen

Apple TViPad TV interfaceDuo

The window you hear fills the screen while a see-through second channel floats in a corner.

How to use it

  • Apple TV: in Multi-View, choose Ghost, or hold Select on a window and choose Float over the sound. Select swaps the two, a swipe moves the floating one to another corner, and holding Select opens See-through, Size, Corner, Swap screens and Back to Multi-View.
  • Duo, opened flat: in Multi-View, tap Ghost. Drag the floating picture to a corner, tap a channel in the row to float it, and use Transparency, Size, Position, Swap screens and Restore.

How it works

The floating picture can be 20 to 80% see-through, in three sizes, in any corner. Swapping keeps both pictures playing.

LimitsOn Apple TV, Ghost needs at least two windows. On the Duo, folding it or standing it half open closes Ghost Screen.

Multi-View limits: 4K and connections

Apple TViPad TV interfaceiPhoneiPadDuo

The rules that keep the grid within your provider's limits.

How it works

4K: only one 4K window plays at a time. A second one shows “4K needs a screen to itself. Choose an HD channel for this tile”. Where your provider offers several sizes of a channel, each window takes the largest that suits it: 1080p in 2 up, 720p in the four-window layouts, SD in 4 × 2.

Connections: each login allows its stated number of streams, and streams open on your other devices count against it (they report through iCloud every minute). The whole grid is planned at once, so a window can move to another account's copy of the channel, or to another account's feed of the same game. When nothing fits: “Waiting for a connection. <account> allows N stream(s) at once and M are in use somewhere else.” A recording's connection is never taken.

Start-up: each window builds a 3-second reserve before its first frame, and windows on the same provider start 2 seconds apart.

On Apple TV, Settings › Multi-View › Concurrent streams shows how many windows are open.

Multi-View on iPhone, iPad and Duo

iPhoneiPadDuo

Multi-View by touch.

Ways in
On iPhone, the Multi-View tab (an Open Multi-View page); the player's Multi-View button; the Home card's Multi-View; Live TV's hold menu; a game's Open in Multi-View; or games picked in Scores.
Windows
iPhone or folded Duo: 2 windows, side by side when wide and stacked when tall. iPad or open Duo: 2 up, 2 × 2 and 1 + 3, plus 4 × 2 at 1000 points wide or more.
Each window
Volume or mute, a headphones button (Listen to … only), and remove (X). An empty window offers Choose a channel, favorites first. Its search finds a game by either team, a show on now or a channel, your own area's channels first, and asks Merlin about anything else. A window that stops shows a Play button to start it again, and one that failed offers Pick another.
Top bar
Close, the layout choices, Clear all tiles, and a used/limit count for each account with something playing. Close leaves you where you opened Multi-View: its tab, or More's list. The footer says what you are hearing, or “Everything is muted.”
Next time
Open Multi-View again and the windows you closed with come back in their places, with the sound where you left it. Closing still lets go of every stream. Each window counts against its account's stream limit, as on Apple TV, and opening Multi-View stops the main player first, so a stream is never open twice.

LimitsNo Build with Merlin and no Multi-View settings on these devices. Saved sets, Freeform Studio and Ghost Screen need the Duo opened flat (Duo layouts).

Section 7

Radio with the picture

Watch a game's TV picture with a radio broadcast's call as the sound. Excalibur lines the two up, by hand or by itself.

Radio with the picture

Apple TViPad TV interfaceiPhoneiPadDuo

The game's TV picture, with the home or away radio call as the sound.

How to use it

  • Apple TV player: press Audio. Under RADIO WITH THE PICTURE, choose Home radio call or Away radio call. The TV sound goes off and Radio sync opens. While a call plays, a chip with its name and offset shows when the controls are up, and the Audio panel shows Radio sync ±X.X s to reopen the sync.
  • From Sports: Sources rows marked LISTEN WITH THE PICTURE, or Your teams' Watch with the radio.
  • iPhone, iPad and Duo: the player's Radio call button, the Audio sheet's RADIO CALLS, Scores' Listen with the picture, or Your teams' Watch with the radio. A radio chip at the top of the player opens the sync.
  • Back to TV sound: choose TV sound.

How it works

Radio calls are found when Sports matches the game: a feed whose name says radio and names a team. For college football, each school's own station's call is offered too, for both teams and for over 80 schools, from the station's own internet stream. Calls are remembered across restarts and offered from an hour before the start to four hours after. The radio plays as a second, sound-only stream.

Limits

  • A second stream is needed. On a one-stream account: “Your provider plays one stream at a time, and the picture is using it. The radio call needs a second stream, so it cannot play with this picture.” When no stream is free: “No connection is free for the radio right now. Try again in a minute or two.”
  • Changing channel ends the call. If it fails: “The radio did not start. The TV sound is back.”
  • On iPhone the button is dimmed when there is no call: “This channel has no radio call for its game”.

Lining up the call by hand

Apple TViPad TV interfaceiPhoneiPadDuo

Radio and TV rarely arrive at the same moment. Radio sync lines them up.

How to use it

  • Apple TV: the RADIO SYNC panel sits low over the picture. Left holds the radio back and Right holds the picture back, half a second per press, up to 60 seconds either way. The hint reads “Left and Right line up the call with the play · Select when done”. Select or Menu closes the panel, and it closes itself after 10 seconds untouched.
  • iPhone, iPad and Duo: the RADIO SYNC bar. − and + move half a second; dragging the track moves up to 30 seconds either way. Done closes it.

How it works

One side pauses for the difference while its buffer keeps filling, so nothing is skipped or reopened. The panel explains the state: “Radio held back X seconds behind the picture”, “Picture held back X seconds behind the radio”, or “Radio and picture as they arrive”.

Automatic radio sync

Apple TViPad TV interfaceiPhoneiPadDuo

Excalibur lines up the call by itself, usually within two to four minutes of play, to a tenth of a second.

How to use it

Leave Settings › Video & Audio › Automatic radio sync On (the default) and start a radio call.

How it works

Every 15 seconds, the app compares sounds both broadcasts carry, such as horns, whistles and buzzers, over a 60-second window. It trusts a result only when three matches in a row agree within a tenth of a second, and moves the sync only for a change of 0.4 seconds or more.

When a call starts, a notice at the top reads “Lining up the radio” for six seconds. In Radio sync, the panel shows “Automatic sync is listening for sounds heard on both”, then “Synced automatically to +X.X s by sounds heard on both”. When it moves the call, a notice says how far: “Picture held X.X s so the call catches up” or “Radio held X.X s so it matches the picture”. If the two already match, a short notice says “The radio and the picture already match”.

Your presses win. Once you press Left or Right, automatic sync stops for that call: “Automatic sync is off for this call: you set it”. It also waits while Excalibur is off the screen, so the call is not moved while you are away. Automatic radio sync is patent pending.

LimitsIf it cannot hear the picture, it says so on screen: “Automatic sync cannot hear this picture. Left and Right still line it up.” When one of the picture's soundtracks is silent, it listens to the next. If none has any sound for 30 seconds, a notice reads “Can't line up the radio” with “This feed has no sound to match · set the sync by hand, or choose another feed”, and it keeps listening. Lining up by hand works at any time.

Stadium surround

Apple TV

While a game's radio call plays, the TV broadcast's crowd plays quietly in your rear speakers, lined up with the picture: the call up front, the stadium around you.

How to use it

  • Settings › Video & Audio › Stadium surround, On by default.
  • Rear speakers level, shown while it is On, sets how loud the crowd plays: Standard by default, up to 12 dB quieter or louder in 2 dB steps.
  • Test rear speakers plays a rushing sound in the left rear speaker, then the right, so you can check your sound system plays them.
  • In the player, open Audio while a radio call plays. Stadium surround is under Radio sync and changes at once, there and in Settings.

How it works

The crowd comes from the TV broadcast's own sound, with the announcers kept out. On a 5.1 broadcast, the crowd behind you is fuller.

LimitsNeeds a 5.1 sound system and Automatic radio sync. Apple TV only.

Sync memory and reconnects

Apple TViPad TV interfaceiPhoneiPadDuo

What Excalibur remembers about a sync.

How it works

The sync you set is kept for that game only: the same call with the same picture, for 4 hours. Another broadcast or another game starts from zero. If the radio drops, it rides out up to 45 seconds of silence before reconnecting, and a reconnect does not knock the sync off.

Section 8

Recording

Record single programs, follow whole shows, save every game of a team, and keep recordings in your iCloud so any of your Apple TVs can play them.

Where recording works

Apple TViPad TV interfaceMac
Apple TV
Records while Excalibur is open. tvOS cannot wake the app to record, so Stay on to record keeps it open for you.
iPad
Records in the TV interface and keeps recordings on the iPad. iCloud storage for recordings is not used there.
iPhone and Duo
No recording and no Library.
Mac
Excalibur Recorder records for you while your Apple TV is off or the app is closed.

LimitsEach device records one program at a time. Recording a channel you are not watching uses an extra connection to your provider.

Record a program

Apple TViPad TV interface

Save one program.

How to use it

  1. In the Prism guide, hold Select on a listing to open the action strip.
  2. Press the record button. Its label follows the state: Record, Record from the start, Schedule recording, Cancel recording, Skip this one (an airing of a followed show), Stop & Save / Saving…

Other ways in: Record in the Details panel; Record in the player, which starts at once and opens the Recordings panel; and Record on AI Search's COMING UP cards.

How it works

Listings that will record get a red outline and dot. Programs record until 2 minutes past their listed end. A note under the action strip says where the recording will happen: “Records only if Excalibur is open on an Apple TV at <time>.” or, with a Mac recorder, “Records <time> on <Mac> and saves to your iCloud.”

Record from the start, and Save what has played

Apple TViPad TV interface
Record from the start
Offered for a program on now that began more than a minute ago, when this Apple TV has been on the channel since it began. It keeps what the Live buffer already holds.
Save what has played
In the action strip's More. Keeps what the Live buffer holds for the station you are playing.

LimitsBoth need the Live buffer turned on.

Follow a show

Apple TViPad TV interface

New episodes of a show record by themselves.

How to use it

  1. Press Follow on the action strip. It becomes Following.
  2. Optional: on the show's Library page, Keeps the last N / Keeps all cycles through 5, 10, all and 3, and New episodes / Every airing chooses which airings record.

How it works

By default a followed show records new episodes only and keeps the last 5. Plans look 36 hours ahead. Merlin may suggest a show you keep watching.

LimitsNeeds listings for the show. What you follow in Merlin's settings is for recommendations and does not record.

Save every game

Apple TViPad TV interface

Record every game of a team you follow.

How to use it

Press Save every game on the Your teams card, or in Library › Teams. It becomes Saving every game.

How it works

A game records until the score says Final, plus 2 minutes, for at most 4 hours.

Limits“Each game saves only if Excalibur is open on an Apple TV when it starts”, unless a Mac recorder is running.

Library

Apple TViPad TV interface

Your recordings, followed shows, teams, and tonight's plan.

How to use it

Open it from the guide's Library pill, Settings › Playback › Library, Live TV's Recordings › Library, the Hub's Recordings card, or search.

Shows
Up Next and Following, with REC and N NEW badges. A show's page has Resume / Play and Episodes.
Teams
Your teams' saved games.
Tonight · N
What records tonight, with Stay on tonight, and Cancel or Skip this one on each row.
All recordings
A storage line (“<size> in your iCloud · N recordings”, and how much an hour of recording takes), an iCloud storage switch, Storage, and Delete.

How it works

A recording kept only in iCloud plays while it downloads (“Downloading from iCloud… N%”). Its timeline shows the whole length from the start, with the part that is ready shaded and “<time> ready, the rest coming from iCloud” under the title. Recordings made on a Mac read FROM <MAC> or “Recorded on <device>”.

CarefulDelete acts at once and also removes the recording from iCloud, so it is gone from every Apple TV.

The Recordings panel and storage limit

Apple TViPad TV interface

A panel for the recording in progress and the space on this device.

How to use it

It opens from the player's Record, or the guide's More › Recordings. It has Stop & Save, Done, and Storage limit: 1, 2 (the default), 4 or 8 GB.

How it works

On Apple TV, recordings waiting on the device sit in its cache (“Apple TV may clear saved videos when it needs space.”). With iCloud storage off, reaching the limit stops recording: “Recording storage is full…”

Store recordings in iCloud

Apple TVMac

Recordings live in your private iCloud instead of on the device, and play on any of your Apple TVs.

How to use it

Settings › Playback › Store recordings in iCloud, On by default. The same switch is in Library › All recordings.

How it works

Each recording uploads in parts. The copy on the device is deleted once iCloud has it, except recordings played in the last 24 hours. Recordings count against your iCloud storage plan. When iCloud is full, the Library shows “Your iCloud is full”, and waiting uploads try again after you delete something.

LimitsOn Apple TV, uploads run only while Excalibur is open.

Stay on to record

Apple TViPad TV interface

Keeps Excalibur open so tonight's recordings happen.

How to use it

Settings › Playback › Stay on to record, On by default.

How it works

After 8 minutes without a press, while a recording runs or one is due within the hour, a dim clock screen appears with tonight's timeline and “Press any button to come back.” The screen saver is held off while it shows.

LimitsIt does not appear while a Mac recorder is running.

Excalibur Recorder for Mac

Apple TVMac

A separate menu-bar app for a Mac running macOS 26. It records for your Apple TVs and saves to your iCloud, so your shows record even when no Apple TV has Excalibur open. It is installed separately; it is not part of the App Store app.

How to use it

  1. Install Excalibur Recorder on a Mac signed in to the same Apple Account as your Apple TVs.
  2. Open Excalibur on an Apple TV now and then. Each time, it shares the recording plan.
  3. Check the menu-bar window. It shows Recording <title> with Stop and save, Next: … and Coming up (up to 6), an iCloud status line, “Plan from <Apple TV>, N min ago” (or “Waiting for an Apple TV to share the plan. Open Excalibur on one.”), Open at login and Quit Excalibur Recorder.

How it works

The plan travels through iCloud, so the Mac needs no pairing and does not have to be on the same network.

What it records: shows you follow, games you save, and single programs. A recording of the channel an Apple TV is playing, and Record from the start, stay on that Apple TV, because one login cannot play the same channel on two devices.

Timing: recordings start a minute early and run 2 minutes late. Games run to the final plus 2 minutes, at most 4 hours. If the stream drops, the recorder reconnects and carries on in the same recording, marking any gap.

Files: each recording uploads to your iCloud and the Mac's copy is then deleted. Your Apple TVs play them from iCloud.

Protected connection: while the Mac records a copy, no other device takes that login's copy of the channel. The player says “This channel is being recorded on that account, and no other account's copy is free.”

Limits

  • “Records only while this Mac is awake and on the network.” Closing a laptop's lid stops it. The Mac stays awake while recording, or when a recording is due within 10 minutes.
  • One recording at a time. Encrypted streams cannot be recorded.
  • Space on the Mac is capped at 60 GB, or its free space minus 4 GB. When iCloud is full: “Recordings wait on this Mac until there's room.”

Break marks and Skip break

Apple TViPad TV interface

Commercial breaks in a recording are found after it finishes.

How to use it

While playing a recording, press Skip break · m:ss.

How it works

Breaks are marked automatically once a recording finishes (“N breaks marked”).

Heat strip: where the action is

Apple TViPad TV interface

A recording's timeline drawn as a heat strip of 240 segments: red where the most is happening, then orange and gold, down to cream where it is quiet.

How to use it

Play a recording. The part already played is bright, and breaks are marked on top. While scrubbing, a magnifier above the thumb shows the picture plus six minutes of heat around it.

How it works

Apple's on-device video analysis scores the recording after it finishes, or about 10 seconds after an unscored recording starts playing. The scores are saved with the recording and travel with it in iCloud.

LimitsNeeds tvOS 27 or iPadOS 27. Recordings only, not live TV or films. Where the analysis is unavailable, no strip is drawn. There is no switch.

Section 9

Merlin

Merlin is Excalibur's assistant. It finds things to watch, answers questions in plain words, describes what is on screen, and picks channels for you.

How Merlin answers on each device

Apple TViPad TV interfaceiPhoneiPadDuo
Apple TV
Merlin answers through OpenAI, using your own OpenAI API key, billed to your OpenAI account. Requests go straight from the Apple TV to OpenAI; no Excalibur server is involved. Settings › General › Merlin says so: “Answers come from OpenAI, using the key you entered.”
iPhone, iPad, Duo and the iPad TV interface
Merlin uses Apple Intelligence on the device, with no key. It needs iOS or iPadOS 27 with Apple Intelligence turned on. Settings shows Apple Intelligence: On or Not available. When it is not available: “Turn on Apple Intelligence in the iPhone's Settings, under Apple Intelligence & Siri, for Merlin to answer here.”
Without Merlin
Search still finds names, picks fall back to your viewing history, and For You uses Excalibur's own ranking.

Setting up Merlin on Apple TV

Apple TV

How to use it

  1. Open Settings › Merlin › OpenAI API key. The sheet Add your OpenAI key explains how to create one at platform.openai.com. Once saved, only the key's last four characters are shown.
  2. Optional: Model lists the models your key can use (Show N dated builds reveals more). Until you choose, Merlin uses the least expensive model that answers well.
  3. Leave Personalized picks On (the default) for Picked for you.

Last request shows the latest status; pressing it asks again. What is sent to OpenAI explains what leaves the Apple TV (see What leaves the device).

Ask Merlin

Apple TViPad TV interface

Describe what you want, and Merlin turns it into a filter over your whole lineup.

How to use it

  • Open it with Ask Merlin in the Live TV lead tile's hold menu, Ask Merlin in your own words in AI Search, or Build with Merlin in Multi-View.
  • The prompt reads “What do you feel like?”, with the example “Show me sports channels in the USA”. Your last 10 phrases are listed (with Clear), along with suggested phrases.
  • From Multi-View: “Name the things you want side by side and Merlin fills the tiles.”

How it works

Merlin turns your words into a filter, and the filter runs on the device over your lineup. A phrase you have asked before reuses its earlier answer.

Describe what you want: the film finder

Apple TViPad TV interfaceiPhoneiPadDuo

Describe a film or series, and Merlin names titles. Excalibur then checks which of them your accounts carry.

How to use it

  • Apple TV: Describe what you want in Movies or Series.
  • iPhone: the sparkles button in Films or Series, or Settings › Merlin › Ask Merlin.

How it works

Results are split into N IN YOUR CATALOG and MERLIN ALSO NAMED, NOT IN YOUR ACCOUNTS. A plain title search runs alongside.

LimitsOn iPhone the results are a list to read. Play a title from Films or Series.

What's on? Merlin reads the screen

Apple TViPad TV interface

Merlin describes what is on screen right now: scoreboards, logos and captions.

How to use it

Press What's on? in the player's bar. The panel shows What's on, then “Reading the screen…”, then the answer. Menu closes it.

How it works

It sends one still frame, with the channel, program and region.

LimitsIt never identifies people. It needs Merlin.

Merlin describes channels with no listings

Apple TViPad TV interface

In the Live TV panel, a channel with no listing gets a one-line description read from its picture.

How it works

While it works the panel shows “Reading the picture…”, then the line, headed MERLIN, FROM THE PICTURE or MERLIN, FROM THE LAST PICTURE.

LimitsOn an Apple TV without a key: “Add your OpenAI key in Settings, under Merlin, and Merlin reads the picture here.” With no picture to read: “You can still watch this channel”.

Picked for you

Apple TViPad TV interfaceiPhoneiPadDuo

A row of programs Merlin picks for you.

How to use it

Look for PICKED FOR YOU on Live TV, and Picked for you on the wide iPad and Duo Home. Refresh picks asks again, and Enable Merlin picks turns them on. On Apple TV, the switch is Settings › Merlin › Personalized picks.

How it works

Picks come from your taste profile: genres, time of day, the sections you watch, and what is on now.

LimitsWithout Merlin the row falls back to your viewing history.

What you follow, What you like, and Forget what you watch

Apple TViPad TV interface
What you follow
In Settings › Merlin, or Live TV's Your interests. Type a sentence, then Find these. Matches are listed IN YOUR LINEUP and current follows under YOU FOLLOW, each with Remove. It feeds For You, Picked for you, and your first Your teams list.
What you like
In Settings › Home Hub or Settings › Merlin. The genre tiles from setup (N of 12). It feeds the Hub's For you and Merlin.
Forget what you watch
In Settings › Merlin. Clears your viewing profile.

Follow suggestions

Apple TViPad TV interface

Merlin notices a show you keep watching and offers to follow it.

How it works

A line appears under the guide's action strip: “Merlin: you've watched <show> on N days lately. Follow it?”

What leaves the device

Apple TViPad TV interfaceiPhoneiPadDuo
Apple TV
Requests go from the Apple TV to OpenAI, using your key. Picks send genre shares, time of day, lineup sections, and what is on the air now. For You also sends up to 20 channel names you watched recently, with how long ago, and what you follow. Ask Merlin sends your phrase and section tags. AI Search and the film finder send what you type or say. Labeling provider sections and choosing Channels on Home send names from your lineup. What's on? and the Live TV panel's descriptions send a still frame. Nothing adult is ever sent.
iPhone, iPad, Duo and the iPad TV interface
Apple Intelligence runs on the device, so Merlin's requests stay on it.
Section 10

Home control

Excalibur shows and controls the accessories in your Home app: lights, fans, thermostats, locks, plugs, HomePods, Apple TVs and cameras. It can also run a scene when you start or stop watching.

Connecting HomeKit

Apple TViPad TV interfaceiPhoneiPadDuo

How to use it

  • Apple TV: open Settings › HomeKit, or a home card on the Hub. The Home permission prompt appears the first time.
  • iPhone, iPad and Duo: press Connect HomeKit on the Home Hub.

How it works

If you turned permission down, the app explains how to allow it.

NoteThe HomeKit settings pane is on Apple TV and in the iPad TV interface.

Choose what the Home Hub shows

Apple TViPad TV interfaceiPhoneiPadDuo

Hide rooms, cameras, lights and other devices from Excalibur on one device. The Home app and your other devices don't change.

How to use it

  1. Open Settings › Home Hub › Show in Excalibur. Your rooms are listed with their cameras, lights, fans, plugs, speakers and locks, and your thermostats, each with a switch.
  2. Switch off what this device should not show. A room switched off takes everything in it along, its cameras too. On iPhone, iPad and Duo, Show this room switches a whole room.
  3. On Apple TV you can also hold a light, a camera or a thermostat on the Home Hub, then choose Hide <name> from the Home Hub, Hide all of <room> or Choose what the Home Hub shows…

How it works

Hidden things leave the Home Hub, the camera wall and Multi-View on that device only, and they are not synced. Ask for the PIN to show what is hidden uses the PIN for adult channels, set in Settings › Adult channels. It never unlocks adult channels.

Lights

Apple TViPad TV interfaceiPhoneiPadDuo

On the Hub's House section, room by room, with the lights you use most first.

  • Apple TV: click a light to open its panel. Left and Right change brightness by 10%. Turn on / Turn off, and Done. A light without a dimmer says “On. This light has no dimmer.”
  • iPhone, iPad and Duo: tap to switch a light on or off; touch and hold for a Brightness slider.

LimitsNo color or color-temperature control.

Fans

Apple TViPad TV interfaceiPhoneiPadDuo
  • Apple TV: Turn on / Turn off, speed with Left and Right, and Auto / Manual where the fan supports it.
  • iPhone, iPad and Duo: tap to switch on or off; touch and hold for a Speed slider.

LimitsNo direction control.

Thermostats

Apple TViPad TV interfaceiPhoneiPadDuo

The target temperature, with Lower and Raise. Find it on the Hub's Climate card, as Climate beside the clock (up to three thermostats), and on the iPhone Hub.

LimitsFahrenheit only. The heating or cooling mode is shown; change it in the Home app.

Plugs, HomePods and Apple TVs

Apple TViPad TV interfaceiPhoneiPadDuo
  • Plugs: a click or tap switches the power.
  • HomePods and Apple TVs: play or pause, where HomeKit allows it.
  • A device that does not answer reads Not responding.

Locks

Apple TViPad TV interfaceiPhoneiPadDuo

Your HomeKit door locks, in their rooms on the Hub.

  • Each lock reads Locked, Unlocked or Jammed.
  • A click or tap on an unlocked or jammed door locks it at once.
  • A locked door asks first: “Unlock <name>?”, with Unlock and Cancel.

Cameras and the camera wall

Apple TViPad TV interfaceiPhoneiPadDuo

Your HomeKit cameras, live or as stills.

How to use it

  • Apple TV: the Cameras sidebar item opens a wall. Click a camera for full screen; Menu goes back.
  • Settings: Settings › HomeKit › Cameras (On by default; Off hides cameras everywhere), and Live pictures on the camera wall: Live (the default) or Stills, refreshed every 10 seconds.
  • Elsewhere: a camera can fill a Multi-View window (cameras are listed first in the picker) or sit beside the clock.
  • iPhone, iPad and Duo: Cameras on the Hub, then All N › for a wall two across.

How it works

The wall uses 2 columns for up to 4 cameras and 3 above that, and scrolls. Up to 3 live streams start at a time. If HomeKit drops the streams twice in a row, the wall switches to stills, keeps the focused camera live, and says so on screen.

LimitsCameras have no player controls.

Scenes when you watch

Apple TViPad TV interface

Excalibur runs one of your HomeKit scenes when watching starts, stops, pauses or resumes. For example, lights down when a film starts and back up when it ends.

How to use it

In Settings › HomeKit, set When something starts, When it stops, When paused and When resumed to None or one of your scenes.

How it works

Make the scenes in Apple's Home app; Excalibur runs them. A Home automation can also run Excalibur's Shortcuts.

LimitsExcalibur cannot appear as a tile in the Home app. A scene that would unlock a door is not run from Excalibur: “Scenes that unlock doors must be run in the Home app.”

Section 11

Siri, widgets and Top Shelf

Ways to reach Excalibur from outside the app.

Siri and Shortcuts

Apple TViPad TV interfaceiPhoneiPadDuo

Six actions for Siri, the Shortcuts app and Home automations.

Watch a Channel
“Watch <channel> on Excalibur” (or Play, or Put). Siri replies “Playing <name>.”
What's On
“What's on Excalibur”, “What's on television on Excalibur”. Siri reads up to four shows from your favorites, without opening the app.
Open the Guide
“Open the guide in Excalibur”, “Show the Excalibur guide”.
Open Multi-View
“Open Multi-View in Excalibur” (or Show).
Open Films
“Open films in Excalibur” (or Show).
Keep Watching
“Keep watching on Excalibur”, “Resume Excalibur”.

How it works

Channel names are matched against your favorites, then your recent channels, then the whole lineup, ignoring accents and punctuation. The Shortcuts app suggests your top 12 channels. Adult channels are left out. Settings › HomeKit › Automations and Shortcuts lists these actions.

LimitsAll six actions are for Apple TV and the iPad TV interface. On iPhone, iPad and Duo, use What's On.

Top Shelf

Apple TV

When Excalibur sits in the top row of the Apple TV Home Screen, a carousel shows up to 4 Merlin's pick items (a title and a reason), then up to 8 of your recent channels with what is on now: 12 items at most.

How to use it

Select an item to open Excalibur straight to that channel. Resting on an item can play a short live clip.

How it works

Merlin's picks need a Merlin key and Personalized picks. Clear watch history clears the channel items.

LimitsAdult channels never appear. The live clip needs a suitable stream format and an account with more than one connection, and has no setting.

Last Channel widget

iPhoneiPadDuo

A Home Screen and Lock Screen widget for your last channel: “Plays the channel you were last watching, with what is on now.”

How to use it

Add it from the widget gallery: small, medium, large, or a rectangular Lock Screen widget. A tap opens Excalibur on Home's player, playing that channel. The adult PIN still applies.

  • Every size shows LAST WATCHED or FROM <DEVICE> (whichever device watched more recently), a recent still with a LIVE badge, the show, and the channel number and name.
  • Medium adds a countdown bar and Watch.
  • Large adds a rainbow ring that empties as the show runs, and tiles for CHANNEL, ENDS and NEXT.
  • Before you have watched anything, it reads Watch a channel.

How it works

It updates every minute for an hour, then every 5 minutes.

LimitsWidgets cannot play video themselves. It never shows adult channels or films. An iPad in the TV interface does not update it.

Section 12

Your devices

What each device can do, the iPad's TV interface, and how the foldable iPhone uses its fold.

Which device does what

Feature
Apple TV
iPad TV interface
iPhone
iPad
Duo
Mac
Accounts, iCloud sync, favorites
Yes
Yes
Yes
Yes
Yes
No
Prism guide
Yes
Yes
Touch version
Touch version
Touch, follows the fold
No
For You, Your guide, Categories, Go to channel
Yes
Yes
In the guide's More
In the guide's More
In the guide's More
No
Top 200, Sports pill, Recents
Yes
Yes
Yes
Yes
Yes
No
Home Hub and Live TV wall
Yes
Yes
Yes
Two columns when wide
Split at the fold
No
Calendar and Music cards
Yes
Yes
No
No
No
No
Pause and rewind live TV
Yes
Yes
Yes
Yes
Yes
No
From the beginning, Start Over replays
Yes
Yes
No
No
No
No
Films and series
Yes
Yes
Plays, no resume
Plays, no resume
Plays, no resume
No
Lower the sound in commercials
Yes
Yes
Yes
Yes
Yes
No
Commercial Escape
Yes
Yes
No
No
No
No
Scores and Your teams
Yes
Yes
Yes
Yes
Yes
No
Sources by broadcast, your team's broadcast first
Yes
Yes
No
No
No
No
Best feed order
Yes
Yes
Yes
Yes
Yes
No
Racing and horse racing
Yes
Yes
Yes
Yes
Yes
No
Never Miss a Moment
Yes
Yes
Yes
Yes
Yes
No
Pick several games, Find a game
Yes
Yes
Pick several
Pick several
Pick several
No
Multi-View
Up to 8
Up to 8
2 windows
Up to 8 when wide
2 folded, more open
No
Ghost Screen
Yes
Yes
No
No
Opened flat
No
Radio with the picture
Yes
Yes
Yes
Yes
Yes
No
Stadium surround
Yes
No
No
No
No
No
Recording, Library, Follow, Save every game
Yes
Yes
No
No
No
Records for your Apple TVs
Recordings in iCloud
Yes
No
No
No
No
Yes
Heat strip
Yes
Yes
No
No
No
No
Merlin answers with
OpenAI, your key
Apple Intelligence
Apple Intelligence
Apple Intelligence
Apple Intelligence
No
What's on? and picture descriptions
Yes
Yes
No
No
No
No
HomeKit lights, fans, locks, climate, cameras
Yes
Yes
Yes
Yes
Yes
No
Choose what the Home Hub shows
Yes
Yes
Yes
Yes
Yes
No
HomeKit scenes when you watch
Yes
Yes
No
No
No
No
Picture in Picture
In-app window
In-app window
System, plus background sound
System, plus background sound
System, plus background sound
No
Keep playing while browsing
Yes
No
No
No
No
No
Live Activity
No
No
Yes
No
Yes
No
Last Channel widget
No
No
Yes
Yes
Yes
No
Top Shelf
Yes
No
No
No
No
No
Siri and Shortcuts
All six actions
All six actions
What's On
What's On
What's On
No

The iPad TV interface

iPad TV interfaceiPad

The Apple TV's own screens on an iPad, used by touch. It is off by default; the iPad normally uses the iPhone-style interface.

How to use it

  1. In the iPad's Excalibur Settings, find iPad interface (it sits under About & Legal) and choose TV.
  2. Close Excalibur and open it again. The change takes effect at the next launch.
  3. To go back, open Settings › General › iPad interface, choose iPhone, and reopen the app.
Screen
The TV screens are scaled to the iPad, in landscape or upright. A section pill at the top left opens the TV sidebar.
Touch
A tap is the remote's click, and touch and hold is holding Select. A Back button, or a swipe in from the left edge, is Menu. In the player, a tap shows or hides the controls and swipes act as the arrows.
Keyboard
With a hardware keyboard, the arrow keys are the remote's arrows and the space bar is Play/Pause.
Merlin
Uses Apple Intelligence on the iPad.

LimitsPrism is the only guide. No system Picture in Picture, no background play and no Live Activity. The Last Channel widget does not update. Recordings stay on the iPad.

Duo layouts

Duo

On the foldable iPhone, Excalibur reads the fold and lays screens out around it. Reading the hinge needs iOS 27.1.

Open flat, upright
Home, the Guide, Search, Films, Series, Sports and a provider's rooms use the whole screen as one page. Half open, or held on its side like a book, they split at the fold.
Guide, open on its side
Splits exactly at the fold: the picture, title, Watch and description on the left half; the bar, search and grid on the right.
Guide, folded
The picture on top and the grid below.
Guide, half open
Standing on its fold, the picture fills the upper half and the grid the lower. Held like a book, it splits at the fold, as when open.
Home Hub
Open on its side or half open, two balanced columns split at the fold. Open flat and upright, one page across the whole screen. Folded, one column.
Live TV, open
Live TV and the tuner are one screen: your live channels sit beside the one you pick, playing, with Watch on, its Sound (TV sound or a radio call) and what is up next.
Live TV, like a laptop
Stand the Duo up like a laptop and the picture fills the upper screen. The lower screen becomes a deck: Back 10 Seconds, Play/Pause, Jump to Live, Add to Multi-View, Full Screen, and a strip of what is live to tap into the picture above.
Player
Folded and upright, the upright layout. Sideways, full screen, with the bar shrinking to fit. Half open, the picture on one side of the fold and a deck of controls on the other.
Multi-View, open
A builder with saved sets (Your sets, New, Layout and Channels, then Watch); Freeform, a studio where you move, resize, spotlight and save your windows (Save My Studio); and Ghost Screen. Sets are kept on the Duo.
Other screens
Multi-View has 2 windows folded and the iPad layouts open. Settings and Sports split into two columns when open, panels such as Game day fill the screen, and the tabs sit in a rail at the side: Home and the next four of your tabs, then More.

Requirements

  • Merlin on iPhone and iPad: iOS or iPadOS 27 with Apple Intelligence turned on.
  • Heat strip: tvOS 27 or iPadOS 27.
  • Duo fold layouts: iOS 27.1.
  • Excalibur Recorder: macOS 26.
  • Weather is shown in Fahrenheit. Radar and the National Weather Service fallback cover the US only.
Section 13

Settings reference

Every setting, where it lives, what it does and its default.

Apple TV
Settings is the sidebar's last item. The left column has Search settings and an Excalibur card, then the panes General, Home Hub, Playback, Video & Audio, Guide, Multi-View, Providers, Merlin, HomeKit and Adult channels. Pressing a row steps to its next value; rows with an up-down chevron open a menu; removals need a second press.
iPhone, iPad, Duo
More › Settings on iPhone, or the iPad sidebar. Sections: General, Home Hub, Tabs, Playback, Video & Audio, Guide, Providers, Merlin, Adult channels, and About & Legal. On screens 760 points wide or more, the list and the chosen section sit side by side.
iPad TV interface
The Apple TV Settings screen, by touch, with a two-line explanation under every row.

In the tables below, All means Apple TV, the iPad TV interface, iPhone, iPad and Duo.

General

Excalibur
All
Options
Your plan
Default
n/a

Shows your plan; opens the purchase screen

Restore Purchases
All
Options
Restore
Default
n/a

Restores a purchase on this Apple Account

iPad interface
iPad TV interfaceiPad
Options
iPhone / TV
Default
iPhone

Which interface the iPad opens with, from the next launch. In the standard iPad interface it sits under About & Legal

Version, This Apple TV / iPhone / iPad
All
Options
Read only
Default
n/a

Build and device

What's new in build N
All
Options
Read only
Default
n/a

This build's notes (under About & Legal on iPhone and iPad)

Privacy policy, Terms of Use
All
Options
Read only
Default
n/a

Apple TV shows a QR code; iPhone and iPad open the page

Contact and credits
All
Options
Read only
Default
n/a

Contact details, and credits for weather, Merlin, program listings, MPEG-2 decoding and trademarks

Tabs
iPhoneDuo
Options
Drag to reorder
Default
Standard order

Which tabs are on the bar, and in what order; its own section, after Home Hub

Home Hub

Open on
Apple TViPad TV interface
Options
Home Hub / Live TV / Guide
Default
Home Hub

The screen Excalibur opens on

Show in Excalibur
All
Options
A switch for each room, camera and device
Default
Everything shown

What the Home Hub, the camera wall and Multi-View show on this device

Calendar
Apple TViPad TV interface
Options
Not set / a calendar link
Default
Not set

Published calendar for the Hub's calendar card

Music on the hub
Apple TViPad TV interface
Options
Not allowed / On
Default
Not allowed

Shows what the Music app is playing

Preview sound
All
Options
On / Off
Default
Off

Sound on the Watching card and guide previews

What you like
Apple TViPad TV interface
Options
Choose / N of 12
Default
Not set

Genres for the Hub's For you and for Merlin

Hub layout
Apple TViPad TV interface
Options
Scrolling / At a glance
Default
Scrolling

The Hub's page style, per device

Beside the clock
Apple TViPad TV interface
Options
Radar / Climate / Cameras / Heart rate / Stocks
Default
Radar

The item beside the clock (Scrolling layout)

Rain, snow and leaves
All
Options
On / Off
Default
On

Weather or seasonal effect behind the Hub

Weather on the hub
Apple TViPad TV interface
Options
On / Off
Default
On

Weather and the week; asks for your location

Share heart rate
iPhoneiPadDuo
Options
On / Off
Default
Off

Sends your Apple Watch heart rate to your Apple TVs

Stocks
iPhoneiPadDuo
Options
A key and up to 6 symbols
Default
Not set

Stock quotes for your Apple TVs

Playback

Buffer profile
All
Options
Adaptive / Minimal 1s / Balanced 3s / Stable 8s / Deep 16s
Default
Adaptive

How much stream is held ahead of the picture

Shield
All
Options
On / Off
Default
Off

Optional reconnect helper for some .ts channels

Diagnostics
Apple TViPad TV interface
Options
Open
Default
n/a

Playback charts and channel checks

Keep playing while browsing
Apple TV
Options
On / Off
Default
On

Back from a live channel keeps it playing in a corner window

Play the channel behind Home
Apple TViPad TV interface
Options
On / Off
Default
On

Silent live picture on Live TV's lead tile

Continue watching across devices
All
Options
On / Off
Default
On

Shares your last channel and shows other devices' channels

Live buffer
All
Options
Off / 30 min / 1 to 6 hr
Default
Off

Pause and rewind live TV

Rewind window
All
Options
Read only
Default
n/a

How far back the current channel can go

Library
Apple TV
Options
Open
Default
n/a

Opens the Library

Store recordings in iCloud
Apple TV
Options
On / Off
Default
On

Recordings live in your iCloud

Stay on to record
Apple TViPad TV interface
Options
On / Off
Default
On

Shows the On watch tonight screen so recordings happen

Never Miss a Moment
All
Options
On / Off
Default
On

Your teams' scores, final minutes and starts, said over whatever is on

Moment notifications
iPhoneiPadDuo
Options
On / Off
Default
Off

Moments as notifications while Excalibur plays out of sight

Video & Audio

Maximum resolution
All
Options
Automatic / 4K / 1080p / 720p
Default
Automatic

Caps the resolution

Best feed order
All
Options
Smoothest first / Sharpest first / Custom
Default
Smoothest first

Which copy plays first when a channel or a game is on more than one feed

Keep HDR in menus
Apple TV
Options
On / Off
Default
Off

The TV stays in HDR after an HDR channel

Captions when muted
All
Options
On / Off
Default
Off

Captions while Audio is Muted

Audio
All
Options
On / Muted
Default
On

Mutes Excalibur while the app stays open; each launch starts On

Audio language
All
Options
Automatic / English / Spanish / French / German / Italian / Portuguese / Arabic
Default
Automatic

The soundtrack a channel starts with

Prefer 5.1 surround
All
Options
On / Off
Default
Off

A smooth 5.1 copy beats a sharper stereo one

Automatic radio sync
All
Options
On / Off
Default
On

Lines up radio calls by itself

Stadium surround
Apple TV
Options
On / Off
Default
On

The TV crowd in the rear speakers under a radio call

Rear speakers level
Apple TV
Options
−12 dB to +12 dB
Default
Standard

How loud the crowd plays; shown while Stadium surround is On

Test rear speakers
Apple TV
Options
Play
Default
n/a

A rushing sound in the left rear speaker, then the right

Commercials
All
Options
Full volume / Down 20 dB / Muted
Default
Full volume

Lowers the sound during breaks

Break detection
All
Options
Strict / Normal / Relaxed
Default
Normal

How sure detection must be

Commercial Escape
Apple TViPad TV interface
Options
On / Off
Default
Off

Offers your last channel during breaks

Back to the program
Apple TViPad TV interface
Options
Ask first / Automatically
Default
Ask first

Shown when Commercial Escape is On

Not in SettingsCaptions on or off is the player's own button. 5.1 only is inside the Watch on sheet. Match Content follows the Apple TV's own setting.

Guide

Channels on Home
Apple TViPad TV interface
Options
Status
Default
Not set up

Merlin picks local stations for Live TV

Show channels from
All
Options
Your country / All countries
Default
Your country

Country filter for the lineup

Your area
All
Options
Not set / a town
Default
Not set

Local stations first

Show channel numbers
Apple TViPad TV interface
Options
On / Off
Default
On

Numbers on rows and cards

Copies
All
Options
Grouped / All
Default
All

One row per station, or every copy

Channel names
All
Options
Clean / Full
Default
Clean

Removes provider tags from names

Preview while browsing
All
Options
On / Off
Default
On

Plays the highlighted channel

Multi-View

Default layout
Apple TViPad TV interface
Options
2 × 2 / 1 + 3 / 2 up / 4 × 2
Default
2 × 2

The layout new grids open in while the app stays open; each launch starts at 2 × 2

Background audio
Apple TViPad TV interface
Options
On / Off
Default
On

Other windows play at 18%

Concurrent streams
Apple TViPad TV interface
Options
Read only
Default
n/a

How many windows are open

Providers

Playlists
All
Options
Read only
Default
n/a

Channel count

Guide coverage
All
Options
N%
Default
n/a

Share of channels with listings; press to fetch again

Each account
All
Options
On / Off / Expired
Default
On

Opens the account's page

Synced through iCloud
All
Options
N accounts / N arriving
Default
n/a

Adopts accounts waiting in iCloud

Sync settings with iCloud
All
Options
On / Off
Default
On

Captions, audio, commercial skipping, radio sync, channel numbers, your guide, the Best feed order and each provider's stream format and numbering match on every device; playback engine, picture, buffer and recording settings stay with each device

Each added guide
Apple TViPad TV interface
Options
On / Off / Failed
Default
On

Extra guide, with Remove <guide>

Update channel list
Apple TViPad TV interface
Options
1h / 3h / 6h / 12h / Daily
Default
3h

How often playlists refresh

User agent
Apple TViPad TV interface
Options
Excalibur and 9 other names
Default
Excalibur

The name the app gives your provider

Refresh channel list
All
Options
Refresh
Default
n/a

Re-reads every playlist now

Add a guide
Apple TViPad TV interface
Options
Sheet
Default
n/a

Adds extra guides

Add a playlist
All
Options
Form
Default
n/a

Adds an account

Advanced › Remove all providers
All
Options
Confirm
Default
n/a

Removes every account here and in iCloud

An account's page

<account name>
All
Options
On / Off
Default
On

Switches the account on this device

Check <name>
All
Options
Press
Default
n/a

Expiry date and connections in use (Xtream Codes)

Make primary
All
Options
Press
Default
Not primary

Channels open on this account first (two or more accounts)

Channel guide
Apple TViPad TV interface
Options
Address / Use the provider's
Default
The provider's

A different guide for this account

Decoder for <name>
All
Options
Automatic / Native playback / AVFoundation
Default
Automatic

Which player decodes this account

Stream format for <name>
All
Options
Automatic / M3U8 / TS
Default
Automatic

Which stream format to ask for

Rewind on .ts for <name>
All
Options
On / Off
Default
Off

Lets .ts channels use the Live buffer

Name <name>
Apple TViPad TV interface
Options
Text
Default
n/a

A short name that travels to your devices

Remove <name>
All
Options
Press twice / confirm
Default
n/a

Removes the account everywhere

Merlin

What you follow
Apple TViPad TV interface
Options
Add / count
Default
None

Things you follow, for recommendations

OpenAI API key
Apple TV
Options
Set / Not set
Default
Not set

The key Merlin uses on Apple TV

Model
Apple TV
Options
Models your key can use
Default
Not chosen

Until chosen, the least expensive model that answers well

Personalized picks
Apple TViPad TV interface
Options
On / Off
Default
On

Turns on Picked for you and Top Shelf picks

Last request
Apple TV
Options
Status
Default
n/a

The latest answer's status; press to ask again

What is sent to OpenAI
Apple TV
Options
Read only
Default
n/a

About what leaves the Apple TV (see What leaves the device)

What you like
Apple TViPad TV interface
Options
Choose / N of 12
Default
Not set

Genres for Merlin and the Hub

Forget what you watch
Apple TViPad TV interface
Options
Press
Default
n/a

Clears your viewing profile

Apple Intelligence
iPhoneiPadDuo
Options
On / Not available
Default
Read only

Whether Merlin can answer on this device

Ask Merlin
iPhoneiPadDuo
Options
Open
Default
n/a

Opens the film finder

HomeKit

Live pictures on the camera wall
Apple TViPad TV interface
Options
Live / Stills
Default
Live

Live video, or stills every 10 seconds

Cameras
Apple TViPad TV interface
Options
On / Off
Default
On

Off hides cameras everywhere

What is playing, told to the system
Apple TViPad TV interface
Options
Read only
Default
Publishing

Lock Screen and Control Center details

Automations and Shortcuts
Apple TViPad TV interface
Options
Read only
Default
n/a

Lists the Siri and Shortcuts actions

Your home
Apple TViPad TV interface
Options
Read only
Default
n/a

How many scenes your home has

When something starts, When it stops, When paused, When resumed
Apple TViPad TV interface
Options
None / a scene
Default
None

Runs a scene when watching changes

Adult channels

Set a PIN / Change PIN
All
Options
4 or more digits
Default
Not set

The PIN that unlocks adult channels on this device

Show adult channels
All
Options
Locked / Unlocked
Default
Locked

Unlocks until the app closes; shown once a PIN exists

Remove the PIN
All
Options
Asks for the PIN
Default
n/a

Removes the PIN; adult channels hide again

Clear watch history
All
Options
Count / Empty
Default
n/a

Clears Continue watching and Top Shelf's channels

History
All
Options
Read only
Default
Excluded

Adult channels are kept out of history

Features with no setting

The heat strip, Picture in Picture and background play on iPhone and iPad, Live Activities (use the iPhone's own setting), the Top Shelf clip, radio with the picture (apart from Automatic radio sync and Stadium surround), Ghost Screen, the Duo layouts, and the screen-saver hold.