Common issues

Kodi releases are brought to a stable point where most users should not have issues. However, due to Kodi's large, complex, and multi-platform nature, it is nearly impossible to release a totally bug-free version. As such, these are some of the more common issues that are known about in Kodi.

For a more complete list of possible bugs/issues see the Kodi Trac bug tracker. For reporting bugs see HOW-TO:Submit a bug report.

General

 * When using UPnP library sharing between Kodi instances:
 * The watched/resume status for TV shows/episodes doesn't update on the "client" Kodi instance until Kodi is restarted.
 * If you have a TV show that has watched episodes and unwatched episodes, the entire TV show will be hidden if "hide watched" is turned on.
 * Mplayer style EDLs (.edl) don't work well when stepping back or forward in v13.
 * Fixed in v15
 * Fixed in v14.1
 * Removed in v15


 * Non-Kodi issues
 * AirPlay Mirroring and any AirPlay function that involves DRM is not supported

Android

 * The CTRL modifier for keymaps currently doesn't work. Other modifier keys do still work.
 * Initial Android support is targeted at inexpensive Android powered set-top boxes. As such, support for mobile devices is still being developed, but will improve with time.

Linux general

 * Ubuntu might "steal" media keys (play, fastforward, rewind, volume, etc) before Kodi receives them. A temp work around is to un-set these keys in Ubuntu's keyboard shortcut settings.

Kodibuntu specific

 * All AMD/ATI users with a GPU up to ATI HD5xxx will have a failed install because 12.10 does not carry compatible fglrx a workaround is on this thread.

Mac OS X/iOS
* Gapless playback for music isn't working.


 * Non-Kodi issues
 * Apple does not provide support for HD-audio passthrough in their audio API, CoreAudio.

Mac specific

 * There seem to be some audio sync issues when refresh rate is changed to 24hz.
 * No retina support yet.
 * Some tools/applications which adjust screen brightness may lead to low framerates (5fps framerate limiting) in Kodi. The most common ones should be exempt from this and not cause any issue, but there may be others. Please report any tools/applications that still have this issue to the Kodi support forums so that we can add them to the exempt list. (basically all tools which use a transparent fullscreen overlay)
 * Certain Macs using Intel GPUs seem to show a green line when using hardware decoding (VDA). A fix was found, but that fix caused some other issues, so the lesser evil was chosen (green line). Developers are still working on this issue. In most cases the Mac in question can run just fine without the hardware (VDA) decoder, as they have more than enough CPU power. It won't hurt anything. At most it might just kick up your CPU fans more, depending on how demanding the video is. You can turn off hardware video decoding by going into Settings -> Videos -> Playback and deselecting the VDA option.

iOS specific

 * Retina support for iPad is currently GUI only. Video resolution currently maxes out at 1024 x 768. Retina is fully supported for iPhones and iPod touches.

Raspberry Pi

 * None currently with 

Windows

 * AirPlay videos recorded with iPhones/iPads might not rotate correctly when using hardware video decoding
 * Windows screensaver and power saving mode kicks in when Kodi is not focused (independent of whether Kodi is playing a video or not)
 * Fixed in v14.2