VLC Fix Guide

VLC MKV No Video (Audio Only): Causes & Fixes

Format & Codec Issues Last updated: Applies to: All platforms · VLC 3.0.x · MKV/Matroska files

MKV (Matroska) is the most flexible video container in existence — and the most likely to surprise you: audio plays, but the video track shows nothing. Because MKV can hold nearly any codec, "MKV no video" usually means the contained video codec is failing in your decoder chain, not that the container is broken. The fixes below walk the real causes in order; the first two resolve most cases.

Why does this happen?

  • Unsupported or failing video codec inside the MKV — usually HEVC 10-bit, VP9, or AV1 in an MKV where your GPU/driver path fails.
  • Hardware acceleration conflict — the GPU decoder misreads the MKV’s video track.
  • Multiple video tracks — some MKVs (especially remuxes) contain 2–3 video tracks; VLC may default to a broken one.
  • Corrupt MKV index (cues) — a damaged index makes VLC seek/fail on the video track.
  • Old VLC with demuxer bugs — MKV handling improved substantially across 3.0.x releases.

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 2Switch the video track

Fixes MKVs with multiple video tracks

  1. Right-click the video > Video > Video Track.

    The video track list opens.

  2. Try each track if more than one is listed.

    A working track is found.

  3. Confirm the chosen track in Tools > Track Synchronization.

    The correct track is active.

NoteRemuxed MKVs sometimes carry a director’s commentary video track or a broken first track — track 2 may be the real content.

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.

NoteThis forces CPU decoding. Slightly higher CPU usage is normal, but playback becomes stable. If it works, you can later re-enable it after updating your graphics driver.

Fix 4Switch the video output module to OpenGL

Resolves black screen and rendering glitches on specific GPU setups

  1. Go to Tools > Preferences > Video.

    Video settings open.

  2. Set "Output" to OpenGL.

    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 5Repair the MKV index

Fixes corrupt-cue MKVs without re-encoding

  1. Install mkvtoolnix (mkvmerge) — the standard Matroska toolkit.

    mkvmerge is installed.

  2. Run: mkvmerge --fix-bitstream-timing-information 0 input.mkv -o fixed.mkv — or simply remux: mkvmerge -o fixed.mkv input.mkv.

    The index is rebuilt.

  3. Play fixed.mkv in VLC.

    The repaired file plays.

Notemkvmerge rebuilds the cues/index — no re-encoding, no quality loss, and it fixes the majority of "plays in one player but not VLC" MKV cases.

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 1Extract and inspect the video track

Identifies the exact codec and its flags

  1. Open the MKV in mkvmerge GUI (or run mkvinfo input.mkv).

    All tracks and codecs are listed.

  2. Note the video codec (V_MPEG4/ISO/AVC, V_MPEGH/ISO/HEVC, V_VP9, V_AV1…) and bit depth.

    The codec is identified.

  3. Search the codec name + VLC in the VideoLAN forum — many have known fixes.

    The specific fix is found.

NoteCodec-specific issues (e.g. V_AV1 in MKV on old GPUs) have codec-specific fixes — knowing the codec is half the battle.

How to avoid it in the future

  • Keep VLC updated — Matroska demuxer fixes land in every 3.0.x point release.
  • Remux downloaded MKVs once with mkvmerge to normalize broken files.
  • For 4K HEVC MKV, verify hardware decode works (see the HEVC guide).

Frequently asked questions

Why do MKV files play in other players but not in VLC?
Other players fall back to different decoder paths or handle multi-track MKVs differently. In VLC, update, switch video tracks, and toggle hardware acceleration in that order.
Is MKV supported by VLC?
Fully — MKV is a first-class container in VLC. The issue is always the codec inside or the file’s index, not the container itself.
Does VLC play MKV with DTS audio?
Yes, DTS decodes in software. If audio is missing (not video), see the no-sound guide — DTS passthrough misconfiguration is a common cause.
MKV plays video but no audio — what’s different?
The audio track (often DTS/AC-3/EAC-3) is the failing link. Check the audio track selection and the audio output module.
Should I convert MKV to MP4?
Only if the target device (TV, phone) lacks MKV support. VLC plays MKV natively — converting loses nothing but wastes time unless compatibility demands it.

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