Kodi Won't Play Your Movies — Every Fix for Every Error in 2026

Kodi is an open-source media center application that plays movies, TV shows, and other media from local drives, network shares, and streaming add-ons. When Kodi fails to play movies, the problem typically falls into one of four categories: missing codecs, corrupted video files, network share configuration issues, or hardware acceleration conflicts.

This guide covers every major cause and fix.

Part 1. Diagnosing the Error — Read the Log First

Before trying fixes randomly, check the Kodi debug log to identify the exact error. This saves significant time.

Enable debug logging:

1. Open Kodi → Settings (gear icon) → System
2. Scroll to Logging → enable Enable debug logging
3. Attempt to play the failing video
4. Go to Settings → System → Logging → Upload log file to Kodi servers (or find the log at ~/.kodi/temp/kodi.log on Linux/Mac, %APPDATA%\Kodi\temp\kodi.log on Windows)

Common log error messages and their meaning:

Part 2. Fix: Missing Codec or Unsupported Format

Kodi relies on codec libraries (typically provided by FFmpeg) built into the application. However, some DRM-protected content and certain proprietary codecs cannot be played natively.

Step 1 — Update Kodi to the latest version:

Most codec improvements are bundled with Kodi updates. Download the latest version from kodi.tv.

Step 2 — Install codec add-ons:

Some platforms (particularly Amazon Fire TV and older Android boxes) benefit from additional codec support:

1. Go to Settings → Add-ons → Install from repository → Kodi Add-on Repository
2. Navigate to Services → Codec Installation Helper if available for your platform

Step 3 — Convert the video file format:

If a specific file refuses to play on Kodi but plays fine in VLC, the container format may be incompatible. Use HandBrake (free) to convert the file to H.264 or H.265 in an MKV or MP4 container.

💡 Tip: H.265 (HEVC) content requires hardware decoding support on older devices. If your Kodi box is more than 5 years old and struggles with 4K H.265 content, try converting to H.264 instead — it plays on virtually every device.

Part 3. Fix: Hardware Acceleration Issues (Black Screen or Crash)

Hardware acceleration (using your GPU to decode video instead of the CPU) dramatically improves performance — but can cause black screens, stuttering, or immediate crashes when misconfigured.

Disable hardware acceleration:

1. Go to Settings → Player (set experience level to Advanced or Expert)
2. Scroll to Videos → Allow hardware acceleration (DXVA2) → toggle off
3. Also disable: Allow hardware acceleration (AMF), Allow hardware acceleration (VAAPI), Allow hardware acceleration (VDPAU) depending on your platform

Re-enable gradually:

After disabling all acceleration, re-enable one method at a time and test playback. Some codecs work with hardware acceleration while others require software decoding.

⚠️ Important: On Windows, if Kodi shows a black screen when playing any video, DXVA2 hardware acceleration is the most common culprit. Disable it first before any other troubleshooting. This single setting resolves the majority of black screen playback issues.

🗣️ r/Kodi user: "Spent two days debugging my Kodi setup. Turned out DXVA2 was causing silent crashes on H.265 files. Disabled it and everything worked instantly. Should have checked this first."

Part 4. Fix: SMB Network Share Not Working

Kodi frequently fails to play movies stored on NAS devices, Windows shared folders, or other network locations due to SMB protocol version mismatches or authentication changes.

Step 1 — Re-enter SMB credentials:

1. Navigate to Settings → Media → Videos → select the failing source → Edit source
2. Remove and re-add the network path, entering the correct username and password
3. Kodi stores credentials separately from Windows — ensure you are using the correct share username

Step 2 — Force SMB version:

Older NAS devices use SMBv1, while newer Kodi versions default to SMBv2 or SMBv3.

1. Go to Settings → Services → SMB client
2. Set Minimum SMB version and Maximum SMB version to match your NAS (SMBv2 is the recommended minimum for security)

Step 3 — Check network stability:

Buffering mid-playback on network sources often indicates network congestion rather than a Kodi issue. Use a wired Ethernet connection for reliable 4K stream playback from NAS.

