HOW-TO:Submit a bug report

From Official Kodi Wiki
Revision as of 14:32, 26 September 2008 by >Gamester17
Jump to navigation Jump to search

IMPORTANT!

  1. The normal XBMC log IS NOT a debug log, to enable debug logging you must toggle it on in System Settings. The log (xbmc.log) can be found in the same place as the XBMC executable (like on the Xbox), OR "/var/temp for Linux", OR "~/Library/Logs/" on the Mac, OR, "/mnt/Scratch/Users/frontrow/Library/Logs/" on Apple TV, OR "C:\Documents and Settings\Username\Application Data\XBMC\" under Windows.
  2. Please do not paste logs to the XBMC forums. Use one of the many pasting sites such as pastebin.ca instead and link to it.

How to submit a bug report

  1. First check whether or not there has been a bug reported before, as your bug may already have been fixed or may be in the process of being fixed. Do that by searching on Trac (our tracker-system) to see whether a similar bug report have already been filed or not, (if an existing ticket already exist as is open then add your experiences and logs to that bug report instead of creating a new report). You may also try searching in the XBMC Community Forum to see whether others are having the same problems.

  2. If you're not sure whether it is a legitimate bug then please post on the forums and give as much information as you can, including a debug log.

  3. If you are sure that it is a genuine bug (or the issue have been confirmed by others) then please post a bug report on Trac (our tracker-system). The following information is always essential:
    1. Information as to which platform (operating-system/hardware) and version of XBMC (exact SVN revision) you are running.
    2. Clear steps as to how someone else can reproduce the problem that you see (very few bugs are truly "random", and getting it reproducible by others is 90% on the way to fixing it).
    3. A full _debug log_ of when the error occurs.
    4. Anything else that may be of assistance to developers (eg. screenshots, the skin you are using if not the default PMIII and so on).

  4. Make sure you follow up the bug report with any information that is requested by a developer as soon as possible.

Help with Bug Reports

You can help the XBMC development team keep up with the bug reports by closing duplicates, helping to clarify a reported problem, and confirming that you can reproduce bugs.

You can via our tracking system view the entire list of open bugs, or browse XBMC bugs by various attributes (ones with unreviewed patches, etc).

You may not have permissions to do much at first except comment - which you should feel free to do. You should read GNOME's bug triaging guide for tips on how to best report a bug.