VLC Fix Guide

VLC HEVC (H.265) Not Playing: Full Fix Guide

Format & Codec Issues Last updated: Applies to: All platforms · VLC 3.0.x · 4K HEVC content

HEVC (H.265) video — standard for 4K, iPhones, and modern cameras — sometimes refuses to play in VLC: black screen, no picture, or an error. The pattern is usually hardware-related: VLC relies on your GPU’s HEVC decoder, and if the driver path fails, HEVC playback collapses while H.264 keeps working. This guide fixes the decoder path first, then the rare config-level causes. Fix 1–2 cover the vast majority of cases.

Why does this happen?

  • GPU HEVC decode failing (driver or capability) — older GPUs lack HEVC decode; newer ones fail via buggy drivers.
  • Hardware acceleration disabled — with hwaccel off, HEVC 4K is decoded by the CPU; weak CPUs drop frames or show no picture.
  • HEVC 10-bit (Main10) path issues — 10-bit HEVC needs a capable decoder; some drivers mishandle it while 8-bit works.
  • Demuxer misdetection — HEVC in unusual containers (TS, MKV with odd flags) can confuse VLC’s parser.
  • Very old VLC versions — pre-3.0 builds had partial HEVC support.

How to fix it

Fix 1Update VLC to the latest version

Applies official bug and security fixes (current stable: 3.0.23)

  1. In VLC, go to Help > Check for Updates.

    VLC compares your version with the latest.

  2. If an update exists, download it from the official page videolan.org.

    The new installer is downloaded.

  3. Install over your current version (settings are kept) and restart.

    VLC runs the new version.

NoteVLC 3.0.23 is the 24th update to the 3.0 branch and includes a large batch of demuxer and stability fixes — many "not playing" issues are already fixed there.

Fix 2Check whether your GPU actually decodes HEVC

Tells you if the problem is hardware capability

  1. Open the file and check Tools > Media Information > Codec: the "Decoder" line shows the decoder in use.

    You see the active decoder.

  2. If it shows a hardware decoder (D3D11VA, VDA, VAAPI), HEVC hardware decode is active; a black screen then means a driver bug.

    The decode path is known.

  3. If it shows FFmpeg software decoding and the CPU is pegged, your GPU/driver cannot decode HEVC — update the driver, or accept CPU decoding with the fixes below.

    The capability is assessed.

NoteAs a reference: Intel HD 4000 and older, most pre-2014 AMD GPUs, and pre-2014 NVIDIA GPUs cannot decode HEVC in hardware.

Fix 3Disable hardware-accelerated decoding

Fixes black/green screen, pixelation and stuttering in most cases

  1. Open VLC and go to Tools > Preferences (or press Ctrl+P on Windows/Linux, Cmd+, on macOS).

    The Preferences window opens.

  2. Click the Input / Codecs tab on the left.

    Codec-related settings are shown.

  3. Find "Hardware-accelerated decoding" and set it to Disable.

    The dropdown now reads "Disable".

  4. Click Save, then fully restart VLC (close every VLC window, not just the video).

    VLC restarts with software decoding.

  5. Play the problematic file again.

    If the issue is gone, the GPU decoder was the culprit.

NoteFor HEVC, hwaccel should be ON with a working driver. If hardware decode is unavailable, keep it OFF and rely on CPU — see the advanced fix.

Fix 4Update your graphics driver

Fixes black screen, green artifacts and crashes caused by driver bugs

  1. Press Win+X and open Device Manager (or System Settings > Display on macOS).

    The device list opens.

  2. Expand "Display adapters" and note your GPU model (NVIDIA, AMD or Intel).

    Your GPU is identified.

  3. Download the newest driver from the GPU vendor site (nvidia.com, amd.com or intel.com) — or use Windows Update.

    The driver package is ready.

  4. Install, restart your PC, then try VLC again.

    The system runs the new driver.

NoteOEM laptops sometimes block vendor drivers; in that case use the driver page from your laptop manufacturer instead.

