Kodi Error? How to “Check the Log for More Information”

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.

AndroidAndroid/data/org.xbmc.kodi/files/.kodi/userdata/
iOS/private/var/mobile/Library/Preferences/Kodi/userdata/
Linux~/.kodi/userdata/
Mac/Users/<your_user_name>/Library/Application Support/Kodi/userdata/
Windows %APPDATA%\Kodi\userdata
Windows UWP %LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi\

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.

Add the Kodi log file viewer addon 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.

Install from the official Kodi Add-on repository

Next, scroll down through the list until you get to the Program Add-ons section.

Click on it to continue.

Program add-ons section of the official Kodi repository

Then, scroll down the list until you see the Log Viewer for Kodi addon.

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.

Detail screen for the Log Viewer for Kodi addon

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.

Post installation of the Log Viewer for Kodi addon

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.

Log Viewer for Kodi - main menu

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.

Log Viewer for Kodi: Show current log file

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.

Log Viewer for Kodi - Settings menu

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.


Conclusion

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.

Tim Wells

Tim Wells got his first computer at the age of ten and hasn't stopped tinkering ever since. After discovering Android TV boxes in 2013, he created a popular Android PC Review website and guided it to over 8 million pageviews before stepping away in 2018. After a brief hiatus from the industry he's back at the helm of AndroidTVNews.com to bring Android TV and TV boxes to the forefront of the streaming world. When he's not writing, he spends as much time as he can with his beautiful wife and his bulldog.

Recent Posts