sodcalculator

10 Tech How-To

Kodi Crashing on Windows? Fixes That Work

Guide 10-32089 · Updated · Step by step

If Kodi is crashing on Windows, the fix usually involves clearing a corrupted cache, updating the app, or disabling a problematic add-on. This guide walks through the most common causes and step-by-step solutions, from simple restarts to deeper configuration changes.

Why Kodi Crashes on Windows

Kodi is a powerful, open-source media center, but its flexibility comes with complexity. Crashes on Windows typically stem from one of four areas:

  • Corrupted cache or database: Kodi stores thumbnails, library info, and add-on data in a user-specific folder. If this data gets corrupted (often after a power loss or forced shutdown), Kodi can crash on startup or while browsing.
  • Problematic add-ons: Third-party add-ons, especially those not from the official repository, can contain unstable code or conflict with the current Kodi version. A single bad add-on can crash the entire app.
  • Outdated graphics drivers: Kodi uses hardware acceleration for video playback. An outdated or buggy GPU driver can cause crashes during playback, especially with high-resolution or HDR content.
  • Incompatible Kodi version: Running an older Kodi build on a newer Windows version (or vice versa) can lead to instability. Also, Windows often updates, and a Kodi version that was fine last month may now have issues.

Quick Fixes to Try First

Before diving into complex solutions, try these quick steps. They resolve a surprising number of crashes:

  1. Restart Windows: A simple reboot clears temporary system issues and frees up memory that Kodi might be fighting for.
  2. Update Kodi: Go to the official Kodi website and download the latest stable version. If you’re using an older version, a newer one likely contains bug fixes for crashes.
  3. Update your graphics drivers: Use the tool from your GPU manufacturer (NVIDIA, AMD, Intel) to check for and install the latest driver. This is critical for video playback stability.
  4. Run Kodi as Administrator (temporarily): Right-click the Kodi shortcut and select “Run as administrator.” If it doesn’t crash, the issue is likely a permissions problem with its data folder. (Don’t leave this as a permanent fix; it can cause other issues.)

Clear the Kodi Cache and Data (The Nuclear Option)

If quick fixes fail, the most reliable solution is to reset Kodi’s user data. This clears all corrupted files and returns Kodi to a clean state. Warning: This will remove your library, watched status, and add-on settings. You’ll need to set everything up again.

  1. Close Kodi completely.
  2. Press Windows + R to open the Run dialog.
  3. Type %APPDATA%\Kodi and press Enter. This opens the Kodi data folder.
  4. Delete the addons, userdata, and Database folders (or just the entire Kodi folder).
  5. Restart Kodi. It will rebuild the folders from scratch.

If you want to keep your library but fix a crash, try deleting only the Database folder first. That often fixes database corruption without wiping your add-ons.

Disable Hardware Acceleration

Hardware acceleration offloads video decoding to your GPU, which is usually a good thing. But on some Windows systems, especially with older GPUs or specific drivers, it can cause crashes.

  1. Open Kodi (if it starts).
  2. Go to Settings (gear icon) > Player > Videos.
  3. Scroll down to Processing and turn off Allow hardware acceleration (DXVA2).
  4. Also try turning off Allow hardware acceleration (VDPAU) if it’s listed.
  5. Restart Kodi and try playing the video that caused the crash.

If the crash stops, you’ve found the culprit. You can leave acceleration off, or try updating your GPU driver and then re-enabling it.

Find the Culprit: Disable Add-ons

Add-ons are a common source of crashes. If Kodi starts but crashes when you open a specific add-on, that’s your problem. If it crashes randomly, a background add-on (like a library auto-updater) might be the issue.

  1. Start Kodi in Safe Mode. To do this, hold Shift while clicking the Kodi icon, or run kodi.exe --safe-mode from a command prompt. Safe Mode disables all non-essential add-ons.
  2. If Kodi runs fine in Safe Mode, the problem is an add-on.
  3. Exit Safe Mode and go to Add-ons > My add-ons.
  4. Disable add-ons one by one (especially recently installed ones or those from third-party repos). Restart Kodi after each disable to test.

Common crash-causing add-ons include those that scrape metadata, auto-update libraries, or use heavy skins. If you have a custom skin, try switching back to the default Estuary skin first.

Check the Windows Event Log

If you want to know why Kodi is crashing, Windows records the details. This can help you pinpoint the exact file or module causing the problem.

  1. Press Windows + X and select Event Viewer.
  2. In the left pane, expand Windows Logs and click Application.
  3. Look for Error events with the source Application Error or .NET Runtime that mention kodi.exe.
  4. Click on the event to see the details. The Faulting module name often tells you what caused the crash (e.g., a specific DLL file).

This is advanced, but it can reveal if a specific add-on’s DLL is the problem, or if it’s a system DLL like d3d11.dll (graphics) or nvlddmkm.sys (NVIDIA driver).

Reinstall Kodi Completely

If nothing else works, a full reinstall is the final step. This ensures you have the latest version and a completely clean install.

  1. Uninstall Kodi via Settings > Apps > Kodi > Uninstall.
  2. After uninstalling, manually delete the %APPDATA%\Kodi folder (as in the cache-clearing step) to remove leftover files.
  3. Download the latest version from the official website and install it.

A clean install is almost guaranteed to fix crashes caused by corrupted data or incompatible settings.

Frequently Asked Questions

Why does Kodi crash on startup?

This is almost always a corrupted database or cache. The userdata folder might be damaged. Try deleting the Database and Thumbnails folders in %APPDATA%\Kodi. If that doesn’t work, a full reset of the Kodi data folder will.

Does Kodi crash because of Windows updates?

Yes, occasionally. A Windows update can change system libraries that Kodi depends on, or it can update your graphics driver to a buggy version. If Kodi started crashing after a Windows update, try rolling back the GPU driver or updating to the latest Kodi version, which may have compatibility fixes.

Can a VPN cause Kodi to crash?

It’s possible. A VPN can interfere with Kodi’s network connections, especially if the VPN software crashes or the connection drops. If you use a VPN, try disabling it temporarily to see if the crashes stop. Also, some VPNs have split-tunneling features that can exclude Kodi.

Is there a way to fix Kodi crashing without losing my library?

Yes. First, try updating Kodi and your GPU drivers. Then, try disabling hardware acceleration. If you need to clear data, back up the userdata folder first. You can also export your library to an XML file (Settings > Media > Export library) and re-import it after a reset.

Why does Kodi crash only when playing certain videos?

This is usually a codec or hardware acceleration issue. The video file may use a codec that your GPU or Kodi’s software decoder handles poorly. Try disabling hardware acceleration, or install a codec pack like K-Lite Codec Pack (but be careful, as codec packs can sometimes cause conflicts).

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →