error_code_parsing_container_malformed — What It Means & How to Fix It

What Does This Error Mean?

This error means ExoPlayer could open the media file but could not read its contents. The file or stream is either corrupted, incomplete, or in a format the app does not fully support. This is more common with downloaded files and unusual stream formats than with mainstream services.

Affected Models

CloudStream 3
Plex Media Player (Android)
Kodi
VLC for Android
MX Player
Any Android app using ExoPlayer or Media3

Common Causes

The media file is corrupted — often from an incomplete download or bad storage
The file uses a container format that ExoPlayer does not fully support
An HLS or MPEG-TS live stream has missing keyframes or access unit delimiters
The file extension does not match the actual format inside
The stream was encoded with unusual settings not compatible with ExoPlayer

How to Fix It

Try reloading or refreshing the stream. Close it completely and open it again.

Live streams can occasionally send a bad segment. A fresh start usually skips past it.
If playing a local file, try opening it in a different app — such as VLC for Android.

VLC has its own media engine and supports more formats than ExoPlayer. If VLC plays it, the file is fine but ExoPlayer cannot handle that specific format.
If the file was downloaded, delete it and download it again.

A download that was interrupted or stored on a faulty SD card can produce a corrupted file that looks intact but fails to parse.
Check the file extension matches the actual format. A .mp4 file that is actually an .mkv will often fail to parse.

You can rename the file extension and try again, or use a tool like MediaInfo to check the real container format.
Update the app to the latest version. ExoPlayer adds support for new formats in every release.

An older version of ExoPlayer may not support a container format that was added in a recent update.

When to Call a Professional

This error is almost always fixable by trying a different file, player, or source. If the error appears on a specific file you own, try re-downloading or re-encoding it. If it happens on a paid streaming service, contact their support — the issue is on their end.

Frequently Asked Questions

Does this error mean the file is permanently broken?

Not always. Live streams can produce a bad segment that clears on its own. For local files, try re-downloading before assuming the file is permanently corrupted. If multiple players fail on the same file, it is likely corrupted beyond repair.

Why does the same file play on my computer but not on Android?

Desktop players like VLC or Windows Media Player support far more formats than Android apps. Android has stricter codec and container support, and ExoPlayer adds its own limitations on top. Using VLC for Android often bridges this gap — it uses the same engine as the desktop version.

Can this error appear on live streams, not just files?

Yes. Some live streams use MPEG-TS format without proper keyframe markers. ExoPlayer struggles to parse these streams and throws this error. Switching to a different stream source or app version often resolves it for live content.