error_code_decoding_format_exceeds_capabilities
ExoPlayer / Media3 Streaming App
Severity: MinorWhat Does This Error Mean?
The video resolution or bitrate is too high for your device to decode. For example, a 4K stream on a device that only supports up to 1080p will trigger this error. Simply lower the video quality in the app settings to fix it.
Affected Models
- CloudStream 3
- Plex Media Player (Android)
- Kodi
- MX Player
- VLC for Android
- Any Android app using ExoPlayer or Media3
Common Causes
- Attempting to play a 4K video on a device that only supports 1080p
- Content bitrate exceeds the maximum the device decoder can handle
- High frame rate content (e.g. 60fps or 120fps) on a device that supports only 30fps
- HDR content on a device without HDR decoding capability
- The app selected a quality tier above the device's rated limits
How to Fix It
-
Open the app's video quality settings and select a lower resolution (e.g. 1080p or 720p).
This is the most direct fix — the device cannot play above its maximum supported resolution.
-
If the app has an 'Auto' quality mode, enable it so the app picks a safe resolution.
Auto mode lets the app choose quality based on your device's capabilities.
-
Check your device specifications to know its maximum supported resolution.
Search for your phone model online to find its video playback limits.
-
Update the app to the latest version.
Newer versions may better detect device limits and avoid selecting unsupported quality tiers.
When to Call a Professional
This is a device limitation, not a real error — no professional help is needed. Your device simply cannot decode content above a certain resolution or bitrate. Lowering the quality setting in the app is the correct and complete solution.
Frequently Asked Questions
Can I fix this without buying a new phone?
Yes — just lower the quality setting to 1080p or 720p. Your device plays lower resolutions perfectly fine. You do not need a new phone to enjoy the content.
Why does YouTube play 4K fine but this app does not?
YouTube uses adaptive streaming that automatically picks a safe quality for your device. This app may not have adaptive quality or may have selected a quality tier too high. Enable Auto quality or manually select a lower resolution.
Is 4K really that much better than 1080p on a phone screen?
On most phone screens, the difference between 4K and 1080p is very small. 1080p looks great on phones — you are not missing much. Saving battery and data with 1080p is often a better trade-off anyway.