error_code_parsing_container_unsupported — What It Means & How to Fix It

What Does This Error Mean?

This error means the video file uses a container format that ExoPlayer does not support on your device. Common unsupported containers include MKV, AVI, and some older formats. You need to either convert the file or use an app that supports more formats.

Affected Models

CloudStream 3
Plex Media Player (Android)
Kodi
TiviMate
IPTV Smarters Pro
VLC for Android
Any Android app using ExoPlayer or Media3

Common Causes

The video file is in MKV, AVI, WMV, or another format ExoPlayer does not support
The app was built with a limited version of ExoPlayer that excludes certain container parsers
The file has a .mp4 extension but is actually a different container format inside
The container uses an unusual or very new codec profile not yet supported
The file is a rare or proprietary container format not part of the ExoPlayer standard

How to Fix It

Try opening the file in VLC for Android. VLC supports a much wider range of container formats than most apps.

VLC uses its own media engine instead of ExoPlayer, so it can often play files that other apps cannot.
Check the file extension. Right-tap or long-press the file to see its full name and format.

If the file is .mkv, .avi, .wmv, or .flv, it is likely in an unsupported container. MP4 and WebM have the broadest support.
If you are using Kodi, install the correct codec add-on or use the built-in media player which handles more formats.

Kodi has add-ons that extend playback support. Check the Kodi settings for software decoding options.
Convert the file to MP4 using a free tool like HandBrake (available for Windows and Mac).

Converting to MP4 with H.264 video gives the widest compatibility across all Android apps and ExoPlayer versions.
Update the app to the latest version — newer ExoPlayer versions support more container formats.

Google regularly adds support for more formats in Media3. An outdated app may be missing newer container support.

When to Call a Professional

This is a compatibility issue between the file format and the app — not a hardware problem. No professional help is needed to resolve this. You just need a different app that supports the container format, or to convert the file.

Frequently Asked Questions

What is a container format and why does it matter?

A container is the wrapper that holds the video, audio, and subtitle tracks together in one file. Common containers are MP4, MKV, and AVI — they are like ZIP files for media. If the app cannot read the container, it cannot get to the video inside.

Does ExoPlayer support MKV files?

ExoPlayer has partial MKV support, but not all MKV files will play in all apps. Apps built on older ExoPlayer versions may reject MKV entirely. VLC for Android handles MKV most reliably if your preferred app cannot play it.

Will converting my file to MP4 reduce quality?

If you use a lossless or high-quality setting in HandBrake, quality loss is minimal. For normal viewing, most people cannot tell the difference. Use the H.264 codec with a high quality setting (RF 18-22) for best results.