for Apple TV

Playback failed

Checked against version 0.1.0 · Updated

One program would not play. SpiteTV shows the message for 3 seconds, then the channel moves on.

SpiteTV for Apple TV shows Playback failed when it cannot play the current program, even after its recovery steps. The message stays for 3 seconds, then the channel moves to its next program. You do not need to do anything. If it keeps happening, check the files on that channel.

The message

In a panel near the bottom of the picture:

"Playback failed"

Sometimes a short line of facts about the failure shows in its place.

Mock-up. Screen text from the app.

What the app tried first

Before it gives up on a program, SpiteTV tries:

  1. Direct play, the file as is.
  2. A server stream, where the server converts what the Apple TV cannot read.
  3. A server stream capped at 1080p and 12 Mbps.

A stream that ends early is reloaded at the same point. A file shorter than Plex says is skipped without counting as a failure.

What happens next

  • Breaks off: the next program starts at once, from its beginning. The channel then runs ahead of its schedule.
  • Breaks on (Premium): spots fill the failed program's time, in blocks of up to 15 minutes with 60-second "coming up next" cards. The next program starts on time.
  • After 5 failures in a row on one channel, the app stops and shows a card. See Channel not playing.

Common causes

  • The file is damaged or incomplete.
  • The file moved or was deleted, and Plex still lists it.
  • The server could not convert the file.
  • The network dropped during the program.

Fix

  1. Let the channel move on. One failure is not a problem.
  2. If you want that program, find it in Plex and check that it plays elsewhere.
  3. Check its format against Direct play and server streams.
  4. Have Plex scan the library again if files were moved. See Plex's own documentation.

If it does not work

  • Many programs fail. Check the server and the network. See No signal from your server.
  • The same program fails each time it airs. The file is the problem. Replace or fix it in Plex.
  • You want details. Settings > About > Diagnostics lists the recent playback events. See Diagnostics.

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

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

Menu

Join the beta