Difference between revisions of "Userdata"

From Official Kodi Wiki
Jump to: navigation, search
m (Location of the userdata folder)
m (Page cleared)
Line 1: Line 1:
{{mininav|[[Main_Page]]|[[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 System data 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" <!-- Weird trick used to make the table indent when transcluded -->
 
{| class="prettytable"
 
! Operating system
 
! File path
 
|-
 
| '''Android''' || {{userdata|Android}}
 
|-
 
| '''iOS/tvOS''' || {{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'
 
* '''[[Databases]]''' - This is where all of the databases required for your [[Music_library|Music]] and [[Video_library|Video Libraries]] are located, containing any downloaded (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.}}
 
* '''[[Keymap|keymaps]]''' - This folder is where your customized keymapping files reside (e.g. MyRemote.xml or keyboard.xml)
 
* '''library''' - Directory to store [[Video_nodes|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]]).
 
* '''[[LIRC|Lircmap.xml]]''' - This file which may be created can contain changes to the default Lircmap (Linux Only).
 
* '''[[Party_Mode|partymode.xsp]]''' - Defines the [[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 [[Media_sources|Media Sources]] and locations.
 
* '''[[Userdata/mediasources.xml|mediasources.xml]]''' - Similar to sources.xml, but just for the "Browse for new share" window.
 
* '''[[Profiles#profiles.xml_and_profiles_folder|profiles.xml]]''' - Stores your Master user and additional user(s) [[Settings/Interface/Master_lock|Master lock]] codes and profiles information see also [[Settings/Interface/Master_lock]] '''{{?}}'''
 
* '''[[autoexec.py]]''' - optional python script that is run at Kodi startup.
 
 
{{Krypton updated}}
 
 
[[Category:Settings]]
 
[[Category:Manual]]
 
[[Category:Advanced topics]]
 

Revision as of 20:38, 27 October 2020