Fix 5Switch the video output module to OpenGL (fixes HEVC 10-bit rendering glitches)

Resolves black screen and rendering glitches on specific GPU setups

  1. Go to Tools > Preferences > Video.

    Video settings open.

  2. Set "Output" to OpenGL (fixes HEVC 10-bit rendering glitches).

    The output module changes.

  3. Click Save and restart VLC.

    VLC restarts.

  4. Reopen the file and check the picture.

    The video should now render correctly.

NoteIf the new module works, keep it. Different GPUs and drivers behave differently, so testing is the fastest way to find a stable output.

Fix 6Reset VLC preferences to defaults

Clears corrupted settings that cause crashes, black screens and audio issues

  1. Close VLC completely.

    No VLC process is running.

  2. Open a command prompt (Win+R → cmd) or terminal.

    A command line is available.

  3. Run: vlc --reset-config (Windows/Linux) — on macOS delete ~/Library/Preferences/org.videolan.vlc instead.

    VLC preferences are restored to defaults.

  4. Launch VLC and re-apply only the settings you actually need.

    VLC starts with clean settings.

NoteThis erases all custom preferences (including shortcuts and skins). Export your config first under Tools > Preferences > All > Interface if you want a backup.

Advanced fixes

Fix 1Enable CPU (software) HEVC decoding properly

Plays HEVC on machines without GPU decode

  1. Tools > Preferences > Input / Codecs > "Hardware-accelerated decoding" > Disable.

    CPU decoding is forced.

  2. Enable "Drop frames on late pictures" to keep audio smooth on weak CPUs.

    Frames drop instead of stalling.

  3. For 4K HEVC on older CPUs, reduce the window size or use the video filter "Sharpen" is NOT needed — just accept the CPU load or watch in a smaller window.

    Playback is stable.

NoteModern mid-range CPUs (Ryzen 5 / Core i5, 2018+) decode 4K HEVC in software well enough for 24–30 fps. 4K60 may still drop frames.

Fix 2Remux HEVC-in-TS files

Fixes container-related HEVC failures

  1. Run: ffmpeg -i input.ts -c copy -map 0 output.mp4.

    The HEVC stream is remuxed into MP4.

  2. Play the MP4 in VLC.

    The remuxed file plays.

NoteNo quality loss — stream is copied, only the container changes.

How to avoid it in the future

  • Keep GPU drivers current — HEVC decode bugs are patched in driver releases.
  • Before buying/downloading 4K content, check your GPU’s HEVC decode support (NVDEC/Intel Quick Sync/AMD VCN).
  • Prefer MP4/MKV with clean HEVC flags for maximum compatibility.

Frequently asked questions

Does VLC support HEVC?
Yes — VLC 3.0 plays HEVC/H.265 in software and hardware. If yours does not, the failing link is usually the GPU decoder or driver, not VLC itself.
Why does HEVC play in another player but not VLC?
Other players may fall back to different decoder paths (e.g. Media Foundation) silently. In VLC, ensure hardware acceleration is on with an updated driver, or force software decoding.
Is HEVC 10-bit supported in VLC?
Yes, with a Main10-capable decoder. 10-bit issues usually trace to the GPU driver — update it, or use software decoding.
Do I need the HEVC codec pack on Windows for VLC?
No. VLC bundles its own HEVC decoder. The Windows Store HEVC extension is only needed by apps using Media Foundation.
Can VLC play AV1?
Yes — VLC 3.0 plays AV1 in software (and via hardware decode where supported). dav2d (the new AV2 decoder by VideoLAN) is on the roadmap for 4.0.

Summary

Update VLC to the latest version — Applies official bug and security fixes (current stable: 3.0.23). If it does not help, work through the remaining fixes in order: each targets a different layer of the problem. Most users resolve this issue by fix 3 at the latest. Keep VLC updated (current stable: 3.0.23) and revisit this guide when a new VLC version ships.

Related guides

Edited by the VLC Fix Guide Tech Team — 10+ years of media software troubleshooting