Troubleshooting: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>UNiversal
mNo edit summary
No edit summary
(37 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<div style="background-color:#cedff2; font-size:120%; border:1px solid #a3b0bf; color:#000;padding:0.2em 0.4em;">[[File:star.png|link=|caption]] '''Troubleshooting'''</div><br />
{{mininav}}


Always a good idea to get a [[debug log]] (remember to enable [[Settings/System#Debugging|debugging]]) while you are troubleshooting.


==Platform specific troubleshooting FAQs==
<section being="intro" />Experiencing difficulties with {{kodi}}? Then this page will guide you to information that may assist. Use this page as a jumping off point and if you cannot find a solution, there is always the forum to fallback to.<section end="intro" />
* [[Android FAQ#Troubleshooting]]
* [[iOS FAQ#Troubleshooting]]
* [[Linux FAQ#Troubleshooting]]
* [[Mac FAQ #Troubleshooting]]
* [[Windows FAQ#Troubleshooting]]


* [[Raspberry Pi FAQ#Troubleshooting]]


==Effective Troubleshooting Tactics==
===Isolate the Problem===
Before writing a bug report, it is advisable to try and find the source of the bug.  There are two good ways to do this:
# Temporarily remove user data
# Temporarily uninstall an add-on
If, for example, you remove an add-on and the bug still occurs, then that add-on is not the source of the bug.  If there is no problem after temporarily removing the component in question, then you have narrowed down the source of the bug.  Doing this will help the developers find and fix the bug faster.
 
===Update and Upgrade===
Before writing a bug report, make sure that the add-on you are using, or the XBMC itself, is fully updated to the newest version.  It is entirely possible that the problem is fixed in the most recent versions of the add-on and/or the XBMC.  The add-on support section of the forum contains information and help with the XBMC add-ons.  There may be versions of add-ons that are not officially added to the repository that fix the problem. 


===Test on Multiple Devices===
= First Time User =
Reproducing the bug on multiple devices will determine whether or not the source of the bug is the user’s hardware or the XBMC itself.  Testing the bug on multiple devices before submitting the bug report can isolate the source of the problem and help determine whether or not the developers can fix it.  This tactic also greatly reduces the confusion that can occur when others try to reproduce the bug.  Depending on the hardware involved with the bug, the user should reproduce the bug on second devices including, but not limited to:
If you are a first time user of {{kodi}} and are just generally lost and not sure how to operate {{kodi}}, then start with the '''''[[First time user]]''''' pages. Also check out the '''''[[FAQs]]''''' page.
*Computers
*Televisions
*TV remotes
*Blu-Ray or DVD players
*Xbox 360 controllers
If the bug is successfully reproduced on at least two devices, then it is more likely that there is a problem with the XBMC.


==Reporting bugs and errors==
 
= Audio Troubleshooting =
{{list|Audio troubleshooting}}
 
 
 
= Video Library Troubleshooting =
{{list|Incorrect and missing videos}}
 
 
 
= Debug Logs =
{{list|Log file}}
 
 
 
= Test files and samples =
{{See|Samples}}
Various samples that are useful for testing or trying to reproduce possible issues.
 
 
 
= Video levels and color space =
{{See|Video levels and color space}}
Information about video levels, color space, and calibration, for video.
 
 
 
= Effective Troubleshooting =
Steps that should be used to try and rectify issues.
 
;Isolate the Problem
:Before writing a bug report or asking questions in the forum, it is advisable to try and find the source of the bug. There are two good ways to do this depending on the problem:
:# Temporarily remove user data (Fresh Start)
:# Temporarily uninstall an add-on
:Now test if the problem remains.
 
:Windows users have the benefit of being able to install multiple copies of {{kodi}} using '''''[[HOW-TO:Install_Kodi_for_Windows#Portable_Mode|Portable Mode]]'''''. Install a fresh copy and see if the issue persists.
 
; Update and Upgrade
:Before writing a bug report, make sure that the add-on you are using, or {{Kodi}} itself, is fully updated to the latest official version.  It is entirely possible that the problem is fixed in the most recent versions of the add-on and/or {{Kodi}}.  The add-on support section of the forum contains information and help with {{Kodi}} add-ons.  There may be beta versions of add-ons that are not officially added to the repository that fix the problem.
 
; Test on Multiple Devices
:Reproducing the bug on multiple devices will determine whether or not the source of the bug is the user’s hardware or {{Kodi}} itself.  Testing the bug on multiple devices before submitting the bug report can isolate the source of the problem and help determine whether or not the developers can fix it.  This tactic also greatly reduces the confusion that can occur when others try to reproduce the bug.
 
 
 
= Reporting bugs and errors =
{{See|HOW-TO:Submit a proper bug report}}
{{See|HOW-TO:Submit a proper bug report}}


==Getting more help==
* [http://forum.xbmc.org/forumdisplay.php?f=33 Help and Support forums]
* [irc://irc.freenode.org/xbmc #xbmc] - [[w:IRC|IRC]] chat channel on irc.freenode.org


==See also==
*[[HOW-TO:Submit a proper bug report]]
*[[Log file]]
*[[Bug tracker]]


[[Category:XBMC Manual]]
= Getting more help =
* [https://forum.kodi.tv/ Help and Support forums]
* [irc://irc.freenode.org/kodi #kodi] - [[w:IRC|IRC]] chat channel on irc.freenode.org
 
 
 
== Asking questions in a smart way ==
<section begin="how to ask a question"/>[http://catb.org/~esr/faqs/smart-questions.html How to ask questions in a smart way?]:
* '''When you ask:'''
** Use meaningful Titles on posts. Don't ask the question in the post title.
** If English is a second language for you, then clearly state that in the post.
** Be clear, precise and informative about your question and problem
** Provide the link to your '''''[[Log_file|Debug Log]]''''' uploaded to a public Pastebin type site. We recommend to use http://paste.kodi.tv
** Include screenshots to aid in problem description.
** Write clearly, with correct use of punctuation and paragraphs. Too much text will put people off reading it. Too little and people won't bother.
** Don't ask people to reply by private e-mail or private message.
** Courtesy never hurts, and sometimes helps.
** Follow up with a brief note on the solution if you find one <section end="how to ask a question"/>
 
 
 
== No Response ==
It is important to remember that {{kodi}} is entirely a '''Volunteer''' project and nobody works on this as a full time job. This project is merely a very successful hobby for the developers. The forum is not a paid help service and the Moderators are also volunteers.
 
While the Team tries to provide assistance, it is not always possible to respond to every post personally. For that we rely on the devoted community of users. If you find that neither a Team-Member nor a Community Member has responded to your post, then there may be something wrong with your post. Some common errors include:
* The question was too vague with little or no information provided
* The question was too off-topic and is not a {{kodi}} problem
* The question has been answered so many times previously, that members are annoyed you have not done a basic search for the answer
* The post may come across as rude, demanding, insulting or just generally unappreciative
 
Ensure you don't fall into any of the above categories.
 
 
 
= See also =
* [[Development builds]]
* [[Log file|Debug Log]]
* [[Bug tracker]]
 
 
 
 
 
{{Top}}
 
{{updated|18}}
[[Category:FAQ]]
[[Category:Index]]
[[Category:Guides]]
[[Category:Manual]]
[[Category:Karellen]]
[[Category:First time user]]
[[Category:Advanced topics]]
[[Category:Troubleshooting]]

Revision as of 08:32, 2 October 2018

Home icon grey.png   ▶ Troubleshooting


Experiencing difficulties with Kodi? Then this page will guide you to information that may assist. Use this page as a jumping off point and if you cannot find a solution, there is always the forum to fallback to.


First Time User

If you are a first time user of Kodi and are just generally lost and not sure how to operate Kodi, then start with the First time user pages. Also check out the FAQs page.


Audio Troubleshooting

Audio troubleshooting
This page describes some of the steps you can take to troubleshoot audio problem and gives background information on audio concepts as a foundation for understand why some things work as they do.


Video Library Troubleshooting

Incorrect and missing videos
No scraper is 100% accurate. Errors arise from either mistakes by the user, inherent limitations of the scraper, and/or errors at the site of the information provider. If you have followed the guide, the errors you encounter will be minimal. For those errors that do occur, this page will help correct them. Sorry, but we cannot fix stubborness or laziness for those that refuse to fix their file naming problems.


Debug Logs

Log file
The Debug Log is Kodi's most basic diagnostic tool that assists in fault finding and troubleshooting. Kodi records a process and error log at all times, but this may not be sufficent and more detail is required. The Debug Log records additional data that may assist in resolving issues experienced by the user. The Easy and Advanced methods are the two options to create the Debug Log. The method you choose will depend on your requirements.


Test files and samples

See: Samples

Various samples that are useful for testing or trying to reproduce possible issues.


Video levels and color space

See: Video levels and color space

Information about video levels, color space, and calibration, for video.


Effective Troubleshooting

Steps that should be used to try and rectify issues.

Isolate the Problem
Before writing a bug report or asking questions in the forum, it is advisable to try and find the source of the bug. There are two good ways to do this depending on the problem:
  1. Temporarily remove user data (Fresh Start)
  2. Temporarily uninstall an add-on
Now test if the problem remains.
Windows users have the benefit of being able to install multiple copies of Kodi using Portable Mode. Install a fresh copy and see if the issue persists.
Update and Upgrade
Before writing a bug report, make sure that the add-on you are using, or Kodi itself, is fully updated to the latest official version. It is entirely possible that the problem is fixed in the most recent versions of the add-on and/or Kodi. The add-on support section of the forum contains information and help with Kodi add-ons. There may be beta versions of add-ons that are not officially added to the repository that fix the problem.
Test on Multiple Devices
Reproducing the bug on multiple devices will determine whether or not the source of the bug is the user’s hardware or Kodi itself. Testing the bug on multiple devices before submitting the bug report can isolate the source of the problem and help determine whether or not the developers can fix it. This tactic also greatly reduces the confusion that can occur when others try to reproduce the bug.


Reporting bugs and errors

See: HOW-TO:Submit a proper bug report


Getting more help


Asking questions in a smart way

How to ask questions in a smart way?:

  • When you ask:
    • Use meaningful Titles on posts. Don't ask the question in the post title.
    • If English is a second language for you, then clearly state that in the post.
    • Be clear, precise and informative about your question and problem
    • Provide the link to your Debug Log uploaded to a public Pastebin type site. We recommend to use http://paste.kodi.tv
    • Include screenshots to aid in problem description.
    • Write clearly, with correct use of punctuation and paragraphs. Too much text will put people off reading it. Too little and people won't bother.
    • Don't ask people to reply by private e-mail or private message.
    • Courtesy never hurts, and sometimes helps.
    • Follow up with a brief note on the solution if you find one


No Response

It is important to remember that Kodi is entirely a Volunteer project and nobody works on this as a full time job. This project is merely a very successful hobby for the developers. The forum is not a paid help service and the Moderators are also volunteers.

While the Team tries to provide assistance, it is not always possible to respond to every post personally. For that we rely on the devoted community of users. If you find that neither a Team-Member nor a Community Member has responded to your post, then there may be something wrong with your post. Some common errors include:

  • The question was too vague with little or no information provided
  • The question was too off-topic and is not a Kodi problem
  • The question has been answered so many times previously, that members are annoyed you have not done a basic search for the answer
  • The post may come across as rude, demanding, insulting or just generally unappreciative

Ensure you don't fall into any of the above categories.


See also



Return to top