How many times have you been watching a movie on Kodi and suddenly get an error message telling you to check the log file for more information?
It’s happened to me more than once, so I’m guessing it’s happened to you too.
In fact, if you go on the official Kodi forums to get help for a problem, one of the first things they’re going to ask for is a copy of your log file.
The log file is a simple text file that stores every action that Kodi does. It’s incredibly helpful when you’re trying to troubleshoot errors, and provides some really useful information on your system.
In this article, I’m going to explain where you can find the Kodi log file. Then I’m going to show you an easy way to view the log file right from within Kodi itself.
Where is the Kodi Log File?
Each operating system will have a different location for the Kodi log file. That means if you’re used to running Kodi on your PC, for example, don’t expect the log file to be in the same folder on your Android TV.
Here are the most common locations for the log file, straight from the Kodi Wiki.
However, you don’t need to go to your favorite file explorer and navigate deep into your device’s file structure. I’m going to show you a quick way to view your log file – right inside Kodi itself!
Kodi Log File Viewer Addon
If you don’t feel like navigating through your device’s file structure to find your log file, don’t worry. There’s an easier way.
Team Kodi has an officially supported addon that lets you quickly view your log file.
This addon has saved me a lot of time trying to troubleshoot errors on my own Kodi devices. I highly recommend installing it on every Kodi device you have.
How to Install the Log Viewer for Kodi
To install the Log Viewer for Kodi addon, scroll down the left-hand side menu and click on the Add-ons section.
Once you’re there, click Install from Repository.
This pulls up a list of every repository you’ve installed on this instance of Kodi. Scroll down until you see the official Kodi Add-on Repository from Team Kodi. I’ve highlighted it in the image below.
Depending on how many repositories you’ve installed, you may have to scroll down to find it. Once you do, click it to continue.
Next, scroll down through the list until you get to the Program Add-ons section.
Click on it to continue.
Then, scroll down the list until you see the Log Viewer for Kodi addon.
Clicking on it takes you to the detail screen for the Log Viewer for Kodi addon. Here you can find the file size as well as some screenshots if you want to see what it looks like before you install it.
Click Install to continue.
The addon is very very small (under 1MB), so the installation only takes a few seconds. A check-mark appears next o the row once it’s finished.
With the installation complete, head back to the Add-ons menu so we can run the addon and view your log file.
How to Use the Log Viewer for Kodi
The Log Viewer for Kodi addon is essentially a text-file viewer that sits within the Kodi interface. It has a few settings that you can adjust to make things easier. We’ll go over those briefly below.
However, it’s core functionality is incredibly simple.
Once you start the addon, there are only three options: Show Log, Show Old Log and Settings.
Each log file is displayed right there on the screen. Although there’s no search function, you can scroll through from beginning to end.
It’s useful if you want to quickly get an idea of how your Kodi instance is performing and if there’s anything you need to examine in more detail.
Kodi’s log files are session logs, not a permanent log. A new log file is created every time you start Kodi.
The previous Kodi session’s log file is renamed to Kodi.old.log, which you can view using the Show Old Log file option.
Looking through log files can sometimes feel like you’re looking for a needle in a haystack. That said, there are a couple of settings that you can change to make your job a little easier.
Let’s take a look at those now.
The first thing I like to change is to Invert the Log so that the most recent entries are at the top of the log. This saves you from needing to scroll all the way to the bottom before you get started.
Once you invert the log, you then get the option of limiting the number of lines to display. I normally keep this to “All”, so I can see the entire log file. I only recommend changing this if you never reboot your Kodi box.
The other setting I change is to enable Show Log automatically When an Error Occurs. Personally, I like knowing right away if something is wrong with my system. That way I can address it before it gets worse.
If you’re having problems with your Kodi installation, looking at your log file is usually the first step to fixing the issue. The Log Viewer for Kodi addon is a great tool that’s officially supported by Team Kodi.
That’s all I could ask for, so I recommend installing it on all your Kodi devices.