Kodi Keeps Crashing? Fixed: Causes & Solutions

Kodi crashing repeatedly is a common frustration, but it is usually fixable without reinstalling everything. The fix depends on the cause—most often a corrupt add-on, a bad skin, outdated hardware acceleration settings, or a full cache—and this article walks through each likely culprit and the exact steps to resolve it.

Why Kodi Crashes: The Most Common Causes

Kodi is a media center application that runs on Windows, macOS, Android, iOS, Linux, and even Raspberry Pi. Because it is highly customizable, crashes often come from user-installed components rather than the core program itself. The top reasons in order of frequency:

• Add-ons with bugs or incompatibilities – third-party add-ons, especially unofficial ones, can crash Kodi when they try to fetch data or play content.
• Corrupt cache or database – the video and music libraries, as well as the thumbnail cache, can become corrupted after a power outage or a forced shutdown.
• Hardware acceleration conflicts – enabling video acceleration that your GPU or driver does not support well can cause immediate crashes during playback.
• Outdated Kodi version – running an old release on a newer operating system often leads to instability.
• Skin or theme issues – a heavy skin with too many widgets can exhaust memory on low-end devices.
• Insufficient storage or memory – on Android boxes or Raspberry Pi, a full SD card or low RAM can cause random crashes.

First Steps: Basic Troubleshooting

Before diving into advanced fixes, try these simple steps. They resolve a surprising number of crashes:

1. Restart the device – a full reboot clears temporary files and resets the GPU state.
2. Update Kodi – go to the official Kodi website and download the latest stable version for your platform. Do not use beta builds unless you are testing.
3. Check for add-on updates – open Kodi, go to Add-ons → My add-ons, and update any that have pending updates.
4. Clear the cache – in Kodi, go to Settings → System → Storage, then clear the thumbnail cache. On Android, you can also clear the app cache from the system settings.
5. Disable hardware acceleration temporarily – Settings → Player → Videos, turn off “Allow hardware acceleration” (both DXVA2 and VDPAU options) and test playback.

If none of these help, move on to the more targeted solutions below.

Fixing Add-On Related Crashes

Add-ons are the most common crash trigger. A single misbehaving add-on can take down the whole app. To isolate the problem:

1. Start Kodi in safe mode (if available on your platform) or temporarily rename the addons folder in your Kodi data directory to addons.bak and restart. If Kodi no longer crashes, an add-on is the culprit.
2. Re-enable add-ons one by one, testing after each, until you find the one that crashes.
3. For a known problematic add-on, disable it or uninstall it entirely. If you need it, check for an alternative or a newer version from the developer’s official repository.
4. If you use a build with many pre-installed add-ons, consider starting fresh with a clean Kodi installation and adding only what you actually use.

Remember that third-party add-ons that stream copyrighted content are not only unstable but also legally risky in many regions. Sticking to official Kodi repositories reduces both crashes and legal exposure.

Clearing the Corrupt Database and Cache

Kodi stores your library in an SQLite database. If it becomes corrupted, Kodi may crash when scanning or browsing. To rebuild it:

1. Close Kodi completely.
2. Navigate to your Kodi data folder (see table below for locations).
3. Delete the MyVideos*.db and MyMusic*.db files. Kodi will recreate them on next start.
4. Also delete the Textures13.db file – this is the thumbnail database.
5. Restart Kodi. You will need to re-scan your media sources, but the library will be rebuilt cleanly.

If you want to keep your library, you can back up the userdata folder first, but a fresh database is often the quickest fix.

Hardware Acceleration and Playback Settings

Hardware acceleration offloads video decoding to your GPU, which is great for performance, but it can cause crashes if the driver is buggy or the codec is not supported. Symptoms include crashes that happen only when playing certain video files, or after a few minutes of playback.

To adjust:

• Go to Settings → Player → Videos.
• Under “Processing,” set “Allow hardware acceleration” to off.
• If you have an NVIDIA or AMD GPU, update your graphics drivers from the manufacturer’s website.
• For Raspberry Pi, try changing the “Video acceleration” setting from MMAL to V4L2 or vice versa, depending on your OS version.

If disabling hardware acceleration fixes the crash, you can try enabling it again after a driver update. Some users find that disabling only one type (e.g., DXVA2) while keeping others helps.

When All Else Fails: Clean Reinstall

If you have tried everything and Kodi still crashes, a clean reinstall is the most reliable solution. This removes all settings, add-ons, and databases, giving you a fresh start.

1. Uninstall Kodi using your system’s normal uninstaller.
2. Manually delete the Kodi data folder (see table below) – this is crucial, as uninstalling often leaves it behind.
3. Reinstall the latest stable version from the official website.
4. Do not restore any backup from the old installation, as that would bring back the problem.
5. Add your media sources and reinstall only the add-ons you need.

This is the nuclear option, but it works in the vast majority of cases. Before doing this, you may want to export your library to a .strm file or a video playlist so you don’t lose your watched status.

Frequently Asked Questions

Why does Kodi crash only when I open a specific add-on?

That add-on likely has a bug or is incompatible with your Kodi version. Check for updates in the add-on’s repository. If no update exists, disable it and look for an alternative. Some add-ons also crash if they try to access a service that is down or blocked in your region.

Can a VPN cause Kodi to crash?

Yes, if the VPN software interferes with network traffic or uses a virtual network adapter that Kodi doesn’t handle well. Try disabling the VPN temporarily. If the crashes stop, configure the VPN to bypass Kodi or use a different VPN provider.

How do I find the Kodi data folder on Windows, Mac, and Android?

On Windows, it’s %APPDATA%\Kodi. On macOS, it’s ~/Library/Application Support/Kodi. On Android, it’s usually Android/data/org.xbmc.kodi/files/.kodi (or /sdcard/Android/data/org.xbmc.kodi/files/.kodi). On Linux, it’s ~/.kodi. You can also find it in Kodi by going to Settings → System → Storage and looking at the “Data” path.

Is there a way to prevent Kodi from crashing in the future?

Keep Kodi and add-ons updated, avoid unofficial add-ons, use a lightweight skin, and periodically clear the thumbnail cache. Also, make sure your device has enough free storage and RAM. On Android, closing other background apps can help.

Does Kodi crash more on certain devices?

Yes, low-end Android TV boxes and Raspberry Pi models with limited RAM are more prone to crashes, especially when using heavy skins or streaming high-bitrate 4K video. Using a lighter skin and disabling unnecessary services can improve stability.

What if Kodi crashes on startup before I can change any settings?

You can still fix it by deleting the guisettings.xml file in the userdata folder. This resets all GUI settings (like skin and display) to defaults. If that doesn’t work, do a clean reinstall as described above.

Related

• Is a Document Scanner Worth the Extra Cost?
• Flock Safety Drone Programs: Costs, Capabilities, Privacy
• Relative Row Numbers in Excel: How to Get Them

in t | Finish time | min | 50 | 0
in d | Distance | km | 10 | 0
out pace | Average pace | min/km | t / d | 2
out speed | Average speed | km/h | d / (t / 60) | 2