error_code_decoding_format_unsupported
ExoPlayer / Media3 Streaming App
Severity: MinorWhat Does This Error Mean?
Your device does not have a decoder for the codec used in this video (such as AV1 or HEVC). This is common on older Android devices that predate newer video compression standards. Switching to a lower quality or a compatible format usually resolves the issue.
Affected Models
- CloudStream 3
- Plex Media Player (Android)
- Kodi
- MX Player
- VLC for Android
- Any Android app using ExoPlayer or Media3
Common Causes
- The video uses AV1 codec which requires Android 10+ or specific hardware
- The video uses HEVC (H.265) which older devices do not support in hardware
- An unusual or niche codec (e.g. VP9 profile 2) not present on the device
- The app selected an AV1 or HEVC stream instead of a compatible H.264 stream
- The local file was encoded in a format incompatible with Android's media framework
How to Fix It
-
In the app settings, switch to a quality tier labeled H.264 or AVC if available.
H.264 is supported by virtually all Android devices and is the most compatible codec.
-
Lower the video quality to 720p or 1080p — these tiers typically use H.264.
Higher quality tiers often use newer codecs like AV1 or HEVC that old devices lack.
-
In Plex or Kodi, enable transcoding so the server converts the video to a compatible format.
Transcoding converts the file on the server side before it reaches your device.
-
In MX Player, go to Settings > Decoder and switch to 'SW' (software) decoder.
The software decoder supports more formats than the hardware decoder on older devices.
-
Update the app — newer versions may include a software fallback for unsupported codecs.
App developers often add software codec support for devices missing hardware decoders.
When to Call a Professional
No professional help is needed for this error. It is a device compatibility limitation, not a malfunction. Switching the quality/format setting or using a different app is the correct solution.
Frequently Asked Questions
What is AV1 and why does my phone not support it?
AV1 is a newer video codec that offers better compression than H.264. It requires hardware support that older Android phones (pre-2019) do not have. Switching to a lower quality usually picks an H.264 stream instead.
Does this mean I can never watch this content on my phone?
Usually not — most content is available in a compatible format at a lower quality. For local files, you can convert them using a free tool on your computer. For streaming, lower quality settings almost always use H.264.
Will a newer phone fix this?
Yes — phones from 2019 onwards generally support HEVC, and newer ones support AV1. But you can usually work around this on your current phone by using H.264 quality tiers. A new phone is not required.