SoftwareHow to & Tips

Video FormatsConvert Video


How to Check Kodi Error Log File to Diagnose and Troubleshoot Problems?

Author by Kevincy

Updated on July 13, 2023

Kodi is not a perfect program. People may run into miscellaneous issues due to different usages, devices and environment, so the solutions are also varied. Nevertheless, Kodi log file will faithfully record all your actions in detail, which plays a critical role in problem troubleshooting and diagnostic. Therefore, let's learn how to check Kodi error log file below.

Why Kodi Log File Is Important to You?

Check & Upload Kodi Error Log FileCheck & Upload Kodi Error Log File

In the course of using Kodi, you will inevitably run into a variety of fail or error messages, such as "Check the log for more information", "Details are not in expected format", "Unable to connect", etc., but you may not know exactly what the problem is. In this case, the existence of Kodi log file provides you with an approach to solving the problem, as it records all operation information from the time you run Kodi to shutdown, which is important for querying historical data, diagnosing problems, and tracking the activities of the software system.

For experienced users, it can be used to analyze and find the problem; while for general users, they can upload the Kodi error log file to the Kodi official forum for help as required, so as to facilitate those people or experts to locate specific error information and offer the most practical and accurate solution. Without further ado, the following content will show you how to check Kodi logfile and how to upload it to Kodi forum.

The guide below is demonstrated in Kodi Leia and likely to be applied to future version, in order to follow the steps seamlessly, you'd better update your Kodi version if it is out of date, or just install the latest version of Kodi on your device.

Warning: You must strictly follow Kodi Forum Rules, if you have banned add-ons installed, you are ineligible for support at the Official Kodi forum, that is, you're not allowed to upload Kodi error log file to forum. Go ahead at your own risk.

How to Manually Check Kodi Log File on Your Devices?

The log file is actually a text-based file. With any text editor/viewer program like Notepad on Windows, you can easily open and check it out. However, you have to find the exact destination path of Kodi logfile, which varies across different devices and operating systems. According to Kodi Wiki, I have compiled all Kodi log locations below so that you can simply locate your log file.

Windows desktop: %APPDATA%\Kodi\kodi.log

iOS/ATV2: /private/var/mobile/Library/Preferences/kodi.log

macOS: /Users/ /Library/Logs/kodi.log

Android: The first folder might be different on various devices:

- /data/org.xbmc.kodi/cache/temp/kodi.log

- /sdcard/Android/data/org.xbmc.kodi/files/.kodi/temp/kodi.log

- /storage/emulated/0/Android/data/org.xbmc.kodi/files/.kodi/temp/kodi.log

Linux: $HOME/.kodi/temp/kodi.log

Raspberry Pi: /storage/.kodi/temp/kodi.log

CoreELEC: storage/.kodi/temp/kodi.log

Windows store (UWP): %LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi\kodi.log

Special protocol: special://logpath (this can be used by scripts)

How to Automatically Locate and Check Log File with Kodi Add-on?

As a general user, if you're not tech-savvy or have very little knowledge about your devices, it's a bit difficult to find out the log file. Fortunately, to get out of this dilemma, you can directly view the log file on Kodi by means of an official add-on - Log Viewer for Kodi which comes with the Kodi latest version by default. Here are the installation steps below.

Step 1. Launch Kodi app on your device, click on or tap "Add-ons" on the left menu bar of Kodi Home screen.

Add-on Menu

Step 2. Click on the "opened box" icon and enter the "Add-on browser".

Go to Add-on Browser

Step 3. Select "Install from repository" option.

Install from Repository

Step 4. Choose "Kodi Add-on repository" right there, which contains all Kodi Official add-ons that have undergone basic testing and offer stable and reliable updates.

Kodi Add-on Repository

Step 5. Go to "Program add-ons" category.

Open Program Add-ons

Step 6. Scroll down the list and click on "Log Viewer for Kodi" add-on.

Kodi Log Viewer

Step 7. Press "Install" to start the download and installation process.

Install Kodi Log Viewer

Step 8. Wait a moment till the notification appears in the upper right corner.

Add-on Installed

Step 9. Go to Program add-ons and run "Log Viewer for Kodi".

Run Log Viewer for Kodi

Step 10. It will display 3 options: "Show Log", "Show old Log", "Settings". For the first time you run this add-on, go to Settings and make the changes based on your preferences. Click OK to save the settings.

Select Settings

Customize and Save Settings

For "kodi.log" and "kodi.old.log", which Log you should choose? That depends...

- Select kodi.log, if the log has captured the problem and you have not restarted Kodi.

- Select kodi.old.log, if the log has captured the problem and you have restarted Kodi (includes the crash).

Step 11. View your kodi.log or kodi.old.log with ease.

View Kodi Log

How to Enable Debug Logging and Upload Kodi Error Log to Official Forum?

If you're suffering from unexpected problems resulted from Kodi or a certain add-on, why not get timely help from some masters and experts on support forum? In this case, you're required to upload and post the Debug Log file.

However, DO NOT rudely post your logs directly into the forum, as you know, the full log information is always too long (no partial logs or snippets, provide FULL logs only). So the gentle method is that you're supposed to upload the debug log information to or, generate a short link, then post the link to the forum.

Sounds cumbersome? Luckily for you, there is also a terrific official add-on - Kodi Logfile Uploader that can help you do it in a click. Now let's see how to enable the debug logging mode and upload the debug logfile.

Step 1. Run Kodi app, press the cog icon in the upper left corner.

Go to Settings Interface

Step 2. On Settings interface, go to "System" category.

Go to System Category

Step 3. Hover mouse over "Logging" on the left side, switch on "Enable Debug logging" option. After that, you'll see the log location and information at the top-left corner.

Enable Debug Logging

Step 4. Follow Step 1 - Step 5 above, find and install "Kodi Logfile Uploader" add-on in "Kodi Add-on repository".

Install Kodi Logfile Uploader

Step 5. Now, in the debug logging mode, reproduce the error or problem you got. It will add additional information about the issue to Kodi error log. Next, you're ready to update and share the Kodi debug log file.

Recur Problems

Reproduce Error

Step 6. Go to "Add-ons" > "Program add-ons", and run "Kodi Logfile Uploader".

Run Logfile Uploader

Step 7. You'll be asked to upload or view the logfile. Select "upload" to automatically upload it to and returns an URL and QR code so that you can conveniently post it on Kodi support forum for help.

Select Upload

An URL and QR Code

At last...

That's all about how to fix log file error on Kodi. Have you got it? In addition to Kodi official add-ons, some third-party maintenance tools also work like a charm, such as Indigo and Ares Wizard, which provides a much simpler process to do the job. You may give them a try if you're interested. Anyway, I hope this post is helpful for you to analyze and troubleshoot your Kodi problems. If it deserves your thumb-up, don't hesitate to share on your social media.

More Related Articles

Guide on How to Add Addons to Kodi Leia on Windows PC How to Enable the Installation of Addon from Unknown Sources on Kodi How to Download Videos from The Crew Addon with Ease?
Step-by-step Guide on How to Adopt External Video Player for Kodi Two Simple Methods to Change Language in Kodi How to Set Kodi Password to Protect Your Privacy and Private Content?