Known Issues and Limitations

xbox-one

#1

Common Terms:
Direct Play - The entire file plays as is, nothing is changed.
Direct - The indicated stream is being directly copied by the transcoder.
Direct Stream - One or more streams are being directly copied.
Transcoding - The indicated stream needs to be converted to a compatible format.
App settings - The settings for the Xbox One app. These are located inside the app itself when you select your name from the top right.
(e)AC3 - Dolby Digital (AC3) or Dolby Digital Plus (eAC3)

Limitations:

  1. Image Based subtitles will cause a transcode as the subtitles need to be burned into the video stream. SRT subtitles will allow the app to display the subtitles as soft subtitles (No Transcoding)
  2. Audio channels are currently limited to a max of 6 channels. 7.1 Audio will trigger a transcode down to 5.1.
  3. Audio pass through is currently not supported. If the audio codec is not supported by the Xbox One for decoding it will trigger a transcode.
  4. H264 holding 4K video will cause issues. Anytime 4K HEVC needs to be transcoded it will transcode to 1080p H264.
  5. Using the Dolby Atmos app does not grant the Plex app access to decode Dolby Atmos streams. The audio codec still needs to be compatible with the Xbox One decoders. The only known Atmos stream that will currently direct play is (e)AC3 with Atmos position stream.
  6. The original Xbox One (non-S and X models) cannot direct stream HEVC. These streams will be transcoded if any other limitations is met.
  7. File starts direct playing and then switches to transcoding mid-stream. This is expected behavior and occurs when the app encounters an error with a file that is currently playing. Instead of rejecting the stream and displaying an error the app will first attempt to switch to a transcoded stream and continue playback.
  8. An Amplifier, home theater, or sound bar always displays the same format during playback. This is currently expected behavior. Because the app does not passthrough the output from the Xbox One will always be what is selected in the Xbox One system settings.

Known issues

Please note that these aren’t in any priority or meaningful order, but if they’re here we’re working on them.

  • Infinite Buffer Loop

    Symptom:
    The video pauses with a buffering circle in the center of the screen. The video never resumes and the buffering circle never goes away. This currently occurs with the HEVC video codec is direct streamed to the Xbox One. This is most noticeable in 4K HDR videos because of the HEVC encoding with audio formats not supported by the Xbox One

    Workarounds:

  1. Ensure the file is direct played - Allows HDR video
    This method involves disabling video based subtitles, ensuring always burn subtitles is disabled, and ensuring a compatible audio stream (such as AAC or (e)AC3) is the first audio track in the file and selected for playback. Selecting a secondary audio track will not workaround the issue.
  2. Force video transcoding - Strips HDR from video stream
    This method forces the video and audio streams to transcode. This method involves going into the application settings, selecing video, and unchecking allow direct stream.
  • Audio Cutting Out

    Symptom:
    During playback all audio stops while the video continues to play. This currently occurs when display mode switching is enabled.

    Workarounds:

  1. Uncheck allow display mode switching from the video options.
  • Xbox One X Forced Transcoding

    Symptom:
    During playback the video will initially start direct playing and then buffer and begin transcoding.

    There is currently no workaround for this issue. During troubleshooting transcoding is the proper action. It is still being investigated as to why the app is reporting direct play before the buffering and transcoding begin.

Possible Workaround
It is possible that a secondary audio stream is being incorrectly reported as the main audio stream. The app then attempts to play the secondary audio stream which causes the media player to crash. This will trigger the app to then fallback into transcoding. To try and workaround this verify that the 1st audio track is marked as the default audio track.

  • 3D Video

    Symptom:
    During playback the 3D HSBS (Half side-by-side) video only displays a single half of the video. This appears to be an internal function of the Xbox One and not a behavior that currently can be changed.
    What Should Happen:
    During playback the 3D HSBS image should display on screen with both the left and right fields. This will allow the user to switch their TV/display device into 3D mode to recreate the 3D image.

    There is no method for automatic TV mode switching through the Xbox One app, so manual TV mode switching is the current expected behavior.

Troubleshooting

When requesting support please follow these steps:

  1. Restart Server - This ensures a new clean log
  2. Enable logging to server from the app settings - This adds additional debugging information to server log
  3. Reproduce the issue
  4. Gather the Plex Media Server.log and attach to forum post

Enabling server logs: