Troubleshooting: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
(Add Scraping troubleshooting)
Line 2: Line 2:
{{see also|Log file|Bug tracker}}
{{see also|Log file|Bug tracker}}
It is always a good idea to get a [[debug log]] (remember to enable [[Settings/System#Debugging|debugging]]) while you are troubleshooting.
It is always a good idea to get a [[debug log]] (remember to enable [[Settings/System#Debugging|debugging]]) while you are troubleshooting.


== Platform specific troubleshooting FAQs ==
== Platform specific troubleshooting FAQs ==
Line 11: Line 13:
* [[Raspberry Pi FAQ#Troubleshooting]]
* [[Raspberry Pi FAQ#Troubleshooting]]


== Audio troubleshooting ==
 
 
== Audio Troubleshooting ==
{{See|Audio troubleshooting}}
{{See|Audio troubleshooting}}
== Video Library Troubleshooting ==
{{See|Incorrect and missing videos}}


== Effective Troubleshooting Tactics ==
== Effective Troubleshooting Tactics ==
Steps that should be used to try and rectify issues.
=== Isolate the Problem ===
=== 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:
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:
Line 21: Line 36:
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.
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 ===
=== Update and Upgrade ===
Before writing a bug report, make sure that the add-on you are using, or the Kodi 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 Kodi.  The add-on support section of the forum contains information and help with the Kodi add-ons.  There may be versions of add-ons that are not officially added to the repository that fix the problem.   
Before writing a bug report, make sure that the add-on you are using, or the Kodi 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 Kodi.  The add-on support section of the forum contains information and help with the Kodi 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 ===
=== Test on Multiple Devices ===
Line 32: Line 51:
* Xbox 360 controllers
* 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 Kodi.
If the bug is successfully reproduced on at least two devices, then it is more likely that there is a problem with the Kodi.


== Reporting bugs and errors ==
== Reporting bugs and errors ==
{{See|HOW-TO:Submit a proper bug report}}
{{See|HOW-TO:Submit a proper bug report}}


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


=== How do I ask a question in a smart way? ===
=== How do I ask a question in a smart way? ===
Line 56: Line 81:
** Courtesy never hurts, and sometimes helps.
** 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"/>
** Follow up with a brief note on the solution if you find one<section end="how to ask a question"/>


== Test files and samples ==
== Test files and samples ==
{{See|Samples}}
{{See|Samples}}
Various samples that are useful for testing or trying to reproduce possible issues.


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


== Video levels and color space ==
== Video levels and color space ==
{{See|Video levels and color space}}
{{See|Video levels and color space}}
Information about video levels, color space, and calibration, for video.


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


== See also ==
== See also ==
Line 76: Line 105:
[[Category:Manual]]
[[Category:Manual]]
[[Category:General topics]]
[[Category:General topics]]
[[Category:Troubleshooting|*]]
[[Category:Troubleshooting]]

Revision as of 22:25, 1 May 2018

Home icon grey.png   ▶ Troubleshooting

It is always a good idea to get a debug log (remember to enable debugging) while you are troubleshooting.


Platform specific troubleshooting FAQs


Audio Troubleshooting

See: Audio troubleshooting


Video Library Troubleshooting

See: Incorrect and missing videos


Effective Troubleshooting Tactics

Steps that should be used to try and rectify issues.


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:

  1. Temporarily remove user data
  2. 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 Kodi 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 Kodi. The add-on support section of the forum contains information and help with the Kodi 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

Reproducing the bug on multiple devices will determine whether or not the source of the bug is the user’s hardware or the 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. Depending on the hardware involved with the bug, the user should reproduce the bug on second devices including, but not limited to:

  • 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 Kodi.


Reporting bugs and errors

See: HOW-TO:Submit a proper bug report


Getting more help


How do I ask a question in a smart way?

How to ask questions in a smart way?:

  • When you ask:
    • Use meaningful, specific subject headers on posts.
    • Be explicit about your question.
    • Provide a Debug Log uploaded to a public Pastebin type site. Then copy the link into your post
    • Do not paste logs directly into the forum.
    • Be precise and informative about your problem.
    • Include screenshots to aid in problem description.
    • Describe the problem's symptoms, not your guesses.
    • Describe your problem's symptoms in chronological order
    • Describe the goal, not the step.
    • Write clearly, with correct use of punctuation and paragraphs.
    • 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


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.


See also