Understand playback routes and JellyTV Engine
Learn how direct play, direct stream, remux, transcoding, HDR, Picture in Picture, and AirPlay work.
Last reviewed:
On this page
JellyTV negotiates playback with the active media server and automatically chooses Apple's native player, JellyTV Engine, an optional remux route, or server HLS. The result can change with the file, selected tracks, quality limit, device capability, and server permissions.
Understand the playback methods
- Direct Play uses the original media without server conversion.
- Direct Stream asks the server for a compatible stream while avoiding video transcoding when possible.
- Remux repackages compatible online media for Apple’s native player without re-encoding the video. Eligible HDR10+ and Dolby Vision Profile 7 sources can use automatic remux independently of this setting.
- Transcoding asks the server to produce compatible H.264 and AAC HLS when direct or local routes are unsuitable, a quality limit requires conversion, or another fallback is needed.
HDR and format compatibility
JellyTV Engine supports HDR10 and HLG, Dolby Vision base-layer fallback, multichannel and spatial audio, hardware-accelerated AV1 when available, optimized AV1 and VP9 software decoding, and embedded or image-based subtitles. Support varies by device, display, source profile, container, and selected route; not every HDR or Dolby Vision combination is guaranteed.
Picture in Picture and AirPlay
- On supported iPhone and iPad devices, use Picture in Picture from the player controls to continue playback outside JellyTV. Availability is checked for the current device and content.
- Choose an AirPlay destination from the player controls. JellyTV attempts native playback first and can request a compatible stream from Jellyfin when conversion is needed.
- AirPlay results depend on the receiver, container, codecs, selected audio and subtitle tracks, and server capabilities. Offline media that needs a server remux cannot use that route.
Automate episode playback
Open Profile, then Playback to enable Auto-skip intros or Auto-play next episode. You can use a compact Next Up control and choose how early the prompt appears when the server does not provide an outro marker. Intro skipping requires segment information from the server; JellyTV does not automatically skip credits.
Inspect the active route
Playback information can show the player, playback method, protocol, stream type, codec, resolution, bitrate, frame rate, dynamic range, selected audio, and original container. Use it when comparing titles or preparing a playback report.