Caches explained



"Cache" can refer to one of many different types of caches that Kodi uses, and most are not directly related to each other.

A cache can refer to any data that is locally saved on the Kodi device and used for fast access to that data. The overall concept of a cache is explained on Cache (computing).

Unlike other pages on the wiki that describe a specific feature or how to get something done, this page is dedicated to helping dispel some of the myths and mystery around the different types of caches that Kodi uses.

Video cache - the source of most "out of cache" messages
The video cache is the most common cache that people talk about when it comes to Kodi. The video cache works by saving a few seconds of video before it is needed, so that if there are small slowdowns or bumps in loading the video, it will not constantly pause while waiting to get enough data to resume playing back. The video cache is normally stored in RAM and erased on the fly, as needed. It requires no user intervention to "empty" this cache.

A warning about the cache filling up does not actually mean that more cache space is needed or that the existing cache needs to be emptied. The warning box is not currently well worded and has lead to a lot of confusion with users. What it means is that the video is loading too slowly for the cache to smooth out all of the bumps, and that the bumps will keep happening due to that low video speed.

Kodi only uses a tiny amount of RAM for the video cache, about 60 MB. This is because Kodi is not currently coded to see if the hardware you are using has more or less RAM, so to be safe only a small amount is assumed to be available. Users are able to increase this amount, and modify how "quickly" it fills up, by following the guide at HOW-TO:Modify the video cache. However, changes to these settings are only helpful for a few situations, such as a network that fluctuates in speed, occasional wifi interference, or a connection that is borderline too slow for video to playback.

"Zero" cache
A lot of people see references to a "zero cache". This is a specific setting for the video cache to use local storage (such as a hard drive) instead of RAM. This setting is not needed for most users, even if you only have 1GB of RAM total.

Like all video cache settings and modes, the user does not need to manually "empty" the cache when using the "zero" setting. Kodi will automatically empty such temporary files.

Add-on cache - the common source of running out of local drive space
Some (but not all) add-ons will save files to make their own "cache". This can be for many reasons and be used for many different types of files. Some add-ons will even bypass the normal video cache (described in the section above) and implement their own special video cache, by pre-downloading files and then playing them back locally. This method isn't necessarily wrong, but it depends on the add-on keeping track of those downloaded files and cleaning them up, or else the device will run out of available drive space.

Many add-ons do not always clean up these files, and as a result some people have used various tools to "clean the cache". Because the only known add-ons that have these issues are ones that break the community rules for the official Kodi websites, we cannot help users who need help with this situation. The only advice that can really be given here is that you should avoid using add-ons that are unable to clean up after themselves. If you do need to clean up such files, there is information on the internet for doing so.

For any situation where you need to clean up leftover add-on data files, you can also manually delete various add-on files by going into the File manager and navigating to the userdata folder (which will be labeled as Profile directory) and then into the addon data folder. Find the add-on in question, and you should be able to manually delete files inside that have collected over time. Be careful to not delete anything important, such as a settings file for an add-on you still wish to use. The exact contents of these folders vary greatly between add-ons.

Android application cache
On Android devices there is an "application cache" for nearly all Android apps. This can be accessed by going into your Android settings and then into Apps, and then selecting the specific application in question.

For Kodi the application cache only contains various default files, and normally does not need to ever be cleared. However, it is possible for one of these files to sometimes be corrupt, or sometimes Kodi crashes before it is able to delete older files, and the user must use the button/option to clear the Kodi application cache. If you have any issues with Kodi starting on an Android device then this is one option that can be tried to fix it. This should not clear out any Kodi user settings, add-ons, or library information, but you should still avoid clearing this cache very often. The next time that Kodi is ran you will see a "first run" screen, where it regenerates these files.

Image cache
Kodi will cache various images, mainly those used in the video library, automatically and without need for user intervention. If a user is ever low on local disk space, such as having a large video library, or having an install that has been active for a long time, then sometimes manual cleaning is needed. For more information about such cleaning, see HOW-TO:Reduce disk space usage. That page also describes how to save such images in another location, such as an external drive or on a network share, for devices with low internal memory.

Temp and other files
There are a few other files, mainly temporary files that are automatically cleaned up, that Kodi might save. This includes things like some subtitle related files, extracted videos from a zip or rar archive, previous versions of some add-ons, or other data that is saved to be quickly accessed if necessary.