Userdata

2022-01-28T20:04:47Z

Mifo: /* Location */ Added details for Windows store

{{mininav|[[Settings]]|[[Kodi data folder]]}}

= Introduction =
The Userdata folder is a subfolder of the '''[[Kodi data folder|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 =
<section begin="location all" />
The Userdata folder is a subfolder of the '''''[[Kodi data folder|Kodi Data Folder]]''''' and is located as shown in the table below.
{| class="prettytable"
! scope="row" ! style="width:150px; background-color:#dbdf26; | Operating system
! scope="row" ! style="width:700px; background-color:#dbdf26; | Userdata Folder
|-
| '''Android''' || {{userdata|Android}}
|-
| '''iOS''' || {{userdata|iOS}}
|-
| '''LibreELEC''' || {{userdata|LibreELEC}}
|-
| '''Linux''' || {{userdata|Linux}}
|-
| '''Mac''' || {{userdata|Mac}}
|-
| ''' Nvidia Shield (SMB) || {{userdata|Nvidia Shield (SMB)}}
|-
| '''OSMC''' || {{userdata|OSMC}}
|-
| '''tvOS''' || {{userdata|iOS}}
|-
| '''Windows''' || {{userdata|Windows}}
|-
| '''Windows Portable''' || <''Install location chosen by you''>\portable_data\userdata\
|-
| '''Windows via Microsoft Store''' || {{userdata|Windows UWP}}
|-
| '''Windows Xbox''' || {{userdata|Windows UWP}}
|}
:'''Note:''' In some Android setups the path may be slightly different to the one stated above.
<section end="location all" />

= Folders =
The following subfolders are located in the Userdata folder:

== addon_data ==
Is the counterpart to the '''[[Kodi_data_folder#addons|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 '''[[Add-on:Library_Node_Editor|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.

:{{big|See: '''[[Advancedsettings.xml#guisettings.xml_Setting_Conversion|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.

{{warning|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
<syntaxhighlight lang="xml">
<mediasources>
<network>
<location id="0">smb://192.168.0.20/j/</location>
</network>
</mediasources>
</syntaxhighlight>

== 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 ==
{{warning|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.

{{warning|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}}

{{top}}

{{updated|19}}
[[Category:Karellen]]
[[Category:Settings]]

Official Kodi Wiki - User contributions [en]

Userdata