error_code_decoding_failed — What It Means & How to Fix It

What Does This Error Mean?

The media decoder started successfully but crashed or produced errors while processing the video or audio. This can happen with corrupted files, buggy device firmware, or insufficient device memory. Clearing the app cache and restarting the device fixes this in most cases.

Affected Models

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

Common Causes

The media file is corrupted or has malformed data packets
The device ran out of memory during decoding
A firmware bug in the device's hardware decoder
The video bitrate spiked beyond what the decoder can handle
An incompatible combination of codec profile and device decoder

How to Fix It

Clear the app's cache: Settings > Apps > [App Name] > Storage > Clear Cache.

Stale cached data can cause the decoder to receive malformed input.
Close other apps running in the background to free up RAM.

Decoding video requires significant memory; freeing RAM reduces decoder crashes.
Restart your device and try playing again.

A reboot resets the media framework and clears any memory leaks.
Try a lower video quality setting if the app offers one.

Lower bitrate streams put less pressure on the decoder and are less likely to cause crashes.
If playing a local file, re-download or re-transfer the file.

The file itself may be corrupted, causing the decoder to fail on bad data.
Update the app to the latest version.

App updates often include decoder crash fixes for specific device models.

When to Call a Professional

This error rarely requires professional help. If it happens on all content and a fresh install does not help, contact the app developer with your device model. For a corrupted local file, the file itself may need to be re-downloaded.

Frequently Asked Questions

Is this error caused by the video file or my device?

It can be either — a corrupted file or a device memory/firmware issue. Try a different video first to narrow it down. If other videos work fine, the file is likely corrupted.

Why does the video play fine on my computer but fail on my phone?

Computers have more powerful decoders and more memory than phones. Your phone may struggle with high-bitrate or unusual codec combinations. Lowering the quality setting often solves this.

Could a bad app update cause this?

Yes — a buggy app update can break decoder handling for certain devices. Check if others report the same issue on the app's reviews page. Waiting for the next update or rolling back may help.