Getting started

Why Jellyfin converts video, and how to avoid it

Jellyfin sends a title in one of three ways, from cheapest to dearest for your computer:

  1. Direct play: the file goes to the device as it is. Almost no work for the server.
  2. Direct stream: the device can play the picture but not the file's wrapper (for example an MKV in a browser) or not the sound. The server repackages the file and, if needed, converts only the sound. The picture is not touched, so the work is small.
  3. Converting (transcoding): the server re-draws the picture. This is the heavy one. It happens when the device can't decode the picture, can't show its HDR, the file is bigger than the quality limit, or subtitles are made of pictures and have to be burned in.

Seeing why. In Reelhost Signal, the player's information shows which of the three is used and the reason in plain words, for example the TV can't play Dolby Digital. In Jellyfin's own apps, open Playback Info. In Reelhost, Monitor explains each stream that converts and offers the matching fix.

What usually causes a needless conversion.

  • Antenna channels and recordings are often MPEG-2 video with Dolby Digital sound. A TV may play the picture but not the sound. Jellyfin 12.2 converts the whole picture in that case, although only the sound needs changing.
  • Picture subtitles (PGS, VobSub) are burned in, which converts the whole title. Text subtitles (SRT) do not.
  • HDR on a screen without HDR, a picture bigger than the device can decode, and the quality limit set in the app or on Jellyfin for streams away from home.
  • Interlaced video on devices that can't show it without conversion, and wrappers a device can't open.

What Reelhost does about it.

  • The Video speed fix puts conversions that can't be avoided on a graphics card that passed a test, and makes them pause when they're far ahead of the viewer.
  • TV-friendly copies give a title that keeps converting a version every device plays as it is.
  • The Reelhost Signal app is being changed to ask for the cheapest way first (direct play, then repackaging, then converting only the sound, and only then the picture), to repackage live channels at once for players that can't open a raw broadcast stream, and not to turn picture subtitles on by itself. If a way doesn't play on the device, Reelhost Signal moves one step down instead of showing an error. This was checked against a test Jellyfin 12.2 server and in automatic tests. It hasn't been checked on real TVs yet, so it is not available in the released apps.

What isn't covered. Reelhost doesn't add its own video decoders to Reelhost Signal, so a device still converts what its own hardware can't decode (for example DTS on many TVs, unless the receiver takes it as passthrough). Tone mapping (HDR to normal colour) is Jellyfin's setting and Reelhost doesn't change it.

Still stuck? Click Get help at the bottom of Reelhost's sidebar, or ask us in your account. All help topics.