for Apple TV

Sync between Apple TVs

Checked against version 0.1.0 · Updated

Settings, favorites, and hidden channels travel between your Apple TVs through your own iCloud. Each TV can opt out.

SpiteTV for Apple TV syncs its settings between your Apple TVs through iCloud key-value storage in your own iCloud account. The app sends nothing to us. Sync is on by default, and you can turn it off on each Apple TV. Your Plex sign-in and the kids mode PIN never sync.

This page describes how sync is built to work.

What syncs

  • Packages, libraries you chose, theme, text size, CRT Effect, channel logo, guide preview, up next strip, mini channel strip.
  • Kids mode on or off.
  • Film series switches, commercial breaks and the break library, subtitle mode and language, audio language.
  • Favorites, hidden channels, generated channel numbers, and channel order. Each of these syncs entry by entry.

What never syncs

  • The Sync Between Apple TVs switch itself.
  • Your Plex sign-in and server. Each Apple TV links to Plex once.
  • The kids mode PIN.
  • The last channel you watched, the saved schedule, and the diagnostics log and its salt.

Turn sync off or on

  1. Open the sidebar and select Settings.
  2. Select Sync.
  3. Select Sync Between Apple TVs. Its help reads "Keeps these settings the same on all your Apple TVs."

With sync off, this TV reads nothing from iCloud and writes nothing to it.

Mock-up. Settings, as the app lays them out.

The Status row

StatusHelp line
OnSends your settings to your other Apple TVs.
OffKeeps your settings on this Apple TV only.
Not availableKeeps your settings here, since this build cannot sync.
Near the limitUses N KB of the 1,000 KB iCloud limit.
Over the limitKeeps changes here: N KB is over the 1,000 KB iCloud limit.

Apple limits this storage to 1,000 KB and 1,024 keys. The status changes to Near the limit from 800 KB. Over the limit, changes stay on this Apple TV and nothing is sent.

Sync runs through Apple's service, so there is no set time for a change to arrive on another Apple TV.

Add another Apple TV

  1. On the new Apple TV, sign in to the same iCloud account in the Apple TV's own settings.
  2. Install SpiteTV and open it.
  3. Select Link Plex and enter the code at plex.tv/link. See Sign in to Plex.
  4. Your theme, packages, favorites, hidden channels, and the other synced settings arrive by themselves. Only the channels that a synced setting changes are rebuilt.

To give the new Apple TV its own settings, turn off Sync Between Apple TVs on it before you change anything.

When two TVs disagree

The newest change wins, field by field. Favorites, hidden channels, numbers, and channel order merge entry by entry, so changes on two TVs both survive. A removal is remembered for 90 days. An Apple TV that was offline longer than that can bring a removed entry back.

Same settings, same schedule

Two Apple TVs show the same schedule when they read the same library, use the same settings that shape channels, and sit in the same time zone. Sync takes care of the settings. The schedule itself is never sent: each TV works it out on its own. The TVs do not need to be on the same network.

If it does not work

  • Status says "Not available". The Apple TV is not signed in to iCloud, or iCloud did not answer. Settings stay on this TV. Check the Apple TV's iCloud sign-in.
  • Status says "Over the limit". iCloud allows 1,000 KB. Changes stay on this TV. Unhide channels or reset the channel order to shrink what syncs.
  • A setting changed by itself. Another Apple TV changed it. Turn sync off on the TV that should keep its own.
  • The two TVs show different schedules. Check that both read the same libraries, and that both are in the same time zone.

Was something wrong? Email support and we fix the page.

SpiteTV for Apple TV is in beta. Join the beta.

Menu

Join the beta