Stream

Updated

Fix MKV and 4K NAS Video Playback on Android

If a video from your NAS won't play on your Android phone, try a small 720p or 1080p MP4 with H.264 video and AAC audio from the same folder. If that file plays, the share can serve at least one known-good video. You can then check whether the original file hit a Stream Pro limit, needs a decoder your phone lacks, or asks more of the network than the test file.

This guide covers direct playback from SMB and WebDAV in Stream for Android phones. Start with the SMB setup guide or WebDAV setup guide if Stream cannot list the NAS folder yet.

What the Playback Symptom Tells You

What you seeWhat to check first
The MKV plays for five minutes and Stream shows a preview-ended messageYou reached the free-format preview. Stream Pro is required to continue that playback.
A 4K MP4 shows a resolution limit or a Stream Pro promptCheck the video track's height. Full playback above the free resolution limit requires Stream Pro and a compatible decoder.
You hear sound but the picture stays black or the app shows a decoder errorCheck the video codec, profile, bit depth, resolution, and HDR format. Try the same file from local storage on the same phone.
The picture plays without soundOpen Audio in the player and try another track if available. Check the selected track's codec if the issue persists.
Subtitles are missingCheck whether the file includes the subtitle track you expect. Open the player's subtitle control to see the tracks Stream can select.
The video plays locally but buffers from the NASTest the same file over the main Wi-Fi network and check the NAS load. See the buffering guide for network checks.

Check the Container and the Tracks Inside It

MKV and MP4 are containers. They hold video, audio, and sometimes subtitles. Two MKV files can use different formats inside. An MKV with H.264 video and AAC audio may play on a phone that struggles with another MKV containing 10-bit HEVC and a different audio track.

In your file's media information, note the video codec (H.264/AVC or H.265/HEVC), resolution, profile or bit depth, HDR format, and audio codec. A 4K HEVC file may need a decoder that handles its particular profile and resolution. HDR playback also depends on the phone's display and Android support. Android media format reference · Android Media3 HDR playback

Changing the file extension leaves the tracks as they were. Moving tracks into a different container is called remuxing. If the phone cannot decode a track, use a compatible copy or re-encode that track with a separate tool.

Check Whether Stream Pro Is Required

On Android phones, compatible MP4 and M4V files up to 1080p play free without a time limit. Stream allows a small amount of padding, including 1080p encodes stored at 1088 pixels high. Full playback of MP4 and M4V above the free height limit requires Stream Pro.

Compatible MKV, MOV, AVI, FLV, and WebM files get a five-minute preview per playback. Try the specific file on your phone before subscribing. Stream Pro lifts the app's access limits. Decoding and HDR support still depend on the device and file. Stream Pro playback limits

Compare Local and NAS Playback on the Same Phone

  1. Play the small H.264/AAC MP4 from the same NAS folder. Check that playback starts and seeking works.
  2. Play the original file from that folder. Note whether you get a Stream Pro message, a decode error, missing sound or subtitles, or buffering.
  3. Copy the original file to a local folder and play it in Stream on the same phone. If it plays smoothly there, examine the connection or NAS load. If you see the same decoder error with the local copy, check the file's tracks or try a version encoded for the device.

For our SMB and WebDAV walkthroughs, Stream 1.1.12 on an Android 10 emulator scanned and played a 720p H.264/AAC MP4 from a read-only Samba share and a WebDAV endpoint. Use that format as a starting point, then test the MKV or 4K file you actually want to watch on your own phone.