Things we want from EVERY report: checklist
- Complete Debug log (wiki) (Use your favourite paste site! See below.) << NOT OPTIONAL!
- If you can, get screenshots to illustrate problems (See below)
- Latest is not a revision, of anything! (See below)
- Linux Distribution and version (See below)
- Hardware (e.g.. i686, x86_64, GPU (See below)
- Install Method (PPA, RPM, build.sh, manual, other)
- Determining GIT revision (See below.)
- Troubleshooting 101 - Determining if a addon or skin is causing the issue (See below)
- Detailed instructions to reproduce the problem (The more specific the better.)
- Backtrace (Only attainable if Kodi has crashed. See below.)
- Compiler output (Only useful if Kodi doesn't build. See below.)
- Skin name
- Video codec and container.
- Audio codec and container.
- You may also be asked for a sample. << Use sites like Dropbox, Mediafire or your favourite hosting site and do not post copyrighted materials.
- System hardware specs (CPU, GPU, Chipset, etc.)
- Kernel Version
When referring to the version of something, always be as detailed as possible. Saying you're using the latest version of something is wrong the second it is updated, and completely useless to someone looking for help on a similar problem in the future. (NOTE: It is perfectly fine to tell someone to upgrade to the latest version of something as this is nearly always a good idea.) Some good examples:
- Ubuntu 14.04 up to date as of 2015-06-29
- Kodi for OSX v15.1
- libsmbclient 3.0.27
How do I find my GIT revision number?
From home screen in default Confluence skin... (also in any kodi.log)
- Navigate to SYSTEM
- Choose "System Info" (submenu item)
- GIT Revision is at the bottom of each page (Kodi 16.0-"tag" Git:20130104-de8789a)
Troubleshooting 101 - Determining if a addon or skin is causing the issue
Sometimes Kodi issues are directly or indirectly related to a particular skin or addon. A fast way to rule out such issues is to rename the addons folder and userdata (wiki) folder and restart kodi. (same as a fresh installation)
Alternative solution is to disable all 3rd party addons / skins (including ones in default repository) and use default skin, if issue persists you have likely found a bug with Kodi.
If you already taken this step or reinstalled Kodi and are using a clean install, say so
- Disable any addons (if a addon is part of a skin dependency you have to disable the skin first and then disable the addon)
- Disable the skin (in case you're using a 3rd party skin and the issue is not skin related)
- Try to duplicate issue if issue persists you found a Kodi bug. Else enable one addon at a time and try to duplicate the issue, when issue reappears you found the causing addon.
Where is my debug log?
- Read debug_Log (wiki) thoroughly.
- Don't forget to enable debugging! (Try to obtain a clean debug log, enable debugging, restart Kodi, duplicate issue and finally pastebin the complete debug log)
- Don't forget to use a paste site!
sudo apt-get install pastebinit -y
cat $HOME/.kodi/temp/kodi.log | pastebinit
This is also available and automatically appended together in a Kodi crashlog when gdb is already installed and you allow stack traces to be generated. In that case pastebin the crashlog directly.
- Open terminal
- Run "ulimit -c unlimited" (You only need to do this if no core file is created automatically)
- Run "kodi"
- Reproduce the crash.
- Install gdb if you don't have it "sudo apt-get install gdb"
- Run "gdb /path/to/kodi.bin /path/to/core" (kodi.bin path is in the debug log (see above), core file should be in the current directory (may have the process ID number appended))
- Once gdb has loaded up type "thread apply all bt" and press enter.
- Press return until you're back at the prompt then copy and paste the output to your favourite paste site.
- Type "q" then enter to quit gdb.
- Delete the core file to avoid confusion later.
First things first, wait 24hrs. Just as the police don't care if your kids are missing, we don't care if you can't compile! Kodi is in a constant state of flux and it is very likely that any compile errors will be resolved in a much shorter time than this. That being said, what not to post. "make: *** [some target] Error #", I'm sure we can all agree that this tells us nothing other than something bad happened while building "some target", so don't waste your time posting it.
Now, there probably isn't actually a problem. Try this from a terminal.
git clean -xfd && git reset --hard && git pull --rebase
It is also helpful to pastebin the config.log with any compile issue reports especially where dependency issues are reported. Again full logs only with refrence to specific lines or output with report.
Screenshot sites:File Hosting sites: