How To Check Kodi's Log File Featured Image

We’ve all have seen the “One or more items failed to play. Check the log for details” error message. But where’s the log and how can i check it? In this guide we’ll show you how to find Kodi’s log file and what to do afterwards.

Checking the log file

Kodi’s log is a plain text file so you can open it with any text editor. If you are using Android you might need to use a File Explorer app, on some systems you might need to enable the view hidden files option.

Each OS use different paths to store Kodi’s files, you can find the path to the log file on the following list.

  • Windows Desktop: %APPDATA%\Kodi\kodi.log 
  • Windows Store%LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi\kodi.log
  • Linux$HOME/.kodi/kodi.log
  • Ubuntu: $HOME/.var/app/tv.kodi.Kodi/data/temp/kodi.log
  • macOS/Users/<user_name>/Library/Application Support/Kodi/kodi.log
  • Android<data | sdcard | storage>/Android/data/org.xbmc.kodi/files/.kodi/temp/kodi.log
  • iOS/private/var/mobile/Library/Preferences/Kodi/kodi.log
  • OpenELEC/storage/.kodi/kodi.log
  • OSMC: /home/osmc/.kodi/temp/kodi.log
  • XBian: /home/xbian/.kodi/temp/kodi.log

Each line in the log file describes an event, it contains data like the time of the event, the event’s severity level and a message describing the event.

There are different severity levels in the Kodi log, you need to focus on events of level WARNING and ERROR and read the event’s descriptions to identify the source of the problem.

Event descriptions usually show the name of the addon or the filename where the error originated. Here is an example of the log file showing an error caused by a corrupted file in the addon Covenant.

14:23:06.600 T:8816 NOTICE: Running the application…
14:23:06.600 T:8816 NOTICE: starting upnp client
14:23:06.607 T:5804 NOTICE: ES: Starting UDP Event server on port 9777
14:23:06.607 T:5804 NOTICE: UDP: Listening on port 9777 (ipv6 : true)
14:23:06.739 T:11556 ERROR: EXCEPTION Thrown (PythonToCppException) : –>Python callback/script returned the following error<–
– NOTE: IGNORING THIS CAN LEAD TO MEMORY LEAKS!
Error Type: <type ‘exceptions.ImportError’>
Error Contents: cannot import name None
Traceback (most recent call last):
File “C:\Users\pc\AppData\Roaming\Kodi\addons\plugin.video.covenant\covenant.py”, line 61, in <module>
from resources.lib.indexers import _Xq7mc31Gnv

Identifying the problematic addon is the most important part of this process, read a couple of lines around the error when looking for the cause.

Keep in mind that having lots of addons installed might make this process harder, if you are using a pre-loaded android box is highly advisable that you reinstall Kodi with just the addons you normally use.

What to do when there’s an error

There’s a big chance that someone else already had to deal with the same problem, try googling the error’s description with some relevant keywords like addon name, repository name or developer nickname.

Most addon developers have a way to communicate with their users like twitter, facebook, github or they have a specific thread on a forum, you’ll probably find this information in a readme file inside the addon’s folder or in the addon’s information screen on Kodi.

If you are planing on asking for help on forums, github or the other alternatives there are some things you’ll have to do first. It is very important to enable the debug logging option on Kodi, this will add extra information about Kodi’s status on the log file, the developers need this information to identify and fix the problem.

Open Kodi and select Settings (the cog icon) > System Settings > Logging tab and activate Enable debug logging. You’ll see some text on top of Kodi when debugging is enabled. enable debug logging on Kodi

Now that debug logging is enabled you need to restart Kodi and reproduce the error, this will generate a clean log file with the error description and its respective debugging information. Try going through the steps that lead you to the error.

Log files might contain identifiable information like your device’s username and hostname, some addons could expose your IP address or passwords used on said addons. It’s a good idea to edit all sensible information before sharing your log file.

When sharing your log file, it’s considered a good practice to use pastebin or a similar service to upload your file instead of pasting the file contents directly on a message. Try to describe the error as best as you can and include relevant information like OS and Kodi versions and also the addons you are using.

Troubleshooting Kodi addons is not an easy task, sometimes it’s better to just reinstall the addon, this will fix most of the problems and it’s usually the easiest solution.

There’s an excellent F.A.Q on r/Addons4Kodi’s wiki, it addresses the most common issues and you should definitely give it a look. The official Kodi forum doesn’t support unofficial streaming addons, don’t post questions about grey area addons on the official forum.

More Info:

How to check Kodi’s log file
Tagged on:         

63
Leave a Reply

avatar
49 Comment threads
14 Thread replies
1 Followers
 
Most reacted comment
Hottest comment thread
55 Comment authors
johnvincentBubyJayKaicee92 Recent comment authors
Jess
Jess

Trying to add exodus add on keeps saying check error log. In error log says Python script error the handshake operation timed out. How do I fix this?

Benny
Benny

how do i fix this error how do i fix failed: couldn’t resolve name for http://mirrors.kodi.tv/addons/jarvis/script.cinder/fanart.jpg

GW
GW

Reading this, most apps have this feature built internally and automatically, so that when it states to look into the error log, you have that option available… having to do an add-on is IMHO a stupid step to have to do …

Douglas tubbs
Douglas tubbs

Error control 61 in window 10147 : link resolve failed

Dave
Dave

Looking at the log viewer and it reads ERROR:CGUI Media window::Get directory(plug in://) failed

Mekita
Mekita

How did you fix this Dave, mine is saying the Dane thing

Reem
Reem

Okay how do I fix these errors now?

Amanda Mcgrath
Amanda Mcgrath

won’t do nothing all I am gettin is a black screen. went out of it and back in still nothing. I get constant error messages

Doe
Doe

Nothing comes up, just a black window

9a3bsp
9a3bsp

After looking into error log I’ve noticed UrlResolver is missing?!.
ConfigWizard & reinstalled all addons which fixed all errors for me and everything is working again.
Thanks for hint 🙂

duck10walter
duck10walter

also how do we fix it

duck10walter
duck10walter

looking at log viewer for kodi it shows log but what do we do next

louise
louise

What next when you get in log files

Earle
Earle

So how do I clear the error log on Kodiak now. I have a lot of errors and it doesn’t do anything

Rob Williams
Rob Williams

I followed directions and now I am waiting and waiting for something to show up. I have had many error messages. Does it have to wait while loading them all?

Vena
Vena

What do I do now it says failed I already knew that