💡 Tip: If Kodi can browse the network share but playback stalls, the issue is almost always network bandwidth. 4K H.265 files typically require 30–80 Mbps sustained throughput — a congested Wi-Fi network may not provide this reliably.

🗣️ r/Kodi user: "My Kodi kept dropping the SMB connection mid-movie. Switched from 5GHz WiFi to a powerline Ethernet adapter and the problem went away completely."

Part 5. Fix: Corrupt Video File

If a specific file fails to play but other files on the same source work fine, the file itself may be corrupt — especially if it was partially downloaded, interrupted during transfer, or came from an unreliable source.

Verify the file:

Use MediaInfo (free) to check the file's codec, container, and stream information. A healthy file shows complete stream data; a corrupt file may show truncated duration or missing stream info.

Repair a corrupt video file:

• Stellar Repair for Video — handles corrupt MP4, MKV, MOV, and AVI files
• VLC — in some cases, VLC can play files that Kodi cannot due to more aggressive error correction in its decoder

Part 6. Recovering Deleted Kodi Movie Files With Ritridata

If your Kodi movie files were accidentally deleted from a local hard drive, external drive, or NAS-connected drive that is also accessible as a local volume, Ritridata can recover them.

How to recover:

1. Stop writing new files to the drive where the movies were stored
2. Install Ritridata on a different drive or USB
3. Run a Deep Scan on the affected drive
4. Filter results by file type (MKV, MP4, AVI, MOV) — Ritridata identifies video file headers
5. Preview and recover to a different drive

Ritridata supports recovery from internal HDDs and SSDs, external drives, USB drives, and SD cards. NAS-connected drives accessible over the network cannot be scanned directly — but if the NAS drive is removed and connected via USB, Ritridata can scan it.

💡 Tip: Large video files (especially MKV files over 20 GB) have better recovery rates than small files because they occupy large contiguous blocks on the drive that are less likely to be partially overwritten.

FAQ

Q: Why does Kodi say "This item cannot be played" for every video? This error usually indicates either a missing codec, a broken add-on dependency, or a hardware acceleration conflict. Start by disabling hardware acceleration in Settings → Player → Videos. If that does not fix it, check whether the files play in VLC to confirm the files themselves are valid.

Q: Why does Kodi buffer constantly on network shares? Buffering on network playback typically means the network connection cannot sustain the required data rate. Switch to a wired Ethernet connection, reduce video quality, or increase Kodi's buffer size via advancedsettings.xml — set <buffermode>1</buffermode> and increase <cachemembuffersize> to a value appropriate for your available RAM.

Q: Does Kodi support Dolby Vision or HDR content? Kodi supports HDR10 and HLG playback on compatible hardware with appropriate video output settings configured. Dolby Vision support depends on the platform — it requires specific hardware and driver support. Check the Kodi wiki for your specific platform's HDR capabilities.

Q: Why did Kodi stop working after a Windows or Android update? System updates can reset hardware acceleration settings, audio output configuration, or break display driver compatibility with Kodi's rendering pipeline. After any major OS update, check Kodi's hardware acceleration settings and audio output device settings.

Q: Can Kodi play DRM-protected content like Netflix or Amazon Prime? Kodi's core player cannot handle Widevine-protected streaming services natively. Some add-ons (like the official Netflix and Prime Video add-ons with inputstream.adaptive) support DRM content through the Widevine CDM library, but setup is complex and support varies by platform.

Q: What video formats does Kodi support? Kodi supports a wide range of formats through its integrated FFmpeg library, including MKV, MP4, AVI, MOV, M4V, FLV, TS, ISO, and most H.264, H.265/HEVC, VP9, and AV1 video codecs. Very new codecs like AV1 may require hardware decoding support for smooth playback on lower-powered devices.

References

• Kodi Official Download Page
• Kodi Wiki — Video Playback Troubleshooting
• HandBrake — Open Source Video Transcoder
• VLC Media Player
• Ritridata — Data Recovery Software