Understand direct play and codec support
Direct play means Phyn can ask your device to play the media file without Jellyfin changing the video or audio stream first. It is usually the fastest and highest-quality playback path.
Codec support is not decided by Phyn alone. It depends on the media container, video codec, audio codec, subtitle format, selected tracks, operating system, device hardware, and Jellyfin server behavior.
Quick check: If one file will not play, test another file first. If other videos play normally, the issue may be specific to that media file, codec, subtitle track, or server transcode path.
What affects direct play
Direct play can depend on:
- The video codec, such as H.264, HEVC, AV1, or another format.
- The audio codec and selected audio track.
- The container, such as MP4, MKV, or WebM.
- Subtitle type and whether subtitles need to be burned in.
- Device support on iOS, Android, macOS, or Meta Quest.
- Jellyfin server settings and transcoding capability.
- Network speed between your device and server.
3D video on Meta Quest
Phyn supports immersive playback on Meta Quest with FSBS, HSBS, HTAB, and FTAB display formats. These describe how the two eye views are arranged; codec support still depends on the video file and headset.
You need a 3D source video. In the immersive controls, use Display → 3D format to choose a format. For side-by-side content, try FSBS and HSBS and use whichever produces the best picture, even if it differs from the filename's half/full label.
If a video does not direct play
If this happens, try this sequence:
- Confirm the item plays in Jellyfin Web.
- Try another video in Phyn.
- Lower playback quality and try again.
- Turn off unusual subtitle tracks and retry.
- View the media codec information for the item.
- Send the codec details to support if the item still fails.
When to contact support
Contact support when a file should play on your device but fails in Phyn after the checks above. Include the media codec information, your platform, whether Jellyfin Web can play it, and whether lowering quality changes the result.
Useful detail: Saying "this file is HEVC in MKV with EAC3 audio" helps support more than saying "the video does not play." Codec details make the issue much easier to reproduce.