Troubleshooting: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 32: Line 32:
===IRC===
===IRC===


 
==See also==
----
*[[HOW-TO:Submit a proper bug report]]
{{editor note|Some raw notes about what this should include: Talk about how to isolate issues, temp remove userdata folder, temp remove add-ons, etc to help isolate issues. Talk about upgrading various add-ons or XBMC itself, or searching the add-on support forum for newer versions not available on the repos. Talk about trying to replicate issues on a second computer. Maybe have a section on networking specifically. The differences between this and "how to send a proper debug report" etc is this page is more for helping people use simple solutions to solve problems themselves, or even to just isolate the issue for the debug report.}}
*[[Log file]]

Revision as of 20:47, 22 May 2012

Incomplete.png INCOMPLETE:
This page or section is incomplete. Please add information or correct uncertain data which is marked with a ?

Template:XBMC wiki toc Before starting troubleshooting it's always a good idea to enable Debug-Mode for Debug-Logging in XBMC.
This debug-mode provides more detailed info on what's going on, and it can be enabled like this.

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:

  1. Temporarily remove user data
  2. Temporarily uninstall an addon

If, for example, you remove an addon and the bug still occurs, then that addon 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 addon 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 addon support section of the forum contains information and help with the XBMC addons. There may be versions of addons 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 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:

  • 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

See: HOW-TO:Submit a proper bug report

Getting help

Forum

IRC

See also