for Apple TV

Direct play and server streams

Checked against version 0.1.0 · Updated

SpiteTV plays a file directly when the Apple TV can read it as is. Anything else goes through your Plex server, which copies what fits and converts the rest.

SpiteTV for Apple TV tries direct play first: the Apple TV reads the file from your Plex server as is. When the file's container, video, or audio is outside what the Apple TV plays, the app asks your Plex server for a stream instead. The server copies the parts that fit and converts the rest. You do not choose. There is no quality setting.

What direct plays

PartPlays directly
ContainerMP4, MOV, M4V
VideoH.264 (8-bit), or HEVC tagged hvc1 or dvh1
Dolby VisionProfiles 5 and 8
AudioAAC, AC-3, E-AC-3 (up to 6 channels), MP3, ALAC, FLAC

All parts must fit. An MP4 with H.264 video and DTS audio goes through the server, because DTS is not in the list.

What goes through the server

PartWhat happens
Other containers, such as MKV or AVIServer stream. Video and audio are copied when they fit.
H.264 at 10-bitServer stream.
HEVC with another tagServer stream.
Dolby Vision profile 7, or an unknown profileServer stream.
DTS and TrueHD audioAlways converted by the server.
E-AC-3 above 6 channelsServer stream.
Image subtitles (PGS, VobSub)Burned in by the server.
Over 20 Mbps on a remote connectionServer stream. See Remote access.
  1. The file
  2. Container check
  3. Video check
  4. Audio check
  5. Connection check
  6. Direct play or Server stream

Apple TV HD

The Apple TV HD has no HEVC decoder. On it, every HEVC file goes through a server stream, even one that would direct play on an Apple TV 4K.

Quality

Quality is automatic. On your home network a server stream runs at the file's original quality. On any other connection, including a Plex relay, it is capped by the remote ceiling. There is no setting to change this.

When a stream has trouble

The app recovers by itself, in this order:

  1. If direct play fails, it tries a server stream.
  2. If that fails, it tries a server stream capped at 1080p and 12 Mbps.
  3. If a stream ends early, it reloads at the same point, waiting 1, 2, then 4 seconds between tries.
  4. A file that is shorter than Plex says is noticed and skipped. It does not count as a failure.

Server streams in the guide

The guide preview plays only files that direct play. A file that needs a server stream shows Preview not available for this program in the preview window. It still plays full screen. See Preview not available.

On a server stream you cannot scrub back before the point where you joined.

Make more files direct play

Remux MKV files into MP4 with the same video and audio, and keep a stereo AAC or AC-3 track next to DTS or TrueHD. See your tools' own documentation. A file that plays directly puts less work on the server, and it can play in the guide preview.

If it does not work

  • "The Plex server is busy with other streams". The server hit its limit for converting. See Server busy.
  • "Playback failed". Every step above failed for that program. See Playback failed.
  • The server is slow on many channels. Many of your files need conversion. Check them against the first table.

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

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

Menu

Join the beta