Userdata

From Official Kodi Wiki
Revision as of 07:40, 20 January 2024 by Kambala (talk | contribs) (fix name of macOS)
Jump to navigation Jump to search
Home icon grey.png   ▶ Settings ▶ Kodi data folder ▶ Userdata


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.


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


Folders

The following subfolders are located in the Userdata folder:


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.


Database

See: Databases


keymaps

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

See: Keyboard controls
See: Keymap


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


peripheral_data

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


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


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


Savestates

Save points for the Games section of Kodi

See: Games


Thumbnails

This is the location of all the cached artwork.

See: Artwork
See: Artwork/Cache


Files

The following files are located in the Userdata folder:


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


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


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


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


Lircmap.xml

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

See: LIRC


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>


PartyMode.xsp

Contains the rules for the Party Mode playlist when it has been edited from the default rules. The file does not exist until the Party mode playlist has been edited.

See: Party Mode


passwords.xml

Stop hand.png Passwords are stored in unencrypted text format.

Contains the passwords for your network shares. These passwords are stored as text which can be easily read by prying eyes.

We recommend creating a new user on your network to access your media files only and not any other sensitive files. Use a new and simple password for the new user login.


profiles.xml

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

See: Profiles


RssFeeds.xml

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

See: RssFeeds.xml


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: Sources.xml
See: Sources.xml/Types


upnpserver.xml

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

See: UPnP


wakeonlan.xml

Automatically created when the Wake On Lan setting is enabled. The file can be edited to add or remove options.

See: Wake on lan



Return to top