Difference between revisions of "Log file/Easy"

From Official Kodi Wiki
Jump to navigation Jump to search
m (remove ubuntu paste)
 
(16 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{mininav| [[Troubleshooting]] | [[HOW-TO:Submit a bug report]] | [[Log file]] }}
{{mininav| [[Troubleshooting]] | [[Log file]] }}
__FORCETOC__


== Instructions ==
{{big|'''Someone has asked you for a debug log (aka log file, kodi.log, etc). This is what they want you to do:'''}}


{{Note| This if for Krypton (v.17) and above and assumes that you are using the Estuary skin (default skin)}}
= Introduction =
<section begin="intro" />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 '''''[[Log_file/Advanced|Advanced Method]]'''''.<section end="intro" />


<span style="font-size:2em;line-height:100%;">Provide FULL Logs only. No Partial logs or snippets</span>




{| class="prettytable" style="font-size:1.5em;line-height:150%;"
= Steps =
Ensure you follow each step in the displayed order.
 
'''Note:''' If you intend to use the '''''[[Add-on:Kodi_Logfile_Uploader| Kodi Logfile Uploader Add-on]]''''' install the add-on '''now''' before commencing the steps.
 
 
{| class="prettytable" style="width:70%"
|-
|-
! style="font-size:2.5em;" | 1
! scope="row" ! style="background-color:#b8ecff; text-align:left;"|1. Enable Debug Mode by using one of the following methods:
| '''Download the Debug log uploader add-on:'''<br /> From the Main menu, navigate to the menu item {{highlight|bordered=yes|Add-ons}} & from the top of the Add-ons menu select {{highlight|bordered=yes|Install from repository}} box,  in the next page select {{highlight|bordered=yes|Kodi Add-on repository → Program add-ons → Kodi Logfile Uploader}} then select {{highlight|bordered=yes|Install}}
|}
<section begin="EnableDebugMode" />:* Enable the setting '''Enable debug logging''' in the settings page located at '''''[[Settings/System/Logging#Debug|Settings > System Settings > Logging]]'''''
:* Pressing {{keypress|ctrl|shift|d}} on a keyboard
:* Create an entry in the '''''[[Advancedsettings.xml#loglevel|advancedsettings.xml]]''''' file. See: '''''[[Log_file/Advanced|Advanced Method]]'''''<section end="EnableDebugMode" />
 
:If you have been asked to enable component specific logging see '''''[[Log_file/Easy#Enable_component-specific_logging|Enable component-specific logging]]''''' section below.
 
 
{| class="prettytable" style="width:70%"
|-
|-
! style="font-size:2.5em;" | 2
! scope="row" ! style="background-color:#b8ecff; text-align:left;"|2. Restart {{Kodi}} using one of the options in the {{kodi}} Power Menu.
| '''Turn debugging on:'''<br /> From the Main menu, select {{highlight|bordered=yes|Settings (gear icon at top of the menu) → System Settings → Logging}} and turn on {{highlight|bordered=yes|Enable debug logging}}. You will see some weird text pop up on the screen.
|}
: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


{{small| {{Note| Sometimes you might be asked to enable additional debug logging "components", which is an option in this same Settings/System/Debugging area. If you were not asked to enable anything extra, then don't worry about those additional settings. }} }}
 
{| class="prettytable" style="width:70%"
|-
|-
! style="font-size:2.5em;" | 3
! scope="row" ! style="background-color:#b8ecff; text-align:left;"|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.  
| '''Restart Kodi:'''<br /> so that the log file records important startup information.
|}
|-
:For example...
! style="font-size:2.5em;" | 4
 
| '''Reproduce whatever issue/bug you are reporting on.'''<br /> If a bug happened when you played a movie, play a movie. If something weird popped up on the screen when you went into an add-on, go into that add-on. Etc. If the issue doesn't require action (the problem happens when you open Kodi, etc) then go to the next step.
:* 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
! style="font-size:2.5em;" | 5
:* If you cannot install add-ons, then try installing the add-on.
| '''If you use passwords or logins in add-ons:'''<br /> You will probably need to edit your log before you upload it. Don't use the rest of the steps here and instead see '''[[#Removing passwords|here]]''' for further instructions.  
|-
! style="font-size:2.5em;" | 6
| '''Upload your debug log:'''<br /> On the Main menu, navigate to {{highlight|bordered=yes|Add-ons → Program addons → Kodi Logfile Uploader}} and select it.  Once the addon is finished uploading, it will show a message which includes the paste URL, it will be in this format ''<code><nowiki>http://paste.ubuntu.com/########/</nowiki></code>'', write this down and post it in the thread were it was asked for.
{{small| {{note|If you don't get a window pop up with an ID number, then the paste site might be down and you might need to manually copy/paste your log file to http://pastebin.com instead. See '''[[Log file/Advanced#Location]]''' for how to locate the log file manually. }} }}




'''If Kodi crashes:'''<br /> If your issue involves Kodi crashing then you need to do an additional step. From the Main menu, navigate to  {{highlight|bordered=yes|Add-ons}} then to {{highlight|bordered=yes|Program add-ons → Kodi Logfile Uploader}}, but do NOT select it.  Then bring up the context menu (press {{keypress|C}} on a keyboard or long press {{button|Enter/OK}} on a remote) and select {{highlight|bordered=yes|Settings}}. Then check "Post the old logfile, from the previous time Kodi ran". If you're using Linux, OSX or iOS, also check the "Post the crashlog" option. Now it will upload the debug log of when Kodi crashed (the previous run) and optionally the crashlog as well.
{| class="prettytable" style="width:70%"
|-
|-
! style="font-size:2.5em;" | 7
! scope="row" ! style="background-color:#b8ecff; text-align:left;"|4. The log must now be uploaded to a [[w:Pastebin|Pastebin]] type site using one of the methods in the next section:
| '''Copy the URL'''<br /> Note the URL you see in the popup and paste it to the forum post or give it to whoever asked you for the debug log. If Kodi had crashed during your log, be sure to include the URL for the "old log" (and crashlog) file. {{note|Never copy/paste the log file itself into a forum post. Just post the URL.}}
|-
! style="font-size:2.5em;" | 8
| '''You're done'''<br /> You can turn off debugging now.
|}
|}




= Uploading Methods =
Choose one of these methods to upload the log.
<div style="margin-left: 4em;">
== 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: [[Add-on:Kodi_Logfile_Uploader| Kodi Logfile Uploader Add-on]]'''''
== File Manager ==
{{list|Log file/File manager access}}
:Once you have obtained the log, use the Copy and Paste method to upload the log.
::'''''See: [[Log_file/File_manager_access| Kodi Logfile Uploader Add-on]]'''''
</div>
<div style="margin-left: 4em;">
== Copy and Paste ==
<section begin="CopyAndPaste" />: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.
:#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: <section end="CopyAndPaste" />
:{{LogfilePath}}
</div>
<div style="margin-left: 4em;">
== iOS Native Sharing ==
From Kodi v19, accessing the {{Kodi}} log file on your iOS device has become a whole lot simpler.
::'''''See: [[Log_file/iOS_native_sharing | iOS native sharing]]'''''
</div>


== Removing passwords ==
{{log file password warning}}


See '''[[Log file/Advanced#Location]]''' for how to locate the log file manually. Then just open that xbmc.log (or kodi.log) file in a text editor. If you do not see passwords in your log then you can keep using the instructions on this page for using the debug log uploader add-on. If you see passwords, remove them and then manually copy and paste the log onto a pastebin site, like http://xbmclogs.com or http://pastebin.com , and then give that URL to whoever you need to share your log with. (or see '''[[Log file/Advanced#So what do I do with this thing?]]''')


= 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.


== Kodi Is Unresponsive ==
Enable the setting '''''Enable component-specific logging''''' in '''''[[Settings/System/Logging#Debug|Settings > System Settings > Logging]]'''''.
If you cannot control {{kodi}}, such as a remote control not working, or if {{kodi}} crashes before you can upload a log with the log uploader add-on, or can otherwise have issues following these steps, then you will need to manually enable debug logging and manually paste/upload a log to a pastebin-type website.  


For enabling logging see: '''[[Log file/Advanced#advancedsettings.xml]]'''
Select '''''Specify component-specific logging''''' and select the required components.


For manually locating the log file (xbmc.log or kodi.log) file see: '''[[Log file/Advanced#Location]]'''
<gallery mode="packed" widths="600px" heights="384px">
File:Settings-System-Logging-01.jpg
File:Component-logging-selection.jpg
</gallery>


Then finally, see '''[[Log file/Advanced#So what do I do with this thing?]]''' for how to paste it to a pastebin-type website
'''The following components are available, depending upon your hardware.'''
<section begin="ComponentValues" />
{| class="prettytable"
! scope="row" ! style="width:270px; | GUI name || ! scope="row" ! style="width:250px; | <setextraloglevel> code
|-
| The SMB library || style="text-align:center;" | 32
|-
| The libcURL library (HTTP(S), DAV) || style="text-align:center;" | 64
|-
| The FFmpeg libraries || style="text-align:center;" | 128
|-
| JSON-RPC requests || style="text-align:center;" | 1024
|-
| The Audio component || style="text-align:center;" | 2048
|-
| The Airtunes library || style="text-align:center;" | 4096
|-
| The UPnP components || style="text-align:center;" | 8192
|-
| The libCEC library || style="text-align:center;" | 16384
|-
| The Video component || style="text-align:center;" | 32768
|-
| The Webserver component || style="text-align:center;" | 65536
|-
| The Database component || style="text-align:center;" | 131072
|-
| audio/video timing information || style="text-align:center;" | 262144
|-
| Windowing component || style="text-align:center;" | 524288
|-
| PVR component || style="text-align:center;" | 1048576
|-
| EPG component || style="text-align:center;" | 2097152
|-
| Announce Logging || style="text-align:center;" | 4194304
|-
| WS-Discovery component || style="text-align:center;" | 8388608
|}
<section end="ComponentValues" />






== Uploading Using File Manager ==
{{see|Log file/File manager access}}






== More info ==
For more info about the debug log see '''[[Log file/Advanced]]'''.


{{Updated|16}}
{{Top}}
{{updated|19}}


[[Category:Manual]]
[[Category:Karellen]]
[[Category:Troubleshooting]]
[[Category:Troubleshooting]]

Latest revision as of 23:00, 4 January 2022

Home icon grey.png   ▶ Troubleshooting ▶ Log file ▶ Easy


1 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.


2 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:
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 a Pastebin type site using one of the methods in the next section:


3 Uploading Methods

Choose one of these methods to upload the log.

3.1 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


3.2 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.
See: Kodi Logfile Uploader Add-on


3.3 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.
  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
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
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)


3.4 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


4 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





Return to top