How to Fix Kodi Not Playing Videos

Updated: April 2, 2026 · Full review · Alternatives · Video Players

When your Kodi video player stalls, freezes, or shows a black screen, the fix usually comes down to one of five common culprits: codec support, outdated software, hardware acceleration conflicts, add-on issues, or network problems. Here's how to fix Kodi not playing videos and get back to watching.

Check Your File Format and Codecs

The first thing to verify: does Kodi actually support the video format you're trying to play? This open source media player handles MP4, MKV, AVI, and dozens of other containers, but it needs the right codecs installed on your system. A file might play fine in VLC but fail in Kodi because the codec isn't available.

Supported Formats and Limitations

Kodi plays H.264, H.265 (HEVC), VP9, and AV1 video codecs. If you're streaming MP4 files and hitting problems, check whether the audio codec is AAC, MP3, or FLAC — mismatches here are a silent killer. Windows 10 and macOS usually have decent codec support built-in, but Linux users on Ubuntu might need to install additional libraries through the terminal.

For MKV files with embedded subtitles, make sure the subtitle format is SRT or ASS. Some exotic subtitle formats will cause the whole file to fail playback.

Update Kodi and Your System

Running an outdated version is the second most common culprit. Kodi 21.3 fixed numerous playback bugs from earlier releases. Navigate to Settings > System > Updates and check for a newer build. Don't skip this step — it takes two minutes.

Your operating system matters too. If you're on Windows 10, pull up Windows Update. macOS users should check the App Store. Ubuntu Linux users need to run `sudo apt update && sudo apt upgrade` in terminal. Older OS versions sometimes lack hardware video decoding drivers that Kodi relies on.

Disable Hardware Acceleration

Here's where most people get stuck: hardware acceleration (GPU decoding) can conflict with your graphics card driver. This is especially true on Android TV, Fire TV, and Raspberry Pi setups.

Go to Settings > System > Display > Video Playback. Toggle off "Adjust display refresh rate" and disable "Allow hardware acceleration." Test a video. If it plays now, your graphics driver needs updating. Grab the latest driver from your GPU manufacturer (NVIDIA, AMD, or Intel), install it, then re-enable acceleration.

Pro Tip: On Android TV devices and Fire TV, clearing the app cache often resurrects dead playback. Go to Android Settings > Apps > Kodi > Storage > Clear Cache. This doesn't wipe your library — just temporary data.

Scan Your Library and Clear Cache

When you import videos into your media library, Kodi downloads metadata (artwork, descriptions) and scrapes info from online sources. A corrupted library entry prevents that video from loading.

Navigate to Settings > Media > Library and select "Clean Library." Then go to Settings > System > Maintenance > Clean Cache. Restart the application afterward. This forces Kodi to rebuild everything from scratch.

How to Fix Kodi Not Playing Videos From Network Shares

If you're streaming videos over your home network (SMB, NFS, or DLNA server), connection drops are the real issue. Go to Settings > Services > SMB Client and increase the timeout value from 20 to 60 seconds. This gives the software more time to find files on your network before giving up.

For HTTP streaming sources, verify your internet connection can handle the bitrate. A 4K HEVC file won't stream smoothly on 10 Mbps bandwidth.

Add-Ons and Playback Failures

Third-party add-ons sometimes break between Kodi versions. Disable your custom add-ons one at a time under Settings > Add-ons. When the video plays, you've found your culprit. How to fix Kodi not playing videos caused by add-ons? Update them from the repository or remove outdated ones.

Explore managing add-ons in Kodi to keep them current.

If none of these steps work, compare with other media center software options to rule out a fundamental platform issue.