Fix Kodi Won’t Open Error on Windows

If Kodi won’t open on your Windows PC, you’re likely seeing the application crash on launch, a blank window, or an error message before the interface appears. This guide walks you through the most common causes and fixes, from clearing a corrupted cache to reinstalling the app cleanly. No special tools are needed—just a few minutes and access to your Windows settings.

What You’ll Need

A Windows PC (Windows 10 or 11)
Administrator access (to run commands and reinstall software)
Your Kodi installation file (or the ability to download it again)

Step-by-Step

Close Kodi completely. If Kodi is running in the background (even if the window isn’t visible), right-click the taskbar and select Task Manager. Under Processes, look for Kodi and click End task. This ensures no lingering process is blocking a fresh start.
Restart your PC. A simple reboot clears temporary glitches and frees up memory that Kodi might need. After restarting, try launching Kodi again. If it still fails, continue.
Run Kodi as an administrator. Right-click the Kodi shortcut (on your desktop or Start menu) and select Run as administrator. If this works, the issue is likely a permissions problem. To make it permanent, right-click the shortcut, go to Properties > Compatibility tab, and check Run this program as an administrator.
Clear the Kodi cache and settings. Kodi stores its configuration and cache in a folder under %APPDATA%\Kodi. Press Win + R, type %APPDATA%\Kodi, and press Enter. Rename the userdata folder to userdata.old (or move it to your desktop) to reset Kodi’s settings without deleting your media library. Try launching Kodi again. If it opens, your old settings were corrupt. You can restore specific files from userdata.old later, but often a fresh start is best.
Check for conflicting add-ons. If the issue started after installing a new add-on, it might be crashing Kodi on startup. After renaming userdata, Kodi will start with default settings and no add-ons. If it works, you can reinstall add-ons one by one to find the culprit.
Update your graphics drivers. Kodi relies on hardware acceleration. Outdated or corrupt GPU drivers can prevent it from launching. Go to Device Manager (right-click Start), expand Display adapters, right-click your GPU, and select Update driver. Choose Search automatically. If Windows doesn’t find a new driver, visit your GPU manufacturer’s website (NVIDIA, AMD, Intel) for the latest version.
Disable hardware acceleration in Kodi (if you can access settings). If Kodi opens but shows a black screen or freezes, you might need to turn off hardware acceleration. Since you can’t get into Kodi, you can edit the settings.xml file in the userdata folder. Open it with Notepad, find the line containing videoplayer\useamcodec or videoscreen\useamcodec and change the value to false. Save and try again.
Reinstall Kodi completely. If nothing else works, a clean reinstall is the most reliable fix. First, uninstall Kodi via Settings > Apps > Apps & features. Then, delete the remaining %APPDATA%\Kodi folder (this removes all settings and add-ons—back up anything you want to keep). Download the latest version from the official Kodi website (kodi.tv) and install it. Run it once to ensure it opens, then you can restore your backup if you made one.

Common Mistakes

Deleting the wrong folder. The %APPDATA%\Kodi folder is where user data lives. Deleting the installation folder (usually C:\Program Files\Kodi) doesn’t clear corrupted settings—it only removes the program files.
Renaming userdata but not closing Kodi first. If Kodi is still running, it will recreate the folder and overwrite your changes. Always end the process first.
Skipping the restart. Many Windows issues are resolved by a simple reboot. Don’t skip this step.
Installing a beta or nightly build. If you’re using a development version, it might be unstable. Stick to the stable release.

Tips

Back up your library. Before making major changes, export your library via Settings > Media > Export library. This saves your watched status and metadata, so you don’t lose everything after a reset.
Use a portable install. If you frequently run into issues, consider using the portable version of Kodi. It stores all data in the installation folder, making it easy to back up and move.
Check Windows Event Viewer. If Kodi crashes, Windows logs the error. Press Win + X and select Event Viewer. Under Windows Logs > Application, look for errors with source Application Error that mention Kodi. The details might point to a specific DLL or module causing the crash.

Troubleshooting

If you’ve followed all steps and Kodi still won’t open, try these additional checks:

Check for antivirus interference. Some security software flags Kodi as a false positive and blocks it. Temporarily disable your antivirus (or add Kodi to the exclusions list) and try launching again. If it works, add Kodi to the allowed list permanently.
Ensure your Windows is up to date. Go to Settings > Update & Security > Windows Update and install any pending updates. A missing system component can cause Kodi to fail.
Test with a new Windows user account. Create a new local user (Settings > Accounts > Family & other users) and try running Kodi under that account. If it works, your main user profile is corrupted. You can migrate your files or use the new account.
Check for corrupted system files. Open Command Prompt as administrator and run sfc /scannow. This scans and repairs Windows system files. After it finishes, restart and try Kodi again.
Look at the Kodi log file. Kodi creates a log file at %APPDATA%\Kodi\kodi.log. Open it with Notepad and look for lines containing ERROR or FATAL. The log often reveals the exact cause, such as a missing dependency or a bad add-on.

Frequently Asked Questions

Why does Kodi open but show a black screen?

This is usually a graphics or hardware acceleration issue. Try updating your GPU drivers, or disable hardware acceleration by editing settings.xml as described in Step 7. Also, try changing the rendering method in Kodi’s settings (if you can access them) from Direct3D to OpenGL.

Will I lose my movies and TV shows if I reset Kodi?

No. Your media files are stored on your hard drive, not inside Kodi. Kodi only stores the library database and settings. Resetting Kodi (by renaming userdata) will remove the library entries, but you can re-add your media sources and Kodi will rescan them. Your actual files remain untouched.

Can I fix Kodi without reinstalling Windows?

Yes, absolutely. The steps above are all non-destructive to your system. Reinstalling Windows is a last resort and rarely needed for Kodi issues.

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

That add-on is likely outdated or incompatible with your Kodi version. Try updating the add-on, or disable it and use an alternative. You can also check the Kodi log for errors related to that add-on.

Is it safe to use the `userdata.old` folder after a reset?

Yes, you can copy back specific files from it, like sources.xml (your media sources) or advancedsettings.xml, but avoid copying the entire folder as it may bring back the corrupt settings that caused the problem.

How do I know which Kodi version I have?

If Kodi won’t open, you can check the version in the kodi.log file. The first few lines usually contain the version number. If you have a shortcut, right-click it and select Properties—the version might be listed there, but the log is more reliable.

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 →