Userdata

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


1 Introduction

The Userdata folder is a subfolder of the Kodi Data Folder. The folders and files described on this page may vary between releases and forks.

This Userdata folder is used for the Master (default) profile. When creating a new profile, the userdata folder for the new profile is stored in the Profiles folder detailed below.

Modifying items in the Userdata folder is an advanced topic and not recommended. If you find it necessary, create a Backup of the Kodi data folder first.


2 Location

The Userdata folder is a subfolder of the Kodi Data Folder and is located as shown in the table below.

Operating system Userdata Folder
Android Android/data/org.xbmc.kodi/files/.kodi/userdata/ (see note)
iOS /private/var/mobile/Library/Preferences/Kodi/userdata/
LibreELEC /storage/.kodi/userdata/
Linux ~/.kodi/userdata/
OSMC /home/osmc/.kodi/userdata/
Mac /Users/<your_user_name>/Library/Application Support/Kodi/userdata/
tvOS /private/var/mobile/Library/Preferences/Kodi/userdata/
Windows  %APPDATA%\Kodi\userdata
Windows Portable <Install location chosen by you>\portable_data\userdata\
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 subfolders are located in the Userdata folder:


3.1 addon_data

Is the counterpart to the addons folder in the Kodi Data folder.

For addons that require it, this folder holds user specified settings and other data. Not all installed add-ons will have a folder here.


3.2 Database

See: Databases


3.3 keymaps

This folder is where your customized keymapping files reside (e.g. MyRemote.xml or keyboard.xml)

See: Keyboard controls
See: Keymap


3.4 library

The folder where user created library nodes are stored.

If creating a new node, first copy the contents of the identical library folder located in the program installation folder. Once copied across, you are able to modify existing nodes or add new nodes. Using the Node Editor will automatically copy the files across.

If you need to remove a node, open the xml file and add visible="false" to the opening <node> tag. eg <node order="80" type="folder" visible="false">

See: Music nodes
See: Video nodes


3.5 peripheral_data

Settings and other data for hardware using the Peripheral API, such as joysticks.


3.6 playlists

Playlists are saved in one of the following subfolders.

If using the Kodi interface to create your smart playlist, Kodi will save the playlist to the correct folder. If creating a playlist using an XML editor, ensure the playlist is saved to the correct folder or it will not be available in Kodi.

  • mixed - playlists containing both music and music videos, will show in both the Music and Video Libraries.
  • music - playlists containing music only, will show in the Music Library.
  • video - playlists containing videos only, will show in the Video Library.
See: Playlists


3.7 profiles

Available only when one or more new profiles have been created.

New Profiles are created in this folder. Each subfolder is a Profile and contains a replica of the Userdata folder. Depending on which settings you chose during setup, the Profile Userdata folder may contain structure and data or structure only.

See: Profiles


3.8 Savestates

Save points for the Games section of Kodi

See: Games


3.9 Thumbnails

This is the location of all the cached artwork.

See: Artwork
See: Artwork/Cache


4 Files

The following files are located in the Userdata folder:


4.1 advancedsettings.xml

This file does not exist by default. It must be created by the user.

This file can be used to modify additional settings that are not displayed in the Kodi Settings pages.

See: Advancedsettings.xml


4.2 autoexec.py

This file does not exist by default. It must be created by the user.

An autoexec.py file can be used to perform certain actions during startup of Kodi.

Notes
  • From v12 - v18 either the autoexec.py or the Autoexec Service methods can be used (not both).
  • From v19 the autoexec.py feature has been removed for security reasons. Use the Autoexec Service instead and delete the autoexec.py file if one remains from a previous setup.
See: Autoexec Service


4.3 favourites.xml

Contains the items that have been added through the use of Add to favourites.

The file is created by Kodi when adding items to Favourites for the first time, or it can be manually created by the user.

See: Favourites
See: Favourites.xml


4.4 guisettings.xml

Holds the configuration of all the settings in the Kodi Settings pages.

See: Settings

It is also possible to transfer these settings out of the settings pages and into the advancedsettings.xml file.

See: Settings Conversion


4.5 Lircmap.xml

Created when there are changes to the default Lircmap (Linux Only).

See: LIRC


4.6 mediasources.xml

Similar to sources.xml, but used to add custom network locations when browsing in the GUI for a path.

mediasources.xml does not exist by default and is only created when Add network location... is used in the Browse for new share window when adding a new Source.

Stop hand.png Editing this file does not change the paths in your library. The folder paths for library items are stored in the databases.


An example entry of a network share in the mediasources.xml file

<mediasources>
    <network>
        <location id="0">smb://192.168.0.20/j/</location>
    </network>
</mediasources>


4.7 profiles.xml

Holds data for the Master (default) profile as well as any additional profiles and allows you to switch between profiles.

See: Profiles


4.8 RssFeeds.xml

RssFeeds.xml is used to configure the RSS feeds displayed on the home screen.

See: RssFeeds.xml


4.9 sources.xml

Defines the paths for Media Sources as displayed in the GUI. The file does not exist until a media Source is added to Kodi for the first time.

Stop hand.png Editing this file does not change the paths in your library. The folder paths for library items are stored in the databases.


See: Media sources
See: Sources.xml
See: Sources.xml/Types


4.10 upnpserver.xml

Created when Kodi is enabled as either a uPnP Client or Server.

See: UPnP


Return to top