Kodi data folder

From Official Kodi Wiki
Revision as of 12:06, 25 September 2021 by CastagnaIT (talk | contribs) (→‎media)
Jump to navigation Jump to search
Home icon grey.png   ▶ Settings ▶ Kodi data folder


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.


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
Mac /Users/<your_user_name>/Library/Application Support/Kodi
Nvidia Shield (SMB) smb://<nvidiashieldurl>/internal/Android/data/org.xbmc.kodi/files/.kodi
OSMC /home/osmc/.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.


Folders

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


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


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.


media

In the media folder is possible to add a fonts sub-folder.

The fonts sub-folder, can be used to store additionals subtitle fonts, which can be used as alternative to the default subtitle font "Arial". We strongly suggest to avoid adding more than 100 fonts in this folder, otherwise you may experience of playback slowdowns and system instability.

If your intent is to provide a big library of fonts as support to subtitles format type like ASS/SSA, we suggest you to install these fonts in the operative system and avoid to use this folder to store them, some Kodi OS could provide a special folder, where you can place your own font library.

system

Not used.


userdata

See: Userdata


Files

For Kodi installations on Windows, the log files are saved in this folder. (For location of log files in other platforms, see: Log file Paths)

\kodi.log
\kodi.old.log

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


See Debug Log



Return to top