Kodi data folder

From Official Kodi Wiki
Revision as of 01:23, 27 October 2020 by Karellen (talk | contribs)
Jump to: navigation, search
Home icon grey.png   ▶ Settings ▶ Kodi data folder

1 Introduction

Once Kodi is installed, all subsequent changes and usage data are saved in the Kodi data folder which is the parent folder of the Userdata folder. When you install a new skin or an add-on it is installed in this folder. Playlists and edits to Nodes are stored here, and the library databases are created here along with the artwork cache and any other changes you make during your travels with Kodi

Basically anything you add or modify, after installation, occurs in this folder and sub-folders.

2 Location

The location of this folder varies between operating systems and the table below lists their locations.

Operating system Kodi Data folder path
Android Android/data/org.xbmc.kodi/files/.kodi
iOS /private/var/mobile/Library/Preferences/Kodi
LibreELEC /storage/.kodi
Linux ~/.kodi
OSMC /home/osmc/.kodi
Mac /Users/<your_user_name>/Library/Application Support/Kodi
tvOS /private/var/mobile/Library/Preferences/Kodi
Windows C:\Users\<YourUsername>\AppData\Roaming\Kodi
Windows Portable <Install location chosen by you>\portable_data
Windows UWP  %LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi\
Note: In some Android setups the path may be slightly different to the one stated above.

3 Folders

The following are the sub-folders in the Kodi Data folder. Forks of Kodi may have additional folders not covered here.

3.1 addons

Any add-on installed in Kodi is installed in this folder along with any subsequent updates.

Many add-ons have an additional folder located in \userdata\addon_data. This folder contains data created due to user preference or usage. eg, changed settings, channel line-up, etc

Kodi comes pre-installed with a series of default add-ons that are required for basic functioning, such as language add-ons, scrapers, default skins etc. These pre-installed add-ons are located in the Programs folder along with the remainder of the Kodi program files. When these pre-installed add-ons receive a subsequent update, the update is saved in this folder and the original add-on remains but is ignored.

See: Add-ons

3.2 cache

The cache folder and its subfolders are used as temporary storage for some Kodi functions. They can be used by:

  • Scrapers to cache results and reduce API calls to remote sites.
  • Caching navigation nodes that are slow to load in larger libraries
  • File view of non-library items that entails tag reading which can be slow

This folder is self-cleaning with items generally kept for 3 hours for the python Pickle cache, and 24 hours or more for scraper caches.

3.3 media

Not used.

3.4 system

Not used.

3.5 userdata

See: Userdata

4 Files

The following files are located in the Kodi Data folder except for iOS, tvOS and macOS systems which save the logs elsewhere.


The Kodi logs are Session Logs. The logs are written from Kodi startup to Kodi shutdown (or crash). The next time you start Kodi, the existing kodi.log is renamed Kodi.old.log and a new kodi.log is created for this new session. In effect you only ever have two logs available- the current one, and the previous one.

Which log you upload depends...

  1. If you have created the log which captures the problem and have not restarted Kodi, then upload kodi.log
  2. If you have created the log which captures the problem and have restarted Kodi, then upload kodi.old.log

Return to top