Archive:Common issues

Troubleshooting FAQs

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.

Note: This is not an exhaustive list of bugs/issues, but a simple summary of the more common issues that users might be facing. The purpose of this page is to let users know that Team Kodi is aware of these issues and (in most cases) is working on fixing them.

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 always update right away on the "client" Kodi instance.
  • 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. [1]
• Using variable rewind (x2, x4, x8, etc) will actually go faster than it is supposed to. A fix has been done but won't be ready for v13: [2] (however, it is fixed in OpenELEC)
• Chapter markers for MP4 files are broken in v13 and v14 Fixed in v14.1
• The current AFP client in Kodi is unstable and will eventually be removed. 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.

Non-Kodi issues

• Apple TV 2 will crash on startup when older versions of Plex are also installed. Either uninstall Plex or update it.

Raspberry Pi

• None currently with Kodi v21 Omega

Windows

• Webserver (also used for smartphone/tablet remotes) seems to be causing crashes. FIXED in v14.2
• AirPlay videos recorded with iPhones/iPads might not rotate correctly when using hardware video decoding [3]
• Windows screensaver and power saving mode kicks in when Kodi is not focused (independent of whether Kodi is playing a video or not)