Ad Space — Top Banner

error_code_decoding_format_unsupported

ExoPlayer / Media3 Streaming App

Severity: Minor

What 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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.