How to install the HEVC codec

"A codec is required to play this file": the most searched HEVC error. Pick your system and you will have it sorted in five minutes.

Updated 5 sources cited

Key points

  • Windows: "HEVC Video Extensions" ($0.99 / €0.99) or the free device-manufacturer version if your PC has it; or use VLC.
  • Mac: nothing to install since macOS High Sierra (2017); for MKV, IINA or VLC.
  • Linux: FFmpeg already includes the decoder; install your distro's codecs and set up VA-API.
  • Download only from official sources: "free HEVC codecs" from unknown sites often bundle adware.

Pick your system

Windows 10 and 11

Cost
Free to $0.99
Time
2 minutes
Windows guide

macOS

Cost
Free
Time
Nothing to install
Mac guide

Linux

Cost
Free
Time
5 minutes
Linux guide

Android, iPhone and TVs

On phones and TVs the codec is built in and cannot be installed separately: if the device lacks a hardware decoder, your only options are an app with a software decoder (VLC for Android or iOS) or converting the video to H.264. See the list of compatible devices.

Before installing: does your hardware decode HEVC?

Intel
  1. 2015 6th gen (Skylake): 8-bit
  2. 2016 7th gen (Kaby Lake): 10-bit
NVIDIA
  1. 2015 GTX 950/960: Main y Main 10
  2. 2016 GTX 10: up to 12-bit
AMD
  1. 2015 Carrizo APUs and R9 Fury: 8-bit
  2. 2016 RX 400 (Polaris): 10-bit
Apple
  1. 2015 A9 chip (iPhone 6s)
  2. 2017 macOS High Sierra on Intel 6th-gen+ Macs
  3. 2020 M1: 8- and 10-bit
Before those dates HEVC can only be decoded in software (slow at 4K). Sources: NVIDIA, Intel, Wikipedia.

Most common errors

Message or symptomCauseFix
"You need a new codec to play this item"Windows without the HEVC extensionInstall the extension or use VLC
Audio plays but the picture is blackVideo decoder missingSame as above
Video stutters or CPU at 100 %Software decoding (GPU without HEVC or acceleration off)Enable acceleration in the player, update drivers or convert to H.264
Green, pink or blocky pictureDriver bug, or 10-bit file on an 8-bit-only GPUUpdate drivers; turn off hardware acceleration
HEIC photos won't openHEIF and HEVC extensions missingSee the Windows guide
QuickTime won't open an .mkvQuickTime doesn't support MKVIINA or VLC, or remux to MP4

The universal fix: a player with its own codec

VLC, mpv, Kodi and PotPlayer include FFmpeg's HEVC decoder and work even with nothing installed on the system. Find them all in downloads.

Frequently asked questions

Is the HEVC codec free?

It depends on the system. On Mac, iPhone, Android and Linux you pay nothing. On Windows, Microsoft's extension costs $0.99 / €0.99 unless the PC maker preinstalled it; the free alternative is VLC or mpv, which bring their own decoder.

Are codec packs safe?

Only from the official site. Avoid websites offering "free HEVC codec" with their own installers: they are a common adware route. We always link to the original download.

Sources

  1. Microsoft Store. HEVC Video Extensions
  2. Microsoft Store. HEVC Video Extensions from Device Manufacturer
  3. Apple. Using HEIF or HEVC media on Apple devices
  4. FFmpeg Wiki. Hardware acceleration (VA-API, NVDEC, QSV, VideoToolbox)
  5. VideoLAN. VLC media player