Log file/Easy
![]() |
![]() |
![]() |
![]() |
Introduction
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.
Steps
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: |
---|
- Enable the setting Enable debug logging in the settings page located at Settings > System Settings > Logging
- Pressing ctrl+⇧ Shift+d on a keyboard
- Create an entry in the advancedsettings.xml file. See: Advanced Method
- 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
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...
- Open it with any text editor and copy the contents of the file.
- Paste the contents to a paste site like http://paste.kodi.tv/, and press the Save icon.
- 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.
- 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:
|
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 |
---|