Log file/Easy

From Official Kodi Wiki
Jump to navigation Jump to search
Home icon grey.png   ▶ Troubleshooting ▶ Log file ▶ Easy


This method assumes you are able to navigate the menu system of Kodi. If you cannot gain access to the menu system, then you will need to follow the Advanced Method.


Ensure you follow each step in the displayed order.

Note: If you intend to use the Kodi Logfile Uploader Add-on install the add-on now before commencing the steps.

1. Enable Debug Mode by using one of the following methods:
If you have been asked to enable component specific logging see Enable component-specific logging section below.

2. Restart Kodi using one of the options in the Kodi Power Menu.
Do not simply disconnect the power. Doing this may prevent saving the changes you made in the Settings page when you enabled Debug Mode.
When you restart, you should see counters displayed in the top left corner of the screen. If you do not see these counters, then debug mode is not enabled.
Restarting has the following effect:
  • Reduce the size of the log by clearing it and starting fresh
  • It captures the startup that can reveal critical information about the installation. eg graphics cards, audio drivers, versions etc

3. It is important that you now replicate the problem while the log is running. Do whatever you did previously when you experienced the problem.
For example...
  • If you are having problems scraping, then run an Update Library
  • If you are having problems with playback, then try playing the problematic video or music file
  • If you cannot install add-ons, then try installing the add-on.

4. The log must now be uploaded to the Kodi paste site using one of the methods in the next section:

Uploading Methods

Choose one of these methods to upload the log.

Add-on Kodi Logfile Uploader

If you are using this method to upload the log, you may run it now. Once you upload the logfile, you must post the provided url into a post on the forum. Without it, we will be unable to locate your logfile.
By default the add-on only uploads the current kodi.log file. If you need to upload the kodi.old.log, ensure the setting is enabled in the add-ons setting page. Once enabled, you will need to upload the current kodi.log, then upload the kodi.old.log
See: Kodi Logfile Uploader Add-on

File Manager

Log file/File manager access
This page describes another method to access the log file using the Kodi File manager. This method can be used as the fallback option if the Kodi Logfile Uploader is not functioning on your installation. If you are using a desktop type operating system such as Windows, using the Kodi File Manager is not necessary as all files can be accessed through the file browser of the operating system.
Once you have obtained the log, use the Copy and Paste method to upload the log.

Copy and Paste

If you are using a desktop operating system, such as Windows, then you can simply navigate to the Debug Log using the File Manager of the operating system.
Once you find the log...
  1. Open it with any text editor and copy the contents of the file.
  2. Paste the contents to a paste site like http://paste.kodi.tv/, and press the Save icon.
  3. For very large logs, you may need to split the log into two or more pastes. Each paste can hold approx 15,000 lines or 2MB of log.
  4. When the screen refreshes with your paste, copy the entire address in the address bar and paste it into a new message in your post.
Logs are located in the following locations:
Operating System File/Folder Path
Android The folder may differ depending on the device:
  • /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
CoreELEC /storage/.kodi/temp/kodi.log
Flatpak ~/.var/app/tv.kodi.Kodi/data/temp/kodi.log
iOS/tvOS /private/var/mobile/Library/Preferences/kodi.log
LibreElec /storage/.kodi/temp/kodi.log
Linux $HOME/.kodi/temp/kodi.log
macOS /Users/<username>/Library/Logs/kodi.log
Nvidia Shield (SMB) smb://<nvidiashieldurl>/internal/Android/data/org.xbmc.kodi/files/.kodi/temp/kodi.log
OSMC /home/osmc/.kodi/temp/kodi.log
webOS /media/developer/apps/usr/palm/applications/org.xbmc.kodi/.kodi/temp/kodi.log
Windows %APPDATA%\Kodi\kodi.log
Windows Portable <Install location chosen by you>\portable_data\
Windows (UWP) %LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi\kodi.log
Special protocol special://logpath (this can be used by scripts)

iOS Native Sharing

From Kodi v19, accessing the Kodi log file on your iOS device has become a whole lot simpler.

See: iOS native sharing

Enable component-specific logging

Only enable this if you have been specifically asked to enable it.

For more extensive logging, several system components can be selected to put in more detailed debug messages in Kodi's log file. Multiple components can be selected.

Enable the setting Enable component-specific logging in Settings > System Settings > Logging.

Select Specify component-specific logging and select the required components.

The following components are available, depending upon your hardware.

GUI name <setextraloglevel> code
The SMB library 32
The libcURL library (HTTP(S), DAV) 64
The FFmpeg libraries 128
JSON-RPC requests 1024
The Audio component 2048
The Airtunes library 4096
The UPnP components 8192
The libCEC library 16384
The Video component 32768
The Webserver component 65536
The Database component 131072
audio/video timing information 262144
Windowing component 524288
PVR component 1048576
EPG component 2097152
Announce Logging 4194304
WS-Discovery component 8388608
Add-ons component[1] 16777216

Return to top