Is your Kodi not working? Even though Kodi is a highly stable application, problems may happen at times (just like with any software). This is where you need a trustworthy guide written by Kodi experts – and we’re pleased to say that you’ve come to the right place. We’ve created this comprehensive Kodi Troubleshooting Guide in an effort to provide easy solutions to a wide range of Kodi problems.
We’ve used this article to provide a comprehensive overview of common Kodi-related problems. With this said, here’s a list of jump links that will take you to the best solution to the problem you’re experiencing:
- Kodi Won’t Start (Crashes on Startup)
- Kodi Keeps Freezing, Pausing, and Crashing Frequently
- Kodi Shows The ‘Failed to Install a Dependency’ Error
- Kodi Shows The ‘Unable to Create Application’ Error
- Kodi Can’t Connect to a Source
- Kodi Addon/Build Not Working
- Kodi Addon/Build Search Not Working
- Kodi Can’t Delete an Addon
- Kodi Repository Not Working
- Long Buffering When Playing a Video in Kodi
- Kodi Playback Issues Related to Zoom & Brightness
- Kodi Can’t Play 4K or HD Video Filles
- Black Screen When Playing Videos in Kodi
Without any further ado, let’s jump to what truly want to know. Here’s how to fix common Kodi-related technical problems.
We’ve prepared two common solutions for this problem, which luckily doesn’t happen too often. Here’s what to do when Kodi crashes on startup and won’t launch.
Download the Latest Visual C++ Redistributable
If you have a brand new Windows 10 PC, or if you’ve recently done a fresh installation of Windows, Kodi can sometimes fail to launch. Instead, it crashes on startup without giving you an error message. Here’s an easy fix for this problem.
In many cases, installing the latest Visual C++ Redistributable can solve this issue. In fact, Kodi should check for any missing files on your system during the installation – but this doesn’t always happen. So, go to Microsoft’s website and download the latest update.
With each new update, Kodi receives plenty of bug fixes. So, here’s how to update Kodi to the latest available version.
- Go to Kodi’s official website and click on a blue ‘Download’ button. This is where you’ll find the latest versions for different platforms and operating systems.
- Select your operating system in the ‘Choose Your Weapon’ section and proceed with downloading the needed file.
- Once downloaded, double-click to install Kodi. You don’t have to uninstall the old version. Instead, re-install Kodi and all your add-ons and customizations will be left intact.
In case you need a more detailed guide with some extra information, we have a dedicated article on how to update Kodi.
There are several possible reasons why Kodi might be misbehaving. So, here’s what to do when Kodi keeps freezing when launched, or if it crashes constantly.
In many instances, clearing the cache of Kodi has the potential to resolve plenty of issues. Please use the provided link to get our in-depth guide on how this procedure is done.
In case you’re experiencing issues with certain addons, such as Exodus or Covenant, you should know that these addons come with dedicated maintenance tools. So, here’s how to clear cache on Exodus (which applies to some other addons as well).
- Open Kodi, navigate to Add-ons and launch Exodus;
- On the add-on’s Main Page, click on ‘Tools’;
- This is where you’ll see two options – ‘Clear Cache’ and ‘Clear Providers’. Feel free to use them. You will be asked whether you’d like to proceed, so click ‘Yes’ to finish.
Disable Hardware Acceleration
A number of playback issues can be resolved by disabling hardware acceleration from within Kodi’s interface. This problem is more present on Android devices, which is why we strongly recommend you to disable this option if you have any kind of Android-based device, including a range of TV set-top boxes.
- Launch Kodi on your device;
- Go to Settings by clicking on the Gear-shaped icon (top-left corner);
- Navigate to Player Settings;
- In the bottom-left corner, click on the Gear icon until it says ‘Expert‘;
- On the right side of the screen, you’ll see an option that says: ‘Allow Hardware Acceleration – DXA2‘. Make sure to disable this option;
- Restart Kodi.
Reset Kodi to Default Settings
Restoring Kodi to default settings is done via an addon called Indigo. This is a hugely powerful maintenance addon that you can use to resolve all kinds of Kodi-related issues. We strongly recommend you to keep Indigo installed on your system, as it will most definitely come in handy.
Here’s how to reset Kodi to default settings by using Indigo:
- After installing Indigo, open it from within Kodi;
- On the home screen, you’ll see an option named ‘Factory Restore‘. Click on it;
- You’ll be asked whether you want to do this option, so go ahead with ‘Yes‘;
- It might take a few minutes for this process to be done.
- Once everything’s set, restart Kodi and import your media library once again.
Update the ‘URL Resolver’ Addon
In many cases, faulty addons cause Kodi to reboot continuously. First, we suggest you disconnect from the Web. Then, open Kodi and delete any recently installed addons. However, you can also try to update Web scrapers (while connected to the Web, of course), and here’s how that is done:
- Launch Kodi;
- Go to Settings and then open ‘System Settings‘;
- Scroll down to the ‘Add-ons‘ tab and click on ‘Manage Dependencies‘;
- You will see an entry named ‘URL Resolver‘. Select it, and then select ‘Update‘;
- Restart Kodi.
When installing addons, the last thing you want to see is the ‘Failed to Install a Dependency’ error. However, there’s plenty you can do to solve this problem.
In essence, you need to understand the cause of this problem first. Kodi addons rely on different types of addons to work. For example, we have Web scrapers that search the Web for media streaming links. If the scraper doesn’t work, the addon won’t work either.
Now, let’s talk about how to resolve this issue. You’ll find all you need to know in our article on resolving Kodi’s dependency-related issues.
In some cases, updating your Kodi to the latest available version can cause certain issues. The most common one is the ‘Unable to Create Application’ error which prevents Kodi from opening after updating the application. This most frequently happens on Windows PCs, so here’s the solution:
- Go to My Computer on your Windows PC;
- Now, make sure that you can see hidden files. This is done (on Windows 10) by clicking on the ‘View’ tab and then select ‘Hidden Items‘;
- Now go to C: > Users > Your Username > App Data > Roaming;
- Next, go to Kodi > Userdata.
- This is where you’ll find a file named ‘profiles.xml’. Feel free to delete this file as it has become corrupted.
- Now, restart your PC and launch Kodi. The application will create a new ‘profiles.xml’ file and it should start successfully.
Every time you want to add an external source, you will need to add a URL. For example, this happens when you want to install an addon. If Kodi fails to open that URL, you will see a notification saying that it can’t connect to a source. So, here’s what to do:
- First, make sure that you’ve entered the URL correctly.
- Check if the URL begins with ‘HTTP’ or ‘HTTPS’ and check for any uppercase or lowercase letters.
- If you’re 100% sure that you’ve entered the URL correctly, the repository might be offline at the moment. In that case, try installing some other addon from a different source.
In case you can’t access any video streams after installing an addon or build, we suggest two options. Make sure to update your addon to the latest available version. If that doesn’t help, try using a VPN.
Update Your Kodi Addons
Once you launch Kodi, the application will try to search for new versions of add-ons. If there are pending updates, you can see them in the Add-ons section – under Kodi’s logo. You’ll recognize this icon as a circular arrow. Click on it to perform manual updates.
- Open Kodi and navigate to the Add-ons section;
- Now go to Video Add-ons where you’ll find the add-on you are looking for;
- Once you find it, right-click on its icon and pick ‘Information’;
- You will see an overview of the add-on. Click on the ‘Update’ button to manually check for a newer version.
Make sure to occasionally check for new updates. We understand that this can be tiresome if you have dozens of installed add-ons. However, make sure to keep your frequently used add-ons updated at all times. And finally, here’s how to uninstall addons that you no longer use.
Use a VPN to Unblock Kodi’s Video Streams
In many cases, fixes for Kodi-related problems might be out of your reach. That’s because Kodi is often associated with piracy, which forces certain ISPs (Internet Service Providers) to block or throttle Kodi-related traffic. In turn, this often produces problems with buffering, which makes streaming video files close to impossible.
The most reliable way to fix this issue is by using a VPN application. These are quite technical yet easy-to-use solutions that encrypt your Web traffic. By being encrypted, your traffic can’t be throttled by anyone, including your ISP, which is how VPNs work.
Since VPNs are subscription-based, you need to do your research on which one to use. A good place to start is our overview of the best VPN for Kodi. In fact, we always recommend our readers to buy the ExpressVPN subscription, is just because, it is the best VPN overall. Once you’re ready to make your pick and start using it, you’ll want to read our guide on how to install a VPN on Kodi.
In many instances, Kodi isn’t able to search for files is the date and time are incorrectly set. This also causes problems within individual addons, especially those that list entries based on dates. Therefore, to resolve this problem, you need to check your device. This can be a computer, a media streaming device, or a TV set-top box. Double-check if the date and time are set properly.
If you’re just upgraded to a major new Kodi version, there’s also a chance that you’re using obsolete addons. It might take a few months until developers update their software creations and made them fully compatible with new Kodi versions.
In some cases, Kodi will present a series of errors that prevent you from uninstalling addons. So, here’s what you need to do.
Delete Kodi Addons – The Right Way!
At times, faulty addons or builds can force your Kodi to crash. When that happens, you need to remove recently installed addons. There are different ways you can do this, with the easiest one being from within Kodi’s interface. For more information about this, here’s our article on how to delete Kodi addons.
If you’re experiencing problems related to Kodi’s black screen or blank screen issues – you can resolve these by deleting a file named ‘Addons27.db’. It’s also important to note that this issue usually happens when updating Kodi to a major new version.
The solution is to delete a file called ‘Addons27.db’ which contains cached information about your installed addons. You won’t remove any addons this way, as the file will be automatically generated the next time you launch Kodi. So, here’s how to find and delete this file:
- Windows: Open the Start menu and paste the following navigation path: %APPDATA%kodiuserdataDatabase. Click ‘Enter’ and the folder will open.
- MacOS: Go to Users > Your Username > Library > Application Support > Kodi > Userdata > Database.
- Linux: Go to ~ > Kodi > Userdata > Database.
- Android: Navigate using a File Manager to Android > data > orgkodi > files > kodi > userdata > Database.
- iOS: Go to private > var > mobile > Library > Preferences > Kodi > Userdata > Database.
- OpenElec/LibreElec: Navigate to storage > kodi > userdata > Database.
Once you open the ‘Database’ folder, simply delete the ‘Addons27.db’. There’s no need to restart your device, just open Kodi. The file will be created from scratch, potentially resolving Kodi-related blank screen issues.
You need to know that Kodi addons 100% rely on remote servers. Even though they’re installed locally, they need a Web connection to work. If something happens to those servers, the addon will stop working all of the sudden.
In general, Kodi addons are quite unreliable, especially unofficial ones. They depend on their developers who spend quite a lot of time maintaining their addons. So, when you find a non-working addon or repository, we suggest you simply move to a new one. There are hundreds of addons on the Web, and we’re sure you’ll find an alternative.
Here’s what to do if you’re experiencing playback issues with your Kodi. We’ve prepared several handy solutions for you.
Fine-Tune Kodi’s ‘AdvancedSettings’ File
In general, the more powerful computer (or device) you have, the better. Even though Kodi is a lightweight application, you can allocate more resources to help the application run better. This is done via an XML file that you need to create and place within your User Data folder. We’ll tell you how to create that file, where to place it and how to make Kodi more powerful.
The first step is to create a new file with the XML extension that needs to be placed in your User Data folder. Here’s how to locate your User Data on different operating systems:
- Windows: Open the Run command by pressing the Windows Key + R. Paste the following code: ‘%APPDATA%roamingkodiuserdata’. Press Enter and you’ll see the directory. You can also use the provided navigation path by launching the Start menu in Windows 10 and pasting it.
- Mac: Go to ‘/Users/<your_user_name>/Library/Application Support/Kodi/userdata/’;
- Linux: Navigate to ‘~/.kodi/userdata/’;
- Android: Use your default File Manager and go to ‘Android/data/org.xbmc.kodi/files/.kodi/userdata/’;
- iOS: Use your devices File Manager and open ‘/private/var/mobile/Library/Preferences/Kodi/userdata/’.
Once you’ve found the directory, create a new file and name it ‘advancedsettings.xml’. This can be done by creating a new text file and making sure you are using the XML extension.
Using the below-placed image, you can see the final look of the Advanced Settings file. Please note that the blue-colored text must be placed as you see on the image. The white text presents variations you can use, depending on your device’s specification. The green-colored texts are explanations for what each of the available commands can do.
To help you understand what each of the commands is used for, we’ll take a closer look at every one of them:
- <memorysize> is a command used to tell Kodi how many bytes to use. In general, you can use up to one-third of your free RAM memory and dedicate it to Kodi. Make sure to know how much RAM you have, and divide that number by three. However, make sure to calculate that number in bytes. You can use this Online Converter to switch between gigabytes and bytes.
- <buffermode> is a setting that defines the types of content that are allowed to be buffered. For example, you can instruct Kodi to only buffer locally stored content or to buffer any type of file. ‘0’ is used to buffer all internet streams, ‘1’ is used to buffer anything compatible with Kodi, while ‘2’ is used to buffer true Internet-based filesystems.
- <readfactor> is how Kodi tries to read a video file. If you have a powerful processor, you can take advantage of that. The default value is ‘4.0’. You can double it if you have a CPU that is above mid-range.
Once you’ve entered the new values, save your file. Once again, make sure the file has the XML extension. That’s all you need to know. Kodi will do the rest.
Important note: Make sure that every symbol is properly entered. Take a close look at the image above and make sure every command has its start and end. For example: <memorysize> and </memorysize>. You will see that every command needs to be closed in order for Kodi to recognize this file. In case you mess something up, you can delete this file and Kodi will return to its original state.
Take Advantage of Real-Debrid
Long-time Kodi users are well-aware of an amazing tool called Real-Debrid. This service is used to help Kodi users deal with the uncertainty of streaming movies and TV shows using add-ons.
The truth is that Kodi’s addons act as repositories of links towards media files. When you start streaming a movie, for example, it isn’t served from a particular addon’s server. Instead, that addon is using a link found on the Web to help you stream that content. This is why you can often find broken links forcing you to search for alternatives.
Real-Debrid solves this issue by letting you download and stream media files as fast as your Internet connection allows. Even if a download gets interrupted, you can resume downloading the file at a later time. However, you need to know what add-ons support this service. So, check our article on how to configure Real Debrid on Kodi.
Please note that Real-Debrid is a premium-priced service. However, it’s quite affordable. If you depend on Kodi for all your media streaming needs, this service can be a wise investment.
Playback issues related to incorrect colors are not common when it comes to Kodi. However, you might experience something strange at times. For example, videos can be too large or too small, which means that you’ve accidentally zoomed in or out. Here’s what you need to do:
- Start playing a video within Kodi;
- In the bottom-right corner, you’ll see the Gear icon. Click on it;
- Next, select ‘Video Settings‘;
- This is where you’ll see the ‘Zoom Amount‘ option. Return it to ‘1.0‘;
- Also, make sure the ‘Video Mode‘ is set to ‘Normal‘.
- While you’re here, you can also check if the brightness and contrast are set to 50%.
You’ve probably heard great things about 4K video addons for Kodi. However, playing 4K files requires you to have a capable machine running Kodi. This is why we recommend you to check whether your device is capable of playing 4K files.
You should also know that Kodi comes preloaded on a number of custom-made Android TV boxes. These are so-called ‘Kodi Boxes’ and they are usually quite affordable. In the majority of cases, these can play HD files (720p or 1080p). However, many of them are simply not capable of playing 4K files which leads to stuttering.
We’ve received reports of Kodi users experiencing a black screen when trying to play videos. Upon further investigation, we’ve discovered three possible solutions for this problem. And interestingly enough, we already wrote about those solutions – found in this article. Therefore, check out the following jump links:
We hope that our Kodi troubleshooting guide helped you solve your issues. If you know any other solution to any problem described in this article, please make sure to post a comment below.