Kodi data folder: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
mNo edit summary
m (fix name of macOS)
 
(7 intermediate revisions by 3 users not shown)
Line 4: Line 4:


= Introduction =
= Introduction =
<section begin="KodiDataFolder" />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}}
<section begin="KodiDataFolder" />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.<section end="KodiDataFolder" />
Basically anything you add or modify, after installation, occurs in this folder and sub-folders.<section end="KodiDataFolder" />
Line 25: Line 25:
|-
|-
| '''Linux''' || ~/.kodi
| '''Linux''' || ~/.kodi
|-
| '''macOS''' || /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
| '''OSMC''' || /home/osmc/.kodi
|-
|-
| '''Mac''' || /Users/<your_user_name>/Library/Application Support/Kodi
| '''tvOS''' || /private/var/mobile/Library/Preferences/Kodi
|-
|-
| '''tvOS''' || /private/var/mobile/Library/Preferences/Kodi
| '''WebOS''' || /media/developer/apps/usr/palm/applications/org.xbmc.kodi/.kodi
|-
|-
| '''Windows''' || C:\Users\<''YourUsername''>\AppData\Roaming\Kodi
| '''Windows''' || C:\Users\<''YourUsername''>\AppData\Roaming\Kodi
Line 36: Line 40:
| '''Windows Portable''' || <''Install location chosen by you''>\portable_data
| '''Windows Portable''' || <''Install location chosen by you''>\portable_data
|-
|-
| '''Windows UWP ''' || %LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi\  
| '''Windows Xbox''' || %LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi\  
|}
|}


:'''Note:''' In some Android setups the path may be slightly different to the one stated above.
:'''Note:''' In some Android setups the path may be slightly different to the one stated above.
<section end="KodiDataFolderLocation" />
<section end="KodiDataFolderLocation" />


= Folders =
= Folders =
Line 69: Line 72:


== media ==
== media ==
Not used.
The media folder may contain other sub-folders that may need to be created manually.
 
=== Fonts ===
The ''Fonts'' sub-folder, can be used to add additionals subtitle fonts, which can be used as alternative to the default Kodi font.
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 your operative system and avoid to use this folder to store them,
some Kodi distributions could provide a special folder, where you can place your own font library.


{{note|On Kodi 20 - At each startup Kodi will check if files have been added and/or removed in this folder, and then rebuilds the font cache if necessary.
When the font cache has been builded will be saved a <code>fontcache.xml</code> file in this folder. To optimise Kodi startup, please do not delete this file.}}


== system ==
== system ==
Line 82: Line 95:


= Files =
= Files =
The following files are located in the Kodi Data folder except for iOS, tvOS and macOS systems which save the logs elsewhere.
For {{kodi}} installations on Windows, the log files are saved in this folder. (For location of log files in other platforms, see: ''[[Template:LogfilePath|Log file Paths]]'')


; \kodi.log
; \kodi.log
Line 88: Line 101:


{{#lst:Log_file|WhichLog}}
{{#lst:Log_file|WhichLog}}
:See '''[[Log_file|Debug Log]]'''




Line 94: Line 110:


{{top}}
{{top}}
{{updated|20}}


{{updated|18}}
[[Category:FAQ]]
[[Category:Index]]
[[Category:Manual]]
[[Category:Karellen]]
[[Category:Karellen]]
[[Category:Settings]]
[[Category:Settings]]
[[Category:Video library]]
[[Category:Music library]]
[[Category:Advanced topics]]

Latest revision as of 07:39, 20 January 2024

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
macOS /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
WebOS /media/developer/apps/usr/palm/applications/org.xbmc.kodi/.kodi
Windows C:\Users\<YourUsername>\AppData\Roaming\Kodi
Windows Portable <Install location chosen by you>\portable_data
Windows Xbox %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

The media folder may contain other sub-folders that may need to be created manually.

Fonts

The Fonts sub-folder, can be used to add additionals subtitle fonts, which can be used as alternative to the default Kodi font. 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 your operative system and avoid to use this folder to store them, some Kodi distributions could provide a special folder, where you can place your own font library.

Note: On Kodi 20 - At each startup Kodi will check if files have been added and/or removed in this folder, and then rebuilds the font cache if necessary. When the font cache has been builded will be saved a fontcache.xml file in this folder. To optimise Kodi startup, please do not delete this file.

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