Userdata

2019-12-28T21:04:36Z

Amirrammari: /* Windows 10 App Store version */

{{mininav|[[General topics]]|[[Settings]]}}

{{redv|'''NOTICE:'''|Manually editing files in the '''userdata''' folder is an '''advanced topic for {{kodi}}'''. New users '''don't need to manually edit files''' in the '''userdata''' folder. {{kodi}} does this for you, when you change the options in the {{kodi}} GUI'' with the exception of [[advancedsettings.xml]]}}
{{bluev|'''NOTE'''|''There are two userdata folders, the [[Systemdata]] one contains default settings necessary for {{kodi}} to operate, and the userdata folder for user modifications. Do not touch the files in the first system-userdata folder. This page (and most references on the wiki) are about editing the second, user-accessible, '''userdata''' folder.''}}

<section begin="intro" />The '''userdata''' folder is where all of your settings and customizations are stored.<section end="intro" />
<br />
== Location of the userdata folder ==
<section begin="location all" />
<includeonly>:::</includeonly>{{Note|In older versions of the software (before v14) the <code>'''kodi'''</code> directories were named <code>'''xbmc'''</code>.}}
<includeonly>:::</includeonly>{{{!}} class="datatable" 
{| class="prettytable"
! Operating system
! File path
|-
| '''Android''' || {{userdata|Android}}
|-
| '''iOS''' || {{userdata|iOS}}
|-
| '''LibreELEC''' || {{userdata|OpenELEC}}
|-
| '''Linux''' || {{userdata|Linux}}
|-
| '''OSMC''' || {{userdata|OSMC}}
|-
| '''Mac''' || {{userdata|Mac}}
|-
| '''Windows''' || {{userdata|Windows}}
|-
| '''Windows UWP ''' || {{userdata|Windows UWP}}
|}
<section end="location all" />

=== Android location ===
Sometimes the exact path will differ from device to device. The Android userdata folder is usually inside of "sdcard" so the path might be /sdcard/Android/data/org.xbmc.kodi/files/.kodi/userdata/

=== Microsoft Store version ===
Kodi installed from the Microsoft Store puts user data in %LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi\userdata

== Backing up your settings ==
{{See|Backup}}

== UserData folder contents ==
Below are the elements contained in the UserData folder and their role:

* '''addon_data''' - Contains configuration data for your currently installed addons, the addons themselves are not in userdata but one folder up in 'addons'
* '''[[Database]]''' - This is where all of the databases required for your [[Music Library|Music]] and [[Video Library|Video Libraries]] are located, containing any downloaded [[Scraper.xml|(scraped)]] music or video information.
** '''MyMusic#.db''' - Database file containing Music information.
** '''MyVideos#.db''' - Database file containing Movie, TV Show and Music Videos information.
** '''ViewModes#.db''' - Database file containing information on all Kodi views (viewmode, sorting etc.).
** '''Addons#.db''' - Database file containing information on all Kodi addons (skins, scraper, video-addons...).
** '''Textures#.db''' - Database file containing information on all Kodi textures (thumbs, fanart, posters...).
** '''TV#.db''' - Database file containing information on Live-TV channels.
** '''EPG#.db''' - Database file containing information on EPG for Live-TV.
** '''ADSP#.db''' - Database file containing information for Audio Digital Signal Processing add-ons.
:{{note|Where <big>'''#'''</big> is the number of current '''[[Databases#Database_Versions]]''' in use.}}
* '''[[keyboard.xml|keymaps]]''' - This folder is where your customized keymapping files reside (e.g. MyRemote.xml or keyboard.xml)
* '''library''' - Directory to store [[custom library nodes]].
* '''[[Playlists]]''' - This is where your playlists are stored. There are separate subfolders for mixed, music and video playlists.
** '''mixed''' - playlists containing both audio and music videos, will show in both the Music and Video Libraries.
** '''music''' - playlists containing audio only, will show in the Music Library.
** '''video''' - playlists containing videos only, will show in the Video Library.
* '''[[Artwork|Thumbnails]]''' - Cached Thumbnails (icons) are stored in this folder.
* '''[[advancedsettings.xml]]''' - A user can create this file in their UserData folder. The file can contain additional settings and pre-defined values for the settings available in the GUI (thus removing them from the GUI settings screens). Useful for advanced users and for installers.
* '''Visualizations''' - All of your visualization settings are stored in this folder. <<this is not present in frodo?
* '''[[favourites.xml]]''' - This file, which may be created by Kodi or the user in their UserData folder contains items added via the ''Add to Favourites'' context menu option.
* '''guisettings.xml''' - This is where your settings configured in the GUI are stored (through the User Interface [[Settings]]).
* '''[[lircmap.xml|Lircmap.xml]]''' - This file which may be created can contain changes to the default Lircmap (Linux Only).
* '''[[partymode.xsp]]''' - Defines the [[Playlists#Smart Playlists|Smart Playlist]] to be used when using Party Mode for music playback.
* '''[[profiles]]''' - Directory stores your additionally created user-profiles settings and data information this directory may contain all the contents of the [[userdata]] list depending on settings used to create the user. {{?}}
* '''[[RssFeeds.xml]]''' - RssFeeds.xml is used to configure the RSS feeds displayed on the home screen.
* '''[[sources.xml]]''' - Defines your [[Adding Media Sources|Media Sources]] and locations.
* '''[[mediasources.xml]]''' - Similar to sources.xml, but just for the "Browse for new share" window.
* '''[[Profiles#Profiles folder contents|profiles.xml]]''' - Stores your Master user and additional user(s) [[Master lock]] codes and profiles information see also [[Settings/System#Master lock]] and [[Media sources#Locking]] '''{{?}}'''
* '''[[autoexec.py]]''' - optional python script that is run at Kodi startup.

{{Krypton updated}}

[[Category:Settings]]
[[Category:Manual]]
[[Category:Advanced topics]]

Template:Userdata

2019-12-28T21:01:56Z

Amirrammari:

{{#switch:{{{1|}}}
| Android = Android/data/org.xbmc.kodi/files/.kodi/userdata/ {{small | ''(see [[Userdata#Android location|note]])'' }}
| iOS = /private/var/mobile/Library/Preferences/Kodi/userdata/
| Linux = ~/.kodi/userdata/
| Mac = /Users/<your_user_name>/Library/Application Support/Kodi/userdata/ {{small | ''(see [[Mac FAQ#Lion userdata|note]])'' }}
| OpenELEC = /storage/.kodi/userdata/
| OSMC = /home/osmc/.kodi/userdata/
| Windows = %APPDATA%\Kodi\userdata
| Windows UWP = %LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi\
}}<noinclude>{{doc}}</noinclude>

Official Kodi Wiki - User contributions [en]

Userdata

Template:Userdata