Official Kodi Wiki - User contributions [en]

EPGGrid control

2025-04-18T12:49:11Z

Ksooo:

<section begin="main content" />
The epggrid control is used for creating an epg timeline in Kodi. You can choose the position, size, and look of the grid and it's contents.
=== Example ===
<syntaxhighlight lang="xml" enclose="div">
<control type="epggrid" id="10">
<description>EPG Grid</description>
<left>80</left>
<top>81</top>
<width>1120</width>
<height>555</height>
<pagecontrol>10</pagecontrol>
<scrolltime>350</scrolltime>
<timeblocks>40</timeblocks>
<rulerunit>6</rulerunit>
<progresstexture border="5">PVR-EpgProgressIndicator.png</progresstexture>
<onleft>31</onleft>
<onright>31</onright>
<onup>10</onup>
<ondown>10</ondown>
<orientation>Horizontal</orientation>
<rulerdatelayout width="1700" height="45" condition="$PARAM[has_rulerdate_layout]">
<control type="label">
<width>1700</width>
<height>45</height>
<font>font24</font>
<label>$INFO[ListItem.Label]</label>
<textcolor>button_focus</textcolor>
<align>center</align>
<aligny>center</aligny>
</control>
</rulerdatelayout>
<rulerlayout height="35" width="40">
<control type="image" id="1">
<width>40</width>
<height>29</height>
<left>0</left>
<top>0</top>
<texture border="5">button-nofocus.png</texture>
</control>
<control type="label" id="2">
<left>10</left>
<top>0</top>
<width>34</width>
<height>29</height>
<font>font12</font>
<aligny>center</aligny>
<selectedcolor>selected</selectedcolor>
<align>left</align>
<label>$INFO[ListItem.Label]</label>
</control>
</rulerlayout>
<channellayout height="52" width="280">
<animation effect="fade" start="110" time="200">UnFocus</animation>
<control type="image" id="1">
<left>0</left>
<top>0</top>
<width>270</width>
<height>52</height>
<texture border="5">button-nofocus.png</texture>
</control>
<control type="label">
<left>5</left>
<top>5</top>
<width>40</width>
<height>35</height>
<font>font12</font>
<align>left</align>
<aligny>center</aligny>
<textcolor>grey</textcolor>
<selectedcolor>grey</selectedcolor>
<label>$INFO[ListItem.ChannelNumber]</label>
</control>
<control type="image">
<left>45</left>
<top>4</top>
<width>45</width>
<height>44</height>
<texture>$INFO[ListItem.Icon]</texture>
</control>
<control type="label" id="1">
<left>94</left>
<top>0</top>
<width>160</width>
<height>52</height>
<font>special12</font>
<aligny>center</aligny>
<selectedcolor>selected</selectedcolor>
<align>left</align>
<label>$INFO[ListItem.ChannelName]</label>
</control>
</channellayout>
<focusedchannellayout height="52" width="280">
<animation effect="fade" start="110" time="200">OnFocus</animation>
<control type="image" id="1">
<left>0</left>
<top>0</top>
<width>270</width>
<height>52</height>
<texture border="5">button-focus.png</texture>
</control>
<control type="label">
<left>5</left>
<top>5</top>
<width>40</width>
<height>35</height>
<font>font12</font>
<align>left</align>
<aligny>center</aligny>
<textcolor>grey</textcolor>
<selectedcolor>grey</selectedcolor>
<label>$INFO[ListItem.ChannelNumber]</label>
</control>
<control type="image">
<left>45</left>
<top>4</top>
<width>45</width>
<height>44</height>
<texture>$INFO[ListItem.Icon]</texture>
</control>
<control type="label" id="1">
<left>94</left>
<top>0</top>
<width>160</width>
<height>52</height>
<font>special12</font>
<aligny>center</aligny>
<selectedcolor>selected</selectedcolor>
<align>left</align>
<label>$INFO[ListItem.ChannelName]</label>
</control>
</focusedchannellayout>
<itemlayout height="52" width="40">
<control type="image" id="2">
<width>40</width>
<height>52</height>
<left>0</left>
<top>0</top>
<aspectratio>stretch</aspectratio>
<texture border="3">epg-genres/$INFO[ListItem.Property(GenreType)].png</texture>
</control>
<control type="label" id="1">
<left>6</left>
<top>3</top>
<width>30</width>
<height>25</height>
<font>font12</font>
<aligny>center</aligny>
<selectedcolor>selected</selectedcolor>
<align>left</align>
<label>$INFO[ListItem.Label]</label>
</control>
<control type="image">
<left>5</left>
<top>28</top>
<width>30</width>
<height>20</height>
<texture>PVR-IsRecording.png</texture>
<visible>ListItem.IsRecording</visible>
</control>
<control type="image">
<left>5</left>
<top>28</top>
<width>20</width>
<height>20</height>
<texture>PVR-HasTimer.png</texture>
<visible>ListItem.HasTimer + !ListItem.IsRecording</visible>
</control>
</itemlayout>
<focusedlayout height="52" width="40">
<control type="image" id="14">
<width>40</width>
<height>52</height>
<left>0</left>
<top>0</top>
<texture border="5">folder-focus.png</texture>
</control>
<control type="image" id="2">
<width>40</width>
<height>52</height>
<left>0</left>
<top>0</top>
<aspectratio>stretch</aspectratio>
<texture border="3">epg-genres/$INFO[ListItem.Property(GenreType)].png</texture>
</control>
<control type="label" id="1">
<left>6</left>
<top>3</top>
<width>30</width>
<height>25</height>
<font>font12</font>
<aligny>center</aligny>
<selectedcolor>selected</selectedcolor>
<align>left</align>
<label>$INFO[ListItem.Label]</label>
</control>
<control type="image">
<left>5</left>
<top>28</top>
<width>30</width>
<height>20</height>
<texture>PVR-IsRecording.png</texture>
<visible>ListItem.IsRecording</visible>
</control>
<control type="image">
<left>5</left>
<top>28</top>
<width>20</width>
<height>20</height>
<texture>PVR-HasTimer.png</texture>
<visible>ListItem.HasTimer + !ListItem.IsRecording</visible>
</control>
</focusedlayout>
</control>
</syntaxhighlight>

=== Available tags ===
In addition to the [[Default Control Tags]] the following tags are available. Note that each tag is '''lower case''' only. This is important, as xml tags are case-sensitive.
{| class="prettytable"
! Tag !! Description
|-
| '''timeblocks'''
| The number of timeframes on the top row.
|-
| '''minspertimeblock'''
| The number of minutes a time block represents. Default is 5 minutes.
|-
| '''rulerunit'''
| Timeframe of each unit on the top row. 1 unit equals 5 minutes.
|-
| '''rulerdatelayout'''
| The layout of the date header.
|-
| '''rulerlayout'''
| The layout of the top row.
|-
| '''progresstexture'''
| A texture which indicates the current progress time
|-
| '''channellayout'''
| The layout of the left column.
|-
| '''focusedchannellayout'''
| The focused layout of the left column.
|-
| '''itemlayout'''
| The layout of the grid
|-
| '''focusedlayout'''
| The focused layout of the grid
|-
| '''orientation'''
| The orientation (Horizontal/Vertical) of the grid
|}

<section end="main content" />

== See also ==
'''Development:'''
* [[Add-on development]]
* [[Skinning]]

[[Category:Skin development]]

MySQL/Advanced notes

2025-04-18T12:41:00Z

Ksooo:

{{:MySQL/Contents}}
{{mininav| [[MySQL]] }}
__TOC__
{{-}}
==advancedsettings.xml==
For a full listing of the advancedsettings.xml parameters, see '''[[advancedsettings.xml#musicdatabase/videodatabase]]'''

== Other databases (PVR) ==

{{MySQL warning}}

==MySQL speed-up tweaks==

=== In advancedsettings.xml: ===
Use the IP address and NOT the hostname of your MySQL server<br />
eg.: 192.168.1.105 <<IP address>> instead of \\SERVER

==Removing stale entries from the database==
Occasionally, it can be beneficial to remove database entries that correspond to files that are no longer on available on the file-system. Note that these orphaned database entries are independent from the Kodi library status which is managed by Kodi [[https://kodi.wiki/view/List_of_built-in_functions#Library_built-in.27s built ins]] such as '''CleanLibrary()'''.

{{Warning|The database should ALWAYS be backed-up before attempting these commands.}}

To locate and delete orphaned database entries, connect to the box serving up the SQL database and log into the SQL database:
mysql -u root -p

Once authenticated, the following can be used to identify active databases on which to work:
SHOW databases;

For example, Matrix will generate a video database called, "MyVideos119."

Execute the following to identify possible rows for deleting:
USE MyVideos119;
SELECT * FROM files WHERE idfile not in (select idfile from episode) and idfile not in (select idfile from movie) and idfile not in (select idfile from musicvideo) ORDER BY `idFile` DESC;

If the command returns rows, these should be stale entries that can be safely removed by substituting DELETE for SELECT * in the last command:

DELETE FROM files WHERE idfile not in (select idfile from episode) and idfile not in (select idfile from movie) and idfile not in (select idfile from musicvideo) ORDER BY `idFile` DESC;

=== In my.cnf (my.ini for older versions): ===
The named file is located at /etc/mysql/my{{dot}}cnf<br />
1. $sudo nano /etc/mysql/my{{dot}}cnf<br />
2. Scroll down to '''[mysqld]''' section and add:<br />
# skip-name-resolve<br />
3. Press Ctrl+X, type y and hit Enter to validate changes and exit nano<br />
4. Restart your MySQL server. $sudo restart mysql

[[File:mysql.PNG|400px]]

==Automated Backup ==
=== Windows ===
This will allow you to make a regular backup of your MySQL database using the schedule of your choosing and saving the backups for however many days you choose. Recommend performing daily backups and saving for a minimum of 7 days. This will give you enough time to discover a problem with the DB and restore to a previous version that did not have problems.

To begin, go ahead and download the [http://www.7-zip.org/download.html command line version of 7zip]. We will use this to compress our MySQL dumps. Create a new folder in your C directory named KODISQLBACKUP. So you should have a C:\KODISQLBACKUP\ location now. In this location, create another new folder and name it zip. So you should now have C:\KODISQLBACKUP\zip. Extract the contents of the 7zip download to this location. Once complete you should have:
<br>
<pre>C:\KODISQLBACKUP\zip\7za.exe

C:\KODISQLBACKUP\zip\7-zip.chm

C:\KODISQLBACKUP\zip\license.txt

C:\KODISQLBACKUP\zip\readme.txt</pre>

We're going to create a down and dirty batch file to perform the actual backup, then we'll execute the batch script with the task scheduler built into Windows. For the purpose of these instructions, it is assumed that you are running MySQL 5.5 installed to the default location. If not, be sure to adjust your path(s) accordingly. It's also a good idea to save your backups to a network location to protect against local drive failure, so the paths here will reflect this. So here are the batch file contents:

<syntaxhighlight lang=winbatch enclose="div">
:: All lines that start with 2 colons are comments, they do not affect the script itself. These comments are explanations of each command, as well as instructions for the things that you will need to edit. Pay close attention to all comments.

:: These lines do not NEED to be edited
set year=%DATE:~10,4%
set day=%DATE:~7,2%
set mnt=%DATE:~4,2%
set hr=%TIME:~0,2%
set min=%TIME:~3,2%

IF %day% LSS 10 SET day=0%day:~1,1%
IF %mnt% LSS 10 SET mnt=0%mnt:~1,1%
IF %hr% LSS 10 SET hr=0%hr:~1,1%
IF %min% LSS 10 SET min=0%min:~1,1%

set backuptime=%mnt%-%day%-%year%-%hr%-%min%

:: User name for DB - NOTE that root credentials are needed for this script.
set dbuser=root

:: User password - NOTE that the root credentials are needed for this script.
set dbpass=password

:: Path to location where you would like to save the errors log file. For simplicity, I keep mine in the same location as the backups.
set errorLogPath="\\REMOTE\KODI_Database\backups\dumperrors.txt"

:: We need to switch to the data directory to enumerate the folders
pushd "C:\ProgramData\MySQL\MySQL Server 5.5\data"

:: We will dump each database to it's own .sql so you can easily restore ONLY what is needed in the future. We're also going to skip the performance_schema db as it is not necessary.

FOR /D %%F IN (*) DO (

IF NOT [%%F]==[performance_schema] (
SET %%F=!%%F:@002d=-!
"C:\Program Files\MySQL\MySQL Server 5.5\bin\mysqldump.exe" --user=%dbuser% --password=%dbpass% --databases --routines --log-error=%errorLogPath% %%F > "\\REMOTE\KODI_Database\backups\%%F.%backuptime%.sql"
) ELSE (
echo Skipping DB backup for performance_schema
)
)

::Now to zip all of the .sql files in this folder and move the resulting .zip files to our network location.

"c:\KODISQLBACKUP\zip\7za.exe" a -tzip "\\REMOTE\KODI_Database\backups\FullBackup.%backuptime%.zip" "\\REMOTE\KODI_Database\backups\*.sql"

::Now we'll delete the unzipped .sql files

del "\\REMOTE\KODI_Database\backups\*.sql"

::Now we'll delete all zip files older than 30 days. You can adjust the number of days to suit your needs, simply change the -30 to whatever number of days you prefer. Be sure you enter the path to your backup location.
Forfiles -p \\REMOTE\KODI_Database\backups\ -s -m *.* -d -30 -c "cmd /c del /q @path"

popd
</syntaxhighlight>

Save this as Kodibackup.bat at C:\KODISQLBACKUP
Make ''sure'' you include the .bat at the end.

After you have edited the above batch file to reflect your paths and saved it as a batch file, all that is left is scheduling it to run. Daily backups are best, but you can use whatever frequency you are comfortable with. To do this, open up the Windows Task Scheduler.

In the Task Scheduler click on "Create Task...", NOT "Create Basic Task...". In the new task window, in the Name box put Kodi MySQL backup (or whatever name you want).

Then click on the Triggers tab, followed by the New button. Select Daily (or whatever you want) and adjust the time you would like it to run. Click OK.

Click on the Actions tab and click New. In the Program/Script box enter C:\KODISQLBACKUP\Kodibackup.bat (or whatever you named your batch file) and in the start in box enter C:\KODISQLBACKUP

Click ok, then click ok in the task window. In the main task scheduler window, right click on the task you just created and select run. If everything works as it should, you should now have a zipped backup of your database(s) in your backup location. It will now do this for you automatically.

Enjoy!

=== Linux ===
[http://sourceforge.net/projects/automysqlbackup/ AutoMySQLBackup] is a script that is designed to keep daily, weekly and monthly backups of your databases. It is very customizable and reliable. There is useful information on installing and configuring the script here: http://www.linux.com/learn/tutorials/659107-how-to-do-painless-mysql-server-backups-with-automysqlbackup.
{{note|Detailed instructions on configuring AutoMySQLBackup should probably be added to this section as the linked page above could be deleted at any time and there is little beginner friendly information available on the web.}}

==Name tag==
{{#lst:MySQL/Setting up Kodi|name tag}}

==Multiple profiles with one MySQL database==
The idea is to share information on files in the library (only scrape once) but have individual watch status for every profile. For information see the forum thread [http://forum.kodi.tv/showthread.php?tid=196821 [MYSQL<nowiki>]</nowiki> HOW-TO: 5 User XBMC] and for a setup for Kodi v16 see [http://forum.kodi.tv/showthread.php?tid=196821&pid=2280431#pid2280431 this post]. An older setup can be found at: http://forum.kodi.tv/showthread.php?tid=81095&pid=840499#pid840499

{{Next|[[MySQL/Backup and restore databases|Backup and restore databases]]}}

{{Updated|16}}

Advancedsettings.xml

2025-04-18T12:35:14Z

Ksooo:

{{TOC right}}{{mininav|[[Settings]]|page=advancedsettings.xml}}
{{bigger|{{note|'''The advancedsettings.xml file does not exist by default. You have to create it first!'''}} }}

<section begin="intro" />The [[advancedsettings.xml]] file, which does not exist by default, can be created by a user in their '''[[Userdata|userdata folder]]'''.

This file is used for advanced settings and options that do not have GUI controls inside of {{kodi}}. Some settings are experimental or very rarely set, so they can only be used via the advancedsettings.xml file. The file is simply a plain text file and can be edited by various text editors, so long as the name is "advancedsettings.xml". These advanced settings can be used to tweak various things such as episode naming patterns, special network ports, special behaviors, and more.<section end="intro" />

The following page will describe the structure of the advancedsettings.xml file and the various individual settings.

{{note|
# All XML tags must be lowercase. The start and end of the advancedsettings.xml file must have the <advancedsettings> and </advancedsettings> tags.
# Kodi will only read the advancedsettings.xml file when it starts up. If you make changes while it is running then you must restart Kodi.
# For some Windows versions, Kodi has two <code>\userdata\</code> folders. The correct one to put the advancedsettings.xml file in is not the one in Program Files, but in <code>%appdata%\Kodi\userdata\.</code>}}

== Layout ==

The layout of <code>advancedsettings.xml</code> is as follows:

<syntaxhighlight lang=xml enclose="div">
<advancedsettings version="1.0">
<setting>value</setting>
...
<setting>value</setting>
</advancedsettings>
</syntaxhighlight>

where "setting" gives the name of the setting, and "value" gives its value.

A list of the available "setting" strings and their values is given below.

= List of available settings =
List of available settings that are recognised in the advancedsettings.xml file <ref>https://github.com/xbmc/xbmc/blob/master/xbmc/settings/AdvancedSettings.cpp</ref>

Recommended: Use the table of contents or the search function in your browser to locate items.

== Troubleshooting settings ==

=== loglevel ===
{{Anchor|.3Cloglevel.3E}}

<section begin="loglevel" />
Sets the logging level used to log errors and information. The "hide" attribute is optional.

<syntaxhighlight lang=xml>
<loglevel hide="attribute">options</loglevel>
</syntaxhighlight>

{| class="mw-collapsible mw-collapsed wikitable"
|-
! style="width:100px;" | Attribute
! style="width:500px;" | Action
|-
! '''true'''
| Hides the "enable debugging" setting in the Settings page. (default)
|-
! '''false'''
| Allows "enable debugging" setting to switch between '''0''' and '''2'''.
|}

{| class="mw-collapsible mw-collapsed wikitable"
|-
! style="width:100px;" | Option
! style="width:500px;" | Action
|-
! '''-1'''
| No logging, suppresses all log output
|-
! '''0'''
| Normal logging, only logging errors (default)
|-
! '''1'''
| Debug logging with freemem, fps and cpu usage (no on screen)
|-
! '''2'''
| Same as 1 (with on screen display)
|-
! '''3'''
| Same as 1 + full smb logging
|}

{| class="wikitable"
|-
! style="width:100px;" | Example
! style="width:500px;" |
|-
! Example 1:
|<syntaxhighlight lang=xml enclose="div">
<advancedsettings version="1.0">
<loglevel>2</loglevel>
</advancedsettings>
</syntaxhighlight>
|-
! Example 2:
|<syntaxhighlight lang=xml enclose="div">
<advancedsettings version="1.0">
<loglevel hide="true">2</loglevel>
</advancedsettings>
</syntaxhighlight>
|}

'''Note:''' The setting is persistent through shutdown and restarts.<br>
'''Note:''' If debugging is enabled in the GUI, loglevel will be set to '''2'''. This will over-ride the <code>advancedsettings.xml</code> setting. You must disable the GUI Setting before adding the entry to <code>advancedsettings.xml</code>.<br />
<section end="loglevel" />
:''{{see also|Log_file|label 1=Debug Log}}''

=== jsonrpc ===
{{Anchor|.3Cjsonrpc.3E}}
To make it easier for developers using the [[JSON-RPC_API]] API in their (third party) applications to debug during development the json output of Kodi can be prettified by setting '''compactoutput''' to '''false'''. Default json output mode is a compact print which does not contain any unnecessary whitespaces and therefore is difficult to read for humans.
Furthermore using the '''tcpport''' setting it is possible to change the default TCP port used by Kodi for JSON RPC (which is 9090) to any other valid port.

Example:
<syntaxhighlight lang=xml enclose="div">
<jsonrpc>
<compactoutput>false</compactoutput>
<tcpport>9999</tcpport>
</jsonrpc>
</syntaxhighlight>

== Audio/video playback settings ==

=== skiploopfilter ===
{{anchor|.3Cskiploopfilter.3E}}
The amount of the loop filter to skip on h.264 decoding. This can help the performance of slower machines when decoding h264 content. Values, in decreasing CPU usage (and decreasing quality)
* -16 None
* 0 Skip only empty frames (default)
* 8 Skip non-reference frames
* 16 Skip bi-dir frames
* 32 Skip all non-key frames
* 48 Skip all frames
Example:
<syntaxhighlight lang=xml enclose="div">
<skiploopfilter>8</skiploopfilter>
</syntaxhighlight>

=== video ===
{{anchor|.3Cvideo.3E}}

The <video> section also includes the following child-tags, which have their own sections:
*[[#cleandatetime]]
*[[#cleanstrings]]
*[[#excludefromscan]]
*[[#excludefromlisting]]
*[[#excludetvshowsfromscan]]

{{note|Some tags that have a "third-level" and are grouped together are highlighted in color.}}

{| class="prettytable"
! Tag !! Description
|-
|
<syntaxhighlight lang=xml>
<video>
</syntaxhighlight>
| Parent tag that all other child tags need to be placed inside of. Do not use more than one '''<code><video></code>''' tag, but instead place all other child-tags within a single '''<code><video></video></code>''' set.
|-
|
<syntaxhighlight lang=xml>
<subsdelayrange>10</subsdelayrange>
</syntaxhighlight>
| Delay range for subtitles, in seconds.
|-
|
<syntaxhighlight lang=xml>
<maxtempo>2.1</maxtempo>
</syntaxhighlight>
| Allow further increase of playback speed over the default of 1.5<br>
maxtempo must be in the range of 1.5 to 2.1 <br>
Be aware of the limitations of your platform / hardware as not all are capable of the increased maxtempo <ref>https://forum.kodi.tv/showthread.php?tid=10023&pid=2795069#pid2795069</ref>
|-
|
<syntaxhighlight lang=xml>
<audiodelayrange>10</audiodelayrange>
</syntaxhighlight>
| Delay range for audio/video sync, in seconds.
|-
|
<syntaxhighlight lang=xml>
<usetimeseeking>true</usetimeseeking>
</syntaxhighlight>
| Whether to use time based or percentage based seeking. {{small see also|Skip steps}}
|-
|
<syntaxhighlight lang=xml>
<timeseekforwardbig>600</timeseekforwardbig>
<timeseekbackwardbig>-600</timeseekbackwardbig>
</syntaxhighlight>
| Time to seek forward in seconds when doing a long seek. Defaults to 600 (10 minutes) and -600 (-10 minutes) respectively. ''{{small|See also: [[Skip steps]] }}''
|-
|
<syntaxhighlight lang=xml>
<percentseekforward>2</percentseekforward>
<percentseekbackward>-2</percentseekbackward>
</syntaxhighlight>
| Amount to seek forward as a percentage, when doing a short seek. Defaults to 2 (2%) and -2 (2%) respectively. ''{{small|See also: [[Skip steps]] }}''
|-
|
<syntaxhighlight lang=xml>
<percentseekforwardbig>10</percentseekforwardbig>
<percentseekbackwardbig>-10</percentseekbackwardbig>
</syntaxhighlight>
| Amount to seek forward as a percentage, when doing a long seek. Defaults to 10 (10%) and -10 (10%) respectively. ''{{small|See also: [[Skip steps]] }}''
|-
|
<syntaxhighlight lang=xml>
<fullscreenonmoviestart>true</fullscreenonmoviestart>
</syntaxhighlight>
| Whether to go to fullscreen or not when starting a movie. Defaults to true.
|-
|
<syntaxhighlight lang=xml>
<defaultplayer>VideoPlayer</defaultplayer>
</syntaxhighlight>
| Set the default video player: VideoPlayer or an external player. See '''[[External players]]''' for more info.
|-
|
<syntaxhighlight lang=xml>
<excludefromscan>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromscan>
</syntaxhighlight>
| Regular expressions that if evaluated to true won't be added to library. It is possible to add multiple <code><regexp></code> tags to match multiple patterns
|-
|
<syntaxhighlight lang=xml>
<excludefromlisting>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>
</syntaxhighlight>
| Regular expressions that if evaluated to true won't be displayed in files view.
|-
|
<syntaxhighlight lang=xml>
<playcountminimumpercent>90</playcountminimumpercent>
</syntaxhighlight>
| Minimum percentage that has to be played before it is marked as watched. Set to 101 to never auto-mark items as watched. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang=xml>
<ignoresecondsatstart>180</ignoresecondsatstart>
</syntaxhighlight>
| Number of seconds to ignore at video start after which a resume point is created. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang=xml>
<ignorepercentatend>8</ignorepercentatend>
</syntaxhighlight>
| Percentage of video to ignore at the end. If you stop watching the video here no resume point is created. Set to 101 to never save a resume point. The video is already marked as watched at 90%, see above. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang=xml>
<vdpauscaling>true</vdpauscaling>
</syntaxhighlight>
| Scales with vdpau instead of opengl and turns on its HQ scaler when available, enabling this might slow down rendering and cause framedrops especially on ION systems, this setting requires a vdpau feature set C GPU.
|-
|
<syntaxhighlight lang=xml>
<ppffmpegdeinterlacing>linblenddeint</ppffmpegdeinterlacing>
</syntaxhighlight>
| Override the deinterlacing options passed to libpostproc.
|-
|
<syntaxhighlight lang=xml>
<ppffmpegpostprocessing>ha:128:7,va,dr</ppffmpegpostprocessing>
</syntaxhighlight>
| Override the post processing options passed to libpostproc when 'Video post-processing' is activated in GUI Videos-Settings-Playback.
|-
|
<syntaxhighlight lang=xml>
<autoscalemaxfps>30</autoscalemaxfps>
</syntaxhighlight>
| When scaling method is set to auto, bilinear is chosen when the fps is higher than this limit, the default is 30.
|-
|
<syntaxhighlight lang=xml>
<adjustrefreshrate>
</syntaxhighlight>
| style="background:#CADCFB;" | Settings for when "Adjust refreshrate to match video fps" is enabled in the video playback GUI settings.
|-
|
<syntaxhighlight lang=xml>
<override>
<fps>23.976</fps>
<refresh>60.0</refresh>
</override>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' "Adjust refreshrate to match video fps" will try to select the best refreshrate for the video fps but it doesn't always get it right, for example it might switch to an unsupported refreshrate. You can add overrides here to switch to a certain refreshrate based on video fps. It's possible to add as many overrides as you need. Overrides are processed in order, if the first one doesn't match the fps or no refreshrates match that override, it will try the next one until no overrides are left.

* '''fps''' - if the fps is between 23.966 and 23.986
* '''refresh''' - switch to the first found refreshrate that is between 59.99 and 60.01
|-
|
<syntaxhighlight lang=xml>
<override>
<fpsmin>29.96</fpsmin>
<fpsmax>30.01</fpsmax>
<refreshmin>59.0</refreshmin>
<refreshmax>61.0</refreshmax>
</override>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -'''
* '''fpsmin''' / '''fpsmin''' - You can also specify the fps range yourself.
* '''refreshmin''' / '''refreshmax''' - Same for the refreshrate
|-
|
<syntaxhighlight lang=xml>
<fallback>
<refresh>50.0</refresh>
</fallback>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' If none of the overrides match, or none of the refreshrates match any of the fps matching overrides, it will choose a fallback refreshrate. Fallbacks are process in order, if the first fallback doesn't match any refreshrate, it will try the next one until no fallbacks are left.

* '''refresh''' - Switch to the first found refreshrate that is between 49.99 and 50.01.
|-
|
<syntaxhighlight lang=xml>
<fallback>
<refreshmin>49.0</refreshmin>
<refreshmax>51.0</refreshmax>
</fallback>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' You can also specify the range for the fallback yourself.

If none of the overrides match the video fps, or no refreshrates match any of the fps matching overrides, and no fallbacks are specified or no refreshrates match any fallbacks, it will automatically choose the best refreshrate (same as having no overrides and fallbacks).
|-
|
<syntaxhighlight lang=xml>
</adjustrefreshrate>
</syntaxhighlight>
| style="background:#CADCFB;" |
|-
|
<syntaxhighlight lang=xml>
<checkdxvacompatibility>value</checkdxvacompatibility>
</syntaxhighlight>
| Advanced setting not present: let Kodi autodetect cards that support H.264 profile > L4.1. Set value to false to enable DXVA no matter what. Set value to true if Kodi doesn't autodetect that the graphics card doesn't support > L4.1.
|-
|
<syntaxhighlight lang=xml>
<useocclusionquery>-1</useocclusionquery>
</syntaxhighlight>
| Use an occlusion query when capturing videoframes, -1 means auto detect, 0 means disabled, 1 means enabled, the default is -1.
|-
|
<syntaxhighlight lang=xml>
<fpsdetect>1</fpsdetect>
</syntaxhighlight>
| FPS detection for video playback
* 0 = trust codec fps
* 1 = recalculate from video timestamps with uniform spacing
* 2 = recalculate from video timestamps always
|-
|
<syntaxhighlight lang=xml>
<latency>
<delay>0</delay>
<hdrextradelay>0</hdrextradelay>
<refresh>
<min></min>
<max></max>
<rate></rate>
<delay></delay>
<hdrextradelay></hdrextradelay>
</refresh>
</latency>
</syntaxhighlight>
| '''Latency''' helps correct audio/video synchronization (lip-sync) when the display's internal processing introduces noticeable delays in the display of the pictures. The optional overrides and hdr extra delay offer further fine-tuning when the delay is not the same for all refresh rates or the HDR vs SDR modes. Latency is given in milliseconds. For one-off adjustments use the OSD during playback to adjust audio synchronisation.<br/><br/>
'''<delay>''' - Global default display latency.<br>
'''<hdrextradelay>''' - Global default latency added to the global default display latency when the display is in any HDR mode. Note: the display HDR mode is not detected on all platforms (Windows-only at time of writing).<br>
'''<refresh>''' - Override latency for given display (not video) refresh rates. When Kodi is in windowed mode, override is ignored. Multiple overrides are allowed.<br>
'''<min>''', '''<max>''' - refresh rate range, OR<br>
'''<rate>''' - exact refresh rate<br>
'''<delay>''' - display latency for the given refresh rate<br>
'''<hdrextradelay>''' - additional latency when the display is in any HDR mode for the given refresh rate<br>
<br/>
'''Example:''' The following example sets display latency of 125 msec at 23-24 Hz
<syntaxhighlight lang=xml>
<refresh>
<min>23</min>
<max>24</max>
<delay>125</delay>
</refresh>
</syntaxhighlight>
<br/>
'''Example:''' The following example sets display latency of 50 msec at 50 (+/-0.01) Hz
<syntaxhighlight lang=xml>
<refresh>
<rate>50</rate>
<delay>50</delay>
</refresh>
</syntaxhighlight>

|-
|
<syntaxhighlight lang=xml>
<stereoscopicregex3d>[-. _]3d[-. _]</stereoscopicregex3d>
<stereoscopicregexsbs>[-. _]h?sbs[-. _]</stereoscopicregexsbs>
<stereoscopicregextab>[-. _]h?tab[-. _]</stereoscopicregextab>
</syntaxhighlight>
| Filename triggers for 3D (stereoscopic) mode.
|-
|
<syntaxhighlight lang=xml>
<assfixedworks>false</assfixedworks>
</syntaxhighlight>
| Position behavior of ass subtitiles when setting "subtitle position on screen" set to "fixed". True to show at the fixed position set in video calibration. False to show at the bottom of video (default). {{note|Removed in Kodi v20.}}
|-
|
<syntaxhighlight lang=xml>
<subtitleverticalmargin>120</subtitleverticalmargin>
</syntaxhighlight>
| Allows to customise the vertical margin of text based subtitles, which will be applied to each type of subtitle position in subtitle settings. {{note|Available in Kodi v20 and above.}}
|-
|
<syntaxhighlight lang=xml>
</video>
</syntaxhighlight>
|
|}

=== audio ===
{{anchor|.3Caudio.3E}}
<syntaxhighlight lang=xml enclose="div">
<audio>

<headroom>0</headroom>

<defaultplayer>paplayer</defaultplayer>

<excludefromscan>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromscan>

<excludefromlisting>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromlisting>

<ac3downmixgain>12.0</ac3downmixgain>

<usetimeseeking>true</usetimeseeking>

<timeseekforwardbig>600</timeseekfowardbig>

<timeseekbackwardbig>-600</timeseekbackward>

<playcountminimumpercent>99</playcountminimumpercent>

<applydrc>-1.0</applydrc>

<limiterhold>0.025</limiterhold>

<limiterrelease>0.1</limiterrelease>

<maxpassthroughoffsyncduration>10</maxpassthroughoffsyncduration>

<allowmultichannelfloat>false</allowmultichannelfloat>

<superviseaudiodelay>false</superviseaudiodelay>
</audio>
</syntaxhighlight>

=== forcedswaptime ===
{{anchor|.3Cforcedswaptime.3E}}
Use to force a backbuffer->frontbuffer swap while vsync is enabled. Set to the time (in ms) to allow for the swap (e.g. <forcedswaptime>1</forcedswaptime> is typical).

Default: Off

=== edl ===
{{anchor|.3Cedl.3E}}
{{main|Edit_decision_list}}
Commercial break detection not as good you think it could be? Are some commercial breaks in a series of adverts not being skipped? Are some parts being skipped that are clearly not commercials? Does the end of the previous recording still show? The following advanced settings can be used to better identify full commercial break sequences, remove incorrectly flagged commercial breaks, and have playback start at the actual beginning of the recording.

<syntaxhighlight lang=xml enclose="div">
<edl>

<mergeshortcommbreaks>false</mergeshortcommbreaks>


<maxcommbreaklength>250</maxcommbreaklength>


<mincommbreaklength>90</mincommbreaklength>


<maxcommbreakgap>120</maxcommbreakgap>


<commbreakautowait>0</commbreakautowait>


<commbreakautowind>0</commbreakautowind>


<displaycommbreaknotifications>false</displaycommbreaknotifications>
</edl>
</syntaxhighlight>
'''Notes:'''
* displaycommbreaknotifications<ref>https://github.com/xbmc/xbmc/pull/20711</ref>

== PVR & Live TV ==
{{anchor|.3Cpvr.3E}}
Settings available for PVR, EPG and Live TV. Edit Decision List settings are located in the previous section.

=== pvr ===
<syntaxhighlight lang="xml" line='line'>
<pvr>
<timecorrection>0</timecorrection> 
<infotoggleinterval>3000</infotoggleinterval> 
<channeliconsautoscan>true</channeliconsautoscan> 
<autoscaniconsuserset>false</autoscaniconsuserset> 
<numericchannelswitchtimeout>1000</numericchannelswitchtimeout> 
</pvr>
</syntaxhighlight>

==== pvrrecordings ====
In v19 and later, allows users to modify sort type and order of pvr recordings. <ref>https://github.com/xbmc/xbmc/pull/18605</ref>

;Note- These settings are child tags to the ''<pvr>'' tag in the previous section.

<syntaxhighlight lang="xml" line='line'>
<pvr>
<pvrrecordings>
<sortmethod>2</sortmethod> 
<sortorder>2</sortorder> 
</pvrrecordings>
</pvr>
</syntaxhighlight>

=== epg ===
{{anchor|.3Cpvr.3E}}
<syntaxhighlight lang="xml" line='line'>
<epg>
<updatecheckinterval>300</updatecheckinterval> 
<updateemptytagsinterval>60</updateemptytagsinterval> 
<cleanupinterval>900</cleanupinterval> 
<activetagcheckinterval>60</activetagcheckinterval> 
<retryinterruptedupdateinterval>60</retryinterruptedupdateinterval> 
<displayupdatepopup>true</displayupdatepopup> 
<displayincrementalupdatepopup>false</displayincrementalupdatepopup> 
</epg>
</syntaxhighlight>

== Video library settings ==

=== videoextensions ===
{{anchor|.3Cvideoextensions.3E}}<section begin="videoextensions" />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Video windows.

Default extensions for VIDEOS:
<pre>
.m4v .3g2 .3gp .nsv .tp .ts .ty .strm .pls .rm .rmvb .mpd .m3u .m3u8 .ifo .mov .qt .divx .xvid
.bivx .vob .nrg .img .iso .udf .pva .wmv .asf .asx .ogm .m2v .avi .bin .dat .mpg .mpeg .mp4
.mkv .mk3d .avc .vp3 .svq3 .nuv .viv .dv .fli .flv .001 .wpl .xspf .zip .vdr .dvr-ms .xsp .mts
.m2t .m2ts .evo .ogv .sdp .avs .rec .url .pxml .vc1 .h264 .rcv .rss .mpls .mpl .webm .bdmv
.bdm .wtv .trp .f4v
</pre>
Examples:
<pre>
<videoextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</videoextensions>
</pre>
<section end="videoextensions" />

=== discstubextensions ===
{{main|Media stubs}}

<section begin="discstubextensions" />
The default filename extension for Disc Stubs is:
<syntaxhighlight lang=xml enclose="div">
.disc
</syntaxhighlight>
Using the following tags, it is possible to <tt><add></tt> additional or <tt><remove></tt> existing disc stub extensions to better suit your requirements.
<syntaxhighlight lang=xml enclose="div">
<discstubextensions>
<add>.disk|.stub</add>
<remove>.disc</remove>
</discstubextensions>
</syntaxhighlight>
<section end="discstubextensions" />

=== languagecodes ===
{{anchor|.3Clanguagecodes.3E}}
User-defined translation table for language codes used in subtitles and audio.
It can be used to add, extend or override Kodi's language codes.

'''How to add a new language code:'''

<syntaxhighlight lang=xml enclose="div">
<languagecodes>
<code>
<short>alt</short>
<long>Alternate</long>
</code>
</languagecodes>
</syntaxhighlight>

'''How to add a new language code with subtag (e.g. pt-BR):'''
{{note|This support is available from Kodi v20}}

<syntaxhighlight lang=xml enclose="div">
<languagecodes>
<code>
<short>pt-BR</short>
<long>Portuguese - Brazil</long>
</code>
</languagecodes>
</syntaxhighlight>

''NOTE FOR MKV FILES:''<br/>
MKV files that contain audio/subtitle tracks with language codes with subtags are not yet supported, but from <code>Kodi v21</code> a workaround was introduced that allows Kodi to recognize language codes with subtags.
To use the workaround, you must open the MKV file with an editor and in the metadata of the desired audio/subtitle track, edit the track Name (or Title field) by adding the language code wrapped in curly brackets, as in following example:
<br/><code>Original track name: Audio portuguese/brazil</code>
<br/><code>Modified track name: Audio portuguese/brazil {pt-BR}</code>

'''How to extend an existing language code:'''

Set the same "long" description of the existing language, for example we reuse the Portughese language for another language code:

<syntaxhighlight lang=xml enclose="div">
<languagecodes>
<code>
<short>pt-BR</short>
<long>Portuguese</long>
</code>
</languagecodes>
</syntaxhighlight>

In this case when in Kodi settings you set the "Portuguese" language, when in playing according to availability the track "pt" or "pt-BR" will be chosen.

'''How to override an existing language code:'''

This allow you to rename an existing language. Set to an existing language code your preferred "long" name description.

''WARNING: This can cause problems with add-ons, so do not override languages if you are not aware of the side effects.''

<syntaxhighlight lang=xml enclose="div">
<languagecodes>
<code>
<short>en</short>
<long>English example</long>
</code>
<code>
<short>en-GB</short>
<long>English example</long>
</code>
</languagecodes>
</syntaxhighlight>

=== moviestacking ===
{{anchor|.3Cmoviestacking.3E}}<section begin="moviestacking" />
{{main|Naming_video_files/Movies}}
This is used by the [[Naming_video_files/Movies#Split_Video_Files|file stacking]] algorithm to combine multi-part files and contains a list of regular expressions. For stacking videos that are contained in folders, such as VIDEO_TS folders, see '''[[advancedsettings.xml#folderstacking|<folderstacking>]]'''

As of v9.11, video stacking regular expressions '''must''' contain exactly four (4) capture expressions.

Default:
<syntaxhighlight lang=xml enclose="div">
<moviestacking>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[0-9]+)(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[a-d])(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ ._-]*[a-d])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="append"</tt> or <tt>append="yes"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the end.

Example:
<syntaxhighlight lang=xml enclose="div">
<moviestacking action="append">

<regexp>(.*?)([ ._-]*[0-9])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="prepend"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the beginning.

Example:
<syntaxhighlight lang=xml enclose="div">
<moviestacking action="prepend">
<regexp>(Title)(Volume)(Ignore)(Extension)</regexp>
</moviestacking>
</syntaxhighlight>

If no argument is supplied, or the argument <tt>append="no"</tt> is supplied, the default moviestacking regular expressions are overwritten by the user specified ones.
<section end="moviestacking" />

=== folderstacking ===
{{main|Naming_video_files/Movies}}
This is similar to '''[[advancedsettings.xml#moviestacking|<moviestacking>]]''', but is used for videos that are contained in folders that use the folder names to stack, such as VIDEO_TS folders (DVD rips that are not in ISO format).

Default:
<syntaxhighlight lang=xml enclose="div">
<folderstacking>

<regexp>((cd|dvd|dis[ck])[0-9]+)$</regexp>
</folderstacking>
</syntaxhighlight>

=== cleandatetime ===
{{anchor|.3Ccleandatetime.3E}}
Matches a year number in a string using a Regular Expression

Default expression:
<syntaxhighlight lang=xml enclose="div">
<video>
<cleandatetime>(.*[^ _\,\.\[\]\-])[ _\.\[\]\-]+(19[0-9][0-9]|20[0-9][0-9])([ _\,\.\[\]\-]|[^0-9]$)?</cleandatetime>
</video>
</syntaxhighlight>
:* The string found before will be used as basis string getting cleaned by the cleanstrings expressions.
:* By default date formats like MM:YY are ignored.

=== cleanstrings ===
{{anchor|.3Ccleanstrings.3E}}
Clean unwanted characters from filenames or folders by using a list of Regular Expressions. Please note that everything right of the match (at the end of the file name) is removed, so if you would have a file named ''Super movie.mp4'' and would add <tt><regexp> </regexp></tt> (only a space), the only thing that would be left is ''Super'', which is probably not what you want.

{{Github_link|[https://github.com/xbmc/xbmc/blob/Nexus/xbmc/settings/AdvancedSettings.cpp#L201-L211 Code in Github]}}

Default expressions:
<syntaxhighlight lang=xml enclose="div">
<video>
<cleanstrings>
<regexp>([ _\\,\\.\$\$\\[\\]\\-](10bit|480p|480i|576p|576i|720p|720i|1080p|1080i|2160p|3d|aac|ac3|aka|atmos|avi|bd5|bdrip|bluray|brrip|cam|cd[1-9]|custom|dc|ddp|divx|divx5|dolbydigital|dolbyvision|dsr|dsrip|dts|dts-hdma|dts-hra|dts-x|dv|dvd|dvd5|dvd9|dvdivx|dvdrip|dvdscr|dvdscreener|extended|fragment|fs|h264|h265|hdr|hdr10|hevc|hddvd|hdrip|hdtv|hdtvrip|hrhd|hrhdtv|internal|limited|multisubs|nfofix|ntsc|ogg|ogm|pal|pdtv|proper|r3|r5|read.nfo|remastered|remux|repack|rerip|retail|screener|se|svcd|tc|telecine|telesync|truehd|ts|uhd|unrated|ws|x264|x265|xvid|xvidvd|xxx|web-dl|webrip|www.www|\\[.*\\])([ _\\,\\.\$\$\\[\\]\\-]|$)");</regexp>
<regexp>(\[.*\])</regexp>
</cleanstrings>
</video>
</syntaxhighlight>
Updated in v20<ref>https://github.com/xbmc/xbmc/pull/20549</ref>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== tvshowmatching ===
{{anchor|.3Ctvshowmatching.3E}}
Matches the season and episode numbers in file paths by using a list of Regular Expressions

{{Github_link|[https://github.com/xbmc/xbmc/blob/Matrix/xbmc/settings/AdvancedSettings.cpp#L232 Code in Github]}}

Defaults:
<syntaxhighlight lang=xml enclose="div">
<tvshowmatching>
<regexp>s([0-9]+)[ ._x-]*e([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)([^\\\\/]*)$</regexp> 
<regexp>[\._ -]()[Ee][Pp]_?([0-9]+)([^\\/]*)$</regexp> 
<regexp>([0-9]{4})[\.-]([0-9]{2})[\.-]([0-9]{2})</regexp> 
<regexp>([0-9]{2})[\.-]([0-9]{2})[\.-]([0-9]{4})</regexp> 
<regexp>[\\/\._ \[\(-]([0-9]+)x([0-9]+)([^\\/]*)$</regexp> 
<regexp>[\\/\._ -]([0-9]+)([0-9][0-9])([\._ -][^\\/]*)$</regexp> 
<regexp>[\/._ -]p(?:ar)?t[_. -]()([ivx]+)([._ -][^\/]*)$</regexp> 
</tvshowmatching>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)
:* Paths are converted to lower case before matching.
:* For multi-episode matching to work, there needs to be a third set of parentheses '()' at the end, this part is fed back into the regexp engine.
:* A [https://forum.kodi.tv/showthread.php?tid=51614 forum thread] has a discussion of pre-made regex lists to match common names. These might improve Kodi's ability to match TV show names in some situations, at the risk of additional false positives.

==== Filenames without Season ====
There are two methods to add episodes without a season in their file path. Both ways will force the season to '1' by default, so that you can use
the 'Use Absolute Ordering (Single Season)' setting from the TheTvDb.com scraper.

; Simple Method ''(XBMC v9.11 onwards and Kodi)''
: Use only one pair of parentheses
<syntaxhighlight lang=xml enclose="div"><regexp>[/\._ \-]([0-9]+)</regexp></syntaxhighlight>
; Advanced Method ''(XBMC v10.05 onwards and Kodi)''
: Supports multi-episode files without season
: Use an empty pair of parentheses for the season
<syntaxhighlight lang=xml enclose="div"><regexp>[/\._ \-]()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

; Specifying Default Season ''(XBMC v12.0 onwards and Kodi)''
It is possible to set the default season for specific regular expressions by setting the 'defaultseason' attribute.
: Works with both the simple method and advanced method
: If not used, the season will be set to '1'
: Useful for setting specials to season '0'
<syntaxhighlight lang=xml enclose="div"><regexp defaultseason="0">[/\._ \-]X()([0-9]+)(-[0-9]+)?</regexp>
<regexp defaultseason="1">[/\._ \-]E()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

=== tvmultipartmatching ===
{{anchor|.3Ctvmultipartmatching.3E}}
Matches a multipart episode number based on a previously identified episode file, using a list of Regular Expressions.

Default:
<syntaxhighlight lang=xml enclose="div">
<tvmultipartmatching>^[-_ex]+([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)</tvmultipartmatching>
</syntaxhighlight>
:* Text matching is compared case-insensitive.
:* Specifying this option '''replaces''' the default value

=== excludefromscan ===
{{anchor|.3Cexcludefromscan.3E}}
Matches filenames or folders which should be excluded from a library scan (except tvshows) using a list of Regular Expressions. This can be for both Video or Audio sections of <tt>advancedsettings.xml</tt>.

Defaults:
<syntaxhighlight lang=xml enclose="div">
<video>
<excludefromscan>
<regexp>-trailer</regexp>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludefromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== excludefromlisting ===
{{anchor|.3Cexcludefromlisting.3E}}
<syntaxhighlight lang=xml enclose="div">
<video>
<excludefromlisting> 
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>
</video>
</syntaxhighlight>

=== excludetvshowsfromscan ===
{{anchor|.3Cexcludetvshowsfromscan.3E}}
Matches filenames or folders which should be excluded from a tvshow library scan using a list of Regular Expressions

Defaults:
<syntaxhighlight lang=xml enclose="div">
<video>
<excludetvshowsfromscan>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludetvshowsfromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== trailermatching ===
{{anchor|.3Ctrailermatching.3E}}
Contains Regular Expression syntax to match the locally stored trailers to movies in the library. Only files with recognized video file extensions will be considered, and the extensions are removed for the Regular Expression evaluation.

<syntaxhighlight lang=xml enclose="div">
<trailermatching>

<regexp>(.*?)(_Trailer)$</regexp>
</trailermatching>
</syntaxhighlight>

=== videolibrary ===
{{anchor|.3Cvideolibrary.3E}}
Options specific to the Video Library

{{Note|Kodi v20 users don't need set "importwatched" or "importresumepoint" to true anymore as that's the default then <ref>https://github.com/xbmc/xbmc/pull/20842</ref>}}

<syntaxhighlight lang="xml" line='line'>
<videolibrary>
<allitemsonbottom>false</allitemsonbottom> 
<cleanonupdate>false</cleanonupdate> 
<usefasthash>true</usefasthash> 
<recentlyaddeditems>35</recentlyaddeditems> 
<itemseparator> / </itemseparator> 
<exportautothumbs>false</exportautothumbs> 
<importwatchedstate>false</importwatchedstate> 
<importresumepoint>false</importresumepoint> 
<dateadded>1</dateadded> 
</videolibrary>
</syntaxhighlight>

=== videoscanner ===
{{anchor|.3Cvideoscanner.3E}}
Options specific to the Video scanner
<syntaxhighlight lang=xml enclose="div">
<videoscanner>
<ignoreerrors>true</ignoreerrors> 
</videoscanner>
</syntaxhighlight>

== Library artwork ==

{{note|Using <imageres>9999</imageres> and <fanartres>9999</fanartres> will allow caching artwork at original size.}}

=== imageres ===
{{anchor|.3Cimageres.3E}}

<section begin="imageres description" />Specify the maximum resolution that [[Artwork/Cache#Texture optimization| cached artwork]] (other than fanart / 16:9 images) should be resized to in pixels. The width is automatically calculated as being 16/9*height. The image will be resized to fit within this size. e.g. an image that is 2000x500 will be cached at size 1280x320. An image that is 500x800 will be cached at size 450x720 using the default value of 720.<section end="imageres description" />

<syntaxhighlight lang=xml enclose="div">
<imageres>720</imageres>
</syntaxhighlight>

=== fanartres ===
{{anchor|.3Cfanartres.3E}}

<section begin="fanartres description" />Specify the maximum resolution that [[Artwork/Cache#Texture optimization| cached fanart]] should be resized to in pixels. The width is automatically calculated as being 16/9*height. Only images that are exactly 16x9 and equal to or greater than this resolution will be cached at this size - all other images will be cached using <imageres>. The default value is 1080.<section end="fanartres description" />

<syntaxhighlight lang=xml enclose="div">
<fanartres>1080</fanartres>
</syntaxhighlight>

=== imagescalingalgorithm ===
Specify the image scaling algorithm for image resizing when [[Artwork/Cache#Texture optimization| caching artwork]] to the local texture cache.
<br />
<syntaxhighlight lang=xml enclose="div">
<imagescalingalgorithm>bicubic</imagescalingalgorithm>
</syntaxhighlight>

[https://github.com/xbmc/xbmc/blob/master/xbmc/pictures/PictureScalingAlgorithm.cpp#L20-L32 Available image scaling algorithms]

<syntaxhighlight lang=text enclose="div">
fast_bilinear
bilinear
bicubic
experimental
nearest_neighbor
averaging_area
bicublin
gaussian
sinc
lanczos
bicubic_spline
</syntaxhighlight>

=== imagequalityjpeg ===
This specifies the quality of the images when stored in jpeg format. By default kodi uses a quality of 4 which is a good compromise between size and quality. If you want to reduce the thumbnail sizes (decreasing quality) choose a higher value up to 21. If high quality (large thumbnail size) is needed, chose a smaller value, e.g. 0,1,2 or 3. (Added in v20 <ref>https://github.com/xbmc/xbmc/pull/21418</ref>)
<br />
<syntaxhighlight lang=xml enclose="div">
<imagequalityjpeg>4</imagequalityjpeg>
</syntaxhighlight>

== Video and music library settings ==

=== playlistasfolders ===
{{anchor|.3Cplaylistasfolders.3E}}
In the recent releases, playlists are treated as folders. Selecting a playlist no longer plays it, but opens it, as if it were a folder.

Set to false to revert to the previous behaviour. When you select a playlist, its content is added to the list of elements to be played.

:{{note|This setting will not affect smart playlists, they will always show as folders.}}

;Example
<syntaxhighlight lang=xml enclose="div">
<playlistasfolders>true</playlistasfolders>
</syntaxhighlight>

=== playlistretries ===
{{anchor|.3Cplaylistretries.3E}}
The number of retries attempted if a source is offline. With this control you can alter the number of consecutive failed items before a playlist fails.

Default:
<syntaxhighlight lang=xml enclose="div">
<playlistretries>100</playlistretries>
</syntaxhighlight>

=== playlisttimeout ===
{{anchor|.3Cplaylisttimeout.3E}}
The timeout, in seconds, before item failure.

Default:
<syntaxhighlight lang=xml enclose="div">
<playlisttimeout>20</playlisttimeout>
</syntaxhighlight>

=== sorttokens ===
Allows you to specify additional tokens that will be ignored at the start of lines during sorting.
{{note|Sort tokens are case sensitive.}}
<syntaxhighlight lang=xml enclose="div">
<sorttokens>
<token>the</token>
</sorttokens>
</syntaxhighlight>

In the above example "the ", "the." and "the_" will be ignored at the start of titles or names when sorting items, in both video and music libraries. A separator can also be specified, for example
<syntaxhighlight lang=xml enclose="div">
<sorttokens>
<token separators="'">L</token>
</sorttokens>
</syntaxhighlight>
In that case the value L', as in French movie name ''L'argent'', will be ignored and the item listed under "A".

=== musicdatabase/videodatabase ===
{{anchor|.3Cmusicdatabase.3E/.3Cvideodatabase.3E|musicdatabase/videodatabase|database tags music/video/tv/epg}}
{{main|MySQL}}
<section begin="videodatabase" />
Allows advanced customization of the default database settings for music, video, TV, and EPG databases.

:{{note| '''It is HIGHLY recommended that you not attempt to place an sqlite3 database outside of kodi's path. sqlite3 contains no filesystem abstraction, so this will plain break on any non-local (as far as Kodi is concerned) paths. Use this for mysql only.'''}}

'''Parent tags:'''

* '''<videodatabase>'''
* '''<musicdatabase>'''
* '''<tvdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
* '''<epgdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
{{MySQL warning}}

'''Child tags: '''

;<type>
: ''Required'' - Can be either "sqlite3" or "mysql" (default: sqlite3)

;<host>
:''Required'' -
* sqlite3: defines the relative path to the database file (eg. /usr/local/kodi/databases).
* mysql: defines the host of the mysql socket (eg. localhost, 192.168.0.1, etc)

;<port>
: ''Optional'' -
* sqlite3: silently ignored
* mysql: defines the port of the mysql socket (default: 3306)

;<name>
: ''Optional'' -
:by default "MyVideos"+DB number will be used.
* sqlite3: defines the name of the database file to read from, excluding the ".db" extension.
* mysql: defines the name of the database to use

;<user>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the user with privileged access to the database

;<pass>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the password for the user with privileged access to the database

;<connecttimeout> [https://github.com/xbmc/xbmc/pull/26657]
: ''Optional'' -
* sqlite3: silently ignored
* mysql: defines a connect timeout, in seconds. Default value is 5 seconds.

;<compression>
: ''Optional'' - Defaults to false. Set to "true" to enable MySQL compression protocol. Performance benefit is going to be largely dependent on the network bandwidth, latency between database and clients and on the size of the result sets. [https://github.com/xbmc/xbmc/pull/6484]
: {{Note|Slower clients (such as the RPi and others) won't benefit from it as the zlib de-compression overhead is higher than the actual compression savings}}

;<key>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<cert>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ca>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<capath>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ciphers>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

'''Examples:'''

1) Configure a database for MySQL.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', and '''<epgdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang=xml enclose="div">
<videodatabase>
<type>mysql</type>
<host>192.168.0.10</host>
<name>kodi_video</name>
<user>kodi</user>
<pass>kodi</pass>
<connecttimeout>3</connecttimeout>
</videodatabase>
</syntaxhighlight>

2) Configure a database for an sqlite database.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', and '''<epgdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang=xml enclose="div">
<musicdatabase>
<type>sqlite3</type>
<host>/usr/local/share/kodi/databases</host>
</musicdatabase>
</syntaxhighlight>

<section end="videodatabase" />

=== externalplayer ===
{{anchor|.3Cexternalplayer.3E}}
{{see|External players}}

== Music settings ==

=== musicextensions ===
{{anchor|.3Cmusicextensions.3E}}
<section begin="musicextensions" />
Default extensions for MUSIC:
<pre>
.nsv .m4a .flac .aac .strm .pls .rm .rma .mpa .wav .wma .ogg .mp3 .mp2 .m3u .gdm .imf .m15 .sfx
.uni .ac3 .dts .cue .aif .aiff .wpl .xspf .ape .mac .mpc .mp+ .mpp .shn .zip .wv .dsp .xsp .xwav
.waa .wvs .wam .gcm .idsp .mpdsp .mss .spt .rsd .sap .cmc .cmr .dmc .mpt .mpd .rmt .tmc .tm8
.tm2 .oga .url .pxml .tta .rss .wtv .mka .tak .opus .dff .dsf .m4b .dtshd
</pre>

It is possible to add or remove extensions for Music, using the following XML tags. Useful if you keep, say, FLAC and mp3 versions of music in the same folder. The <remove> tag can be used to remove mp3 from being listed in the library, leaving only the higher quality FLAC being displayed.

<musicextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</musicextensions>

<section end="musicextensions" />

=== cddbaddress ===
{{anchor|.3Ccddbaddress.3E}}
The address of the online CDDb database. You may set this to another freedb mirror if there is a more suitable one.

Default:
<syntaxhighlight lang=xml enclose="div>
<cddbaddress>freedb.freedb.org</cddbaddress>
</syntaxhighlight>

=== songinfoduration ===
{{anchor|.3Csonginfoduration.3E}}
This controls how long the song information will remain onscreen when the song changes during visualisations. The valid range is "1" to "Indefinite (0)", in seconds. This does not include the duration of any transition effects.

Default:
<syntaxhighlight lang=xml enclose="div">
<songinfoduration>10</songinfoduration>
</syntaxhighlight>

=== musicfilenamefilters ===
{{anchor|.3Cmusicfilenamefilters.3E}}
Contains filters to match music information (artist, title etc.) from a tag-less music filename. The first <filter> to match completely is used. Matched items include:

<pre>
%A - Artist
%T - Title
%B - Album
%N - Track number
%S - Part of set (disk number)
%D - Duration
%G - Genre
%Y - Year
%R - Rating
</pre>

Example:
<syntaxhighlight lang=xml enclose="div">
<musicfilenamefilters>
<filter>%A - %T</filter>
</musicfilenamefilters>
</syntaxhighlight>

=== musiclibrary ===
Options specific to the Music Library
<section begin="MusicLibrary" />
<syntaxhighlight lang="xml" line='line'>
<musiclibrary>
<recentlyaddeditems>35</recentlyaddeditems> 

<prioritiseapetags>true</prioritiseapetags> 

<allitemsonbottom>true</allitemsonbottom> 

<cleanonupdate>false</cleanonupdate> 

<artistsortonupdate>false</artistsortonupdate> 

<albumformat>%B - %Y</albumformat> 

<itemseparator> / </itemseparator> 

<dateadded>1</dateadded> 

<artistseparators> 
<separator>;</separator>
<separator>:</separator>
<separator>|</separator>
<separator> feat. </separator>
<separator> ft. </separator>
</artistseparators>


<useisodates>false</useisodates> 


<artistnavigatestosongs>true</artistnavigatestosongs> 
</musiclibrary>
</syntaxhighlight>
{{Note|Changing the <itemseparator> or <artistseparators> will only affect newly added items. A rescan won't change the existing ones. Remove the Source(s) or delete the Music DB and rebuild. This process should be made easier from v18 and up using <promptfulltagscan>. <artistseparators> are cAsE sensitive and only used if you are not using MBID's. Separators will be used alongside MBID's from v22 onwards.}}<section end="MusicLibrary" />

== Photos settings ==

=== pictureextensions ===
{{anchor|.3Cpictureextensions.3E}}
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Pictures window.

Default extensions for PICTURES:
<pre>
.png .jpg .jpeg .bmp .gif .ico .tif .tiff .tga .pcx .cbz .zip .rss .webp .jp2 .apng
</pre>

Examples:
<syntaxhighlight lang=xml enclose="div">
<pictureextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</pictureextensions>
</syntaxhighlight>

=== pictureexcludes ===
{{anchor|.3Cpictureexcludes.3E}}
Matches filenames or folders which should be excluded from being displayed in My Pictures using a list of Regular Expressions

<syntaxhighlight lang=xml enclose="div">
<pictureexcludes> 
<regexp>small</regexp>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</pictureexcludes>
</syntaxhighlight>

=== slideshow ===
{{anchor|.3Cslideshow.3E}}
<syntaxhighlight lang=xml enclose="div">
<slideshow>

<panamount>2.5</panamount>

<zoomamount>5.0</zoomamount>



<blackbarcompensation>20</blackbarcompensation>
</slideshow>
</syntaxhighlight>

== Network settings ==

=== ftp ===
{{anchor|.3Cftp.3DE}}
Specific settings if a ftp server is in use as a source

<syntaxhighlight lang=xml enclose="div">
<ftp>
<remotethumbs>true</remotethumbs> 
</ftp>
</syntaxhighlight>

=== samba ===
{{anchor|.3Csamba.3E}}
<syntaxhighlight lang=xml enclose="div">
<samba>
<doscodepage></doscodepage> 
<clienttimeout>10</clienttimeout> 
<statfiles>true</statfiles> 
</samba>
</syntaxhighlight>

=== hosts ===
{{anchor|.3Cfhosts.3E}}
Static dns entries which take precedence over your dns server.
<syntaxhighlight lang=xml enclose="div">
<hosts>
<entry name="HOSTNAME">IPADDRESS</entry>
</hosts>
</syntaxhighlight>

=== network ===
{{anchor|.3Cnetwork.3E}}

<syntaxhighlight lang=xml line='line'>
<network>
<curlclienttimeout>10</curlclienttimeout> 
<curllowspeedtime>20</curllowspeedtime> 
<curlretries>2</curlretries> 
<httpproxyusername></httpproxyusername> 
<httpproxypassword></httpproxypassword> 
<disableipv6>false</disableipv6> 
<disablehttp2>false</disablehttp2> 
<nfstimeout>30</nfstimeout> 
<catrustfile>filepath</catrustfile> 
<curlkeepaliveinterval>30</curlkeepaliveinterval> 
<nfsretries>0</nfsretries> 
</network>
</syntaxhighlight>

'''More information:'''<br>
* <curlkeepaliveinterval><ref>https://github.com/xbmc/xbmc/pull/19319</ref><br>
* <nfsretries><ref>https://github.com/xbmc/xbmc/pull/19513</ref>

=== airtunesport ===
{{anchor|.3Cairtunesport.3E}}<section begin="airtunesport" />
This overwrites the defalt listening port of the AirTunes server (announced via zeroconf).
<section end="airtunesport" />

=== airplayport ===
{{anchor|.3Cairplayport.3E}}<section begin="airplayport" />
This overwrites the default listening port of the AirPlay server (announced via zeroconf).
<section end="airplayport" />

== File system settings ==

=== packagefoldersize ===
<section begin="packagefoldersize" />
{{anchor|.3Cpackagefoldersize.3E}}
{{xml setting
| tag name = packagefoldersize
| option type = numerical
| option values =
| default values = 200
| platform = all
| XBMC version = 12
| description = The amount (in megabytes) of add-on zip packages saved from previous add-on installs. These packages are mainly used for the [[Add-ons|add-on]] rollback feature. Increasing the size should increase the amount of past versions saved. Defaults to 200 MB.
| example = Example: <syntaxhighlight lang=xml enclose="div"><packagefoldersize>200</packagefoldersize> </syntaxhighlight>
}}
<section end="packagefoldersize" />

=== detectasudf ===
{{anchor|.3Cdetectasudf.3E}}
{{xml setting
| tag name = detectasudf
| option type = binary
| option values = true, false
| default values = false
| platform = all
| XBMC version =
| description = Set to true if you wish to detect joint ISO9660/UDF disks as UDF.
| example = Example: <syntaxhighlight lang=xml enclose="div"><detectasudf>false</detectasudf></syntaxhighlight>
}}

=== handlemounting ===
{{anchor|.3Chandlemounting.3E}}
{{xml setting
| tag name = handlemounting
| option type = binary
| option values = true, false
| default values = false
| platform = Linux
| XBMC version =
| description = Only used in Linux, it defines if Kodi should attempt to mount media drives (via udisks or udisks2).<br/>Default: False. If kodi is executed with the --standalone option (e.g. as done by kodi-standalone.sh) it by default will be True.
| example = Example: <syntaxhighlight lang=xml enclose="div"><handlemounting>false</handlemounting></syntaxhighlight>
}}

=== automountopticalmedia ===
{{xml setting
| tag name = automountopticalmedia
| option type = binary
| option values = true, false
| default values = false
| platform = Linux
| XBMC version =
| description = Only used in linux for the udisks and udisks2 providers<br/>defines if kodi should automount optical discs<ref>https://github.com/xbmc/xbmc/pull/20840</ref>
| example = Example: <syntaxhighlight lang=xml enclose="div"><automountopticalmedia>true</automountopticalmedia></syntaxhighlight>
}}

=== pathsubstitution ===
{{anchor|.3Cpathsubstitution.3E}}
{{main|Path substitution}}

{{divbox|red||'''Note:''' Path substition for "sources" and profiles is broken, and will '''NOT''' be fixed.}}

Path substitutions are for use for redirecting file paths. These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for Kodi to handle.

Default: No path substitutions defined.

Example:
<syntaxhighlight lang=xml enclose="div">
<pathsubstitution>
<substitute>
<from>G:\dvds\</from>
<to>smb://somecomputer/g-share/dvds/</to> 
</substitute>
</pathsubstitution>
</syntaxhighlight>

== Input control settings ==

=== remotedelay ===
{{anchor|.3Cremotedelay.3E}}
The repeat delay for a LIRC remote control. A delay value between 1 and 20 before a remote button starts repeating on a long keypress (i.e. continuously sending button pushes while it's held down).

Default: 3
<syntaxhighlight lang=xml enclose="div">
<remotedelay>10</remotedelay>
</syntaxhighlight>

=== controllerdeadzone ===
{{anchor|.3Ccontrollerdeadzone.3E}}
This advanced settings has been removed.
Since v17, the [[Advancedsettings.xml#controllerdeadzone|<controllerdeadzone>]] advanced setting has been removed. Deadzones can now be configured by plugging in the controller and selecting it in Settings -> System settings -> Input -> Peripherals.

=== enablemultimediakeys ===
{{anchor|.3Cenablemultimediakeys.3E}}
This setting only has any effect on Windows versions of Kodi, and only applies to builds from 28th May 2011 onwards.
In Windows the multimedia keys generate a WM_APPCOMMAND message in addition the keypress. Kodi processes both keypresses and the WM_APPCOMMAND messages, and the end result would be that the command is executed twice. To avoid this, by default multimedia keypresses are disabled. Although it should rarely be necessary, the enablemultimediakeys setting allows you to enable the multimedia keys.

Example:
<syntaxhighlight lang=xml enclose="div">
<enablemultimediakeys>true</enablemultimediakeys>
</syntaxhighlight>

=== seeksteps ===
{{Main|Skip steps}}

This setting changes which increments are available in the settings GUI for additive seeking. Note that <code><seeksteps></code> is not used to actually choose which seek steps are enabled.

'''Default:'''
<syntaxhighlight lang=xml enclose="div">
<seeksteps>7, 15, 30, 60, 180, 300, 600, 900, 1800</seeksteps>
</syntaxhighlight>

{{editor note|the defaults need to be updated for seeksteps.}}

=== touchscreen ===
{{anchor|.3Ctouchscreen.3E}}
This setting allows you to move/align the origin of the touch screen with the origin of the display used. If touch input does not result in a correct movement of the mouse pointer, the behaviour can be corrected with an offset and a stretch/compress factor.

Example:
<syntaxhighlight lang=xml enclose="div">
<touchscreen>
<x_offset>0</x_offset> 
<y_offset>0</y_offset> 
<x_stretch_factor>1.0</x_stretch_factor> 
<y_stretch_factor>1.0</y_stretch_factor> 
</touchscreen>
</syntaxhighlight>

=== scanirserver ===
Introduced in v18 and used in MS Windows setups only.<ref>https://github.com/xbmc/xbmc/pull/13896</ref>
Used to disable the regular connection attempts to the IR Server Suite when there is no remote to connect to.

The default setting is to allow connection attempts. To disable connection attempts change value to '''false'''.
<syntaxhighlight lang=xml enclose="div">
<scanirserver>true</scanirserver>
</syntaxhighlight>

== GUI rendering settings ==

=== algorithmdirtyregions ===
{{anchor|.3Calgorithmdirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="algorithmdirtyregions" />{{note|Some GPU/hardware configurations will have some minor issues (such as a visual "flicker"). For those situations try mode 2 or use the default (mode 3, which requires no advancedsetting). Almost all ARM-based devices (such as [[Android]]) willl likely have flickering issues.}}

Enable dirty-region processing. Dirty regions are any parts of the screen that have changed since the last frame. By not re-rendering what hasn't changed the GUI can be sped up. Because all GPUs work differently, only Mode 3 is guaranteed to work for everyone without flickering issues. This mode will reduce CPU/GPU usage, but will not increase GUI speed.

{| class="prettytable"
! value !! result !! description
|-
! 0
| Off
| The entire viewport is always rendered.
|-
! 1
|Union
|All dirty regions are grouped into the smallest possible rectangle. This is typically the fastest mode for slower GPUs due to only making one pass.
|-
! 2
| {{nowrap|Cost reduction}}
| Each dirty region is presented separately, in as many passes as there are regions.
|-
! 3
| {{nowrap|Whole Screen}}
| The entire screen is rendered if there are any dirty regions. This is a safe default for drivers that clear buffer contents (manifests as blinking or vibrating images). '''Default'''
|}<section end="algorithmdirtyregions" />

Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<algorithmdirtyregions>1</algorithmdirtyregions>
</gui>
</syntaxhighlight>

=== visualizedirtyregions ===
{{anchor|.3Cvisualizedirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="visualizedirtyregions" />Enable dirty-region visualization. Paints a rectangle over marked controls.

* true: on
* false: off '''(Default)'''

{{note|This is only a development mode and isn't of use to normal users.}}
<section end="visualizedirtyregions" />
Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<visualizedirtyregions>true</visualizedirtyregions>
</gui>
</syntaxhighlight>

=== smartredraw ===

{{note|This is an experimental feature and you might face issues using it. So please be aware of that.}}

This new feature was introduced in Kodi 18 and if enabled, the GUI process call (and therefore the render call) is only done if anything has changed. The result will be a faster GUI and less load if Kodi plays a video

* true: on
* false: off '''(Default)'''

Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<smartredraw>true</smartredraw>
</gui>
</syntaxhighlight>

=== anisotropicfiltering ===

This new feature was introduced for the GL/GLES rendering backends in Kodi 22. It allows for better (hardware specific) filtering of textures at glancing angles. Depending on the hardware it might have no effect, or there might be a performance degradation. Typical values are "2" or "3", but might go as high as "16", depending on the hardware. The default is "1" (disabled).

Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<anisotropicfiltering>2</anisotropicfiltering>
</gui>
</syntaxhighlight>

=== fronttobackrendering ===

This experimental feature was introduced for the GL/GLES rendering backends in Kodi 22. It enables a form of occlusion culling, by rendering opaque object from front to back. Most GPUs should benefit from this setting (especially on ARM based systems), often resulting in higher frame rates or less memory bandwidth usage.

* true: on
* false: off '''(Default)'''

Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<fronttobackrendering>true</fronttobackrendering>
</gui>
</syntaxhighlight>

=== geometryclear ===

This experimental setting was introduced for the GL/GLES rendering backends in Kodi 22. It disables geometry based screen clearing in favor of fixed function clearing. Depending on the GPU (most ARM systems, Intel >gen 12), disabling the setting might be preferable for increased performance.

* true: on '''(Default)'''
* false: off

Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<geometryclear>false</geometryclear>
</gui>
</syntaxhighlight>

== Other interface settings ==

=== window ===
{{anchor|.3Cwindow.3E}}
{{note|This is a "hidden" guisettings.xml setting (defined by the mouse moving the window size), but it is mentioned here because it is a particularly useful override when used in advancedsettings.xml}}
This allows you to manually set the default size of Kodi's windowed mode. If you resize the window, it will return to the set size when restarting.

WIDTH and HEIGHT are the values for each dimension, in pixels.

<syntaxhighlight lang=xml enclose="div">
<window>
<width>WIDTH</width>
<height>HEIGHT</height>
</window>
</syntaxhighlight>

=== restrictcapsmask ===
{{anchor|.3Crestrictcapsmask.3E}}
Windows only. A bitmask to prevent Kodi from using detected texture capabilities of the GPU. This helps work around buggy hardware/drivers.

1: prevent the use of compressed textures (DXT1, DXT3, DXT5)
2: prevent the use of non-power-of-two dimensions for textures
4: prevent the use of compressed textures with non-power-of-two dimensions.

<syntaxhighlight lang=xml enclose="div">
<restrictcapsmask>0</restrictcapsmask>
</syntaxhighlight>

=== showexitbutton ===
{{anchor|.3Cshowexitbutton.3E}}
Setting to hide the exit button, useful for people running appliance based setups where exit would only confuse/complicate the user. Modifiable via the advancedsettings.xml by setting showexitbutton to false, default is true (show)

Example:
<syntaxhighlight lang=xml enclose="div">
<showexitbutton>true</showexitbutton>
</syntaxhighlight>

=== fullscreen ===
{{anchor|.3Cfullscreen.3E}}
Starts Kodi in full screen (check resolutions!).

<syntaxhighlight lang=xml enclose="div">
<fullscreen>false</fullscreen>
</syntaxhighlight>

=== splash ===
{{anchor|.3Csplash.3E}}
Set to false if you wish to disable the startup splash image. Defaults to true.

<syntaxhighlight lang=xml enclose="div">
<splash>true</splash>
</syntaxhighlight>

=== cputempcommand ===
{{anchor|.3Ccputempcommand.3E}}
Provide a shell command Kodi will use to get CPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia and Raspberry Pi</u>
<syntaxhighlight lang=xml enclose="div">
<cputempcommand>sed -e 's/$[0-9]*$[0-9]\{3\}.*/\1 C/' /sys/class/thermal/thermal_zone0/temp</cputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang=xml enclose="div">
<cputempcommand>echo "$(sensors -u | tail -n64 | grep temp1_input | awk '{print $2 }' |awk '{printf("%d\n",$1 + 0.5);}') C"</cputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang=xml enclose="div">
<cputempcommand>sensors|sed -ne "s/temp1: \+[-+]$[0-9]\+$.*/\1 C/p"</cputempcommand>
</syntaxhighlight>

=== gputempcommand ===
{{anchor|.3Cgputempcommand.3E}}
Provide a shell command Kodi will use to get GPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia</u>
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>echo "$(nvidia-settings -tq gpuCoreTemp) C"</gputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>echo "$(nvidia-smi -q -d TEMPERATURE | grep Gpu | cut -c35-36) C"</gputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>/usr/bin/aticonfig --od-gettemperature | grep Temperature | cut -f 2 -d "-" | cut -f 1 -d "." | sed -e "s, ,," | sed 's/$/ C/'</gputempcommand>
</syntaxhighlight>

;<u>For Raspberry Pi</u>
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>/opt/vc/bin/vcgencmd measure_temp | sed -e "s/temp=//" -e "s/\..*'/ /"</gputempcommand>
</syntaxhighlight>

=== glrectanglehack ===
{{anchor|.3Cglrectanglehack.3E}}
Problems with ghosting or videos which are only played back in the left upper quarter? The following ATI hack may solve it.
<syntaxhighlight lang=xml enclose="div">
<glrectanglehack>yes</glrectanglehack>
</syntaxhighlight>

=== alwaysontop ===
{{anchor|.3Calwaysontop.3E}}
Added in XBMC v9.11 (Windows OS only). Keeps Kodi always on top when windowed.
<syntaxhighlight lang=xml enclose="div">
<alwaysontop>yes</alwaysontop>
</syntaxhighlight>

There is also a fake fullscreen GUI option in Kodi's settings.

=== minimizetotray ===
{{anchor|.3Cminimizetotray.3E}}
{{note|Available in Kodi v20 and above.}}

Windows only. Minimizes Kodi to the system tray. Defaults to false.
<syntaxhighlight lang=xml enclose="div">
<minimizetotray>true</minimizetotray>
</syntaxhighlight>

= Removed tags =
{{anchor|Recently removed tags}}
* {{anchor|.3Cthumbsize.3E}}'''<thumbsize>''' - replaced by <[[#imageres|imageres]]> in v12 Frodo
* {{anchor|.3Cfanartheight.3E}}'''<fanartheight>''' - replaced by <[[#fanartres|fanartres]]> in v12 Frodo
* {{anchor|.3Cdvdthumbs.3E}}'''<dvdthumbs>''' - removed in v12 Frodo
* {{anchor|.3Cbusydialogdelayms.3E}}'''<busydialogdelayms>''' - removed in v12 Frodo
* {{anchor|.3Cbginfoloadermaxthreads.3E}}'''<bginfoloadermaxthreads>''' - removed in v13 Gotham
* '''<showepginfoonselect>''' - replaced by a GUI setting in v13 Gotham
* '''<resample>''', '''<forceDirectSound>''', '''<audiophile>''', '''<audiosinkbufferdurationmsec>''', '''<allowtranscode44100>''', and '''<streamsilence>''' - These were various sub-tags for <audio> that were removed in v13 Gotham and either replaced by GUI settings or were no longer needed.
* {{anchor|.3Cenableairtunesdebuglog.3E}}'''<enableairtunesdebuglog>''' - replaced by a GUI option in v14 Helix
* '''<videoDisableHi10pMultithreading>''' - renamed to <disableswmultithreading> in v14 Helix
* '''<hideallitems>''' - For both the <code><videolibrary></code> and <code><musiclibrary></code> sections, this is replaced by a GUI option in v15 Isengard
* '''<SmallStepBackSeconds>''' - In v15 the <code>SmallStepBack</code> [[Action_IDs]] has been replaced by <code>seek(-7)</code> in default keymaps. See '''[[skip steps]]''' for details. When the original <code>SmallStepBack</code> action ID is used it defaults to the first backwards [[skip steps|additive seeking value]].
* '''<timeseekforward>/<timeseekbackward>''' - In v15 these tags are replaced by GUI options via [[skip steps|additive seeking]], which is configured in the GUI. See '''[[skip steps]]''' for details.
* {{anchor|.3Ckaraoke.3E}}'''<karaoke>''' - In v16 all of the karaoke features in Kodi were removed.
* '''<useddsfanart>''' - removed in v17 Krypton.
* '''<cachemembuffersize>''' and '''<readbufferfactor>''' - In v17 '''<cachemembuffersize>''' is renamed to '''<memorysize>''' and <code><readbufferfactor></code> is renamed to <code><readfactor></code>. In addition, all three buffer related settings in <network> are moved out of <network> and into a new <cache> parent tag.
* '''<minvideocachelevel>''', '''<minaudiocachelevel>''', and '''<cacheindvdplayer>''' have been removed in v17.
* '''<useffmpegvda>''' - Tag was only used for development testing. Removed in v17.
* '''<nofliptimeout>''' - Removed in v17
* '''<blackbarcolour>''' - Removed in v17 (maybe?)
* '''<disableswmultithreading>''' - Removed in v17 (maybe?)
* '''<controllerdeadzone>''' - Removed in v17
* {{anchor|.3Cmeasurerefreshrate.3E}}'''<measurerefreshrate>''' - Removed in v17 or v18?
* {{anchor|.3Cmyth.3E}}'''<myth>''' - Removed sometime between v16 to v18
* {{anchor|.3Ctuxbox.3E}}'''<tuxbox>''' - Removed
* '''<backgroundupdate>''' - Removed
* '''<hideemptyseries>''' - Replaced by a GUI option.
* '''<mymovies>''' and child tag '''<categoriestogenres>''' - Removed
* '''<albumssortbyartistthenyear'''> - Removed
* '''<albumformatright>''' - Removed
* {{anchor|.3Cremoterepeat.3E}}'''<remoterepeat>''' - Removed
* {{anchor|.3Callowd3d9ex.3E}}'''<allowd3d9ex>''' and {{anchor|.3Cforced3d9ex.3E}}'''<forced3d9ex>''' - Removed sometime between v16 to v18
* '''<lingertime>''' - Replaced by a GUI setting in v18
* '''<forcevaapienabled>''' - Removed in v18
* '''<dxvaallowhqscaling>''' - Removed in v18 <ref>https://github.com/xbmc/xbmc/pull/15466</ref>
* '''<promptfulltagscan>false</promptfulltagscan>''' Removed in v18. Now automatically asked each time a scan is conducted.
* '''<omxdecodestartwithvalidframe>''' - This tag is only in some Raspberry Pi specific distributions, such as OpenELEC. As of March 2015, this tag has not been merged into "vanilla" Kodi builds
* '''<musicthumbs>''' Replaced in v19 by the GUI setting '''Thumbnail image files''' found in Media -> Music
* '''<artistextraart>''' Replaced in v19 by the GUI setting '''Artist art types whitelist''' found in Media -> Music <ref>https://github.com/xbmc/xbmc/pull/22748</ref>
* '''<albumextraart>''' Replaced in v19 by the GUI setting '''Album art types whitelist''' found in Media -> Music
* '''<episodeextraart>''' Replaced in v19 by the GUI setting '''Episode art types whitelist''' found in Media -> Videos
* '''<tvshowextraart>''' Replaced in v19 by the GUI setting '''TV show art types whitelist''' found in Media -> Videos
* '''<tvseasonextraart>''' Replaced in v19 by the GUI setting '''TV show art types whitelist''' found in Media -> Videos
* '''<movieextraart>''' Replaced in v19 by the GUI setting '''Movie art types whitelist''' found in Media -> Videos
* '''<moviesetextraart>''' Replaced in v19 by the GUI setting '''Movie art types whitelist''' found in Media -> Videos
* '''<musicvideoextraart>''' Replaced in v19 by the GUI setting '''Music video art types whitelist''' found in Media -> Videos
* '''<fanart>''' Removed in v19
* '''<assfixedworks>''' Removed in v20
* '''<try10bitoutput>''' Removed in v20 and replaced with [[Settings/System/Display#Use_10_bit_for_SDR|Use 10 bit for SDR]] setting <ref>https://github.com/xbmc/xbmc/pull/20014</ref>
* '''<enablehighqualityhwscalers>''' Removed in v20 <ref>https://github.com/xbmc/xbmc/pull/21537</ref>
* '''<cache> / <memorysize> / <buffermode> / <readfactor> / <chunksize>''' - Removed in v21 and added to GUI settings page

= guisettings.xml Setting Conversion =
It is possible to convert settings found in the '''[[Settings]]''' ''(guisettings.xml)'' pages of {{kodi}} into entries for the advancedsettings.xml file.

When a setting from the guisettings.xml is added to the advancedsettings.xml file, it will override the existing guisettings.xml values and the setting will be removed from the settings pages.

Why would I need to do this?
* You set up multiple devices and then need to individually change settings and preferences on each device. Using this conversion method, you save those settings in the advancedsettings.xml file and simply add the file to each device
* You need to hide settings to prevent those settings from being modified

To convert a guisetting to advancedsettings.xml follow these steps:
# In the {{kodi}} settings pages, adjust the setting(s) to your preference.
# Back out of the settings pages to the main menu, which forces {{kodi}} to save the adjusted settings to the guisettings.xml file
# Locate the guisettings.xml file in the [[Userdata]] folder and open it
# Locate the setting(s) to be converted. The list can be overwhelming so make use of the Search feature of whichever editor you are using
# Using the following setting as an example:
<syntaxhighlight lang="xml">
<setting id="videolibrary.showemptytvshows">true</setting>
</syntaxhighlight>
: Breaking down the string:
::'''videolibrary'''- parent tag
::'''showemptytvshows'''- child tag
::'''true'''- value
: The conversion is as follows and place this in the advancedsettings.xml file
<syntaxhighlight lang="xml">
<advancedsettings version="1.0">
<videolibrary>
<showemptytvshows>true</showemptytvshows>
</videolibrary>
</advancedsettings>
</syntaxhighlight>

'''Note:''' Some parent tags may already be in use in your advancedsettings.xml file. Do not duplicate them, but add the child tag beneath the existing parent tag.

= References =
<references />

{{Updated|18}}
{{DISPLAYTITLE:advancedsettings.xml}}

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

Dynamic List Content

2023-09-30T05:46:42Z

Ksooo: /* Available attributes */

<section begin="main content" />
Container controls (the [[List Container]], [[Fixed List Container]], [[Wrap List Container]], and [[Panel Container]]) can be setup by the skinner with dynamic content from a path or plugin. This is done by including the <content> tag in the control. It saves many lines of code as it's not necessary anymore to use static items for i.e. recently added movies.

=== Examples ===
Content filled from a plugin
<syntaxhighlight lang="XML" enclose="div">
<content>plugin://plugin.test.me?arg1=foo</content>
</syntaxhighlight>

Content filled from a path
<syntaxhighlight lang="XML" enclose="div">
<content target="music" sortby="artist" sortorder="ascending" limit="10">musicdb://recentlyaddedalbums/</content>
</syntaxhighlight>

It's also possible to fill a container with multiple <content> sources.

=== Available attributes ===
The available XML attributes for the content tag are as follows. Note that, as always, they're lower-case only, as XML is case-sensitive.

{| class="prettytable"
! Attributes !! Description
|-
| '''target'''
| Specifies the context window of the content. This is only necessary for folder items as it defines which window should be activated. For example '''musicdb://albums/''' should have '''target="music"''' but '''musicdb://songs/''' does not need a target because it contains only songs which will be played via '''PlayMedia(...)''' rather than opened via '''ActivateWindow(target,path,return)'''
|-
| '''limit'''
| Limits the number of items in the container.
|-
| '''sortby'''
| Sorts the list by the given value.
|-
| '''sortorder'''
| Sort direction of the list: ascending or descending.
|-
| '''browse'''
| Since v21: Control visibility of the "more..." button which can be appended to lists to open the window specified by the '''target''' attribute:
* '''always''' : Add the button, if list contains at least one item.
* '''auto''' : Add the button, if the list as provided by the core actually has more items than specified by the '''limit''' attribute. This is the default value.
* '''never''' : Never add the button.
|}

=== Available item properties (can be filled in plugins) ===
{| class="prettytable"
! Property !! Description
|-
| '''node.target'''
| Specifies the context window of the content. This overwrites the target attribute of the content tag.
|-
| '''node.target_url'''
| Overwrites the path of an item if it's clicked on. This can be used to show the content of the item's path in another container while entering a different path if the item is clicked on. An example would be Confluence's home screen where '''Movies''' shows the items of it's path as a submenu below while clicking the item always takes the user to movie titles.
|}

=== Override onclick action ===
You can define a custom <onclick> action for lists with dynamic content.

<syntaxhighlight lang="XML" enclose="div">
<control type="list">
...
<onclick>some_builtin</onclick>
...
<content>...</content>
</control>
</syntaxhighlight>

<section end="main content" />
== See also ==
'''Development:'''
* [[Add-on development]]
* [[Skinning]]

[[Category:Skin development]]

List of Built In Controls

2022-10-27T07:38:07Z

Ksooo:

<section begin="main content" />
== .xml files ==

=== AddonBrowser.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|5 ||radiobutton ||Enable auto-updating of the installed add-on's
|-
|6 ||radiobutton ||Enable add-on notifications
|-
|7 ||radiobutton ||Enable language filter
|-
|8 ||radiobutton ||Hide broken addons
|-
|9 ||button ||Check for repo updates
|}

=== DialogAddonInfo.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|6 ||button ||Install the selected add-on
|-
|7 ||button ||Disable the selected add-on
|-
|8 ||button ||Update the selected add-on
|-
|9 ||button ||Show the settings of the selected add-on
|-
|10 ||button ||Show the dependencies of the selected add-on
|-
|12 ||button ||Run the selected add-on
|-
|13 ||radiobutton ||Auto-update
|-
|14 ||button ||Select add-on version
|-
|50 ||container ||List of available screenshots
|}

=== DialogAddonSettings.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||label ||Heading label
|-
|3 ||grouplist ||Grouplist template
|-
|5 ||grouplist ||Grouplist template
|-
|7 ||button ||Button template
|-
|8 ||radiobutton ||Radiobutton template
|-
|9 ||spincontrolex ||Spincontrolex template
|-
|10 ||togglebutton ||Togglebutton template
|-
|11 ||image ||Default separator image
|-
|12 ||edit ||Edit template
|-
|13 ||sliderex ||Slider template
|-
|14 ||label ||Label template
|-
|28 ||button ||OK button
|-
|29 ||button ||Cancel button
|-
|30 ||button ||<unused button>
|}

=== DialogAudioDSPManager.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|20 ||container ||List with available options
|-
|21 ||container ||List with active options
|-
|22 ||radiobutton ||Continuous save button
|-
|23 ||button ||Apply button
|-
|24 ||button ||Clear button
|-
|9000 ||container ||List with available modes
|}

=== DialogBusy.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|10 ||progress ||Progress bar
|}

=== DialogButtonMenu.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|3100 ||label ||Label of the focused button
|}

=== DialogConfirm.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|1 ||label ||Heading label
|-
|9 ||textbox ||Message
|-
|10 ||button ||No button
|-
|11 ||button ||Yes button
|-
|12 ||button ||(for future use)
|-
|20 ||progress ||Progress bar
|}

=== DialogContextMenu.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|999 ||image ||Background image of the context menu (center part) (deprecated)
|-
|998 ||image ||Background image of the context menu (bottom part) (deprecated)
|-
|997 ||image ||Background image of the context menu (top part) (deprecated)
|-
|996 ||grouplist || Grouplist template
|-
|999 ||image ||Background image of the context menu
|-
|1000 ||button ||Button template
|}

=== DialogExtendedProgressBar.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|30 ||label ||Heading label
|-
|31 ||label ||Line 1
|-
|32 ||progress ||Scan progress bar
|}

=== DialogGameControllers.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|3 ||grouplist ||List of controller types
|-
|5 ||grouplist ||List of feature types
|-
|7 ||button ||Button template
|-
|8 ||label ||Settings category label template
|-
|9 ||image ||Settings separator image template
|-
|10 ||button ||Button template
|-
|17 ||button ||Help button
|-
|18 ||button ||OK button
|-
|19 ||button ||Reset button
|-
|20 ||button ||Get more... button
|-
|21 ||button ||Ignore input button
|-
|22 ||button ||Get all button
|-
|31 ||gamecontroller ||Gamecontroller image template
|-
|32 ||textbox ||Controller description
|}

=== DialogFavourites.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|450 ||container ||List of available favourites
|}

=== DialogKeyboard.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|8 ||button ||Backspace button
|-
|100 – 111 ||button ||Digits 0 – 9
|-
|120 – 171 ||button ||Characters A – Z
|-
|300 ||button ||Done Button
|-
|301 ||button ||Cancel button
|-
|302 ||radiobutton ||Shift button
|-
|303 ||radiobutton ||Caps-Lock button
|-
|304 ||radiobutton ||Switch to symbols
|-
|305 ||button ||Navigate left button
|-
|306 ||button ||Navigate right button
|-
|307 ||button ||Enter IP address button
|-
|309 ||button ||Layout button
|-
|311 ||label ||Heading label
|-
|312 ||edit ||Label displaying the text being entered
|-
|313 ||label ||Label displaying the text being entered (when keyboard layout is Chinese)
|-
|314 ||label ||Label displaying the available choices (when keyboard layout is Chinese)
|}

=== DialogMediaSource.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||label ||Heading label
|-
|10 ||container ||List of added media sources
|-
|11 ||button ||Browse for location button
|-
|12 ||edit ||Button for entering the name for the selected source
|-
|13 ||button ||Add new source button
|-
|14 ||button ||Delete source button
|-
|18 ||button ||OK button
|-
|19 ||button ||Cancel button (unused)
|}

=== DialogMusicInfo.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|6 ||button ||Refresh artist information / Refresh album information
|-
|7 ||button ||User rating
|-
|8 ||button ||Play album/song
|-
|10 ||button ||Get artist thumbnail / Get album thumbnail
|-
|11 ||button ||Connect to the Last.fm radio channel for this artist
|-
|12 ||button ||Get artist fanart image
|-
|13 ||button ||Get song thumbnail
|-
|50 ||container || Discography of the selected artist / tracks on the selected album / contributors on the selected song
|}

=== DialogNotification.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|400 ||image ||Default Icon
|-
|401 ||label ||Heading text
|-
|402 ||label ||Message text
|}

=== DialogNumeric.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|1 ||label ||Heading label
|-
|4 ||label ||Label displaying the digits being entered
|-
|10 – 19 ||button ||Digits 0 – 9
|-
|20 ||button ||Navigate left button
|-
|21 ||button ||Enter Button
|-
|22 ||button ||Navigate right button
|-
|23 ||button ||Backspace button
|}

=== DialogPictureInfo.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|5 ||container ||List of the available exif information of the image currently being displayed
|}

=== DialogPVRChannelManager.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|4 ||button ||OK button
|-
|5 ||button ||Apply button
|-
|6 ||button ||Cancel button
|-
|7 ||radiobutton ||Activate channel button
|-
|6 ||button ||Cancel button
|-
|8 ||edit ||Channel name
|-
|9 ||button ||Channel logo
|-
|11 ||spincontrolex ||Select group
|-
|12 ||radiobutton ||Activate EPG
|-
|13 ||spincontrolex ||Select EPG source button
|-
|30 ||button ||Switch to group management
|-
|31 ||button ||New channel
|-
|34 ||button ||Toggle radio / tv channels
|-
|20 ||container ||Channel list
|}

=== DialogPVRChannelsOSD.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|11 ||container ||Channels list
|}

=== DialogPVRGroupManager.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|11 ||container ||Ungrouped channels
|-
|12 ||container ||Grouped channels
|-
|13 ||container ||Group list
|-
|25 ||radiobutton ||Hide / Unhide button
|-
|26 ||button ||Add button
|-
|27 ||button ||Rename button
|-
|28 ||button ||Delete button
|-
|29 ||button ||OK button
|-
|34 ||togglebutton ||Switch between TV / Radio
|}

=== DialogPVRChannelGuide.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|11 ||container ||Guide list
|}

=== DialogPVRGuideSearch.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|9 ||edit ||Search string
|-
|10 ||radiobutton ||Include description
|-
|11 ||radiobutton ||Case sensitive
|-
|12 ||spincontrolex ||Minimal duration
|-
|13 ||spincontrolex ||Maximal duration
|-
|14 ||edit ||Start date
|-
|15 ||edit ||End date
|-
|16 ||edit ||Start time
|-
|17 ||edit ||End Time
|-
|18 ||spincontrolex ||Genre
|-
|19 ||radiobutton ||Avoid repeats
|-
|20 ||radiobutton ||Unknown genres
|-
|21 ||spincontrolex ||Groups
|-
|22 ||radiobutton ||FTA
|-
|23 ||spincontrolex ||Channels
|-
|24 ||radiobutton ||Ignore timers
|-
|25 ||button ||Cancel button
|-
|26 ||button ||Search button
|-
|27 ||radiobutton ||Ignore recordings
|-
|28 ||button ||Defaults button
|}

=== DialogPVRInfo.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|4 ||button ||Similar button
|-
|5 ||button ||Switch to channel button
|-
|6 ||button ||Record button
|-
|7 ||button ||OK button
|-
|8 ||button ||Play recording button
|-
|9 ||button ||Add timer button
|-
|10 ||button ||Play programme button
|-
|11 ||button ||Set reminder button
|}

=== DialogSeekBar.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|401 ||slider ||Marker representing the current seek position
|-
|402 ||slider ||Marker representing the epg seek position (PVR)
|-
|403 ||slider ||Marker representing the current timeshift position (PVR)
|}

=== DialogSelect.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|1 ||label ||Heading label
|-
|2 ||label ||Number of items in the list
|-
|3 ||container ||List of available options
|-
|5 ||button ||OK (on multiple selection) or Manual/Get More... button
|-
|6 ||container ||List of available add-ons
|-
|7 ||button ||Cancel button
|-
|8 ||button || Add/Get More... button
|-
|11 ||container ||List with game video thumbnails
|-
|12 ||textbox ||Description of the currently-selected video filter
|}

=== DialogSettings.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||label ||Header label
|-
|5 ||grouplist ||Grouplist template
|-
|7 ||button ||button template
|-
|8 ||radiobutton ||radiobutton template
|-
|9 ||spincontrolex ||spincontrolex template
|-
|11 ||image ||image template
|-
|12 ||edit ||edit template
|-
|13 ||sliderex ||sliderex template
|-
|14 ||label ||label template
|-
|28 ||button ||ok button
|-
|29 ||button ||cancel button
|-
|30 ||button ||clear/settings button
|}

=== DialogSlider.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|10 ||label ||Heading label
|-
|11 ||slider ||Slider
|-
|12 ||label ||Label representing the slider value
|}

=== DialogSubtitles.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|100 ||label ||Name of subtitle service
|-
|110 ||image ||Logo of subtitle service
|-
|120 ||container ||List of available subtitles
|-
|130 ||label ||Local subtitle available
|-
|140 ||label ||Number of available subtitles
|-
|150 ||container ||List of available subtitle services
|-
|160 ||button ||Manual search buttom
|}

=== DialogTextViewer.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|5 ||textbox ||Text area for add-on output
|}

=== DialogVideoInfo.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|3 ||image ||Video thumb
|-
|4 ||textbox ||Text area for displaying the video plot
|-
|5 ||button ||Toggle between video review and cast members (Deprecated)
|-
|6 ||button ||Refresh video information
|-
|7 ||button ||User rating
|-
|8 ||button ||Play video
|-
|9 ||button ||Resume video
|-
|10 ||button ||Get video Fanart, Poster, Banner, or Thumb
|-
|11 ||button ||Play movie trailer
|-
|13 ||button ||Show all movies by the director of the selected movie
|-
|50 ||container ||List of cast members of the currently selected movie
|}

=== MyFavourites.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype
|-
|3 ||button ||Select sort method
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|19 ||radiobutton / edit||Filter the content to only show items that include the specified string in the name
|}

=== EventLog.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|20 ||button ||Clear button
|-
|21 ||button ||Level button
|-
|22 ||radiobutton ||Only show current level radiobutton
|-
|50 ||container ||Container with event loglines
|}

=== FileBrowser.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|450 ||container ||Directory list
|-
|451 ||container ||List of available thumbnails
|-
|411 ||label ||Heading label
|-
|412 ||label ||Path of the selected item
|-
|413 ||button ||OK button
|-
|414 ||button ||Cancel button
|-
|415 ||button ||Create folder
|-
|416 ||radiobutton ||Flip Image horizontally
|}

=== FileManager.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|12 ||label ||Number of items in directory list 1
|-
|13 ||label ||Number of items in directory list 2
|-
|20 ||container ||Directory list 1
|-
|21 ||container ||Directory list 2
|-
|101 ||label ||Path of the currently selected directory in list 1
|-
|102 ||label ||Path of the currently selected directory in list 2
|}

=== GameOSD.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|1101 ||label ||Help text
|-
|1102 ||gamecontroller ||Controller layout
|}

=== LoginScreen.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||label ||Heading label
|-
|3 ||label ||Number of the currently selected profile
|-
|52 ||container ||List of the available profiles
|}

=== MusicOSD.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|500 ||button ||Select visualization
|-
|501 ||button ||Lock visualization to the current preset
|}

=== MusicVisualisation.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||visualisation ||Background Visualization
|}

=== MyMusicNav.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|5 ||radiobutton ||Switch to file mode
|-
|8 ||edit ||Search for a string anywhere in the Kodi music database
|-
|12 ||label ||Number of items in the list
|-
|15 ||label ||Filter label
|-
|16 ||radiobutton ||Start party mode (randomly play songs from your entire music collection)
|-
|17 ||button ||Manually enter artist and album name to lookup the artist and album information on the internet
|-
|18 ||label ||Warning to the user to turn off library mode when no scanned media is found
|-
|19 ||radiobutton / edit||Filter the media files to only show items that include the specified string in the name
|-
|20 ||button ||Update library
|}

=== MyMusicPlaylistEditor.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|6 ||button ||Load the playlist
|-
|7 ||button ||Save the playlist
|-
|8 ||button ||Clear the playlist
|-
|12 ||label ||Number of items in the current directory or library list
|-
|XX ||container ||List allowing you to browse your directories and music library
|-
|100 ||container ||List of songs in the playlist
|-
|101 ||label ||Number of items in the playlist
|}

=== MyPics.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|6 ||button ||Start a picture slideshow
|-
|7 ||button ||Start a recursive picture slideshow
|-
|9 ||radiobutton ||Randomize the picture slideshow
|-
|12 ||label ||Number of items in the list
|}

=== MyPlaylist.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|12 ||label ||Number of items in the playlist
|-
|20 ||radiobutton ||Shuffle the playlist
|-
|21 ||button ||Save the playlist
|-
|22 ||button ||Clear the playlist
|-
|23 ||button ||Play the playlist
|-
|24 ||button ||Play the next item in the playlist
|-
|25 ||button ||Play the previous item in the playlist
|-
|26 ||button ||Put the playlist on repeat
|}

=== MyPrograms.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|12 ||label ||Number of items in the list
|}

=== MyPVRChannels.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|6 ||radiobutton ||Show hidden channels
|-
|28 ||button ||Channel groups button
|-
|29 ||label ||Channel groups name
|-
|31 ||radiobutton ||Filter
|}

=== MyPVRGuide.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|10 ||epggrid ||EPG Guide Timeline
|-
|11 ||container ||Channel groups selector
|-
|28 ||button ||Channel groups button
|-
|29 ||label ||View name (Now / Next / Timeline)
|-
|30 ||label ||Channel groups name
|}

=== MyPVRRecordings.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|5 ||radiobutton ||Group items by folder structure
|-
|7 ||radiobutton ||Show deleted recordings
|-
|10 ||button ||Show only watched, unwatched or all recordings
|-
|28 ||button ||Channelgroups button
|-
|29 ||label ||'Deleted' (When show deleted recordings is enabled, otherwise empty)
|}

=== MyPVRSearch.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|28 ||button ||Channel groups button
|}

=== MyPVRTimers.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|8 ||radiobutton ||Hide disabled timers
|-
|28 ||button ||Channel groups button
|}

=== MyVideoNav.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|5 ||button ||Switch to file mode
|-
|6 ||button ||Play DVD (used the play physical DVD discs)
|-
|8 ||button ||Search for a string anywhere in the Kodi video database
|-
|10 ||button ||Show only watched, unwatched or all videos
|-
|12 ||label ||Number of items in the list
|-
|14 ||button ||Show only unwatched or all videos
|-
|11 ||button ||Unlock shares
|-
|15 ||label ||Filter label
|-
|16 ||button ||Start party mode (randomly play musicvideos from your collection)
|-
|18 ||label ||Warning to the user to turn off library mode when no scanned media is found
|-
|19 ||radiobutton / edit ||Filter the media files to only show items that include the specified string in the name
|-
|20 ||button ||Update library
|}

=== MyWeather.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Refresh the weather information
|-
|3 ||spincontrolex ||Change weather location
|-
|11 ||label ||Shows the time of last weather update
|-
|31 ||label ||Current day label
|-
|32 ||label ||Today's high temperature value
|-
|33 ||label ||Today's low temperature value
|-
|34 ||label ||Today's weather condition
|-
|35 ||image ||Today's weather icon
|-
|223 ||label ||Localized “Temperature” string
|-
|224 ||label ||Localized “Feels like” string
|-
|225 ||label ||Localized “UV index” string
|-
|226 ||label ||Localized “Wind” string
|-
|227 ||label ||Localized “Dew point” string
|-
|228 ||label ||Localized “Humidity” string
|}

=== Pointer.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|1 ||image ||Pointer no focus image
|-
|2 ||image ||Pointer focus image
|-
|3 ||image ||Pointer drag image
|-
|4 ||image ||Pointer click image
|}

=== SettingsCategory.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||label ||Label displaying the current settings category
|-
|3 ||grouplist ||Grouplist template for the menu
|-
|5 ||grouplist ||Grouplist template for the settings section
|-
|6 ||textbox ||Settings description
|-
|7 ||button ||Button template
|-
|8 ||radiobutton ||Radiobutton template
|-
|9 ||spincontrolex ||Spincontrolex template
|-
|10 ||button ||Button template for the menu
|-
|11 ||image ||Default separator image
|-
|12 ||edit ||Edit control template
|-
|13 ||sliderex ||Sliderex control template
|-
|14 ||label ||Label template
|-
|20 ||button ||Setting level button
|}

=== SettingsProfile.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||container ||List of available profiles
|-
|4 ||button ||Enable the loginscreen
|-
|5 ||button ||Auto login
|}

=== SettingsScreenCalibration.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||label ||Coordinates label
|-
|3 ||label ||Help information
|-
|8 ||mover ||Top left mover
|-
|9 ||mover ||Right bottom mover
|-
|10 ||mover ||Subtitle position mover
|-
|11 ||resize ||Pixel aspect ratio box
|-
|20 ||videowindow ||currently playing video
|}

=== SlideShow.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|10 ||label ||Error loading image message
|-
|13 ||[any] ||These controls are visible when the slideshow is paused
|}

=== SettingsSystemInfo.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 – 11 ||label ||Line 2 – Line 11
|-
|30 ||textbox ||privacy-policy text
|-
|40 ||label ||System information category label
|-
|52 ||label ||Kodi build label
|-
|53 ||label || Kodi build date label
|-
|94 ||button ||Show storage information
|-
|95 ||button ||Show summary information
|-
|96 ||button ||Show network information
|-
|97 ||button ||Show video information
|-
|98 ||button ||Show hardware information
|-
|99 ||button ||Show PVR information
|-
|100 ||button ||Show privacy-policy
|}

=== SmartPlaylistEditor.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||label ||Heading label
|-
|10 ||container ||List of playlist rules
|-
|12 ||button ||Name of the playlist
|-
|13 ||button ||Add a rule
|-
|14 ||button ||Remove a rule
|-
|15 ||button ||Edit a rule
|-
|16 ||button ||Match rules option (match all rules / match one or more rules)
|-
|17 ||button ||Limit rules option (number of results: 10, 25, 50, 100, etc... items)
|-
|18 ||button ||Sort rules option (order the results by: title, genre, random, etc...)
|-
|19 ||button ||Sort direction option (ascending / descending)
|-
|20 ||button ||OK button
|-
|21 ||button ||Cancel button
|-
|22 ||button ||Set Playlist type (movies, episodes, mixed, etc...)
|-
|23 ||button ||Group by
|-
|24 ||radiobutton ||Mixed
|}

=== SmartPlaylistRule.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|15 ||button ||Select field (director, duration, video resolution, etc...)
|-
|16 ||button ||Select operator (is, is not, less than, etc...)
|-
|17 ||edit ||Enter a value the rule should match
|-
|18 ||button ||OK button
|-
|19 ||button ||Cancel button
|-
|20 ||button ||Browse button
|}

=== VideoFullScreen.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|1 ||label ||Numpad seek label
|-
|10 ||label ||Line 1
|-
|11 ||label ||Line 2
|-
|12 ||label ||Line 3
|}

=== VideoOSDBookmarks.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Add a video bookmark
|-
|3 ||button ||Clear all bookmarks
|-
|4 ||button ||Use the currently selected video bookmark as the episode thumbnail
|-
|11 ||container ||List of available bookmarks
|}

<section end="main content" />

== See also ==
'''Development:'''
* [[Add-on development]]
* [[Skinning]]

[[Category:Skin development]]

List of Built In Controls

2022-10-13T07:55:45Z

Ksooo:

<section begin="main content" />
== .xml files ==

=== AddonBrowser.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|5 ||radiobutton ||Enable auto-updating of the installed add-on's
|-
|6 ||radiobutton ||Enable add-on notifications
|-
|7 ||radiobutton ||Enable language filter
|-
|8 ||radiobutton ||Hide broken addons
|-
|9 ||button ||Check for repo updates
|}

=== DialogAddonInfo.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|6 ||button ||Install the selected add-on
|-
|7 ||button ||Disable the selected add-on
|-
|8 ||button ||Update the selected add-on
|-
|9 ||button ||Show the settings of the selected add-on
|-
|10 ||button ||Show the dependencies of the selected add-on
|-
|12 ||button ||Run the selected add-on
|-
|13 ||radiobutton ||Auto-update
|-
|14 ||button ||Select add-on version
|-
|50 ||container ||List of available screenshots
|}

=== DialogAddonSettings.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||label ||Heading label
|-
|3 ||grouplist ||Grouplist template
|-
|5 ||grouplist ||Grouplist template
|-
|7 ||button ||Button template
|-
|8 ||radiobutton ||Radiobutton template
|-
|9 ||spincontrolex ||Spincontrolex template
|-
|10 ||togglebutton ||Togglebutton template
|-
|11 ||image ||Default separator image
|-
|12 ||edit ||Edit template
|-
|13 ||sliderex ||Slider template
|-
|14 ||label ||Label template
|-
|28 ||button ||OK button
|-
|29 ||button ||Cancel button
|-
|30 ||button ||<unused button>
|}

=== DialogAudioDSPManager.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|20 ||container ||List with available options
|-
|21 ||container ||List with active options
|-
|22 ||radiobutton ||Continuous save button
|-
|23 ||button ||Apply button
|-
|24 ||button ||Clear button
|-
|9000 ||container ||List with available modes
|}

=== DialogBusy.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|10 ||progress ||Progress bar
|}

=== DialogButtonMenu.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|3100 ||label ||Label of the focused button
|}

=== DialogConfirm.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|1 ||label ||Heading label
|-
|9 ||textbox ||Message
|-
|10 ||button ||No button
|-
|11 ||button ||Yes button
|-
|12 ||button ||(for future use)
|-
|20 ||progress ||Progress bar
|}

=== DialogContextMenu.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|999 ||image ||Background image of the context menu (center part) (deprecated)
|-
|998 ||image ||Background image of the context menu (bottom part) (deprecated)
|-
|997 ||image ||Background image of the context menu (top part) (deprecated)
|-
|996 ||grouplist || Grouplist template
|-
|999 ||image ||Background image of the context menu
|-
|1000 ||button ||Button template
|}

=== DialogExtendedProgressBar.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|30 ||label ||Heading label
|-
|31 ||label ||Line 1
|-
|32 ||progress ||Scan progress bar
|}

=== DialogGameControllers.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|3 ||grouplist ||List of controller types
|-
|5 ||grouplist ||List of feature types
|-
|7 ||button ||Button template
|-
|8 ||label ||Settings category label template
|-
|9 ||image ||Settings separator image template
|-
|10 ||button ||Button template
|-
|17 ||button ||Help button
|-
|18 ||button ||OK button
|-
|19 ||button ||Reset button
|-
|20 ||button ||Get more... button
|-
|21 ||button ||Ignore input button
|-
|22 ||button ||Get all button
|-
|31 ||gamecontroller ||Gamecontroller image template
|-
|32 ||textbox ||Controller description
|}

=== DialogFavourites.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|450 ||container ||List of available favourites
|}

=== DialogKeyboard.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|8 ||button ||Backspace button
|-
|100 – 111 ||button ||Digits 0 – 9
|-
|120 – 171 ||button ||Characters A – Z
|-
|300 ||button ||Done Button
|-
|301 ||button ||Cancel button
|-
|302 ||radiobutton ||Shift button
|-
|303 ||radiobutton ||Caps-Lock button
|-
|304 ||radiobutton ||Switch to symbols
|-
|305 ||button ||Navigate left button
|-
|306 ||button ||Navigate right button
|-
|307 ||button ||Enter IP address button
|-
|309 ||button ||Layout button
|-
|311 ||label ||Heading label
|-
|312 ||edit ||Label displaying the text being entered
|-
|313 ||label ||Label displaying the text being entered (when keyboard layout is Chinese)
|-
|314 ||label ||Label displaying the available choices (when keyboard layout is Chinese)
|}

=== DialogMediaSource.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||label ||Heading label
|-
|10 ||container ||List of added media sources
|-
|11 ||button ||Browse for location button
|-
|12 ||edit ||Button for entering the name for the selected source
|-
|13 ||button ||Add new source button
|-
|14 ||button ||Delete source button
|-
|18 ||button ||OK button
|-
|19 ||button ||Cancel button (unused)
|}

=== DialogMusicInfo.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|6 ||button ||Refresh artist information / Refresh album information
|-
|7 ||button ||User rating
|-
|10 ||button ||Get artist thumbnail / Get album thumbnail
|-
|11 ||button ||Connect to the Last.fm radio channel for this artist
|-
|12 ||button ||Get artist fanart image
|-
|13 ||button ||Get song thumbnail
|-
|50 ||container || Discography of the selected artist / tracks on the selected album / contributors on the selected song
|}

=== DialogNotification.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|400 ||image ||Default Icon
|-
|401 ||label ||Heading text
|-
|402 ||label ||Message text
|}

=== DialogNumeric.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|1 ||label ||Heading label
|-
|4 ||label ||Label displaying the digits being entered
|-
|10 – 19 ||button ||Digits 0 – 9
|-
|20 ||button ||Navigate left button
|-
|21 ||button ||Enter Button
|-
|22 ||button ||Navigate right button
|-
|23 ||button ||Backspace button
|}

=== DialogPictureInfo.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|5 ||container ||List of the available exif information of the image currently being displayed
|}

=== DialogPVRChannelManager.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|4 ||button ||OK button
|-
|5 ||button ||Apply button
|-
|6 ||button ||Cancel button
|-
|7 ||radiobutton ||Activate channel button
|-
|6 ||button ||Cancel button
|-
|8 ||edit ||Channel name
|-
|9 ||button ||Channel logo
|-
|11 ||spincontrolex ||Select group
|-
|12 ||radiobutton ||Activate EPG
|-
|13 ||spincontrolex ||Select EPG source button
|-
|30 ||button ||Switch to group management
|-
|31 ||button ||New channel
|-
|34 ||button ||Toggle radio / tv channels
|-
|20 ||container ||Channel list
|}

=== DialogPVRChannelsOSD.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|11 ||container ||Channels list
|}

=== DialogPVRGroupManager.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|11 ||container ||Ungrouped channels
|-
|12 ||container ||Grouped channels
|-
|13 ||container ||Group list
|-
|25 ||radiobutton ||Hide / Unhide button
|-
|26 ||button ||Add button
|-
|27 ||button ||Rename button
|-
|28 ||button ||Delete button
|-
|29 ||button ||OK button
|-
|34 ||togglebutton ||Switch between TV / Radio
|}

=== DialogPVRChannelGuide.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|11 ||container ||Guide list
|}

=== DialogPVRGuideSearch.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|9 ||edit ||Search string
|-
|10 ||radiobutton ||Include description
|-
|11 ||radiobutton ||Case sensitive
|-
|12 ||spincontrolex ||Minimal duration
|-
|13 ||spincontrolex ||Maximal duration
|-
|14 ||edit ||Start date
|-
|15 ||edit ||End date
|-
|16 ||edit ||Start time
|-
|17 ||edit ||End Time
|-
|18 ||spincontrolex ||Genre
|-
|19 ||radiobutton ||Avoid repeats
|-
|20 ||radiobutton ||Unknown genres
|-
|21 ||spincontrolex ||Groups
|-
|22 ||radiobutton ||FTA
|-
|23 ||spincontrolex ||Channels
|-
|24 ||radiobutton ||Ignore timers
|-
|25 ||button ||Cancel button
|-
|26 ||button ||Search button
|-
|27 ||radiobutton ||Ignore recordings
|-
|28 ||button ||Defaults button
|}

=== DialogPVRInfo.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|4 ||button ||Similar button
|-
|5 ||button ||Switch to channel button
|-
|6 ||button ||Record button
|-
|7 ||button ||OK button
|-
|8 ||button ||Play recording button
|-
|9 ||button ||Add timer button
|-
|10 ||button ||Play programme button
|-
|11 ||button ||Set reminder button
|}

=== DialogSeekBar.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|401 ||slider ||Marker representing the current seek position
|-
|402 ||slider ||Marker representing the epg seek position (PVR)
|-
|403 ||slider ||Marker representing the current timeshift position (PVR)
|}

=== DialogSelect.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|1 ||label ||Heading label
|-
|2 ||label ||Number of items in the list
|-
|3 ||container ||List of available options
|-
|5 ||button ||OK (on multiple selection) or Manual/Get More... button
|-
|6 ||container ||List of available add-ons
|-
|7 ||button ||Cancel button
|-
|8 ||button || Add/Get More... button
|-
|11 ||container ||List with game video thumbnails
|-
|12 ||textbox ||Description of the currently-selected video filter
|}

=== DialogSettings.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||label ||Header label
|-
|5 ||grouplist ||Grouplist template
|-
|7 ||button ||button template
|-
|8 ||radiobutton ||radiobutton template
|-
|9 ||spincontrolex ||spincontrolex template
|-
|11 ||image ||image template
|-
|12 ||edit ||edit template
|-
|13 ||sliderex ||sliderex template
|-
|14 ||label ||label template
|-
|28 ||button ||ok button
|-
|29 ||button ||cancel button
|-
|30 ||button ||clear/settings button
|}

=== DialogSlider.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|10 ||label ||Heading label
|-
|11 ||slider ||Slider
|-
|12 ||label ||Label representing the slider value
|}

=== DialogSubtitles.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|100 ||label ||Name of subtitle service
|-
|110 ||image ||Logo of subtitle service
|-
|120 ||container ||List of available subtitles
|-
|130 ||label ||Local subtitle available
|-
|140 ||label ||Number of available subtitles
|-
|150 ||container ||List of available subtitle services
|-
|160 ||button ||Manual search buttom
|}

=== DialogTextViewer.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|5 ||textbox ||Text area for add-on output
|}

=== DialogVideoInfo.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|3 ||image ||Video thumb
|-
|4 ||textbox ||Text area for displaying the video plot
|-
|5 ||button ||Toggle between video review and cast members (Deprecated)
|-
|6 ||button ||Refresh video information
|-
|7 ||button ||User rating
|-
|8 ||button ||Play video
|-
|9 ||button ||Resume video
|-
|10 ||button ||Get video Fanart, Poster, Banner, or Thumb
|-
|11 ||button ||Play movie trailer
|-
|13 ||button ||Show all movies by the director of the selected movie
|-
|50 ||container ||List of cast members of the currently selected movie
|}

=== MyFavourites.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype
|-
|3 ||button ||Select sort method
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|19 ||radiobutton / edit||Filter the content to only show items that include the specified string in the name
|}

=== EventLog.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|20 ||button ||Clear button
|-
|21 ||button ||Level button
|-
|22 ||radiobutton ||Only show current level radiobutton
|-
|50 ||container ||Container with event loglines
|}

=== FileBrowser.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|450 ||container ||Directory list
|-
|451 ||container ||List of available thumbnails
|-
|411 ||label ||Heading label
|-
|412 ||label ||Path of the selected item
|-
|413 ||button ||OK button
|-
|414 ||button ||Cancel button
|-
|415 ||button ||Create folder
|-
|416 ||radiobutton ||Flip Image horizontally
|}

=== FileManager.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|12 ||label ||Number of items in directory list 1
|-
|13 ||label ||Number of items in directory list 2
|-
|20 ||container ||Directory list 1
|-
|21 ||container ||Directory list 2
|-
|101 ||label ||Path of the currently selected directory in list 1
|-
|102 ||label ||Path of the currently selected directory in list 2
|}

=== GameOSD.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|1101 ||label ||Help text
|-
|1102 ||gamecontroller ||Controller layout
|}

=== LoginScreen.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||label ||Heading label
|-
|3 ||label ||Number of the currently selected profile
|-
|52 ||container ||List of the available profiles
|}

=== MusicOSD.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|500 ||button ||Select visualization
|-
|501 ||button ||Lock visualization to the current preset
|}

=== MusicVisualisation.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||visualisation ||Background Visualization
|}

=== MyMusicNav.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|5 ||radiobutton ||Switch to file mode
|-
|8 ||edit ||Search for a string anywhere in the Kodi music database
|-
|12 ||label ||Number of items in the list
|-
|15 ||label ||Filter label
|-
|16 ||radiobutton ||Start party mode (randomly play songs from your entire music collection)
|-
|17 ||button ||Manually enter artist and album name to lookup the artist and album information on the internet
|-
|18 ||label ||Warning to the user to turn off library mode when no scanned media is found
|-
|19 ||radiobutton / edit||Filter the media files to only show items that include the specified string in the name
|-
|20 ||button ||Update library
|}

=== MyMusicPlaylistEditor.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|6 ||button ||Load the playlist
|-
|7 ||button ||Save the playlist
|-
|8 ||button ||Clear the playlist
|-
|12 ||label ||Number of items in the current directory or library list
|-
|XX ||container ||List allowing you to browse your directories and music library
|-
|100 ||container ||List of songs in the playlist
|-
|101 ||label ||Number of items in the playlist
|}

=== MyPics.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|6 ||button ||Start a picture slideshow
|-
|7 ||button ||Start a recursive picture slideshow
|-
|9 ||radiobutton ||Randomize the picture slideshow
|-
|12 ||label ||Number of items in the list
|}

=== MyPlaylist.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|12 ||label ||Number of items in the playlist
|-
|20 ||radiobutton ||Shuffle the playlist
|-
|21 ||button ||Save the playlist
|-
|22 ||button ||Clear the playlist
|-
|23 ||button ||Play the playlist
|-
|24 ||button ||Play the next item in the playlist
|-
|25 ||button ||Play the previous item in the playlist
|-
|26 ||button ||Put the playlist on repeat
|}

=== MyPrograms.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|12 ||label ||Number of items in the list
|}

=== MyPVRChannels.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|6 ||radiobutton ||Show hidden channels
|-
|28 ||button ||Channel groups button
|-
|29 ||label ||Channel groups name
|-
|31 ||radiobutton ||Filter
|}

=== MyPVRGuide.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|10 ||epggrid ||EPG Guide Timeline
|-
|11 ||container ||Channel groups selector
|-
|28 ||button ||Channel groups button
|-
|29 ||label ||View name (Now / Next / Timeline)
|-
|30 ||label ||Channel groups name
|}

=== MyPVRRecordings.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|5 ||radiobutton ||Group items by folder structure
|-
|7 ||radiobutton ||Show deleted recordings
|-
|10 ||button ||Show only watched, unwatched or all recordings
|-
|28 ||button ||Channelgroups button
|-
|29 ||label ||'Deleted' (When show deleted recordings is enabled, otherwise empty)
|}

=== MyPVRSearch.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|28 ||button ||Channel groups button
|}

=== MyPVRTimers.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|8 ||radiobutton ||Hide disabled timers
|-
|28 ||button ||Channel groups button
|}

=== MyVideoNav.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Select viewtype (list, thumbnail, media info, etc...)
|-
|3 ||button ||Select sort method (sort by: name, date size, etc...)
|-
|4 ||togglebutton ||Select sortmode (ascending or descending)
|-
|5 ||button ||Switch to file mode
|-
|6 ||button ||Play DVD (used the play physical DVD discs)
|-
|8 ||button ||Search for a string anywhere in the Kodi video database
|-
|10 ||button ||Show only watched, unwatched or all videos
|-
|12 ||label ||Number of items in the list
|-
|14 ||button ||Show only unwatched or all videos
|-
|11 ||button ||Unlock shares
|-
|15 ||label ||Filter label
|-
|16 ||button ||Start party mode (randomly play musicvideos from your collection)
|-
|18 ||label ||Warning to the user to turn off library mode when no scanned media is found
|-
|19 ||radiobutton / edit ||Filter the media files to only show items that include the specified string in the name
|-
|20 ||button ||Update library
|}

=== MyWeather.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Refresh the weather information
|-
|3 ||spincontrolex ||Change weather location
|-
|11 ||label ||Shows the time of last weather update
|-
|31 ||label ||Current day label
|-
|32 ||label ||Today's high temperature value
|-
|33 ||label ||Today's low temperature value
|-
|34 ||label ||Today's weather condition
|-
|35 ||image ||Today's weather icon
|-
|223 ||label ||Localized “Temperature” string
|-
|224 ||label ||Localized “Feels like” string
|-
|225 ||label ||Localized “UV index” string
|-
|226 ||label ||Localized “Wind” string
|-
|227 ||label ||Localized “Dew point” string
|-
|228 ||label ||Localized “Humidity” string
|}

=== Pointer.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|1 ||image ||Pointer no focus image
|-
|2 ||image ||Pointer focus image
|-
|3 ||image ||Pointer drag image
|-
|4 ||image ||Pointer click image
|}

=== SettingsCategory.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||label ||Label displaying the current settings category
|-
|3 ||grouplist ||Grouplist template for the menu
|-
|5 ||grouplist ||Grouplist template for the settings section
|-
|6 ||textbox ||Settings description
|-
|7 ||button ||Button template
|-
|8 ||radiobutton ||Radiobutton template
|-
|9 ||spincontrolex ||Spincontrolex template
|-
|10 ||button ||Button template for the menu
|-
|11 ||image ||Default separator image
|-
|12 ||edit ||Edit control template
|-
|13 ||sliderex ||Sliderex control template
|-
|14 ||label ||Label template
|-
|20 ||button ||Setting level button
|}

=== SettingsProfile.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||container ||List of available profiles
|-
|4 ||button ||Enable the loginscreen
|-
|5 ||button ||Auto login
|}

=== SettingsScreenCalibration.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||label ||Coordinates label
|-
|3 ||label ||Help information
|-
|8 ||mover ||Top left mover
|-
|9 ||mover ||Right bottom mover
|-
|10 ||mover ||Subtitle position mover
|-
|11 ||resize ||Pixel aspect ratio box
|-
|20 ||videowindow ||currently playing video
|}

=== SlideShow.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|10 ||label ||Error loading image message
|-
|13 ||[any] ||These controls are visible when the slideshow is paused
|}

=== SettingsSystemInfo.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 – 11 ||label ||Line 2 – Line 11
|-
|30 ||textbox ||privacy-policy text
|-
|40 ||label ||System information category label
|-
|52 ||label ||Kodi build label
|-
|53 ||label || Kodi build date label
|-
|94 ||button ||Show storage information
|-
|95 ||button ||Show summary information
|-
|96 ||button ||Show network information
|-
|97 ||button ||Show video information
|-
|98 ||button ||Show hardware information
|-
|99 ||button ||Show PVR information
|-
|100 ||button ||Show privacy-policy
|}

=== SmartPlaylistEditor.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||label ||Heading label
|-
|10 ||container ||List of playlist rules
|-
|12 ||button ||Name of the playlist
|-
|13 ||button ||Add a rule
|-
|14 ||button ||Remove a rule
|-
|15 ||button ||Edit a rule
|-
|16 ||button ||Match rules option (match all rules / match one or more rules)
|-
|17 ||button ||Limit rules option (number of results: 10, 25, 50, 100, etc... items)
|-
|18 ||button ||Sort rules option (order the results by: title, genre, random, etc...)
|-
|19 ||button ||Sort direction option (ascending / descending)
|-
|20 ||button ||OK button
|-
|21 ||button ||Cancel button
|-
|22 ||button ||Set Playlist type (movies, episodes, mixed, etc...)
|-
|23 ||button ||Group by
|-
|24 ||radiobutton ||Mixed
|}

=== SmartPlaylistRule.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|15 ||button ||Select field (director, duration, video resolution, etc...)
|-
|16 ||button ||Select operator (is, is not, less than, etc...)
|-
|17 ||edit ||Enter a value the rule should match
|-
|18 ||button ||OK button
|-
|19 ||button ||Cancel button
|-
|20 ||button ||Browse button
|}

=== VideoFullScreen.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|1 ||label ||Numpad seek label
|-
|10 ||label ||Line 1
|-
|11 ||label ||Line 2
|-
|12 ||label ||Line 3
|}

=== VideoOSDBookmarks.xml ===
{| class="prettytable" width="100%"
! width="50" | ID !! width="150" | Type !! Description
|-
|2 ||button ||Add a video bookmark
|-
|3 ||button ||Clear all bookmarks
|-
|4 ||button ||Use the currently selected video bookmark as the episode thumbnail
|-
|11 ||container ||List of available bookmarks
|}

<section end="main content" />

== See also ==
'''Development:'''
* [[Add-on development]]
* [[Skinning]]

[[Category:Skin development]]

Window IDs

2022-10-13T07:47:29Z

Ksooo:

{{mininav|[[Development]]|[[Add-on development]]}}
{{see also|Opening Windows and Dialogs|Python development|Skinning}}
__TOC__
<section begin="main content" />
This table cross-references Window names, Window definitions, and Window ID. The code that performs the cross-reference is found in https://github.com/xbmc/xbmc/blob/master/xbmc/input/WindowTranslator.cpp and https://github.com/xbmc/xbmc/blob/master/xbmc/guilib/WindowIDs.h.

* [[keymap.xml]] uses the Window name.
* Kodi's C++ code uses the Window definitions and Window ID's.
* ActivateWindow() should use the Window name.
* sounds.xml should use the window name<br />

'''You can use secondary parameters with all media windows, as can be seen here:'''
* '''[[Opening Windows and Dialogs]]'''

{| class="prettytable sortable"
|-
! Name !! Definition !! Window ID !! source XML file !! Remark
|-
| <code>home</code>
| <code>WINDOW_HOME</code>
| <code>10000</code>
| Home.xml
|-
| <code>programs</code>
| <code>WINDOW_PROGRAMS</code>
| <code>10001</code>
| MyPrograms.xml
|-
| <code>pictures</code>
| <code>WINDOW_PICTURES</code>
| <code>10002</code>
| MyPics.xml
|-
| <code>filemanager</code>
| <code>WINDOW_FILES</code>
| <code>10003</code>
| FileManager.xml
|-
| <code>settings</code>
| <code>WINDOW_SETTINGS_MENU</code>
| <code>10004</code>
| Settings.xml
|-
| <code>systeminfo</code>
| <code>WINDOW_SYSTEM_INFORMATION</code>
| <code>10007</code>
| SettingsSystemInfo.xml
|-
| <code>testpattern</code>
| <code>WINDOW_TEST_PATTERN</code>
| <code>10008</code>
| none
|-
| <code>screencalibration</code>
| <code>WINDOW_SCREEN_CALIBRATION</code>
| <code>10011</code>
| SettingsScreenCalibration.xml
|-
| <code>systemsettings</code>
| <code>WINDOW_SETTINGS_SYSTEM</code>
| <code>10016</code>
| SettingsCategory.xml
|-
| <code>servicesettings</code>
| <code>WINDOW_SETTINGS_SERVICE</code>
| <code>10018</code>
| SettingsCategory.xml
|-
| <code>pvrsettings</code>
| <code>WINDOW_SETTINGS_MYPVR</code>
| <code>10021</code>
| SettingsCategory.xml
|-
| <code>gamesettings</code>
| <code>WINDOW_SETTINGS_MYGAMES</code>
| <code>10022</code>
| SettingsCategory.xml
|-
| <code>videos</code>
| <code>WINDOW_VIDEO_NAV</code>
| <code>10025</code>
| MyVideoNav.xml
|-
| <code>videoplaylist</code>
| <code>WINDOW_VIDEO_PLAYLIST</code>
| <code>10028</code>
| MyPlaylist.xml
|-
| <code>loginscreen</code>
| <code>WINDOW_LOGIN_SCREEN</code>
| <code>10029</code>
| LoginScreen.xml
|-
| <code>playersettings</code>
| <code>WINDOW_SETTINGS_PLAYER</code>
| <code>10030</code>
| SettingsCategory.xml
|-
| <code>mediasettings</code>
| <code>WINDOW_SETTINGS_MEDIA</code>
| <code>10031</code>
| SettingsCategory.xml
|-
| <code>interfacesettings</code>
| <code>WINDOW_SETTINGS_INTERFACE</code>
| <code>10032</code>
| SettingsCategory.xml
|-
| <code>profiles</code>
| <code>WINDOW_SETTINGS_PROFILES</code>
| <code>10034</code>
| SettingsProfile.xml
|-
| <code>skinsettings</code>
| <code>WINDOW_SKIN_SETTINGS</code>
| <code>10035</code>
| SkinSettings.xml
|-
| <code>addonbrowser</code>
| <code>WINDOW_ADDON_BROWSER</code>
| <code>10040</code>
| AddonBrowser.xml
|-
| <code>eventlog</code>
| <code>WINDOW_EVENT_LOG</code>
| <code>10050</code>
| EventLog.xml
|-
| <code>favouritesbrowser</code>
| <code>WINDOW_FAVOURITES</code>
| <code>10060</code>
| MyFavourites.xml
| Added in Kodi v20 Nexus
|-
| <code>pointer</code>
| <code>WINDOW_DIALOG_POINTER</code>
| <code>10099</code>
| Pointer.xml
|-
| <code>yesnodialog</code>
| <code>WINDOW_DIALOG_YES_NO</code>
| <code>10100</code>
| DialogConfirm.xml
|-
| <code>progressdialog</code>
| <code>WINDOW_DIALOG_PROGRESS</code>
| <code>10101</code>
| DialogConfirm.xml
|-
| <code>virtualkeyboard</code>
| <code>WINDOW_DIALOG_KEYBOARD</code>
| <code>10103</code>
| DialogKeyboard.xml
|-
| <code>volumebar</code>
| <code>WINDOW_DIALOG_VOLUME_BAR</code>
| <code>10104</code>
| DialogVolumeBar.xml
|-
| <code>submenu</code>
| <code>WINDOW_DIALOG_SUB_MENU</code>
| <code>10105</code>
| DialogSubMenu.xml
|-
| <code>contextmenu</code>
| <code>WINDOW_DIALOG_CONTEXT_MENU</code>
| <code>10106</code>
| DialogContextMenu.xml
|-
| <code>notification</code>
| <code>WINDOW_DIALOG_KAI_TOAST</code>
| <code>10107</code>
| DialogNotification.xml
|-
| <code>numericinput</code>
| <code>WINDOW_DIALOG_NUMERIC</code>
| <code>10109</code>
| DialogNumeric.xml
|-
| <code>gamepadinput</code>
| <code>WINDOW_DIALOG_GAMEPAD</code>
| <code>10110</code>
| DialogSelect.xml
|-
| <code>shutdownmenu</code>
| <code>WINDOW_DIALOG_BUTTON_MENU</code>
| <code>10111</code>
| DialogButtonMenu.xml
|-
| <code>playercontrols</code>
| <code>WINDOW_DIALOG_PLAYER_CONTROLS</code>
| <code>10114</code>
| PlayerControls.xml
|-
| <code>seekbar</code>
| <code>WINDOW_DIALOG_SEEK_BAR</code>
| <code>10115</code>
| DialogSeekBar.xml
|-
| <code>playerprocessinfo</code>
| <code>WINDOW_DIALOG_PLAYER_PROCESS_INFO</code>
| <code>10116</code>
| DialogPlayerProcessInfo.xml
|-
| <code>musicosd</code>
| <code>WINDOW_DIALOG_MUSIC_OSD</code>
| <code>10120</code>
| MusicOSD.xml
|-
| <code></code>
| <code>WINDOW_DIALOG_VIS_SETTINGS</code>
| <code>10121</code>
|
|-
| <code>visualisationpresetlist</code>
| <code>WINDOW_DIALOG_VIS_PRESET_LIST</code>
| <code>10122</code>
| DialogSelect.xml
|-
| <code>osdvideosettings</code>
| <code>WINDOW_DIALOG_VIDEO_OSD_SETTINGS</code>
| <code>10123</code>
| DialogSettings.xml
|-
| <code>osdaudiosettings</code>
| <code>WINDOW_DIALOG_AUDIO_OSD_SETTINGS</code>
| <code>10124</code>
| DialogSettings.xml
|-
| <code>videobookmarks</code>
| <code>WINDOW_DIALOG_VIDEO_BOOKMARKS</code>
| <code>10125</code>
| VideoOSDBookmarks.xml
|-
| <code>filebrowser</code>
| <code>WINDOW_DIALOG_FILE_BROWSER</code>
| <code>10126</code>
| FileBrowser.xml
|-
| <code>networksetup</code>
| <code>WINDOW_DIALOG_NETWORK_SETUP</code>
| <code>10128</code>
| DialogSettings.xml
|-
| <code>mediasource</code>
| <code>WINDOW_DIALOG_MEDIA_SOURCE</code>
| <code>10129</code>
| DialogMediaSource.xml
|-
| <code>profilesettings</code>
| <code>WINDOW_DIALOG_PROFILE_SETTINGS</code>
| <code>10130</code>
| DialogSettings.xml
|-
| <code>locksettings</code>
| <code>WINDOW_DIALOG_LOCK_SETTINGS</code>
| <code>10131</code>
| DialogSettings.xml
|-
| <code>contentsettings</code>
| <code>WINDOW_DIALOG_CONTENT_SETTINGS</code>
| <code>10132</code>
| DialogSettings.xml
|-
| <code>libexportsettings</code>
| <code>WINDOW_DIALOG_LIBEXPORT_SETTINGS</code>
| <code>10133</code>
| DialogSettings.xml
|-
| <code>favourites</code>
| <code>WINDOW_DIALOG_FAVOURITES</code>
| <code>10134</code>
| DialogFavourites.xml
| Deprecated. Will be removed in Kodi v21
|-
| <code>songinformation</code>
| <code>WINDOW_DIALOG_SONG_INFO</code>
| <code>10135</code>
| DialogMusicInfo.xml
|-
| <code>smartplaylisteditor</code>
| <code>WINDOW_DIALOG_SMART_PLAYLIST_EDITOR</code>
| <code>10136</code>
| SmartPlaylistEditor.xml
|-
| <code>smartplaylistrule</code>
| <code>WINDOW_DIALOG_SMART_PLAYLIST_RULE</code>
| <code>10137</code>
| SmartPlaylistRule.xml
|-
| <code>busydialog</code>
| <code>WINDOW_DIALOG_BUSY</code>
| <code>10138</code>
| DialogBusy.xml
|-
| <code>pictureinfo</code>
| <code>WINDOW_DIALOG_PICTURE_INFO</code>
| <code>10139</code>
| DialogPictureInfo.xml
|-
| <code>addonsettings</code>
| <code>WINDOW_DIALOG_ADDON_SETTINGS</code>
| <code>10140</code>
| DialogAddonSettings.xml
|-
| <code>accesspoints</code>
| <code>WINDOW_DIALOG_ACCESS_POINTS</code>
| <code>10141</code>
| DialogAccessPoints.xml
|-
| <code>fullscreeninfo</code>
| <code>WINDOW_DIALOG_FULLSCREEN_INFO</code>
| <code>10142</code>
| DialogFullScreenInfo.xml
|-
| <code>sliderdialog</code>
| <code>WINDOW_DIALOG_SLIDER</code>
| <code>10145</code>
| DialogSlider.xml
|-
| <code>addoninformation</code>
| <code>WINDOW_DIALOG_ADDON_INFO</code>
| <code>10146</code>
| DialogAddonInfo.xml
|-
| <code>textviewer</code>
| <code>WINDOW_DIALOG_TEXT_VIEWER</code>
| <code>10147</code>
| DialogTextViewer.xml
|-
| <code></code>
| <code>WINDOW_DIALOG_PLAY_EJECT</code>
| <code>10148</code>
| DialogConfirm.xml
|-
| <code></code>
| <code>WINDOW_DIALOG_PERIPHERALS</code>
| <code>10149</code>
| DialogSelect.xml
|-
| <code>peripheralsettings</code>
| <code>WINDOW_DIALOG_PERIPHERAL_SETTINGS</code>
| <code>10150</code>
| DialogSettings.xml
|-
| <code>extendedprogressdialog</code>
| <code>WINDOW_DIALOG_EXT_PROGRESS</code>
| <code>10151</code>
| DialogExtendedProgressBar.xml
|-
| <code>mediafilter</code>
| <code>WINDOW_DIALOG_MEDIA_FILTER</code>
| <code>10152</code>
| DialogSettings.xml
|-
| <code>subtitlesearch</code>
| <code>WINDOW_DIALOG_SUBTITLES</code>
| <code>10153</code>
| DialogSubtitles.xml
|-
| <code></code>
| <code>WINDOW_DIALOG_KEYBOARD_TOUCH</code>
| <code>10156</code>
|
|-
| <code>osdcmssettings</code>
| <code>WINDOW_DIALOG_CMS_OSD_SETTINGS</code>
| <code>10157</code>
| DialogSettings.xml
|-
| <code>infoprovidersettings</code>
| <code>WINDOW_DIALOG_INFOPROVIDER_SETTINGS</code>
| <code>10158</code>
| DialogSettings.xml
|-
| <code>osdsubtitlesettings</code>
| <code>WINDOW_DIALOG_SUBTITLE_OSD_SETTINGS</code>
| <code>10159</code>
| DialogSettings.xml
|-
| <code>busydialognocancel</code>
| <code>WINDOW_DIALOG_BUSY_NOCANCEL</code>
| <code>10160</code>
| DialogBusy.xml
|-
| <code>musicplaylist</code>
| <code>WINDOW_MUSIC_PLAYLIST</code>
| <code>10500</code>
| MyPlaylist.xml
|-
| <code>music</code>
| <code>WINDOW_MUSIC_NAV</code>
| <code>10502</code>
| MyMusicNav.xml
|-
| <code>musicplaylisteditor</code>
| <code>WINDOW_MUSIC_PLAYLIST_EDITOR</code>
| <code>10503</code>
| MyMusicPlaylistEditor.xml
|-
| <code>teletext</code>
| <code>WINDOW_DIALOG_OSD_TELETEXT</code>
| <code>10550</code>
|
|-

| <code>pvrguideinfo</code>
| <code>WINDOW_DIALOG_PVR_GUIDE_INFO</code>
| <code>10600</code>
| DialogPVRInfo.xml
|-
| <code>pvrrecordinginfo</code>
| <code>WINDOW_DIALOG_PVR_RECORDING_INFO</code>
| <code>10601</code>
| DialogPVRInfo.xml
|-
| <code>pvrtimersetting</code>
| <code>WINDOW_DIALOG_PVR_TIMER_SETTING</code>
| <code>10602</code>
| DialogSettings.xml
|-
| <code>pvrgroupmanager</code>
| <code>WINDOW_DIALOG_PVR_GROUP_MANAGER</code>
| <code>10603</code>
| DialogPVRGroupManager.xml
|-
| <code>pvrchannelmanager</code>
| <code>WINDOW_DIALOG_PVR_CHANNEL_MANAGER</code>
| <code>10604</code>
| DialogPVRChannelManager.xml
|-
| <code>pvrguidesearch</code>
| <code>WINDOW_DIALOG_PVR_GUIDE_SEARCH</code>
| <code>10605</code>
| DialogPVRGuideSearch.xml
|-
| <code>pvrchannelscan</code>
| <code>WINDOW_DIALOG_PVR_CHANNEL_SCAN</code>
| <code>10606</code>
| none (unused)
|-
| <code>pvrupdateprogress</code>
| <code>WINDOW_DIALOG_PVR_UPDATE_PROGRESS</code>
| <code>10607</code>
| none (unused)
|-
| <code>pvrosdchannels</code>
| <code>WINDOW_DIALOG_PVR_OSD_CHANNELS</code>
| <code>10608</code>
| DialogPVRChannelsOSD.xml
|-
| <code>pvrchannelguide</code>
| <code>WINDOW_DIALOG_PVR_CHANNEL_GUIDE</code>
| <code>10609</code>
| DialogPVRChannelGuide.xml
|-
| <code>pvrradiordsinfo</code>
| <code>WINDOW_DIALOG_PVR_RADIO_RDS_INFO</code>
| <code>10610</code>
| DialogPVRRadioRDSInfo.xml
|-
| <code>pvrrecordingsettings</code>
| <code>WINDOW_DIALOG_PVR_RECORDING_SETTING</code>
| <code>10611</code>
| DialogSettings.xml
|-
| <code></code>
| <code>WINDOW_DIALOG_PVR_CLIENT_PRIORITIES</code>
| <code>10612</code>
| DialogSettings.xml
|-
| <code>tvchannels</code>
| <code>WINDOW_TV_CHANNELS</code>
| <code>10700</code>
| MyPVRChannels.xml
|-
| <code>tvrecordings</code>
| <code>WINDOW_TV_RECORDINGS</code>
| <code>10701</code>
| MyPVRRecordings.xml
|-
| <code>tvguide</code>
| <code>WINDOW_TV_GUIDE</code>
| <code>10702</code>
| MyPVRGuide.xml
|-
| <code>tvtimers</code>
| <code>WINDOW_TV_TIMERS</code>
| <code>10703</code>
| MyPVRTimers.xml
|-
| <code>tvsearch</code>
| <code>WINDOW_TV_SEARCH</code>
| <code>10704</code>
| MyPVRSearch.xml
|-
| <code>radiochannels</code>
| <code>WINDOW_RADIO_CHANNELS</code>
| <code>10705</code>
| MyPVRChannels.xml
|-
| <code>radiorecordings</code>
| <code>WINDOW_RADIO_RECORDINGS</code>
| <code>10706</code>
| MyPVRRecordings.xml
|-
| <code>radioguide</code>
| <code>WINDOW_RADIO_GUIDE</code>
| <code>10707</code>
| MyPVRGuide.xml
|-
| <code>radiotimers</code>
| <code>WINDOW_RADIO_TIMERS</code>
| <code>10708</code>
| MyPVRTimers.xml
|-
| <code>radiosearch</code>
| <code>WINDOW_RADIO_SEARCH</code>
| <code>10709</code>
| MyPVRSearch.xml
|-
| <code>tvtimerrules</code>
| <code>WINDOW_TV_TIMER_RULES</code>
| <code>10710</code>
| MyPVRTimers.xml
|-
| <code>radiotimerrules</code>
| <code>WINDOW_RADIO_TIMER_RULES</code>
| <code>10711</code>
| MyPVRTimers.xml
|-
| <code>FullscreenLiveTV</code>
| <code>WINDOW_FULLSCREEN_LIVETV</code>
| <code>10800</code>
| None (shortcut to fullscreenvideo)
|-
| <code>fullscreenradio</code>
| <code>WINDOW_FULLSCREEN_RADIO</code>
| <code>10801</code>
| None (shortcut to visualisation)
|-
| <code>fullscreenlivetvpreview</code>
| <code>WINDOW_FULLSCREEN_LIVETV_PREVIEW</code>
| <code>10802</code>
| None (shortcut to fullscreenlivetv)
|-
| <code>fullscreenradiopreview</code>
| <code>WINDOW_FULLSCREEN_RADIO_PREVIEW</code>
| <code>10803</code>
| None (shortcut to fullscreenradio
|-
| <code>fullscreenlivetvinput</code>
| <code>WINDOW_FULLSCREEN_LIVETV_INPUT</code>
| <code>10804</code>
| None (shortcut to fullscreenlivetv)
|-
| <code>fullscreenradioinput</code>
| <code>WINDOW_FULLSCREEN_RADIO_INPUT</code>
| <code>10805</code>
| None (shortcut to fullscreenradio)
|-
| <code>gamecontrollers</code>
| <code>WINDOW_DIALOG_GAME_CONTROLLERS</code>
| <code>10820</code>
| DialogGameControllers.xml
|-
| <code>games</code>
| <code>WINDOW_GAMES</code>
| <code>10821</code>
| MyGames.xml
|-
| <code>gameosd</code>
| <code>WINDOW_DIALOG_GAME_OSD</code>
| <code>10822</code>
| GameOSD.xml
|-
| <code>gamevideofilter</code>
| <code>WINDOW_DIALOG_GAME_VIDEO_FILTER</code>
| <code>10823</code>
| DialogSettings.xml
|-
| <code>gameviewmode</code>
| <code>WINDOW_DIALOG_GAME_STRETCH_MODE</code>
| <code>10824</code>
| DialogSelect.xml
|-
| <code>gamevolume</code>
| <code>WINDOW_DIALOG_GAME_VOLUME</code>
| <code>10825</code>
| DialogVolumeBar.xml
|-
| <code>gameadvancedsettings</code>
| <code>WINDOW_DIALOG_GAME_ADVANCED_SETTINGS</code>
| <code>10826</code>
| DialogAddonSettings.xml
|-
| <code>gamevideorotation</code>
| <code>WINDOW_DIALOG_GAME_VIDEO_ROTATION</code>
| <code>10827</code>
| DialogSelect.xml
|-
| <code>Custom Skin Windows</code>
| <code>- </code>
| <code>- </code>
| custom*.xml
|-
| <code>selectdialog</code>
| <code>WINDOW_DIALOG_SELECT</code>
| <code>12000</code>
| DialogSelect.xml
|-
| <code>musicinformation</code>
| <code>WINDOW_DIALOG_MUSIC_INFO</code>
| <code>12001</code>
| DialogMusicInfo.xml
|-
| <code>okdialog</code>
| <code>WINDOW_DIALOG_OK</code>
| <code>12002</code>
| DialogConfirm.xml
|-
| <code>movieinformation</code>
| <code>WINDOW_DIALOG_VIDEO_INFO</code>
| <code>12003</code>
| DialogVideoInfo.xml
|-
| <code>fullscreenvideo</code>
| <code>WINDOW_FULLSCREEN_VIDEO</code>
| <code>12005</code>
| VideoFullScreen.xml
|-
| <code>visualisation</code>
| <code>WINDOW_VISUALISATION</code>
| <code>12006</code>
| MusicVisualisation.xml
|-
| <code>slideshow</code>
| <code>WINDOW_SLIDESHOW</code>
| <code>12007</code>
| SlideShow.xml
|-
| <code>weather</code>
| <code>WINDOW_WEATHER</code>
| <code>12600</code>
| MyWeather.xml
|-
| <code>screensaver</code>
| <code>WINDOW_SCREENSAVER</code>
| <code>12900</code>
| none
|-
| <code>videoosd</code>
| <code>WINDOW_DIALOG_VIDEO_OSD</code>
| <code>12901</code>
| VideoOSD.xml
|-
| <code>videomenu</code>
| <code>WINDOW_VIDEO_MENU</code>
| <code>12902</code>
| none
|-
| <code>videotimeseek</code>
| <code>WINDOW_VIDEO_TIME_SEEK</code>
| <code>12905</code>
| none
|-
| <code>fullscreengame</code>
| <code>WINDOW_FULLSCREEN_GAME</code>
| <code>12906</code>
| none
|-
| <code>splash</code>
| <code>WINDOW_SPLASH</code>
| <code>12997</code>
|
|-
| <code>startwindow</code>
| <code>WINDOW_START</code>
| <code>12998</code>
| shortcut to the current startwindow
|-
| <code>startup</code>
| <code>WINDOW_STARTUP_ANIM</code>
| <code>12999</code>
| Startup.xml
|-
| colspan="5" bgcolor="#ffffff" | In addition, there are the following "special" windows whose id is not really a concern (and you'll notice isn't unique)
|-
| <code>(Python Windows)</code>
| <code>- </code>
| <code>- </code>
| none
|-
| <code>addon</code>
| <code>- </code>
| <code>- </code>
| none
|}
<section end="main content" />
== Removed window IDs ==
* <code>programssettings</code> - Removed in ?
* <code>scripts</code> - Removed in v10 Dharma
* <code>networksettings</code> - Removed in v12 Frodo
* <code>musicscan</code> - Removed in v12 Frodo
* <code>videoscan</code> - Removed in v12 Frodo
* <code>videofiles</code> - Removed in v13 Gotham
* <code>pvr</code> - Replaced in v14 Helix with more specific PVR windows
* <code>karaoke</code> - Removed in v16 Jarvis
* <code>musicoverlay</code> - Removed in v16 Jarvis
* <code>videooverlay</code> - Removed in v16 Jarvis
* <code>musicfiles</code> - Removed in v16 Jarvis
* <code>infodialog</code> - Removed in v17 Jarvis
* <code>video</code> - Removed in v17 Krypton
* <code>videolibrary</code> - Removed in v17 Krypton
* <code>musiclibrary</code> - Removed in v17 Krypton
* <code>mutebug</code> - Removed in v17 Krypton
* <code>videossettings</code> - Removed in v17 Krypton
* <code>musicsettings</code> - Removed in v17 Krypton
* <code>appearancesettings</code> - Removed in v17 Krypton
* <code>picturessettings</code> - Removed in v17 Krypton
* <code>weathersettings</code> - Removed in v17 Krypton
* <code>osdaudiodspsettings</code> - Removed in v18 Leia

== See also ==
* [[Keymaps]]
* [[Action IDs]]
* [[Built-in scripting]]

{{top}}
{{updated|19}}

[[Category:Python]]
[[Category:Add-on development]]
[[Category:Skin development]]

Window IDs

2022-10-13T07:44:27Z

Ksooo:

{{mininav|[[Development]]|[[Add-on development]]}}
{{see also|Opening Windows and Dialogs|Python development|Skinning}}
__TOC__
<section begin="main content" />
This table cross-references Window names, Window definitions, and Window ID. The code that performs the cross-reference is found in https://github.com/xbmc/xbmc/blob/master/xbmc/input/WindowTranslator.cpp and https://github.com/xbmc/xbmc/blob/master/xbmc/guilib/WindowIDs.h.

* [[keymap.xml]] uses the Window name.
* Kodi's C++ code uses the Window definitions and Window ID's.
* ActivateWindow() should use the Window name.
* sounds.xml should use the window name<br />

'''You can use secondary parameters with all media windows, as can be seen here:'''
* '''[[Opening Windows and Dialogs]]'''

{| class="prettytable sortable"
|-
! Name !! Definition !! Window ID !! source XML file
|-
| <code>home</code>
| <code>WINDOW_HOME</code>
| <code>10000</code>
| Home.xml
|-
| <code>programs</code>
| <code>WINDOW_PROGRAMS</code>
| <code>10001</code>
| MyPrograms.xml
|-
| <code>pictures</code>
| <code>WINDOW_PICTURES</code>
| <code>10002</code>
| MyPics.xml
|-
| <code>filemanager</code>
| <code>WINDOW_FILES</code>
| <code>10003</code>
| FileManager.xml
|-
| <code>settings</code>
| <code>WINDOW_SETTINGS_MENU</code>
| <code>10004</code>
| Settings.xml
|-
| <code>systeminfo</code>
| <code>WINDOW_SYSTEM_INFORMATION</code>
| <code>10007</code>
| SettingsSystemInfo.xml
|-
| <code>testpattern</code>
| <code>WINDOW_TEST_PATTERN</code>
| <code>10008</code>
| none
|-
| <code>screencalibration</code>
| <code>WINDOW_SCREEN_CALIBRATION</code>
| <code>10011</code>
| SettingsScreenCalibration.xml
|-
| <code>systemsettings</code>
| <code>WINDOW_SETTINGS_SYSTEM</code>
| <code>10016</code>
| SettingsCategory.xml
|-
| <code>servicesettings</code>
| <code>WINDOW_SETTINGS_SERVICE</code>
| <code>10018</code>
| SettingsCategory.xml
|-
| <code>pvrsettings</code>
| <code>WINDOW_SETTINGS_MYPVR</code>
| <code>10021</code>
| SettingsCategory.xml
|-
| <code>gamesettings</code>
| <code>WINDOW_SETTINGS_MYGAMES</code>
| <code>10022</code>
| SettingsCategory.xml
|-
| <code>videos</code>
| <code>WINDOW_VIDEO_NAV</code>
| <code>10025</code>
| MyVideoNav.xml
|-
| <code>videoplaylist</code>
| <code>WINDOW_VIDEO_PLAYLIST</code>
| <code>10028</code>
| MyPlaylist.xml
|-
| <code>loginscreen</code>
| <code>WINDOW_LOGIN_SCREEN</code>
| <code>10029</code>
| LoginScreen.xml
|-
| <code>playersettings</code>
| <code>WINDOW_SETTINGS_PLAYER</code>
| <code>10030</code>
| SettingsCategory.xml
|-
| <code>mediasettings</code>
| <code>WINDOW_SETTINGS_MEDIA</code>
| <code>10031</code>
| SettingsCategory.xml
|-
| <code>interfacesettings</code>
| <code>WINDOW_SETTINGS_INTERFACE</code>
| <code>10032</code>
| SettingsCategory.xml
|-
| <code>profiles</code>
| <code>WINDOW_SETTINGS_PROFILES</code>
| <code>10034</code>
| SettingsProfile.xml
|-
| <code>skinsettings</code>
| <code>WINDOW_SKIN_SETTINGS</code>
| <code>10035</code>
| SkinSettings.xml
|-
| <code>addonbrowser</code>
| <code>WINDOW_ADDON_BROWSER</code>
| <code>10040</code>
| AddonBrowser.xml
|-
| <code>eventlog</code>
| <code>WINDOW_EVENT_LOG</code>
| <code>10050</code>
| EventLog.xml
|-
| <code>favouritesbrowser</code>
| <code>WINDOW_FAVOURITES</code>
| <code>10060</code>
| MyFavourites.xml
|-
| <code>pointer</code>
| <code>WINDOW_DIALOG_POINTER</code>
| <code>10099</code>
| Pointer.xml
|-
| <code>yesnodialog</code>
| <code>WINDOW_DIALOG_YES_NO</code>
| <code>10100</code>
| DialogConfirm.xml
|-
| <code>progressdialog</code>
| <code>WINDOW_DIALOG_PROGRESS</code>
| <code>10101</code>
| DialogConfirm.xml
|-
| <code>virtualkeyboard</code>
| <code>WINDOW_DIALOG_KEYBOARD</code>
| <code>10103</code>
| DialogKeyboard.xml
|-
| <code>volumebar</code>
| <code>WINDOW_DIALOG_VOLUME_BAR</code>
| <code>10104</code>
| DialogVolumeBar.xml
|-
| <code>submenu</code>
| <code>WINDOW_DIALOG_SUB_MENU</code>
| <code>10105</code>
| DialogSubMenu.xml
|-
| <code>contextmenu</code>
| <code>WINDOW_DIALOG_CONTEXT_MENU</code>
| <code>10106</code>
| DialogContextMenu.xml
|-
| <code>notification</code>
| <code>WINDOW_DIALOG_KAI_TOAST</code>
| <code>10107</code>
| DialogNotification.xml
|-
| <code>numericinput</code>
| <code>WINDOW_DIALOG_NUMERIC</code>
| <code>10109</code>
| DialogNumeric.xml
|-
| <code>gamepadinput</code>
| <code>WINDOW_DIALOG_GAMEPAD</code>
| <code>10110</code>
| DialogSelect.xml
|-
| <code>shutdownmenu</code>
| <code>WINDOW_DIALOG_BUTTON_MENU</code>
| <code>10111</code>
| DialogButtonMenu.xml
|-
| <code>playercontrols</code>
| <code>WINDOW_DIALOG_PLAYER_CONTROLS</code>
| <code>10114</code>
| PlayerControls.xml
|-
| <code>seekbar</code>
| <code>WINDOW_DIALOG_SEEK_BAR</code>
| <code>10115</code>
| DialogSeekBar.xml
|-
| <code>playerprocessinfo</code>
| <code>WINDOW_DIALOG_PLAYER_PROCESS_INFO</code>
| <code>10116</code>
| DialogPlayerProcessInfo.xml
|-
| <code>musicosd</code>
| <code>WINDOW_DIALOG_MUSIC_OSD</code>
| <code>10120</code>
| MusicOSD.xml
|-
| <code></code>
| <code>WINDOW_DIALOG_VIS_SETTINGS</code>
| <code>10121</code>
|
|-
| <code>visualisationpresetlist</code>
| <code>WINDOW_DIALOG_VIS_PRESET_LIST</code>
| <code>10122</code>
| DialogSelect.xml
|-
| <code>osdvideosettings</code>
| <code>WINDOW_DIALOG_VIDEO_OSD_SETTINGS</code>
| <code>10123</code>
| DialogSettings.xml
|-
| <code>osdaudiosettings</code>
| <code>WINDOW_DIALOG_AUDIO_OSD_SETTINGS</code>
| <code>10124</code>
| DialogSettings.xml
|-
| <code>videobookmarks</code>
| <code>WINDOW_DIALOG_VIDEO_BOOKMARKS</code>
| <code>10125</code>
| VideoOSDBookmarks.xml
|-
| <code>filebrowser</code>
| <code>WINDOW_DIALOG_FILE_BROWSER</code>
| <code>10126</code>
| FileBrowser.xml
|-
| <code>networksetup</code>
| <code>WINDOW_DIALOG_NETWORK_SETUP</code>
| <code>10128</code>
| DialogSettings.xml
|-
| <code>mediasource</code>
| <code>WINDOW_DIALOG_MEDIA_SOURCE</code>
| <code>10129</code>
| DialogMediaSource.xml
|-
| <code>profilesettings</code>
| <code>WINDOW_DIALOG_PROFILE_SETTINGS</code>
| <code>10130</code>
| DialogSettings.xml
|-
| <code>locksettings</code>
| <code>WINDOW_DIALOG_LOCK_SETTINGS</code>
| <code>10131</code>
| DialogSettings.xml
|-
| <code>contentsettings</code>
| <code>WINDOW_DIALOG_CONTENT_SETTINGS</code>
| <code>10132</code>
| DialogSettings.xml
|-
| <code>libexportsettings</code>
| <code>WINDOW_DIALOG_LIBEXPORT_SETTINGS</code>
| <code>10133</code>
| DialogSettings.xml
|-
| <code>favourites</code>
| <code>WINDOW_DIALOG_FAVOURITES</code>
| <code>10134</code>
| DialogFavourites.xml
|-
| <code>songinformation</code>
| <code>WINDOW_DIALOG_SONG_INFO</code>
| <code>10135</code>
| DialogMusicInfo.xml
|-
| <code>smartplaylisteditor</code>
| <code>WINDOW_DIALOG_SMART_PLAYLIST_EDITOR</code>
| <code>10136</code>
| SmartPlaylistEditor.xml
|-
| <code>smartplaylistrule</code>
| <code>WINDOW_DIALOG_SMART_PLAYLIST_RULE</code>
| <code>10137</code>
| SmartPlaylistRule.xml
|-
| <code>busydialog</code>
| <code>WINDOW_DIALOG_BUSY</code>
| <code>10138</code>
| DialogBusy.xml
|-
| <code>pictureinfo</code>
| <code>WINDOW_DIALOG_PICTURE_INFO</code>
| <code>10139</code>
| DialogPictureInfo.xml
|-
| <code>addonsettings</code>
| <code>WINDOW_DIALOG_ADDON_SETTINGS</code>
| <code>10140</code>
| DialogAddonSettings.xml
|-
| <code>accesspoints</code>
| <code>WINDOW_DIALOG_ACCESS_POINTS</code>
| <code>10141</code>
| DialogAccessPoints.xml
|-
| <code>fullscreeninfo</code>
| <code>WINDOW_DIALOG_FULLSCREEN_INFO</code>
| <code>10142</code>
| DialogFullScreenInfo.xml
|-
| <code>sliderdialog</code>
| <code>WINDOW_DIALOG_SLIDER</code>
| <code>10145</code>
| DialogSlider.xml
|-
| <code>addoninformation</code>
| <code>WINDOW_DIALOG_ADDON_INFO</code>
| <code>10146</code>
| DialogAddonInfo.xml
|-
| <code>textviewer</code>
| <code>WINDOW_DIALOG_TEXT_VIEWER</code>
| <code>10147</code>
| DialogTextViewer.xml
|-
| <code></code>
| <code>WINDOW_DIALOG_PLAY_EJECT</code>
| <code>10148</code>
| DialogConfirm.xml
|-
| <code></code>
| <code>WINDOW_DIALOG_PERIPHERALS</code>
| <code>10149</code>
| DialogSelect.xml
|-
| <code>peripheralsettings</code>
| <code>WINDOW_DIALOG_PERIPHERAL_SETTINGS</code>
| <code>10150</code>
| DialogSettings.xml
|-
| <code>extendedprogressdialog</code>
| <code>WINDOW_DIALOG_EXT_PROGRESS</code>
| <code>10151</code>
| DialogExtendedProgressBar.xml
|-
| <code>mediafilter</code>
| <code>WINDOW_DIALOG_MEDIA_FILTER</code>
| <code>10152</code>
| DialogSettings.xml
|-
| <code>subtitlesearch</code>
| <code>WINDOW_DIALOG_SUBTITLES</code>
| <code>10153</code>
| DialogSubtitles.xml
|-
| <code></code>
| <code>WINDOW_DIALOG_KEYBOARD_TOUCH</code>
| <code>10156</code>
|
|-
| <code>osdcmssettings</code>
| <code>WINDOW_DIALOG_CMS_OSD_SETTINGS</code>
| <code>10157</code>
| DialogSettings.xml
|-
| <code>infoprovidersettings</code>
| <code>WINDOW_DIALOG_INFOPROVIDER_SETTINGS</code>
| <code>10158</code>
| DialogSettings.xml
|-
| <code>osdsubtitlesettings</code>
| <code>WINDOW_DIALOG_SUBTITLE_OSD_SETTINGS</code>
| <code>10159</code>
| DialogSettings.xml
|-
| <code>busydialognocancel</code>
| <code>WINDOW_DIALOG_BUSY_NOCANCEL</code>
| <code>10160</code>
| DialogBusy.xml
|-
| <code>musicplaylist</code>
| <code>WINDOW_MUSIC_PLAYLIST</code>
| <code>10500</code>
| MyPlaylist.xml
|-
| <code>music</code>
| <code>WINDOW_MUSIC_NAV</code>
| <code>10502</code>
| MyMusicNav.xml
|-
| <code>musicplaylisteditor</code>
| <code>WINDOW_MUSIC_PLAYLIST_EDITOR</code>
| <code>10503</code>
| MyMusicPlaylistEditor.xml
|-
| <code>teletext</code>
| <code>WINDOW_DIALOG_OSD_TELETEXT</code>
| <code>10550</code>
|
|-

| <code>pvrguideinfo</code>
| <code>WINDOW_DIALOG_PVR_GUIDE_INFO</code>
| <code>10600</code>
| DialogPVRInfo.xml
|-
| <code>pvrrecordinginfo</code>
| <code>WINDOW_DIALOG_PVR_RECORDING_INFO</code>
| <code>10601</code>
| DialogPVRInfo.xml
|-
| <code>pvrtimersetting</code>
| <code>WINDOW_DIALOG_PVR_TIMER_SETTING</code>
| <code>10602</code>
| DialogSettings.xml
|-
| <code>pvrgroupmanager</code>
| <code>WINDOW_DIALOG_PVR_GROUP_MANAGER</code>
| <code>10603</code>
| DialogPVRGroupManager.xml
|-
| <code>pvrchannelmanager</code>
| <code>WINDOW_DIALOG_PVR_CHANNEL_MANAGER</code>
| <code>10604</code>
| DialogPVRChannelManager.xml
|-
| <code>pvrguidesearch</code>
| <code>WINDOW_DIALOG_PVR_GUIDE_SEARCH</code>
| <code>10605</code>
| DialogPVRGuideSearch.xml
|-
| <code>pvrchannelscan</code>
| <code>WINDOW_DIALOG_PVR_CHANNEL_SCAN</code>
| <code>10606</code>
| none (unused)
|-
| <code>pvrupdateprogress</code>
| <code>WINDOW_DIALOG_PVR_UPDATE_PROGRESS</code>
| <code>10607</code>
| none (unused)
|-
| <code>pvrosdchannels</code>
| <code>WINDOW_DIALOG_PVR_OSD_CHANNELS</code>
| <code>10608</code>
| DialogPVRChannelsOSD.xml
|-
| <code>pvrchannelguide</code>
| <code>WINDOW_DIALOG_PVR_CHANNEL_GUIDE</code>
| <code>10609</code>
| DialogPVRChannelGuide.xml
|-
| <code>pvrradiordsinfo</code>
| <code>WINDOW_DIALOG_PVR_RADIO_RDS_INFO</code>
| <code>10610</code>
| DialogPVRRadioRDSInfo.xml
|-
| <code>pvrrecordingsettings</code>
| <code>WINDOW_DIALOG_PVR_RECORDING_SETTING</code>
| <code>10611</code>
| DialogSettings.xml
|-
| <code></code>
| <code>WINDOW_DIALOG_PVR_CLIENT_PRIORITIES</code>
| <code>10612</code>
| DialogSettings.xml
|-
| <code>tvchannels</code>
| <code>WINDOW_TV_CHANNELS</code>
| <code>10700</code>
| MyPVRChannels.xml
|-
| <code>tvrecordings</code>
| <code>WINDOW_TV_RECORDINGS</code>
| <code>10701</code>
| MyPVRRecordings.xml
|-
| <code>tvguide</code>
| <code>WINDOW_TV_GUIDE</code>
| <code>10702</code>
| MyPVRGuide.xml
|-
| <code>tvtimers</code>
| <code>WINDOW_TV_TIMERS</code>
| <code>10703</code>
| MyPVRTimers.xml
|-
| <code>tvsearch</code>
| <code>WINDOW_TV_SEARCH</code>
| <code>10704</code>
| MyPVRSearch.xml
|-
| <code>radiochannels</code>
| <code>WINDOW_RADIO_CHANNELS</code>
| <code>10705</code>
| MyPVRChannels.xml
|-
| <code>radiorecordings</code>
| <code>WINDOW_RADIO_RECORDINGS</code>
| <code>10706</code>
| MyPVRRecordings.xml
|-
| <code>radioguide</code>
| <code>WINDOW_RADIO_GUIDE</code>
| <code>10707</code>
| MyPVRGuide.xml
|-
| <code>radiotimers</code>
| <code>WINDOW_RADIO_TIMERS</code>
| <code>10708</code>
| MyPVRTimers.xml
|-
| <code>radiosearch</code>
| <code>WINDOW_RADIO_SEARCH</code>
| <code>10709</code>
| MyPVRSearch.xml
|-
| <code>tvtimerrules</code>
| <code>WINDOW_TV_TIMER_RULES</code>
| <code>10710</code>
| MyPVRTimers.xml
|-
| <code>radiotimerrules</code>
| <code>WINDOW_RADIO_TIMER_RULES</code>
| <code>10711</code>
| MyPVRTimers.xml
|-
| <code>FullscreenLiveTV</code>
| <code>WINDOW_FULLSCREEN_LIVETV</code>
| <code>10800</code>
| None (shortcut to fullscreenvideo)
|-
| <code>fullscreenradio</code>
| <code>WINDOW_FULLSCREEN_RADIO</code>
| <code>10801</code>
| None (shortcut to visualisation)
|-
| <code>fullscreenlivetvpreview</code>
| <code>WINDOW_FULLSCREEN_LIVETV_PREVIEW</code>
| <code>10802</code>
| None (shortcut to fullscreenlivetv)
|-
| <code>fullscreenradiopreview</code>
| <code>WINDOW_FULLSCREEN_RADIO_PREVIEW</code>
| <code>10803</code>
| None (shortcut to fullscreenradio
|-
| <code>fullscreenlivetvinput</code>
| <code>WINDOW_FULLSCREEN_LIVETV_INPUT</code>
| <code>10804</code>
| None (shortcut to fullscreenlivetv)
|-
| <code>fullscreenradioinput</code>
| <code>WINDOW_FULLSCREEN_RADIO_INPUT</code>
| <code>10805</code>
| None (shortcut to fullscreenradio)
|-
| <code>gamecontrollers</code>
| <code>WINDOW_DIALOG_GAME_CONTROLLERS</code>
| <code>10820</code>
| DialogGameControllers.xml
|-
| <code>games</code>
| <code>WINDOW_GAMES</code>
| <code>10821</code>
| MyGames.xml
|-
| <code>gameosd</code>
| <code>WINDOW_DIALOG_GAME_OSD</code>
| <code>10822</code>
| GameOSD.xml
|-
| <code>gamevideofilter</code>
| <code>WINDOW_DIALOG_GAME_VIDEO_FILTER</code>
| <code>10823</code>
| DialogSettings.xml
|-
| <code>gameviewmode</code>
| <code>WINDOW_DIALOG_GAME_STRETCH_MODE</code>
| <code>10824</code>
| DialogSelect.xml
|-
| <code>gamevolume</code>
| <code>WINDOW_DIALOG_GAME_VOLUME</code>
| <code>10825</code>
| DialogVolumeBar.xml
|-
| <code>gameadvancedsettings</code>
| <code>WINDOW_DIALOG_GAME_ADVANCED_SETTINGS</code>
| <code>10826</code>
| DialogAddonSettings.xml
|-
| <code>gamevideorotation</code>
| <code>WINDOW_DIALOG_GAME_VIDEO_ROTATION</code>
| <code>10827</code>
| DialogSelect.xml
|-
| <code>Custom Skin Windows</code>
| <code>- </code>
| <code>- </code>
| custom*.xml
|-
| <code>selectdialog</code>
| <code>WINDOW_DIALOG_SELECT</code>
| <code>12000</code>
| DialogSelect.xml
|-
| <code>musicinformation</code>
| <code>WINDOW_DIALOG_MUSIC_INFO</code>
| <code>12001</code>
| DialogMusicInfo.xml
|-
| <code>okdialog</code>
| <code>WINDOW_DIALOG_OK</code>
| <code>12002</code>
| DialogConfirm.xml
|-
| <code>movieinformation</code>
| <code>WINDOW_DIALOG_VIDEO_INFO</code>
| <code>12003</code>
| DialogVideoInfo.xml
|-
| <code>fullscreenvideo</code>
| <code>WINDOW_FULLSCREEN_VIDEO</code>
| <code>12005</code>
| VideoFullScreen.xml
|-
| <code>visualisation</code>
| <code>WINDOW_VISUALISATION</code>
| <code>12006</code>
| MusicVisualisation.xml
|-
| <code>slideshow</code>
| <code>WINDOW_SLIDESHOW</code>
| <code>12007</code>
| SlideShow.xml
|-
| <code>weather</code>
| <code>WINDOW_WEATHER</code>
| <code>12600</code>
| MyWeather.xml
|-
| <code>screensaver</code>
| <code>WINDOW_SCREENSAVER</code>
| <code>12900</code>
| none
|-
| <code>videoosd</code>
| <code>WINDOW_DIALOG_VIDEO_OSD</code>
| <code>12901</code>
| VideoOSD.xml
|-
| <code>videomenu</code>
| <code>WINDOW_VIDEO_MENU</code>
| <code>12902</code>
| none
|-
| <code>videotimeseek</code>
| <code>WINDOW_VIDEO_TIME_SEEK</code>
| <code>12905</code>
| none
|-
| <code>fullscreengame</code>
| <code>WINDOW_FULLSCREEN_GAME</code>
| <code>12906</code>
| none
|-
| <code>splash</code>
| <code>WINDOW_SPLASH</code>
| <code>12997</code>
|
|-
| <code>startwindow</code>
| <code>WINDOW_START</code>
| <code>12998</code>
| shortcut to the current startwindow
|-
| <code>startup</code>
| <code>WINDOW_STARTUP_ANIM</code>
| <code>12999</code>
| Startup.xml
|-
| colspan="5" bgcolor="#ffffff" | In addition, there are the following "special" windows whose id is not really a concern (and you'll notice isn't unique)
|-
| <code>(Python Windows)</code>
| <code>- </code>
| <code>- </code>
| none
|-
| <code>addon</code>
| <code>- </code>
| <code>- </code>
| none
|}
<section end="main content" />
== Removed window IDs ==
* <code>programssettings</code> - Removed in ?
* <code>scripts</code> - Removed in v10 Dharma
* <code>networksettings</code> - Removed in v12 Frodo
* <code>musicscan</code> - Removed in v12 Frodo
* <code>videoscan</code> - Removed in v12 Frodo
* <code>videofiles</code> - Removed in v13 Gotham
* <code>pvr</code> - Replaced in v14 Helix with more specific PVR windows
* <code>karaoke</code> - Removed in v16 Jarvis
* <code>musicoverlay</code> - Removed in v16 Jarvis
* <code>videooverlay</code> - Removed in v16 Jarvis
* <code>musicfiles</code> - Removed in v16 Jarvis
* <code>infodialog</code> - Removed in v17 Jarvis
* <code>video</code> - Removed in v17 Krypton
* <code>videolibrary</code> - Removed in v17 Krypton
* <code>musiclibrary</code> - Removed in v17 Krypton
* <code>mutebug</code> - Removed in v17 Krypton
* <code>videossettings</code> - Removed in v17 Krypton
* <code>musicsettings</code> - Removed in v17 Krypton
* <code>appearancesettings</code> - Removed in v17 Krypton
* <code>picturessettings</code> - Removed in v17 Krypton
* <code>weathersettings</code> - Removed in v17 Krypton
* <code>osdaudiodspsettings</code> - Removed in v18 Leia

== See also ==
* [[Keymaps]]
* [[Action IDs]]
* [[Built-in scripting]]

{{top}}
{{updated|19}}

[[Category:Python]]
[[Category:Add-on development]]
[[Category:Skin development]]

Add-on:Pluto.tv PVR Client

2021-11-30T16:38:15Z

Ksooo:

{{Addon
|Name=Pluto.tv PVR Client
|provider-name=Team Kodi
|ID=pvr.plutotv
|latest-version=20.0.0
|extension point=kodi.pvrclient
|provides=
|Summary=Pluto.tv PVR Client
|Description=Pluto.tv PVR Client. Hinweis: Dies ist kein offizielles Pluto.tv-Plugin und steht nicht in Verbindung zu Pluto.tv. Es wurde von Freiwilligen entwickelt.
|Platform=all
|Language=
|License=GNU General Public License. Version 2, June 1991
|Forum=
|Website=https://pluto.tv/
|Source=https://github.com/kodi-pvr/pvr.plutotv
|Email=
|broken=
|icon url=http://mirrors.kodi.tv/addons/matrix/pvr.plutotv+osx-x86_64/icon.png}}

[[Category:Add-ons missing type]]
[[Category:Add-ons with license tag]]
[[Category:Add-ons with source tag]]
[[Category:Add-ons with website tag]]
[[Category:All add-ons]]
[[Category:Matrix add-on repository]]
[[Category:Nexus add-on repository]]

InfoLabels

2021-04-29T20:22:55Z

Ksooo:

{{mininav|[[Development]]|[[Add-on development]]|[[Skinning]]}}
<section begin="main content" />
Skins can use infolabels with $INFO[infolabel] or the <info> tag. Scripts can read infolabels with <code>xbmc.getInfoLabel('infolabel')</code>.

An up-to-date list can be found here [https://github.com/xbmc/xbmc/blob/master/xbmc/GUIInfoManager.cpp GUIInfoManager.cpp]

=== Container ===

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| Container.Content
| Shows content of the current container
|
|-
| Container.FolderPath
| Shows complete path of currently displayed folder
|
|-
| Container.FolderName
| Shows top most folder in currently displayed folder
|
|-
| Container.Viewmode
| Returns the current viewmode (list, icons etc.)
|
|-
| Container.SortMethod
| Returns the current sort method (returns the localized name of: title, year, rating, etc.)
|
|-
| Container.SortOrder
| Returns the current sort order (Ascending/Descending)
|
|-
| Container.PluginName
| Returns the current plugins base folder name
|
|-
| Container.PluginCategory
| Returns the current plugins category (set by the scripter)
|
|-
| Container.ShowPlot
| Returns the TV Show plot of the current container and can be used at season and episode level
|
|-
| Container.ShowTitle
| Returns the TV Show title of the current container and can be used at season and episode level
| v17 addition
|-
| Container(id).NumPages
| Number of pages in the container with given id. If no id is specified it grabs the current container.
|
|-
| Container(id).NumItems
| Number of items in the container or grouplist with given id. If no id is specified it grabs the current container.
|
|-
| Container(id).NumAllItems
| Number of all items in the container or grouplist with given id including parent folder item.
| v18
|-
| Container(id).NumNonFolderItems
| Number of items in the container or grouplist with given id excluding all folder items.
| v18
|-
| Container(id).CurrentPage
| Current page in the container with given id. If no id is specified it grabs the current container.
|
|-
| Container(id).CurrentItem
| Current absolute item in the container or grouplist with given id. If no id is specified it grabs the current container.
|
|-
| Container(id).Position
| Returns the current focused position of the container / grouplist (id) as a numeric label.
|
|-
| Container(id).Column
| Returns the column number of the focused position in a panel container.
|
|-
| Container(id).Row
| Returns the row number of the focused position in a panel container.
|
|-
| Container.Totaltime
| Returns the total time of all items in the current container
|
|-
| Container.TotalWatched
| Returns the number of watched items in the current container
|
|-
| Container.TotalUnWatched
| Returns the number of unwatched items in the current container
|
|-
| Container(id).ListItem(offset).Label
| Shows ListItem.Label for a specific List or Panel Container with a offset ''( eg: Container(50).Listitem(2).Label )''
|
|-
| Container(id).ListItem(offset).Label2
| Shows ListItem.Label2 for a specific List or Panel Container with a offset ''( eg: Container(50).Listitem(-2).Label2 )''
|
|-
| Container(id).ListItem(offset).Icon
| Shows ListItem.Icon for a specific List or Panel Container with a offset ''( eg: Container(52).Listitem(1).Icon)''
|
|-
| Container(id).ListItem(offset).ActualIcon
| Shows ListItem.ActualIcon for a specific List or Panel Container with a offset ''( eg: Container(50).Listitem(0).ActualIcon )''
|
|-
| Container(id).ListItem(offset).Thumb
| Shows ListItem.Thumb for a specific List or Panel Container with a offset ''( eg: Container(50).Listitem(0).Thumb )''
|
|-
| Container(id).ListItemNoWrap(offset).Property
| Basically returns the same as ListItem(offset) but it won't wrap. That means if the last item of a list is focused, ListItemNoWrap(1) will be empty while ListItem(1) will return the first item of the list. ''Property'' has to be replaced with Label, Label2, Icon etc. ''( eg: Container(50).ListitemNoWrap(1).Plot )''
|
|-
| Container(id).ListItemPosition(id).[infolabel]
| Shows the infolabel for an item at position 'id' in a Container. the id is an offset to the first *visible* item of the container. ''( eg: Container(50).ListItemPosition(4).Genre )''
|
|-
| Container(id).ListItemAbsolute(id).[infolabel]
| Shows the infolabel for an item in a Container. the item id is the absolute position in the container. ''( eg: Container(50).ListItemAbsolute(4).Genre )''
|
|-
| Container.Property(addoncategory)
| Returns the current add-on category
|
|-
| Container.Property(reponame)
| Returns the current add-on repository name
|
|-
| Container.ViewCount
| The number of available skin view modes for the current container listing.
|
|}

=== Control ===

{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| Control.GetLabel(id)[.index()]
| Returns the label value or texture name of the control with the given id. Optionally you can specify index(1) to retrieve label2 from an Edit control.
|
|}

=== Fanart ===

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| Fanart.Color1
| Returns the first of three colors included in the currently selected '''[[Fanart]]''' theme for the parent TV Show. Colors are arranged Lightest to Darkest.
|
|-
| Fanart.Color2
| Returns the second of three colors included in the currently selected '''[[Fanart]]''' theme for the parent TV Show. Colors are arranged Lightest to Darkest.
|
|-
| Fanart.Color3
| Returns the third of three colors included in the currently selected '''[[Fanart]]''' theme for the parent TV Show. Colors are arranged Lightest to Darkest.
|
|}

=== Game ===

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| Game.Title
| Name of the game
| v18
|-
| Game.Platform
| Platform the game runs on (eg. Atari 2600)
| v18
|-
| Game.Genres
| Gerne of the game (eg. Action)
| v18
|-
| Game.Publisher
| Publishing company of the game (eg. Nintendo)
| v18
|-
| Game.Developer
| Developer of the game
| v18
|-
| Game.Overview
| Game description
| v18
|-
| Game.Year
| Year the game was released
| v18
|-
| Game.GameClient
| Name of the used emulator
| v18
|}

=== ListItem ===

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| ListItem.Label
| Shows the left label of the currently selected item in a container
|
|-
| ListItem.Label2
| Shows the right label of the currently selected item in a container
|
|-
| ListItem.Title
| Shows the title of the currently selected song or movie in a container
|
|-
| ListItem.OriginalTitle
| Shows the original title of the currently selected movie in a container
|
|-
| ListItem.SortLetter
| Shows the first letter of the current file in a container
|
|-
| ListItem.TrackNumber
| Shows the track number of the currently selected song in a container
|
|-
| ListItem.Artist
| Shows the artist of the currently selected song in a container
|
|-
| ListItem.AlbumArtist
| Shows the artist of the currently selected album in a list
|
|-
| ListItem.Property(Artist_Born)
| Date of Birth of the currently selected Artist
|
|-
| ListItem.Property(Artist_Died)
| Date of Death of the currently selected Artist
|
|-
| ListItem.Property(Artist_Formed)
| Formation date of the currently selected Band
|
|-
| ListItem.Property(Artist_Disbanded)
| Disbanding date of the currently selected Band
|
|-
| ListItem.Property(Artist_YearsActive)
| Years the currently selected artist has been active
|
|-
| ListItem.Property(Artist_Instrument)
| Instruments played by the currently selected artist
|
|-
| ListItem.Property(Artist_Description)
| Shows a biography of the currently selected artist
|
|-
| ListItem.Property(Artist_Mood)
| Shows the moods of the currently selected artist
|
|-
| ListItem.Property(Artist_Style)
| Shows the styles of the currently selected artist
|
|-
| ListItem.Property(Artist_Genre)
| Shows the genre of the currently selected artist
|
|-
| Listitem.Property(Artist_Sortname)
| Sortname of the currently selected Artist
| v18
|-
| Listitem.Property(Artist_Type)
| Type of the currently selected Artist - person, group, orchestra, choir etc.
| v18
|-
| Listitem.Property(Artist_Gender)
| Gender of the currently selected Artist - male, female, other
| v18
|-
| Listitem.Property(Artist_Disambiguation)
| Brief description of the currently selected Artist that differentiates them from others with the same name
| v18
|-
| ListItem.Album
| Shows the album of the currently selected song in a container
|
|-
| ListItem.Property(Album_Mood)
| Shows the moods of the currently selected Album
|
|-
| ListItem.Property(Album_Style)
| Shows the styles of the currently selected Album
|
|-
| ListItem.Property(Album_Theme)
| Shows the themes of the currently selected Album
|
|-
| ListItem.Property(Album_Type)
| Shows the Album Type (e.g. compilation, enhanced, explicit lyrics) of the currently selected Album
|
|-
| ListItem.Property(Album_Label)
| Shows the record label of the currently selected Album
|
|-
| ListItem.Property(Album_Description)
| Shows a review of the currently selected Album
|
|-
| ListItem.Property(Album_Rating)
| Shows the scraped rating of the currently selected Album
|
|-
| ListItem.Property(Album_UserRating)
| Shows the user rating of the currently selected Album
|
|-
| ListItem.DiscNumber
| Shows the disc number of the currently selected song in a container
|
|-
| ListItem.Year
| Shows the year of the currently selected song, album or movie in a container
|
|-
| ListItem.Premiered
| Shows the release/aired date of the currently selected episode, show, movie or EPG item in a container
|
|-
| ListItem.Genre
| Shows the genre of the currently selected song, album or movie in a container
|
|-
| ListItem.Director
| Shows the director of the currently selected movie in a container
|
|-
| ListItem.Country
| Shows the production country of the currently selected movie in a container
|
|-
| ListItem.Episode
| Shows the episode number value for the currently selected episode. It also shows the number of total, watched or unwatched episodes for the currently selected tvshow or season, based on the the current watched filter.
|
|-
| ListItem.Season
| Shows the season value for the currently selected tvshow
|
|-
| ListItem.TVShowTitle
| Shows the name value for the currently selected tvshow in the season and episode depth of the video library
|
|-
| ListItem.Property(TotalSeasons)
| Shows the total number of seasons for the currently selected tvshow
|
|-
| ListItem.Property(TotalEpisodes)
| Shows the total number of episodes for the currently selected tvshow or season
|
|-
| ListItem.Property(WatchedEpisodes)
| Shows the number of watched episodes for the currently selected tvshow or season
|
|-
| ListItem.Property(UnWatchedEpisodes)
| Shows the number of unwatched episodes for the currently selected tvshow or season
|
|-
| ListItem.Property(NumEpisodes)
| Shows the number of total, watched or unwatched episodes for the currently selected tvshow or season, based on the the current watched filter.
|
|-
| ListItem.PictureAperture
| Shows the F-stop used to take the selected picture. This is the value of the EXIF FNumber tag (hex code 0x829D).
|
|-
| ListItem.PictureAuthor
| Shows the name of the person involved in writing about the selected picture. This is the value of the IPTC Writer tag (hex code 0x7A).
|
|-
| ListItem.PictureByline
| Shows the name of the person who created the selected picture. This is the value of the IPTC Byline tag (hex code 0x50).
|
|-
| ListItem.PictureBylineTitle
| Shows the title of the person who created the selected picture. This is the value of the IPTC BylineTitle tag (hex code 0x55).
|
|-
| ListItem.PictureCamMake
| Shows the manufacturer of the camera used to take the selected picture. This is the value of the EXIF Make tag (hex code 0x010F).
|
|-
| ListItem.PictureCamModel
| Shows the manufacturer's model name or number of the camera used to take the selected picture. This is the value of the EXIF Model tag (hex code 0x0110).
|
|-
| ListItem.PictureCaption
| Shows a description of the selected picture. This is the value of the IPTC Caption tag (hex code 0x78).
|
|-
| ListItem.PictureCategory
| Shows the subject of the selected picture as a category code. This is the value of the IPTC Category tag (hex code 0x0F).
|
|-
| ListItem.PictureCCDWidth
| Shows the width of the CCD in the camera used to take the selected picture. This is calculated from three EXIF tags (0xA002 * 0xA210 / 0xA20e).
|
|-
| ListItem.PictureCity
| Shows the city where the selected picture was taken. This is the value of the IPTC City tag (hex code 0x5A).
|
|-
| ListItem.PictureColour
| Shows whether the selected picture is "Colour" or "Black and White".
|
|-
| ListItem.PictureComment
| Shows a description of the selected picture. This is the value of the EXIF User Comment tag (hex code 0x9286). This is the same value as Slideshow.SlideComment.
|
|-
| ListItem.PictureCopyrightNotice
| Shows the copyright notice of the selected picture. This is the value of the IPTC Copyright tag (hex code 0x74).
|
|-
| ListItem.PictureCountry
| Shows the full name of the country where the selected picture was taken. This is the value of the IPTC CountryName tag (hex code 0x65).
|
|-
| ListItem.PictureCountryCode
| Shows the country code of the country where the selected picture was taken. This is the value of the IPTC CountryCode tag (hex code 0x64).
|
|-
| ListItem.PictureCredit
| Shows who provided the selected picture. This is the value of the IPTC Credit tag (hex code 0x6E).
|
|-
| ListItem.PictureDate
| Shows the localized date of the selected picture. The short form of the date is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
|
|-
| ListItem.PictureDatetime
| Shows the date/timestamp of the selected picture. The localized short form of the date and time is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
|
|-
| ListItem.PictureDesc
| Shows a short description of the selected picture. The SlideComment, EXIFComment, or Caption values might contain a longer description. This is the value of the EXIF ImageDescription tag (hex code 0x010E).
|
|-
| ListItem.PictureDigitalZoom
| Shows the digital zoom ratio when the selected picture was taken. This is the value of the EXIF DigitalZoomRatio tag (hex code 0xA404).
|
|-
| ListItem.PictureExpMode
| Shows the exposure mode of the selected picture. The possible values are "Automatic", "Manual", and "Auto bracketing". This is the value of the EXIF ExposureMode tag (hex code 0xA402).
|
|-
| ListItem.PictureExposure
| Shows the class of the program used by the camera to set exposure when the selected picture was taken. Values include "Manual", "Program (Auto)", "Aperture priority (Semi-Auto)", "Shutter priority (semi-auto)", etc. This is the value of the EXIF ExposureProgram tag (hex code 0x8822).
|
|-
| ListItem.PictureExposureBias
| Shows the exposure bias of the selected picture. Typically this is a number between -99.99 and 99.99. This is the value of the EXIF ExposureBiasValue tag (hex code 0x9204).
|
|-
| ListItem.PictureExpTime
| Shows the exposure time of the selected picture, in seconds. This is the value of the EXIF ExposureTime tag (hex code 0x829A). If the ExposureTime tag is not found, the ShutterSpeedValue tag (hex code 0x9201) might be used.
|
|-
| ListItem.PictureFlashUsed
| Shows the status of flash when the selected picture was taken. The value will be either "Yes" or "No", and might include additional information. This is the value of the EXIF Flash tag (hex code 0x9209).
|
|-
| ListItem.PictureFocalLen
| Shows the lens focal length of the selected picture
|
|-
| ListItem.PictureFocusDist
| Shows the focal length of the lens, in mm. This is the value of the EXIF FocalLength tag (hex code 0x920A).
|
|-
| ListItem.PictureGPSLat
| Shows the latitude where the selected picture was taken (degrees, minutes, seconds North or South). This is the value of the EXIF GPSInfo.GPSLatitude and GPSInfo.GPSLatitudeRef tags.
|
|-
| ListItem.PictureGPSLon
| Shows the longitude where the selected picture was taken (degrees, minutes, seconds East or West). This is the value of the EXIF GPSInfo.GPSLongitude and GPSInfo.GPSLongitudeRef tags.
|
|-
| ListItem.PictureGPSAlt
| Shows the altitude in meters where the selected picture was taken. This is the value of the EXIF GPSInfo.GPSAltitude tag.
|
|-
| ListItem.PictureHeadline
| Shows a synopsis of the contents of the selected picture. This is the value of the IPTC Headline tag (hex code 0x69).
|
|-
| ListItem.PictureImageType
| Shows the color components of the selected picture. This is the value of the IPTC ImageType tag (hex code 0x82).
|
|-
| ListItem.PictureIPTCDate
| Shows the date when the intellectual content of the selected picture was created, rather than when the picture was created. This is the value of the IPTC DateCreated tag (hex code 0x37).
|
|-
| ListItem.PictureIPTCTime
| Shows the time when the intellectual content of the selected picture was created, rather than when the picture was created. This is the value of the IPTC TimeCreated tag (hex code 0x3C).
|
|-
| ListItem.PictureISO
| Shows the ISO speed of the camera when the selected picture was taken. This is the value of the EXIF ISOSpeedRatings tag (hex code 0x8827).
|
|-
| ListItem.PictureKeywords
| Shows keywords assigned to the selected picture. This is the value of the IPTC Keywords tag (hex code 0x19).
|
|-
| ListItem.PictureLightSource
| Shows the kind of light source when the picture was taken. Possible values include "Daylight", "Fluorescent", "Incandescent", etc. This is the value of the EXIF LightSource tag (hex code 0x9208).
|
|-
| ListItem.PictureLongDate
| Shows only the localized date of the selected picture. The long form of the date is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
|
|-
| ListItem.PictureLongDatetime
| Shows the date/timestamp of the selected picture. The localized long form of the date and time is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. if the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
|
|-
| ListItem.PictureMeteringMode
| Shows the metering mode used when the selected picture was taken. The possible values are "Center weight", "Spot", or "Matrix". This is the value of the EXIF MeteringMode tag (hex code 0x9207).
|
|-
| ListItem.PictureObjectName
| Shows a shorthand reference for the selected picture. This is the value of the IPTC ObjectName tag (hex code 0x05).
|
|-
| ListItem.PictureOrientation
| Shows the orientation of the selected picture. Possible values are "Top Left", "Top Right", "Left Top", "Right Bottom", etc. This is the value of the EXIF Orientation tag (hex code 0x0112).
|
|-
| ListItem.PicturePath
| Shows the filename and path of the selected picture
|
|-
| ListItem.PictureProcess
| Shows the process used to compress the selected picture
|
|-
| ListItem.PictureReferenceService
| Shows the Service Identifier of a prior envelope to which the selected picture refers. This is the value of the IPTC ReferenceService tag (hex code 0x2D).
|
|-
| ListItem.PictureResolution
| Shows the dimensions of the selected picture
|
|-
| ListItem.PictureSource
| Shows the original owner of the selected picture. This is the value of the IPTC Source tag (hex code 0x73).
|
|-
| ListItem.PictureSpecialInstructions
| Shows other editorial instructions concerning the use of the selected picture. This is the value of the IPTC SpecialInstructions tag (hex code 0x28).
|
|-
| ListItem.PictureState
| Shows the State/Province where the selected picture was taken. This is the value of the IPTC ProvinceState tag (hex code 0x5F).
|
|-
| ListItem.PictureSublocation
| Shows the location within a city where the selected picture was taken - might indicate the nearest landmark. This is the value of the IPTC SubLocation tag (hex code 0x5C).
|
|-
| ListItem.PictureSupplementalCategories
| Shows supplemental category codes to further refine the subject of the selected picture. This is the value of the IPTC SuppCategory tag (hex code 0x14).
|
|-
| ListItem.PictureTransmissionReference
| Shows a code representing the location of original transmission of the selected picture. This is the value of the IPTC TransmissionReference tag (hex code 0x67).
|
|-
| ListItem.PictureUrgency
| Shows the urgency of the selected picture. Values are 1-9. The "1" is most urgent. Some image management programs use urgency to indicate picture rating, where urgency "1" is 5 stars and urgency "5" is 1 star. Urgencies 6-9 are not used for rating. This is the value of the IPTC Urgency tag (hex code 0x0A).
|
|-
| ListItem.PictureWhiteBalance
| Shows the white balance mode set when the selected picture was taken. The possible values are "Manual" and "Auto". This is the value of the EXIF WhiteBalance tag (hex code 0xA403).
|
|-
| ListItem.FileName
| Shows the filename of the currently selected song or movie in a container
|
|-
| ListItem.FileNameNoExtension
| Returns the filename without its extension.
| v19
|-
| ListItem.Path
| Shows the complete path of the currently selected song or movie in a container
|
|-
| ListItem.FolderName
| Shows top most folder of the path of the currently selected song or movie in a container
|
|-
| ListItem.FolderPath
| Shows the complete path of the currently selected song or movie in a container (without user details).
|
|-
| ListItem.FileNameAndPath
| Shows the full path with filename of the currently selected song or movie in a container
|
|-
| ListItem.FileExtension
| Shows the file extension (without leading dot) of the currently selected item in a container
|
|-
| ListItem.Date
| Shows the file date of the currently selected song or movie in a container / Aired date of an episode / Day, start time and end time of current selected TV programme (PVR)
|
|-
| ListItem.DateAdded
| Shows the date the currently selected item was added to the library / Date and time of an event in the EventLog window.
|
|-
| ListItem.Size
| Shows the file size of the currently selected song or movie in a container
|
|-
| ListItem.Rating[(name)]
| Shows the scraped rating of the currently selected item in a container. Optionally you can specify the name of the scraper to retrieve a specific rating, for use in dialogvideoinfo.xml.
|
|-
| ListItem.Set
| Shows the name of the set the movie is part of
|
|-
| ListItem.SetId
| Shows the id of the set the movie is part of
|
|-
| ListItem.UserRating
| Shows the user rating of the currently selected item in a container
|
|-
| ListItem.Votes[(name)]
| Shows the IMDB votes of the currently selected movie in a container. Optionally you can specify the name of the scraper to retrieve specific votes, for use in dialogvideoinfo.xml.
|
|-
| ListItem.RatingAndVotes[(name)]
| Shows the IMDB rating and votes of the currently selected movie in a container. Optionally you can specify the name of the scraper to retrieve a specific rating and votes, for use in dialogvideoinfo.xml.
|
|-
| ListItem.Mpaa
| Show the MPAA rating of the currently selected movie in a container
|
|-
| ListItem.ProgramCount
| Shows the number of times an xbe has been run from "my programs"
|
|-
| ListItem.Duration[(format)]
| Shows the song or movie duration of the currently selected movie in a container. Optionally specify a time format, hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
|
|-
| ListItem.DBTYPE
| Shows the database type of the ListItem.DBID for videos (video, movie, set, tvshow, season, episode, musicvideo) or for audio (music, song, album, artist). Beware with season, the "*all seasons" entry does give a DBTYPE "season" and a DBID, but you can't get the details of that entry since it's a virtual entry in the Video Library.
|
|-
| ListItem.DBID
| Shows the database id of the currently selected listitem in a container
|
|-
| ListItem.Cast
| Shows a concatenated string of cast members of the currently selected movie, for use in dialogvideoinfo.xml
|
|-
| ListItem.CastAndRole
| Shows a concatenated string of cast members and roles of the currently selected movie, for use in dialogvideoinfo.xml
|
|-
| ListItem.Studio
| Studio of current selected Music Video in a container
|
|-
| ListItem.Top250
| Shows the IMDb top250 position of the currently selected listitem in a container.
|
|-
| ListItem.Trailer
| Shows the full trailer path with filename of the currently selected movie in a container
|
|-
| ListItem.Writer
| Name of Writer of current Video in a container
|
|-
| ListItem.Tagline
| Small Summary of current Video in a container
|
|-
| ListItem.PlotOutline
| Small Summary of current Video in a container
|
|-
| ListItem.Plot
| Complete Text Summary of Video in a container
|
|-
| ListItem.IMDBNumber
| The IMDB iD of the selected Video in a container
|
|-
| ListItem.EpisodeName
| (PVR only) The name of the episode if the selected EPG item is a TV Show
|
|-
| ListItem.PercentPlayed
| Returns percentage value [0-100] of how far the selected video has been played
|
|-
| ListItem.LastPlayed
| Last play date of Video in a container
|
|-
| ListItem.PlayCount
| Playcount of Video in a container
|
|-
| ListItem.StartTime
| Start time of current selected TV programme in a container
|
|-
| ListItem.EndTime
| End time of current selected TV programme in a container
|
|-
| ListItem.StartDate
| Start date of current selected TV programme in a container
|
|-
| ListItem.ChannelName
| Name of current selected TV channel in a container
|
|-
| ListItem.VideoCodec
| Shows the video codec of the currently selected video (common values: 3iv2, avc1, div2, div3, divx, divx 4, dx50, flv, h264, microsoft, mp42, mp43, mp4v, mpeg1video, mpeg2video, mpg4, rv40, svq1, svq3, theora, vp6f, wmv2, wmv3, wvc1, xvid)
|
|-
| ListItem.VideoResolution
| Shows the resolution of the currently selected video (possible values: 480, 576, 540, 720, 1080, 4K, 8K [Note: v18 addition]). Note that 540 usually means a widescreen format (around 960x540) while 576 means PAL resolutions (normally 720x576), therefore 540 is actually better resolution than 576.
| v18
|-
| ListItem.VideoAspect
| Shows the aspect ratio of the currently selected video (possible values: 1.33, 1.37, 1.66, 1.78, 1.85, 2.20, 2.35, 2.40, 2.55, 2.76)
|
|-
| ListItem.AudioCodec
| Shows the audio codec of the currently selected video (common values: aac, ac3, cook, dca, dtshd_hra, dtshd_ma, eac3, mp1, mp2, mp3, pcm_s16be, pcm_s16le, pcm_u8, truehd, vorbis, wmapro, wmav2)
|
|-
| ListItem.AudioChannels
| Shows the number of audio channels of the currently selected video (possible values: 1, 2, 4, 5, 6, 7, 8, 10)
|
|-
| ListItem.AudioLanguage
| Shows the audio language of the currently selected video (returns an ISO 639-2 three character code, e.g. eng, epo, deu)
|
|-
| ListItem.SubtitleLanguage
| Shows the subtitle language of the currently selected video (returns an ISO 639-2 three character code, e.g. eng, epo, deu)
|
|-
| ListItem.Property(AudioCodec.[n])
| Shows the audio codec of the currently selected video, 'n' defines the number of the audiostream (values: see ListItem.AudioCodec)
|
|-
| ListItem.Property(AudioChannels.[n])
| Shows the number of audio channels of the currently selected video, 'n' defines the number of the audiostream (values: see ListItem.AudioChannels)
|
|-
| ListItem.Property(AudioLanguage.[n])
| Shows the audio language of the currently selected video, 'n' defines the number of the audiostream (values: see ListItem.AudioLanguage)
|
|-
| ListItem.Property(SubtitleLanguage.[n])
| Shows the subtitle language of the currently selected video, 'n' defines the number of the subtitle (values: see ListItem.SubtitleLanguage)
|
|-
| ListItem.AddonName
| Shows the name of the currently selected addon
|
|-
| ListItem.AddonVersion
| Shows the version of the currently selected addon
|
|-
| ListItem.AddonSummary
| Shows a short description of the currently selected addon
|
|-
| ListItem.AddonDescription
| Shows the full description of the currently selected addon
|
|-
| ListItem.AddonType
| Shows the type (screensaver, script, skin, etc...) of the currently selected addon
|
|-
| ListItem.AddonCreator
| Shows the name of the author the currently selected addon
|
|-
| ListItem.AddonDisclaimer
| Shows the disclaimer of the currently selected addon
|
|-
| ListItem.AddonBroken
| Deprecated! use ListItem.AddonLifecycleDesc instead
|
|-
| ListItem.Property(Addon.Changelog)
| Shows the changelog of the currently selected addon
|
|-
| ListItem.Property(Addon.ID)
| Shows the identifier of the currently selected addon
|
|-
| ListItem.Property(Addon.Status)
| Shows the status of the currently selected addon
|
|-
| ListItem.Property(Addon.Path)
| Shows the path of the currently selected addon
|
|-
| ListItem.StartTime
| Start time of the selected item (PVR).
|
|-
| ListItem.EndTime
| End time of the selected item (PVR).
|
|-
| ListItem.StartDate
| Start date of the selected item (PVR).
|
|-
| ListItem.EndDate
| End date of the selected item (PVR).
|
|-
| ListItem.NextTitle
| Title of the next item (PVR).
|
|-
| ListItem.NextGenre
| Genre of the next item (PVR).
|
|-
| ListItem.NextPlot
| Plot of the next item (PVR).
|
|-
| ListItem.NextPlotOutline
| Plot outline of the next item (PVR).
|
|-
| ListItem.NextStartTime
| Start time of the next item (PVR).
|
|-
| ListItem.NextEndTime
| End of the next item (PVR).
|
|-
| ListItem.NextStartDate
| Start date of the next item (PVR).
|
|-
| ListItem.NextEndDate
| End date of the next item (PVR).
|
|-
| Listitem.NextDuration
| Duration of the next item (PVR).
| v18
|-
| ListItem.ChannelName
| Channelname of the selected item (PVR).
|
|-
| ListItem.ChannelNumber
| Channel number of the selected item (PVR).
|
|-
| ListItem.ChannelNumberLabel
| Channel and subchannel number of the currently selected channel that's currently playing (PVR).
|
|-
| ListItem.Progress
| Part of the programme that's been played (PVR).
|
|-
| ListItem.StereoscopicMode
| Returns the stereomode of the selected video (i.e. mono, split_vertical, split_horizontal, row_interleaved, anaglyph_cyan_red, anaglyph_green_magenta)
|
|-
| ListItem.Comment
| Comment assigned to the item (PVR/MUSIC).
|
|-
| ListItem.AddonInstallDate
| Date the addon was installed
|
|-
| ListItem.AddonLastUpdated
| Date the addon was last updated
|
|-
| ListItem.AddonLastUsed
| Date the addon was used last
|
|-
| ListItem.AddonNews
| Returns a brief changelog, taken from the addons' addon.xml file
|
|-
| ListItem.AddonSize
| Filesize of the addon
|
|-
| ListItem.Contributors
| List of all people who've contributed to the selected song
|
|-
| ListItem.ContributorAndRole
| List of all people and their role who've contributed to the selected song
|
|-
| ListItem.EndTimeResume
| Returns the time a video will end if you resume it, instead of playing it from the beginning.
|
|-
| ListItem.Mood
| Mood of the selected song
|
|-
| ListItem.Status
| For use with tv shows. It can return one of the following: 'returning series','in production','planned','cancelled' or 'ended'
|
|-
| ListItem.Tag
| Will return the name of the 'tag' this movie is part of.
|
|-
| ListItem.Property(Role.Arranger)
| Returns the name of the person who arranged the selected song
|
|-
| ListItem.Property(Role.Composer)
| Returns the name of the person who composed the selected song
|
|-
| ListItem.Property(Role.Conductor)
| Returns the name of the person who conducted the selected song
|
|-
| ListItem.Property(Role.DJMixer)
| Returns the name of the dj who remixed the selected song
|
|-
| ListItem.Property(Role.Engineer)
| Returns the name of the person who was the engineer of the selected song
|
|-
| ListItem.Property(Role.Lyricist)
| Returns the name of the person who wrote the lyrics of the selected song
|
|-
| ListItem.Property(Role.Mixer)
| Returns the name of the person who mixed the selected song
|
|-
| ListItem.Property(Role.Orchestra)
| Returns the name of the orchestra performing the selected song
|
|-
| ListItem.Property(Role.Producer)
| Returns the name of the person who produced the selected song
|
|-
| ListItem.Property(Role.Remixer)
| Returns the name of the person who remixed the selected song
|
|-
| ListItem.Property(Album_Duration)
| Returns the duration of an album in HH:MM:SS
| v19
|-
| ListItem.Appearances
| Returns the number of movies featuring the selected actor / directed by the selected director
| v17 addition
|-
| ListItem.PrivacyPolicy
| Returns the official Kodi privacy-policy
| v17 addition
|-
| Listitem.Property(game.videofilter)
| Name of the video filter (eg. Bilinear)
| v18
|-
| Listitem.Property(game.stretchmode)
| Name of the stretch mode (eg. Stretch 4:3)
| v18
|-
| Listitem.Property(game.videorotation)
| Angle of the rotation
| v18
|-
| ListItem.CurrentItem
| will return the current index of the item in a container starting at 1.
| v19
|-
| ListItem.DiscTitle
| The disc title of the currently selected album or song
| v19
|-
| ListItem.TotalDiscs
| The total amount of discs belonging to an album
| v19
|-
| ListItem.IsBoxset
| Returns true if the item is part of a boxset
| v19
|-
| ListItem.ReleaseDate
| Returns the release date of the current item
| v19
|-
| ListItem.OriginalDate
| Returns the original release date of the item
|v19
|-
| ListItem.BPM
| Returns the Beats Per Minute for a song
| v19
|-
| ListItem.BitRate
| Returns the bitrate of the current song (Actual rate for CBR, average rate for VBR)
| v19
|-
| ListItem.SampleRate
| Returns the sample rate of a song / 1000.0 eg 44.1, 48, 96 etc
| v19
|-
| ListItem.MusicChannels
| Returns the number of audio channels for a song
| v19
|-
| ListItem.AlbumStatus
| Returns the Musicbrainz release status of the album (offical, bootleg, promotion etc)
| v19
|-
| ListItem.UniqueID()
| Returns the UniqueID of the selected item in a container
| v19
|-
| ListItem.TvShowDBID
| Returns the tv show DBID of the selected season or episode a container
| v19
|-
| ListItem.AddonLifecycleType
| The Lifecycle type of the addon (returns a localized string: normal / broken / deprecated)
| v19
|-
| ListItem.AddonLifecycleDesc
| Description of the Lifecycle type (example: broken due to website changes)
| v19
|}

=== Musicpartymode labels ===

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| MusicPartyMode.SongsPlayed
| Number of songs played during Party Mode
|
|-
| MusicPartyMode.MatchingSongs
| Number of songs available to Party Mode
|
|-
| MusicPartyMode.MatchingSongsPicked
| Number of songs picked already for Party Mode
|
|-
| MusicPartyMode.MatchingSongsLeft
| Number of songs left to be picked from for Party Mode
|
|-
| MusicPartyMode.RelaxedSongsPicked
| Not currently used
|
|-
| MusicPartyMode.RandomSongsPicked
| Number of unique random songs picked during Party Mode
|
|}

=== Network labels ===

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| Network.IsDHCP
| Network type is DHCP or FIXED
|
|-
| Network.IPAddress
| The system's IP Address (<ipaddress> is returned as a string)
|
|-
| Network.LinkState
| Network linkstate e.g. 10mbit/100mbit etc.
|
|-
| Network.MacAddress
| The system's mac address
|
|-
| Network.SubnetMask
| Network subnet mask
|
|-
| Network.GatewayAddress
| Network gateway address
|
|-
| Network.DNS1Address
| Network dns server 1 address
|
|-
| Network.DNS2Address
| Network dns server 2 address
|
|-
| Network.DHCPAddress
| DHCP server ip address
|
|}

=== Player labels ===

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| Player.FinishTime
| Time playing media will end
|
|-
| Player.FinishTime(format)
| Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
|
|-
| Player.Chapter
| Current chapter of current playing media
|
|-
| Player.ChapterCount
| Total number of chapters of current playing media
|
|-
| Player.Time
| Elapsed time of current playing media
|
|-
| Player.Time(format)
| Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
|
|-
| Player.TimeRemaining
| Remaining time of current playing media
|
|-
| Player.TimeRemaining(format)
| Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
|
|-
| Player.Duration
| Total duration of the current playing media
|
|-
| Player.Duration(format)
| Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
|
|-
| Player.SeekTime
| Time to which the user is seeking
|
|-
| Player.SeekBar
| Time to which the user is seeking as a percentage (for use in slider controls)
|
|-
| Player.SeekOffset
| Indicates the seek offset after a seek press (eg user presses BigStepForward, player.seekoffset returns +10:00)
|
|-
| Player.SeekOffset(format)
| Shows hours (hh), minutes (mm) or seconds (ss). Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
|
|-
| Player.SeekStepSize
| Displays the seek step size. (v15 addition)
|
|-
| Player.Progress
| Shows how much (percentage) of the file has been played
|
|-
| Player.ProgressCache
| Shows how much of the file is cached above current play percentage
|
|-
| Player.Folderpath
| Shows the full path of the currently playing song or movie. (supports .offset() and .position())
|
|-
| Player.Filenameandpath
| Shows the full path with filename of the currently playing song or movie. (supports .offset() and .position())
|
|-
| Player.StartTime
| Returns the starttime (from the epg) of a tv program, for all other videos it will return the time you started watching this video.
|
|-
| Player.StartTime(format)
| Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
|
|-
| Player.Title
| Returns the musicplayer title for audio and the videoplayer title for videos. (supports .offset() and .position())
|
|-
| Player.Filename
| Returns the filename of the currently playing media. (supports .offset() and .position())
|
|-
| Player.Volume
| Returns the volume level in dB
|
|-
| Player.PlaySpeed
| Current playspeed. (range:0.8 to 1.5)
|
|-
| Player.Process(AudioBitsPerSample)
| Bits per sample of the currently playing item
|
|-
| Player.Process(AudioChannels)
| Number of audiochannels of the currently playing item
|
|-
| Player.Process(AudioDecoder)
| Audiodecoder name of the currently playing item
|
|-
| Player.Process(AudioSamplerate)
| Samplerate f the currently playing item
|
|-
| Player.Process(DeintMethod)
| Deinterlace method of the currently playing video
|
|-
| Player.Process(PixFormat)
| Pixel format of the currently playing video
|
|-
| Player.Process(VideoDAR)
| Display aspect ratio of the currently playing video
|
|-
| Player.Process(VideoFPS)
| Video framerate of the currently playing video
|
|-
| Player.Process(VideoHeight)
| Height of the currently playing video
|
|-
| Player.Process(VideoDecoder)
| Videodecoder name of the currently playing video
|
|-
| Player.Process(VideoWidth)
| Width of the currently playing video
|
|-
| Player.CutList
| this infolabel can be used with the [[Ranges Control]], as EDL and chapter markers
| v19
|-
| Player.Chapters
| this infolabel can be used with the [[Ranges Control]], as EDL and chapter markers
| v19
|}

==== Music player ====

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| MusicPlayer.Title
| Title of the currently playing song, also available are "MusicPlayer.offset(number).Title" offset is relative to the current playing item and "MusicPlayer.Position(number).Title" position is relative to the start of the playlist
|
|-
| MusicPlayer.Album
| Album from which the current song is from, also available are "MusicPlayer.offset(number).Album" offset is relative to the current playing item and "MusicPlayer.Position(number).Album" position is relative to the start of the playlist
|
|-
| MusicPlayer.Property(Album_Mood)
| Shows the moods of the currently playing Album
|
|-
| MusicPlayer.Property(Album_Style)
| Shows the styles of the currently playing Album
|
|-
| MusicPlayer.Property(Album_Theme)
| Shows the themes of the currently playing Album
|
|-
| MusicPlayer.Property(Album_Type)
| Shows the Album Type (e.g. compilation, enhanced, explicit lyrics) of the currently playing Album
|
|-
| MusicPlayer.Property(Album_Label)
| Shows the record label of the currently playing Album
|
|-
| MusicPlayer.Property(Album_Description)
| Shows a review of the currently playing Album
|
|-
| MusicPlayer.Artist
| Artist(s) of current song, also available are "MusicPlayer.offset(number).Artist" offset is relative to the current playing item and "MusicPlayer.Position(number).Artist" position is relative to the start of the playlist
|
|-
| MusicPlayer.Property(Artist_Born)
| Date of Birth of the currently playing Artist
|
|-
| MusicPlayer.Property(Artist_Died)
| Date of Death of the currently playing Artist
|
|-
| MusicPlayer.Property(Artist_Formed)
| Formation date of the currently playing Artist/Band
|
|-
| MusicPlayer.Property(Artist_Disbanded)
| Disbanding date of the currently playing Artist/Band
|
|-
| MusicPlayer.Property(Artist_YearsActive)
| Years the currently Playing artist has been active
|
|-
| MusicPlayer.Property(Artist_Instrument)
| Instruments played by the currently playing artist
|
|-
| MusicPlayer.Property(Artist_Description)
| Shows a biography of the currently playing artist
|
|-
| MusicPlayer.Property(Artist_Mood)
| Shows the moods of the currently playing artist
|
|-
| MusicPlayer.Property(Artist_Style)
| Shows the styles of the currently playing artist
|
|-
| MusicPlayer.Property(Artist_Genre)
| Shows the genre of the currently playing artist
|
|-
| MusicPlayer.Property(Artist_Sortname)
| Sortname of the currently playing Artist
| v18
|-
| MusicPlayer.Property(Artist_Type)
| Type of the currently playing Artist - person, group, orchestra, choir etc.
| v18
|-
| MusicPlayer.Property(Artist_Gender)
| Gender of the currently playing Artist - male, female, other
| v18
|-
| MusicPlayer.Property(Artist_Disambiguation)
| Brief description of the currently playing Artist that differentiates them from others with the same name
| v18
|-
| MusicPlayer.Genre
| Genre(s) of current song, also available are "MusicPlayer.offset(number).Genre" offset is relative to the current playing item and "MusicPlayer.Position(number).Genre" position is relative to the start of the playlist
|
|-
| MusicPlayer.Lyrics
| Lyrics of current song stored in ID tag info
|
|-
| MusicPlayer.Year
| Year of release of current song, also available are "MusicPlayer.offset(number).Year" offset is relative to the current playing item and "MusicPlayer.Position(number).Year" position is relative to the start of the playlist
|
|-
| MusicPlayer.Rating
| Numeric Rating of current song, also available are "MusicPlayer.offset(number).Rating" offset is relative to the current playing item and "MusicPlayer.Position(number).Rating" position is relative to the start of the playlist
|
|-
| MusicPlayer.DiscNumber
| Disc Number of current song stored in ID tag info, also available are "MusicPlayer.offset(number).DiscNumber" offset is relative to the current playing item and "MusicPlayer.Position(number).DiscNumber" position is relative to the start of the playlist
|
|-
| MusicPlayer.Comment
| Comment of current song stored in ID tag info, also available are "MusicPlayer.offset(number).Comment" offset is relative to the current playing item and "MusicPlayer.Position(number).Comment" position is relative to the start of the playlist
|
|-
| MusicPlayer.Time
| Current time in song
|
|-
| MusicPlayer.TimeRemaining
| Current remaining time in song
|
|-
| MusicPlayer.TimeSpeed
| Both the time and the playspeed formatted up. eg 1:23 (2x)
|
|-
| MusicPlayer.TrackNumber
| Track number of current song, also available are "MusicPlayer.offset(number).TrackNumber" offset is relative to the current playing item and "MusicPlayer.Position(number).TrackNumber" position is relative to the start of the playlist
|
|-
| MusicPlayer.Duration
| Duration of current song, also available are "MusicPlayer.offset(number).Duration" offset is relative to the current playing item and "MusicPlayer.Position(number).Duration" position is relative to the start of the playlist
|
|-
| MusicPlayer.BitRate
| Bitrate of current song
|
|-
| MusicPlayer.Channels
| Number of channels of current song
|
|-
| MusicPlayer.BitsPerSample
| Number of bits per sample of current song
|
|-
| MusicPlayer.SampleRate
| Samplerate of current song
|
|-
| MusicPlayer.Codec
| Codec of current song
|
|-
| MusicPlayer.PlaylistPosition
| Position of the current song in the current music playlist
|
|-
| MusicPlayer.PlaylistLength
| Total size of the current music playlist
|
|-
| MusicPlayer.ChannelName
| Channel name of the radio programme that's currently playing (PVR).
|
|-
| MusicPlayer.ChannelNumberLabel
| Channel and subchannel number of the radio channel that's currently playing (PVR).
|
|-
| MusicPlayer.ChannelGroup
| Channel group of of the radio programme that's currently playing (PVR).
|
|-
| MusicPlayer.Contributors
| List of all people who've contributed to the currently playing song
|
|-
| MusicPlayer.ContributorAndRole
| List of all people and their role who've contributed to the currently playing song
|
|-
| MusicPlayer.Mood
| Mood of the currently playing song
|
|-
| MusicPlayer.Property(Role.Arranger)
| Returns the name of the person who arranged the selected song
|
|-
| MusicPlayer.Property(Role.Composer)
| Returns the name of the person who composed the selected song
|
|-
| MusicPlayer.Property(Role.Conductor)
| Returns the name of the person who conducted the selected song
|
|-
| MusicPlayer.Property(Role.DJMixer)
| Returns the name of the dj who remixed the selected song
|
|-
| MusicPlayer.Property(Role.Engineer)
| Returns the name of the person who was the engineer of the selected song
|
|-
| MusicPlayer.Property(Role.Lyricist)
| Returns the name of the person who wrote the lyrics of the selected song
|
|-
| MusicPlayer.Property(Role.Mixer)
| Returns the name of the person who mixed the selected song
|
|-
| MusicPlayer.Property(Role.Orchestra)
| Returns the name of the orchestra performing the selected song
|
|-
| MusicPlayer.Property(Role.Producer)
| Returns the name of the person who produced the selected song
|
|-
| MusicPlayer.Property(Role.Remixer)
| Returns the name of the person who remixed the selected song
|
|-
| MusicPlayer.UserRating
| The rating the user gave to the currently playing song
|
|-
| MusicPlayer.DBID
| The database id of the currently playing song
| v17 Addition
|-
| MusicPlayer.DiscTitle
| The title of the disc currently playing
| v19
|-
| MusicPlayer.ReleaseDate
| Returns the release date of the song currently playing
| v19
|-
| MusicPlayer.OriginalDate
| Returns the original release date of the song currently playing
| v19
|-
| MusicPlayer.BPM
| Returns the Beats Per Minute of the currently playing song
| v19
|-
| MusicPlayer.TotalDiscs
| Returns the number of discs associated with the album of the currently playing song
| v19
|}

==== Video player ====

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| VideoPlayer.Time
| Current time in movie
|
|-
| VideoPlayer.TimeRemaining
| Current remaining time in movie
|
|-
| VideoPlayer.TimeSpeed
| Current time + playspeed. eg 1:23:14 (-4x)
|
|-
| VideoPlayer.Duration
| Length of current movie
|
|-
| VideoPlayer.Title
| Title of currently playing video. If it's in the database it will return the database title, else the filename. (supports .offset() and .position())
|
|-
| VideoPlayer.OriginalTitle
| The original title of currently playing video. (supports .offset() and .position())
|
|-
| VideoPlayer.TVShowTitle
| Title of currently playing episode's tvshow name. (supports .offset() and .position())
|
|-
| VideoPlayer.Season
| Season number of the currently playing episode, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.Episode
| Episode number of the currently playing episode. (supports .offset() and .position())
|
|-
| VideoPlayer.Genre
| Genre(s) of current movie, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.Director
| Director of current movie, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.Country
| Production country of current movie, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.Year
| Year of release of current movie, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.Premiered
| The release/aired date of the currently selected episode, show, movie or EPG item. (supports .offset() and .position())
|
|-
| VideoPlayer.Rating
| IMDb user rating of current movie, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.UserRating
| Shows the user rating of the currently playing item. (supports .offset() and .position())
|
|-
| VideoPlayer.Votes
| IMDb votes of current movie, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.RatingAndVotes
| IMDb user rating and votes of current movie, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.mpaa
| MPAA rating of current movie, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.IMDBNumber
| The IMDB iD of the current video, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.EpisodeName
| (PVR only) The name of the episode if the playing video is a TV Show, if it's in the database
|
|-
| VideoPlayer.PlaylistPosition
| Position of the current song in the current video playlist
|
|-
| VideoPlayer.PlaylistLength
| Total size of the current video playlist
|
|-
| VideoPlayer.Cast
| A concatenated string of cast members of the current movie, if it's in the database
|
|-
| VideoPlayer.CastAndRole
| A concatenated string of cast members and roles of the current movie, if it's in the database
|
|-
| VideoPlayer.Trailer
| The trailer of the current movie. (supports .offset() and .position())
|
|-
| VideoPlayer.Album
| Album from which the current Music Video is from, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.Artist
| Artist(s) of current Music Video, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.Studio
| Studio of current Music Video, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.Writer
| Name of Writer of current playing Video, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.Tagline
| Small Summary of current playing Video, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.PlotOutline
| Small Summary of current playing Video, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.Plot
| Complete Text Summary of current playing Video, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.Top250
| Shows the IMDb top250 position of the current playing Video. (supports .offset() and .position())
|
|-
| VideoPlayer.LastPlayed
| Last play date of current playing Video, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.PlayCount
| Playcount of current playing Video, if it's in the database. (supports .offset() and .position())
|
|-
| VideoPlayer.VideoCodec
| Shows the video codec of the currently playing video (common values: see ListItem.VideoCodec)
|
|-
| VideoPlayer.VideoResolution
| Shows the video resolution of the currently playing video (possible values: see ListItem.VideoResolution)
|
|-
| VideoPlayer.VideoAspect
| Shows the aspect ratio of the currently playing video (possible values: see ListItem.VideoAspect)
|
|-
| VideoPlayer.AudioCodec
| Shows the audio codec of the currently playing video, optionally 'n' defines the number of the audiostream (common values: see ListItem.AudioCodec)
|
|-
| VideoPlayer.AudioChannels
| Shows the number of audio channels of the currently playing video (possible values: see ListItem.AudioChannels)
|
|-
| VideoPlayer.AudioLanguage
| Shows the language of the audio of the currently playing video(possible values: see ListItem.AudioLanguage)
|
|-
| VideoPlayer.SubtitlesLanguage
| Shows the language of the subtitle of the currently playing video (possible values: see ListItem.SubtitlesLanguage)
|
|-
| VideoPlayer.StereoscopicMode
| Shows the stereoscopic mode of the currently playing video (possible values: see ListItem.StereoscopicMode)
|
|-
| VideoPlayer.EndTime
| End date of the currently playing programme (PVR).
|
|-
| VideoPlayer.NextTitle
| Title of the programme that will be played next (PVR).
|
|-
| VideoPlayer.NextGenre
| Genre of the programme that will be played next (PVR).
|
|-
| VideoPlayer.NextPlot
| Plot of the programme that will be played next (PVR).
|
|-
| VideoPlayer.NextPlotOutline
| Plot outline of the programme that will be played next (PVR).
|
|-
| VideoPlayer.NextStartTime
| Start time of the programme that will be played next (PVR).
|
|-
| VideoPlayer.NextEndTime
| End time of the programme that will be played next (PVR).
|
|-
| VideoPlayer.NextDuration
| Duration of the programme that will be played next (PVR).
|
|-
| VideoPlayer.ChannelName
| Name of the curently tuned channel (PVR).
|
|-
| VideoPlayer.ChannelNumberLabel
| Channel and subchannel number of the tv channel that's currently playing (PVR).
|
|-
| VideoPlayer.ChannelGroup
| Group of the curently tuned channel (PVR).
|
|-
| VideoPlayer.ParentalRating
| Parental rating of the currently playing programme (PVR).
|
|-
| VideoPlayer.DBID
| The database id of the currently playing video. (supports .offset() and .position())
| v17 Addition
|-
| VideoPlayer.UniqueID()
| Returns the UniqueID of the currently playing video
| v19
|-
| VideoPlayer.TvShowDBID
| Returns the tv show DBID of the currently playing episode
| v19
|}

=== Playlist ===

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| Playlist.Length(media)
| Total size of the current playlist. optional parameter media is either video or music.
|
|-
| Playlist.Position(media)
| Position of the current item in the current playlist. optional parameter media is either video or music.
|
|-
| Playlist.Random
| Returns 'On' or 'Off'
|
|-
| Playlist.Repeat
| Returns string ID's 592 (Repeat One), 593 (Repeat All), or 594 (Repeat Off)
|
|}

=== PVR ===

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| PVR.NowRecordingTitle
| Title of the programme being recorded
|
|-
| PVR.NowRecordingDateTime
| Start date and time of the current recording
|
|-
| PVR.NowRecordingChannel
| Channel number that's being recorded
|
|-
| PVR.NextRecordingTitle
| Title of the next programme that will be recorded
|
|-
| PVR.NextRecordingDateTime
| Start date and time of the next recording
|
|-
| PVR.NextRecordingChannel
| Channel name of the next recording
|
|-
| PVR.BackendName
| Name of the backend being used
|
|-
| PVR.BackendVersion
| Version of the backend that's being used
|
|-
| PVR.BackendHost
| Backend hostname
|
|-
| PVR.BackendDiskSpace
| Available diskspace on the backend
|
|-
| PVR.BackendChannels
| Number of available channels the backend provides
|
|-
| PVR.BackendTimers
| Number of timers set for the backend
|
|-
| PVR.BackendRecordings
| Number of recording available on the backend
|
|-
| PVR.BackendDiskspace
| Free diskspace available for recordings on the backend
|
|-
| PVR.BackendNumber
| Backend number
|
|-
| PVR.TotalDiscSpace
| Total diskspace available for recordings
|
|-
| PVR.NextTimer
| Next timer date
|
|-
| PVR.EpgEventDuration[(format)]
| Returns the duration of the currently played title on TV. See ListItem.Duration for optinional formatting options
|
|-
| PVR.EpgEventElapsedTime[(format)]
| Returns the time position of the currently played title on TV. See ListItem.Duration for optinional formatting options
|
|-
| PVR.EpgEventRemainingTime[(format)]
| Returns the remaining time for currently playing epg event. See ListItem.Duration for optinional formatting options
| v18
|-
| PVR.EpgEventFinishTime[(format)]
| Returns the time the currently playing epg event will end. See ListItem.Duration for optinional formatting options
| v18
|-
| PVR.EpgEventSeekTime[(format)]
| Returns the seek time of the currently playing epg event. See ListItem.Duration for optinional formatting options
| v18
|-
| PVR.EpgEventProgress
| Returns the position of currently played title on TV as integer
|
|-
| PVR.TimeShiftStart[(format)]
| Start position of the timeshift. See ListItem.Duration for optinional formatting options
|
|-
| PVR.TimeShiftEnd[(format)]
| End position of the timeshift. See ListItem.Duration for optinional formatting options
|
|-
| PVR.TimeShiftCur[(format)]
| Current position of the timeshift. See ListItem.Duration for optinional formatting options
|-
| PVR.TimeShiftOffset[(format)]
| Current offset of the timeshift. See ListItem.Duration for optinional formatting options
|
|-
| PVR.TimeShiftProgress
| Returns the position of currently timeshifted title on TV as interger
|
|-
| PVR.ActStreamClient
| Stream client name
|
|-
| PVR.ActStreamDevice
| Stream device name
|
|-
| PVR.ActStreamStatus
| Status of the stream
|
|-
| PVR.ActStreamSignal
| Signal quality of the stream
|
|-
| PVR.ActStreamSnr
| Signal to noise ratio of the stream
|
|-
| PVR.ActStreamBer
| Bit error rate of the stream
|
|-
| PVR.ActStreamUnc
| UNC value of the stream
|
|-
| PVR.ActStreamVideoBitRate
| Video bitrate of the stream
|
|-
| PVR.ActStreamAudioBitRate
| Audio bitrate of the stream
|
|-
| PVR.ActStreamDolbyBitRate
| Dolby bitrate of the stream
|
|-
| PVR.ActStreamProgrSignal
| Signal quality of the programme
|
|-
| PVR.ActStreamProgrSnr
| Signal to noise ratio of the programme
|
|-
| PVR.ActStreamEncryptionName
| Encryption used on the stream
|
|-
| PVR.TVNowRecordingTitle
| Title of the tv programme being recorded
| {{nowrap|v17 Addition}}
|-
| PVR.TVNowRecordingDateTime
| Start date and time of the current tv recording
| {{nowrap|v17 Addition}}
|-
| PVR.TVNowRecordingChannel
| Channel name of the current tv recording
| {{nowrap|v17 Addition}}
|-
| PVR.TVNowRecordingChannelIcon
| Icon of the current recording TV channel
| {{nowrap|v17 Addition}}
|-
| PVR.TVNextRecordingTitle
| Title of the next tv programme that will be recorded
| {{nowrap|v17 Addition}}
|-
| PVR.TVNextRecordingDateTime
| Start date and time of the next tv recording
| {{nowrap|v17 Addition}}
|-
| PVR.TVNextRecordingChannel
| Channel name of the next tv recording
| {{nowrap|v17 Addition}}
|-
| PVR.TVNextRecordingChannelIcon
| Icon of the next recording tv channel
| {{nowrap|v17 Addition}}
|-
| PVR.RadioNowRecordingTitle
| Title of the radio programme being recorded
| {{nowrap|v17 Addition}}
|-
| PVR.RadioNowRecordingDateTime
| Start date and time of the current radio recording
| {{nowrap|v17 Addition}}
|-
| PVR.RadioNowRecordingChannel
| Channel name of the current radio recording
| {{nowrap|v17 Addition}}
|-
| PVR.RadioNowRecordingChannelIcon
| Icon of the current recording radio channel
| {{nowrap|v17 Addition}}
|-
| PVR.RadioNextRecordingTitle
| Title of the next radio programme that will be recorded
| {{nowrap|v17 Addition}}
|-
| PVR.RadioNextRecordingDateTime
| Start date and time of the next radio recording
| {{nowrap|v17 Addition}}
|-
| PVR.RadioNextRecordingChannel
| Channel name of the next radio recording
| {{nowrap|v17 Addition}}
|-
| PVR.ChannelNumberInput
| Label displaying the number the user entered on remote or keyboard
| v18
|-
| PVR.TimeshiftProgressDuration
| Returns the duration of the PVR timeshift progress in the format hh:mm:ss. hh: will be omitted if hours value is zero
| v18
|-
| PVR.TimeshiftProgressDuration(format)
| Returns the duration of the PVR timeshift progress in different formats, hours (hh), minutes (mm) or seconds (ss)
| v18
|-
| PVR.TimeshiftProgressStartTime
| Returns the start time of the PVR timeshift progress in the format hh:mm:ss. hh: will be omitted if hours value is zero
| v18
|-
| PVR.TimeshiftProgressStartTime(format)
| Returns the start time of the PVR timeshift progress in different formats, hours (hh), minutes (mm) or seconds (ss)
| v18
|-
| PVR.TimeshiftProgressEndTime
| Returns the end time of the PVR timeshift progress in the format hh:mm:ss. hh: will be omitted if hours value is zero
| v18
|-
| PVR.TimeshiftProgressEndTime(format)
| Returns the end time of the PVR timeshift progress in different formats, hours (hh), minutes (mm) or seconds (ss)
| v18
|-
| PVR.TimeshiftProgressPlayPos
| Returns the percentage of the current play position within the PVR timeshift progress
| v18
|-
| PVR.TimeshiftProgressEpgStart
| Returns the percentage of the start of the currently playing epg event within the PVR timeshift progress
| v18
|-
| PVR.TimeshiftProgressEpgEnd
| Returns the percentage of the end of the currently playing epg event within the PVR timeshift progress
| v18
|-
| PVR.TimeshiftProgressBufferStart
| Returns the percentage of the start of the timeshift buffer within the PVR timeshift progress
| v18
|-
| PVR.TimeshiftProgressBufferEnd
| Returns the percentage of the end of the timeshift buffer within the PVR timeshift progress
| v18
|-
| PVR.TimeShiftSeekbar
| This is the equivalent of Player.Seekbar, but for LiveTV (can be used in a slider control and indicates the position being seeked to)
| v19
|}

=== RDS ===
{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| RDS.AudioLanguage
| The from RDS reported audio language of channel
|
|-
| RDS.ChannelCountry
| Country where the radio channel is sended
|
|-
| RDS.GetLine(number)
| Returns the last sended RDS text messages on givern number, 0 is thelast and 4 rows are supported (0-3)
|
|-
| RDS.Title
| Title of item; e.g. track title of an album (Only be available on RadiotextPlus)
|
|-
| RDS.Artist
| A person or band/collective generally considered responsible for the work (Only be available on RadiotextPlus)
|
|-
| RDS.Band
| Band/orchestra/accompaniment/musician (Only be available on RadiotextPlus)
|
|-
| RDS.Composer
| Name of the original composer/author (Only be available on RadiotextPlus)
|
|-
| RDS.Conductor
| The artist(s) who performed the work. In classical music this would bethe conductor (Only be available on RadiotextPlus)
|
|-
| RDS.Album
| The collection name to which this track belongs (Only be available on RadiotextPlus)
|
|-
| RDS.TrackNumber
| The track number of the item on the album on which it was originallyreleased. (Only be available on RadiotextPlus)
|
|-
| RDS.RadioStyle
| The from radio channel used style of currently played part, e.g "popmusic", "news" or "weather"
|
|-
| RDS.Comment
| Radio station comment string if available (Only be available on RadiotextPlus)
|
|-
| RDS.InfoNews
| Message / headline (if available) (Only be available on RadiotextPlus)
|
|-
| RDS.InfoNewsLocal
| Local information news sended from radio channel (if available) (Only be available on RadiotextPlus)
|
|-
| RDS.InfoStock
| Quote information; either as one part or as several distinct parts:"name 99latest value 99change 99high 99low 99volume" (if available) (Only be available on RadiotextPlus)
|
|-
| RDS.InfoStockSize
| Number of rows present in stock information (Only be available on RadiotextPlus)
|
|-
| RDS.InfoSport
| Result of a game; either as one part or as several distinct parts:"match 99result", e.g. "Bayern München : Borussia 995:5" (if available) (Only be available on RadiotextPlus)
|
|-
| RDS.InfoSportSize
| Number of rows present in sport information (Only be available on RadiotextPlus)
|
|-
| RDS.InfoLottery
| Raffle / lottery: "key word 99values" (if available) (Only be available on RadiotextPlus)
|
|-
| RDS.InfoLotterySize
| Number of rows present in lottery information (Only be available on RadiotextPlus)
|
|-
| RDS.InfoWeather
| Weather informations sended from radio channel (if available) (Only be available on RadiotextPlus)
|
|-
| RDS.InfoWeatherSize
| Number of rows present in weather information (Only be available on RadiotextPlus)
|
|-
| RDS.InfoCinema
| Information about movies in cinema (if available) (Only be available on RadiotextPlus)
|
|-
| RDS.InfoCinemaSize
| Number of rows present in cinema information (Only be available on RadiotextPlus)
|
|-
| RDS.InfoHoroscope
| Horoscope; either as one part or as two distinct parts:"key word 99text", e.g. "sign of the zodiac 99blablabla" (if available) (Only be available on RadiotextPlus)
|
|-
| RDS.InfoHoroscopeSize
| Number of rows present in horoscope information (Only be available on RadiotextPlus)
|
|-
| RDS.InfoOther
| Other information, not especially specified: "key word 99info" (if available) (Only be available on RadiotextPlus)
|
|-
| RDS.InfoOtherSize
| Number of rows present with other informations (Only be available on RadiotextPlus)
|
|-
| RDS.ProgStation
| Name of the radio channel@note becomes also be set from epg if from RDS not available
|
|-
| RDS.ProgNow
| Now played program name@note becomes also be set from epg if from RDS not available
|
|-
| RDS.ProgNext
| Next played program name (if available)@note becomes also be set from epg if from RDS not available
|
|-
| RDS.ProgHost
| Name of the host of the radio show
|
|-
| RDS.ProgEditStaff
| Name of the editorial staff; e.g. name of editorial journalist (Only be available on RadiotextPlus)
|
|-
| RDS.ProgHomepage
| Link to radio station homepage (Only be available on RadiotextPlus)
|
|-
| RDS.ProgStyle
| Human readable string about radiostyle defined from RDS or RBDS
|
|-
| RDS.PhoneHotline
| The telephone number of the radio station's hotline (Only be available on RadiotextPlus)
|
|-
| RDS.PhoneStudio
| The telephone number of the radio station's studio (Only be available on RadiotextPlus)
|
|-
| RDS.SmsStudio
| The sms number of the radio stations studio (to send directly a sms to the studio) (if available) (Only be available on RadiotextPlus)
|
|-
| RDS.EmailHotline
| The email adress of the radio stations hotline (if available) (Only be available on RadiotextPlus)
|
|-
| RDS.EmailStudio
| The email adress of the radio stations studio (if available) (Only be available on RadiotextPlus)
|
|}

=== Skin ===

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| Skin.CurrentTheme
| Returns the current selected skin theme.
|
|-
| Skin.CurrentColourTheme
| Returns the current selected colour theme of the skin.
|
|-
| Skin.Font
| Returns the current fontset from Font.xml.
| v18 addition
|-
| Skin.String(name)
| Returns the <span class="nobr">user-set</span> skin string, set via the Skin.SetString(name) '''[[List of Built In Functions]]'''. Allows skinners to have <span class="nobr">user-customisable</span> labels.
|
|-
| Skin.AspectRatio
| Returns the closest aspect ratio match using the resolution info from the skin's addon.xml file.
|
|}

=== Slideshow ===

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| Slideshow.Altitude
| Shows the altitude in meters where the current picture was taken. This is the value of the EXIF GPSInfo.GPSAltitude tag.
|
|-
| Slideshow.Aperture
| Shows the F-stop used to take the current picture. This is the value of the EXIF FNumber tag (hex code 0x829D).
|
|-
| Slideshow.Author
| Shows the name of the person involved in writing about the current picture. This is the value of the IPTC Writer tag (hex code 0x7A).
|
|-
| Slideshow.Byline
| Shows the name of the person who created the current picture. This is the value of the IPTC Byline tag (hex code 0x50).
|
|-
| Slideshow.BylineTitle
| Shows the title of the person who created the current picture. This is the value of the IPTC BylineTitle tag (hex code 0x55).
|
|-
| Slideshow.CameraMake
| Shows the manufacturer of the camera used to take the current picture. This is the value of the EXIF Make tag (hex code 0x010F).
|
|-
| Slideshow.CameraModel
| Shows the manufacturer's model name or number of the camera used to take the current picture. This is the value of the EXIF Model tag (hex code 0x0110).
|
|-
| Slideshow.Caption
| Shows a description of the current picture. This is the value of the IPTC Caption tag (hex code 0x78).
|
|-
| Slideshow.Category
| Shows the subject of the current picture as a category code. This is the value of the IPTC Category tag (hex code 0x0F).
|
|-
| Slideshow.CCDWidth
| Shows the width of the CCD in the camera used to take the current picture. This is calculated from three EXIF tags (0xA002 * 0xA210 / 0xA20e).
|
|-
| Slideshow.City
| Shows the city where the current picture was taken. This is the value of the IPTC City tag (hex code 0x5A).
|
|-
| Slideshow.Colour
| Shows whether the current picture is "Colour" or "Black and White".
|
|-
| Slideshow.CopyrightNotice
| Shows the copyright notice of the current picture. This is the value of the IPTC Copyright tag (hex code 0x74).
|
|-
| Slideshow.Country
| Shows the full name of the country where the current picture was taken. This is the value of the IPTC CountryName tag (hex code 0x65).
|
|-
| Slideshow.CountryCode
| Shows the country code of the country where the current picture was taken. This is the value of the IPTC CountryCode tag (hex code 0x64).
|
|-
| Slideshow.Credit
| Shows who provided the current picture. This is the value of the IPTC Credit tag (hex code 0x6E).
|
|-
| Slideshow.DigitalZoom
| Shows the digital zoom ratio when the current picture was taken. This is the value of the EXIF .DigitalZoomRatio tag (hex code 0xA404).
|
|-
| Slideshow.EXIFComment
| Shows a description of the current picture. This is the value of the EXIF User Comment tag (hex code 0x9286). This is the same value as Slideshow.SlideComment.
|
|-
| Slideshow.EXIFDate
| Shows the localized date of the current picture. The short form of the date is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
|
|-
| Slideshow.EXIFDescription
| Shows a short description of the current picture. The SlideComment, EXIFComment, or Caption values might contain a longer description. This is the value of the EXIF ImageDescription tag (hex code 0x010E).
|
|-
| Slideshow.EXIFSoftware
| Shows the name and version of the firmware used by the camera that took the current picture. This is the value of the EXIF Software tag (hex code 0x0131).
|
|-
| Slideshow.EXIFTime
| Shows the date/timestamp of the current picture. The localized short form of the date and time is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
|
|-
| Slideshow.Exposure
| Shows the class of the program used by the camera to set exposure when the current picture was taken. Values include "Manual", "Program (Auto)", "Aperture priority (Semi-Auto)", "Shutter priority (semi-auto)", etc. This is the value of the EXIF ExposureProgram tag (hex code 0x8822).
|
|-
| Slideshow.ExposureBias
| Shows the exposure bias of the current picture. Typically this is a number between -99.99 and 99.99. This is the value of the EXIF ExposureBiasValue tag (hex code 0x9204).
|
|-
| Slideshow.ExposureMode
| Shows the exposure mode of the current picture. The possible values are "Automatic", "Manual", and "Auto bracketing". This is the value of the EXIF ExposureMode tag (hex code 0xA402).
|
|-
| Slideshow.ExposureTime
| Shows the exposure time of the current picture, in seconds. This is the value of the EXIF ExposureTime tag (hex code 0x829A). If the ExposureTime tag is not found, the ShutterSpeedValue tag (hex code 0x9201) might be used.
|
|-
| Slideshow.Filedate
| Shows the file date of the current picture
|
|-
| Slideshow.Filename
| Shows the file name of the current picture
|
|-
| Slideshow.Filesize
| Shows the file size of the current picture
|
|-
| Slideshow.FlashUsed
| Shows the status of flash when the current picture was taken. The value will be either "Yes" or "No", and might include additional information. This is the value of the EXIF Flash tag (hex code 0x9209).
|
|-
| Slideshow.FocalLength
| Shows the focal length of the lens, in mm. This is the value of the EXIF FocalLength tag (hex code 0x920A).
|
|-
| Slideshow.FocusDistance
| Shows the distance to the subject, in meters. This is the value of the EXIF SubjectDistance tag (hex code 0x9206).
|
|-
| Slideshow.Headline
| Shows a synopsis of the contents of the current picture. This is the value of the IPTC Headline tag (hex code 0x69).
|
|-
| Slideshow.ImageType
| Shows the color components of the current picture. This is the value of the IPTC ImageType tag (hex code 0x82).
|
|-
| Slideshow.IPTCDate
| Shows the date when the intellectual content of the current picture was created, rather than when the picture was created. This is the value of the IPTC DateCreated tag (hex code 0x37).
|
|-
| Slideshow.ISOEquivalence
| Shows the ISO speed of the camera when the current picture was taken. This is the value of the EXIF ISOSpeedRatings tag (hex code 0x8827).
|
|-
| Slideshow.Keywords
| Shows keywords assigned to the current picture. This is the value of the IPTC Keywords tag (hex code 0x19).
|
|-
| Slideshow.Latitude
| Shows the latitude where the current picture was taken (degrees, minutes, seconds North or South). This is the value of the EXIF GPSInfo.GPSLatitude and GPSInfo.GPSLatitudeRef tags.
|
|-
| Slideshow.LightSource
| Shows the kind of light source when the picture was taken. Possible values include "Daylight", "Fluorescent", "Incandescent", etc. This is the value of the EXIF LightSource tag (hex code 0x9208).
|
|-
| Slideshow.LongEXIFDate
| Shows only the localized date of the current picture. The long form of the date is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
|
|-
| Slideshow.LongEXIFTime
| Shows the date/timestamp of the current picture. The localized long form of the date and time is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. if the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
|
|-
| Slideshow.Longitude
| Shows the longitude where the current picture was taken (degrees, minutes, seconds East or West). This is the value of the EXIF GPSInfo.GPSLongitude and GPSInfo.GPSLongitudeRef tags.
|
|-
| Slideshow.MeteringMode
| Shows the metering mode used when the current picture was taken. The possible values are "Center weight", "Spot", or "Matrix". This is the value of the EXIF MeteringMode tag (hex code 0x9207).
|
|-
| Slideshow.ObjectName
| Shows a shorthand reference for the current picture. This is the value of the IPTC ObjectName tag (hex code 0x05).
|
|-
| Slideshow.Orientation
| Shows the orientation of the current picture. Possible values are "Top Left", "Top Right", "Left Top", "Right Bottom", etc. This is the value of the EXIF Orientation tag (hex code 0x0112).
|
|-
| Slideshow.Path
| Shows the file path of the current picture
|
|-
| Slideshow.Process
| Shows the process used to compress the current picture
|
|-
| Slideshow.ReferenceService
| Shows the Service Identifier of a prior envelope to which the current picture refers. This is the value of the IPTC ReferenceService tag (hex code 0x2D).
|
|-
| Slideshow.Resolution
| Shows the dimensions of the current picture (Width x Height)
|
|-
| Slideshow.SlideComment
| Shows a description of the current picture. This is the value of the EXIF User Comment tag (hex code 0x9286). This is the same value as Slideshow.EXIFComment.
|
|-
| Slideshow.SlideIndex
| Shows the slide index of the current picture
|
|-
| Slideshow.Source
| Shows the original owner of the current picture. This is the value of the IPTC Source tag (hex code 0x73).
|
|-
| Slideshow.SpecialInstructions
| Shows other editorial instructions concerning the use of the current picture. This is the value of the IPTC SpecialInstructions tag (hex code 0x28).
|
|-
| Slideshow.State
| Shows the State/Province where the current picture was taken. This is the value of the IPTC ProvinceState tag (hex code 0x5F).
|
|-
| Slideshow.Sublocation
| Shows the location within a city where the current picture was taken - might indicate the nearest landmark. This is the value of the IPTC SubLocation tag (hex code 0x5C).
|
|-
| Slideshow.SupplementalCategories
| Shows supplemental category codes to further refine the subject of the current picture. This is the value of the IPTC SuppCategory tag (hex code 0x14).
|
|-
| Slideshow.TimeCreated
| Shows the time when the intellectual content of the current picture was created, rather than when the picture was created. This is the value of the IPTC TimeCreated tag (hex code 0x3C).
|
|-
| Slideshow.TransmissionReference
| Shows a code representing the location of original transmission of the current picture. This is the value of the IPTC TransmissionReference tag (hex code 0x67).
|
|-
| Slideshow.Urgency
| Shows the urgency of the current picture. Values are 1-9. The 1 is most urgent. Some image management programs use urgency to indicate picture rating, where urgency 1 is 5 stars and urgency 5 is 1 star. Urgencies 6-9 are not used for rating. This is the value of the IPTC Urgency tag (hex code 0x0A).
|
|-
| Slideshow.WhiteBalance
| Shows the white balance mode set when the current picture was taken. The possible values are "Manual" and "Auto". This is the value of the EXIF WhiteBalance tag (hex code 0xA403).
|
|}

=== System ===

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| System.Time
| Current time
|
|-
| System.Time(format)
| Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss). (xx) option added after dharma
|
|-
| System.Date
| Current date
|
|-
| System.Date(format)
| Show current date using format, available markings: d (day of month 1-31), dd (day of month 01-31), ddd (short day of the week Mon-Sun), DDD (long day of the week Monday-Sunday), m (month 1-12), mm (month 01-12), mmm (short month name Jan-Dec), MMM (long month name January-December), yy (2-digit year), yyyy (4-digit year). Added after dharma.
|
|-
| System.AlarmPos
| Shutdown Timer position
|
|-
| System.BatteryLevel
| Returns the remaining battery level in range 0-100
|
|-
| System.FreeSpace
| Total Freespace on the drive
|
|-
| System.UsedSpace
| Total Usedspace on the drive
|
|-
| System.TotalSpace
| Totalspace on the drive
|
|-
| System.UsedSpacePercent
| Total Usedspace Percent on the drive
|
|-
| System.FreeSpacePercent
| Total Freespace Percent on the drive
|
|-
| System.CPUTemperature
| Current CPU temperature
|
|-
| System.CpuUsage
| Displays the cpu usage for each individual cpu core.
|
|-
| System.CoreUsage(id)
| Displays the usage of the cpu core with the given 'id'
|
|-
| System.GPUTemperature
| Current GPU temperature
|
|-
| System.FanSpeed
| Current fan speed
|
|-
| System.BuildVersion
| Version of build
|
|-
| System.BuildDate
| Date of build
|
|-
| System.FriendlyName
| Returns the Kodi instance name. It will auto append (%hostname%) in case the device name was not changed. eg. "Kodi (htpc)"
|
|-
| System.FPS
| Current rendering speed (frames per second)
|
|-
| System.FreeMemory
| Amount of free memory in Mb
|
|-
| System.Memory(format)
| Available formats: used, used.percent, free, free.percent, total
|
|-
| System.ScreenMode
| Screenmode (eg windowed / fullscreen)
|
|-
| System.ScreenWidth
| Width of screen in pixels
|
|-
| System.ScreenHeight
| Height of screen in pixels
|
|-
| System.StartupWindow
| The Window Kodi will load on startup
|
|-
| System.CurrentWindow
| Current Window we are in
|
|-
| System.CurrentControl
| Current focused control
|
|-
| System.CurrentControlID
| ID of the currently focused control.
|
|-
| System.DVDLabel
| Label of the disk in the <span class="nobr">DVD-ROM</span> drive
|
|-
| System.HddTemperature
| Hdd temperature
|
|-
| System.OSVersionInfo
| System name + kernel version
|
|-
| System.KernelVersion (deprecated)
| System name + kernel version
|
|-
| System.Uptime
| System current uptime
|
|-
| System.TotalUptime
| System total uptime
|
|-
| System.CpuFrequency
| System cpu frequency
|
|-
| System.ScreenResolution
| Screen resolution
|
|-
| System.VideoEncoderInfo
| Video encoder info
|
|-
| System.InternetState
| Will return the internet state, connected or not connected
and for Conditional use: Connected->TRUE, not Connected->FALSE, do not use to check status in a pythonscript since it is threaded.
|
|-
| System.Language
| Shows the current language
|
|-
| System.ProfileName
| Shows the User name of the currently logged in Kodi user
|
|-
| System.ProfileCount
| Shows the number of defined profiles
|
|-
| System.ProfileAutoLogin
| The profile Kodi will auto login to
|
|-
| System.Progressbar
| The percentage of the currently active progress.
|
|-
| System.StereoscopicMode
| The prefered stereoscopic mode (settings > video > playback)
|
|-
| System.TemperatureUnits
| Shows Celsius or Fahrenheit symbol
|
|-
| System.AddonTitle(id)
| Returns the title of the addon with the given id
|
|-
| System.AddonVersion(id)
| Returns the version of the addon with the given id
|
|-
| System.BuildVersionCode
| The internal version of the kodi build
| v19
|-
| System.BuildVersionGit
| The git version (sha) of the kodi build
| v19
|-
| System.AddonUpdateCount
| The number of available addon updates
| v19
|}

=== Visualisation ===

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| Visualisation.Preset
| Shows the current preset of the visualisation.
|
|-
| Visualisation.Name
| Shows the name of the visualisation.
|
|}

=== Weather labels ===

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| Weather.Conditions
| Current weather conditions – this is looked up in a background process.
|
|-
| Weather.Temperature
| Current weather temperature
|
|-
| Weather.Location
| City/town which the above two items are for
|
|-
| Weather.fanartcode
| Current weather fanartcode.
|
|-
| Weather.plugin
| Current weather plugin.
|
|}

=== Window ===

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| Window([window]).Property(key)
| Window property. (key can be any value, optional window can be id or name)
|
|-
| Window.Property(xmlfile)
| Displays the name of the xml file currently shown
|
|-
| Window.Property(IsRadio)
| Returns "true" if the window is a radio window, empty string otherwise (for use in the PVR windows)
|
|-
| Window(AddonBrowser).Property(Updated)
| Shows the date and time the addon repo was last checked for updates
|
|-
| Window.Property(Addon.ID)
| Returns the id of the selected addon, in DialogAddonSettings.xml
|
|-
| Window(Home).Property(key)
| The home window has the following info labels.
Movies.Count, Movies.Watched, Movies.UnWatched, TVShows.Count, TVShows.Watched, TVShows.UnWatched, Episodes.Count, Episodes.Watched, Episodes.UnWatched, MusicVideos.Count, MusicVideos.Watched, MusicVideos.UnWatched, Music.SongsCount, Music.AlbumsCount, Music.ArtistsCount

LatestMovie.[1-10].Title, LatestMovie.[1-10].Year, LatestMovie.[1-10].RunningTime, LatestMovie.[1-10].Rating, LatestMovie.[1-10].Plot, LatestMovie.[1-10].Trailer, LatestMovie.[1-10].Thumb, LatestMovie.[1-10].Fanart, LatestMovie.[1-10].Path

LatestEpisode.[1-10].ShowTitle, LatestEpisode.[1-10].EpisodeTitle, LatestEpisode.[1-10].EpisodeNo, LatestEpisode.[1-10].EpisodeSeason, LatestEpisode.[1-10].EpisodeNumber, LatestEpisode.[1-10].Rating, LatestEpisode.[1-10].Plot, LatestEpisode.[1-10].Thumb, LatestEpisode.[1-10].ShowThumb, LatestEpisode.[1-10].SeasonThumb, LatestEpisode.[1-10].Fanart, LatestEpisode.[1-10].Path

LatestMusicVideo.[1-10].Title, LatestMusicVideo.[1-10].Thumb, LatestMusicVideo.[1-10].Year, LatestMusicVideo.[1-10].Plot, LatestMusicVideo.[1-10].RunningTime, LatestMusicVideo.[1-10].Path, LatestMusicVideo.[1-10].Artist, LatestMusicVideo.[1-10].Fanart

LatestSong.[1-10].Title, LatestSong.[1-10].Artist, LatestSong.[1-10].Album, LatestSong.[1-10].Year, LatestSong.[1-10].Rating, LatestSong.[1-10].Thumb, LatestSong.[1-10].Fanart, LatestSong.[1-10].Path

LatestAlbum.[1-10].Title, LatestAlbum.[1-10].Artist, LatestAlbum.[1-10].Year, LatestAlbum.[1-10].Rating, LatestAlbum.[1-10].Thumb, LatestAlbum.[1-10].Fanart, LatestAlbum.[1-10].Path
|
|-
| Window(Weather).Property(key)
| The weather window has the following info labels.
Location, Updated, Current.Condition, Current.Temperature, Current.FeelsLike, Current.UVIndex, Current.Wind (From <wind dir.> at <speed> <unit>), Current.WindSpeed, Current.WindDirection, Current.DewPoint, Current.Humidity, Day[0-6].Title, Day[0-6].HighTemp, Day[0-6].LowTemp, Day[0-6].Outlook, WeatherProvider

Data set in Current.Temperature, Current.FeelsLike, Day[0-6].HighTemp, Day[0-6].LowTemp should be provided in Celsius, and will be autoconverted according to System.TemperatureUnits
|
|}

=== Images Available in Kodi ===

See '''[[Artwork/Accessing with skins and JSON-RPC]]''' for the general pattern of accessing artwork for media items. Below is a list of other possible images available as InfoLabels.

{| class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| ListItem.Art(type)
| Artwork for the current listitem.
|
|-
| Fanart.Image
| Fanart image for the parent TV Show. Note: Deprecated, use ListItem.Art(tvshow.fanart) instead.
|
|-
| ListItem.Thumb
| Shows the thumbnail (if it exists) of the currently selected item in a list or thumb control. Note: Deprecated but still available, returns the same as ListItem.Art(thumb).
|
|-
| ListItem.Icon
| Shows the thumbnail (if it exists) of the currently selected item in a list or thumb control. If no thumbnail image exists, it will show the default icon.
|
|-
| ListItem.ActualIcon
| Shows the default icon of the currently selected item in a list or thumb control.
|
|-
| ListItem.Overlay
| Shows the Overlay Icon status (compressed file [OverlayRAR.png], watched [OverlayWatched.png], unwatched [OverlayUnwatched.png], locked [OverlayLocked.png]) of the currently selected item in a list or thumb control.
|
|-
| ListItem.EPGEventIcon
| Returns the icon of the EPG programme (if available).
| v18
|-
| ListItem.Property(Fanart_Image)
| Fanart Image currently selected item or of the parent TV show. Note: Deprecated, use ListItem.Art(fanart) or ListItem.Art(tvshow.fanart) instead.
|
|-
| MusicPlayer.Cover
| Cover of currently playing album
|
|-
| MusicPlayer.Property(Fanart_Image)
| Fanart image of the currently playing artist
|
|-
| Player.Art(type)
| Artwork for the currently playing item.
|
|-
| Player.Icon
| Shows the thumbnail (if it exists) of the currently playing item. If no thumbnail image exists, it will show the icon.
| v18
|-
| Player.StarRating
| Returns a value of 0 to 5 as a graphical display from images named rating0.png to rating5.png of the skin
|
|-
| Pvr.NowRecordingChannelIcon
| Channel icon of the programme currently being recorded.
|
|-
| Pvr.NextRecordingChannelIcon
| Channel icon of the programme that will be recorded next.
|
|-
| Pvr.EPGEventIcon
| Returns the icon of the currently playing EPG programme (if available).
| v18
|-
| Skin.String(name)
| Returns the image or image folder set by the user via a Skin.SetPath(name) or Skin.SetImage(name) '''[[List of Built In Functions]]'''. Allows skinners to have <span class="nobr">user-customisable</span> images and multiimages.
|
|-
| System.AddonIcon(id)
| Returns the Icon of the specified addon. Instead of specifying the id directly, one can also use an infolabel (eg. $INFO[Skin.String(Foo)])
|
|-
| System.ProfileThumb
| Shows the Thumbnail image of the currently logged in Kodi user
|
|-
| VideoPlayer.Cover
| Cover of currently playing movie. Note: Deprecated, use ListItem.Art(poster) instead.
|
|-
| Weather.ConditionsIcon
| Image of current weather conditions (NOTE: Can be used to load/refresh weather conditions)
|
|-
| Window([window]).Property(key)
| Window property. (key can be any value, optional window can be id or name)
|
|-
| Window(Weather).Property(key)
| The weather window has the following info images.
Current.ConditionIcon, Day[0-6].OutlookIcon, Current.FanartCode, Day[0-6].FanartCode, WeatherProviderLogo
|
|}

<section end="main content" />

== See also ==
'''Development:'''
* [[Add-on development]]
* [[Skinning]]

[[Category:Skin development]]
[[Category:Add-on development]]

List of boolean conditions

2021-04-29T20:19:55Z

Ksooo:

{{see also|Conditional Visibility}}
<section begin="main content" />
Skins can use boolean conditions with the <visible> tag or with condition attributes. Scripts can read boolean conditions with <code>xbmc.getCondVisibility(condition)</code>.

=== Container ===
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>Container.HasThumb</code>
| Returns true if the current container you are in has a thumb assigned to it
|
|-
| <code>Container.Content(parameter)</code>
| Returns true if the current container you are in contains the following: '''files, songs, artists, albums, movies, tvshows, seasons, episodes, musicvideos, genres, years, actors, playlists, plugins, studios, directors, sets, tags, countries, roles, images''' (Note: these currently only work in the Video and Music Library or unless a Plugin has set the value) also available are '''Addons''' true when a list of add-ons is shown '''LiveTV''' true when a htsp (tvheadend) directory is shown
|
|-
| <code>Container(id).OnNext</code>
| Returns true if the container with id (or current container if id is omitted) is moving to the next item. Allows views to be custom-designed (such as 3D coverviews etc.)
|
|-
| <code>Container(id).OnScrollNext</code>
| Returns true if the container with id (or current container if id is omitted) is scrolling to the next item. Differs from OnNext in that OnNext triggers on movement even if there is no scroll involved.
|
|-
| <code>Container(id).OnPrevious</code>
| Returns true if the container with id (or current container if id is omitted) is moving to the previous item. Allows views to be custom-designed (such as 3D coverviews etc.)
|
|-
| <code>Container(id).OnScrollPrevious</code>
| Returns true if the container with id (or current container if id is omitted) is scrolling to the previous item. Differs from OnPrevious in that OnPrevious triggers on movement even if there is no scroll involved.
|
|-
| <code>Container(id).HasFocus(item_number)</code>
| Returns true if the container with id (or current container if id is omitted) has static content and is focused on the item with id item_number.
|
|-
| <code>Container.HasFiles</code>
| Returns true if the container contains files.
|
|-
| <code>Container.HasFolders</code>
| Returns true if the container contains folders.
|
|-
| <code>Container(id).HasNext</code>
| Returns true if the container or textbox with id (id) has a next page.
|
|-
| <code>Container(id).HasPrevious</code>
| Returns true if the container or textbox with id (id) has a previous page.
|
|-
| <code>Container(id).IsUpdating</code>
| Returns true if the container with [[Dynamic List Content|dynamic list content]] is currently updating.
|
|-
| <code>Container.IsStacked</code>
| Returns true if the container is currently in stacked mode.
|
|-
| <code>Container.CanFilter</code>
| Returns true when the current container can be filtered.
|
|-
| <code>Container.CanFilterAdvanced</code>
| Returns true when advanced filtering can be applied to the current container.
|
|-
| <code>Container.Filtered</code>
| Returns true when a mediafilter is applied to the current container.
|
|-
| <code>Container(id).HasParent</code>
| Return true when the container with id (or current container if id is omitted) contains a parent ('..') item.
|
|-
| <code>Container.SortDirection(ascending)</code>
| Returns true the sort direction of a container is ascending.
|
|-
| <code>Container.SortDirection(descending)</code>
| Returns true the sort direction of a container is descending.
|
|-
| <code>Container(id).Row(row)</code>
| Returns true if the container with id (or current container if id is omitted) is focused on the row given.
|
|-
| <code>Container(id).Column(col)</code>
| Returns true if the container with id (or current container if id is omitted) is focused on the column given.
|
|-
| <code>Container(id).Position(pos)</code>
| Returns true if the container with id (or current container if id is omitted) is focused on the position given.
|
|-
| <code>Container(id).Scrolling</code>
| Returns true if the user is currently scrolling through the container with id (or current container if id is omitted). Note that this is slightly delayed from the actual scroll start. Use Container(id).OnScrollNext/OnScrollPrevious to trigger animations immediately on scroll.
|
|-
| Container(id).SubItem
| Returns true if the container with id (or current container if id is omitted) is focused on the specified subitem.
|
|-
| Container.Sortmethod(id)
| Returns true if the current sort method matches the specified SortID [[https://kodi.wiki/view/List_of_built-in_functions#List_of_sort_methods see list of sort methods]].
|
|}

=== Control ===
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>Control.IsEnabled(id)</code>
| Returns true if the control with id "id" is enabled.
|
|-
| <code>Control.IsVisible(id)</code>
| Returns true if the control with id "id" is visible.
|
|-
| <code>Control.HasFocus(id)</code>
| Returns true if the currently focused control has id "id".
|
|-
| <code>ControlGroup(group).HasFocus(id)</code>
| Returns true if the control group with id “group” has control id “id” as it's focused item. If “id” is not present, or is 0, then it will return true if the currently focused control is in the control group with id “group”. Note that if the control group with id “group” does not have focus, then this will still return true if the last focused item in the group had control id “id”.
|
|}

=== Integer ===
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>Integer.IsEqual([[InfoLabels|info]],number)</code>
| Returns true if the value of the [[InfoLabels|infolabel]] is equal to the supplied number.<br />Example: Integer.IsEqual(ListItem.Year,2000)
| {{nowrap|v17 Addition}}
|-
| <code>Integer.IsEven([[InfoLabels|info]])</code>
| Returns true if the value of the [[InfoLabels|infolabel]] is even.<br />Example: Integer.IsEven(ListItem.CurrentItem)
| {{nowrap|v19 Addition}}
|-
| <code>Integer.IsGreater([[InfoLabels|info]],number)</code>
| Returns true if the value of the [[InfoLabels|infolabel]] is greater than to the supplied number.<br />Example: Integer.IsGreater(ListItem.Year,2000)
| {{nowrap|v17 Addition}}
|-
| <code>Integer.IsGreaterOrEqual([[InfoLabels|info]],number)</code>
| Returns true if the value of the [[InfoLabels|infolabel]] is greater or equal to the supplied number.<br />Example: Integer.IsGreaterOrEqual(ListItem.Year,2000)
| {{nowrap|v17 Addition}}
|-
| <code>Integer.IsLess([[InfoLabels|info]],number)</code>
| Returns true if the value of the [[InfoLabels|infolabel]] is less than the supplied number.<br />Example: Integer.IsLess(ListItem.Year,2000)
| {{nowrap|v17 Addition}}
|-
| <code>Integer.IsLessOrEqual([[InfoLabels|info]],number)</code>
| Returns true if the value of the [[InfoLabels|infolabel]] is less or equal to the supplied number.<br />Example: Integer.IsLessOrEqual(ListItem.Year,2000)
| {{nowrap|v17 Addition}}
|-
| <code>Integer.IsOdd([[InfoLabels|info]])</code>
| Returns true if the value of the [[InfoLabels|infolabel]] is odd.<br />Example: Integer.IsOdd(ListItem.CurrentItem)
| {{nowrap|v19 Addition}}
|}

=== Library ===
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>Library.HasContent(string)</code>
| Returns true if the Kodi libraries have the content from string. Valid Strings are (Video, Music, Movies, TVShows, MusicVideos, MovieSets, BoxSets)
|
|-
| <code>Library.IsScanningMusic</code>
| Returns true if the music library is being updated
|
|-
| <code>Library.IsScanningVideo</code>
| Returns true if the video library is being updated
|
|-
| <code>Library.HasContent(Role, Composer)</code>
| Tag can be Composer, Conductor, Orchestra, Lyricist, Remixer, Arranger, Engineer, Producer, DJMixer or Mixer. Returns true if there are any artists with that role in the library
| v17 addition
|-
| <code>Library.HasNode(path)</code>
| Returns True if the specified node is available (example: Library.HasNode(library://video/movies/titles.xml))
| v19 addition
|}

=== ListItem ===
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>ListItem.IsFolder</code>
| Returns whether the current ListItem is a folder
|
|-
| <code>ListItem.IsPlaying</code>
| Returns whether the current ListItem.* [[InfoLabels|info labels]] and images are currently Playing media
|
|-
| <code>ListItem.IsResumable</code>
| Returns true when the current ListItem has been partially played
|
|-
| <code>ListItem.IsCollection</code>
| Returns true when the current ListItem is a movie set
|
|-
| <code>ListItem.IsSelected</code>
| Returns whether the current ListItem is selected (f.e. currently playing in playlist window)
|
|-
| <code>ListItem.HasArchive</code>
| returns True when the selected channel has a server-side back buffer (PVR)
| v19 addition
|-
| <code>ListItem.HasEpg</code>
| Returns true when the selected programme has epg info (PVR)
|
|-
| <code>ListItem.HasReminder</code>
| returns True if the item has a reminder set (PVR)
| v19 addition
|-
| <code>ListItem.HasReminderRule</code>
| returns True if the item was scheduled by a reminder timer rule (PVR)
| v19 addition
|-
| <code>ListItem.HasTimer</code>
| Returns true when a recording timer has been set for the selected programme (PVR)
|
|-
| <code>ListItem.IsRecording</code>
| Returns true when the selected programme is being recorded (PVR)
|
|-
| <code>ListItem.IsEncrypted</code>
| Returns true when the selected programme is encrypted (PVR)
|
|-
| <code>ListItem.IsStereoscopic</code>
| Returns true when the selected video is a 3D (stereoscopic) video
|
|-
| <code>ListItem.Property(IsSpecial)</code>
| Returns whether the current Season/Episode is a Special
|
|-
| <code>ListItem.Property(DateLabel)</code>
| Can be used in the rulerlayout of the epggrid control. Will return true if the item is a date label, returns false if the item is a time label.
|
|-
| <code>ListItem.Property(Addon.IsEnabled)</code>
| Returns true when the selected addon is enabled (for use in the addon info dialog only).
|
|-
| <code>ListItem.Property(Addon.IsInstalled)</code>
| Returns true when the selected addon is installed (for use in the addon info dialog only).
|
|-
| <code>ListItem.Property(Addon.HasUpdate)</code>
| Returns true when there's an update available for the selected addon.
|
|-
| <code>ListItem.HasTimerSchedule</code>
| Whether the item is part of a repeating timer schedule (PVR).
| v16 addition
|-
| <code>ListItem.TimerHasError</code>
| Whether the item has a timer and it won't be recorded because of an error (PVR).
| v17 addition
|-
| <code>ListItem.TimerHasConflict</code>
| Whether the item has a timer and it won't be recorded because of a conflict (PVR).
| v17 addition
|-
| <code>ListItem.TimerIsActive</code>
| Whether the item has a timer that will be recorded, i.e. the timer is enabled (PVR).
| v17 addition
|-
| <code>ListItem.Property(Addon.Orphaned)</code>
| Returns true if the slected addon is orphaned (not needed anymore by any other addon)
| v17 addition
|-
| <code>ListItem.IsParentFolder</code>
| Returns true is the slected item is the 'up' item
| v17 addition
|-
| <code>ListItem.IsNew</code>
| [PVR] will return true if the item is a premiere (for example, a Live TV show that will be first aired).
| v19 addition
|-
| <code>ListItem.IsPlayable</code>
| Returns True when the selected programme can be played (PVR)
| v19 addition
|-
| <code>ListItem.IsBoxset</code>
| Returns True if the item is part of a boxset album
| v19 addition
|-
| <code>ListItem.IsPremiere</code>
| Returns true if the item is a premiere (for example, a Movie first showing or season first on Live TV)
| v19 addition
|-
| <code>ListItem.IsFinale</code>
| Returns true if the item is a finale (for example, a season finale showing on Live TV)
| v19 addition
|-
| <code>ListItem.IsLive</code>
| Returns true if the item is live (for example, a Live TV sports event)
| v19 addition
|-
| <code>ListItem.Property(Addon.IsFromOfficialRepo)</code>
| Returns true if the addon is from an official repository
| v19 addition
|-
| <code>ListItem.Property(Addon.IsBinary)</code>
| Returns true for binary addons
| v19 addition
|-
| <code>ListItem.Property(Addon.IsUpdate)</code>
| Returns True if this add-on is a valid update of an installed outdated add-on
| v19 addition
|-
| <code>ListItem.IsAutoUpdateable</code>
| Returns True if this add-on can be updated automatically
| v19 addition
|}

=== Player ===
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>Player.HasMedia</code>
| Returns true if the player has an audio or video file.
|
|-
| <code>Player.HasAudio</code>
| Returns true if the player has an audio file.
|
|-
| <code>Player.HasDuration</code>
| Returns true if Media isn't a true stream
|
|-
| <code>Player.HasVideo</code>
| Returns true if the player has a video file.
|
|-
| <code>Player.Passthrough</code>
| Returns true if the player is using audio passthrough.
|
|-
| <code>Player.Playing</code>
| Returns true if the player is currently playing (ie not ffwding, rewinding or paused.)
|
|-
| <code>Player.Paused</code>
| Returns true if the player is paused.
|
|-
| <code>Player.Forwarding</code>
| Returns true if the player is fast forwarding.
|
|-
| <code>Player.Forwarding2x</code>
| Returns true if the player is fast forwarding at 2x.
|
|-
| <code>Player.Forwarding4x</code>
| Returns true if the player is fast forwarding at 4x.
|
|-
| <code>Player.Forwarding8x</code>
| Returns true if the player is fast forwarding at 8x.
|
|-
| <code>Player.Forwarding16x</code>
| Returns true if the player is fast forwarding at 16x.
|
|-
| <code>Player.Forwarding32x</code>
| Returns true if the player is fast forwarding at 32x.
|
|-
| <code>Player.Rewinding</code>
| Returns true if the player is rewinding.
|
|-
| <code>Player.Rewinding2x</code>
| Returns true if the player is rewinding at 2x.
|
|-
| <code>Player.Rewinding4x</code>
| Returns true if the player is rewinding at 4x.
|
|-
| <code>Player.Rewinding8x</code>
| Returns true if the player is rewinding at 8x.
|
|-
| <code>Player.Rewinding16x</code>
| Returns true if the player is rewinding at 16x.
|
|-
| <code>Player.Rewinding32x</code>
| Returns true if the player is rewinding at 32x.
|
|-
| <code>Player.PauseEnabled</code>
| Returns true if the currently playing stream can be paused.
|
|-
| <code>Player.Caching</code>
| Returns true if the player is current <span class="nobr">re-caching</span> data (internet based video playback).
|
|-
| <code>Player.DisplayAfterSeek</code>
| Returns true for the first 2.5 seconds after a seek.
|
|-
| <code>Player.Seeking</code>
| Returns true if a seek is in progress
|
|-
| <code>Player.SeekEnabled</code>
| Returns true if player can seek
|
|-
| <code>Player.ShowTime</code>
| Returns true if the user has requested the time to show (occurs in video fullscreen)
|
|-
| <code>Player.ShowInfo</code>
| Returns true if the user has requested the song info to show (occurs in visualisation fullscreen and slideshow)
|
|-
| <code>Player.IsInternetStream</code>
| Returns true if the player is playing an internet stream.
|
|-
| <code>Player.Muted</code>
| Returns true if the volume is muted.
|
|-
| <code>Player.Process(videohwdecoder)</code>
| Returns true if the currently playing video is decoded in hardware
| v17 addition
|-
| <code>Player.TempoEnabled</code>
| Returns true if the current player supports changing the playback speed
| v17 addition
|-
| <code>Player.IsTempo</code>
| Returns true if the current playbackspeed is not equal to 1
| v17 addition
|-
| <code>Player.HasGame</code>
| Returns true if the player is playing a game
| v18
|-
| <code>Player.HasResolutions</code>
| Returns true when multiple resolutions are available
| v18
|-
| <code>Player.FrameAdvance</code>
| Returns true if player is in frame advance mode
| v18
|-
| <code>Player.ChannelPreviewActive</code>
| Returns true if PVR channel preview is active (used channel tag different from played tag)
|
|}

==== MusicPlayer ====
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>MusicPlayer.HasNext</code>
| Returns true if the music player has a next song queued in the Playlist.
|
|-
| <code>MusicPlayer.HasPrevious</code>
| Returns true if the music player has a a Previous Song in the Playlist .
|
|-
| <code>MusicPlayer.Offset(number).Exists</code>
| Returns true if the music players playlist has a song queued in position (number).
|
|-
| <code>MusicPlayer.Content(parameter)</code>
| Returns true if the current audio you are playing matches the specified content. The following values are accepted: files, livetv
|
|-
| <code>MusicPartyMode.Enabled</code>
| Returns true if Party Mode is enabled
|
|-
|<code>MusicPlayer.IsMultiDisc</code>
| Returns true if the current album consists of two or more discs
| v19 addition
|}

==== VideoPlayer ====
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>VideoPlayer.UsingOverlays</code>
| Returns true if the video player is using the hardware overlays render method. Useful, as with hardware overlays you have no alpha blending to the video image, so shadows etc. need redoing, or disabling.
|
|-
| <code>VideoPlayer.IsFullscreen</code>
| Returns true if the video player is in fullscreen mode.
|
|-
| <code>VideoPlayer.HasMenu</code>
| Returns true if the video player has a menu (ie is playing a DVD)
|
|-
| <code>VideoPlayer.HasInfo</code>
| Returns true if the current playing video has information from the library or from a plugin (eg director/plot etc.)
|
|-
| <code>VideoPlayer.Content(parameter)</code>
| Returns true if the current Video you are playing is contained in corresponding Video Library sections. The following values are accepted : files, movies, episodes, musicvideos, livetv
|
|-
| <code>VideoPlayer.HasSubtitles</code>
| Returns true if there are subtitles available for video. (available for version 11.0 and above)
|
|-
| <code>VideoPlayer.IsStereoscopic</code>
| Returns true when the currently playing video is a 3D (stereoscopic) video
|
|-
| <code>VideoPlayer.SubtitlesEnabled</code>
| Returns true if subtitles are turned on for video. (available for version 11.0 and above)
|
|-
| <code>VideoPlayer.HasEpg</code>
| Returns true when epg information is available for the currently playing programme (PVR).
|
|-
| <code>VideoPlayer.HasTeletext</code>
| Returns true when teletext is available.
|
|}

=== PlayList ===
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>Playlist.IsRandom</code>
| Returns true if the player is in random mode.
|
|-
| <code>Playlist.IsRepeat</code>
| Returns true if the player is in repeat all mode.
|
|-
| <code>Playlist.IsRepeatOne</code>
| Returns true if the player is in repeat one mode.
|
|}

=== PVR ===
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>Pvr.HasTimer</code>
| Returns true when a recording timer is active.
|
|-
| <code>Pvr.HasNonRecordingTimer</code>
| Returns true when a non recording timer is active.
|
|-
| <code>Pvr.HasTVChannels</code>
| Returns true if there are tv channels available
|
|-
| <code>Pvr.HasRadioChannels</code>
| Returns true if there are radio channels available
|
|-
| <code>Pvr.IsPlayingTv</code>
| Returns true when live tv is being watched.
|
|-
| <code>Pvr.IsPlayingRadio</code>
| Returns true when live radio is being listened to.
|
|-
| <code>Pvr.IsPlayingRecording</code>
| Returns true when a recording is being watched.
|
|-
| <code>Pvr.IsRecording</code>
| Returns true when the system is recording a tv programme.
|
|-
| <code>Pvr.IsTimeShift</code>
| Returns true when the playback is timeshifted.
|
|-
| <code>Pvr.ActStreamIsEncrypted</code>
| Returns true if the stream is encrypted
|
|-
| <code>Pvr.RadioNextRecordingChannelIcon</code>
| Icon of the next recording radio channel
| {{nowrap|v17 Addition}}
|-
| <code>Pvr.IsRecordingTV</code>
| Returns true when the system is recording a tv programme.
| {{nowrap|v17 Addition}}
|-
| <code>Pvr.HasTVTimer</code>
| Returns true if at least one tv timer is active.
| {{nowrap|v17 Addition}}
|-
| <code>Pvr.HasNonRecordingTVTimer</code>
| Returns true if there are tv timers present who currently not do recording
| {{nowrap|v17 Addition}}
|-
| <code>Pvr.IsRecordingRadio</code>
| Returns true when the system is recording a radio programme.
| {{nowrap|v17 Addition}}
|-
| <code>Pvr.HasRadioTimer</code>
| Returns true if at least one radio timer is active.
| {{nowrap|v17 Addition}}
|-
| <code>Pvr.HasNonRecordingRadioTimer</code>
| Returns true if there are radio timers present who currently not do recording
| {{nowrap|v17 Addition}}
|
|-
| <code>Pvr.CanRecordPlayingChannel</code>
| Returns true if the player can record the current internet stream.
| {{nowrap|v18 Addition}}
|-
| <code>Pvr.IsRecordingPlayingChannel</code>
| Returns true if the player is recording the current internet stream.
| {{nowrap|v18 Addition}}
|-
| <code>Pvr.IsPlayingActiveRecording</code>
| Returns true when Kodi is currently playing a recording that is in progress.
| {{nowrap|v19 Addition}}
|}

=== RDS ===
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>RDS.HasRds</code>
| Returns true if RDS is present
|
|-
| <code>RDS.HasRadioText</code>
| Returns true if RDS contains also Radiotext
|
|-
| <code>RDS.HasRadioTextPlus</code>
| Returns true if RDS with Radiotext contains also the plus information
|
|-
| <code>RDS.HasHotline</code>
| Returns true if a hotline phone number is present (Only be available on RadiotextPlus)
|
|-
| <code>RDS.HasStudio</code>
| Returns true if a studio name is present (Only be available on RadiotextPlus)
|
|}

=== Skin ===
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>Skin.HasTheme(theme)</code>
| Returns true if the user has selected the theme with name ?theme?.
|
|-
| <code>Skin.HasSetting(setting)</code>
| Returns the state of the <span class="nobr">skin-specified</span> setting ?setting?. You can toggle a setting from a button by using <onclick>Skin.ToggleSetting(setting)</onclick>.
|
|-
| <code>Skin.String(string)</code>
| Returns whether the skin string (set via Skin.SetString, Skin.SetPath, or Skin.SetImage) is <span class="nobr">non-empty</span>.
|
|-
| <code>Skin.String(string1,string2)</code>
| Same as String.IsEqual(Skin.String(string1),string2). Returns true if Skin.String(string1) equals string2.
|
|}

=== SlideShow ===
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>Slideshow.IsActive</code>
| Returns true if the picture slideshow is running
|
|-
| <code>Slideshow.IsPaused</code>
| Returns true if the picture slideshow is paused
|
|-
| <code>Slideshow.IsRandom</code>
| Returns true if the picture slideshow is in random mode
|
|-
| <code>Slideshow.IsVideo</code>
| Returns true if the picture slideshow is playing a video
|
|}

=== String ===
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>String.IsEmpty([[InfoLabels|info]])</code>
| Returns true if the [[InfoLabels|info]] is empty.<br />Example of info: ListItem.Title, ListItem.Genre. Please note that string can also be a $LOCALIZE[]. Also note that in a panelview or similar this only works on the focused item.
| {{nowrap|v17 Addition}}
|-
| <code>String.IsEqual([[InfoLabels|info]],string)</code>
| Returns true if the [[InfoLabels|info]] is equal to the given string.<br />Example of info: ListItem.Title, ListItem.Genre. Please note that string can also be a $LOCALIZE[] or [[InfoLabels|info label]] (without $INFO prefix). Also note that in a panelview or similar this only works on the focused item.
| {{nowrap|v17 Addition}}
|-
| <code>String.StartsWith([[InfoLabels|info]],substring)</code>
| Returns true if the [[InfoLabels|info]] starts with the given substring.<br />Example of info: ListItem.Title, ListItem.Genre. Please note that string can also be a $LOCALIZE[] or [[InfoLabels|info label]] (without $INFO prefix). Also note that in a panelview or similar this only works on the focused item.
| {{nowrap|v17 Addition}}
|-
| <code>String.EndsWith([[InfoLabels|info]],substring)</code>
| Returns true if the [[InfoLabels|info]] ends with the given substring.<br />Example of info: ListItem.Title, ListItem.Genre. Please note that string can also be a $LOCALIZE[] or [[InfoLabels|info label]] (without $INFO prefix). Also note that in a panelview or similar this only works on the focused item.
| {{nowrap|v17 Addition}}
|-
| <code>String.Contains([[InfoLabels|info]],substring)</code>
| Returns true if the [[InfoLabels|info]] contains the given substring.<br />Example of info: ListItem.Title, ListItem.Genre. Please note that string can also be a $LOCALIZE[] or [[InfoLabels|info label]] (without $INFO prefix). Also note that in a panelview or similar this only works on the focused item.
| {{nowrap|v17 Addition}}
|}

=== System ===
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>System.AddonIsEnabled(id)</code>
| Returns true if the specified addon is enabled on the system
| v19 addition
|-
| <code>System.HasAddon(id)</code>
| Returns true if the specified addon is installed on the system.
|
|-
| <code>System.HasPVRAddon</code>
| Returns true if at least one PVR addon is installed on the system.
|
|-
| <code>System.HasAlarm(alarm)</code>
| Returns true if the system has the ?alarm? alarm set.
|
|-
| <code>System.AlarmLessOrEqual(alarmname,seconds)</code>
| Returns true if the alarm with ?alarmname? has less or equal to ?seconds? left. Standard use would be system.alarmlessorequal(shutdowntimer,119), which would return true when the shutdowntimer has less then 2 minutes left.
|
|-
| <code>System.HasNetwork</code>
| Returns true if the ethernet cable is plugged in.
|
|-
| <code>System.HasMediadvd</code>
| Returns true if there is a CD or DVD in the <span class="nobr">DVD-ROM</span> drive.
|
|-
| <code>System.HasMediaAudioCD</code>
| Returns true if there is an audio CD in the optical drive. False if no drive available, empty drive or other medium.
| v18 Addition
|-
| <code>System.IdleTime(time)</code>
| Returns true if Kodi has had no input for ?time? amount of seconds.
|
|-
| <code>System.IsStandalone</code>
| Returns true if Kodi is running in standalone mode.
|
|-
| <code>System.IsFullscreen</code>
| Returns true if Kodi is running fullscreen.
|
|-
| <code>System.IsLoggedOn</code>
| Returns true if a user is currently logged on under a [[Profiles|profile]]
|
|-
| <code>System.HasLoginScreen</code>
| Returns true if the [[Profiles|profile]] login screen is enabled
|
|-
| <code>System.HasActiveModalDialog</code>
| Returns true true when a modal dialog is active, disregarding any animations (Leia (v18) and newer versions)
| v18
|-
| <code>System.HasVisibleModalDialog</code>
| Returns true if a modal dialog is visible, eg when the animations are finished (Leia (v18) and newer versions)
| v18
|-
| <code>System.Time(startTime,endTime)</code>
| Returns true if the current system time is >= startTime and < endTime. endTime is optional. Time must be specified in the format HH:mm, using a 24 hour clock.
|
|-
| <code>System.Date(startDate,endDate)</code>
| Returns true if the current system date is >= startDate and < endDate. endDate is optional. Date must be specified in the format MM-DD.
|
|-
| <code>System.Platform.Linux</code>
| Returns true if Kodi is running on a linux/unix based computer.
|
|-
| <code>System.Platform.Windows</code>
| Returns true if Kodi is running on a windows based computer.
|
|-
| <code>System.Platform.OSX</code>
| Returns true if Kodi is running on an OSX based computer.
|
|-
| <code>System.Platform.IOS</code>
| Returns true if Kodi is running on an IOS device.
|
|-
| <code>System.Platform.Darwin</code>
| Returns true if Kodi is running on an OSX or IOS system.
|
|-
| <code>System.Platform.Android</code>
| Returns true if Kodi is running on an android device.
|
|-
| <code>System.Platform.UWP</code>
| Returns true if Kodi is running on Universal Windows Platform (UWP).
| {{nowrap|v18 Addition}}
|-
| <code>System.CanPowerDown</code>
| Returns true if Kodi can powerdown the system.
|
|-
| <code>System.CanSuspend</code>
| Returns true if Kodi can suspend the system.
|
|-
| <code>System.CanHibernate</code>
| Returns true if Kodi can hibernate the system.
|
|-
| <code>System.HasHiddenInput</code>
| Return true when to osd keyboard/numeric dialog requests a password/pincode.
|
|-
| <code>System.CanReboot</code>
| Returns true if Kodi can reboot the system.
|
|-
| <code>System.ScreenSaverActive</code>
| Returns true if ScreenSaver is active.
|
|-
| <code>System.Setting(hidewatched)</code>
| Returns true if 'hide watched items' is selected.
|
|-
| <code>System.IsInhibit</code>
| Returns true when shutdown on idle is disabled.
|
|-
| <code>System.HasShutdown</code>
| Returns true when shutdown on idle is enabled.
|
|-
| <code>System.HasCMS</code>
| Returns true if colour management is supported in Kodi.
| {{nowrap|v17 Addition}}
|-
| <code>System.GetBool(boolean)</code>
| Returns the value of any standard system boolean setting. Will not work with settings in advancedsettings.xml
|
|-
| <code>System.HasLocks</code>
| Returns true if the profile has lock preferences configured
|
|-
| <code>System.IsMaster</code>
| Returns true if the profile has entered the master mode
|
|-
| <code>System.SupportsCPUUsage</code>
| Return True if the system provides CPU info
| {{nowrap|v19 Addition}}
|}

=== Visualisation ===
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>Visualisation.Enabled</code>
| Returns true if any visualisation has been set in settings (so not None).
|
|-
| <code>Visualisation.HasPresets</code>
| Returns true if the visualisation has built in presets.
|
|-
| <code>Visualisation.Locked</code>
| Returns true if the current visualisation preset is locked (eg in Milkdrop.)
|
|}

=== Weather ===
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>Weather.IsFetched</code>
| Returns true if the weather data has been downloaded.
|
|}

=== Window ===
{| class="prettytable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
| <code>Window.IsVisible(window)</code>
| Returns true if the window is visible (includes fade out time on dialogs)
|
|-
| <code>Window.IsActive(window)</code>
| Returns true if the window with id or title ?window? is active (excludes fade out time on dialogs) [[Window IDs|See here for a list of windows]]
|
|-
| <code>Window.IsTopMost(window)</code>
| Returns true if the window with id or title ?window? is on top of the window stack (excludes fade out time on dialogs) [[Window IDs|See here for a list of windows]]
|
|-
| <code>Window.IsMedia</code>
| Returns true if this window is a media window (programs, music, video, scripts, pictures)
|
|-
| <code>Window.Next(window)</code>
| Returns true if the window with id or title ?window? is being moved to. [[Window IDs|See here for a list of windows]]. Only valid while windows are changing.
|
|-
| <code>Window.Previous(window)</code>
| Returns true if the window with id or title ?window? is being moved from. [[Window IDs|See here for a list of windows]]. Only valid while windows are changing.
|
|-
| <code>Window.Is(name)</code>
| Useful in xml files that are shared between multiple windows/dialogs. Will return true if the window with the given name is visible
| v17 addition
|}
<section end="main content" />

== See also ==
'''Development:'''
* [[Add-on development]]
* [[Skinning]]

[[Category:Skin development]]
[[Category:Add-on development]]

Kodi v19 (Matrix) changelog

2019-11-04T10:55:23Z

Ksooo: /* Live TV and PVR (Personal Video Recorder) */

{{mininav|[[Releases]] {{l2| [[Matrix]] }} }}

{{future|19}}

{{see also|Kodi v19 (Matrix) FAQ|Matrix API changes|Releases}}

This is the Kodi Wiki version of a condensed changelog for the future Kodi v19 version (codename: "Matrix") releases with a summary of the most important core features and functions as well as other notable changes to key areas of the application software or its user interface. Please note that this condensed changelog version is not meant bug-fixes, nor minor refactoring or cosmetic changes.

= Changelog =
Changes that affect all platforms

== Add-ons Framework, API, and Manager ==

== AudioEngine ==

== Gaming (Games interface and Game Clients)==

== General Library ==

== GUI Engine (Skinning Engine) ==

== Input System (Input Manager and Input APIs) ==

== Live TV and PVR (Personal Video Recorder) ==
* Added PVR Reminders <ref>https://github.com/xbmc/xbmc/pull/15467</ref><ref>https://github.com/xbmc/xbmc/pull/16227</ref><ref>https://github.com/xbmc/xbmc/pull/16393</ref>
* Added EDL and chapter marker visualisation for recordings (and videos in general) <ref>https://github.com/xbmc/xbmc/pull/15767</ref>
* Reworked EPG database storage setting semantics (default to 'do not store') <ref>https://github.com/xbmc/xbmc/pull/16005</ref>
* Added TV and radio channel groups home screen widgets <ref>https://github.com/xbmc/xbmc/pull/16351</ref>
* Added thumbnail picture generation for channel groups <ref>https://github.com/xbmc/xbmc/pull/16360</ref>
* Group manager: Automatically fill channel lists upon group selection <ref>https://github.com/xbmc/xbmc/pull/16361</ref>
* Added ability to sort channels and EPG by the backend order of channels <ref>https://github.com/xbmc/xbmc/pull/16558</ref>
* Added support for group specific channel numbering and option to start group number locally from 1 <ref>https://github.com/xbmc/xbmc/pull/16593</ref>
* Reworked Guide window's navigation controls <ref>https://github.com/xbmc/xbmc/pull/16638</ref>
* Added support for 'first aired' and 'rating' to PVR info dialog <ref>https://github.com/xbmc/xbmc/pull/16640</ref>
* Added 'new' indicators to Gudie window and PVR info dialog <ref>https://github.com/xbmc/xbmc/pull/16645</ref>
* Added support for 'year' to Guide, Timers and Recordings windows and dialogs <ref>https://github.com/xbmc/xbmc/pull/16728</ref>

* PVR-Addon API changes <ref>https://github.com/xbmc/xbmc/pull/15953</ref><ref>https://github.com/xbmc/xbmc/pull/16541</ref><ref>https://github.com/xbmc/xbmc/pull/16558</ref>

* Added, updated, and improved PVR backend clients addons for popular third-party external [[PVR backend]] platforms:
** New: [[Add-on:waipu.tv PVR Client|waipu.tv PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** New: [[Add-on:Freebox PVR Client|Freebox PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Zattoo PVR Client|Zattoo PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Teleboy PVR Client|Teleboy PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Sledovanitv.cz PVR Client|Sledovanitv.cz PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR Demo Client|PVR Demo Client]] dummy addon with fake (method stub) [[PVR backend]] for [[PVR]] skinning and regression testing
** [[Add-on:IPTV Simple Client|IPTV Simple Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:HDHomeRun PVR|HDHomeRun]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Digital Devices Octopus NET Client|Digital Devices Octopus NET Client]] PVR Addon backend client maintained and made available by [http://digitaldevices.de/home/ Digital Devices]
** [[Add-on:VU+ / Enigma2 Client|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Njoy N7 PVR Client|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VDR VNSI Client|VDR VNSI Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MythTV PVR Client|MythTV PVR Client]] Addon backend client maintained and available from the Kodi's community
** [[Add-on:NextPVR PVR Client|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Argus TV Client|Argus TV (former ForTheRecord)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBLink PVR Client|DVBLink PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBViewer Client|DVBViewer Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MediaPortal PVR Client|MediaPortal PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community

== Music Library ==

== Platform Independent Playback ==

== Web Scrapers ==

== Other ==

= Platform Specific =

== Android Specific ==

== BSD Specific ==

== iOS Specific ==

== Linux Specific ==

== OS X Specific ==

== Windows Specific ==

= References =
<references/>

= See also =
* [[Leia API changes]]
{{Changelogs}}

[[Category:Manual]]
[[Category:Leia|*]]
[[Category:Changelogs|18]]

Kodi v19 (Matrix) changelog

2019-11-03T20:38:04Z

Ksooo: /* Live TV and PVR (Personal Video Recorder) */

{{mininav|[[Releases]] {{l2| [[Matrix]] }} }}

{{future|19}}

{{see also|Kodi v19 (Matrix) FAQ|Matrix API changes|Releases}}

This is the Kodi Wiki version of a condensed changelog for the future Kodi v19 version (codename: "Matrix") releases with a summary of the most important core features and functions as well as other notable changes to key areas of the application software or its user interface. Please note that this condensed changelog version is not meant bug-fixes, nor minor refactoring or cosmetic changes.

= Changelog =
Changes that affect all platforms

== Add-ons Framework, API, and Manager ==

== AudioEngine ==

== Gaming (Games interface and Game Clients)==

== General Library ==

== GUI Engine (Skinning Engine) ==

== Input System (Input Manager and Input APIs) ==

== Live TV and PVR (Personal Video Recorder) ==
* Added PVR Reminders <ref>https://github.com/xbmc/xbmc/pull/15467</ref><ref>https://github.com/xbmc/xbmc/pull/16227</ref><ref>https://github.com/xbmc/xbmc/pull/16393</ref>
* Added EDL and chapter marker visualisation for recordings (and videos in general) <ref>https://github.com/xbmc/xbmc/pull/15767</ref>
* Reworked EPG database storage setting semantics (default to 'do not store') <ref>https://github.com/xbmc/xbmc/pull/16005</ref>
* Added TV and radio channel groups home screen widgets <ref>https://github.com/xbmc/xbmc/pull/16351</ref>
* Added thumbnail picture generation for channel groups <ref>https://github.com/xbmc/xbmc/pull/16360</ref>
* Group manager: Automatically fill channel lists upon group selection <ref>https://github.com/xbmc/xbmc/pull/16361</ref>
* Added ability to sort channels and EPG by the backend order of channels <ref>https://github.com/xbmc/xbmc/pull/16558</ref>
* Added support for group specific channel numbering and option to start group number locally from 1 <ref>https://github.com/xbmc/xbmc/pull/16593</ref>
* Reworked Guide window's navigation controls <ref>https://github.com/xbmc/xbmc/pull/16638</ref>
* Added support for 'first aired' and 'rating' to PVR info dialog <ref>https://github.com/xbmc/xbmc/pull/16640</ref>
* Added 'new' indicators to Gudie window and PVR info dialog <ref>https://github.com/xbmc/xbmc/pull/16645</ref>
* Added support for 'year' to Guide, Timers and Recordings windows and dialogs <ref>https://github.com/xbmc/xbmc/pull/16728</ref>

* PVR-Addon API changes <ref>https://github.com/xbmc/xbmc/pull/15953</ref><ref>https://github.com/xbmc/xbmc/pull/16541</ref><ref>https://github.com/xbmc/xbmc/pull/16558</ref>

* Added, updated, and improved PVR backend clients addons for popular third-party external [[PVR backend]] platforms:
** New: [[Add-on:Waipu TV PVR Client|Waipu TV PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** New: [[Add-on:Freebox PVR Client|Freebox PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Zattoo PVR Client|Zattoo PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Teleboy PVR Client|Teleboy PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Sledovanitv.cz PVR Client|Sledovanitv.cz PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR Demo Client|PVR Demo Client]] dummy addon with fake (method stub) [[PVR backend]] for [[PVR]] skinning and regression testing
** [[Add-on:IPTV Simple Client|IPTV Simple Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:HDHomeRun PVR|HDHomeRun]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Digital Devices Octopus NET Client|Digital Devices Octopus NET Client]] PVR Addon backend client maintained and made available by [http://digitaldevices.de/home/ Digital Devices]
** [[Add-on:VU+ / Enigma2 Client|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Njoy N7 PVR Client|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VDR VNSI Client|VDR VNSI Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MythTV PVR Client|MythTV PVR Client]] Addon backend client maintained and available from the Kodi's community
** [[Add-on:NextPVR PVR Client|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Argus TV Client|Argus TV (former ForTheRecord)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBLink PVR Client|DVBLink PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBViewer Client|DVBViewer Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MediaPortal PVR Client|MediaPortal PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community

== Music Library ==

== Platform Independent Playback ==

== Web Scrapers ==

== Other ==

= Platform Specific =

== Android Specific ==

== BSD Specific ==

== iOS Specific ==

== Linux Specific ==

== OS X Specific ==

== Windows Specific ==

= References =
<references/>

= See also =
* [[Leia API changes]]
{{Changelogs}}

[[Category:Manual]]
[[Category:Leia|*]]
[[Category:Changelogs|18]]

Kodi v19 (Matrix) changelog

2019-11-03T20:37:27Z

Ksooo: /* Live TV and PVR (Personal Video Recorder) */

{{mininav|[[Releases]] {{l2| [[Matrix]] }} }}

{{future|19}}

{{see also|Kodi v19 (Matrix) FAQ|Matrix API changes|Releases}}

This is the Kodi Wiki version of a condensed changelog for the future Kodi v19 version (codename: "Matrix") releases with a summary of the most important core features and functions as well as other notable changes to key areas of the application software or its user interface. Please note that this condensed changelog version is not meant bug-fixes, nor minor refactoring or cosmetic changes.

= Changelog =
Changes that affect all platforms

== Add-ons Framework, API, and Manager ==

== AudioEngine ==

== Gaming (Games interface and Game Clients)==

== General Library ==

== GUI Engine (Skinning Engine) ==

== Input System (Input Manager and Input APIs) ==

== Live TV and PVR (Personal Video Recorder) ==
* Added PVR Reminders <ref>https://github.com/xbmc/xbmc/pull/15467</ref><ref>https://github.com/xbmc/xbmc/pull/16227</ref><ref>https://github.com/xbmc/xbmc/pull/16393</ref>
* Added EDL and chapter marker visualisation for recordings (and videos in general) <ref>https://github.com/xbmc/xbmc/pull/15767</ref>
* Reworked EPG database storage setting semantics (default to 'do not store') <ref>https://github.com/xbmc/xbmc/pull/16005</ref>
* Added TV and radio channel groups home screen widgets <ref>https://github.com/xbmc/xbmc/pull/16351</ref>
* Added thumbnail picture generation for channel groups <ref>https://github.com/xbmc/xbmc/pull/16360</ref>
* Group manager: Automatically fill channel lists upon group selection <ref>https://github.com/xbmc/xbmc/pull/16361</ref>
* Added ability to sort channels and EPG by the backend order of channels <ref>https://github.com/xbmc/xbmc/pull/16558</ref>
* Added support for group specific channel numbering and option to start group number locally from 1 <ref>https://github.com/xbmc/xbmc/pull/16593</ref>
* Rework Guide window's navigation controls <ref>https://github.com/xbmc/xbmc/pull/16638</ref>
* Added support for 'first aired' and 'rating' to PVR info dialog <ref>https://github.com/xbmc/xbmc/pull/16640</ref>
* Added 'new' indicators to Gudie window and PVR info dialog <ref>https://github.com/xbmc/xbmc/pull/16645</ref>
* Added support for 'year' to Guide, Timers and Recordings windows and dialogs <ref>https://github.com/xbmc/xbmc/pull/16728</ref>

* PVR-Addon API changes <ref>https://github.com/xbmc/xbmc/pull/15953</ref><ref>https://github.com/xbmc/xbmc/pull/16541</ref><ref>https://github.com/xbmc/xbmc/pull/16558</ref>

* Added, updated, and improved PVR backend clients addons for popular third-party external [[PVR backend]] platforms:
** New: [[Add-on:Waipu TV PVR Client|Waipu TV PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** New: [[Add-on:Freebox PVR Client|Freebox PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Zattoo PVR Client|Zattoo PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Teleboy PVR Client|Teleboy PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Sledovanitv.cz PVR Client|Sledovanitv.cz PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR Demo Client|PVR Demo Client]] dummy addon with fake (method stub) [[PVR backend]] for [[PVR]] skinning and regression testing
** [[Add-on:IPTV Simple Client|IPTV Simple Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:HDHomeRun PVR|HDHomeRun]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Digital Devices Octopus NET Client|Digital Devices Octopus NET Client]] PVR Addon backend client maintained and made available by [http://digitaldevices.de/home/ Digital Devices]
** [[Add-on:VU+ / Enigma2 Client|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Njoy N7 PVR Client|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VDR VNSI Client|VDR VNSI Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MythTV PVR Client|MythTV PVR Client]] Addon backend client maintained and available from the Kodi's community
** [[Add-on:NextPVR PVR Client|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Argus TV Client|Argus TV (former ForTheRecord)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBLink PVR Client|DVBLink PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBViewer Client|DVBViewer Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MediaPortal PVR Client|MediaPortal PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community

== Music Library ==

== Platform Independent Playback ==

== Web Scrapers ==

== Other ==

= Platform Specific =

== Android Specific ==

== BSD Specific ==

== iOS Specific ==

== Linux Specific ==

== OS X Specific ==

== Windows Specific ==

= References =
<references/>

= See also =
* [[Leia API changes]]
{{Changelogs}}

[[Category:Manual]]
[[Category:Leia|*]]
[[Category:Changelogs|18]]

Opening Windows and Dialogs

2019-07-02T13:34:07Z

Ksooo:

{{mininav|[[Development]]|[[Add-on development]]}}

You can use the ActivateWindow() [[List of Built In Functions|Built In Function]] to open a certain [[Window IDs|Window]].

This command can be assigned to a [[Button control|button]] in a skin or mapped to a key in your [[Keyboard.xml|Keymap]].

'''Example:'''
* This will take you directly to the settings section/window of xbmc:
<pre>ActivateWindow(Settings)</pre>

Some windows allow you to jump directly to a sub-section of that window. To do this, you can use either the sub-section's name or its path.

'''Example:'''
* If you want a button in your skin or on your remote to take you directly to the movie listing, you let that button do:
<pre>ActivateWindow(Videos,MovieTitles)</pre>
or
<pre>ActivateWindow(Videos,videodb://movies/titles/)</pre>

Below is a list of the available sub-sections in the Videos, Music, and Programs sections/windows.

== Videos ==
{| class="prettytable"
! Sub-section Name !! Path
|-
|Root ||library://video/
|-
|   || 
|-
|Movies ||videodb://movies/
|-
|MovieGenres ||videodb://movies/genres/
|-
|MovieTitles ||videodb://movies/titles/
|-
|MovieYears ||videodb://movies/years/
|-
|MovieActors ||videodb://movies/actors/
|-
|MovieDirectors ||videodb://movies/directors/
|-
|MovieStudios ||videodb://movies/studios/
|-
|MovieSets ||videodb://movies/sets/
|-
|MovieCountries ||videodb://movies/countries/
|-
|MovieTags ||videodb://movies/tags/
|-
|RecentlyAddedMovies ||videodb://recentlyaddedmovies/
|-
|   || 
|-
|TvShows ||videodb://tvshows/
|-
|TvShowGenres ||videodb://tvshows/genres/
|-
|TvShowTitles ||videodb://tvshows/titles/
|-
|TvShowYears ||videodb://tvshows/years/
|-
|TvShowActors ||videodb://tvshows/actors/
|-
|TvShowStudios ||videodb://tvshows/studios/
|-
|RecentlyAddedEpisodes ||videodb://recentlyaddedepisodes/
|-
|InProgressTvShows ||videodb://inprogresstvshows
|-
|   || 
|-
|MusicVideos ||videodb://musicvideos/
|-
|MusicVideoGenres ||videodb://musicvideos/genres/
|-
|MusicVideoTitles ||videodb://musicvideos/titles/
|-
|MusicVideoYears ||videodb://musicvideos/years/
|-
|MusicVideoArtists ||videodb://musicvideos/artists/
|-
|MusicVideoAlbums ||videodb://musicvideos/albums/
|-
|MusicVideoDirectors ||videodb://musicvideos/directors/
|-
|MusicVideoStudios ||videodb://musicvideos/studios/
|-
|RecentlyAddedMusicVideos ||videodb://recentlyaddedmusicvideos/
|-
|   || 
|-
|Playlists ||special://videoplaylists/
|-
|Video Add-ons ||addons://sources/video/
|-
|Files ||sources://video/
|-
|}

== Music ==
{| class="prettytable"
! Sub-section Name !! Path
|-
|Root ||library://music/
|-
|   || 
|-
|Genres ||musicdb://genres/
|-
|Artists ||musicdb://artists/
|-
|Albums ||musicdb://albums/
|-
|Song ||musicdb://songs/
|-
|Top100 ||musicdb://top100/
|-
|Top100Songs ||musicdb://top100/songs/
|-
|Top100Albums ||musicdb://top100/albums/
|-
|RecentlyAddedAlbums ||musicdb://recentlyaddedalbums/
|-
|RecentlyPlayedAlbums ||musicdb://recentlyplayedalbums/
|-
|Compilations ||musicdb://compilations/
|-
|Years ||musicdb://years/
|-
|Singles ||musicdb://singles/
|-
|   || 
|-
|Files ||sources://music/
|-
|Playlists ||special://musicplaylists/
|-
|Music Add-ons ||addons://sources/audio/
|}

== Programs ==
{| class="prettytable"
! Sub-section Name !! Path
|-
|Addons ||addons://sources/executable/
|-
|AndroidApps ||androidapp://sources/apps/
|}

== AddonBrowser ==
{| class="prettytable"
! Sub-section Name !! Path
|-
|My add-ons ||addons://user/<type>/ (see for available types https://github.com/xbmc/xbmc/blob/master/xbmc/addons/Addon.cpp#L73)
|-
|Update available ||addons://outdated/
|-
|Currently downloading add-ons ||addons://downloading/
|-
|Recently updated ||addons://recently_updated/
|-
|Install from repository ||addons://repos/
|-
|Install from zip ||addons://install/
|-
|Search ||addons://search/
|}

== PVR ==
There are different PVR windows, one for every PVR content type (channels, recordings, timers, timer rules, search) not a single PVR window with sub sections denoting the different content types.

Currently, most PVR windows cannot be activated using user supplied paths. Support for more windows may be added in the future.

Example: <pre>ActivateWindow(TVRecordings,pvr://recordings/tv/active/FooDirectory/)</pre> will open the TV recordings window prepoulated with the recordings contained in directory FooDirectory.

{| class="prettytable"
! Window Name !! Path !! Notes
|-
|TVChannels || ||
|-
|TVGuide || ||
|-
|TVRecordings ||pvr://recordings/tv/active/DIRECTORY/ ||Replace DIRECTORY with the name of the recording directory to display
|-
|TVTimers || ||
|-
|TVTimerRules || ||
|-
|TVSearch || ||
|-
|RadioChannels || ||
|-
|RadioGuide || ||
|-
|RadioRecordings ||pvr://recordings/radio/active/DIRECTORY/ ||Replace DIRECTORY with the name of the recording directory to display
|-
|RadioTimers || ||
|-
|RadioTimerRules || ||
|-
|RadioSearch || ||
|}

== Notes ==
<references />

[[Category:Skin development]]
[[Category:Add-on development]]
[[Category:Python]]

Opening Windows and Dialogs

2019-07-02T11:52:51Z

Ksooo:

{{mininav|[[Development]]|[[Add-on development]]}}

You can use the ActivateWindow() [[List of Built In Functions|Built In Function]] to open a certain [[Window IDs|Window]].

This command can be assigned to a [[Button control|button]] in a skin or mapped to a key in your [[Keyboard.xml|Keymap]].

'''Example:'''
* This will take you directly to the settings section/window of xbmc:
<pre>ActivateWindow(Settings)</pre>

Some windows allow you to jump directly to a sub-section of that window. To do this, you can use either the sub-section's name or its path.

'''Example:'''
* If you want a button in your skin or on your remote to take you directly to the movie listing, you let that button do:
<pre>ActivateWindow(Videos,MovieTitles)</pre>
or
<pre>ActivateWindow(Videos,videodb://movies/titles/)</pre>

Below is a list of the available sub-sections in the Videos, Music, and Programs sections/windows.

== Videos ==
{| class="prettytable"
! Sub-section Name !! Path
|-
|Root ||library://video/
|-
|   || 
|-
|Movies ||videodb://movies/
|-
|MovieGenres ||videodb://movies/genres/
|-
|MovieTitles ||videodb://movies/titles/
|-
|MovieYears ||videodb://movies/years/
|-
|MovieActors ||videodb://movies/actors/
|-
|MovieDirectors ||videodb://movies/directors/
|-
|MovieStudios ||videodb://movies/studios/
|-
|MovieSets ||videodb://movies/sets/
|-
|MovieCountries ||videodb://movies/countries/
|-
|MovieTags ||videodb://movies/tags/
|-
|RecentlyAddedMovies ||videodb://recentlyaddedmovies/
|-
|   || 
|-
|TvShows ||videodb://tvshows/
|-
|TvShowGenres ||videodb://tvshows/genres/
|-
|TvShowTitles ||videodb://tvshows/titles/
|-
|TvShowYears ||videodb://tvshows/years/
|-
|TvShowActors ||videodb://tvshows/actors/
|-
|TvShowStudios ||videodb://tvshows/studios/
|-
|RecentlyAddedEpisodes ||videodb://recentlyaddedepisodes/
|-
|InProgressTvShows ||videodb://inprogresstvshows
|-
|   || 
|-
|MusicVideos ||videodb://musicvideos/
|-
|MusicVideoGenres ||videodb://musicvideos/genres/
|-
|MusicVideoTitles ||videodb://musicvideos/titles/
|-
|MusicVideoYears ||videodb://musicvideos/years/
|-
|MusicVideoArtists ||videodb://musicvideos/artists/
|-
|MusicVideoAlbums ||videodb://musicvideos/albums/
|-
|MusicVideoDirectors ||videodb://musicvideos/directors/
|-
|MusicVideoStudios ||videodb://musicvideos/studios/
|-
|RecentlyAddedMusicVideos ||videodb://recentlyaddedmusicvideos/
|-
|   || 
|-
|Playlists ||special://videoplaylists/
|-
|Video Add-ons ||addons://sources/video/
|-
|Files ||sources://video/
|-
|}

== Music ==
{| class="prettytable"
! Sub-section Name !! Path
|-
|Root ||library://music/
|-
|   || 
|-
|Genres ||musicdb://genres/
|-
|Artists ||musicdb://artists/
|-
|Albums ||musicdb://albums/
|-
|Song ||musicdb://songs/
|-
|Top100 ||musicdb://top100/
|-
|Top100Songs ||musicdb://top100/songs/
|-
|Top100Albums ||musicdb://top100/albums/
|-
|RecentlyAddedAlbums ||musicdb://recentlyaddedalbums/
|-
|RecentlyPlayedAlbums ||musicdb://recentlyplayedalbums/
|-
|Compilations ||musicdb://compilations/
|-
|Years ||musicdb://years/
|-
|Singles ||musicdb://singles/
|-
|   || 
|-
|Files ||sources://music/
|-
|Playlists ||special://musicplaylists/
|-
|Music Add-ons ||addons://sources/audio/
|}

== Programs ==
{| class="prettytable"
! Sub-section Name !! Path
|-
|Addons ||addons://sources/executable/
|-
|AndroidApps ||androidapp://sources/apps/
|}

== AddonBrowser ==
{| class="prettytable"
! Sub-section Name !! Path
|-
|My add-ons ||addons://user/<type>/ (see for available types https://github.com/xbmc/xbmc/blob/master/xbmc/addons/Addon.cpp#L73)
|-
|Update available ||addons://outdated/
|-
|Currently downloading add-ons ||addons://downloading/
|-
|Recently updated ||addons://recently_updated/
|-
|Install from repository ||addons://repos/
|-
|Install from zip ||addons://install/
|-
|Search ||addons://search/
|}

== Notes ==
<references />

[[Category:Skin development]]
[[Category:Add-on development]]
[[Category:Python]]

Advancedsettings.xml

2019-02-06T12:25:52Z

Ksooo: /* epg */

{{TOC right}}{{mininav|[[Settings]]|page=advancedsettings.xml}}
{{bigger|{{note|'''The advancedsettings.xml file does not exist by default. You have to create it first!'''}} }}

<section begin="intro" />The [[advancedsettings.xml]] file, which does not exist by default, can be created by a user in their '''[[userdata folder]]'''.

This file is used for advanced settings and options that do not have GUI controls inside of {{kodi}}. Some settings are experimental or very rarely set, so they can only be used via the advancedsettings.xml file. The file is simply a plain text file and can be edited by various text editors, so long as the name is "advancedsettings.xml". These advanced settings can be used to tweak various things such as episode naming patterns, special network ports, special behaviors, and more.<section end="intro" />

The following page will describe the structure of the advancedsettings.xml file and the various individual settings.

{{note|
# All XML tags must be lowercase. The start and end of the advancedsettings.xml file must have the <advancedsettings> and </advancedsettings> tags.
# Kodi will only read the advancedsettings.xml file when it starts up. If you make changes while it is running then you must restart Kodi.
# For some Windows versions, Kodi has two <code>\userdata\</code> folders. The correct one to put the advancedsettings.xml file in is not the one in Program Files, but in <code>%appdata%\Kodi\userdata\.</code>}}

== Layout ==

The layout of <code>advancedsettings.xml</code> is as follows:

<syntaxhighlight lang=xml enclose="div">
<advancedsettings>
<setting>value</setting>
...
<setting>value</setting>
</advancedsettings>
</syntaxhighlight>

where "setting" gives the name of the setting, and "value" gives its value.

A list of the available "setting" strings and their values is given below.

= List of available settings =

== Troubleshooting settings ==

=== loglevel ===
{{Anchor|.3Cloglevel.3E}}

<section begin="loglevel" />
Sets the logging level used to log errors and information. The "hide" attribute is optional.

<syntaxhighlight lang=xml>
<loglevel hide="attribute">options</loglevel>
</syntaxhighlight>

{| class="mw-collapsible mw-collapsed wikitable"
|-
! style="width:100px;" | Attribute
! style="width:500px;" | Action
|-
! '''true'''
| Hides the "enable debugging" setting in the Settings page. (default)
|-
! '''false'''
| Allows "enable debugging" setting to switch between '''0''' and '''2'''.
|}

{| class="mw-collapsible mw-collapsed wikitable"
|-
! style="width:100px;" | Option
! style="width:500px;" | Action
|-
! '''-1'''
| No logging, suppresses all log output
|-
! '''0'''
| Normal logging, only logging errors (default)
|-
! '''1'''
| Debug logging with freemem, fps and cpu usage (no on screen)
|-
! '''2'''
| Same as 1 (with on screen display)
|-
! '''3'''
| Same as 2 + full smb logging (no on screen display)
|}

{| class="mw-collapsible mw-collapsed wikitable"
|-
! style="width:100px;" | Example
! style="width:500px;" |
|-
! Example 1:
|<syntaxhighlight lang=xml enclose="div">
<advancedsettings>
<loglevel>2</loglevel>
</advancedsettings>
</syntaxhighlight>
|-
! Example 2:
|<syntaxhighlight lang=xml enclose="div">
<advancedsettings>
<loglevel hide="true">2</loglevel>
</advancedsettings>
</syntaxhighlight>
|}

'''Note:''' The setting is persistent through shutdown and restarts.<br>
'''Note:''' If debugging is enabled in the GUI, loglevel will be set to '''2'''. This will over-ride the <code>advancedsettings.xml</code> setting. You must disable the GUI Setting before adding the entry to <code>advancedsettings.xml</code>.<br />
<section end="loglevel" />
:''{{see also|Log_file|label 1=Debug Log}}''

=== jsonrpc ===
{{Anchor|.3Cjsonrpc.3E}}
To make it easier for developers using the [[JSON RPC]] API in their (third party) applications to debug during development the json output of Kodi can be prettified by setting '''compactoutput''' to '''false'''. Default json output mode is a compact print which does not contain any unnecessary whitespaces and therefore is difficult to read for humans.
Furthermore using the '''tcpport''' setting it is possible to change the default TCP port used by Kodi for JSON RPC (which is 9090) to any other valid port.

Example:
<syntaxhighlight lang=xml enclose="div">
<jsonrpc>
<compactoutput>false</compactoutput>
<tcpport>9999</tcpport>
</jsonrpc>
</syntaxhighlight>

== Audio/video playback settings ==

=== skiploopfilter ===
{{anchor|.3Cskiploopfilter.3E}}
The amount of the loop filter to skip on h.264 decoding. This can help the performance of slower machines when decoding h264 content. Values, in decreasing CPU usage (and decreasing quality)
* -16 None
* 0 Skip only empty frames (default)
* 8 Skip non-reference frames
* 16 Skip bi-dir frames
* 32 Skip all non-key frames
* 48 Skip all frames
Example:
<syntaxhighlight lang=xml enclose="div">
<skiploopfilter>8</skiploopfilter>
</syntaxhighlight>

=== video ===
{{anchor|.3Cvideo.3E}}

The <video> section also includes the following child-tags, which have their own sections:
*[[#cleandatetime]]
*[[#cleanstrings]]
*[[#excludefromscan]]
*[[#excludefromlisting]]
*[[#excludetvshowsfromscan]]

{{note|Some tags that have a "third-level" and are grouped together are highlighted in color.}}

{| class="prettytable"
! Tag !! Description
|-
|
<syntaxhighlight lang=xml>
<video>
</syntaxhighlight>
| Parent tag that all other child tags need to be placed inside of. Do not use more than one '''<code><video></code>''' tag, but instead place all other child-tags within a single '''<code><video></video></code>''' set.
|-
|
<syntaxhighlight lang=xml>
<subsdelayrange>10</subsdelayrange>
</syntaxhighlight>
| Delay range for subtitles, in seconds.
|-
|
<syntaxhighlight lang=xml>
<audiodelayrange>10</audiodelayrange>
</syntaxhighlight>
| Delay range for audio/video sync, in seconds.
|-
|
<syntaxhighlight lang=xml>
<usetimeseeking>true</usetimeseeking>
</syntaxhighlight>
| Whether to use time based or percentage based seeking. {{small see also|HOW-TO:Modify time seeking}}
|-
|
<syntaxhighlight lang=xml>
<timeseekforwardbig>600</timeseekforwardbig>
<timeseekbackwardbig>-600</timeseekbackwardbig>
</syntaxhighlight>
| Time to seek forward in seconds when doing a long seek. Defaults to 600 (10 minutes) and -600 (-10 minutes) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang=xml>
<percentseekforward>2</percentseekforward>
<percentseekbackward>-2</percentseekbackward>
</syntaxhighlight>
| Amount to seek forward as a percentage, when doing a short seek. Defaults to 2 (2%) and -2 (2%) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang=xml>
<percentseekforwardbig>10</percentseekforwardbig>
<percentseekbackwardbig>-10</percentseekbackwardbig>
</syntaxhighlight>
| Amount to seek forward as a percentage, when doing a long seek. Defaults to 10 (10%) and -10 (10%) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang=xml>
<fullscreenonmoviestart>true</fullscreenonmoviestart>
</syntaxhighlight>
| Whether to go to fullscreen or not when starting a movie. Defaults to true.
|-
|
<syntaxhighlight lang=xml>
<defaultplayer>VideoPlayer</defaultplayer>
</syntaxhighlight>
| Set the default video player: VideoPlayer or an external player. See '''[[External players]]''' for more info.
|-
|
<syntaxhighlight lang=xml>
<excludefromscan>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromscan>
</syntaxhighlight>
| Regular expressions that if evaluated to true won't be added to library. It is possible to add multiple <code><regexp></code> tags to match multiple patterns
|-
|
<syntaxhighlight lang=xml>
<excludefromlisting>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>
</syntaxhighlight>
| Regular expressions that if evaluated to true won't be displayed in files view.
|-
|
<syntaxhighlight lang=xml>
<playcountminimumpercent>90</playcountminimumpercent>
</syntaxhighlight>
| Minimum percentage that has to be played before it is marked as watched. Set to 101 to never auto-mark items as watched. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang=xml>
<ignoresecondsatstart>180</ignoresecondsatstart>
</syntaxhighlight>
| Number of seconds to ignore at video start after which a resume point is created. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang=xml>
<ignorepercentatend>8</ignorepercentatend>
</syntaxhighlight>
| Percentage of video to ignore at the end. If you stop watching the video here no resume point is created. Set to 101 to never save a resume point. The video is already marked as watched at 90%, see above. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang=xml>
<vdpauscaling>true</vdpauscaling>
</syntaxhighlight>
| Scales with vdpau instead of opengl and turns on its HQ scaler when available, enabling this might slow down rendering and cause framedrops especially on ION systems, this setting requires a vdpau feature set C GPU.
|-
|
<syntaxhighlight lang=xml>
<enablehighqualityhwscalers>true</enablehighqualityhwscalers>
</syntaxhighlight>
| Allow turning on the spline36 and lanczos3 shader (for GL builds).
|-
|
<syntaxhighlight lang=xml>
<dxvaallowhqscaling>false</dxvaallowhqscaling>
</syntaxhighlight>
| Enables high quality video upscaling for Windows.
|-
|
<syntaxhighlight lang=xml>
<ppffmpegdeinterlacing>linblenddeint</ppffmpegdeinterlacing>
</syntaxhighlight>
| Override the deinterlacing options passed to libpostproc.
|-
|
<syntaxhighlight lang=xml>
<ppffmpegpostprocessing>ha:128:7,va,dr</ppffmpegpostprocessing>
</syntaxhighlight>
| Override the post processing options passed to libpostproc when 'Video post-processing' is activated in GUI Videos-Settings-Playback.
|-
|
<syntaxhighlight lang=xml>
<autoscalemaxfps>30</autoscalemaxfps>
</syntaxhighlight>
| When scaling method is set to auto, bilinear is chosen when the fps is higher than this limit, the default is 30.
|-
|
<syntaxhighlight lang=xml>
<adjustrefreshrate>
</syntaxhighlight>
| style="background:#CADCFB;" | Settings for when "Adjust refreshrate to match video fps" is enabled in the video playback GUI settings.
|-
|
<syntaxhighlight lang=xml>
<override>
<fps>23.976</fps>
<refresh>60.0</refresh>
</override>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' "Adjust refreshrate to match video fps" will try to select the best refreshrate for the video fps but it doesn't always get it right, for example it might switch to an unsupported refreshrate. You can add overrides here to switch to a certain refreshrate based on video fps. It's possible to add as many overrides as you need. Overrides are processed in order, if the first one doesn't match the fps or no refreshrates match that override, it will try the next one until no overrides are left.

* '''fps''' - if the fps is between 23.966 and 23.986
* '''refresh''' - switch to the first found refreshrate that is between 59.99 and 60.01
|-
|
<syntaxhighlight lang=xml>
<override>
<fpsmin>29.96</fpsmin>
<fpsmax>30.01</fpsmax>
<refreshmin>59.0</refreshmin>
<refreshmax>61.0</refreshmax>
</override>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -'''
* '''fpsmin''' / '''fpsmin''' - You can also specify the fps range yourself.
* '''refreshmin''' / '''refreshmax''' - Same for the refreshrate
|-
|
<syntaxhighlight lang=xml>
<fallback>
<refresh>50.0</refresh>
</fallback>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' If none of the overrides match, or none of the refreshrates match any of the fps matching overrides, it will choose a fallback refreshrate. Fallbacks are process in order, if the first fallback doesn't match any refreshrate, it will try the next one until no fallbacks are left.

* '''refresh''' - Switch to the first found refreshrate that is between 49.99 and 50.01.
|-
|
<syntaxhighlight lang=xml>
<fallback>
<refreshmin>49.0</refreshmin>
<refreshmax>51.0</refreshmax>
</fallback>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' You can also specify the range for the fallback yourself.

If none of the overrides match the video fps, or no refreshrates match any of the fps matching overrides, and no fallbacks are specified or no refreshrates match any fallbacks, it will automatically choose the best refreshrate (same as having no overrides and fallbacks).
|-
|
<syntaxhighlight lang=xml>
</adjustrefreshrate>
</syntaxhighlight>
| style="background:#CADCFB;" |
|-
|
<syntaxhighlight lang=xml>
<checkdxvacompatibility>value</checkdxvacompatibility>
</syntaxhighlight>
| Advanced setting not present: let Kodi autodetect cards that support H.264 profile > L4.1. Set value to false to enable DXVA no matter what. Set value to true if Kodi doesn't autodetect that the graphics card doesn't support > L4.1.
|-
|
<syntaxhighlight lang=xml>
<useocclusionquery>-1</useocclusionquery>
</syntaxhighlight>
| Use an occlusion query when capturing videoframes, -1 means auto detect, 0 means disabled, 1 means enabled, the default is -1.
|-
|
<syntaxhighlight lang=xml>
<fpsdetect>1</fpsdetect>
</syntaxhighlight>
| FPS detection for video playback
* 0 = trust codec fps
* 1 = recalculate from video timestamps with uniform spacing
* 2 = recalculate from video timestamps always
|-
|
<syntaxhighlight lang=xml>
<latency>
</syntaxhighlight>
| style="background:#F0E68C;"| Start of '''latency''' tags. Display latency (video lag). Latency is given in msecs.
|-
|
<syntaxhighlight lang=xml>
<delay>0</delay>
</syntaxhighlight>
| style="background:#F0E68C;" | Global default display latency.
|-
|
<syntaxhighlight lang=xml>
<refresh></refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | Override latency for given display (not video) refresh rates. When Kodi is in windowed mode, override is ignored. Multiple overrides are allowed.

Syntax of an override entry:
<syntaxhighlight lang=xml>
<refresh>
<min>, <max> refresh rate range, OR
<rate> exact refresh rate
<delay> display latency for the given refresh rate
</refresh>
</syntaxhighlight>
|-
|
<syntaxhighlight lang=xml>
<refresh>
<min>23</min>
<max>24</max>
<delay>125</delay>
</refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | '''Example:''' display has 125 msec latency at 23-24 Hz
|-
|
<syntaxhighlight lang=xml>
<refresh>
<rate>50</rate>
<delay>50</delay>
</refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | '''Example:''' display has 50 msec latency at 50 (+/-0.01) Hz
|-
|
<syntaxhighlight lang=xml>
</latency>
</syntaxhighlight>
| style="background:#F0E68C;" |
|-
|
<syntaxhighlight lang=xml>
<stereoscopicregex3d>[-. _]3d[-. _]</stereoscopicregex3d>
<stereoscopicregexsbs>[-. _]h?sbs[-. _]</stereoscopicregexsbs>
<stereoscopicregextab>[-. _]h?tab[-. _]</stereoscopicregextab>
</syntaxhighlight>
| Filename triggers for 3D (stereoscopic) mode.
|-
|
<syntaxhighlight lang=xml>
<assfixedworks>false</assfixedworks>
</syntaxhighlight>
| Position behavior of ass subtitiles when setting "subtitle position on screen" set to "fixed". True to show at the fixed position set in video calibration. False to show at the bottom of video (default).
|-
|
<syntaxhighlight lang=xml>
</video>
</syntaxhighlight>
|
|}

=== audio ===
{{anchor|.3Caudio.3E}}
<syntaxhighlight lang=xml enclose="div">
<audio>

<headroom>0</headroom>

<defaultplayer>paplayer</defaultplayer>

<excludefromscan>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromscan>

<excludefromlisting>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromlisting>

<ac3downmixgain>12.0</ac3downmixgain>

<usetimeseeking>true</usetimeseeking>

<timeseekforwardbig>600</timeseekfowardbig>

<timeseekbackwardbig>-600</timeseekbackward>

<playcountminimumpercent>99</playcountminimumpercent>

<applydrc>-1.0</applydrc>

<limiterhold>0.025</limiterhold>

<limiterrelease>0.1</limiterrelease>
</audio>
</syntaxhighlight>

For more information on the configuration of audio under Frodo see [[AudioEngine/HOW-TO: Configure audio]]

=== edl ===
{{anchor|.3Cedl.3E}}
{{main|EDL}}
Commercial break detection not as good you think it could be? Are some commercial breaks in a series of adverts not being skipped? Are some parts being skipped that are clearly not commercials? Does the end of the previous recording still show? The following advanced settings can be used to better identify full commercial break sequences, remove incorrectly flagged commercial breaks, and have playback start at the actual beginning of the recording.

<syntaxhighlight lang=xml enclose="div">
<edl>

<mergeshortcommbreaks>false</mergeshortcommbreaks>

<maxcommbreaklength>250</maxcommbreaklength>

<mincommbreaklength>90</mincommbreaklength>

<maxcommbreakgap>120</maxcommbreakgap>

<commbreakautowait>0</commbreakautowait>

<commbreakautowind>0</commbreakautowind>
</edl>
</syntaxhighlight>

=== pvr ===
{{anchor|.3Cpvr.3E}}
<syntaxhighlight lang=xml enclose="div">
<pvr>
<timecorrection>0</timecorrection> 
<infotoggleinterval>3000</infotoggleinterval> 
<channeliconsautoscan>true</channeliconsautoscan> 
<autoscaniconsuserset>false</autoscaniconsuserset> 
<numericchannelswitchtimeout>1000</numericchannelswitchtimeout> 
</pvr>
</syntaxhighlight>

=== epg ===
{{anchor|.3Cpvr.3E}}
<syntaxhighlight lang=xml enclose="div">
<epg>
<updatecheckinterval>300</updatecheckinterval> 
<updateemptytagsinterval>60</updateemptytagsinterval> 
<cleanupinterval>900</cleanupinterval> 
<activetagcheckinterval>60</activetagcheckinterval> 
<retryinterruptedupdateinterval>60</retryinterruptedupdateinterval> 
<displayupdatepopup>true</displayupdatepopup> 
<displayincrementalupdatepopup>false</displayincrementalupdatepopup> 
</epg>
</syntaxhighlight>

=== forcedswaptime ===
{{anchor|.3Cforcedswaptime.3E}}
Use to force a backbuffer->frontbuffer swap while vsync is enabled. Set to the time (in ms) to allow for the swap (e.g. <forcedswaptime>1</forcedswaptime> is typical).

Default: Off



== Video library settings ==

=== videoextensions ===
{{anchor|.3Cvideoextensions.3E}}<section begin="videoextensions" />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Video windows.

Default extensions for VIDEOS:
<pre>
.m4v .3g2 .3gp .nsv .tp .ts .ty .strm .pls .rm .rmvb .mpd .m3u .m3u8 .ifo .mov .qt .divx .xvid
.bivx .vob .nrg .pva .wmv .asf .asx .ogm .m2v .avi .dat .mpg .mpeg .mp4 .mkv .mk3d .avc .vp3
.svq3 .nuv .viv .dv .fli .flv .001 .wpl .vdr .dvr-ms .xsp .mts .m2t .m2ts .evo .ogv .sdp .avs
.rec .url .pxml .vc1 .h264 .rcv .rss .mpls .webm .bdmv .wtv .trp .f4v
</pre>
Examples:
<pre>
<videoextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</videoextensions>
</pre>
<section end="videoextensions" />

=== discstubextensions ===
{{main|Media stubs}}

<section begin="discstubextensions" />
The default filename extension for Disc Stubs is:
<syntaxhighlight lang=xml enclose="div">
.disc
</syntaxhighlight>
Using the following tags, it is possible to <tt><add></tt> additional or <tt><remove></tt> existing disc stub extensions to better suit your requirements.
<syntaxhighlight lang=xml enclose="div">
<discstubextensions>
<add>.disk|.stub</add>
<remove>.disc</remove>
</discstubextensions>
</syntaxhighlight>
<section end="discstubextensions" />

=== languagecodes ===
{{anchor|.3Clanguagecodes.3E}}
Translation table for subtitle and audio names. Contains entries of the form

<syntaxhighlight lang=xml enclose="div">
<languagecodes>
<code>
<short>alt</short>
<long>Alternate</long>
</code>
</languagecodes>
</syntaxhighlight>

=== moviestacking ===
{{anchor|.3Cmoviestacking.3E}}<section begin="moviestacking" />
{{main|File stacking}}
This is used by the [[file stacking]] algorithm to combine multi-part files and contains a list of "''[[Regular Expression (RegEx) Tutorial|regular expressions]]''". For stacking videos that are contained in folders, such as VIDEO_TS folders, see '''[[advancedsettings.xml#folderstacking|<folderstacking>]]'''

As of v9.11, video stacking regular expressions '''must''' contain exactly four (4) capture expressions.

Default:
<syntaxhighlight lang=xml enclose="div">
<moviestacking>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[0-9]+)(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[a-d])(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ ._-]*[a-d])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="append"</tt> or <tt>append="yes"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the end.

Example:
<syntaxhighlight lang=xml enclose="div">
<moviestacking action="append">

<regexp>(.*?)([ ._-]*[0-9])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="prepend"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the beginning.

Example:
<syntaxhighlight lang=xml enclose="div">
<moviestacking action="prepend">
<regexp>(Title)(Volume)(Ignore)(Extension)</regexp>
</moviestacking>
</syntaxhighlight>

If no argument is supplied, or the argument <tt>append="no"</tt> is supplied, the default moviestacking regular expressions are overwritten by the user specified ones.
<section end="moviestacking" />

=== folderstacking ===
{{main|File stacking}}
This is similar to '''[[advancedsettings.xml#moviestacking|<moviestacking>]]''', but is used for videos that are contained in folders that use the folder names to stack, such as VIDEO_TS folders (DVD rips that are not in ISO format).

Default:
<syntaxhighlight lang=xml enclose="div">
<folderstacking>

<regexp>((cd|dvd|dis[ck])[0-9]+)$</regexp>
</folderstacking>
</syntaxhighlight>

=== cleandatetime ===
{{anchor|.3Ccleandatetime.3E}}
Matches a year number in a string using a ''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''

Default expression:
<syntaxhighlight lang=xml enclose="div">
<video>
<cleandatetime>(.+[^ _\,\.\[\]\-])[ _\.\[\]\-]+(19[0-9][0-9]|20[0-1][0-9])([ _\,\.\[\]\-][^0-9]|$)</cleandatetime>
</video>
</syntaxhighlight>
:* The string found before will be used as basis string getting cleaned by the cleanstrings expressions.
:* By default date formats like MM:YY are ignored.

=== cleanstrings ===
{{anchor|.3Ccleanstrings.3E}}
Clean unwanted characters from filenames or folders by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. Please note that everything right of the match (at the end of the file name) is removed, so if you would have a file named ''Super movie.mp4'' and would add <tt><regexp> </regexp></tt> (only a space), the only thing that would be left is ''Super'', which is probably not what you want.

Default expressions:
<syntaxhighlight lang=xml enclose="div">
<video>
<cleanstrings>
<regexp>[ _\,\.\[\]\-](ac3|dts|custom|dc|divx|divx5|dsr|dsrip|dutch|dvd|dvdrip|dvdscr|dvdscreener|screener|dvdivx|cam|fragment|fs|hdtv|hdrip|hdtvrip|internal|limited|multisubs|ntsc|ogg|ogm|pal|pdtv|proper|repack|rerip|retail|cd[1-9]|r3|r5|bd5|se|svcd|swedish|german|read.nfo|nfofix|unrated|ws|telesync|ts|telecine|tc|brrip|bdrip|480p|480i|576p|576i|720p|720i|1080p|1080i|hrhd|hrhdtv|hddvd|bluray|x264|h264|xvid|xvidvd|xxx|www.www|\[.*\])([ _\,\.\[\]\-]|$)</regexp>
<regexp>(\[.*\])</regexp>
</cleanstrings>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== tvshowmatching ===
{{anchor|.3Ctvshowmatching.3E}}
Matches the season and episode numbers in file paths by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

Defaults:
<syntaxhighlight lang=xml enclose="div">
<tvshowmatching>
<regexp>s([0-9]+)[ ._x-]*e([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)([^\\\\/]*)$</regexp> 
<regexp>[\._ -]()[Ee][Pp]_?([0-9]+)([^\\/]*)$</regexp> 
<regexp>([0-9]{4})[\.-]([0-9]{2})[\.-]([0-9]{2})</regexp> 
<regexp>([0-9]{2})[\.-]([0-9]{2})[\.-]([0-9]{4})</regexp> 
<regexp>[\\/\._ \[\(-]([0-9]+)x([0-9]+)([^\\/]*)$</regexp> 
<regexp>[\\/\._ -]([0-9]+)([0-9][0-9])([\._ -][^\\/]*)$</regexp> 
<regexp>[\/._ -]p(?:ar)?t[_. -]()([ivx]+)([._ -][^\/]*)$</regexp> 
</tvshowmatching>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)
:* Paths are converted to lower case before matching.
:* Examples of matching regexps for certain filenames can be found on the [[TV Shows (Video Library)|TV shows]] page.

:* For multi-episode matching to work, there needs to be a third set of parentheses '()' at the end, this part is fed back into the regexp engine.

:* A [https://forum.kodi.tv/showthread.php?tid=51614 forum thread] has a discussion of pre-made regex lists to match common names. These might improve Kodi's ability to match TV show names in some situations, at the risk of additional false positives.

==== Filenames without Season ====
There are two methods to add episodes without a season in their file path. Both ways will force the season to '1' by default, so that you can use
the 'Use Absolute Ordering (Single Season)' setting from the TheTvDb.com scraper.

; Simple Method ''(XBMC v9.11 onwards and Kodi)''
: Use only one pair of parentheses
<syntaxhighlight lang=xml enclose="div"><regexp>[/\._ \-]([0-9]+)</regexp></syntaxhighlight>
; Advanced Method ''(XBMC v10.05 onwards and Kodi)''
: Supports multi-episode files without season
: Use an empty pair of parentheses for the season
<syntaxhighlight lang=xml enclose="div"><regexp>[/\._ \-]()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

; Specifying Default Season ''(XBMC v12.0 onwards and Kodi)''
It is possible to set the default season for specific regular expressions by setting the 'defaultseason' attribute.
: Works with both the simple method and advanced method
: If not used, the season will be set to '1'
: Useful for setting specials to season '0'
<syntaxhighlight lang=xml enclose="div"><regexp defaultseason="0">[/\._ \-]X()([0-9]+)(-[0-9]+)?</regexp>
<regexp defaultseason="1">[/\._ \-]E()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

=== tvmultipartmatching ===
{{anchor|.3Ctvmultipartmatching.3E}}
Matches a multipart episode number based on a previously identified episode file, using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''.

Default:
<syntaxhighlight lang=xml enclose="div">
<tvmultipartmatching>^[-_ex]+([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)</tvmultipartmatching>
</syntaxhighlight>
:* Text matching is compared case-insensitive.
:* Specifying this option '''replaces''' the default value

=== excludefromscan ===
{{anchor|.3Cexcludefromscan.3E}}
Matches filenames or folders which should be excluded from a library scan (except tvshows) using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. This can be for both Video or Audio sections of <tt>advancedsettings.xml</tt>.

Defaults:
<syntaxhighlight lang=xml enclose="div">
<video>
<excludefromscan>
<regexp>-trailer</regexp>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludefromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== excludefromlisting ===
{{anchor|.3Cexcludefromlisting.3E}}
<syntaxhighlight lang=xml enclose="div">
<video>
<excludefromlisting> 
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>
</video>
</syntaxhighlight>

=== excludetvshowsfromscan ===
{{anchor|.3Cexcludetvshowsfromscan.3E}}
Matches filenames or folders which should be excluded from a tvshow library scan using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

Defaults:
<syntaxhighlight lang=xml enclose="div">
<video>
<excludetvshowsfromscan>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludetvshowsfromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== trailermatching ===
{{anchor|.3Ctrailermatching.3E}}
Contains "''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''" syntax (commonly referred to as "''[[Regular Expression (RegEx) Tutorial|RegEx]]''" or "''[[Regular Expression (RegEx) Tutorial|RegExp]]''") to match the locally stored trailers to movies in the library.

<syntaxhighlight lang=xml enclose="div">
<trailermatching>

<regexp>(.*?)(_Trailer)(\.[^.]+)$</regexp>
</trailermatching>
</syntaxhighlight>

=== videolibrary ===
{{anchor|.3Cvideolibrary.3E}}
Options specific to the Video Library

<syntaxhighlight lang=xml enclose="div">
<videolibrary>
<allitemsonbottom>false</allitemsonbottom> 
<cleanonupdate>false</cleanonupdate> 
<usefasthash>true</usefasthash> 
<recentlyaddeditems>35</recentlyaddeditems> 
<itemseparator> / </itemseparator> 
<exportautothumbs>false</exportautothumbs> 
<importwatchedstate>false</importwatchedstate> 
<importresumepoint>false</importresumepoint> 
<dateadded>1</dateadded> 
</videolibrary>
</syntaxhighlight>

==== Extra artwork ====

New for Kodi v18.
Configuration to expand the artwork automatically added by Kodi to media items in the library, either from local files or online scrapers.

The original basic artwork types are still hardcoded so they don't need to be configured here (and can't be removed). "poster" and "fanart" for movies, movie sets, TV shows, seasons, and music videos; "banner" for TV shows and seasons; and "thumb" for episodes.

<syntaxhighlight lang=xml enclose="div">
<videolibrary>


<tvshowextraart>
<arttype>characterart</arttype>
<arttype>clearart</arttype>
<arttype>clearlogo</arttype>
<arttype>landscape</arttype>
<arttype>keyart</arttype>
</tvshowextraart>

<tvseasonextraart>
<arttype>landscape</arttype>
</tvseasonextraart>

<episodeextraart>
<arttype>fanart</arttype>
</episodeextraart>

<movieextraart>
<arttype>banner</arttype>
<arttype>clearart</arttype>
<arttype>clearlogo</arttype>
<arttype>discart</arttype>
<arttype>landscape</arttype>
<arttype>keyart</arttype>
</movieextraart>

<moviesetextraart>
<arttype>banner</arttype>
<arttype>clearart</arttype>
<arttype>clearlogo</arttype>
<arttype>discart</arttype>
<arttype>landscape</arttype>
<arttype>keyart</arttype>
</moviesetextraart>

<musicvideoextraart>
<arttype>banner</arttype>
<arttype>clearart</arttype>
<arttype>clearlogo</arttype>
<arttype>discart</arttype>
<arttype>landscape</arttype>
</musicvideoextraart>
</videolibrary>
</syntaxhighlight>

=== videoscanner ===
{{anchor|.3Cvideoscanner.3E}}
Options specific to the Video scanner
<syntaxhighlight lang=xml enclose="div">
<videoscanner>
<ignoreerrors>true</ignoreerrors> 
</videoscanner>
</syntaxhighlight>

== Library artwork ==

{{note|Using <imageres>9999</imageres> and <fanartres>9999</fanartres> will allow caching artwork at original size.}}

=== imageres ===
{{anchor|.3Cimageres.3E}}

<section begin="imageres description" />Specify the maximum resolution that [[Artwork/Cache#Texture optimization| cached artwork]] (other than fanart / 16:9 images) should be resized to in pixels. The width is automatically calculated as being 16/9*height. The image will be resized to fit within this size. e.g. an image that is 2000x500 will be cached at size 1280x320. An image that is 500x800 will be cached at size 450x720 using the default value of 720.<section end="imageres description" />

<syntaxhighlight lang=xml enclose="div">
<imageres>720</imageres>
</syntaxhighlight>

=== fanartres ===
{{anchor|.3Cfanartres.3E}}

<section begin="fanartres description" />Specify the maximum resolution that [[Artwork/Cache#Texture optimization| cached fanart]] should be resized to in pixels. The width is automatically calculated as being 16/9*height. Only images that are exactly 16x9 and equal to or greater than this resolution will be cached at this size - all other images will be cached using <imageres>. The default value is 1080.<section end="fanartres description" />

<syntaxhighlight lang=xml enclose="div">
<fanartres>1080</fanartres>
</syntaxhighlight>

=== fanart ===
{{anchor|.3Cfanart.3E}}
Only used for music and not video.

A list of additional files to try when searching for local fanart images. (The defaults are fanart.jpg and fanart.png which can be removed.)

Example:
<syntaxhighlight lang=xml enclose="div">
<fanart>
<remove>fanart.jpg</remove>
<add>backdrop.jpg</add>
</fanart>
</syntaxhighlight>

=== musicthumbs ===
{{anchor|.3Cmusicthumbs.3E}}
<section begin="musicthumbs" />A list of additional files to try when searching for music thumbnail images. (The default is folder.jpg which can be removed.)

Example:
<syntaxhighlight lang=xml enclose="div">
<musicthumbs>
<remove>folder.jpg</remove>
<add>thumb.jpg|cover.jpg</add>
</musicthumbs>
</syntaxhighlight><section end="musicthumbs" />

=== imagescalingalgorithm ===
Specify the image scaling algorithm for image resizing when [[Artwork/Cache#Texture optimization| caching artwork]] to the local texture cache.
<br />
<syntaxhighlight lang=xml enclose="div">
<imagescalingalgorithm>bicubic</imagescalingalgorithm>
</syntaxhighlight>

[https://github.com/xbmc/xbmc/blob/1a8753d5cd93890dc6a9f9d4b2ce8848066ea5d0/xbmc/pictures/PictureScalingAlgorithm.cpp#L32-L43 Available image scaling algorithms]

<syntaxhighlight lang=text enclose="div">
fast_bilinear
bilinear
bicubic
experimental
nearest_neighbor
averaging_area
bicublin
gaussian
sinc
lanczos
bicubic_spline
</syntaxhighlight>

== Video and music library settings ==

=== playlistasfolders ===
{{anchor|.3Cplaylistasfolders.3E}}
In the recent releases, playlists are treated as folders. Selecting a playlist no longer plays it, but opens it, as if it were a folder.

Set to false to revert to the previous behaviour. When you select a playlist, its content is added to the list of elements to be played.

:{{note|This setting will not affect smart playlists, they will always show as folders.}}

;Example
<syntaxhighlight lang=xml enclose="div">
<playlistasfolders>true</playlistasfolders>
</syntaxhighlight>

=== playlistretries ===
{{anchor|.3Cplaylistretries.3E}}
The number of retries attempted if a source is offline. With this control you can alter the number of consecutive failed items before a playlist fails.

Default:
<syntaxhighlight lang=xml enclose="div">
<playlistretries>100</playlistretries>
</syntaxhighlight>

=== playlisttimeout ===
{{anchor|.3Cplaylisttimeout.3E}}
The timeout, in seconds, before item failure.

Default:
<syntaxhighlight lang=xml enclose="div">
<playlisttimeout>20</playlisttimeout>
</syntaxhighlight>

=== sorttokens ===
Allows you to specify additional tokens that will be ignored at the start of lines during sorting.
{{note|Sort tokens are case sensitive.}}
<syntaxhighlight lang=xml enclose="div">
<sorttokens>
<token>the</token>
</sorttokens>
</syntaxhighlight>

In the above example "the ", "the." and "the_" will be ignored at the start of titles or names when sorting items, in both video and music libraries. A separator can also be specified, for example
<syntaxhighlight lang=xml enclose="div">
<sorttokens>
<token separators="'">L</token>
</sorttokens>
</syntaxhighlight>
In that case the value L', as in French movie name ''L'argent'', will be ignored and the item listed under "A".

=== musicdatabase/videodatabase ===
{{anchor|.3Cmusicdatabase.3E/.3Cvideodatabase.3E|musicdatabase/videodatabase|database tags music/video/tv/epg/adsp}}
{{main|MySQL}}
<section begin="videodatabase" />
Allows advanced customization of the default database settings for music, video, TV, EPG, and ADSP databases.

:{{note| '''It is HIGHLY recommended that you not attempt to place an sqlite3 database outside of kodi's path. sqlite3 contains no filesystem abstraction, so this will plain break on any non-local (as far as Kodi is concerned) paths. Use this for mysql only.'''}}

'''Parent tags:'''

* '''<videodatabase>'''
* '''<musicdatabase>'''
* '''<tvdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
* '''<epgdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
* '''<adspdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
{{MySQL warning}}

'''Child tags: '''

;<type>
: ''Required'' - Can be either "sqlite3" or "mysql" (default: sqlite3)

;<host>
:''Required'' -
* sqlite3: defines the relative path to the database file (eg. /usr/local/kodi/databases).
* mysql: defines the host of the mysql socket (eg. localhost, 192.168.0.1, etc)

;<port>
: ''Optional'' -
* sqlite3: silently ignored
* mysql: defines the port of the mysql socket (default: 3306)

;<name>
: ''Optional'' -
:by default "MyVideos"+DB number will be used.
* sqlite3: defines the name of the database file to read from, excluding the ".db" extension.
* mysql: defines the name of the database to use

;<user>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the user with privileged access to the database

;<pass>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the password for the user with privileged access to the database

;<compression>
: ''Optional'' - Defaults to false. Set to "true" to enable MySQL compression protocol. Performance benefit is going to be largely dependent on the network bandwidth, latency between database and clients and on the size of the result sets. [https://github.com/xbmc/xbmc/pull/6484]
: {{Note|Slower clients (such as the RPi and others) won't benefit from it as the zlib de-compression overhead is higher than the actual compression savings}}

;<key>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<cert>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ca>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<capath>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ciphers>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

'''Examples:'''

1) Configure a database for MySQL.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', '''<epgdatabase>''', and '''<adspdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang=xml enclose="div">
<videodatabase>
<type>mysql</type>
<host>192.168.0.10</host>
<name>kodi_video</name>
<user>kodi</user>
<pass>kodi</pass>
</videodatabase>
</syntaxhighlight>

2) Configure a database for an sqlite database.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', '''<epgdatabase>''', and '''<adspdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang=xml enclose="div">
<musicdatabase>
<type>sqlite3</type>
<host>/usr/local/share/kodi/databases</host>
</musicdatabase>
</syntaxhighlight>

<section end="videodatabase" />

=== externalplayer ===
{{anchor|.3Cexternalplayer.3E}}
{{see|External players}}

== Music settings ==

=== musicextensions ===
{{anchor|.3Cmusicextensions.3E}}
<section begin="musicextensions" />
Default extensions for MUSIC:
<pre>
.nsv .m4a .flac .aac .strm .pls .rm .rma .mpa .wav .wma .ogg .mp3 .mp2 .m3u .gdm .imf .m15 .sfx
.uni .ac3 .dts .aif .aiff .wpl .ape .mac .mpc .mp+ .mpp .shn .wv .dsp .xsp .xwav .waa .wvs .wam
.gcm .idsp .mpdsp .mss .spt .rsd .sap .cmc .cmr .dmc .mpt .mpd .rmt .tmc .tm8 .tm2 .oga .url
.pxml .tta .rss .wtv .mka .tak .opus .dff .dsf .m4b .cue .zip .rar
</pre>

It is possible to add or remove extensions for Music, using the following XML tags. Useful if you keep, say, FLAC and mp3 versions of music in the same folder. The <remove> tag can be used to remove mp3 from being listed in the library, leaving only the higher quality FLAC being displayed.

<musicextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</musicextensions>

<section end="musicextensions" />

=== cddbaddress ===
{{anchor|.3Ccddbaddress.3E}}
The address of the online CDDb database. You may set this to another freedb mirror if there is a more suitable one.

Default:
<syntaxhighlight lang=xml enclose="div>
<cddbaddress>freedb.freedb.org</cddbaddress>
</syntaxhighlight>

=== songinfoduration ===
{{anchor|.3Csonginfoduration.3E}}
This controls how long the song information will remain onscreen when the song changes during visualisations. The valid range is "1" to "Indefinite (0)", in seconds. This does not include the duration of any transition effects.

Default:
<syntaxhighlight lang=xml enclose="div">
<songinfoduration>10</songinfoduration>
</syntaxhighlight>

=== musicfilenamefilters ===
{{anchor|.3Cmusicfilenamefilters.3E}}
Contains filters to match music information (artist, title etc.) from a tag-less music filename. The first <filter> to match completely is used. Matched items include:

<pre>
%A - Artist
%T - Title
%B - Album
%N - Track number
%S - Part of set (disk number)
%D - Duration
%G - Genre
%Y - Year
%R - Rating
</pre>

Example:
<syntaxhighlight lang=xml enclose="div">
<musicfilenamefilters>
<filter>%A - %T</filter>
</musicfilenamefilters>
</syntaxhighlight>

=== musiclibrary ===
Options specific to the Music Library
<section begin="MusicLibrary" />
<syntaxhighlight lang="xml" line='line'>
<musiclibrary>
<allitemsonbottom>true</allitemsonbottom> 
<cleanonupdate>false</cleanonupdate> 
<recentlyaddeditems>35</recentlyaddeditems> 
<albumformat>%B - %Y</albumformat> 
<prioritiseapetags>true</prioritiseapetags> 
<itemseparator> / </itemseparator> 
<artistseparators> 
<separator>;</separator>
<separator>:</separator>
<separator>|</separator>
<separator> feat. </separator>
<separator> ft. </separator>
</artistseparators>
<dateadded>1</dateadded> 


<promptfulltagscan>false</promptfulltagscan> 
<useartistsortname>false</useartistsortname> 
</musiclibrary>
</syntaxhighlight>
{{Note|Changing the <itemseparator> or <artistseparators> will only affect newly added items. A rescan won't change the existing ones. Remove the Source(s) or delete the Music DB and rebuild. This process should be made easier from v18 and up using <promptfulltagscan>}}<section end="MusicLibrary" />

==== Music library extra artwork ====

New for Kodi v18.
Configuration to expand the artwork automatically added by Kodi to media items in the library, either from local files or online scrapers.

The original basic artwork types are still hardcoded so they don't need to be configured here (and can't be removed). "thumb" for artists and albums, and "fanart" for artists.

<syntaxhighlight lang=xml enclose="div">
<musiclibrary>


<artistextraart>
<arttype>banner</arttype>
<arttype>clearlogo</arttype>
<arttype>clearart</arttype>
<arttype>landscape</arttype>
</artistextraart>

<albumextraart>
<arttype>discart</arttype>
<arttype>spine</arttype>
<arttype>back</arttype>
</albumextraart>
</musiclibrary>
</syntaxhighlight>

== Photos settings ==

=== pictureextensions ===
{{anchor|.3Cpictureextensions.3E}}
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Pictures window.

Default extensions for PICTURES:
<pre>
.png .jpg .jpeg .bmp .gif .ico .tif .tiff .tga .pcx .cbz .cbr .rss .webp .jp2 .apng
</pre>

Examples:
<syntaxhighlight lang=xml enclose="div">
<pictureextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</pictureextensions>
</syntaxhighlight>

=== pictureexcludes ===
{{anchor|.3Cpictureexcludes.3E}}
Matches filenames or folders which should be excluded from being displayed in My Pictures using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

<syntaxhighlight lang=xml enclose="div">
<pictureexcludes> 
<regexp>small</regexp>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</pictureexcludes>
</syntaxhighlight>

=== slideshow ===
{{anchor|.3Cslideshow.3E}}
<syntaxhighlight lang=xml enclose="div">
<slideshow>

<panamount>2.5</panamount>

<zoomamount>5.0</zoomamount>



<blackbarcompensation>20</blackbarcompensation>
</slideshow>
</syntaxhighlight>

== Network settings ==

=== samba ===
{{anchor|.3Csamba.3E}}
<syntaxhighlight lang=xml enclose="div">
<samba>
<doscodepage></doscodepage> 
<clienttimeout>10</clienttimeout> 
<statfiles>true</statfiles> 
</samba>
</syntaxhighlight>

=== hosts ===
{{anchor|.3Cfhosts.3E}}
Static dns entries which take precedence over your dns server.
<syntaxhighlight lang=xml enclose="div">
<hosts>
<entry name="HOSTNAME">IPADDRESS</entry>
</hosts>
</syntaxhighlight>

=== network ===
{{anchor|.3Cnetwork.3E}}

<syntaxhighlight lang=xml enclose="div">
<network>
<curlclienttimeout>10</curlclienttimeout> 
<curllowspeedtime>20</curllowspeedtime> 
<curlretries>2</curlretries> 
<httpproxyusername></httpproxyusername> 
<httpproxypassword></httpproxypassword> 
</network>
</syntaxhighlight>

{{Note|In Kodi v17, the three buffer settings are removed from the <code><network></code> tag and now placed under the new <code><cache></code> tag. See '''[[#cache]]''' for full details.}}

=== cache ===
{{see also|HOW-TO:Modify the cache}}
<syntaxhighlight lang=xml enclose="div">
<cache>
<memorysize>0</memorysize> 
<buffermode>0</buffermode> 
<readfactor>4.0</readfactor> 
</cache>
</syntaxhighlight>

=== airtunesport ===
{{anchor|.3Cairtunesport.3E}}<section begin="airtunesport" />
This overwrites the defalt listening port of the AirTunes server (announced via zeroconf).
<section end="airtunesport" />

=== airplayport ===
{{anchor|.3Cairplayport.3E}}<section begin="airplayport" />
This overwrites the default listening port of the AirPlay server (announced via zeroconf).
<section end="airplayport" />

== File system settings ==

=== packagefoldersize ===
<section begin="packagefoldersize" />
{{anchor|.3Cpackagefoldersize.3E}}
{{xml setting
| tag name = packagefoldersize
| option type = numerical
| option values =
| default values = 200
| platform = all
| XBMC version = 12
| description = The amount (in megabytes) of add-on zip packages saved from previous add-on installs. These packages are mainly used for the [[add-on]] rollback feature. Increasing the size should increase the amount of past versions saved. Defaults to 200 MB.
| example = Example: <syntaxhighlight lang=xml enclose="div"><packagefoldersize>200</packagefoldersize> </syntaxhighlight>
}}
<section end="packagefoldersize" />

=== detectasudf ===
{{anchor|.3Cdetectasudf.3E}}
Set to true if you wish to detect joint ISO9660/UDF disks as UDF.

Default: False

=== pathsubstitution ===
{{anchor|.3Cpathsubstitution.3E}}
{{main|Path substitution}}

{{divbox|red||'''Note:''' Path substition for "sources" and profiles is broken, and will '''NOT''' be fixed.}}

Path substitutions are for use for redirecting file paths. These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for Kodi to handle.

Default: No path substitutions defined.

Example:
<syntaxhighlight lang=xml enclose="div">
<pathsubstitution>
<substitute>
<from>G:\dvds\</from>
<to>smb://somecomputer/g-share/dvds/</to> 
</substitute>
</pathsubstitution>
</syntaxhighlight>

== Input control settings ==

=== remotedelay ===
{{anchor|.3Cremotedelay.3E}}
The repeat delay for a LIRC remote control. A delay value between 1 and 20 before a remote button starts repeating on a long keypress (i.e. continuously sending button pushes while it's held down).

Default: 3
<syntaxhighlight lang=xml enclose="div">
<remotedelay>10</remotedelay>
</syntaxhighlight>

=== controllerdeadzone ===
{{anchor|.3Ccontrollerdeadzone.3E}}
This advanced settings has been removed. See [[HOW-TO:Controller deadzone]].

=== enablemultimediakeys ===
{{anchor|.3Cenablemultimediakeys.3E}}
This setting only has any effect on Windows versions of Kodi, and only applies to builds from 28th May 2011 onwards.
In Windows the multimedia keys generate a WM_APPCOMMAND message in addition the keypress. Kodi processes both keypresses and the WM_APPCOMMAND messages, and the end result would be that the command is executed twice. To avoid this, by default multimedia keypresses are disabled. Although it should rarely be necessary, the enablemultimediakeys setting allows you to enable the multimedia keys.

Example:
<syntaxhighlight lang=xml enclose="div">
<enablemultimediakeys>true</enablemultimediakeys>
</syntaxhighlight>

=== seeksteps ===
{{Main|Skip steps}}

This setting changes which increments are available in the settings GUI for additive seeking. Note that <code><seeksteps></code> is not used to actually choose which seek steps are enabled.

'''Default:'''
<syntaxhighlight lang=xml enclose="div">
<seeksteps>7, 15, 30, 60, 180, 300, 600, 900, 1800</seeksteps>
</syntaxhighlight>

{{editor note|the defaults need to be updated for seeksteps.}}

=== touchscreen ===
{{anchor|.3Ctouchscreen.3E}}
This setting allows you to move/align the origin of the touch screen with the origin of the display used. If touch input does not result in a correct movement of the mouse pointer, the behaviour can be corrected with an offset and a stretch/compress factor.

Example:
<syntaxhighlight lang=xml enclose="div">
<touchscreen>
<x_offset>0</x_offset> 
<y_offset>0</y_offset> 
<x_stretch_factor>1.0</x_stretch_factor> 
<y_stretch_factor>1.0</y_stretch_factor> 
</touchscreen>
</syntaxhighlight>

== Other interface settings ==

=== window ===
{{anchor|.3Cwindow.3E}}
{{note|This is a "hidden" guisettings.xml setting (defined by the mouse moving the window size), but it is mentioned here because it is a particularly useful override when used in advancedsettings.xml}}
This allows you to manually set the default size of Kodi's windowed mode. If you resize the window, it will return to the set size when restarting.

WIDTH and HEIGHT are the values for each dimension, in pixels.

<syntaxhighlight lang=xml enclose="div">
<window>
<width>WIDTH</width>
<height>HEIGHT</height>
</window>
</syntaxhighlight>

=== restrictcapsmask ===
{{anchor|.3Crestrictcapsmask.3E}}
Windows only. A bitmask to prevent Kodi from using detected texture capabilities of the GPU. This helps work around buggy hardware/drivers.

1: prevent the use of compressed textures (DXT1, DXT3, DXT5)
2: prevent the use of non-power-of-two dimensions for textures
4: prevent the use of compressed textures with non-power-of-two dimensions.

<syntaxhighlight lang=xml enclose="div">
<restrictcapsmask>0</restrictcapsmask>
</syntaxhighlight>

=== algorithmdirtyregions ===
{{anchor|.3Calgorithmdirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="algorithmdirtyregions" />{{note|Some GPU/hardware configurations will have some minor issues (such as a visual "flicker"). For those situations try mode 2 or use the default (mode 3, which requires no advancedsetting). Almost all ARM-based devices (such as [[Android]]) willl likely have flickering issues.}}

Enable dirty-region processing. Dirty regions are any parts of the screen that have changed since the last frame. By not re-rendering what hasn't changed the GUI can be sped up. Because all GPUs work differently, only Mode 3, combined with nofliptimeout=0, is guaranteed to work for everyone without flickering issues. This mode will reduce CPU/GPU usage, but will not increase GUI speed.

{| class="prettytable"
! value !! result !! description
|-
! 0
| Off
| The entire viewport is always rendered.
|-
! 1
|Union
|All dirty regions are grouped into the smallest possible rectangle. This is typically the fastest mode for slower GPUs due to only making one pass.
|-
! 2
| {{nowrap|Cost reduction}}
| Each dirty region is presented separately, in as many passes as there are regions.
|-
! 3
| {{nowrap|Whole Screen}}
| The entire screen is rendered if there are any dirty regions. This, combined with nofliptimeout is a safe default for drivers that clear buffer contents (manifests as blinking or vibrating images). '''Default'''
|}<section end="algorithmdirtyregions" />

Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<algorithmdirtyregions>1</algorithmdirtyregions>
</gui>
</syntaxhighlight>

=== visualizedirtyregions ===
{{anchor|.3Cvisualizedirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="visualizedirtyregions" />Enable dirty-region visualization. Paints a rectangle over marked controls.

* true: on
* false: off '''(Default)'''

{{note|This is only a development mode and isn't of use to normal users.}}
<section end="visualizedirtyregions" />
Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<visualizedirtyregions>true</visualizedirtyregions>
</gui>
</syntaxhighlight>

=== smartredraw ===

{{note|This is an experimental feature and you might face issues using it. So please be aware of that.}}

This new feature was introduced in Kodi 18 and if enabled, the GUI process call (and therefore the render call) is only done if anything has changed. The result will be a faster GUI and less load if Kodi plays a video

* true: on
* false: off '''(Default)'''

Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<smartredraw>true</smartredraw>
</gui>
</syntaxhighlight>

=== showexitbutton ===
{{anchor|.3Cshowexitbutton.3E}}
Setting to hide the exit button, useful for people running appliance based setups where exit would only confuse/complicate the user. Modifiable via the advancedsettings.xml by setting showexitbutton to false, default is true (show)

Example:
<syntaxhighlight lang=xml enclose="div">
<showexitbutton>true</showexitbutton>
</syntaxhighlight>

=== fullscreen ===
{{anchor|.3Cfullscreen.3E}}
Starts Kodi in full screen (check resolutions!).

<syntaxhighlight lang=xml enclose="div">
<fullscreen>false</fullscreen>
</syntaxhighlight>

=== splash ===
{{anchor|.3Csplash.3E}}
Set to false if you wish to disable the startup splash image. Defaults to true.

<syntaxhighlight lang=xml enclose="div">
<splash>true</splash>
</syntaxhighlight>

=== cputempcommand ===
{{anchor|.3Ccputempcommand.3E}}
Provide a shell command Kodi will use to get CPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia and Raspberry Pi</u>
<syntaxhighlight lang=xml enclose="div">
<cputempcommand>sed -e 's/$[0-9]*$[0-9]\{3\}.*/\1 C/' /sys/class/thermal/thermal_zone0/temp</cputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang=xml enclose="div">
<cputempcommand>echo "$(sensors -u | tail -n64 | grep temp1_input | awk '{print $2 }' |awk '{printf("%d\n",$1 + 0.5);}') C"</cputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang=xml enclose="div">
<cputempcommand>sensors|sed -ne "s/temp1: \+[-+]$[0-9]\+$.*/\1 C/p"</cputempcommand>
</syntaxhighlight>

=== gputempcommand ===
{{anchor|.3Cgputempcommand.3E}}
Provide a shell command Kodi will use to get GPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia</u>
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>echo "$(nvidia-settings -tq gpuCoreTemp) C"</gputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>echo "$(nvidia-smi -q -d TEMPERATURE | grep Gpu | cut -c35-36) C"</gputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>/usr/bin/aticonfig --od-gettemperature | grep Temperature | cut -f 2 -d "-" | cut -f 1 -d "." | sed -e "s, ,," | sed 's/$/ C/'</gputempcommand>
</syntaxhighlight>

;<u>For Raspberry Pi</u>
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>/opt/vc/bin/vcgencmd measure_temp | sed -e "s/temp=//" -e "s/\..*'/ /"</gputempcommand>
</syntaxhighlight>

=== glrectanglehack ===
{{anchor|.3Cglrectanglehack.3E}}
Problems with ghosting or videos which are only played back in the left upper quarter? The following ATI hack may solve it.
<syntaxhighlight lang=xml enclose="div">
<glrectanglehack>yes</glrectanglehack>
</syntaxhighlight>

=== alwaysontop ===
{{anchor|.3Calwaysontop.3E}}
Added in XBMC v9.11 (Windows OS only). Keeps Kodi always on top when windowed.
<syntaxhighlight lang=xml enclose="div">
<alwaysontop>yes</alwaysontop>
</syntaxhighlight>

There is also a fake fullscreen GUI option in Kodi's settings.

== Removed tags ==
{{anchor|Recently removed tags}}
* {{anchor|.3Cthumbsize.3E}}'''<thumbsize>''' - replaced by <[[#imageres|imageres]]> in v12 Frodo
* {{anchor|.3Cfanartheight.3E}}'''<fanartheight>''' - replaced by <[[#fanartres|fanartres]]> in v12 Frodo
* {{anchor|.3Cdvdthumbs.3E}}'''<dvdthumbs>''' - removed in v12 Frodo
* {{anchor|.3Cbusydialogdelayms.3E}}'''<busydialogdelayms>''' - removed in v12 Frodo
* {{anchor|.3Cbginfoloadermaxthreads.3E}}'''<bginfoloadermaxthreads>''' - removed in v13 Gotham
* '''<showepginfoonselect>''' - replaced by a GUI setting in v13 Gotham
* '''<resample>''', '''<forceDirectSound>''', '''<audiophile>''', '''<audiosinkbufferdurationmsec>''', '''<allowtranscode44100>''', and '''<streamsilence>''' - These were various sub-tags for <audio> that were removed in v13 Gotham and either replaced by GUI settings or were no longer needed.
* {{anchor|.3Cenableairtunesdebuglog.3E}}'''<enableairtunesdebuglog>''' - replaced by a GUI option in v14 Helix
* '''<videoDisableHi10pMultithreading>''' - renamed to <disableswmultithreading> in v14 Helix
* '''<hideallitems>''' - For both the <code><videolibrary></code> and <code><musiclibrary></code> sections, this is replaced by a GUI option in v15 Isengard
* '''<SmallStepBackSeconds>''' - In v15 the <code>SmallStepBack</code> [[action ID]] has been replaced by <code>seek(-7)</code> in default keymaps. See '''[[skip steps]]''' for details. When the original <code>SmallStepBack</code> action ID is used it defaults to the first backwards [[skip steps|additive seeking value]].
* '''<timeseekforward>/<timeseekbackward>''' - In v15 these tags are replaced by GUI options via [[skip steps|additive seeking]], which is configured in the GUI. See '''[[skip steps]]''' for details.
* {{anchor|.3Ckaraoke.3E}}'''<karaoke>''' - In v16 all of the karaoke features in Kodi were removed.
* '''<useddsfanart>''' - removed in v17 Krypton.
* '''<cachemembuffersize>''' and '''<readbufferfactor>''' - In v17 '''<cachemembuffersize>''' is renamed to '''<memorysize>''' and <code><readbufferfactor></code> is renamed to <code><readfactor></code>. In addition, all three buffer related settings in <network> are moved out of <network> and into a new <cache> parent tag.
* '''<minvideocachelevel>''', '''<minaudiocachelevel>''', and '''<cacheindvdplayer>''' have been removed in v17.
* '''<useffmpegvda>''' - Tag was only used for development testing. Removed in v17.
* '''<nofliptimeout>''' - Removed in v17
* '''<blackbarcolour>''' - Removed in v17 (maybe?)
* '''<disableswmultithreading>''' - Removed in v17 (maybe?)
* {{anchor|.3Cmeasurerefreshrate.3E}}'''<measurerefreshrate>''' - Removed in v17 or v18?
* {{anchor|.3Cmyth.3E}}'''<myth>''' - Removed sometime between v16 to v18
* {{anchor|.3Ctuxbox.3E}}'''<tuxbox>''' - Removed
* '''<backgroundupdate>''' - Removed
* '''<hideemptyseries>''' - Replaced by a GUI option.
* '''<mymovies>''' and child tag '''<categoriestogenres>''' - Removed
* '''<albumssortbyartistthenyear'''> - Removed
* '''<albumformatright>''' - Removed
* {{anchor|.3Cremoterepeat.3E}}'''<remoterepeat>''' - Removed
* {{anchor|.3Callowd3d9ex.3E}}'''<allowd3d9ex>''' and {{anchor|.3Cforced3d9ex.3E}}'''<forced3d9ex>''' - Removed sometime between v16 to v18
* '''<lingertime>''' - Replaced by a GUI setting in v18
* '''<forcevaapienabled>''' - Removed in v18

== guisettings.xml settings ==
You can also define the settings normally defined in the GUI (and stored in guisettings.xml) in advancedsettings.xml. Most guisettings.xml settings defined in advancedsettings.xml will override the guisettings.xml values, and the settings will be removed completely from the interface.

The easiest way to include a guisettings.xml setting is to first change the setting in the interface to the value that you want, and then open the '''[[userdata]]/guisettings.xml''' file and find the XML entry that corresponds to that setting.

Then just add that entry to the advancedsettings.xml file.

For instance, to set the Font Character Set (found in the appearance setting, in the Look and Feel section), you'd open up guisettings.xml and find:

<syntaxhighlight lang=xml enclose="div">
<lookandfeel>
<charset>Hebrew (Windows)</charset>
</lookandfeel>
</syntaxhighlight>

Simply take that entry and place it in advancedsettings.xml. The option in Kodi's interface for the character set will then no longer be visible, and Kodi will always use the Hebrew (Windows) character set.

{{Updated|17}}
{{DISPLAYTITLE:advancedsettings.xml}}

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

Advancedsettings.xml

2019-02-06T09:55:32Z

Ksooo:

{{TOC right}}{{mininav|[[Settings]]|page=advancedsettings.xml}}
{{bigger|{{note|'''The advancedsettings.xml file does not exist by default. You have to create it first!'''}} }}

<section begin="intro" />The [[advancedsettings.xml]] file, which does not exist by default, can be created by a user in their '''[[userdata folder]]'''.

This file is used for advanced settings and options that do not have GUI controls inside of {{kodi}}. Some settings are experimental or very rarely set, so they can only be used via the advancedsettings.xml file. The file is simply a plain text file and can be edited by various text editors, so long as the name is "advancedsettings.xml". These advanced settings can be used to tweak various things such as episode naming patterns, special network ports, special behaviors, and more.<section end="intro" />

The following page will describe the structure of the advancedsettings.xml file and the various individual settings.

{{note|
# All XML tags must be lowercase. The start and end of the advancedsettings.xml file must have the <advancedsettings> and </advancedsettings> tags.
# Kodi will only read the advancedsettings.xml file when it starts up. If you make changes while it is running then you must restart Kodi.
# For some Windows versions, Kodi has two <code>\userdata\</code> folders. The correct one to put the advancedsettings.xml file in is not the one in Program Files, but in <code>%appdata%\Kodi\userdata\.</code>}}

== Layout ==

The layout of <code>advancedsettings.xml</code> is as follows:

<syntaxhighlight lang=xml enclose="div">
<advancedsettings>
<setting>value</setting>
...
<setting>value</setting>
</advancedsettings>
</syntaxhighlight>

where "setting" gives the name of the setting, and "value" gives its value.

A list of the available "setting" strings and their values is given below.

= List of available settings =

== Troubleshooting settings ==

=== loglevel ===
{{Anchor|.3Cloglevel.3E}}

<section begin="loglevel" />
Sets the logging level used to log errors and information. The "hide" attribute is optional.

<syntaxhighlight lang=xml>
<loglevel hide="attribute">options</loglevel>
</syntaxhighlight>

{| class="mw-collapsible mw-collapsed wikitable"
|-
! style="width:100px;" | Attribute
! style="width:500px;" | Action
|-
! '''true'''
| Hides the "enable debugging" setting in the Settings page. (default)
|-
! '''false'''
| Allows "enable debugging" setting to switch between '''0''' and '''2'''.
|}

{| class="mw-collapsible mw-collapsed wikitable"
|-
! style="width:100px;" | Option
! style="width:500px;" | Action
|-
! '''-1'''
| No logging, suppresses all log output
|-
! '''0'''
| Normal logging, only logging errors (default)
|-
! '''1'''
| Debug logging with freemem, fps and cpu usage (no on screen)
|-
! '''2'''
| Same as 1 (with on screen display)
|-
! '''3'''
| Same as 2 + full smb logging (no on screen display)
|}

{| class="mw-collapsible mw-collapsed wikitable"
|-
! style="width:100px;" | Example
! style="width:500px;" |
|-
! Example 1:
|<syntaxhighlight lang=xml enclose="div">
<advancedsettings>
<loglevel>2</loglevel>
</advancedsettings>
</syntaxhighlight>
|-
! Example 2:
|<syntaxhighlight lang=xml enclose="div">
<advancedsettings>
<loglevel hide="true">2</loglevel>
</advancedsettings>
</syntaxhighlight>
|}

'''Note:''' The setting is persistent through shutdown and restarts.<br>
'''Note:''' If debugging is enabled in the GUI, loglevel will be set to '''2'''. This will over-ride the <code>advancedsettings.xml</code> setting. You must disable the GUI Setting before adding the entry to <code>advancedsettings.xml</code>.<br />
<section end="loglevel" />
:''{{see also|Log_file|label 1=Debug Log}}''

=== jsonrpc ===
{{Anchor|.3Cjsonrpc.3E}}
To make it easier for developers using the [[JSON RPC]] API in their (third party) applications to debug during development the json output of Kodi can be prettified by setting '''compactoutput''' to '''false'''. Default json output mode is a compact print which does not contain any unnecessary whitespaces and therefore is difficult to read for humans.
Furthermore using the '''tcpport''' setting it is possible to change the default TCP port used by Kodi for JSON RPC (which is 9090) to any other valid port.

Example:
<syntaxhighlight lang=xml enclose="div">
<jsonrpc>
<compactoutput>false</compactoutput>
<tcpport>9999</tcpport>
</jsonrpc>
</syntaxhighlight>

== Audio/video playback settings ==

=== skiploopfilter ===
{{anchor|.3Cskiploopfilter.3E}}
The amount of the loop filter to skip on h.264 decoding. This can help the performance of slower machines when decoding h264 content. Values, in decreasing CPU usage (and decreasing quality)
* -16 None
* 0 Skip only empty frames (default)
* 8 Skip non-reference frames
* 16 Skip bi-dir frames
* 32 Skip all non-key frames
* 48 Skip all frames
Example:
<syntaxhighlight lang=xml enclose="div">
<skiploopfilter>8</skiploopfilter>
</syntaxhighlight>

=== video ===
{{anchor|.3Cvideo.3E}}

The <video> section also includes the following child-tags, which have their own sections:
*[[#cleandatetime]]
*[[#cleanstrings]]
*[[#excludefromscan]]
*[[#excludefromlisting]]
*[[#excludetvshowsfromscan]]

{{note|Some tags that have a "third-level" and are grouped together are highlighted in color.}}

{| class="prettytable"
! Tag !! Description
|-
|
<syntaxhighlight lang=xml>
<video>
</syntaxhighlight>
| Parent tag that all other child tags need to be placed inside of. Do not use more than one '''<code><video></code>''' tag, but instead place all other child-tags within a single '''<code><video></video></code>''' set.
|-
|
<syntaxhighlight lang=xml>
<subsdelayrange>10</subsdelayrange>
</syntaxhighlight>
| Delay range for subtitles, in seconds.
|-
|
<syntaxhighlight lang=xml>
<audiodelayrange>10</audiodelayrange>
</syntaxhighlight>
| Delay range for audio/video sync, in seconds.
|-
|
<syntaxhighlight lang=xml>
<usetimeseeking>true</usetimeseeking>
</syntaxhighlight>
| Whether to use time based or percentage based seeking. {{small see also|HOW-TO:Modify time seeking}}
|-
|
<syntaxhighlight lang=xml>
<timeseekforwardbig>600</timeseekforwardbig>
<timeseekbackwardbig>-600</timeseekbackwardbig>
</syntaxhighlight>
| Time to seek forward in seconds when doing a long seek. Defaults to 600 (10 minutes) and -600 (-10 minutes) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang=xml>
<percentseekforward>2</percentseekforward>
<percentseekbackward>-2</percentseekbackward>
</syntaxhighlight>
| Amount to seek forward as a percentage, when doing a short seek. Defaults to 2 (2%) and -2 (2%) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang=xml>
<percentseekforwardbig>10</percentseekforwardbig>
<percentseekbackwardbig>-10</percentseekbackwardbig>
</syntaxhighlight>
| Amount to seek forward as a percentage, when doing a long seek. Defaults to 10 (10%) and -10 (10%) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang=xml>
<fullscreenonmoviestart>true</fullscreenonmoviestart>
</syntaxhighlight>
| Whether to go to fullscreen or not when starting a movie. Defaults to true.
|-
|
<syntaxhighlight lang=xml>
<defaultplayer>VideoPlayer</defaultplayer>
</syntaxhighlight>
| Set the default video player: VideoPlayer or an external player. See '''[[External players]]''' for more info.
|-
|
<syntaxhighlight lang=xml>
<excludefromscan>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromscan>
</syntaxhighlight>
| Regular expressions that if evaluated to true won't be added to library. It is possible to add multiple <code><regexp></code> tags to match multiple patterns
|-
|
<syntaxhighlight lang=xml>
<excludefromlisting>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>
</syntaxhighlight>
| Regular expressions that if evaluated to true won't be displayed in files view.
|-
|
<syntaxhighlight lang=xml>
<playcountminimumpercent>90</playcountminimumpercent>
</syntaxhighlight>
| Minimum percentage that has to be played before it is marked as watched. Set to 101 to never auto-mark items as watched. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang=xml>
<ignoresecondsatstart>180</ignoresecondsatstart>
</syntaxhighlight>
| Number of seconds to ignore at video start after which a resume point is created. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang=xml>
<ignorepercentatend>8</ignorepercentatend>
</syntaxhighlight>
| Percentage of video to ignore at the end. If you stop watching the video here no resume point is created. Set to 101 to never save a resume point. The video is already marked as watched at 90%, see above. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang=xml>
<vdpauscaling>true</vdpauscaling>
</syntaxhighlight>
| Scales with vdpau instead of opengl and turns on its HQ scaler when available, enabling this might slow down rendering and cause framedrops especially on ION systems, this setting requires a vdpau feature set C GPU.
|-
|
<syntaxhighlight lang=xml>
<enablehighqualityhwscalers>true</enablehighqualityhwscalers>
</syntaxhighlight>
| Allow turning on the spline36 and lanczos3 shader (for GL builds).
|-
|
<syntaxhighlight lang=xml>
<dxvaallowhqscaling>false</dxvaallowhqscaling>
</syntaxhighlight>
| Enables high quality video upscaling for Windows.
|-
|
<syntaxhighlight lang=xml>
<ppffmpegdeinterlacing>linblenddeint</ppffmpegdeinterlacing>
</syntaxhighlight>
| Override the deinterlacing options passed to libpostproc.
|-
|
<syntaxhighlight lang=xml>
<ppffmpegpostprocessing>ha:128:7,va,dr</ppffmpegpostprocessing>
</syntaxhighlight>
| Override the post processing options passed to libpostproc when 'Video post-processing' is activated in GUI Videos-Settings-Playback.
|-
|
<syntaxhighlight lang=xml>
<autoscalemaxfps>30</autoscalemaxfps>
</syntaxhighlight>
| When scaling method is set to auto, bilinear is chosen when the fps is higher than this limit, the default is 30.
|-
|
<syntaxhighlight lang=xml>
<adjustrefreshrate>
</syntaxhighlight>
| style="background:#CADCFB;" | Settings for when "Adjust refreshrate to match video fps" is enabled in the video playback GUI settings.
|-
|
<syntaxhighlight lang=xml>
<override>
<fps>23.976</fps>
<refresh>60.0</refresh>
</override>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' "Adjust refreshrate to match video fps" will try to select the best refreshrate for the video fps but it doesn't always get it right, for example it might switch to an unsupported refreshrate. You can add overrides here to switch to a certain refreshrate based on video fps. It's possible to add as many overrides as you need. Overrides are processed in order, if the first one doesn't match the fps or no refreshrates match that override, it will try the next one until no overrides are left.

* '''fps''' - if the fps is between 23.966 and 23.986
* '''refresh''' - switch to the first found refreshrate that is between 59.99 and 60.01
|-
|
<syntaxhighlight lang=xml>
<override>
<fpsmin>29.96</fpsmin>
<fpsmax>30.01</fpsmax>
<refreshmin>59.0</refreshmin>
<refreshmax>61.0</refreshmax>
</override>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -'''
* '''fpsmin''' / '''fpsmin''' - You can also specify the fps range yourself.
* '''refreshmin''' / '''refreshmax''' - Same for the refreshrate
|-
|
<syntaxhighlight lang=xml>
<fallback>
<refresh>50.0</refresh>
</fallback>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' If none of the overrides match, or none of the refreshrates match any of the fps matching overrides, it will choose a fallback refreshrate. Fallbacks are process in order, if the first fallback doesn't match any refreshrate, it will try the next one until no fallbacks are left.

* '''refresh''' - Switch to the first found refreshrate that is between 49.99 and 50.01.
|-
|
<syntaxhighlight lang=xml>
<fallback>
<refreshmin>49.0</refreshmin>
<refreshmax>51.0</refreshmax>
</fallback>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' You can also specify the range for the fallback yourself.

If none of the overrides match the video fps, or no refreshrates match any of the fps matching overrides, and no fallbacks are specified or no refreshrates match any fallbacks, it will automatically choose the best refreshrate (same as having no overrides and fallbacks).
|-
|
<syntaxhighlight lang=xml>
</adjustrefreshrate>
</syntaxhighlight>
| style="background:#CADCFB;" |
|-
|
<syntaxhighlight lang=xml>
<checkdxvacompatibility>value</checkdxvacompatibility>
</syntaxhighlight>
| Advanced setting not present: let Kodi autodetect cards that support H.264 profile > L4.1. Set value to false to enable DXVA no matter what. Set value to true if Kodi doesn't autodetect that the graphics card doesn't support > L4.1.
|-
|
<syntaxhighlight lang=xml>
<useocclusionquery>-1</useocclusionquery>
</syntaxhighlight>
| Use an occlusion query when capturing videoframes, -1 means auto detect, 0 means disabled, 1 means enabled, the default is -1.
|-
|
<syntaxhighlight lang=xml>
<fpsdetect>1</fpsdetect>
</syntaxhighlight>
| FPS detection for video playback
* 0 = trust codec fps
* 1 = recalculate from video timestamps with uniform spacing
* 2 = recalculate from video timestamps always
|-
|
<syntaxhighlight lang=xml>
<latency>
</syntaxhighlight>
| style="background:#F0E68C;"| Start of '''latency''' tags. Display latency (video lag). Latency is given in msecs.
|-
|
<syntaxhighlight lang=xml>
<delay>0</delay>
</syntaxhighlight>
| style="background:#F0E68C;" | Global default display latency.
|-
|
<syntaxhighlight lang=xml>
<refresh></refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | Override latency for given display (not video) refresh rates. When Kodi is in windowed mode, override is ignored. Multiple overrides are allowed.

Syntax of an override entry:
<syntaxhighlight lang=xml>
<refresh>
<min>, <max> refresh rate range, OR
<rate> exact refresh rate
<delay> display latency for the given refresh rate
</refresh>
</syntaxhighlight>
|-
|
<syntaxhighlight lang=xml>
<refresh>
<min>23</min>
<max>24</max>
<delay>125</delay>
</refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | '''Example:''' display has 125 msec latency at 23-24 Hz
|-
|
<syntaxhighlight lang=xml>
<refresh>
<rate>50</rate>
<delay>50</delay>
</refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | '''Example:''' display has 50 msec latency at 50 (+/-0.01) Hz
|-
|
<syntaxhighlight lang=xml>
</latency>
</syntaxhighlight>
| style="background:#F0E68C;" |
|-
|
<syntaxhighlight lang=xml>
<stereoscopicregex3d>[-. _]3d[-. _]</stereoscopicregex3d>
<stereoscopicregexsbs>[-. _]h?sbs[-. _]</stereoscopicregexsbs>
<stereoscopicregextab>[-. _]h?tab[-. _]</stereoscopicregextab>
</syntaxhighlight>
| Filename triggers for 3D (stereoscopic) mode.
|-
|
<syntaxhighlight lang=xml>
<assfixedworks>false</assfixedworks>
</syntaxhighlight>
| Position behavior of ass subtitiles when setting "subtitle position on screen" set to "fixed". True to show at the fixed position set in video calibration. False to show at the bottom of video (default).
|-
|
<syntaxhighlight lang=xml>
</video>
</syntaxhighlight>
|
|}

=== audio ===
{{anchor|.3Caudio.3E}}
<syntaxhighlight lang=xml enclose="div">
<audio>

<headroom>0</headroom>

<defaultplayer>paplayer</defaultplayer>

<excludefromscan>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromscan>

<excludefromlisting>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromlisting>

<ac3downmixgain>12.0</ac3downmixgain>

<usetimeseeking>true</usetimeseeking>

<timeseekforwardbig>600</timeseekfowardbig>

<timeseekbackwardbig>-600</timeseekbackward>

<playcountminimumpercent>99</playcountminimumpercent>

<applydrc>-1.0</applydrc>

<limiterhold>0.025</limiterhold>

<limiterrelease>0.1</limiterrelease>
</audio>
</syntaxhighlight>

For more information on the configuration of audio under Frodo see [[AudioEngine/HOW-TO: Configure audio]]

=== edl ===
{{anchor|.3Cedl.3E}}
{{main|EDL}}
Commercial break detection not as good you think it could be? Are some commercial breaks in a series of adverts not being skipped? Are some parts being skipped that are clearly not commercials? Does the end of the previous recording still show? The following advanced settings can be used to better identify full commercial break sequences, remove incorrectly flagged commercial breaks, and have playback start at the actual beginning of the recording.

<syntaxhighlight lang=xml enclose="div">
<edl>

<mergeshortcommbreaks>false</mergeshortcommbreaks>

<maxcommbreaklength>250</maxcommbreaklength>

<mincommbreaklength>90</mincommbreaklength>

<maxcommbreakgap>120</maxcommbreakgap>

<commbreakautowait>0</commbreakautowait>

<commbreakautowind>0</commbreakautowind>
</edl>
</syntaxhighlight>

=== pvr ===
{{anchor|.3Cpvr.3E}}
<syntaxhighlight lang=xml enclose="div">
<pvr>
<timecorrection>0</timecorrection> 
<infotoggleinterval>3000</infotoggleinterval> 
<channeliconsautoscan>true</channeliconsautoscan> 
<autoscaniconsuserset>false</autoscaniconsuserset> 
<numericchannelswitchtimeout>1000</numericchannelswitchtimeout> 
</pvr>
</syntaxhighlight>

=== epg ===
{{anchor|.3Cpvr.3E}}
<syntaxhighlight lang=xml enclose="div">
<epg>
<updatecheckinterval>300</updatecheckinterval> 
<updateemptytagsinterval>60</updateemptytagsinterval> 
<cleanupinterval>900</cleanupinterval> 
<activetagcheckinterval>60</activetagcheckinterval> 
<retryinterruptedupdateinterval>60</retryinterruptedupdateinterval> 
<displayupdatepopup>true</displayupdatepopup> 
<displayincrementalupdatepopup>false</displayincrementalupdatepopup> 
</epg>
</syntaxhighlight>

=== forcedswaptime ===
{{anchor|.3Cforcedswaptime.3E}}
Use to force a backbuffer->frontbuffer swap while vsync is enabled. Set to the time (in ms) to allow for the swap (e.g. <forcedswaptime>1</forcedswaptime> is typical).

Default: Off



== Video library settings ==

=== videoextensions ===
{{anchor|.3Cvideoextensions.3E}}<section begin="videoextensions" />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Video windows.

Default extensions for VIDEOS:
<pre>
.m4v .3g2 .3gp .nsv .tp .ts .ty .strm .pls .rm .rmvb .mpd .m3u .m3u8 .ifo .mov .qt .divx .xvid
.bivx .vob .nrg .pva .wmv .asf .asx .ogm .m2v .avi .dat .mpg .mpeg .mp4 .mkv .mk3d .avc .vp3
.svq3 .nuv .viv .dv .fli .flv .001 .wpl .vdr .dvr-ms .xsp .mts .m2t .m2ts .evo .ogv .sdp .avs
.rec .url .pxml .vc1 .h264 .rcv .rss .mpls .webm .bdmv .wtv .trp .f4v
</pre>
Examples:
<pre>
<videoextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</videoextensions>
</pre>
<section end="videoextensions" />

=== discstubextensions ===
{{main|Media stubs}}

<section begin="discstubextensions" />
The default filename extension for Disc Stubs is:
<syntaxhighlight lang=xml enclose="div">
.disc
</syntaxhighlight>
Using the following tags, it is possible to <tt><add></tt> additional or <tt><remove></tt> existing disc stub extensions to better suit your requirements.
<syntaxhighlight lang=xml enclose="div">
<discstubextensions>
<add>.disk|.stub</add>
<remove>.disc</remove>
</discstubextensions>
</syntaxhighlight>
<section end="discstubextensions" />

=== languagecodes ===
{{anchor|.3Clanguagecodes.3E}}
Translation table for subtitle and audio names. Contains entries of the form

<syntaxhighlight lang=xml enclose="div">
<languagecodes>
<code>
<short>alt</short>
<long>Alternate</long>
</code>
</languagecodes>
</syntaxhighlight>

=== moviestacking ===
{{anchor|.3Cmoviestacking.3E}}<section begin="moviestacking" />
{{main|File stacking}}
This is used by the [[file stacking]] algorithm to combine multi-part files and contains a list of "''[[Regular Expression (RegEx) Tutorial|regular expressions]]''". For stacking videos that are contained in folders, such as VIDEO_TS folders, see '''[[advancedsettings.xml#folderstacking|<folderstacking>]]'''

As of v9.11, video stacking regular expressions '''must''' contain exactly four (4) capture expressions.

Default:
<syntaxhighlight lang=xml enclose="div">
<moviestacking>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[0-9]+)(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[a-d])(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ ._-]*[a-d])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="append"</tt> or <tt>append="yes"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the end.

Example:
<syntaxhighlight lang=xml enclose="div">
<moviestacking action="append">

<regexp>(.*?)([ ._-]*[0-9])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="prepend"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the beginning.

Example:
<syntaxhighlight lang=xml enclose="div">
<moviestacking action="prepend">
<regexp>(Title)(Volume)(Ignore)(Extension)</regexp>
</moviestacking>
</syntaxhighlight>

If no argument is supplied, or the argument <tt>append="no"</tt> is supplied, the default moviestacking regular expressions are overwritten by the user specified ones.
<section end="moviestacking" />

=== folderstacking ===
{{main|File stacking}}
This is similar to '''[[advancedsettings.xml#moviestacking|<moviestacking>]]''', but is used for videos that are contained in folders that use the folder names to stack, such as VIDEO_TS folders (DVD rips that are not in ISO format).

Default:
<syntaxhighlight lang=xml enclose="div">
<folderstacking>

<regexp>((cd|dvd|dis[ck])[0-9]+)$</regexp>
</folderstacking>
</syntaxhighlight>

=== cleandatetime ===
{{anchor|.3Ccleandatetime.3E}}
Matches a year number in a string using a ''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''

Default expression:
<syntaxhighlight lang=xml enclose="div">
<video>
<cleandatetime>(.+[^ _\,\.\[\]\-])[ _\.\[\]\-]+(19[0-9][0-9]|20[0-1][0-9])([ _\,\.\[\]\-][^0-9]|$)</cleandatetime>
</video>
</syntaxhighlight>
:* The string found before will be used as basis string getting cleaned by the cleanstrings expressions.
:* By default date formats like MM:YY are ignored.

=== cleanstrings ===
{{anchor|.3Ccleanstrings.3E}}
Clean unwanted characters from filenames or folders by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. Please note that everything right of the match (at the end of the file name) is removed, so if you would have a file named ''Super movie.mp4'' and would add <tt><regexp> </regexp></tt> (only a space), the only thing that would be left is ''Super'', which is probably not what you want.

Default expressions:
<syntaxhighlight lang=xml enclose="div">
<video>
<cleanstrings>
<regexp>[ _\,\.\[\]\-](ac3|dts|custom|dc|divx|divx5|dsr|dsrip|dutch|dvd|dvdrip|dvdscr|dvdscreener|screener|dvdivx|cam|fragment|fs|hdtv|hdrip|hdtvrip|internal|limited|multisubs|ntsc|ogg|ogm|pal|pdtv|proper|repack|rerip|retail|cd[1-9]|r3|r5|bd5|se|svcd|swedish|german|read.nfo|nfofix|unrated|ws|telesync|ts|telecine|tc|brrip|bdrip|480p|480i|576p|576i|720p|720i|1080p|1080i|hrhd|hrhdtv|hddvd|bluray|x264|h264|xvid|xvidvd|xxx|www.www|\[.*\])([ _\,\.\[\]\-]|$)</regexp>
<regexp>(\[.*\])</regexp>
</cleanstrings>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== tvshowmatching ===
{{anchor|.3Ctvshowmatching.3E}}
Matches the season and episode numbers in file paths by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

Defaults:
<syntaxhighlight lang=xml enclose="div">
<tvshowmatching>
<regexp>s([0-9]+)[ ._x-]*e([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)([^\\\\/]*)$</regexp> 
<regexp>[\._ -]()[Ee][Pp]_?([0-9]+)([^\\/]*)$</regexp> 
<regexp>([0-9]{4})[\.-]([0-9]{2})[\.-]([0-9]{2})</regexp> 
<regexp>([0-9]{2})[\.-]([0-9]{2})[\.-]([0-9]{4})</regexp> 
<regexp>[\\/\._ \[\(-]([0-9]+)x([0-9]+)([^\\/]*)$</regexp> 
<regexp>[\\/\._ -]([0-9]+)([0-9][0-9])([\._ -][^\\/]*)$</regexp> 
<regexp>[\/._ -]p(?:ar)?t[_. -]()([ivx]+)([._ -][^\/]*)$</regexp> 
</tvshowmatching>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)
:* Paths are converted to lower case before matching.
:* Examples of matching regexps for certain filenames can be found on the [[TV Shows (Video Library)|TV shows]] page.

:* For multi-episode matching to work, there needs to be a third set of parentheses '()' at the end, this part is fed back into the regexp engine.

:* A [https://forum.kodi.tv/showthread.php?tid=51614 forum thread] has a discussion of pre-made regex lists to match common names. These might improve Kodi's ability to match TV show names in some situations, at the risk of additional false positives.

==== Filenames without Season ====
There are two methods to add episodes without a season in their file path. Both ways will force the season to '1' by default, so that you can use
the 'Use Absolute Ordering (Single Season)' setting from the TheTvDb.com scraper.

; Simple Method ''(XBMC v9.11 onwards and Kodi)''
: Use only one pair of parentheses
<syntaxhighlight lang=xml enclose="div"><regexp>[/\._ \-]([0-9]+)</regexp></syntaxhighlight>
; Advanced Method ''(XBMC v10.05 onwards and Kodi)''
: Supports multi-episode files without season
: Use an empty pair of parentheses for the season
<syntaxhighlight lang=xml enclose="div"><regexp>[/\._ \-]()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

; Specifying Default Season ''(XBMC v12.0 onwards and Kodi)''
It is possible to set the default season for specific regular expressions by setting the 'defaultseason' attribute.
: Works with both the simple method and advanced method
: If not used, the season will be set to '1'
: Useful for setting specials to season '0'
<syntaxhighlight lang=xml enclose="div"><regexp defaultseason="0">[/\._ \-]X()([0-9]+)(-[0-9]+)?</regexp>
<regexp defaultseason="1">[/\._ \-]E()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

=== tvmultipartmatching ===
{{anchor|.3Ctvmultipartmatching.3E}}
Matches a multipart episode number based on a previously identified episode file, using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''.

Default:
<syntaxhighlight lang=xml enclose="div">
<tvmultipartmatching>^[-_ex]+([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)</tvmultipartmatching>
</syntaxhighlight>
:* Text matching is compared case-insensitive.
:* Specifying this option '''replaces''' the default value

=== excludefromscan ===
{{anchor|.3Cexcludefromscan.3E}}
Matches filenames or folders which should be excluded from a library scan (except tvshows) using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. This can be for both Video or Audio sections of <tt>advancedsettings.xml</tt>.

Defaults:
<syntaxhighlight lang=xml enclose="div">
<video>
<excludefromscan>
<regexp>-trailer</regexp>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludefromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== excludefromlisting ===
{{anchor|.3Cexcludefromlisting.3E}}
<syntaxhighlight lang=xml enclose="div">
<video>
<excludefromlisting> 
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>
</video>
</syntaxhighlight>

=== excludetvshowsfromscan ===
{{anchor|.3Cexcludetvshowsfromscan.3E}}
Matches filenames or folders which should be excluded from a tvshow library scan using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

Defaults:
<syntaxhighlight lang=xml enclose="div">
<video>
<excludetvshowsfromscan>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludetvshowsfromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== trailermatching ===
{{anchor|.3Ctrailermatching.3E}}
Contains "''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''" syntax (commonly referred to as "''[[Regular Expression (RegEx) Tutorial|RegEx]]''" or "''[[Regular Expression (RegEx) Tutorial|RegExp]]''") to match the locally stored trailers to movies in the library.

<syntaxhighlight lang=xml enclose="div">
<trailermatching>

<regexp>(.*?)(_Trailer)(\.[^.]+)$</regexp>
</trailermatching>
</syntaxhighlight>

=== videolibrary ===
{{anchor|.3Cvideolibrary.3E}}
Options specific to the Video Library

<syntaxhighlight lang=xml enclose="div">
<videolibrary>
<allitemsonbottom>false</allitemsonbottom> 
<cleanonupdate>false</cleanonupdate> 
<usefasthash>true</usefasthash> 
<recentlyaddeditems>35</recentlyaddeditems> 
<itemseparator> / </itemseparator> 
<exportautothumbs>false</exportautothumbs> 
<importwatchedstate>false</importwatchedstate> 
<importresumepoint>false</importresumepoint> 
<dateadded>1</dateadded> 
</videolibrary>
</syntaxhighlight>

==== Extra artwork ====

New for Kodi v18.
Configuration to expand the artwork automatically added by Kodi to media items in the library, either from local files or online scrapers.

The original basic artwork types are still hardcoded so they don't need to be configured here (and can't be removed). "poster" and "fanart" for movies, movie sets, TV shows, seasons, and music videos; "banner" for TV shows and seasons; and "thumb" for episodes.

<syntaxhighlight lang=xml enclose="div">
<videolibrary>


<tvshowextraart>
<arttype>characterart</arttype>
<arttype>clearart</arttype>
<arttype>clearlogo</arttype>
<arttype>landscape</arttype>
<arttype>keyart</arttype>
</tvshowextraart>

<tvseasonextraart>
<arttype>landscape</arttype>
</tvseasonextraart>

<episodeextraart>
<arttype>fanart</arttype>
</episodeextraart>

<movieextraart>
<arttype>banner</arttype>
<arttype>clearart</arttype>
<arttype>clearlogo</arttype>
<arttype>discart</arttype>
<arttype>landscape</arttype>
<arttype>keyart</arttype>
</movieextraart>

<moviesetextraart>
<arttype>banner</arttype>
<arttype>clearart</arttype>
<arttype>clearlogo</arttype>
<arttype>discart</arttype>
<arttype>landscape</arttype>
<arttype>keyart</arttype>
</moviesetextraart>

<musicvideoextraart>
<arttype>banner</arttype>
<arttype>clearart</arttype>
<arttype>clearlogo</arttype>
<arttype>discart</arttype>
<arttype>landscape</arttype>
</musicvideoextraart>
</videolibrary>
</syntaxhighlight>

=== videoscanner ===
{{anchor|.3Cvideoscanner.3E}}
Options specific to the Video scanner
<syntaxhighlight lang=xml enclose="div">
<videoscanner>
<ignoreerrors>true</ignoreerrors> 
</videoscanner>
</syntaxhighlight>

== Library artwork ==

{{note|Using <imageres>9999</imageres> and <fanartres>9999</fanartres> will allow caching artwork at original size.}}

=== imageres ===
{{anchor|.3Cimageres.3E}}

<section begin="imageres description" />Specify the maximum resolution that [[Artwork/Cache#Texture optimization| cached artwork]] (other than fanart / 16:9 images) should be resized to in pixels. The width is automatically calculated as being 16/9*height. The image will be resized to fit within this size. e.g. an image that is 2000x500 will be cached at size 1280x320. An image that is 500x800 will be cached at size 450x720 using the default value of 720.<section end="imageres description" />

<syntaxhighlight lang=xml enclose="div">
<imageres>720</imageres>
</syntaxhighlight>

=== fanartres ===
{{anchor|.3Cfanartres.3E}}

<section begin="fanartres description" />Specify the maximum resolution that [[Artwork/Cache#Texture optimization| cached fanart]] should be resized to in pixels. The width is automatically calculated as being 16/9*height. Only images that are exactly 16x9 and equal to or greater than this resolution will be cached at this size - all other images will be cached using <imageres>. The default value is 1080.<section end="fanartres description" />

<syntaxhighlight lang=xml enclose="div">
<fanartres>1080</fanartres>
</syntaxhighlight>

=== fanart ===
{{anchor|.3Cfanart.3E}}
Only used for music and not video.

A list of additional files to try when searching for local fanart images. (The defaults are fanart.jpg and fanart.png which can be removed.)

Example:
<syntaxhighlight lang=xml enclose="div">
<fanart>
<remove>fanart.jpg</remove>
<add>backdrop.jpg</add>
</fanart>
</syntaxhighlight>

=== musicthumbs ===
{{anchor|.3Cmusicthumbs.3E}}
<section begin="musicthumbs" />A list of additional files to try when searching for music thumbnail images. (The default is folder.jpg which can be removed.)

Example:
<syntaxhighlight lang=xml enclose="div">
<musicthumbs>
<remove>folder.jpg</remove>
<add>thumb.jpg|cover.jpg</add>
</musicthumbs>
</syntaxhighlight><section end="musicthumbs" />

=== imagescalingalgorithm ===
Specify the image scaling algorithm for image resizing when [[Artwork/Cache#Texture optimization| caching artwork]] to the local texture cache.
<br />
<syntaxhighlight lang=xml enclose="div">
<imagescalingalgorithm>bicubic</imagescalingalgorithm>
</syntaxhighlight>

[https://github.com/xbmc/xbmc/blob/1a8753d5cd93890dc6a9f9d4b2ce8848066ea5d0/xbmc/pictures/PictureScalingAlgorithm.cpp#L32-L43 Available image scaling algorithms]

<syntaxhighlight lang=text enclose="div">
fast_bilinear
bilinear
bicubic
experimental
nearest_neighbor
averaging_area
bicublin
gaussian
sinc
lanczos
bicubic_spline
</syntaxhighlight>

== Video and music library settings ==

=== playlistasfolders ===
{{anchor|.3Cplaylistasfolders.3E}}
In the recent releases, playlists are treated as folders. Selecting a playlist no longer plays it, but opens it, as if it were a folder.

Set to false to revert to the previous behaviour. When you select a playlist, its content is added to the list of elements to be played.

:{{note|This setting will not affect smart playlists, they will always show as folders.}}

;Example
<syntaxhighlight lang=xml enclose="div">
<playlistasfolders>true</playlistasfolders>
</syntaxhighlight>

=== playlistretries ===
{{anchor|.3Cplaylistretries.3E}}
The number of retries attempted if a source is offline. With this control you can alter the number of consecutive failed items before a playlist fails.

Default:
<syntaxhighlight lang=xml enclose="div">
<playlistretries>100</playlistretries>
</syntaxhighlight>

=== playlisttimeout ===
{{anchor|.3Cplaylisttimeout.3E}}
The timeout, in seconds, before item failure.

Default:
<syntaxhighlight lang=xml enclose="div">
<playlisttimeout>20</playlisttimeout>
</syntaxhighlight>

=== sorttokens ===
Allows you to specify additional tokens that will be ignored at the start of lines during sorting.
{{note|Sort tokens are case sensitive.}}
<syntaxhighlight lang=xml enclose="div">
<sorttokens>
<token>the</token>
</sorttokens>
</syntaxhighlight>

In the above example "the ", "the." and "the_" will be ignored at the start of titles or names when sorting items, in both video and music libraries. A separator can also be specified, for example
<syntaxhighlight lang=xml enclose="div">
<sorttokens>
<token separators="'">L</token>
</sorttokens>
</syntaxhighlight>
In that case the value L', as in French movie name ''L'argent'', will be ignored and the item listed under "A".

=== musicdatabase/videodatabase ===
{{anchor|.3Cmusicdatabase.3E/.3Cvideodatabase.3E|musicdatabase/videodatabase|database tags music/video/tv/epg/adsp}}
{{main|MySQL}}
<section begin="videodatabase" />
Allows advanced customization of the default database settings for music, video, TV, EPG, and ADSP databases.

:{{note| '''It is HIGHLY recommended that you not attempt to place an sqlite3 database outside of kodi's path. sqlite3 contains no filesystem abstraction, so this will plain break on any non-local (as far as Kodi is concerned) paths. Use this for mysql only.'''}}

'''Parent tags:'''

* '''<videodatabase>'''
* '''<musicdatabase>'''
* '''<tvdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
* '''<epgdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
* '''<adspdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
{{MySQL warning}}

'''Child tags: '''

;<type>
: ''Required'' - Can be either "sqlite3" or "mysql" (default: sqlite3)

;<host>
:''Required'' -
* sqlite3: defines the relative path to the database file (eg. /usr/local/kodi/databases).
* mysql: defines the host of the mysql socket (eg. localhost, 192.168.0.1, etc)

;<port>
: ''Optional'' -
* sqlite3: silently ignored
* mysql: defines the port of the mysql socket (default: 3306)

;<name>
: ''Optional'' -
:by default "MyVideos"+DB number will be used.
* sqlite3: defines the name of the database file to read from, excluding the ".db" extension.
* mysql: defines the name of the database to use

;<user>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the user with privileged access to the database

;<pass>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the password for the user with privileged access to the database

;<compression>
: ''Optional'' - Defaults to false. Set to "true" to enable MySQL compression protocol. Performance benefit is going to be largely dependent on the network bandwidth, latency between database and clients and on the size of the result sets. [https://github.com/xbmc/xbmc/pull/6484]
: {{Note|Slower clients (such as the RPi and others) won't benefit from it as the zlib de-compression overhead is higher than the actual compression savings}}

;<key>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<cert>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ca>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<capath>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ciphers>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

'''Examples:'''

1) Configure a database for MySQL.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', '''<epgdatabase>''', and '''<adspdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang=xml enclose="div">
<videodatabase>
<type>mysql</type>
<host>192.168.0.10</host>
<name>kodi_video</name>
<user>kodi</user>
<pass>kodi</pass>
</videodatabase>
</syntaxhighlight>

2) Configure a database for an sqlite database.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', '''<epgdatabase>''', and '''<adspdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang=xml enclose="div">
<musicdatabase>
<type>sqlite3</type>
<host>/usr/local/share/kodi/databases</host>
</musicdatabase>
</syntaxhighlight>

<section end="videodatabase" />

=== externalplayer ===
{{anchor|.3Cexternalplayer.3E}}
{{see|External players}}

== Music settings ==

=== musicextensions ===
{{anchor|.3Cmusicextensions.3E}}
<section begin="musicextensions" />
Default extensions for MUSIC:
<pre>
.nsv .m4a .flac .aac .strm .pls .rm .rma .mpa .wav .wma .ogg .mp3 .mp2 .m3u .gdm .imf .m15 .sfx
.uni .ac3 .dts .aif .aiff .wpl .ape .mac .mpc .mp+ .mpp .shn .wv .dsp .xsp .xwav .waa .wvs .wam
.gcm .idsp .mpdsp .mss .spt .rsd .sap .cmc .cmr .dmc .mpt .mpd .rmt .tmc .tm8 .tm2 .oga .url
.pxml .tta .rss .wtv .mka .tak .opus .dff .dsf .m4b .cue .zip .rar
</pre>

It is possible to add or remove extensions for Music, using the following XML tags. Useful if you keep, say, FLAC and mp3 versions of music in the same folder. The <remove> tag can be used to remove mp3 from being listed in the library, leaving only the higher quality FLAC being displayed.

<musicextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</musicextensions>

<section end="musicextensions" />

=== cddbaddress ===
{{anchor|.3Ccddbaddress.3E}}
The address of the online CDDb database. You may set this to another freedb mirror if there is a more suitable one.

Default:
<syntaxhighlight lang=xml enclose="div>
<cddbaddress>freedb.freedb.org</cddbaddress>
</syntaxhighlight>

=== songinfoduration ===
{{anchor|.3Csonginfoduration.3E}}
This controls how long the song information will remain onscreen when the song changes during visualisations. The valid range is "1" to "Indefinite (0)", in seconds. This does not include the duration of any transition effects.

Default:
<syntaxhighlight lang=xml enclose="div">
<songinfoduration>10</songinfoduration>
</syntaxhighlight>

=== musicfilenamefilters ===
{{anchor|.3Cmusicfilenamefilters.3E}}
Contains filters to match music information (artist, title etc.) from a tag-less music filename. The first <filter> to match completely is used. Matched items include:

<pre>
%A - Artist
%T - Title
%B - Album
%N - Track number
%S - Part of set (disk number)
%D - Duration
%G - Genre
%Y - Year
%R - Rating
</pre>

Example:
<syntaxhighlight lang=xml enclose="div">
<musicfilenamefilters>
<filter>%A - %T</filter>
</musicfilenamefilters>
</syntaxhighlight>

=== musiclibrary ===
Options specific to the Music Library
<section begin="MusicLibrary" />
<syntaxhighlight lang="xml" line='line'>
<musiclibrary>
<allitemsonbottom>true</allitemsonbottom> 
<cleanonupdate>false</cleanonupdate> 
<recentlyaddeditems>35</recentlyaddeditems> 
<albumformat>%B - %Y</albumformat> 
<prioritiseapetags>true</prioritiseapetags> 
<itemseparator> / </itemseparator> 
<artistseparators> 
<separator>;</separator>
<separator>:</separator>
<separator>|</separator>
<separator> feat. </separator>
<separator> ft. </separator>
</artistseparators>
<dateadded>1</dateadded> 


<promptfulltagscan>false</promptfulltagscan> 
<useartistsortname>false</useartistsortname> 
</musiclibrary>
</syntaxhighlight>
{{Note|Changing the <itemseparator> or <artistseparators> will only affect newly added items. A rescan won't change the existing ones. Remove the Source(s) or delete the Music DB and rebuild. This process should be made easier from v18 and up using <promptfulltagscan>}}<section end="MusicLibrary" />

==== Music library extra artwork ====

New for Kodi v18.
Configuration to expand the artwork automatically added by Kodi to media items in the library, either from local files or online scrapers.

The original basic artwork types are still hardcoded so they don't need to be configured here (and can't be removed). "thumb" for artists and albums, and "fanart" for artists.

<syntaxhighlight lang=xml enclose="div">
<musiclibrary>


<artistextraart>
<arttype>banner</arttype>
<arttype>clearlogo</arttype>
<arttype>clearart</arttype>
<arttype>landscape</arttype>
</artistextraart>

<albumextraart>
<arttype>discart</arttype>
<arttype>spine</arttype>
<arttype>back</arttype>
</albumextraart>
</musiclibrary>
</syntaxhighlight>

== Photos settings ==

=== pictureextensions ===
{{anchor|.3Cpictureextensions.3E}}
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Pictures window.

Default extensions for PICTURES:
<pre>
.png .jpg .jpeg .bmp .gif .ico .tif .tiff .tga .pcx .cbz .cbr .rss .webp .jp2 .apng
</pre>

Examples:
<syntaxhighlight lang=xml enclose="div">
<pictureextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</pictureextensions>
</syntaxhighlight>

=== pictureexcludes ===
{{anchor|.3Cpictureexcludes.3E}}
Matches filenames or folders which should be excluded from being displayed in My Pictures using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

<syntaxhighlight lang=xml enclose="div">
<pictureexcludes> 
<regexp>small</regexp>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</pictureexcludes>
</syntaxhighlight>

=== slideshow ===
{{anchor|.3Cslideshow.3E}}
<syntaxhighlight lang=xml enclose="div">
<slideshow>

<panamount>2.5</panamount>

<zoomamount>5.0</zoomamount>



<blackbarcompensation>20</blackbarcompensation>
</slideshow>
</syntaxhighlight>

== Network settings ==

=== samba ===
{{anchor|.3Csamba.3E}}
<syntaxhighlight lang=xml enclose="div">
<samba>
<doscodepage></doscodepage> 
<clienttimeout>10</clienttimeout> 
<statfiles>true</statfiles> 
</samba>
</syntaxhighlight>

=== hosts ===
{{anchor|.3Cfhosts.3E}}
Static dns entries which take precedence over your dns server.
<syntaxhighlight lang=xml enclose="div">
<hosts>
<entry name="HOSTNAME">IPADDRESS</entry>
</hosts>
</syntaxhighlight>

=== network ===
{{anchor|.3Cnetwork.3E}}

<syntaxhighlight lang=xml enclose="div">
<network>
<curlclienttimeout>10</curlclienttimeout> 
<curllowspeedtime>20</curllowspeedtime> 
<curlretries>2</curlretries> 
<httpproxyusername></httpproxyusername> 
<httpproxypassword></httpproxypassword> 
</network>
</syntaxhighlight>

{{Note|In Kodi v17, the three buffer settings are removed from the <code><network></code> tag and now placed under the new <code><cache></code> tag. See '''[[#cache]]''' for full details.}}

=== cache ===
{{see also|HOW-TO:Modify the cache}}
<syntaxhighlight lang=xml enclose="div">
<cache>
<memorysize>0</memorysize> 
<buffermode>0</buffermode> 
<readfactor>4.0</readfactor> 
</cache>
</syntaxhighlight>

=== airtunesport ===
{{anchor|.3Cairtunesport.3E}}<section begin="airtunesport" />
This overwrites the defalt listening port of the AirTunes server (announced via zeroconf).
<section end="airtunesport" />

=== airplayport ===
{{anchor|.3Cairplayport.3E}}<section begin="airplayport" />
This overwrites the default listening port of the AirPlay server (announced via zeroconf).
<section end="airplayport" />

== File system settings ==

=== packagefoldersize ===
<section begin="packagefoldersize" />
{{anchor|.3Cpackagefoldersize.3E}}
{{xml setting
| tag name = packagefoldersize
| option type = numerical
| option values =
| default values = 200
| platform = all
| XBMC version = 12
| description = The amount (in megabytes) of add-on zip packages saved from previous add-on installs. These packages are mainly used for the [[add-on]] rollback feature. Increasing the size should increase the amount of past versions saved. Defaults to 200 MB.
| example = Example: <syntaxhighlight lang=xml enclose="div"><packagefoldersize>200</packagefoldersize> </syntaxhighlight>
}}
<section end="packagefoldersize" />

=== detectasudf ===
{{anchor|.3Cdetectasudf.3E}}
Set to true if you wish to detect joint ISO9660/UDF disks as UDF.

Default: False

=== pathsubstitution ===
{{anchor|.3Cpathsubstitution.3E}}
{{main|Path substitution}}

{{divbox|red||'''Note:''' Path substition for "sources" and profiles is broken, and will '''NOT''' be fixed.}}

Path substitutions are for use for redirecting file paths. These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for Kodi to handle.

Default: No path substitutions defined.

Example:
<syntaxhighlight lang=xml enclose="div">
<pathsubstitution>
<substitute>
<from>G:\dvds\</from>
<to>smb://somecomputer/g-share/dvds/</to> 
</substitute>
</pathsubstitution>
</syntaxhighlight>

== Input control settings ==

=== remotedelay ===
{{anchor|.3Cremotedelay.3E}}
The repeat delay for a LIRC remote control. A delay value between 1 and 20 before a remote button starts repeating on a long keypress (i.e. continuously sending button pushes while it's held down).

Default: 3
<syntaxhighlight lang=xml enclose="div">
<remotedelay>10</remotedelay>
</syntaxhighlight>

=== controllerdeadzone ===
{{anchor|.3Ccontrollerdeadzone.3E}}
This advanced settings has been removed. See [[HOW-TO:Controller deadzone]].

=== enablemultimediakeys ===
{{anchor|.3Cenablemultimediakeys.3E}}
This setting only has any effect on Windows versions of Kodi, and only applies to builds from 28th May 2011 onwards.
In Windows the multimedia keys generate a WM_APPCOMMAND message in addition the keypress. Kodi processes both keypresses and the WM_APPCOMMAND messages, and the end result would be that the command is executed twice. To avoid this, by default multimedia keypresses are disabled. Although it should rarely be necessary, the enablemultimediakeys setting allows you to enable the multimedia keys.

Example:
<syntaxhighlight lang=xml enclose="div">
<enablemultimediakeys>true</enablemultimediakeys>
</syntaxhighlight>

=== seeksteps ===
{{Main|Skip steps}}

This setting changes which increments are available in the settings GUI for additive seeking. Note that <code><seeksteps></code> is not used to actually choose which seek steps are enabled.

'''Default:'''
<syntaxhighlight lang=xml enclose="div">
<seeksteps>7, 15, 30, 60, 180, 300, 600, 900, 1800</seeksteps>
</syntaxhighlight>

{{editor note|the defaults need to be updated for seeksteps.}}

=== touchscreen ===
{{anchor|.3Ctouchscreen.3E}}
This setting allows you to move/align the origin of the touch screen with the origin of the display used. If touch input does not result in a correct movement of the mouse pointer, the behaviour can be corrected with an offset and a stretch/compress factor.

Example:
<syntaxhighlight lang=xml enclose="div">
<touchscreen>
<x_offset>0</x_offset> 
<y_offset>0</y_offset> 
<x_stretch_factor>1.0</x_stretch_factor> 
<y_stretch_factor>1.0</y_stretch_factor> 
</touchscreen>
</syntaxhighlight>

== Other interface settings ==

=== window ===
{{anchor|.3Cwindow.3E}}
{{note|This is a "hidden" guisettings.xml setting (defined by the mouse moving the window size), but it is mentioned here because it is a particularly useful override when used in advancedsettings.xml}}
This allows you to manually set the default size of Kodi's windowed mode. If you resize the window, it will return to the set size when restarting.

WIDTH and HEIGHT are the values for each dimension, in pixels.

<syntaxhighlight lang=xml enclose="div">
<window>
<width>WIDTH</width>
<height>HEIGHT</height>
</window>
</syntaxhighlight>

=== restrictcapsmask ===
{{anchor|.3Crestrictcapsmask.3E}}
Windows only. A bitmask to prevent Kodi from using detected texture capabilities of the GPU. This helps work around buggy hardware/drivers.

1: prevent the use of compressed textures (DXT1, DXT3, DXT5)
2: prevent the use of non-power-of-two dimensions for textures
4: prevent the use of compressed textures with non-power-of-two dimensions.

<syntaxhighlight lang=xml enclose="div">
<restrictcapsmask>0</restrictcapsmask>
</syntaxhighlight>

=== algorithmdirtyregions ===
{{anchor|.3Calgorithmdirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="algorithmdirtyregions" />{{note|Some GPU/hardware configurations will have some minor issues (such as a visual "flicker"). For those situations try mode 2 or use the default (mode 3, which requires no advancedsetting). Almost all ARM-based devices (such as [[Android]]) willl likely have flickering issues.}}

Enable dirty-region processing. Dirty regions are any parts of the screen that have changed since the last frame. By not re-rendering what hasn't changed the GUI can be sped up. Because all GPUs work differently, only Mode 3, combined with nofliptimeout=0, is guaranteed to work for everyone without flickering issues. This mode will reduce CPU/GPU usage, but will not increase GUI speed.

{| class="prettytable"
! value !! result !! description
|-
! 0
| Off
| The entire viewport is always rendered.
|-
! 1
|Union
|All dirty regions are grouped into the smallest possible rectangle. This is typically the fastest mode for slower GPUs due to only making one pass.
|-
! 2
| {{nowrap|Cost reduction}}
| Each dirty region is presented separately, in as many passes as there are regions.
|-
! 3
| {{nowrap|Whole Screen}}
| The entire screen is rendered if there are any dirty regions. This, combined with nofliptimeout is a safe default for drivers that clear buffer contents (manifests as blinking or vibrating images). '''Default'''
|}<section end="algorithmdirtyregions" />

Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<algorithmdirtyregions>1</algorithmdirtyregions>
</gui>
</syntaxhighlight>

=== visualizedirtyregions ===
{{anchor|.3Cvisualizedirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="visualizedirtyregions" />Enable dirty-region visualization. Paints a rectangle over marked controls.

* true: on
* false: off '''(Default)'''

{{note|This is only a development mode and isn't of use to normal users.}}
<section end="visualizedirtyregions" />
Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<visualizedirtyregions>true</visualizedirtyregions>
</gui>
</syntaxhighlight>

=== smartredraw ===

{{note|This is an experimental feature and you might face issues using it. So please be aware of that.}}

This new feature was introduced in Kodi 18 and if enabled, the GUI process call (and therefore the render call) is only done if anything has changed. The result will be a faster GUI and less load if Kodi plays a video

* true: on
* false: off '''(Default)'''

Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<smartredraw>true</smartredraw>
</gui>
</syntaxhighlight>

=== showexitbutton ===
{{anchor|.3Cshowexitbutton.3E}}
Setting to hide the exit button, useful for people running appliance based setups where exit would only confuse/complicate the user. Modifiable via the advancedsettings.xml by setting showexitbutton to false, default is true (show)

Example:
<syntaxhighlight lang=xml enclose="div">
<showexitbutton>true</showexitbutton>
</syntaxhighlight>

=== fullscreen ===
{{anchor|.3Cfullscreen.3E}}
Starts Kodi in full screen (check resolutions!).

<syntaxhighlight lang=xml enclose="div">
<fullscreen>false</fullscreen>
</syntaxhighlight>

=== splash ===
{{anchor|.3Csplash.3E}}
Set to false if you wish to disable the startup splash image. Defaults to true.

<syntaxhighlight lang=xml enclose="div">
<splash>true</splash>
</syntaxhighlight>

=== cputempcommand ===
{{anchor|.3Ccputempcommand.3E}}
Provide a shell command Kodi will use to get CPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia and Raspberry Pi</u>
<syntaxhighlight lang=xml enclose="div">
<cputempcommand>sed -e 's/$[0-9]*$[0-9]\{3\}.*/\1 C/' /sys/class/thermal/thermal_zone0/temp</cputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang=xml enclose="div">
<cputempcommand>echo "$(sensors -u | tail -n64 | grep temp1_input | awk '{print $2 }' |awk '{printf("%d\n",$1 + 0.5);}') C"</cputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang=xml enclose="div">
<cputempcommand>sensors|sed -ne "s/temp1: \+[-+]$[0-9]\+$.*/\1 C/p"</cputempcommand>
</syntaxhighlight>

=== gputempcommand ===
{{anchor|.3Cgputempcommand.3E}}
Provide a shell command Kodi will use to get GPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia</u>
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>echo "$(nvidia-settings -tq gpuCoreTemp) C"</gputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>echo "$(nvidia-smi -q -d TEMPERATURE | grep Gpu | cut -c35-36) C"</gputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>/usr/bin/aticonfig --od-gettemperature | grep Temperature | cut -f 2 -d "-" | cut -f 1 -d "." | sed -e "s, ,," | sed 's/$/ C/'</gputempcommand>
</syntaxhighlight>

;<u>For Raspberry Pi</u>
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>/opt/vc/bin/vcgencmd measure_temp | sed -e "s/temp=//" -e "s/\..*'/ /"</gputempcommand>
</syntaxhighlight>

=== glrectanglehack ===
{{anchor|.3Cglrectanglehack.3E}}
Problems with ghosting or videos which are only played back in the left upper quarter? The following ATI hack may solve it.
<syntaxhighlight lang=xml enclose="div">
<glrectanglehack>yes</glrectanglehack>
</syntaxhighlight>

=== alwaysontop ===
{{anchor|.3Calwaysontop.3E}}
Added in XBMC v9.11 (Windows OS only). Keeps Kodi always on top when windowed.
<syntaxhighlight lang=xml enclose="div">
<alwaysontop>yes</alwaysontop>
</syntaxhighlight>

There is also a fake fullscreen GUI option in Kodi's settings.

== Removed tags ==
{{anchor|Recently removed tags}}
* {{anchor|.3Cthumbsize.3E}}'''<thumbsize>''' - replaced by <[[#imageres|imageres]]> in v12 Frodo
* {{anchor|.3Cfanartheight.3E}}'''<fanartheight>''' - replaced by <[[#fanartres|fanartres]]> in v12 Frodo
* {{anchor|.3Cdvdthumbs.3E}}'''<dvdthumbs>''' - removed in v12 Frodo
* {{anchor|.3Cbusydialogdelayms.3E}}'''<busydialogdelayms>''' - removed in v12 Frodo
* {{anchor|.3Cbginfoloadermaxthreads.3E}}'''<bginfoloadermaxthreads>''' - removed in v13 Gotham
* '''<showepginfoonselect>''' - replaced by a GUI setting in v13 Gotham
* '''<resample>''', '''<forceDirectSound>''', '''<audiophile>''', '''<audiosinkbufferdurationmsec>''', '''<allowtranscode44100>''', and '''<streamsilence>''' - These were various sub-tags for <audio> that were removed in v13 Gotham and either replaced by GUI settings or were no longer needed.
* {{anchor|.3Cenableairtunesdebuglog.3E}}'''<enableairtunesdebuglog>''' - replaced by a GUI option in v14 Helix
* '''<videoDisableHi10pMultithreading>''' - renamed to <disableswmultithreading> in v14 Helix
* '''<hideallitems>''' - For both the <code><videolibrary></code> and <code><musiclibrary></code> sections, this is replaced by a GUI option in v15 Isengard
* '''<SmallStepBackSeconds>''' - In v15 the <code>SmallStepBack</code> [[action ID]] has been replaced by <code>seek(-7)</code> in default keymaps. See '''[[skip steps]]''' for details. When the original <code>SmallStepBack</code> action ID is used it defaults to the first backwards [[skip steps|additive seeking value]].
* '''<timeseekforward>/<timeseekbackward>''' - In v15 these tags are replaced by GUI options via [[skip steps|additive seeking]], which is configured in the GUI. See '''[[skip steps]]''' for details.
* {{anchor|.3Ckaraoke.3E}}'''<karaoke>''' - In v16 all of the karaoke features in Kodi were removed.
* '''<useddsfanart>''' - removed in v17 Krypton.
* '''<cachemembuffersize>''' and '''<readbufferfactor>''' - In v17 '''<cachemembuffersize>''' is renamed to '''<memorysize>''' and <code><readbufferfactor></code> is renamed to <code><readfactor></code>. In addition, all three buffer related settings in <network> are moved out of <network> and into a new <cache> parent tag.
* '''<minvideocachelevel>''', '''<minaudiocachelevel>''', and '''<cacheindvdplayer>''' have been removed in v17.
* '''<useffmpegvda>''' - Tag was only used for development testing. Removed in v17.
* '''<nofliptimeout>''' - Removed in v17
* '''<blackbarcolour>''' - Removed in v17 (maybe?)
* '''<disableswmultithreading>''' - Removed in v17 (maybe?)
* {{anchor|.3Cmeasurerefreshrate.3E}}'''<measurerefreshrate>''' - Removed in v17 or v18?
* {{anchor|.3Cmyth.3E}}'''<myth>''' - Removed sometime between v16 to v18
* {{anchor|.3Ctuxbox.3E}}'''<tuxbox>''' - Removed
* '''<backgroundupdate>''' - Removed
* '''<hideemptyseries>''' - Replaced by a GUI option.
* '''<mymovies>''' and child tag '''<categoriestogenres>''' - Removed
* '''<albumssortbyartistthenyear'''> - Removed
* '''<albumformatright>''' - Removed
* {{anchor|.3Cremoterepeat.3E}}'''<remoterepeat>''' - Removed
* {{anchor|.3Callowd3d9ex.3E}}'''<allowd3d9ex>''' and {{anchor|.3Cforced3d9ex.3E}}'''<forced3d9ex>''' - Removed sometime between v16 to v18
* '''<lingertime>''' - Replaced by a GUI setting in v18
* '''<forcevaapienabled>''' - Removed in v18

== guisettings.xml settings ==
You can also define the settings normally defined in the GUI (and stored in guisettings.xml) in advancedsettings.xml. Most guisettings.xml settings defined in advancedsettings.xml will override the guisettings.xml values, and the settings will be removed completely from the interface.

The easiest way to include a guisettings.xml setting is to first change the setting in the interface to the value that you want, and then open the '''[[userdata]]/guisettings.xml''' file and find the XML entry that corresponds to that setting.

Then just add that entry to the advancedsettings.xml file.

For instance, to set the Font Character Set (found in the appearance setting, in the Look and Feel section), you'd open up guisettings.xml and find:

<syntaxhighlight lang=xml enclose="div">
<lookandfeel>
<charset>Hebrew (Windows)</charset>
</lookandfeel>
</syntaxhighlight>

Simply take that entry and place it in advancedsettings.xml. The option in Kodi's interface for the character set will then no longer be visible, and Kodi will always use the Hebrew (Windows) character set.

{{Updated|17}}
{{DISPLAYTITLE:advancedsettings.xml}}

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

Advancedsettings.xml

2019-02-06T09:53:54Z

Ksooo:

{{TOC right}}{{mininav|[[Settings]]|page=advancedsettings.xml}}
{{bigger|{{note|'''The advancedsettings.xml file does not exist by default. You have to create it first!'''}} }}

<section begin="intro" />The [[advancedsettings.xml]] file, which does not exist by default, can be created by a user in their '''[[userdata folder]]'''.

This file is used for advanced settings and options that do not have GUI controls inside of {{kodi}}. Some settings are experimental or very rarely set, so they can only be used via the advancedsettings.xml file. The file is simply a plain text file and can be edited by various text editors, so long as the name is "advancedsettings.xml". These advanced settings can be used to tweak various things such as episode naming patterns, special network ports, special behaviors, and more.<section end="intro" />

The following page will describe the structure of the advancedsettings.xml file and the various individual settings.

{{note|
# All XML tags must be lowercase. The start and end of the advancedsettings.xml file must have the <advancedsettings> and </advancedsettings> tags.
# Kodi will only read the advancedsettings.xml file when it starts up. If you make changes while it is running then you must restart Kodi.
# For some Windows versions, Kodi has two <code>\userdata\</code> folders. The correct one to put the advancedsettings.xml file in is not the one in Program Files, but in <code>%appdata%\Kodi\userdata\.</code>}}

== Layout ==

The layout of <code>advancedsettings.xml</code> is as follows:

<syntaxhighlight lang=xml enclose="div">
<advancedsettings>
<setting>value</setting>
...
<setting>value</setting>
</advancedsettings>
</syntaxhighlight>

where "setting" gives the name of the setting, and "value" gives its value.

A list of the available "setting" strings and their values is given below.

= List of available settings =

== Troubleshooting settings ==

=== loglevel ===
{{Anchor|.3Cloglevel.3E}}

<section begin="loglevel" />
Sets the logging level used to log errors and information. The "hide" attribute is optional.

<syntaxhighlight lang=xml>
<loglevel hide="attribute">options</loglevel>
</syntaxhighlight>

{| class="mw-collapsible mw-collapsed wikitable"
|-
! style="width:100px;" | Attribute
! style="width:500px;" | Action
|-
! '''true'''
| Hides the "enable debugging" setting in the Settings page. (default)
|-
! '''false'''
| Allows "enable debugging" setting to switch between '''0''' and '''2'''.
|}

{| class="mw-collapsible mw-collapsed wikitable"
|-
! style="width:100px;" | Option
! style="width:500px;" | Action
|-
! '''-1'''
| No logging, suppresses all log output
|-
! '''0'''
| Normal logging, only logging errors (default)
|-
! '''1'''
| Debug logging with freemem, fps and cpu usage (no on screen)
|-
! '''2'''
| Same as 1 (with on screen display)
|-
! '''3'''
| Same as 2 + full smb logging (no on screen display)
|}

{| class="mw-collapsible mw-collapsed wikitable"
|-
! style="width:100px;" | Example
! style="width:500px;" |
|-
! Example 1:
|<syntaxhighlight lang=xml enclose="div">
<advancedsettings>
<loglevel>2</loglevel>
</advancedsettings>
</syntaxhighlight>
|-
! Example 2:
|<syntaxhighlight lang=xml enclose="div">
<advancedsettings>
<loglevel hide="true">2</loglevel>
</advancedsettings>
</syntaxhighlight>
|}

'''Note:''' The setting is persistent through shutdown and restarts.<br>
'''Note:''' If debugging is enabled in the GUI, loglevel will be set to '''2'''. This will over-ride the <code>advancedsettings.xml</code> setting. You must disable the GUI Setting before adding the entry to <code>advancedsettings.xml</code>.<br />
<section end="loglevel" />
:''{{see also|Log_file|label 1=Debug Log}}''

=== jsonrpc ===
{{Anchor|.3Cjsonrpc.3E}}
To make it easier for developers using the [[JSON RPC]] API in their (third party) applications to debug during development the json output of Kodi can be prettified by setting '''compactoutput''' to '''false'''. Default json output mode is a compact print which does not contain any unnecessary whitespaces and therefore is difficult to read for humans.
Furthermore using the '''tcpport''' setting it is possible to change the default TCP port used by Kodi for JSON RPC (which is 9090) to any other valid port.

Example:
<syntaxhighlight lang=xml enclose="div">
<jsonrpc>
<compactoutput>false</compactoutput>
<tcpport>9999</tcpport>
</jsonrpc>
</syntaxhighlight>

== Audio/video playback settings ==

=== skiploopfilter ===
{{anchor|.3Cskiploopfilter.3E}}
The amount of the loop filter to skip on h.264 decoding. This can help the performance of slower machines when decoding h264 content. Values, in decreasing CPU usage (and decreasing quality)
* -16 None
* 0 Skip only empty frames (default)
* 8 Skip non-reference frames
* 16 Skip bi-dir frames
* 32 Skip all non-key frames
* 48 Skip all frames
Example:
<syntaxhighlight lang=xml enclose="div">
<skiploopfilter>8</skiploopfilter>
</syntaxhighlight>

=== video ===
{{anchor|.3Cvideo.3E}}

The <video> section also includes the following child-tags, which have their own sections:
*[[#cleandatetime]]
*[[#cleanstrings]]
*[[#excludefromscan]]
*[[#excludefromlisting]]
*[[#excludetvshowsfromscan]]

{{note|Some tags that have a "third-level" and are grouped together are highlighted in color.}}

{| class="prettytable"
! Tag !! Description
|-
|
<syntaxhighlight lang=xml>
<video>
</syntaxhighlight>
| Parent tag that all other child tags need to be placed inside of. Do not use more than one '''<code><video></code>''' tag, but instead place all other child-tags within a single '''<code><video></video></code>''' set.
|-
|
<syntaxhighlight lang=xml>
<subsdelayrange>10</subsdelayrange>
</syntaxhighlight>
| Delay range for subtitles, in seconds.
|-
|
<syntaxhighlight lang=xml>
<audiodelayrange>10</audiodelayrange>
</syntaxhighlight>
| Delay range for audio/video sync, in seconds.
|-
|
<syntaxhighlight lang=xml>
<usetimeseeking>true</usetimeseeking>
</syntaxhighlight>
| Whether to use time based or percentage based seeking. {{small see also|HOW-TO:Modify time seeking}}
|-
|
<syntaxhighlight lang=xml>
<timeseekforwardbig>600</timeseekforwardbig>
<timeseekbackwardbig>-600</timeseekbackwardbig>
</syntaxhighlight>
| Time to seek forward in seconds when doing a long seek. Defaults to 600 (10 minutes) and -600 (-10 minutes) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang=xml>
<percentseekforward>2</percentseekforward>
<percentseekbackward>-2</percentseekbackward>
</syntaxhighlight>
| Amount to seek forward as a percentage, when doing a short seek. Defaults to 2 (2%) and -2 (2%) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang=xml>
<percentseekforwardbig>10</percentseekforwardbig>
<percentseekbackwardbig>-10</percentseekbackwardbig>
</syntaxhighlight>
| Amount to seek forward as a percentage, when doing a long seek. Defaults to 10 (10%) and -10 (10%) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang=xml>
<fullscreenonmoviestart>true</fullscreenonmoviestart>
</syntaxhighlight>
| Whether to go to fullscreen or not when starting a movie. Defaults to true.
|-
|
<syntaxhighlight lang=xml>
<defaultplayer>VideoPlayer</defaultplayer>
</syntaxhighlight>
| Set the default video player: VideoPlayer or an external player. See '''[[External players]]''' for more info.
|-
|
<syntaxhighlight lang=xml>
<excludefromscan>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromscan>
</syntaxhighlight>
| Regular expressions that if evaluated to true won't be added to library. It is possible to add multiple <code><regexp></code> tags to match multiple patterns
|-
|
<syntaxhighlight lang=xml>
<excludefromlisting>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>
</syntaxhighlight>
| Regular expressions that if evaluated to true won't be displayed in files view.
|-
|
<syntaxhighlight lang=xml>
<playcountminimumpercent>90</playcountminimumpercent>
</syntaxhighlight>
| Minimum percentage that has to be played before it is marked as watched. Set to 101 to never auto-mark items as watched. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang=xml>
<ignoresecondsatstart>180</ignoresecondsatstart>
</syntaxhighlight>
| Number of seconds to ignore at video start after which a resume point is created. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang=xml>
<ignorepercentatend>8</ignorepercentatend>
</syntaxhighlight>
| Percentage of video to ignore at the end. If you stop watching the video here no resume point is created. Set to 101 to never save a resume point. The video is already marked as watched at 90%, see above. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang=xml>
<vdpauscaling>true</vdpauscaling>
</syntaxhighlight>
| Scales with vdpau instead of opengl and turns on its HQ scaler when available, enabling this might slow down rendering and cause framedrops especially on ION systems, this setting requires a vdpau feature set C GPU.
|-
|
<syntaxhighlight lang=xml>
<enablehighqualityhwscalers>true</enablehighqualityhwscalers>
</syntaxhighlight>
| Allow turning on the spline36 and lanczos3 shader (for GL builds).
|-
|
<syntaxhighlight lang=xml>
<dxvaallowhqscaling>false</dxvaallowhqscaling>
</syntaxhighlight>
| Enables high quality video upscaling for Windows.
|-
|
<syntaxhighlight lang=xml>
<ppffmpegdeinterlacing>linblenddeint</ppffmpegdeinterlacing>
</syntaxhighlight>
| Override the deinterlacing options passed to libpostproc.
|-
|
<syntaxhighlight lang=xml>
<ppffmpegpostprocessing>ha:128:7,va,dr</ppffmpegpostprocessing>
</syntaxhighlight>
| Override the post processing options passed to libpostproc when 'Video post-processing' is activated in GUI Videos-Settings-Playback.
|-
|
<syntaxhighlight lang=xml>
<autoscalemaxfps>30</autoscalemaxfps>
</syntaxhighlight>
| When scaling method is set to auto, bilinear is chosen when the fps is higher than this limit, the default is 30.
|-
|
<syntaxhighlight lang=xml>
<adjustrefreshrate>
</syntaxhighlight>
| style="background:#CADCFB;" | Settings for when "Adjust refreshrate to match video fps" is enabled in the video playback GUI settings.
|-
|
<syntaxhighlight lang=xml>
<override>
<fps>23.976</fps>
<refresh>60.0</refresh>
</override>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' "Adjust refreshrate to match video fps" will try to select the best refreshrate for the video fps but it doesn't always get it right, for example it might switch to an unsupported refreshrate. You can add overrides here to switch to a certain refreshrate based on video fps. It's possible to add as many overrides as you need. Overrides are processed in order, if the first one doesn't match the fps or no refreshrates match that override, it will try the next one until no overrides are left.

* '''fps''' - if the fps is between 23.966 and 23.986
* '''refresh''' - switch to the first found refreshrate that is between 59.99 and 60.01
|-
|
<syntaxhighlight lang=xml>
<override>
<fpsmin>29.96</fpsmin>
<fpsmax>30.01</fpsmax>
<refreshmin>59.0</refreshmin>
<refreshmax>61.0</refreshmax>
</override>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -'''
* '''fpsmin''' / '''fpsmin''' - You can also specify the fps range yourself.
* '''refreshmin''' / '''refreshmax''' - Same for the refreshrate
|-
|
<syntaxhighlight lang=xml>
<fallback>
<refresh>50.0</refresh>
</fallback>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' If none of the overrides match, or none of the refreshrates match any of the fps matching overrides, it will choose a fallback refreshrate. Fallbacks are process in order, if the first fallback doesn't match any refreshrate, it will try the next one until no fallbacks are left.

* '''refresh''' - Switch to the first found refreshrate that is between 49.99 and 50.01.
|-
|
<syntaxhighlight lang=xml>
<fallback>
<refreshmin>49.0</refreshmin>
<refreshmax>51.0</refreshmax>
</fallback>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' You can also specify the range for the fallback yourself.

If none of the overrides match the video fps, or no refreshrates match any of the fps matching overrides, and no fallbacks are specified or no refreshrates match any fallbacks, it will automatically choose the best refreshrate (same as having no overrides and fallbacks).
|-
|
<syntaxhighlight lang=xml>
</adjustrefreshrate>
</syntaxhighlight>
| style="background:#CADCFB;" |
|-
|
<syntaxhighlight lang=xml>
<checkdxvacompatibility>value</checkdxvacompatibility>
</syntaxhighlight>
| Advanced setting not present: let Kodi autodetect cards that support H.264 profile > L4.1. Set value to false to enable DXVA no matter what. Set value to true if Kodi doesn't autodetect that the graphics card doesn't support > L4.1.
|-
|
<syntaxhighlight lang=xml>
<useocclusionquery>-1</useocclusionquery>
</syntaxhighlight>
| Use an occlusion query when capturing videoframes, -1 means auto detect, 0 means disabled, 1 means enabled, the default is -1.
|-
|
<syntaxhighlight lang=xml>
<fpsdetect>1</fpsdetect>
</syntaxhighlight>
| FPS detection for video playback
* 0 = trust codec fps
* 1 = recalculate from video timestamps with uniform spacing
* 2 = recalculate from video timestamps always
|-
|
<syntaxhighlight lang=xml>
<latency>
</syntaxhighlight>
| style="background:#F0E68C;"| Start of '''latency''' tags. Display latency (video lag). Latency is given in msecs.
|-
|
<syntaxhighlight lang=xml>
<delay>0</delay>
</syntaxhighlight>
| style="background:#F0E68C;" | Global default display latency.
|-
|
<syntaxhighlight lang=xml>
<refresh></refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | Override latency for given display (not video) refresh rates. When Kodi is in windowed mode, override is ignored. Multiple overrides are allowed.

Syntax of an override entry:
<syntaxhighlight lang=xml>
<refresh>
<min>, <max> refresh rate range, OR
<rate> exact refresh rate
<delay> display latency for the given refresh rate
</refresh>
</syntaxhighlight>
|-
|
<syntaxhighlight lang=xml>
<refresh>
<min>23</min>
<max>24</max>
<delay>125</delay>
</refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | '''Example:''' display has 125 msec latency at 23-24 Hz
|-
|
<syntaxhighlight lang=xml>
<refresh>
<rate>50</rate>
<delay>50</delay>
</refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | '''Example:''' display has 50 msec latency at 50 (+/-0.01) Hz
|-
|
<syntaxhighlight lang=xml>
</latency>
</syntaxhighlight>
| style="background:#F0E68C;" |
|-
|
<syntaxhighlight lang=xml>
<stereoscopicregex3d>[-. _]3d[-. _]</stereoscopicregex3d>
<stereoscopicregexsbs>[-. _]h?sbs[-. _]</stereoscopicregexsbs>
<stereoscopicregextab>[-. _]h?tab[-. _]</stereoscopicregextab>
</syntaxhighlight>
| Filename triggers for 3D (stereoscopic) mode.
|-
|
<syntaxhighlight lang=xml>
<assfixedworks>false</assfixedworks>
</syntaxhighlight>
| Position behavior of ass subtitiles when setting "subtitle position on screen" set to "fixed". True to show at the fixed position set in video calibration. False to show at the bottom of video (default).
|-
|
<syntaxhighlight lang=xml>
</video>
</syntaxhighlight>
|
|}

=== audio ===
{{anchor|.3Caudio.3E}}
<syntaxhighlight lang=xml enclose="div">
<audio>

<headroom>0</headroom>

<defaultplayer>paplayer</defaultplayer>

<excludefromscan>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromscan>

<excludefromlisting>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromlisting>

<ac3downmixgain>12.0</ac3downmixgain>

<usetimeseeking>true</usetimeseeking>

<timeseekforwardbig>600</timeseekfowardbig>

<timeseekbackwardbig>-600</timeseekbackward>

<playcountminimumpercent>99</playcountminimumpercent>

<applydrc>-1.0</applydrc>

<limiterhold>0.025</limiterhold>

<limiterrelease>0.1</limiterrelease>
</audio>
</syntaxhighlight>

For more information on the configuration of audio under Frodo see [[AudioEngine/HOW-TO: Configure audio]]

=== edl ===
{{anchor|.3Cedl.3E}}
{{main|EDL}}
Commercial break detection not as good you think it could be? Are some commercial breaks in a series of adverts not being skipped? Are some parts being skipped that are clearly not commercials? Does the end of the previous recording still show? The following advanced settings can be used to better identify full commercial break sequences, remove incorrectly flagged commercial breaks, and have playback start at the actual beginning of the recording.

<syntaxhighlight lang=xml enclose="div">
<edl>

<mergeshortcommbreaks>false</mergeshortcommbreaks>

<maxcommbreaklength>250</maxcommbreaklength>

<mincommbreaklength>90</mincommbreaklength>

<maxcommbreakgap>120</maxcommbreakgap>

<commbreakautowait>0</commbreakautowait>

<commbreakautowind>0</commbreakautowind>
</edl>
</syntaxhighlight>

=== pvr ===
{{anchor|.3Cpvr.3E}}
<syntaxhighlight lang=xml enclose="div">
<pvr>
<timecorrection>0</timecorrection> 
<infotoggleinterval>3000</infotoggleinterval> 
<channeliconsautoscan>true</channeliconsautoscan> 
<autoscaniconsuserset>false</autoscaniconsuserset> 
<numericchannelswitchtimeout>1000</numericchannelswitchtimeout> 
</pvr>
</syntaxhighlight>

=== epg ===
{{anchor|.3Cpvr.3E}}
<syntaxhighlight lang=xml enclose="div">
<epg>
<updatecheckinterval>300</updatecheckinterval> 
<updateemptytagsinterval>60</updateemptytagsinterval> 
<cleanupinterval>900</cleanupinterval> 
<activetagcheckinterval>60</activetagcheckinterval> 
<retryinterruptedupdateinterval>60</retryinterruptedupdateinterval> 
<displayupdatepopup>true</displayupdatepopup> 
<displayincrementalupdatepopup>false</displayincrementalupdatepopup> 
</epg>
</syntaxhighlight>

=== forcedswaptime ===
{{anchor|.3Cforcedswaptime.3E}}
Use to force a backbuffer->frontbuffer swap while vsync is enabled. Set to the time (in ms) to allow for the swap (e.g. <forcedswaptime>1</forcedswaptime> is typical).

Default: Off



== Video library settings ==

=== videoextensions ===
{{anchor|.3Cvideoextensions.3E}}<section begin="videoextensions" />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Video windows.

Default extensions for VIDEOS:
<pre>
.m4v .3g2 .3gp .nsv .tp .ts .ty .strm .pls .rm .rmvb .mpd .m3u .m3u8 .ifo .mov .qt .divx .xvid
.bivx .vob .nrg .pva .wmv .asf .asx .ogm .m2v .avi .dat .mpg .mpeg .mp4 .mkv .mk3d .avc .vp3
.svq3 .nuv .viv .dv .fli .flv .001 .wpl .vdr .dvr-ms .xsp .mts .m2t .m2ts .evo .ogv .sdp .avs
.rec .url .pxml .vc1 .h264 .rcv .rss .mpls .webm .bdmv .wtv .trp .f4v
</pre>
Examples:
<pre>
<videoextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</videoextensions>
</pre>
<section end="videoextensions" />

=== discstubextensions ===
{{main|Media stubs}}

<section begin="discstubextensions" />
The default filename extension for Disc Stubs is:
<syntaxhighlight lang=xml enclose="div">
.disc
</syntaxhighlight>
Using the following tags, it is possible to <tt><add></tt> additional or <tt><remove></tt> existing disc stub extensions to better suit your requirements.
<syntaxhighlight lang=xml enclose="div">
<discstubextensions>
<add>.disk|.stub</add>
<remove>.disc</remove>
</discstubextensions>
</syntaxhighlight>
<section end="discstubextensions" />

=== languagecodes ===
{{anchor|.3Clanguagecodes.3E}}
Translation table for subtitle and audio names. Contains entries of the form

<syntaxhighlight lang=xml enclose="div">
<languagecodes>
<code>
<short>alt</short>
<long>Alternate</long>
</code>
</languagecodes>
</syntaxhighlight>

=== moviestacking ===
{{anchor|.3Cmoviestacking.3E}}<section begin="moviestacking" />
{{main|File stacking}}
This is used by the [[file stacking]] algorithm to combine multi-part files and contains a list of "''[[Regular Expression (RegEx) Tutorial|regular expressions]]''". For stacking videos that are contained in folders, such as VIDEO_TS folders, see '''[[advancedsettings.xml#folderstacking|<folderstacking>]]'''

As of v9.11, video stacking regular expressions '''must''' contain exactly four (4) capture expressions.

Default:
<syntaxhighlight lang=xml enclose="div">
<moviestacking>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[0-9]+)(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[a-d])(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ ._-]*[a-d])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="append"</tt> or <tt>append="yes"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the end.

Example:
<syntaxhighlight lang=xml enclose="div">
<moviestacking action="append">

<regexp>(.*?)([ ._-]*[0-9])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="prepend"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the beginning.

Example:
<syntaxhighlight lang=xml enclose="div">
<moviestacking action="prepend">
<regexp>(Title)(Volume)(Ignore)(Extension)</regexp>
</moviestacking>
</syntaxhighlight>

If no argument is supplied, or the argument <tt>append="no"</tt> is supplied, the default moviestacking regular expressions are overwritten by the user specified ones.
<section end="moviestacking" />

=== folderstacking ===
{{main|File stacking}}
This is similar to '''[[advancedsettings.xml#moviestacking|<moviestacking>]]''', but is used for videos that are contained in folders that use the folder names to stack, such as VIDEO_TS folders (DVD rips that are not in ISO format).

Default:
<syntaxhighlight lang=xml enclose="div">
<folderstacking>

<regexp>((cd|dvd|dis[ck])[0-9]+)$</regexp>
</folderstacking>
</syntaxhighlight>

=== cleandatetime ===
{{anchor|.3Ccleandatetime.3E}}
Matches a year number in a string using a ''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''

Default expression:
<syntaxhighlight lang=xml enclose="div">
<video>
<cleandatetime>(.+[^ _\,\.\[\]\-])[ _\.\[\]\-]+(19[0-9][0-9]|20[0-1][0-9])([ _\,\.\[\]\-][^0-9]|$)</cleandatetime>
</video>
</syntaxhighlight>
:* The string found before will be used as basis string getting cleaned by the cleanstrings expressions.
:* By default date formats like MM:YY are ignored.

=== cleanstrings ===
{{anchor|.3Ccleanstrings.3E}}
Clean unwanted characters from filenames or folders by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. Please note that everything right of the match (at the end of the file name) is removed, so if you would have a file named ''Super movie.mp4'' and would add <tt><regexp> </regexp></tt> (only a space), the only thing that would be left is ''Super'', which is probably not what you want.

Default expressions:
<syntaxhighlight lang=xml enclose="div">
<video>
<cleanstrings>
<regexp>[ _\,\.\[\]\-](ac3|dts|custom|dc|divx|divx5|dsr|dsrip|dutch|dvd|dvdrip|dvdscr|dvdscreener|screener|dvdivx|cam|fragment|fs|hdtv|hdrip|hdtvrip|internal|limited|multisubs|ntsc|ogg|ogm|pal|pdtv|proper|repack|rerip|retail|cd[1-9]|r3|r5|bd5|se|svcd|swedish|german|read.nfo|nfofix|unrated|ws|telesync|ts|telecine|tc|brrip|bdrip|480p|480i|576p|576i|720p|720i|1080p|1080i|hrhd|hrhdtv|hddvd|bluray|x264|h264|xvid|xvidvd|xxx|www.www|\[.*\])([ _\,\.\[\]\-]|$)</regexp>
<regexp>(\[.*\])</regexp>
</cleanstrings>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== tvshowmatching ===
{{anchor|.3Ctvshowmatching.3E}}
Matches the season and episode numbers in file paths by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

Defaults:
<syntaxhighlight lang=xml enclose="div">
<tvshowmatching>
<regexp>s([0-9]+)[ ._x-]*e([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)([^\\\\/]*)$</regexp> 
<regexp>[\._ -]()[Ee][Pp]_?([0-9]+)([^\\/]*)$</regexp> 
<regexp>([0-9]{4})[\.-]([0-9]{2})[\.-]([0-9]{2})</regexp> 
<regexp>([0-9]{2})[\.-]([0-9]{2})[\.-]([0-9]{4})</regexp> 
<regexp>[\\/\._ \[\(-]([0-9]+)x([0-9]+)([^\\/]*)$</regexp> 
<regexp>[\\/\._ -]([0-9]+)([0-9][0-9])([\._ -][^\\/]*)$</regexp> 
<regexp>[\/._ -]p(?:ar)?t[_. -]()([ivx]+)([._ -][^\/]*)$</regexp> 
</tvshowmatching>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)
:* Paths are converted to lower case before matching.
:* Examples of matching regexps for certain filenames can be found on the [[TV Shows (Video Library)|TV shows]] page.

:* For multi-episode matching to work, there needs to be a third set of parentheses '()' at the end, this part is fed back into the regexp engine.

:* A [https://forum.kodi.tv/showthread.php?tid=51614 forum thread] has a discussion of pre-made regex lists to match common names. These might improve Kodi's ability to match TV show names in some situations, at the risk of additional false positives.

==== Filenames without Season ====
There are two methods to add episodes without a season in their file path. Both ways will force the season to '1' by default, so that you can use
the 'Use Absolute Ordering (Single Season)' setting from the TheTvDb.com scraper.

; Simple Method ''(XBMC v9.11 onwards and Kodi)''
: Use only one pair of parentheses
<syntaxhighlight lang=xml enclose="div"><regexp>[/\._ \-]([0-9]+)</regexp></syntaxhighlight>
; Advanced Method ''(XBMC v10.05 onwards and Kodi)''
: Supports multi-episode files without season
: Use an empty pair of parentheses for the season
<syntaxhighlight lang=xml enclose="div"><regexp>[/\._ \-]()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

; Specifying Default Season ''(XBMC v12.0 onwards and Kodi)''
It is possible to set the default season for specific regular expressions by setting the 'defaultseason' attribute.
: Works with both the simple method and advanced method
: If not used, the season will be set to '1'
: Useful for setting specials to season '0'
<syntaxhighlight lang=xml enclose="div"><regexp defaultseason="0">[/\._ \-]X()([0-9]+)(-[0-9]+)?</regexp>
<regexp defaultseason="1">[/\._ \-]E()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

=== tvmultipartmatching ===
{{anchor|.3Ctvmultipartmatching.3E}}
Matches a multipart episode number based on a previously identified episode file, using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''.

Default:
<syntaxhighlight lang=xml enclose="div">
<tvmultipartmatching>^[-_ex]+([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)</tvmultipartmatching>
</syntaxhighlight>
:* Text matching is compared case-insensitive.
:* Specifying this option '''replaces''' the default value

=== excludefromscan ===
{{anchor|.3Cexcludefromscan.3E}}
Matches filenames or folders which should be excluded from a library scan (except tvshows) using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. This can be for both Video or Audio sections of <tt>advancedsettings.xml</tt>.

Defaults:
<syntaxhighlight lang=xml enclose="div">
<video>
<excludefromscan>
<regexp>-trailer</regexp>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludefromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== excludefromlisting ===
{{anchor|.3Cexcludefromlisting.3E}}
<syntaxhighlight lang=xml enclose="div">
<video>
<excludefromlisting> 
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>
</video>
</syntaxhighlight>

=== excludetvshowsfromscan ===
{{anchor|.3Cexcludetvshowsfromscan.3E}}
Matches filenames or folders which should be excluded from a tvshow library scan using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

Defaults:
<syntaxhighlight lang=xml enclose="div">
<video>
<excludetvshowsfromscan>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludetvshowsfromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== trailermatching ===
{{anchor|.3Ctrailermatching.3E}}
Contains "''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''" syntax (commonly referred to as "''[[Regular Expression (RegEx) Tutorial|RegEx]]''" or "''[[Regular Expression (RegEx) Tutorial|RegExp]]''") to match the locally stored trailers to movies in the library.

<syntaxhighlight lang=xml enclose="div">
<trailermatching>

<regexp>(.*?)(_Trailer)(\.[^.]+)$</regexp>
</trailermatching>
</syntaxhighlight>

=== videolibrary ===
{{anchor|.3Cvideolibrary.3E}}
Options specific to the Video Library

<syntaxhighlight lang=xml enclose="div">
<videolibrary>
<allitemsonbottom>false</allitemsonbottom> 
<cleanonupdate>false</cleanonupdate> 
<usefasthash>true</usefasthash> 
<recentlyaddeditems>35</recentlyaddeditems> 
<itemseparator> / </itemseparator> 
<exportautothumbs>false</exportautothumbs> 
<importwatchedstate>false</importwatchedstate> 
<importresumepoint>false</importresumepoint> 
<dateadded>1</dateadded> 
</videolibrary>
</syntaxhighlight>

==== Extra artwork ====

New for Kodi v18.
Configuration to expand the artwork automatically added by Kodi to media items in the library, either from local files or online scrapers.

The original basic artwork types are still hardcoded so they don't need to be configured here (and can't be removed). "poster" and "fanart" for movies, movie sets, TV shows, seasons, and music videos; "banner" for TV shows and seasons; and "thumb" for episodes.

<syntaxhighlight lang=xml enclose="div">
<videolibrary>


<tvshowextraart>
<arttype>characterart</arttype>
<arttype>clearart</arttype>
<arttype>clearlogo</arttype>
<arttype>landscape</arttype>
<arttype>keyart</arttype>
</tvshowextraart>

<tvseasonextraart>
<arttype>landscape</arttype>
</tvseasonextraart>

<episodeextraart>
<arttype>fanart</arttype>
</episodeextraart>

<movieextraart>
<arttype>banner</arttype>
<arttype>clearart</arttype>
<arttype>clearlogo</arttype>
<arttype>discart</arttype>
<arttype>landscape</arttype>
<arttype>keyart</arttype>
</movieextraart>

<moviesetextraart>
<arttype>banner</arttype>
<arttype>clearart</arttype>
<arttype>clearlogo</arttype>
<arttype>discart</arttype>
<arttype>landscape</arttype>
<arttype>keyart</arttype>
</moviesetextraart>

<musicvideoextraart>
<arttype>banner</arttype>
<arttype>clearart</arttype>
<arttype>clearlogo</arttype>
<arttype>discart</arttype>
<arttype>landscape</arttype>
</musicvideoextraart>
</videolibrary>
</syntaxhighlight>

=== videoscanner ===
{{anchor|.3Cvideoscanner.3E}}
Options specific to the Video scanner
<syntaxhighlight lang=xml enclose="div">
<videoscanner>
<ignoreerrors>true</ignoreerrors> 
</videoscanner>
</syntaxhighlight>

== Library artwork ==

{{note|Using <imageres>9999</imageres> and <fanartres>9999</fanartres> will allow caching artwork at original size.}}

=== imageres ===
{{anchor|.3Cimageres.3E}}

<section begin="imageres description" />Specify the maximum resolution that [[Artwork/Cache#Texture optimization| cached artwork]] (other than fanart / 16:9 images) should be resized to in pixels. The width is automatically calculated as being 16/9*height. The image will be resized to fit within this size. e.g. an image that is 2000x500 will be cached at size 1280x320. An image that is 500x800 will be cached at size 450x720 using the default value of 720.<section end="imageres description" />

<syntaxhighlight lang=xml enclose="div">
<imageres>720</imageres>
</syntaxhighlight>

=== fanartres ===
{{anchor|.3Cfanartres.3E}}

<section begin="fanartres description" />Specify the maximum resolution that [[Artwork/Cache#Texture optimization| cached fanart]] should be resized to in pixels. The width is automatically calculated as being 16/9*height. Only images that are exactly 16x9 and equal to or greater than this resolution will be cached at this size - all other images will be cached using <imageres>. The default value is 1080.<section end="fanartres description" />

<syntaxhighlight lang=xml enclose="div">
<fanartres>1080</fanartres>
</syntaxhighlight>

=== fanart ===
{{anchor|.3Cfanart.3E}}
Only used for music and not video.

A list of additional files to try when searching for local fanart images. (The defaults are fanart.jpg and fanart.png which can be removed.)

Example:
<syntaxhighlight lang=xml enclose="div">
<fanart>
<remove>fanart.jpg</remove>
<add>backdrop.jpg</add>
</fanart>
</syntaxhighlight>

=== musicthumbs ===
{{anchor|.3Cmusicthumbs.3E}}
<section begin="musicthumbs" />A list of additional files to try when searching for music thumbnail images. (The default is folder.jpg which can be removed.)

Example:
<syntaxhighlight lang=xml enclose="div">
<musicthumbs>
<remove>folder.jpg</remove>
<add>thumb.jpg|cover.jpg</add>
</musicthumbs>
</syntaxhighlight><section end="musicthumbs" />

=== imagescalingalgorithm ===
Specify the image scaling algorithm for image resizing when [[Artwork/Cache#Texture optimization| caching artwork]] to the local texture cache.
<br />
<syntaxhighlight lang=xml enclose="div">
<imagescalingalgorithm>bicubic</imagescalingalgorithm>
</syntaxhighlight>

[https://github.com/xbmc/xbmc/blob/1a8753d5cd93890dc6a9f9d4b2ce8848066ea5d0/xbmc/pictures/PictureScalingAlgorithm.cpp#L32-L43 Available image scaling algorithms]

<syntaxhighlight lang=text enclose="div">
fast_bilinear
bilinear
bicubic
experimental
nearest_neighbor
averaging_area
bicublin
gaussian
sinc
lanczos
bicubic_spline
</syntaxhighlight>

== Video and music library settings ==

=== playlistasfolders ===
{{anchor|.3Cplaylistasfolders.3E}}
In the recent releases, playlists are treated as folders. Selecting a playlist no longer plays it, but opens it, as if it were a folder.

Set to false to revert to the previous behaviour. When you select a playlist, its content is added to the list of elements to be played.

:{{note|This setting will not affect smart playlists, they will always show as folders.}}

;Example
<syntaxhighlight lang=xml enclose="div">
<playlistasfolders>true</playlistasfolders>
</syntaxhighlight>

=== playlistretries ===
{{anchor|.3Cplaylistretries.3E}}
The number of retries attempted if a source is offline. With this control you can alter the number of consecutive failed items before a playlist fails.

Default:
<syntaxhighlight lang=xml enclose="div">
<playlistretries>100</playlistretries>
</syntaxhighlight>

=== playlisttimeout ===
{{anchor|.3Cplaylisttimeout.3E}}
The timeout, in seconds, before item failure.

Default:
<syntaxhighlight lang=xml enclose="div">
<playlisttimeout>20</playlisttimeout>
</syntaxhighlight>

=== sorttokens ===
Allows you to specify additional tokens that will be ignored at the start of lines during sorting.
{{note|Sort tokens are case sensitive.}}
<syntaxhighlight lang=xml enclose="div">
<sorttokens>
<token>the</token>
</sorttokens>
</syntaxhighlight>

In the above example "the ", "the." and "the_" will be ignored at the start of titles or names when sorting items, in both video and music libraries. A separator can also be specified, for example
<syntaxhighlight lang=xml enclose="div">
<sorttokens>
<token separators="'">L</token>
</sorttokens>
</syntaxhighlight>
In that case the value L', as in French movie name ''L'argent'', will be ignored and the item listed under "A".

=== musicdatabase/videodatabase ===
{{anchor|.3Cmusicdatabase.3E/.3Cvideodatabase.3E|musicdatabase/videodatabase|database tags music/video/tv/epg/adsp}}
{{main|MySQL}}
<section begin="videodatabase" />
Allows advanced customization of the default database settings for music, video, TV, EPG, and ADSP databases.

:{{note| '''It is HIGHLY recommended that you not attempt to place an sqlite3 database outside of kodi's path. sqlite3 contains no filesystem abstraction, so this will plain break on any non-local (as far as Kodi is concerned) paths. Use this for mysql only.'''}}

'''Parent tags:'''

* '''<videodatabase>'''
* '''<musicdatabase>'''
* '''<tvdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
* '''<epgdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
* '''<adspdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
{{MySQL warning}}

'''Child tags: '''

;<type>
: ''Required'' - Can be either "sqlite3" or "mysql" (default: sqlite3)

;<host>
:''Required'' -
* sqlite3: defines the relative path to the database file (eg. /usr/local/kodi/databases).
* mysql: defines the host of the mysql socket (eg. localhost, 192.168.0.1, etc)

;<port>
: ''Optional'' -
* sqlite3: silently ignored
* mysql: defines the port of the mysql socket (default: 3306)

;<name>
: ''Optional'' -
:by default "MyVideos"+DB number will be used.
* sqlite3: defines the name of the database file to read from, excluding the ".db" extension.
* mysql: defines the name of the database to use

;<user>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the user with privileged access to the database

;<pass>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the password for the user with privileged access to the database

;<compression>
: ''Optional'' - Defaults to false. Set to "true" to enable MySQL compression protocol. Performance benefit is going to be largely dependent on the network bandwidth, latency between database and clients and on the size of the result sets. [https://github.com/xbmc/xbmc/pull/6484]
: {{Note|Slower clients (such as the RPi and others) won't benefit from it as the zlib de-compression overhead is higher than the actual compression savings}}

;<key>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<cert>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ca>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<capath>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ciphers>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

'''Examples:'''

1) Configure a database for MySQL.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', '''<epgdatabase>''', and '''<adspdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang=xml enclose="div">
<videodatabase>
<type>mysql</type>
<host>192.168.0.10</host>
<name>kodi_video</name>
<user>kodi</user>
<pass>kodi</pass>
</videodatabase>
</syntaxhighlight>

2) Configure a database for an sqlite database.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', '''<epgdatabase>''', and '''<adspdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang=xml enclose="div">
<musicdatabase>
<type>sqlite3</type>
<host>/usr/local/share/kodi/databases</host>
</musicdatabase>
</syntaxhighlight>

<section end="videodatabase" />

=== externalplayer ===
{{anchor|.3Cexternalplayer.3E}}
{{see|External players}}

== Music settings ==

=== musicextensions ===
{{anchor|.3Cmusicextensions.3E}}
<section begin="musicextensions" />
Default extensions for MUSIC:
<pre>
.nsv .m4a .flac .aac .strm .pls .rm .rma .mpa .wav .wma .ogg .mp3 .mp2 .m3u .gdm .imf .m15 .sfx
.uni .ac3 .dts .aif .aiff .wpl .ape .mac .mpc .mp+ .mpp .shn .wv .dsp .xsp .xwav .waa .wvs .wam
.gcm .idsp .mpdsp .mss .spt .rsd .sap .cmc .cmr .dmc .mpt .mpd .rmt .tmc .tm8 .tm2 .oga .url
.pxml .tta .rss .wtv .mka .tak .opus .dff .dsf .m4b .cue .zip .rar
</pre>

It is possible to add or remove extensions for Music, using the following XML tags. Useful if you keep, say, FLAC and mp3 versions of music in the same folder. The <remove> tag can be used to remove mp3 from being listed in the library, leaving only the higher quality FLAC being displayed.

<musicextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</musicextensions>

<section end="musicextensions" />

=== cddbaddress ===
{{anchor|.3Ccddbaddress.3E}}
The address of the online CDDb database. You may set this to another freedb mirror if there is a more suitable one.

Default:
<syntaxhighlight lang=xml enclose="div>
<cddbaddress>freedb.freedb.org</cddbaddress>
</syntaxhighlight>

=== songinfoduration ===
{{anchor|.3Csonginfoduration.3E}}
This controls how long the song information will remain onscreen when the song changes during visualisations. The valid range is "1" to "Indefinite (0)", in seconds. This does not include the duration of any transition effects.

Default:
<syntaxhighlight lang=xml enclose="div">
<songinfoduration>10</songinfoduration>
</syntaxhighlight>

=== musicfilenamefilters ===
{{anchor|.3Cmusicfilenamefilters.3E}}
Contains filters to match music information (artist, title etc.) from a tag-less music filename. The first <filter> to match completely is used. Matched items include:

<pre>
%A - Artist
%T - Title
%B - Album
%N - Track number
%S - Part of set (disk number)
%D - Duration
%G - Genre
%Y - Year
%R - Rating
</pre>

Example:
<syntaxhighlight lang=xml enclose="div">
<musicfilenamefilters>
<filter>%A - %T</filter>
</musicfilenamefilters>
</syntaxhighlight>

=== musiclibrary ===
Options specific to the Music Library
<section begin="MusicLibrary" />
<syntaxhighlight lang="xml" line='line'>
<musiclibrary>
<allitemsonbottom>true</allitemsonbottom> 
<cleanonupdate>false</cleanonupdate> 
<recentlyaddeditems>35</recentlyaddeditems> 
<albumformat>%B - %Y</albumformat> 
<prioritiseapetags>true</prioritiseapetags> 
<itemseparator> / </itemseparator> 
<artistseparators> 
<separator>;</separator>
<separator>:</separator>
<separator>|</separator>
<separator> feat. </separator>
<separator> ft. </separator>
</artistseparators>
<dateadded>1</dateadded> 


<promptfulltagscan>false</promptfulltagscan> 
<useartistsortname>false</useartistsortname> 
</musiclibrary>
</syntaxhighlight>
{{Note|Changing the <itemseparator> or <artistseparators> will only affect newly added items. A rescan won't change the existing ones. Remove the Source(s) or delete the Music DB and rebuild. This process should be made easier from v18 and up using <promptfulltagscan>}}<section end="MusicLibrary" />

==== Music library extra artwork ====

New for Kodi v18.
Configuration to expand the artwork automatically added by Kodi to media items in the library, either from local files or online scrapers.

The original basic artwork types are still hardcoded so they don't need to be configured here (and can't be removed). "thumb" for artists and albums, and "fanart" for artists.

<syntaxhighlight lang=xml enclose="div">
<musiclibrary>


<artistextraart>
<arttype>banner</arttype>
<arttype>clearlogo</arttype>
<arttype>clearart</arttype>
<arttype>landscape</arttype>
</artistextraart>

<albumextraart>
<arttype>discart</arttype>
<arttype>spine</arttype>
<arttype>back</arttype>
</albumextraart>
</musiclibrary>
</syntaxhighlight>

== Photos settings ==

=== pictureextensions ===
{{anchor|.3Cpictureextensions.3E}}
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Pictures window.

Default extensions for PICTURES:
<pre>
.png .jpg .jpeg .bmp .gif .ico .tif .tiff .tga .pcx .cbz .cbr .rss .webp .jp2 .apng
</pre>

Examples:
<syntaxhighlight lang=xml enclose="div">
<pictureextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</pictureextensions>
</syntaxhighlight>

=== pictureexcludes ===
{{anchor|.3Cpictureexcludes.3E}}
Matches filenames or folders which should be excluded from being displayed in My Pictures using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

<syntaxhighlight lang=xml enclose="div">
<pictureexcludes> 
<regexp>small</regexp>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</pictureexcludes>
</syntaxhighlight>

=== slideshow ===
{{anchor|.3Cslideshow.3E}}
<syntaxhighlight lang=xml enclose="div">
<slideshow>

<panamount>2.5</panamount>

<zoomamount>5.0</zoomamount>



<blackbarcompensation>20</blackbarcompensation>
</slideshow>
</syntaxhighlight>

== Network settings ==

=== samba ===
{{anchor|.3Csamba.3E}}
<syntaxhighlight lang=xml enclose="div">
<samba>
<doscodepage></doscodepage> 
<clienttimeout>10</clienttimeout> 
<statfiles>true</statfiles> 
</samba>
</syntaxhighlight>

=== hosts ===
{{anchor|.3Cfhosts.3E}}
Static dns entries which take precedence over your dns server.
<syntaxhighlight lang=xml enclose="div">
<hosts>
<entry name="HOSTNAME">IPADDRESS</entry>
</hosts>
</syntaxhighlight>

=== network ===
{{anchor|.3Cnetwork.3E}}

<syntaxhighlight lang=xml enclose="div">
<network>
<curlclienttimeout>10</curlclienttimeout> 
<curllowspeedtime>20</curllowspeedtime> 
<curlretries>2</curlretries> 
<httpproxyusername></httpproxyusername> 
<httpproxypassword></httpproxypassword> 
</network>
</syntaxhighlight>

{{Note|In Kodi v17, the three buffer settings are removed from the <code><network></code> tag and now placed under the new <code><cache></code> tag. See '''[[#cache]]''' for full details.}}

=== cache ===
{{see also|HOW-TO:Modify the cache}}
<syntaxhighlight lang=xml enclose="div">
<cache>
<memorysize>0</memorysize> 
<buffermode>0</buffermode> 
<readfactor>4.0</readfactor> 
</cache>
</syntaxhighlight>

=== airtunesport ===
{{anchor|.3Cairtunesport.3E}}<section begin="airtunesport" />
This overwrites the defalt listening port of the AirTunes server (announced via zeroconf).
<section end="airtunesport" />

=== airplayport ===
{{anchor|.3Cairplayport.3E}}<section begin="airplayport" />
This overwrites the default listening port of the AirPlay server (announced via zeroconf).
<section end="airplayport" />

== File system settings ==

=== packagefoldersize ===
<section begin="packagefoldersize" />
{{anchor|.3Cpackagefoldersize.3E}}
{{xml setting
| tag name = packagefoldersize
| option type = numerical
| option values =
| default values = 200
| platform = all
| XBMC version = 12
| description = The amount (in megabytes) of add-on zip packages saved from previous add-on installs. These packages are mainly used for the [[add-on]] rollback feature. Increasing the size should increase the amount of past versions saved. Defaults to 200 MB.
| example = Example: <syntaxhighlight lang=xml enclose="div"><packagefoldersize>200</packagefoldersize> </syntaxhighlight>
}}
<section end="packagefoldersize" />

=== detectasudf ===
{{anchor|.3Cdetectasudf.3E}}
Set to true if you wish to detect joint ISO9660/UDF disks as UDF.

Default: False

=== pathsubstitution ===
{{anchor|.3Cpathsubstitution.3E}}
{{main|Path substitution}}

{{divbox|red||'''Note:''' Path substition for "sources" and profiles is broken, and will '''NOT''' be fixed.}}

Path substitutions are for use for redirecting file paths. These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for Kodi to handle.

Default: No path substitutions defined.

Example:
<syntaxhighlight lang=xml enclose="div">
<pathsubstitution>
<substitute>
<from>G:\dvds\</from>
<to>smb://somecomputer/g-share/dvds/</to> 
</substitute>
</pathsubstitution>
</syntaxhighlight>

== Input control settings ==

=== remotedelay ===
{{anchor|.3Cremotedelay.3E}}
The repeat delay for a LIRC remote control. A delay value between 1 and 20 before a remote button starts repeating on a long keypress (i.e. continuously sending button pushes while it's held down).

Default: 3
<syntaxhighlight lang=xml enclose="div">
<remotedelay>10</remotedelay>
</syntaxhighlight>

=== controllerdeadzone ===
{{anchor|.3Ccontrollerdeadzone.3E}}
This advanced settings has been removed. See [[HOW-TO:Controller deadzone]].

=== enablemultimediakeys ===
{{anchor|.3Cenablemultimediakeys.3E}}
This setting only has any effect on Windows versions of Kodi, and only applies to builds from 28th May 2011 onwards.
In Windows the multimedia keys generate a WM_APPCOMMAND message in addition the keypress. Kodi processes both keypresses and the WM_APPCOMMAND messages, and the end result would be that the command is executed twice. To avoid this, by default multimedia keypresses are disabled. Although it should rarely be necessary, the enablemultimediakeys setting allows you to enable the multimedia keys.

Example:
<syntaxhighlight lang=xml enclose="div">
<enablemultimediakeys>true</enablemultimediakeys>
</syntaxhighlight>

=== seeksteps ===
{{Main|Skip steps}}

This setting changes which increments are available in the settings GUI for additive seeking. Note that <code><seeksteps></code> is not used to actually choose which seek steps are enabled.

'''Default:'''
<syntaxhighlight lang=xml enclose="div">
<seeksteps>7, 15, 30, 60, 180, 300, 600, 900, 1800</seeksteps>
</syntaxhighlight>

{{editor note|the defaults need to be updated for seeksteps.}}

=== touchscreen ===
{{anchor|.3Ctouchscreen.3E}}
This setting allows you to move/align the origin of the touch screen with the origin of the display used. If touch input does not result in a correct movement of the mouse pointer, the behaviour can be corrected with an offset and a stretch/compress factor.

Example:
<syntaxhighlight lang=xml enclose="div">
<touchscreen>
<x_offset>0</x_offset> 
<y_offset>0</y_offset> 
<x_stretch_factor>1.0</x_stretch_factor> 
<y_stretch_factor>1.0</y_stretch_factor> 
</touchscreen>
</syntaxhighlight>

== Other interface settings ==

=== window ===
{{anchor|.3Cwindow.3E}}
{{note|This is a "hidden" guisettings.xml setting (defined by the mouse moving the window size), but it is mentioned here because it is a particularly useful override when used in advancedsettings.xml}}
This allows you to manually set the default size of Kodi's windowed mode. If you resize the window, it will return to the set size when restarting.

WIDTH and HEIGHT are the values for each dimension, in pixels.

<syntaxhighlight lang=xml enclose="div">
<window>
<width>WIDTH</width>
<height>HEIGHT</height>
</window>
</syntaxhighlight>

=== restrictcapsmask ===
{{anchor|.3Crestrictcapsmask.3E}}
Windows only. A bitmask to prevent Kodi from using detected texture capabilities of the GPU. This helps work around buggy hardware/drivers.

1: prevent the use of compressed textures (DXT1, DXT3, DXT5)
2: prevent the use of non-power-of-two dimensions for textures
4: prevent the use of compressed textures with non-power-of-two dimensions.

<syntaxhighlight lang=xml enclose="div">
<restrictcapsmask>0</restrictcapsmask>
</syntaxhighlight>

=== algorithmdirtyregions ===
{{anchor|.3Calgorithmdirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="algorithmdirtyregions" />{{note|Some GPU/hardware configurations will have some minor issues (such as a visual "flicker"). For those situations try mode 2 or use the default (mode 3, which requires no advancedsetting). Almost all ARM-based devices (such as [[Android]]) willl likely have flickering issues.}}

Enable dirty-region processing. Dirty regions are any parts of the screen that have changed since the last frame. By not re-rendering what hasn't changed the GUI can be sped up. Because all GPUs work differently, only Mode 3, combined with nofliptimeout=0, is guaranteed to work for everyone without flickering issues. This mode will reduce CPU/GPU usage, but will not increase GUI speed.

{| class="prettytable"
! value !! result !! description
|-
! 0
| Off
| The entire viewport is always rendered.
|-
! 1
|Union
|All dirty regions are grouped into the smallest possible rectangle. This is typically the fastest mode for slower GPUs due to only making one pass.
|-
! 2
| {{nowrap|Cost reduction}}
| Each dirty region is presented separately, in as many passes as there are regions.
|-
! 3
| {{nowrap|Whole Screen}}
| The entire screen is rendered if there are any dirty regions. This, combined with nofliptimeout is a safe default for drivers that clear buffer contents (manifests as blinking or vibrating images). '''Default'''
|}<section end="algorithmdirtyregions" />

Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<algorithmdirtyregions>1</algorithmdirtyregions>
</gui>
</syntaxhighlight>

=== visualizedirtyregions ===
{{anchor|.3Cvisualizedirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="visualizedirtyregions" />Enable dirty-region visualization. Paints a rectangle over marked controls.

* true: on
* false: off '''(Default)'''

{{note|This is only a development mode and isn't of use to normal users.}}
<section end="visualizedirtyregions" />
Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<visualizedirtyregions>true</visualizedirtyregions>
</gui>
</syntaxhighlight>

=== smartredraw ===

{{note|This is an experimental feature and you might face issues using it. So please be aware of that.}}

This new feature was introduced in Kodi 18 and if enabled, the GUI process call (and therefore the render call) is only done if anything has changed. The result will be a faster GUI and less load if Kodi plays a video

* true: on
* false: off '''(Default)'''

Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<smartredraw>true</smartredraw>
</gui>
</syntaxhighlight>

=== showexitbutton ===
{{anchor|.3Cshowexitbutton.3E}}
Setting to hide the exit button, useful for people running appliance based setups where exit would only confuse/complicate the user. Modifiable via the advancedsettings.xml by setting showexitbutton to false, default is true (show)

Example:
<syntaxhighlight lang=xml enclose="div">
<showexitbutton>true</showexitbutton>
</syntaxhighlight>

=== fullscreen ===
{{anchor|.3Cfullscreen.3E}}
Starts Kodi in full screen (check resolutions!).

<syntaxhighlight lang=xml enclose="div">
<fullscreen>false</fullscreen>
</syntaxhighlight>

=== splash ===
{{anchor|.3Csplash.3E}}
Set to false if you wish to disable the startup splash image. Defaults to true.

<syntaxhighlight lang=xml enclose="div">
<splash>true</splash>
</syntaxhighlight>

=== cputempcommand ===
{{anchor|.3Ccputempcommand.3E}}
Provide a shell command Kodi will use to get CPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia and Raspberry Pi</u>
<syntaxhighlight lang=xml enclose="div">
<cputempcommand>sed -e 's/$[0-9]*$[0-9]\{3\}.*/\1 C/' /sys/class/thermal/thermal_zone0/temp</cputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang=xml enclose="div">
<cputempcommand>echo "$(sensors -u | tail -n64 | grep temp1_input | awk '{print $2 }' |awk '{printf("%d\n",$1 + 0.5);}') C"</cputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang=xml enclose="div">
<cputempcommand>sensors|sed -ne "s/temp1: \+[-+]$[0-9]\+$.*/\1 C/p"</cputempcommand>
</syntaxhighlight>

=== gputempcommand ===
{{anchor|.3Cgputempcommand.3E}}
Provide a shell command Kodi will use to get GPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia</u>
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>echo "$(nvidia-settings -tq gpuCoreTemp) C"</gputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>echo "$(nvidia-smi -q -d TEMPERATURE | grep Gpu | cut -c35-36) C"</gputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>/usr/bin/aticonfig --od-gettemperature | grep Temperature | cut -f 2 -d "-" | cut -f 1 -d "." | sed -e "s, ,," | sed 's/$/ C/'</gputempcommand>
</syntaxhighlight>

;<u>For Raspberry Pi</u>
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>/opt/vc/bin/vcgencmd measure_temp | sed -e "s/temp=//" -e "s/\..*'/ /"</gputempcommand>
</syntaxhighlight>

=== glrectanglehack ===
{{anchor|.3Cglrectanglehack.3E}}
Problems with ghosting or videos which are only played back in the left upper quarter? The following ATI hack may solve it.
<syntaxhighlight lang=xml enclose="div">
<glrectanglehack>yes</glrectanglehack>
</syntaxhighlight>

=== alwaysontop ===
{{anchor|.3Calwaysontop.3E}}
Added in XBMC v9.11 (Windows OS only). Keeps Kodi always on top when windowed.
<syntaxhighlight lang=xml enclose="div">
<alwaysontop>yes</alwaysontop>
</syntaxhighlight>

There is also a fake fullscreen GUI option in Kodi's settings.

== Removed tags ==
{{anchor|Recently removed tags}}
* {{anchor|.3Cthumbsize.3E}}'''<thumbsize>''' - replaced by <[[#imageres|imageres]]> in v12 Frodo
* {{anchor|.3Cfanartheight.3E}}'''<fanartheight>''' - replaced by <[[#fanartres|fanartres]]> in v12 Frodo
* {{anchor|.3Cdvdthumbs.3E}}'''<dvdthumbs>''' - removed in v12 Frodo
* {{anchor|.3Cbusydialogdelayms.3E}}'''<busydialogdelayms>''' - removed in v12 Frodo
* {{anchor|.3Cbginfoloadermaxthreads.3E}}'''<bginfoloadermaxthreads>''' - removed in v13 Gotham
* '''<showepginfoonselect>''' - replaced by a GUI setting in v13 Gotham
* '''<resample>''', '''<forceDirectSound>''', '''<audiophile>''', '''<audiosinkbufferdurationmsec>''', '''<allowtranscode44100>''', and '''<streamsilence>''' - These were various sub-tags for <audio> that were removed in v13 Gotham and either replaced by GUI settings or were no longer needed.
* {{anchor|.3Cenableairtunesdebuglog.3E}}'''<enableairtunesdebuglog>''' - replaced by a GUI option in v14 Helix
* '''<videoDisableHi10pMultithreading>''' - renamed to <disableswmultithreading> in v14 Helix
* '''<hideallitems>''' - For both the <code><videolibrary></code> and <code><musiclibrary></code> sections, this is replaced by a GUI option in v15 Isengard
* '''<SmallStepBackSeconds>''' - In v15 the <code>SmallStepBack</code> [[action ID]] has been replaced by <code>seek(-7)</code> in default keymaps. See '''[[skip steps]]''' for details. When the original <code>SmallStepBack</code> action ID is used it defaults to the first backwards [[skip steps|additive seeking value]].
* '''<timeseekforward>/<timeseekbackward>''' - In v15 these tags are replaced by GUI options via [[skip steps|additive seeking]], which is configured in the GUI. See '''[[skip steps]]''' for details.
* {{anchor|.3Ckaraoke.3E}}'''<karaoke>''' - In v16 all of the karaoke features in Kodi were removed.
* '''<useddsfanart>''' - removed in v17 Krypton.
* '''<cachemembuffersize>''' and '''<readbufferfactor>''' - In v17 '''<cachemembuffersize>''' is renamed to '''<memorysize>''' and <code><readbufferfactor></code> is renamed to <code><readfactor></code>. In addition, all three buffer related settings in <network> are moved out of <network> and into a new <cache> parent tag.
* '''<minvideocachelevel>''', '''<minaudiocachelevel>''', and '''<cacheindvdplayer>''' have been removed in v17.
* '''<useffmpegvda>''' - Tag was only used for development testing. Removed in v17.
* '''<nofliptimeout>''' - Removed in v17
* '''<blackbarcolour>''' - Removed in v17 (maybe?)
* '''<disableswmultithreading>''' - Removed in v17 (maybe?)
* {{anchor|.3Cmeasurerefreshrate.3E}}'''<measurerefreshrate>''' - Removed in v17 or v18?
* {{anchor|.3Cmyth.3E}}'''<myth>''' - Removed sometime between v16 to v18
* {{anchor|.3Ctuxbox.3E}}'''<tuxbox>''' - Removed
* '''<backgroundupdate>''' - Removed
* '''<hideemptyseries>''' - Replaced by a GUI option.
* '''<mymovies>''' and child tag '''<categoriestogenres>''' - Removed
* '''<albumssortbyartistthenyear'''> - Removed
* '''<albumformatright>''' - Removed
* {{anchor|.3Cremoterepeat.3E}}'''<remoterepeat>''' - Removed
* {{anchor|.3Callowd3d9ex.3E}}'''<allowd3d9ex>''' and {{anchor|.3Cforced3d9ex.3E}}'''<forced3d9ex>''' - Removed sometime between v16 to v18
* '''<lingertime>''' - Replaced by a GUI setting in v18
* '''<forcevaapienabled>''' - Removed in v18

== guisettings.xml settings ==
You can also define the settings normally defined in the GUI (and stored in guisettings.xml) in advancedsettings.xml. Most guisettings.xml settings defined in advancedsettings.xml will override the guisettings.xml values, and the settings will be removed completely from the interface.

The easiest way to include a guisettings.xml setting is to first change the setting in the interface to the value that you want, and then open the '''[[userdata]]/guisettings.xml''' file and find the XML entry that corresponds to that setting.

Then just add that entry to the advancedsettings.xml file.

For instance, to set the Font Character Set (found in the appearance setting, in the Look and Feel section), you'd open up guisettings.xml and find:

<syntaxhighlight lang=xml enclose="div">
<lookandfeel>
<charset>Hebrew (Windows)</charset>
</lookandfeel>
</syntaxhighlight>

Simply take that entry and place it in advancedsettings.xml. The option in Kodi's interface for the character set will then no longer be visible, and Kodi will always use the Hebrew (Windows) character set.

{{Updated|17}}
{{DISPLAYTITLE:advancedsettings.xml}}

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

Advancedsettings.xml

2019-02-06T09:52:23Z

Ksooo:

{{TOC right}}{{mininav|[[Settings]]|page=advancedsettings.xml}}
{{bigger|{{note|'''The advancedsettings.xml file does not exist by default. You have to create it first!'''}} }}

<section begin="intro" />The [[advancedsettings.xml]] file, which does not exist by default, can be created by a user in their '''[[userdata folder]]'''.

This file is used for advanced settings and options that do not have GUI controls inside of {{kodi}}. Some settings are experimental or very rarely set, so they can only be used via the advancedsettings.xml file. The file is simply a plain text file and can be edited by various text editors, so long as the name is "advancedsettings.xml". These advanced settings can be used to tweak various things such as episode naming patterns, special network ports, special behaviors, and more.<section end="intro" />

The following page will describe the structure of the advancedsettings.xml file and the various individual settings.

{{note|
# All XML tags must be lowercase. The start and end of the advancedsettings.xml file must have the <advancedsettings> and </advancedsettings> tags.
# Kodi will only read the advancedsettings.xml file when it starts up. If you make changes while it is running then you must restart Kodi.
# For some Windows versions, Kodi has two <code>\userdata\</code> folders. The correct one to put the advancedsettings.xml file in is not the one in Program Files, but in <code>%appdata%\Kodi\userdata\.</code>}}

== Layout ==

The layout of <code>advancedsettings.xml</code> is as follows:

<syntaxhighlight lang=xml enclose="div">
<advancedsettings>
<setting>value</setting>
...
<setting>value</setting>
</advancedsettings>
</syntaxhighlight>

where "setting" gives the name of the setting, and "value" gives its value.

A list of the available "setting" strings and their values is given below.

= List of available settings =

== Troubleshooting settings ==

=== loglevel ===
{{Anchor|.3Cloglevel.3E}}

<section begin="loglevel" />
Sets the logging level used to log errors and information. The "hide" attribute is optional.

<syntaxhighlight lang=xml>
<loglevel hide="attribute">options</loglevel>
</syntaxhighlight>

{| class="mw-collapsible mw-collapsed wikitable"
|-
! style="width:100px;" | Attribute
! style="width:500px;" | Action
|-
! '''true'''
| Hides the "enable debugging" setting in the Settings page. (default)
|-
! '''false'''
| Allows "enable debugging" setting to switch between '''0''' and '''2'''.
|}

{| class="mw-collapsible mw-collapsed wikitable"
|-
! style="width:100px;" | Option
! style="width:500px;" | Action
|-
! '''-1'''
| No logging, suppresses all log output
|-
! '''0'''
| Normal logging, only logging errors (default)
|-
! '''1'''
| Debug logging with freemem, fps and cpu usage (no on screen)
|-
! '''2'''
| Same as 1 (with on screen display)
|-
! '''3'''
| Same as 2 + full smb logging (no on screen display)
|}

{| class="mw-collapsible mw-collapsed wikitable"
|-
! style="width:100px;" | Example
! style="width:500px;" |
|-
! Example 1:
|<syntaxhighlight lang=xml enclose="div">
<advancedsettings>
<loglevel>2</loglevel>
</advancedsettings>
</syntaxhighlight>
|-
! Example 2:
|<syntaxhighlight lang=xml enclose="div">
<advancedsettings>
<loglevel hide="true">2</loglevel>
</advancedsettings>
</syntaxhighlight>
|}

'''Note:''' The setting is persistent through shutdown and restarts.<br>
'''Note:''' If debugging is enabled in the GUI, loglevel will be set to '''2'''. This will over-ride the <code>advancedsettings.xml</code> setting. You must disable the GUI Setting before adding the entry to <code>advancedsettings.xml</code>.<br />
<section end="loglevel" />
:''{{see also|Log_file|label 1=Debug Log}}''

=== jsonrpc ===
{{Anchor|.3Cjsonrpc.3E}}
To make it easier for developers using the [[JSON RPC]] API in their (third party) applications to debug during development the json output of Kodi can be prettified by setting '''compactoutput''' to '''false'''. Default json output mode is a compact print which does not contain any unnecessary whitespaces and therefore is difficult to read for humans.
Furthermore using the '''tcpport''' setting it is possible to change the default TCP port used by Kodi for JSON RPC (which is 9090) to any other valid port.

Example:
<syntaxhighlight lang=xml enclose="div">
<jsonrpc>
<compactoutput>false</compactoutput>
<tcpport>9999</tcpport>
</jsonrpc>
</syntaxhighlight>

== Audio/video playback settings ==

=== skiploopfilter ===
{{anchor|.3Cskiploopfilter.3E}}
The amount of the loop filter to skip on h.264 decoding. This can help the performance of slower machines when decoding h264 content. Values, in decreasing CPU usage (and decreasing quality)
* -16 None
* 0 Skip only empty frames (default)
* 8 Skip non-reference frames
* 16 Skip bi-dir frames
* 32 Skip all non-key frames
* 48 Skip all frames
Example:
<syntaxhighlight lang=xml enclose="div">
<skiploopfilter>8</skiploopfilter>
</syntaxhighlight>

=== video ===
{{anchor|.3Cvideo.3E}}

The <video> section also includes the following child-tags, which have their own sections:
*[[#cleandatetime]]
*[[#cleanstrings]]
*[[#excludefromscan]]
*[[#excludefromlisting]]
*[[#excludetvshowsfromscan]]

{{note|Some tags that have a "third-level" and are grouped together are highlighted in color.}}

{| class="prettytable"
! Tag !! Description
|-
|
<syntaxhighlight lang=xml>
<video>
</syntaxhighlight>
| Parent tag that all other child tags need to be placed inside of. Do not use more than one '''<code><video></code>''' tag, but instead place all other child-tags within a single '''<code><video></video></code>''' set.
|-
|
<syntaxhighlight lang=xml>
<subsdelayrange>10</subsdelayrange>
</syntaxhighlight>
| Delay range for subtitles, in seconds.
|-
|
<syntaxhighlight lang=xml>
<audiodelayrange>10</audiodelayrange>
</syntaxhighlight>
| Delay range for audio/video sync, in seconds.
|-
|
<syntaxhighlight lang=xml>
<usetimeseeking>true</usetimeseeking>
</syntaxhighlight>
| Whether to use time based or percentage based seeking. {{small see also|HOW-TO:Modify time seeking}}
|-
|
<syntaxhighlight lang=xml>
<timeseekforwardbig>600</timeseekforwardbig>
<timeseekbackwardbig>-600</timeseekbackwardbig>
</syntaxhighlight>
| Time to seek forward in seconds when doing a long seek. Defaults to 600 (10 minutes) and -600 (-10 minutes) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang=xml>
<percentseekforward>2</percentseekforward>
<percentseekbackward>-2</percentseekbackward>
</syntaxhighlight>
| Amount to seek forward as a percentage, when doing a short seek. Defaults to 2 (2%) and -2 (2%) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang=xml>
<percentseekforwardbig>10</percentseekforwardbig>
<percentseekbackwardbig>-10</percentseekbackwardbig>
</syntaxhighlight>
| Amount to seek forward as a percentage, when doing a long seek. Defaults to 10 (10%) and -10 (10%) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang=xml>
<fullscreenonmoviestart>true</fullscreenonmoviestart>
</syntaxhighlight>
| Whether to go to fullscreen or not when starting a movie. Defaults to true.
|-
|
<syntaxhighlight lang=xml>
<defaultplayer>VideoPlayer</defaultplayer>
</syntaxhighlight>
| Set the default video player: VideoPlayer or an external player. See '''[[External players]]''' for more info.
|-
|
<syntaxhighlight lang=xml>
<excludefromscan>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromscan>
</syntaxhighlight>
| Regular expressions that if evaluated to true won't be added to library. It is possible to add multiple <code><regexp></code> tags to match multiple patterns
|-
|
<syntaxhighlight lang=xml>
<excludefromlisting>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>
</syntaxhighlight>
| Regular expressions that if evaluated to true won't be displayed in files view.
|-
|
<syntaxhighlight lang=xml>
<playcountminimumpercent>90</playcountminimumpercent>
</syntaxhighlight>
| Minimum percentage that has to be played before it is marked as watched. Set to 101 to never auto-mark items as watched. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang=xml>
<ignoresecondsatstart>180</ignoresecondsatstart>
</syntaxhighlight>
| Number of seconds to ignore at video start after which a resume point is created. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang=xml>
<ignorepercentatend>8</ignorepercentatend>
</syntaxhighlight>
| Percentage of video to ignore at the end. If you stop watching the video here no resume point is created. Set to 101 to never save a resume point. The video is already marked as watched at 90%, see above. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang=xml>
<vdpauscaling>true</vdpauscaling>
</syntaxhighlight>
| Scales with vdpau instead of opengl and turns on its HQ scaler when available, enabling this might slow down rendering and cause framedrops especially on ION systems, this setting requires a vdpau feature set C GPU.
|-
|
<syntaxhighlight lang=xml>
<enablehighqualityhwscalers>true</enablehighqualityhwscalers>
</syntaxhighlight>
| Allow turning on the spline36 and lanczos3 shader (for GL builds).
|-
|
<syntaxhighlight lang=xml>
<dxvaallowhqscaling>false</dxvaallowhqscaling>
</syntaxhighlight>
| Enables high quality video upscaling for Windows.
|-
|
<syntaxhighlight lang=xml>
<ppffmpegdeinterlacing>linblenddeint</ppffmpegdeinterlacing>
</syntaxhighlight>
| Override the deinterlacing options passed to libpostproc.
|-
|
<syntaxhighlight lang=xml>
<ppffmpegpostprocessing>ha:128:7,va,dr</ppffmpegpostprocessing>
</syntaxhighlight>
| Override the post processing options passed to libpostproc when 'Video post-processing' is activated in GUI Videos-Settings-Playback.
|-
|
<syntaxhighlight lang=xml>
<autoscalemaxfps>30</autoscalemaxfps>
</syntaxhighlight>
| When scaling method is set to auto, bilinear is chosen when the fps is higher than this limit, the default is 30.
|-
|
<syntaxhighlight lang=xml>
<adjustrefreshrate>
</syntaxhighlight>
| style="background:#CADCFB;" | Settings for when "Adjust refreshrate to match video fps" is enabled in the video playback GUI settings.
|-
|
<syntaxhighlight lang=xml>
<override>
<fps>23.976</fps>
<refresh>60.0</refresh>
</override>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' "Adjust refreshrate to match video fps" will try to select the best refreshrate for the video fps but it doesn't always get it right, for example it might switch to an unsupported refreshrate. You can add overrides here to switch to a certain refreshrate based on video fps. It's possible to add as many overrides as you need. Overrides are processed in order, if the first one doesn't match the fps or no refreshrates match that override, it will try the next one until no overrides are left.

* '''fps''' - if the fps is between 23.966 and 23.986
* '''refresh''' - switch to the first found refreshrate that is between 59.99 and 60.01
|-
|
<syntaxhighlight lang=xml>
<override>
<fpsmin>29.96</fpsmin>
<fpsmax>30.01</fpsmax>
<refreshmin>59.0</refreshmin>
<refreshmax>61.0</refreshmax>
</override>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -'''
* '''fpsmin''' / '''fpsmin''' - You can also specify the fps range yourself.
* '''refreshmin''' / '''refreshmax''' - Same for the refreshrate
|-
|
<syntaxhighlight lang=xml>
<fallback>
<refresh>50.0</refresh>
</fallback>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' If none of the overrides match, or none of the refreshrates match any of the fps matching overrides, it will choose a fallback refreshrate. Fallbacks are process in order, if the first fallback doesn't match any refreshrate, it will try the next one until no fallbacks are left.

* '''refresh''' - Switch to the first found refreshrate that is between 49.99 and 50.01.
|-
|
<syntaxhighlight lang=xml>
<fallback>
<refreshmin>49.0</refreshmin>
<refreshmax>51.0</refreshmax>
</fallback>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' You can also specify the range for the fallback yourself.

If none of the overrides match the video fps, or no refreshrates match any of the fps matching overrides, and no fallbacks are specified or no refreshrates match any fallbacks, it will automatically choose the best refreshrate (same as having no overrides and fallbacks).
|-
|
<syntaxhighlight lang=xml>
</adjustrefreshrate>
</syntaxhighlight>
| style="background:#CADCFB;" |
|-
|
<syntaxhighlight lang=xml>
<checkdxvacompatibility>value</checkdxvacompatibility>
</syntaxhighlight>
| Advanced setting not present: let Kodi autodetect cards that support H.264 profile > L4.1. Set value to false to enable DXVA no matter what. Set value to true if Kodi doesn't autodetect that the graphics card doesn't support > L4.1.
|-
|
<syntaxhighlight lang=xml>
<useocclusionquery>-1</useocclusionquery>
</syntaxhighlight>
| Use an occlusion query when capturing videoframes, -1 means auto detect, 0 means disabled, 1 means enabled, the default is -1.
|-
|
<syntaxhighlight lang=xml>
<fpsdetect>1</fpsdetect>
</syntaxhighlight>
| FPS detection for video playback
* 0 = trust codec fps
* 1 = recalculate from video timestamps with uniform spacing
* 2 = recalculate from video timestamps always
|-
|
<syntaxhighlight lang=xml>
<latency>
</syntaxhighlight>
| style="background:#F0E68C;"| Start of '''latency''' tags. Display latency (video lag). Latency is given in msecs.
|-
|
<syntaxhighlight lang=xml>
<delay>0</delay>
</syntaxhighlight>
| style="background:#F0E68C;" | Global default display latency.
|-
|
<syntaxhighlight lang=xml>
<refresh></refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | Override latency for given display (not video) refresh rates. When Kodi is in windowed mode, override is ignored. Multiple overrides are allowed.

Syntax of an override entry:
<syntaxhighlight lang=xml>
<refresh>
<min>, <max> refresh rate range, OR
<rate> exact refresh rate
<delay> display latency for the given refresh rate
</refresh>
</syntaxhighlight>
|-
|
<syntaxhighlight lang=xml>
<refresh>
<min>23</min>
<max>24</max>
<delay>125</delay>
</refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | '''Example:''' display has 125 msec latency at 23-24 Hz
|-
|
<syntaxhighlight lang=xml>
<refresh>
<rate>50</rate>
<delay>50</delay>
</refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | '''Example:''' display has 50 msec latency at 50 (+/-0.01) Hz
|-
|
<syntaxhighlight lang=xml>
</latency>
</syntaxhighlight>
| style="background:#F0E68C;" |
|-
|
<syntaxhighlight lang=xml>
<stereoscopicregex3d>[-. _]3d[-. _]</stereoscopicregex3d>
<stereoscopicregexsbs>[-. _]h?sbs[-. _]</stereoscopicregexsbs>
<stereoscopicregextab>[-. _]h?tab[-. _]</stereoscopicregextab>
</syntaxhighlight>
| Filename triggers for 3D (stereoscopic) mode.
|-
|
<syntaxhighlight lang=xml>
<assfixedworks>false</assfixedworks>
</syntaxhighlight>
| Position behavior of ass subtitiles when setting "subtitle position on screen" set to "fixed". True to show at the fixed position set in video calibration. False to show at the bottom of video (default).
|-
|
<syntaxhighlight lang=xml>
</video>
</syntaxhighlight>
|
|}

=== audio ===
{{anchor|.3Caudio.3E}}
<syntaxhighlight lang=xml enclose="div">
<audio>

<headroom>0</headroom>

<defaultplayer>paplayer</defaultplayer>

<excludefromscan>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromscan>

<excludefromlisting>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromlisting>

<ac3downmixgain>12.0</ac3downmixgain>

<usetimeseeking>true</usetimeseeking>

<timeseekforwardbig>600</timeseekfowardbig>

<timeseekbackwardbig>-600</timeseekbackward>

<playcountminimumpercent>99</playcountminimumpercent>

<applydrc>-1.0</applydrc>

<limiterhold>0.025</limiterhold>

<limiterrelease>0.1</limiterrelease>
</audio>
</syntaxhighlight>

For more information on the configuration of audio under Frodo see [[AudioEngine/HOW-TO: Configure audio]]

=== edl ===
{{anchor|.3Cedl.3E}}
{{main|EDL}}
Commercial break detection not as good you think it could be? Are some commercial breaks in a series of adverts not being skipped? Are some parts being skipped that are clearly not commercials? Does the end of the previous recording still show? The following advanced settings can be used to better identify full commercial break sequences, remove incorrectly flagged commercial breaks, and have playback start at the actual beginning of the recording.

<syntaxhighlight lang=xml enclose="div">
<edl>

<mergeshortcommbreaks>false</mergeshortcommbreaks>

<maxcommbreaklength>250</maxcommbreaklength>

<mincommbreaklength>90</mincommbreaklength>

<maxcommbreakgap>120</maxcommbreakgap>

<commbreakautowait>0</commbreakautowait>

<commbreakautowind>0</commbreakautowind>
</edl>
</syntaxhighlight>

=== pvr ===
{{anchor|.3Cpvr.3E}}
<syntaxhighlight lang=xml enclose="div">
<pvr>
<timecorrection>0</timecorrection> 
<infotoggleinterval>3000</infotoggleinterval> 
<channeliconsautoscan>true</channeliconsautoscan> 
<autoscaniconsuserset>false</autoscaniconsuserset> 
<numericchannelswitchtimeout>1000</numericchannelswitchtimeout> 
</pvr>
</syntaxhighlight>

=== epg ===
{{anchor|.3Cpvr.3E}}
<syntaxhighlight lang=xml enclose="div">
<epg>
<updatecheckinterval>300</updatecheckinterval> 
<updateemptytagsinterval>60</updateemptytagsinterval> 
<cleanupinterval>900</cleanupinterval> 
<activetagcheckinterval>60</activetagcheckinterval> 
<retryinterruptedupdateinterval>60</retryinterruptedupdateinterval> 
<displayupdatepopup>true</displayupdatepopup> 
<displayincrementalupdatepopup>false</displayincrementalupdatepopup> 
</epg>
</syntaxhighlight>

=== forcedswaptime ===
{{anchor|.3Cforcedswaptime.3E}}
Use to force a backbuffer->frontbuffer swap while vsync is enabled. Set to the time (in ms) to allow for the swap (e.g. <forcedswaptime>1</forcedswaptime> is typical).

Default: Off



== Video library settings ==

=== videoextensions ===
{{anchor|.3Cvideoextensions.3E}}<section begin="videoextensions" />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Video windows.

Default extensions for VIDEOS:
<pre>
.m4v .3g2 .3gp .nsv .tp .ts .ty .strm .pls .rm .rmvb .mpd .m3u .m3u8 .ifo .mov .qt .divx .xvid
.bivx .vob .nrg .pva .wmv .asf .asx .ogm .m2v .avi .dat .mpg .mpeg .mp4 .mkv .mk3d .avc .vp3
.svq3 .nuv .viv .dv .fli .flv .001 .wpl .vdr .dvr-ms .xsp .mts .m2t .m2ts .evo .ogv .sdp .avs
.rec .url .pxml .vc1 .h264 .rcv .rss .mpls .webm .bdmv .wtv .trp .f4v
</pre>
Examples:
<pre>
<videoextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</videoextensions>
</pre>
<section end="videoextensions" />

=== discstubextensions ===
{{main|Media stubs}}

<section begin="discstubextensions" />
The default filename extension for Disc Stubs is:
<syntaxhighlight lang=xml enclose="div">
.disc
</syntaxhighlight>
Using the following tags, it is possible to <tt><add></tt> additional or <tt><remove></tt> existing disc stub extensions to better suit your requirements.
<syntaxhighlight lang=xml enclose="div">
<discstubextensions>
<add>.disk|.stub</add>
<remove>.disc</remove>
</discstubextensions>
</syntaxhighlight>
<section end="discstubextensions" />

=== languagecodes ===
{{anchor|.3Clanguagecodes.3E}}
Translation table for subtitle and audio names. Contains entries of the form

<syntaxhighlight lang=xml enclose="div">
<languagecodes>
<code>
<short>alt</short>
<long>Alternate</long>
</code>
</languagecodes>
</syntaxhighlight>

=== moviestacking ===
{{anchor|.3Cmoviestacking.3E}}<section begin="moviestacking" />
{{main|File stacking}}
This is used by the [[file stacking]] algorithm to combine multi-part files and contains a list of "''[[Regular Expression (RegEx) Tutorial|regular expressions]]''". For stacking videos that are contained in folders, such as VIDEO_TS folders, see '''[[advancedsettings.xml#folderstacking|<folderstacking>]]'''

As of v9.11, video stacking regular expressions '''must''' contain exactly four (4) capture expressions.

Default:
<syntaxhighlight lang=xml enclose="div">
<moviestacking>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[0-9]+)(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[a-d])(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ ._-]*[a-d])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="append"</tt> or <tt>append="yes"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the end.

Example:
<syntaxhighlight lang=xml enclose="div">
<moviestacking action="append">

<regexp>(.*?)([ ._-]*[0-9])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="prepend"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the beginning.

Example:
<syntaxhighlight lang=xml enclose="div">
<moviestacking action="prepend">
<regexp>(Title)(Volume)(Ignore)(Extension)</regexp>
</moviestacking>
</syntaxhighlight>

If no argument is supplied, or the argument <tt>append="no"</tt> is supplied, the default moviestacking regular expressions are overwritten by the user specified ones.
<section end="moviestacking" />

=== folderstacking ===
{{main|File stacking}}
This is similar to '''[[advancedsettings.xml#moviestacking|<moviestacking>]]''', but is used for videos that are contained in folders that use the folder names to stack, such as VIDEO_TS folders (DVD rips that are not in ISO format).

Default:
<syntaxhighlight lang=xml enclose="div">
<folderstacking>

<regexp>((cd|dvd|dis[ck])[0-9]+)$</regexp>
</folderstacking>
</syntaxhighlight>

=== cleandatetime ===
{{anchor|.3Ccleandatetime.3E}}
Matches a year number in a string using a ''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''

Default expression:
<syntaxhighlight lang=xml enclose="div">
<video>
<cleandatetime>(.+[^ _\,\.\[\]\-])[ _\.\[\]\-]+(19[0-9][0-9]|20[0-1][0-9])([ _\,\.\[\]\-][^0-9]|$)</cleandatetime>
</video>
</syntaxhighlight>
:* The string found before will be used as basis string getting cleaned by the cleanstrings expressions.
:* By default date formats like MM:YY are ignored.

=== cleanstrings ===
{{anchor|.3Ccleanstrings.3E}}
Clean unwanted characters from filenames or folders by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. Please note that everything right of the match (at the end of the file name) is removed, so if you would have a file named ''Super movie.mp4'' and would add <tt><regexp> </regexp></tt> (only a space), the only thing that would be left is ''Super'', which is probably not what you want.

Default expressions:
<syntaxhighlight lang=xml enclose="div">
<video>
<cleanstrings>
<regexp>[ _\,\.\[\]\-](ac3|dts|custom|dc|divx|divx5|dsr|dsrip|dutch|dvd|dvdrip|dvdscr|dvdscreener|screener|dvdivx|cam|fragment|fs|hdtv|hdrip|hdtvrip|internal|limited|multisubs|ntsc|ogg|ogm|pal|pdtv|proper|repack|rerip|retail|cd[1-9]|r3|r5|bd5|se|svcd|swedish|german|read.nfo|nfofix|unrated|ws|telesync|ts|telecine|tc|brrip|bdrip|480p|480i|576p|576i|720p|720i|1080p|1080i|hrhd|hrhdtv|hddvd|bluray|x264|h264|xvid|xvidvd|xxx|www.www|\[.*\])([ _\,\.\[\]\-]|$)</regexp>
<regexp>(\[.*\])</regexp>
</cleanstrings>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== tvshowmatching ===
{{anchor|.3Ctvshowmatching.3E}}
Matches the season and episode numbers in file paths by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

Defaults:
<syntaxhighlight lang=xml enclose="div">
<tvshowmatching>
<regexp>s([0-9]+)[ ._x-]*e([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)([^\\\\/]*)$</regexp> 
<regexp>[\._ -]()[Ee][Pp]_?([0-9]+)([^\\/]*)$</regexp> 
<regexp>([0-9]{4})[\.-]([0-9]{2})[\.-]([0-9]{2})</regexp> 
<regexp>([0-9]{2})[\.-]([0-9]{2})[\.-]([0-9]{4})</regexp> 
<regexp>[\\/\._ \[\(-]([0-9]+)x([0-9]+)([^\\/]*)$</regexp> 
<regexp>[\\/\._ -]([0-9]+)([0-9][0-9])([\._ -][^\\/]*)$</regexp> 
<regexp>[\/._ -]p(?:ar)?t[_. -]()([ivx]+)([._ -][^\/]*)$</regexp> 
</tvshowmatching>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)
:* Paths are converted to lower case before matching.
:* Examples of matching regexps for certain filenames can be found on the [[TV Shows (Video Library)|TV shows]] page.

:* For multi-episode matching to work, there needs to be a third set of parentheses '()' at the end, this part is fed back into the regexp engine.

:* A [https://forum.kodi.tv/showthread.php?tid=51614 forum thread] has a discussion of pre-made regex lists to match common names. These might improve Kodi's ability to match TV show names in some situations, at the risk of additional false positives.

==== Filenames without Season ====
There are two methods to add episodes without a season in their file path. Both ways will force the season to '1' by default, so that you can use
the 'Use Absolute Ordering (Single Season)' setting from the TheTvDb.com scraper.

; Simple Method ''(XBMC v9.11 onwards and Kodi)''
: Use only one pair of parentheses
<syntaxhighlight lang=xml enclose="div"><regexp>[/\._ \-]([0-9]+)</regexp></syntaxhighlight>
; Advanced Method ''(XBMC v10.05 onwards and Kodi)''
: Supports multi-episode files without season
: Use an empty pair of parentheses for the season
<syntaxhighlight lang=xml enclose="div"><regexp>[/\._ \-]()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

; Specifying Default Season ''(XBMC v12.0 onwards and Kodi)''
It is possible to set the default season for specific regular expressions by setting the 'defaultseason' attribute.
: Works with both the simple method and advanced method
: If not used, the season will be set to '1'
: Useful for setting specials to season '0'
<syntaxhighlight lang=xml enclose="div"><regexp defaultseason="0">[/\._ \-]X()([0-9]+)(-[0-9]+)?</regexp>
<regexp defaultseason="1">[/\._ \-]E()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

=== tvmultipartmatching ===
{{anchor|.3Ctvmultipartmatching.3E}}
Matches a multipart episode number based on a previously identified episode file, using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''.

Default:
<syntaxhighlight lang=xml enclose="div">
<tvmultipartmatching>^[-_ex]+([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)</tvmultipartmatching>
</syntaxhighlight>
:* Text matching is compared case-insensitive.
:* Specifying this option '''replaces''' the default value

=== excludefromscan ===
{{anchor|.3Cexcludefromscan.3E}}
Matches filenames or folders which should be excluded from a library scan (except tvshows) using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. This can be for both Video or Audio sections of <tt>advancedsettings.xml</tt>.

Defaults:
<syntaxhighlight lang=xml enclose="div">
<video>
<excludefromscan>
<regexp>-trailer</regexp>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludefromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== excludefromlisting ===
{{anchor|.3Cexcludefromlisting.3E}}
<syntaxhighlight lang=xml enclose="div">
<video>
<excludefromlisting> 
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>
</video>
</syntaxhighlight>

=== excludetvshowsfromscan ===
{{anchor|.3Cexcludetvshowsfromscan.3E}}
Matches filenames or folders which should be excluded from a tvshow library scan using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

Defaults:
<syntaxhighlight lang=xml enclose="div">
<video>
<excludetvshowsfromscan>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludetvshowsfromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== trailermatching ===
{{anchor|.3Ctrailermatching.3E}}
Contains "''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''" syntax (commonly referred to as "''[[Regular Expression (RegEx) Tutorial|RegEx]]''" or "''[[Regular Expression (RegEx) Tutorial|RegExp]]''") to match the locally stored trailers to movies in the library.

<syntaxhighlight lang=xml enclose="div">
<trailermatching>

<regexp>(.*?)(_Trailer)(\.[^.]+)$</regexp>
</trailermatching>
</syntaxhighlight>

=== videolibrary ===
{{anchor|.3Cvideolibrary.3E}}
Options specific to the Video Library

<syntaxhighlight lang=xml enclose="div">
<videolibrary>
<allitemsonbottom>false</allitemsonbottom> 
<cleanonupdate>false</cleanonupdate> 
<usefasthash>true</usefasthash> 
<recentlyaddeditems>35</recentlyaddeditems> 
<itemseparator> / </itemseparator> 
<exportautothumbs>false</exportautothumbs> 
<importwatchedstate>false</importwatchedstate> 
<importresumepoint>false</importresumepoint> 
<dateadded>1</dateadded> 
</videolibrary>
</syntaxhighlight>

==== Extra artwork ====

New for Kodi v18.
Configuration to expand the artwork automatically added by Kodi to media items in the library, either from local files or online scrapers.

The original basic artwork types are still hardcoded so they don't need to be configured here (and can't be removed). "poster" and "fanart" for movies, movie sets, TV shows, seasons, and music videos; "banner" for TV shows and seasons; and "thumb" for episodes.

<syntaxhighlight lang=xml enclose="div">
<videolibrary>


<tvshowextraart>
<arttype>characterart</arttype>
<arttype>clearart</arttype>
<arttype>clearlogo</arttype>
<arttype>landscape</arttype>
<arttype>keyart</arttype>
</tvshowextraart>

<tvseasonextraart>
<arttype>landscape</arttype>
</tvseasonextraart>

<episodeextraart>
<arttype>fanart</arttype>
</episodeextraart>

<movieextraart>
<arttype>banner</arttype>
<arttype>clearart</arttype>
<arttype>clearlogo</arttype>
<arttype>discart</arttype>
<arttype>landscape</arttype>
<arttype>keyart</arttype>
</movieextraart>

<moviesetextraart>
<arttype>banner</arttype>
<arttype>clearart</arttype>
<arttype>clearlogo</arttype>
<arttype>discart</arttype>
<arttype>landscape</arttype>
<arttype>keyart</arttype>
</moviesetextraart>

<musicvideoextraart>
<arttype>banner</arttype>
<arttype>clearart</arttype>
<arttype>clearlogo</arttype>
<arttype>discart</arttype>
<arttype>landscape</arttype>
</musicvideoextraart>
</videolibrary>
</syntaxhighlight>

=== videoscanner ===
{{anchor|.3Cvideoscanner.3E}}
Options specific to the Video scanner
<syntaxhighlight lang=xml enclose="div">
<videoscanner>
<ignoreerrors>true</ignoreerrors> 
</videoscanner>
</syntaxhighlight>

== Library artwork ==

{{note|Using <imageres>9999</imageres> and <fanartres>9999</fanartres> will allow caching artwork at original size.}}

=== imageres ===
{{anchor|.3Cimageres.3E}}

<section begin="imageres description" />Specify the maximum resolution that [[Artwork/Cache#Texture optimization| cached artwork]] (other than fanart / 16:9 images) should be resized to in pixels. The width is automatically calculated as being 16/9*height. The image will be resized to fit within this size. e.g. an image that is 2000x500 will be cached at size 1280x320. An image that is 500x800 will be cached at size 450x720 using the default value of 720.<section end="imageres description" />

<syntaxhighlight lang=xml enclose="div">
<imageres>720</imageres>
</syntaxhighlight>

=== fanartres ===
{{anchor|.3Cfanartres.3E}}

<section begin="fanartres description" />Specify the maximum resolution that [[Artwork/Cache#Texture optimization| cached fanart]] should be resized to in pixels. The width is automatically calculated as being 16/9*height. Only images that are exactly 16x9 and equal to or greater than this resolution will be cached at this size - all other images will be cached using <imageres>. The default value is 1080.<section end="fanartres description" />

<syntaxhighlight lang=xml enclose="div">
<fanartres>1080</fanartres>
</syntaxhighlight>

=== fanart ===
{{anchor|.3Cfanart.3E}}
Only used for music and not video.

A list of additional files to try when searching for local fanart images. (The defaults are fanart.jpg and fanart.png which can be removed.)

Example:
<syntaxhighlight lang=xml enclose="div">
<fanart>
<remove>fanart.jpg</remove>
<add>backdrop.jpg</add>
</fanart>
</syntaxhighlight>

=== musicthumbs ===
{{anchor|.3Cmusicthumbs.3E}}
<section begin="musicthumbs" />A list of additional files to try when searching for music thumbnail images. (The default is folder.jpg which can be removed.)

Example:
<syntaxhighlight lang=xml enclose="div">
<musicthumbs>
<remove>folder.jpg</remove>
<add>thumb.jpg|cover.jpg</add>
</musicthumbs>
</syntaxhighlight><section end="musicthumbs" />

=== imagescalingalgorithm ===
Specify the image scaling algorithm for image resizing when [[Artwork/Cache#Texture optimization| caching artwork]] to the local texture cache.
<br />
<syntaxhighlight lang=xml enclose="div">
<imagescalingalgorithm>bicubic</imagescalingalgorithm>
</syntaxhighlight>

[https://github.com/xbmc/xbmc/blob/1a8753d5cd93890dc6a9f9d4b2ce8848066ea5d0/xbmc/pictures/PictureScalingAlgorithm.cpp#L32-L43 Available image scaling algorithms]

<syntaxhighlight lang=text enclose="div">
fast_bilinear
bilinear
bicubic
experimental
nearest_neighbor
averaging_area
bicublin
gaussian
sinc
lanczos
bicubic_spline
</syntaxhighlight>

== Video and music library settings ==

=== playlistasfolders ===
{{anchor|.3Cplaylistasfolders.3E}}
In the recent releases, playlists are treated as folders. Selecting a playlist no longer plays it, but opens it, as if it were a folder.

Set to false to revert to the previous behaviour. When you select a playlist, its content is added to the list of elements to be played.

:{{note|This setting will not affect smart playlists, they will always show as folders.}}

;Example
<syntaxhighlight lang=xml enclose="div">
<playlistasfolders>true</playlistasfolders>
</syntaxhighlight>

=== playlistretries ===
{{anchor|.3Cplaylistretries.3E}}
The number of retries attempted if a source is offline. With this control you can alter the number of consecutive failed items before a playlist fails.

Default:
<syntaxhighlight lang=xml enclose="div">
<playlistretries>100</playlistretries>
</syntaxhighlight>

=== playlisttimeout ===
{{anchor|.3Cplaylisttimeout.3E}}
The timeout, in seconds, before item failure.

Default:
<syntaxhighlight lang=xml enclose="div">
<playlisttimeout>20</playlisttimeout>
</syntaxhighlight>

=== sorttokens ===
Allows you to specify additional tokens that will be ignored at the start of lines during sorting.
{{note|Sort tokens are case sensitive.}}
<syntaxhighlight lang=xml enclose="div">
<sorttokens>
<token>the</token>
</sorttokens>
</syntaxhighlight>

In the above example "the ", "the." and "the_" will be ignored at the start of titles or names when sorting items, in both video and music libraries. A separator can also be specified, for example
<syntaxhighlight lang=xml enclose="div">
<sorttokens>
<token separators="'">L</token>
</sorttokens>
</syntaxhighlight>
In that case the value L', as in French movie name ''L'argent'', will be ignored and the item listed under "A".

=== musicdatabase/videodatabase ===
{{anchor|.3Cmusicdatabase.3E/.3Cvideodatabase.3E|musicdatabase/videodatabase|database tags music/video/tv/epg/adsp}}
{{main|MySQL}}
<section begin="videodatabase" />
Allows advanced customization of the default database settings for music, video, TV, EPG, and ADSP databases.

:{{note| '''It is HIGHLY recommended that you not attempt to place an sqlite3 database outside of kodi's path. sqlite3 contains no filesystem abstraction, so this will plain break on any non-local (as far as Kodi is concerned) paths. Use this for mysql only.'''}}

'''Parent tags:'''

* '''<videodatabase>'''
* '''<musicdatabase>'''
* '''<tvdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
* '''<epgdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
* '''<adspdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
{{MySQL warning}}

'''Child tags: '''

;<type>
: ''Required'' - Can be either "sqlite3" or "mysql" (default: sqlite3)

;<host>
:''Required'' -
* sqlite3: defines the relative path to the database file (eg. /usr/local/kodi/databases).
* mysql: defines the host of the mysql socket (eg. localhost, 192.168.0.1, etc)

;<port>
: ''Optional'' -
* sqlite3: silently ignored
* mysql: defines the port of the mysql socket (default: 3306)

;<name>
: ''Optional'' -
:by default "MyVideos"+DB number will be used.
* sqlite3: defines the name of the database file to read from, excluding the ".db" extension.
* mysql: defines the name of the database to use

;<user>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the user with privileged access to the database

;<pass>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the password for the user with privileged access to the database

;<compression>
: ''Optional'' - Defaults to false. Set to "true" to enable MySQL compression protocol. Performance benefit is going to be largely dependent on the network bandwidth, latency between database and clients and on the size of the result sets. [https://github.com/xbmc/xbmc/pull/6484]
: {{Note|Slower clients (such as the RPi and others) won't benefit from it as the zlib de-compression overhead is higher than the actual compression savings}}

;<key>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<cert>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ca>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<capath>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ciphers>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

'''Examples:'''

1) Configure a database for MySQL.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', '''<epgdatabase>''', and '''<adspdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang=xml enclose="div">
<videodatabase>
<type>mysql</type>
<host>192.168.0.10</host>
<name>kodi_video</name>
<user>kodi</user>
<pass>kodi</pass>
</videodatabase>
</syntaxhighlight>

2) Configure a database for an sqlite database.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', '''<epgdatabase>''', and '''<adspdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang=xml enclose="div">
<musicdatabase>
<type>sqlite3</type>
<host>/usr/local/share/kodi/databases</host>
</musicdatabase>
</syntaxhighlight>

<section end="videodatabase" />

=== externalplayer ===
{{anchor|.3Cexternalplayer.3E}}
{{see|External players}}

== Music settings ==

=== musicextensions ===
{{anchor|.3Cmusicextensions.3E}}
<section begin="musicextensions" />
Default extensions for MUSIC:
<pre>
.nsv .m4a .flac .aac .strm .pls .rm .rma .mpa .wav .wma .ogg .mp3 .mp2 .m3u .gdm .imf .m15 .sfx
.uni .ac3 .dts .aif .aiff .wpl .ape .mac .mpc .mp+ .mpp .shn .wv .dsp .xsp .xwav .waa .wvs .wam
.gcm .idsp .mpdsp .mss .spt .rsd .sap .cmc .cmr .dmc .mpt .mpd .rmt .tmc .tm8 .tm2 .oga .url
.pxml .tta .rss .wtv .mka .tak .opus .dff .dsf .m4b .cue .zip .rar
</pre>

It is possible to add or remove extensions for Music, using the following XML tags. Useful if you keep, say, FLAC and mp3 versions of music in the same folder. The <remove> tag can be used to remove mp3 from being listed in the library, leaving only the higher quality FLAC being displayed.

<musicextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</musicextensions>

<section end="musicextensions" />

=== cddbaddress ===
{{anchor|.3Ccddbaddress.3E}}
The address of the online CDDb database. You may set this to another freedb mirror if there is a more suitable one.

Default:
<syntaxhighlight lang=xml enclose="div>
<cddbaddress>freedb.freedb.org</cddbaddress>
</syntaxhighlight>

=== songinfoduration ===
{{anchor|.3Csonginfoduration.3E}}
This controls how long the song information will remain onscreen when the song changes during visualisations. The valid range is "1" to "Indefinite (0)", in seconds. This does not include the duration of any transition effects.

Default:
<syntaxhighlight lang=xml enclose="div">
<songinfoduration>10</songinfoduration>
</syntaxhighlight>

=== musicfilenamefilters ===
{{anchor|.3Cmusicfilenamefilters.3E}}
Contains filters to match music information (artist, title etc.) from a tag-less music filename. The first <filter> to match completely is used. Matched items include:

<pre>
%A - Artist
%T - Title
%B - Album
%N - Track number
%S - Part of set (disk number)
%D - Duration
%G - Genre
%Y - Year
%R - Rating
</pre>

Example:
<syntaxhighlight lang=xml enclose="div">
<musicfilenamefilters>
<filter>%A - %T</filter>
</musicfilenamefilters>
</syntaxhighlight>

=== musiclibrary ===
Options specific to the Music Library
<section begin="MusicLibrary" />
<syntaxhighlight lang="xml" line='line'>
<musiclibrary>
<allitemsonbottom>true</allitemsonbottom> 
<cleanonupdate>false</cleanonupdate> 
<recentlyaddeditems>35</recentlyaddeditems> 
<albumformat>%B - %Y</albumformat> 
<prioritiseapetags>true</prioritiseapetags> 
<itemseparator> / </itemseparator> 
<artistseparators> 
<separator>;</separator>
<separator>:</separator>
<separator>|</separator>
<separator> feat. </separator>
<separator> ft. </separator>
</artistseparators>
<dateadded>1</dateadded> 


<promptfulltagscan>false</promptfulltagscan> 
<useartistsortname>false</useartistsortname> 
</musiclibrary>
</syntaxhighlight>
{{Note|Changing the <itemseparator> or <artistseparators> will only affect newly added items. A rescan won't change the existing ones. Remove the Source(s) or delete the Music DB and rebuild. This process should be made easier from v18 and up using <promptfulltagscan>}}<section end="MusicLibrary" />

==== Music library extra artwork ====

New for Kodi v18.
Configuration to expand the artwork automatically added by Kodi to media items in the library, either from local files or online scrapers.

The original basic artwork types are still hardcoded so they don't need to be configured here (and can't be removed). "thumb" for artists and albums, and "fanart" for artists.

<syntaxhighlight lang=xml enclose="div">
<musiclibrary>


<artistextraart>
<arttype>banner</arttype>
<arttype>clearlogo</arttype>
<arttype>clearart</arttype>
<arttype>landscape</arttype>
</artistextraart>

<albumextraart>
<arttype>discart</arttype>
<arttype>spine</arttype>
<arttype>back</arttype>
</albumextraart>
</musiclibrary>
</syntaxhighlight>

== Photos settings ==

=== pictureextensions ===
{{anchor|.3Cpictureextensions.3E}}
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Pictures window.

Default extensions for PICTURES:
<pre>
.png .jpg .jpeg .bmp .gif .ico .tif .tiff .tga .pcx .cbz .cbr .rss .webp .jp2 .apng
</pre>

Examples:
<syntaxhighlight lang=xml enclose="div">
<pictureextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</pictureextensions>
</syntaxhighlight>

=== pictureexcludes ===
{{anchor|.3Cpictureexcludes.3E}}
Matches filenames or folders which should be excluded from being displayed in My Pictures using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

<syntaxhighlight lang=xml enclose="div">
<pictureexcludes> 
<regexp>small</regexp>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</pictureexcludes>
</syntaxhighlight>

=== slideshow ===
{{anchor|.3Cslideshow.3E}}
<syntaxhighlight lang=xml enclose="div">
<slideshow>

<panamount>2.5</panamount>

<zoomamount>5.0</zoomamount>



<blackbarcompensation>20</blackbarcompensation>
</slideshow>
</syntaxhighlight>

== Network settings ==

=== samba ===
{{anchor|.3Csamba.3E}}
<syntaxhighlight lang=xml enclose="div">
<samba>
<doscodepage></doscodepage> 
<clienttimeout>10</clienttimeout> 
<statfiles>true</statfiles> 
</samba>
</syntaxhighlight>

=== hosts ===
{{anchor|.3Cfhosts.3E}}
Static dns entries which take precedence over your dns server.
<syntaxhighlight lang=xml enclose="div">
<hosts>
<entry name="HOSTNAME">IPADDRESS</entry>
</hosts>
</syntaxhighlight>

=== network ===
{{anchor|.3Cnetwork.3E}}

<syntaxhighlight lang=xml enclose="div">
<network>
<curlclienttimeout>10</curlclienttimeout> 
<curllowspeedtime>20</curllowspeedtime> 
<curlretries>2</curlretries> 
<httpproxyusername></httpproxyusername> 
<httpproxypassword></httpproxypassword> 
</network>
</syntaxhighlight>

{{Note|In Kodi v17, the three buffer settings are removed from the <code><network></code> tag and now placed under the new <code><cache></code> tag. See '''[[#cache]]''' for full details.}}

=== cache ===
{{see also|HOW-TO:Modify the cache}}
<syntaxhighlight lang=xml enclose="div">
<cache>
<memorysize>0</memorysize> 
<buffermode>0</buffermode> 
<readfactor>4.0</readfactor> 
</cache>
</syntaxhighlight>

=== airtunesport ===
{{anchor|.3Cairtunesport.3E}}<section begin="airtunesport" />
This overwrites the defalt listening port of the AirTunes server (announced via zeroconf).
<section end="airtunesport" />

=== airplayport ===
{{anchor|.3Cairplayport.3E}}<section begin="airplayport" />
This overwrites the default listening port of the AirPlay server (announced via zeroconf).
<section end="airplayport" />

== File system settings ==

=== packagefoldersize ===
<section begin="packagefoldersize" />
{{anchor|.3Cpackagefoldersize.3E}}
{{xml setting
| tag name = packagefoldersize
| option type = numerical
| option values =
| default values = 200
| platform = all
| XBMC version = 12
| description = The amount (in megabytes) of add-on zip packages saved from previous add-on installs. These packages are mainly used for the [[add-on]] rollback feature. Increasing the size should increase the amount of past versions saved. Defaults to 200 MB.
| example = Example: <syntaxhighlight lang=xml enclose="div"><packagefoldersize>200</packagefoldersize> </syntaxhighlight>
}}
<section end="packagefoldersize" />

=== detectasudf ===
{{anchor|.3Cdetectasudf.3E}}
Set to true if you wish to detect joint ISO9660/UDF disks as UDF.

Default: False

=== pathsubstitution ===
{{anchor|.3Cpathsubstitution.3E}}
{{main|Path substitution}}

{{divbox|red||'''Note:''' Path substition for "sources" and profiles is broken, and will '''NOT''' be fixed.}}

Path substitutions are for use for redirecting file paths. These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for Kodi to handle.

Default: No path substitutions defined.

Example:
<syntaxhighlight lang=xml enclose="div">
<pathsubstitution>
<substitute>
<from>G:\dvds\</from>
<to>smb://somecomputer/g-share/dvds/</to> 
</substitute>
</pathsubstitution>
</syntaxhighlight>

== Input control settings ==

=== remotedelay ===
{{anchor|.3Cremotedelay.3E}}
The repeat delay for a LIRC remote control. A delay value between 1 and 20 before a remote button starts repeating on a long keypress (i.e. continuously sending button pushes while it's held down).

Default: 3
<syntaxhighlight lang=xml enclose="div">
<remotedelay>10</remotedelay>
</syntaxhighlight>

=== controllerdeadzone ===
{{anchor|.3Ccontrollerdeadzone.3E}}
This advanced settings has been removed. See [[HOW-TO:Controller deadzone]].

=== enablemultimediakeys ===
{{anchor|.3Cenablemultimediakeys.3E}}
This setting only has any effect on Windows versions of Kodi, and only applies to builds from 28th May 2011 onwards.
In Windows the multimedia keys generate a WM_APPCOMMAND message in addition the keypress. Kodi processes both keypresses and the WM_APPCOMMAND messages, and the end result would be that the command is executed twice. To avoid this, by default multimedia keypresses are disabled. Although it should rarely be necessary, the enablemultimediakeys setting allows you to enable the multimedia keys.

Example:
<syntaxhighlight lang=xml enclose="div">
<enablemultimediakeys>true</enablemultimediakeys>
</syntaxhighlight>

=== seeksteps ===
{{Main|Skip steps}}

This setting changes which increments are available in the settings GUI for additive seeking. Note that <code><seeksteps></code> is not used to actually choose which seek steps are enabled.

'''Default:'''
<syntaxhighlight lang=xml enclose="div">
<seeksteps>7, 15, 30, 60, 180, 300, 600, 900, 1800</seeksteps>
</syntaxhighlight>

{{editor note|the defaults need to be updated for seeksteps.}}

=== touchscreen ===
{{anchor|.3Ctouchscreen.3E}}
This setting allows you to move/align the origin of the touch screen with the origin of the display used. If touch input does not result in a correct movement of the mouse pointer, the behaviour can be corrected with an offset and a stretch/compress factor.

Example:
<syntaxhighlight lang=xml enclose="div">
<touchscreen>
<x_offset>0</x_offset> 
<y_offset>0</y_offset> 
<x_stretch_factor>1.0</x_stretch_factor> 
<y_stretch_factor>1.0</y_stretch_factor> 
</touchscreen>
</syntaxhighlight>

== Other interface settings ==

=== window ===
{{anchor|.3Cwindow.3E}}
{{note|This is a "hidden" guisettings.xml setting (defined by the mouse moving the window size), but it is mentioned here because it is a particularly useful override when used in advancedsettings.xml}}
This allows you to manually set the default size of Kodi's windowed mode. If you resize the window, it will return to the set size when restarting.

WIDTH and HEIGHT are the values for each dimension, in pixels.

<syntaxhighlight lang=xml enclose="div">
<window>
<width>WIDTH</width>
<height>HEIGHT</height>
</window>
</syntaxhighlight>

=== restrictcapsmask ===
{{anchor|.3Crestrictcapsmask.3E}}
Windows only. A bitmask to prevent Kodi from using detected texture capabilities of the GPU. This helps work around buggy hardware/drivers.

1: prevent the use of compressed textures (DXT1, DXT3, DXT5)
2: prevent the use of non-power-of-two dimensions for textures
4: prevent the use of compressed textures with non-power-of-two dimensions.

<syntaxhighlight lang=xml enclose="div">
<restrictcapsmask>0</restrictcapsmask>
</syntaxhighlight>

=== algorithmdirtyregions ===
{{anchor|.3Calgorithmdirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="algorithmdirtyregions" />{{note|Some GPU/hardware configurations will have some minor issues (such as a visual "flicker"). For those situations try mode 2 or use the default (mode 3, which requires no advancedsetting). Almost all ARM-based devices (such as [[Android]]) willl likely have flickering issues.}}

Enable dirty-region processing. Dirty regions are any parts of the screen that have changed since the last frame. By not re-rendering what hasn't changed the GUI can be sped up. Because all GPUs work differently, only Mode 3, combined with nofliptimeout=0, is guaranteed to work for everyone without flickering issues. This mode will reduce CPU/GPU usage, but will not increase GUI speed.

{| class="prettytable"
! value !! result !! description
|-
! 0
| Off
| The entire viewport is always rendered.
|-
! 1
|Union
|All dirty regions are grouped into the smallest possible rectangle. This is typically the fastest mode for slower GPUs due to only making one pass.
|-
! 2
| {{nowrap|Cost reduction}}
| Each dirty region is presented separately, in as many passes as there are regions.
|-
! 3
| {{nowrap|Whole Screen}}
| The entire screen is rendered if there are any dirty regions. This, combined with nofliptimeout is a safe default for drivers that clear buffer contents (manifests as blinking or vibrating images). '''Default'''
|}<section end="algorithmdirtyregions" />

Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<algorithmdirtyregions>1</algorithmdirtyregions>
</gui>
</syntaxhighlight>

=== visualizedirtyregions ===
{{anchor|.3Cvisualizedirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="visualizedirtyregions" />Enable dirty-region visualization. Paints a rectangle over marked controls.

* true: on
* false: off '''(Default)'''

{{note|This is only a development mode and isn't of use to normal users.}}
<section end="visualizedirtyregions" />
Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<visualizedirtyregions>true</visualizedirtyregions>
</gui>
</syntaxhighlight>

=== smartredraw ===

{{note|This is an experimental feature and you might face issues using it. So please be aware of that.}}

This new feature was introduced in Kodi 18 and if enabled, the GUI process call (and therefore the render call) is only done if anything has changed. The result will be a faster GUI and less load if Kodi plays a video

* true: on
* false: off '''(Default)'''

Example:
<syntaxhighlight lang=xml enclose="div">
<gui>
<smartredraw>true</smartredraw>
</gui>
</syntaxhighlight>

=== showexitbutton ===
{{anchor|.3Cshowexitbutton.3E}}
Setting to hide the exit button, useful for people running appliance based setups where exit would only confuse/complicate the user. Modifiable via the advancedsettings.xml by setting showexitbutton to false, default is true (show)

Example:
<syntaxhighlight lang=xml enclose="div">
<showexitbutton>true</showexitbutton>
</syntaxhighlight>

=== fullscreen ===
{{anchor|.3Cfullscreen.3E}}
Starts Kodi in full screen (check resolutions!).

<syntaxhighlight lang=xml enclose="div">
<fullscreen>false</fullscreen>
</syntaxhighlight>

=== splash ===
{{anchor|.3Csplash.3E}}
Set to false if you wish to disable the startup splash image. Defaults to true.

<syntaxhighlight lang=xml enclose="div">
<splash>true</splash>
</syntaxhighlight>

=== cputempcommand ===
{{anchor|.3Ccputempcommand.3E}}
Provide a shell command Kodi will use to get CPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia and Raspberry Pi</u>
<syntaxhighlight lang=xml enclose="div">
<cputempcommand>sed -e 's/$[0-9]*$[0-9]\{3\}.*/\1 C/' /sys/class/thermal/thermal_zone0/temp</cputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang=xml enclose="div">
<cputempcommand>echo "$(sensors -u | tail -n64 | grep temp1_input | awk '{print $2 }' |awk '{printf("%d\n",$1 + 0.5);}') C"</cputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang=xml enclose="div">
<cputempcommand>sensors|sed -ne "s/temp1: \+[-+]$[0-9]\+$.*/\1 C/p"</cputempcommand>
</syntaxhighlight>

=== gputempcommand ===
{{anchor|.3Cgputempcommand.3E}}
Provide a shell command Kodi will use to get GPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia</u>
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>echo "$(nvidia-settings -tq gpuCoreTemp) C"</gputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>echo "$(nvidia-smi -q -d TEMPERATURE | grep Gpu | cut -c35-36) C"</gputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>/usr/bin/aticonfig --od-gettemperature | grep Temperature | cut -f 2 -d "-" | cut -f 1 -d "." | sed -e "s, ,," | sed 's/$/ C/'</gputempcommand>
</syntaxhighlight>

;<u>For Raspberry Pi</u>
<syntaxhighlight lang=xml enclose="div">
<gputempcommand>/opt/vc/bin/vcgencmd measure_temp | sed -e "s/temp=//" -e "s/\..*'/ /"</gputempcommand>
</syntaxhighlight>

=== glrectanglehack ===
{{anchor|.3Cglrectanglehack.3E}}
Problems with ghosting or videos which are only played back in the left upper quarter? The following ATI hack may solve it.
<syntaxhighlight lang=xml enclose="div">
<glrectanglehack>yes</glrectanglehack>
</syntaxhighlight>

=== alwaysontop ===
{{anchor|.3Calwaysontop.3E}}
Added in XBMC v9.11 (Windows OS only). Keeps Kodi always on top when windowed.
<syntaxhighlight lang=xml enclose="div">
<alwaysontop>yes</alwaysontop>
</syntaxhighlight>

There is also a fake fullscreen GUI option in Kodi's settings.

== Removed tags ==
{{anchor|Recently removed tags}}
* {{anchor|.3Cthumbsize.3E}}'''<thumbsize>''' - replaced by <[[#imageres|imageres]]> in v12 Frodo
* {{anchor|.3Cfanartheight.3E}}'''<fanartheight>''' - replaced by <[[#fanartres|fanartres]]> in v12 Frodo
* {{anchor|.3Cdvdthumbs.3E}}'''<dvdthumbs>''' - removed in v12 Frodo
* {{anchor|.3Cbusydialogdelayms.3E}}'''<busydialogdelayms>''' - removed in v12 Frodo
* {{anchor|.3Cbginfoloadermaxthreads.3E}}'''<bginfoloadermaxthreads>''' - removed in v13 Gotham
* '''<showepginfoonselect>''' - replaced by a GUI setting in v13 Gotham
* '''<resample>''', '''<forceDirectSound>''', '''<audiophile>''', '''<audiosinkbufferdurationmsec>''', '''<allowtranscode44100>''', and '''<streamsilence>''' - These were various sub-tags for <audio> that were removed in v13 Gotham and either replaced by GUI settings or were no longer needed.
* {{anchor|.3Cenableairtunesdebuglog.3E}}'''<enableairtunesdebuglog>''' - replaced by a GUI option in v14 Helix
* '''<videoDisableHi10pMultithreading>''' - renamed to <disableswmultithreading> in v14 Helix
* '''<hideallitems>''' - For both the <code><videolibrary></code> and <code><musiclibrary></code> sections, this is replaced by a GUI option in v15 Isengard
* '''<SmallStepBackSeconds>''' - In v15 the <code>SmallStepBack</code> [[action ID]] has been replaced by <code>seek(-7)</code> in default keymaps. See '''[[skip steps]]''' for details. When the original <code>SmallStepBack</code> action ID is used it defaults to the first backwards [[skip steps|additive seeking value]].
* '''<timeseekforward>/<timeseekbackward>''' - In v15 these tags are replaced by GUI options via [[skip steps|additive seeking]], which is configured in the GUI. See '''[[skip steps]]''' for details.
* {{anchor|.3Ckaraoke.3E}}'''<karaoke>''' - In v16 all of the karaoke features in Kodi were removed.
* '''<useddsfanart>''' - removed in v17 Krypton.
* '''<cachemembuffersize>''' and '''<readbufferfactor>''' - In v17 '''<cachemembuffersize>''' is renamed to '''<memorysize>''' and <code><readbufferfactor></code> is renamed to <code><readfactor></code>. In addition, all three buffer related settings in <network> are moved out of <network> and into a new <cache> parent tag.
* '''<minvideocachelevel>''', '''<minaudiocachelevel>''', and '''<cacheindvdplayer>''' have been removed in v17.
* '''<useffmpegvda>''' - Tag was only used for development testing. Removed in v17.
* '''<nofliptimeout>''' - Removed in v17
* '''<blackbarcolour>''' - Removed in v17 (maybe?)
* '''<disableswmultithreading>''' - Removed in v17 (maybe?)
* {{anchor|.3Cmeasurerefreshrate.3E}}'''<measurerefreshrate>''' - Removed in v17 or v18?
* {{anchor|.3Cmyth.3E}}'''<myth>''' - Removed sometime between v16 to v18
* {{anchor|.3Ctuxbox.3E}}'''<tuxbox>''' - Removed
* '''<backgroundupdate>''' - Removed
* '''<hideemptyseries>''' - Replaced by a GUI option.
* '''<mymovies>''' and child tag '''<categoriestogenres>''' - Removed
* '''<albumssortbyartistthenyear'''> - Removed
* '''<albumformatright>''' - Removed
* {{anchor|.3Cremoterepeat.3E}}'''<remoterepeat>''' - Removed
* {{anchor|.3Callowd3d9ex.3E}}'''<allowd3d9ex>''' and {{anchor|.3Cforced3d9ex.3E}}'''<forced3d9ex>''' - Removed sometime between v16 to v18
* '''<lingertime>''' - Replaced by a GUI setting in v18
* '''<forcevaapienabled>''' - Removed in v18

== guisettings.xml settings ==
You can also define the settings normally defined in the GUI (and stored in guisettings.xml) in advancedsettings.xml. Most guisettings.xml settings defined in advancedsettings.xml will override the guisettings.xml values, and the settings will be removed completely from the interface.

The easiest way to include a guisettings.xml setting is to first change the setting in the interface to the value that you want, and then open the '''[[userdata]]/guisettings.xml''' file and find the XML entry that corresponds to that setting.

Then just add that entry to the advancedsettings.xml file.

For instance, to set the Font Character Set (found in the appearance setting, in the Look and Feel section), you'd open up guisettings.xml and find:

<syntaxhighlight lang=xml enclose="div">
<lookandfeel>
<charset>Hebrew (Windows)</charset>
</lookandfeel>
</syntaxhighlight>

Simply take that entry and place it in advancedsettings.xml. The option in Kodi's interface for the character set will then no longer be visible, and Kodi will always use the Hebrew (Windows) character set.

{{Updated|17}}
{{DISPLAYTITLE:advancedsettings.xml}}

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

Settings/Live TV/Playback

2019-01-03T13:13:06Z

Ksooo:

{{bigger|This category contains the PVR playback and channel switching settings.}}

__TOC__

==General==
[[File:SettingsPVRPlayback-leia.jpg|500px]]

=== Switch to fullscreen ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Standard
|- valign="top"
| '''Description:'''
| Switch to full screen display when starting playback of channels and recordings.
|}

=== Show signal quality ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Advanced
|- valign="top"
| '''Description:'''
| True to display signal quality information in the codec information window (if supported by the add-on and backend)
|}

=== Confirm channel switches by pressing OK ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Standard
|- valign="top"
| '''Description:'''
| When this option is enabled and up key or down key is pressed in full screen mode, then a channel switch is only done after pressing OK. However, channel up key and channel down key and numeric keys will always switch without confirmation, regardless of this setting.
|}

=== Delay channel switch ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Advanced
|- valign="top"
| '''Description:'''
| When pressing channel up or down or when using the number keys in full screen mode, the actual channel switch is delayed. Defaults to 0 milliseconds.
|}

=== Delay mark last watched ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Expert
|- valign="top"
| '''Description:'''
| If set to a value greater than zero, last watched channels will be stored the given amount of time after start of channel playback. Otherwise the last watched time will be stored immediately at start of channel playback.
|}

=== Fallback framerate ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Basic
|- valign="top"
| '''Description:'''
| If enabled, this framerate is used for streams we were not able to detect fps. Possible options will depend on what the screen you run Kodi on is capable of.
|}

==RDS Radio==
[[File:PVR_Playback_2.jpg|500px]]
=== Enable RDS for radio channels ===

{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Standard
|- valign="top"
| '''Description:'''
| RDS data can be used if present.
|}

=== Mesage traffic advisory ===

{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Standard
|- valign="top"
| '''Description:'''
| RDS inform you about traffic advisory messages.
|}

{{updated|18}}

Kodi v18 (Leia) changelog

2018-09-07T21:52:36Z

Ksooo:

{{mininav|[[Releases]] {{l2| [[Leia]] }} }}

{{notice|Kodi's journey via non-alpha/beta v18 (Leia) releases is currently underway. As such, these new features/functions and API changes is a placeholder containing changes to the current Kodi mainline (the git master tree repository on GitHub). This is listing changes committed to the master branch after Krypton branching. The many features/functions and API additions, alterations or removal are only subject to change during the Alpha stages. The Beta stage is all about stability and bug fixing. }}
{{incomplete}}
{{future|18}}

{{see also|Kodi v18 (Leia) FAQ|Leia API changes|Releases}}

This is a placeholder and Kodi Wiki copy of the condensed changelog for the future Kodi v18.x version (codename: "Leia") releases with a summery of the most important core features and functions as well as other notable changes to key areas of the application software or its user interface.

== Changelog ==

=== Gaming (Games interface and Game Clients)===
* Added a RetroPlayer player core supporting game clients as well as emulator cores via libretro API<ref name="RetroPlayer">RetroPlayer http://forum.kodi.tv/showthread.php?tid=164725</ref><ref>http://github.com/xbmc/xbmc/pull/11022</ref>
* Added extentions to Kodi's Addons AP to support Game Client Addons, supporting Kodi's VFS (Virtual File System), etc.<ref name="RetroPlayer"/>
* Added support for Game Client Addons as new type of addons with just-in-time emulator installation<ref name="RetroPlayer"/>
* Added a Games window and Game OSD (On-Screen-Display) entries to the GUI<ref name="RetroPlayer"/><ref>https://github.com/xbmc/xbmc/pull/12367</ref>
* Added a gaming and game configuration interface for Game settings to the GUI<ref name="RetroPlayer"/>
* Added support for Game Info Tags (game info tag) and exposed properties to Python list items<ref name="RetroPlayer"/>
* Added a savestate (savestate) manager to Kodi for games<ref>http://github.com/xbmc/xbmc/pull/11034</ref>
* Added initial support for basic gameplay persistence (auto-save & auto-load)<ref>https://github.com/xbmc/xbmc/pull/12434</ref>
* Added support for in-game (save RAM) saves<ref>http://github.com/xbmc/xbmc/pull/11380</ref>
* Added support for Keyboard players via Joystick Emulation<ref name="RetroPlayer"/>
* Added support for libretro API and game cores (emulators and games) that support it
* Added [[Game_Add-ons|game clients addons]] for many popular third-party game console emulators and native open source games *
** ''* [[Game_Add-ons|Game clients addons]] for Kodi is changing quickly so checkout the [[Game_Add-ons|game clients addons]] article for a current list''
* ?

=== Live TV and PVR (Personal Video Recorder) ===
* Major GUI actions refactoring to eliminate duplicate and dead code. Add context menu support for Estuary PVR home screen widgets <ref>https://github.com/xbmc/xbmc/pull/10870</ref>
* Guide window: Get rid of obsolete views "channel", "now" and "next" <ref>https://github.com/xbmc/xbmc/pull/10838</ref>
* Core: Refactor and fix "play minimized" settings handling <ref>https://github.com/xbmc/xbmc/pull/11203</ref>
* Guide, channel, video fullscreen, music visualisation window: Direct channel number input. <ref>https://github.com/xbmc/xbmc/pull/11434</ref>
* Settings: Remove setting 'hide connection lost warning' <ref>https://github.com/xbmc/xbmc/pull/11500</ref>
* Search dialog: Refactor and complete implementation of EPG search filter <ref>https://github.com/xbmc/xbmc/pull/11570</ref>
* Timer settings dialog: Prefill recordings folder with timer title <ref>https://github.com/xbmc/xbmc/pull/11679</ref>
* Recordings window: Content view filter <ref>https://github.com/xbmc/xbmc/pull/11704</ref>
* Settings: Remove non-working recording settings defaults <ref>https://github.com/xbmc/xbmc/pull/11746</ref>
* Guide window: 'Smart selection' of epg events. <ref>https://github.com/xbmc/xbmc/pull/11782</ref>
* Channelgroup manager: Add support for radio channel groups <ref>https://github.com/xbmc/xbmc/pull/11877</ref>
* Guide window: Add possibility to switch between horizontal and vertical epg grid view <ref>https://github.com/xbmc/xbmc/pull/11958</ref>
* Search window: improvements and fixes <ref>https://github.com/xbmc/xbmc/pull/12001</ref>
* Estuary home screen: Add Info support to recently played channel widget <ref>https://github.com/xbmc/xbmc/pull/12254</ref>
* Estuary: Add episodename to live tv and recordings osd sub label, cleanup seek bar for live tv <ref>https://github.com/xbmc/xbmc/pull/12306</ref>
* Estuary: PVR info dialog, recordings window: cleanup and extend <ref>https://github.com/xbmc/xbmc/pull/12416</ref>
* Drop 'channel guide' button from epg event info dialog, add 'channel guide' to context menu <ref>https://github.com/xbmc/xbmc/pull/12526</ref>
* Settings: Introduce new setting 'Startup action' and add 'Play TV/Radio <ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Settings: Make 'epg.lingertime' an official setting, remove the respective advanced setting <ref>https://github.com/xbmc/xbmc/pull/12740</ref>
* Setting: Remove obsolete and unused setting 'pvrplayback.scantime' <ref>https://github.com/xbmc/xbmc/pull/12800</ref>
* Core: Fixes/Improvements for multiple enable PVR client addons <ref>https://github.com/xbmc/xbmc/pull/12959</ref>
* Core: Fixes/Improvements for subchannel numbers support (ATSC) <ref>https://github.com/xbmc/xbmc/pull/13069</ref>
* Core: Global direct channel number input & global unique channel numbers <ref>https://github.com/xbmc/xbmc/pull/13135</ref>
* Database: Fix error "Abort due to constraint violation. Query: INSERT INTO channels..." <ref>https://github.com/xbmc/xbmc/pull/13150</ref>
* Estuary: Rework PVR seekbar + Fix PVR info dialog <ref>https://github.com/xbmc/xbmc/pull/13158</ref>
* Core: Make next/previous chapter work for PVR recordings <ref>https://github.com/xbmc/xbmc/pull/13164</ref>
* Direct channel number input: No delay on switch to previous channel with key 0 <ref>https://github.com/xbmc/xbmc/pull/13232</ref>
* Settings: Make shared channel selection optional <ref>https://github.com/xbmc/xbmc/pull/13237</ref>
* Estuary: PVR info panel cleanup <ref>https://github.com/xbmc/xbmc/pull/13255</ref>
* Guide window: 'Go to date' context menu item <ref>https://github.com/xbmc/xbmc/pull/13282</ref>
* Estuary: Season/Episode info in Guide window and dialog <ref>https://github.com/xbmc/xbmc/pull/13300</ref>
* Estuary: Add percent played progress bar to PVR info panel (for recordings) <ref>https://github.com/xbmc/xbmc/pull/13338</ref>
* Guide window: Channel groups selector <ref>https://github.com/xbmc/xbmc/pull/13364</ref>
* Guide window: Tweaks for more consistency and readability <ref>https://github.com/xbmc/xbmc/pull/13402</ref>
* Guide window: Sort content by channel number/channel name/last played, support sort order <ref>https://github.com/xbmc/xbmc/pull/14231</ref>
* OSD: Timeshift: Revised GUI <ref>https://github.com/xbmc/xbmc/pull/14316</ref><ref>https://github.com/xbmc/xbmc/pull/14386</ref>
* OSD: Timeshift: Add support for next and previous buttons<ref>https://github.com/xbmc/xbmc/pull/14387</ref>
* PVR-Addon API changes <ref>https://github.com/xbmc/xbmc/pull/12028</ref><ref>https://github.com/xbmc/xbmc/pull/12303</ref><ref>https://github.com/xbmc/xbmc/pull/12552</ref><ref>https://github.com/xbmc/xbmc/pull/12609</ref><ref>https://github.com/xbmc/xbmc/pull/12660</ref><ref>https://github.com/xbmc/xbmc/pull/12689</ref><ref>https://github.com/xbmc/xbmc/pull/12755</ref><ref>https://github.com/xbmc/xbmc/pull/13228</ref><ref>https://github.com/xbmc/xbmc/pull/13720</ref><ref>https://github.com/xbmc/xbmc/pull/14002</ref><ref>https://github.com/xbmc/xbmc/pull/14086</ref>
* Added, updated, and improved PVR backend clients addons for all popular third-party external [[PVR backend]] platforms:
** New: [[Add-on:Zattoo PVR Client|Zattoo PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** New: [[Add-on:Teleboy PVR Client|Teleboy PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** New: [[Add-on:Sledovanitv.cz PVR Client|Sledovanitv.cz PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR Demo Client|PVR Demo Client]] dummy addon with fake (method stub) [[PVR backend]] for [[PVR]] skinning and regression testing
** [[Add-on:IPTV Simple Client|IPTV Simple Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:HDHomeRun PVR|HDHomeRun]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Digital Devices Octopus NET Client|Digital Devices Octopus NET Client]] PVR Addon backend client maintained and made available by [http://digitaldevices.de/home/ Digital Devices]
** [[Add-on:VU+ / Enigma2 Client|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Njoy N7 PVR Client|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VDR VNSI Client|VDR VNSI Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MythTV PVR Client|MythTV PVR Client]] Addon backend client maintained and available from the Kodi's community
** [[Add-on:NextPVR PVR Client|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Argus TV Client|Argus TV (former ForTheRecord)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBLink PVR Client|DVBLink PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBViewer Client|DVBViewer Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MediaPortal PVR Client|MediaPortal PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community
* ?

=== Add-ons Framework, API, and Manager ===
For full changelogs of all Addons APIs, see [[Leia API changes]], [https://forum.kodi.tv/showthread.php?tid=324598 JSON-RPC], and [http://forum.kodi.tv/forumdisplay.php?fid=26 Add-ons] Development Forums
* Major refactoring of Kodi's core handling and GUI management of binary addons<ref>http://github.com/xbmc/xbmc/pulls?q=label%3A%22Binary+Addons%22+is%3Aclosed</ref>
* Added framework to support VFS (Virtual File System) as binary addons<ref>http://github.com/xbmc/xbmc/pull/8966</ref>
* Added framework support for binary addons for video decoder codecs<ref name="Addon video codec implementation">https://github.com/xbmc/xbmc/pull/12340</ref>
* Added framework support for binary addons for image (picture) decoder codecs
* Added extentions to Kodi's Addons API to support binary addons for video decoder codecs<ref name="Addon video codec implementation"/>
* Added extentions to Kodi's Addons API to support binary addons for image decoder codecs
* Added support for Python addons to use PyCryptoDome crypto module for decryption<ref>https://github.com/xbmc/xbmc/pull/11477</ref>
* Added option to pass HTTP cookies with AVOption to Kodi's Video Player<ref>https://github.com/xbmc/xbmc/pull/12257</ref>
* Added support to allow addons to edit all used controls on their processed window<ref>https://github.com/xbmc/xbmc/pull/12259</ref>
* Added support to allow Python addons to set the videoinfotag path<ref>http://github.com/xbmc/xbmc/pull/11012</ref>
* Added support to allow Python addons to get/set the dbid of a (music) listitem<ref>http://github.com/xbmc/xbmc/pull/10858</ref>
* Added support for mediatype to musicinfotag tag retrieving via Python API<ref>http://github.com/xbmc/xbmc/pull/11110</ref>
* Added support "int/float slider" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11230</ref>
* Added support "setContent for mediawindows" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11258</ref>
* Added help for load of shared library and allow the use of their own addon temp folder<ref>https://github.com/xbmc/xbmc/pull/12379</ref>
* Added support to inspect add-on dependencies prior to installation<ref>https://github.com/xbmc/xbmc/pull/12242</ref>
* Added ability to remove add-on settings upon uninstall<ref>https://github.com/xbmc/xbmc/pull/11499</ref>
* Changed to new addon gui interface for list items to use on addon window<ref>https://github.com/xbmc/xbmc/pull/12214</ref>
* Changed service addons to use event handlers instead of synchronous addon hooks<ref>https://github.com/xbmc/xbmc/pull/12370</ref>
* Updated "Peripheral Addons" for game controllers, gamepads, joysticks, and input peripherals profiles (in Kodi-game repo<ref>http://github.com/kodi-game/ kodi-game repo on GitHub</ref>):
** [http://github.com/xbmc/peripheral.joystick Joystick Controller Addon]
** [http://github.com/kodi-game/peripheral.xarcade X-Arcade (XGaming Tankstick) support for Kodi Addon]
** [http://github.com/kodi-game/peripheral.steamcontroller Steam Controller (gamepad) Addon]
** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.default Default Game Controller Addon (reference game controller addon based on Xbox 360 gamepad)]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.ps PlayStation Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.nes Nintendo NES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.snes Nintendo SNES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.n64 Nintendo N64 Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.gba Nintendo GBA Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.genesis Sega Genesis Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.dreamcast Sega Dreamcast Game Controller Addon]
* ?

=== GUI Engine (Skinning Engine) ===
For full changelog on changes to the skinning engine, see [[Leia API changes]] and the [http://forum.kodi.tv/showthread.php?tid=298565 Skin Development Forum]
* Added windows to support Games and Game OSD in the new default skins (Estuary and Estouchy)
* Added player process info dialog to Kodi's default skin (Estuary)<ref>https://github.com/xbmc/xbmc/pull/11718</ref>
* Added support for addons to use banner and ClearLogo<ref>https://github.com/xbmc/xbmc/pull/12244</ref>
* Added support for skins/gui to allow implicit container referencing for non-media windows<ref>http://github.com/xbmc/xbmc/pull/10883</ref>
* Added support for addons to add "Enable/Disable" to context menu<ref>http://github.com/xbmc/xbmc/pull/11124</ref>
* Added support for remember last used keyboard layout in GUI<ref>http://github.com/xbmc/xbmc/pull/11242</ref>
* Added support for ISO 639-2/T language code retrieval (required by libbluray)<ref>https://github.com/xbmc/xbmc/pull/12258</ref>
* Added window that display Kodi privacy policy in GUI settings under system info<ref>https://github.com/xbmc/xbmc/pull/10785</ref>
* Added support to map a key to browse for subtitle in video fullscreen window<ref>https://github.com/xbmc/xbmc/pull/11649</ref>
* Improved Kodi's GUI engine with optimizations for message handling and SmartRedraw<ref>https://github.com/xbmc/xbmc/pull/12213</ref>
* Improved Kodi's GUI engine support for scaling container layouts<ref>http://github.com/xbmc/xbmc/pull/11229</ref>
* Improved Kodi's GUI engine by allowing %-values for origin, camera and animation attribs<ref>http://github.com/xbmc/xbmc/pull/11233</ref>
* Changed so that context menu reloading loads async to aviod GUI lockup on wait<ref>https://github.com/xbmc/xbmc/pull/11841</ref>
* Updated guilib ABI (for libgui) to version 5.13.0<ref>http://github.com/xbmc/xbmc/pull/11306</ref>
* Updated keyboard layout for some languages and added support Croatian, Slovenian, and Thai (Kedmanee)
* Updated image resource addons (as example weather icons, weather fanart, studio logos, and genre icons)
* ?

=== Platform Independent Playback ===
* Added support for "InputStream" (input stream) addons to pass CryptoSession flags field<ref>https://github.com/xbmc/xbmc/pull/12428</ref>
* Added support for BD-J / Blu-ray Disc Java menu support (requires system Java runtime enviroment)<ref>https://github.com/xbmc/xbmc/pull/12339</ref><ref>https://github.com/xbmc/xbmc/pull/12310</ref>
* Added support for Blu-ray Disc detection and use provided meta data for Blu-ray Disc names<ref>https://github.com/xbmc/xbmc/pull/12488</ref>
* Added support for video buffers to be used by decoders and renderers<ref name="VideoPlayer updates for Leia">https://github.com/xbmc/xbmc/pull/12212</ref>
** Added support for platforms to register custom buffers, like example dma<ref name="VideoPlayer updates for Leia"/>
* Added a VC1-Packet bitstream parser implementation for improved VC-1 playback<ref>http://github.com/xbmc/xbmc/pull/11417</ref>
* Added and updated many (binary) audio decoder and encoder addons for Kodi
* Added a few (binary) video decoder addons for Kodi<ref name="Addon video codec implementation"/>
* Added a "RAW" (libraw based) image decoder addon to Kodi<ref>https://github.com/xbmc/xbmc/pull/11671</ref>
* Improved MMAL playback of H.264 MVC (Blu-ray 3D) stereoscopic video with framepacking decoding on Raspberry Pi
* Improved Stereoscopic 3D playback of 3D videos (as well as better 2D playback of 3D videos)
* Improved and enhanced Blu-ray support (including updated libbluray dependecies from the VideoLAN project<ref>https://github.com/xbmc/xbmc/pull/12305</ref><ref>http://git.videolan.org/?p=libbluray.git;a=blob;f=ChangeLog</ref>
* Improved support for "InputStream" (input stream) addons as system addons
* Updated "InputStream" (input stream) client addons for common network streaming protocols and popular services:
** [http://github.com/xbmc/xbmc/tree/master/addons/kodi.inputstream InputStream Addon (default reference InputStream Addon by Team Kodi]
** [http://github.com/mapfau/inputstream.test Test InputStream Addon (Test InputStream Addon for Kodi's new inputstream interface]
** [http://github.com/peak3d/inputstream.adaptive Adaptive InputStream Addon (InputStream Client addon for several manifest types)]
** [http://github.com/xbmc/repo-binary-addons/tree/master/inputstream.rtmp RTMP InputStream Addon (InputStream Client for RTMP streams using librtmp)]
** [http://github.com/peak3d/inputstream.mpd MPD (MPEG-DASH) InputStream Addon]
** [http://github.com/peak3d/inputstream.smoothstream SmoothStream InputStream Addon for MS-SSTR (SmoothStreamingMedia) Smooth Streaming Protocol]
** [http://github.com/mapfau/inputstream.nxmsl NXMSL InputStream Addon for Netflix style manifests over MSL]
* Updated FFmpeg multimedia codec and demux libraries to stable branch release version [http://www.ffmpeg.org/download.html#release_3.3.2 FFmpeg 3.3 (3.3.2)]<ref>http://git.videolan.org/?p=ffmpeg.git;a=blob_plain;f=Changelog;hb=release/3.3.2 FFmpeg 3.3.2 release changelog</ref><ref>https://github.com/xbmc/xbmc/pull/12358</ref>
* Removed certain audio codecs from core and made them into audio decoder and audio encoder add-ons
* Removed certain video codecs from core and made them into video decoder add-ons<ref name="Addon video codec implementation"/>
* Removed certain image codecs from core and made them into image decoder add-ons
* ?

=== General Library ===
* Addded support to use the Favourites function in context menus<ref>https://github.com/xbmc/xbmc/pull/11967</ref>
* Added support for context menus to favourites home screen widget<ref>https://github.com/xbmc/xbmc/pull/11929</ref>
* Added support to "Sort By Date Added" in Music Video title node<ref>https://github.com/xbmc/xbmc/pull/12495</ref>

=== Music Library ===
* Fix- The use of BAND and ENSEMBLE (Vorbis and APE) tags. <ref>https://github.com/xbmc/xbmc/pull/11735</ref>
* Fix- Music library cleaning so not lock UI and cancel button works. <ref>https://github.com/xbmc/xbmc/pull/13117</ref>
* Fix- Issue of replay gain not being applied if peak value was missing, and also removed the avoid clipping setting. <ref>https://github.com/xbmc/xbmc/pull/11868</ref><ref>https://github.com/xbmc/xbmc/pull/11865</ref>
* Fix- Clean On Update which prevented scraping in some circumstances <ref>https://github.com/xbmc/xbmc/pull/11609</ref>
* Fix- Missing ''* Item Folder'' entry when browsing for artist fanart from Artist Info Dialog <ref>https://github.com/xbmc/xbmc/pull/12625</ref>
* Fix- Handling of duplicate MusicBrainzTrackID within the same album. Previous assumption was that the MusicBrainzTrackID is unique within the same album <ref>https://github.com/xbmc/xbmc/pull/12079</ref>
* Fix- Sort names for artists that are only album artists <ref>https://github.com/xbmc/xbmc/pull/13030</ref>
* Fix- Wrong playback order for smartplaylists, playlists and upnp <ref>https://github.com/xbmc/xbmc/pull/13059</ref>
* Fix- Cancelling of music library export which continued in the background even after cancel button clicked on progress dialog <ref>https://github.com/xbmc/xbmc/pull/13105</ref>
* Fix- Endless rescraping of unfound album <ref>https://github.com/xbmc/xbmc/pull/13752</ref>
* Fix- Art type "thumb" was sometimes being added to a song with an empty URL, preventing artist fanart from being shown on playback of library items from file view. <ref>https://github.com/xbmc/xbmc/pull/13854</ref>
* Improve- Handling of Cue Sheets <ref>https://github.com/xbmc/xbmc/pull/12082</ref>
* Improve- Online scraping of additional artist and album information making better use of Musicbrainz IDs. <ref>https://github.com/xbmc/xbmc/pull/12120</ref><ref>https://github.com/xbmc/xbmc/pull/12597</ref>
* Improve- On clean installs, change default song sort order to Track Number <ref>https://github.com/xbmc/xbmc/pull/12834</ref>
* Improve- FileItem::IsSamePath for albums and artists to prevent false matches <ref>https://github.com/xbmc/xbmc/pull/13585</ref>
* Improve- Album genre inconsistencies <ref>https://github.com/xbmc/xbmc/pull/13042</ref>
* Improve- Avoid unnecessary db access by GUI when app processing GUI_MSG_UPDATE_ITEM messages <ref>https://github.com/xbmc/xbmc/pull/13640</ref>
* Improve- Refactor Artist/Album Information Dialog <ref>https://github.com/xbmc/xbmc/pull/13672</ref>
* Improve- Refactor Song Information Dialog <ref>https://github.com/xbmc/xbmc/pull/13533</ref>
* Improve- Fetching local art for multi-folder albums (disc sets) <ref>https://github.com/xbmc/xbmc/pull/13769</ref>
* Add- Option to rescan the music file tags for existing items in the library <ref>https://github.com/xbmc/xbmc/pull/11557</ref>
* Add- Add processing of WRITER tag for ID3 v2, Vorbis and APE formats <ref>https://github.com/xbmc/xbmc/pull/11735</ref>
* Add- Processing of ARTISTSORT (TSOP), ALBUMARTISTSORT (TS02) and COMPOSERSORT (TSOC) tags to provide a sort name for artists. <ref>https://github.com/xbmc/xbmc/pull/11738</ref>
* Add- New dialog for selection of both artist and album scraper addons, and their settings.<ref>https://github.com/xbmc/xbmc/pull/12987</ref><ref>https://github.com/xbmc/xbmc/pull/12943</ref>
* Add- Additional artist data that Musicbrainz provides: type (person, group, orchestra, choir etc.), gender, and disambiguation comments that help to differentiate artists with the same name <ref>https://github.com/xbmc/xbmc/pull/12963</ref>
* Add- Artist Information Folder - a single location for artist artwork and nfo. This solves numerous issues related to artwork, artist data import and general folder and file structure <ref>https://github.com/xbmc/xbmc/pull/12891</ref>
* Add- Extended Artwork support, making the local art that is picked up automatically on scan configurable. <ref>https://github.com/xbmc/xbmc/pull/13352</ref><ref>https://github.com/xbmc/xbmc/pull/13848</ref><ref>https://github.com/xbmc/xbmc/pull/13491</ref><ref>https://github.com/xbmc/xbmc/pull/13101</ref><ref>https://github.com/xbmc/xbmc/pull/13871</ref>
* Add- Add option to prefer scraped album covers to embedded images <ref>https://github.com/xbmc/xbmc/pull/13812</ref>
* Add- Filter music items by media source <ref>https://github.com/xbmc/xbmc/pull/14012</ref><ref>https://github.com/xbmc/xbmc/pull/14082</ref>

=== Web Scrapers ===
* Added support for Python (script) based web scrapers for Kodi<ref>http://github.com/xbmc/xbmc/pull/9984</ref>
* Refactored and updated many XML based scrapers in Kodi for music, movies, tv shows, and music videos
* Updated music, movies, tv shows, and music video scrapers for Kodi
* ?

=== AudioEngine ===
* Added a new Sndio sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, other BSD Unix based systems, and Linux<ref>https://github.com/xbmc/xbmc/pull/11962</ref>
* Improved the default cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] (Kodi's [[AudioEngine]])
* Improved ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems
* Improved PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop
* Improved OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD and similar BSD Unix based systems
* Improved AUDIOTRACK sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Amlogic]]
* Improved Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]
* Improved DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved CoreAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* Improved Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* Renamed AE_SINK to KODI_AE_SINK
* ?

=== Other ===
* Added a new unified setting for "Startup action" and added "Play TV/Radio"<ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Added support to build Kodi with support for Bluetooth<ref>http://github.com/xbmc/xbmc/pull/11137</ref>
* Added possibility for CMake build system to add additional libraries on install<ref>https://github.com/xbmc/xbmc/pull/12423</ref>
* Updated and improved mappings for new and existing remote controls
* Improved Kodi's JSON-RPC API
* Improved compiling/building and code documentation (following doxygen coding guidelines)
* Changed to use spdlog for Kodi logging as well as improved and further optimized logging (including debug logs)<ref>https://github.com/xbmc/xbmc/pull/11833</ref>
* Changed XML format of setting values for Kodi's settings configuration<ref>https://github.com/xbmc/xbmc/pull/12277</ref>
* Updated default web interface (webinterface is called "Chorus2" and is currently at version 2.4.4)<ref>https://github.com/xbmc/xbmc/pull/11872</ref>
* Updated critical dependency libraries such as openssl, gnutls, and CMake (used to compile Kodi and its binary addons)
* Removed last dependencies of SDL (Simple DirectMedia Layer) which was hardware abstraction for input devices<ref>https://github.com/xbmc/xbmc/pull/12272</ref><ref>https://github.com/xbmc/xbmc/pull/11881</ref>
* Removed all glew (libglew library) dependencies in Kodi's code<ref>http://github.com/xbmc/xbmc/pull/11128</ref>
* ?

=== Android Specific ===
* Added support for speech-to-text in Kodi OSD keyboard on Android TV (triggered by voice button on remote)
* Added support for Android to move the Kodi app to SD card<ref>https://github.com/xbmc/xbmc/pull/12168</ref>
* Added support for Android TV Leanback search and recommendations meta data from Kodi<ref>|https://github.com/xbmc/xbmc/pull/11901</ref>
** Default setting for Android TV Leanback suggestion to random unwatched movies and music albums<ref>https://github.com/xbmc/xbmc/pull/11963</ref>
* Moved to Android NDK 16
* Changed Rendertype from GUILayer to VideoLayer for Android MediaCodecSurface<ref>https://github.com/xbmc/xbmc/pull/12097</ref>
* Changed to use NDK native C interface for Android MediaCodec (for performance gains)<ref>https://github.com/xbmc/xbmc/pull/11931</ref>
* Changed to support ZeroConf via native Android API (and deprecates mDNSresponder)<ref>http://github.com/xbmc/xbmc/pull/11393</ref>
* Changed to support network information via native Android API (and deprecates POSIX)<ref>https://github.com/xbmc/xbmc/pull/12243</ref>
* Changed handling of Kodi's Java interfaces via JNI for better consistency<ref>https://github.com/xbmc/xbmc/pull/12292</ref>
* ?

=== BSD Specific ===
* Improved Kodi support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* ?

=== Linux Specific ===
* Added support for a generic DRM/KMS implementation using GBM to create required surfaces<ref>https://github.com/xbmc/xbmc/pull/11955</ref>
* Added support for Mir windowing system (Mir 1.0) for Kodi<ref>http://github.com/xbmc/xbmc/pull/10898</ref> and added support for VAAPI on Mir using DRM<ref>http://github.com/xbmc/xbmc/pull/11040</ref>
* Added support for the middle mouse button on embedded platforms<ref>https://github.com/xbmc/xbmc/pull/11956</ref>
* Added support more yuv420p bitwidths for direct rendering on Linux<ref>https://github.com/xbmc/xbmc/pull/12479</ref>
* Added support for using VAAPI hardware video decoding with OpenGL ES<ref>https://github.com/xbmc/xbmc/pull/12113</ref>
* Added support for build Kodi with imx support using CMake<ref>http://github.com/xbmc/xbmc/pull/11288</ref>
* Moved the CMake build system to the top of the code tree (moved to root)<ref>http://github.com/xbmc/xbmc/pull/10446</ref>
* Improved support for UltraHD decoding / 4K resolution output when hardware supports it
* Improved ARM processor architecture (using [[Raspberry Pi]] as reference device)
* Improved OpenGL ES and EGL support (using [[Raspberry Pi]] as reference device)
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* Improved XvBA (AMD/ATI) Hardware Video Acceleration (requires XvBA compatible hardware and drivers)
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on Amlogic devices
* Removed the unused and unmaintained OpenMAX video decoder from Kodi's VideoPlayer<ref>https://github.com/xbmc/xbmc/pull/12197</ref>
* Removed support for autotools based build system for Kodi and binary addons (in favour of CMake)<ref>http://github.com/xbmc/xbmc/pull/10429</ref>
* ?

=== iOS Specific ===
* Added support for iOS 10.0 by adding support for compiling Kodi with Xcode 8 IDE and iOS SDK 10.0<ref>https://github.com/xbmc/xbmc/pull/10539</ref>
* Improved Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)
* Improved support for TVOS (Apple's iOS fork for Apple TV 4) in Kodi mainline
* Improved support for iOS on ARM64 (64-bit iOS)
* ?

=== OS X Specific ===
* Added support for compiling Kodi with Xcode 8 IDE for OSX 10.11 (El Capitan) and macOS 10.12 (Sierra)
* Improved Apple VDADecoder Video Acceleration support for (Mac) OS X
* ?

=== Windows Specific ===
* Added support to build Kodi for Windows 64 / Windows for Intel 64-bit (x86-64)<ref>https://github.com/xbmc/xbmc/pull/12065</ref>
* Added support for 3D LUT (3D Lookup Table) and dithering to Windows video renderer<ref name="WinRenderer re-work">https://github.com/xbmc/xbmc/pull/12475</ref>
* Improved support to compiling Kodi for Microsoft's UWP (Universal Windows Platform) APIs
* Changed the inner working of render buffers and rendering methods<ref name="WinRenderer re-work"/>
* Changed to using unicode win32 api methods<ref>https://github.com/xbmc/xbmc/pull/11780</ref>
* Changed windowing systems for screen saver handling on Windows OS platforms
* Changed to make Kodi for Windows platform independent of posix/main.cpp<ref>https://github.com/xbmc/xbmc/pull/12215</ref>
* Removed support for Windows Vista as the operating-system is no longer supported by Microsoft<ref>https://github.com/xbmc/xbmc/pull/11953</ref>
* ?

== References ==
<references/>

== See also ==
* [[Leia API changes]]
{{Changelogs}}

[[Category:Manual]]
[[Category:Leia|*]]
[[Category:Changelogs|18]]

Kodi v18 (Leia) changelog

2018-09-07T21:49:48Z

Ksooo:

{{mininav|[[Releases]] {{l2| [[Leia]] }} }}

{{notice|Kodi's journey via non-alpha/beta v18 (Leia) releases is currently underway. As such, these new features/functions and API changes is a placeholder containing changes to the current Kodi mainline (the git master tree repository on GitHub). This is listing changes committed to the master branch after Krypton branching. The many features/functions and API additions, alterations or removal are only subject to change during the Alpha stages. The Beta stage is all about stability and bug fixing. }}
{{incomplete}}
{{future|18}}

{{see also|Kodi v18 (Leia) FAQ|Leia API changes|Releases}}

This is a placeholder and Kodi Wiki copy of the condensed changelog for the future Kodi v18.x version (codename: "Leia") releases with a summery of the most important core features and functions as well as other notable changes to key areas of the application software or its user interface.

== Changelog ==

=== Gaming (Games interface and Game Clients)===
* Added a RetroPlayer player core supporting game clients as well as emulator cores via libretro API<ref name="RetroPlayer">RetroPlayer http://forum.kodi.tv/showthread.php?tid=164725</ref><ref>http://github.com/xbmc/xbmc/pull/11022</ref>
* Added extentions to Kodi's Addons AP to support Game Client Addons, supporting Kodi's VFS (Virtual File System), etc.<ref name="RetroPlayer"/>
* Added support for Game Client Addons as new type of addons with just-in-time emulator installation<ref name="RetroPlayer"/>
* Added a Games window and Game OSD (On-Screen-Display) entries to the GUI<ref name="RetroPlayer"/><ref>https://github.com/xbmc/xbmc/pull/12367</ref>
* Added a gaming and game configuration interface for Game settings to the GUI<ref name="RetroPlayer"/>
* Added support for Game Info Tags (game info tag) and exposed properties to Python list items<ref name="RetroPlayer"/>
* Added a savestate (savestate) manager to Kodi for games<ref>http://github.com/xbmc/xbmc/pull/11034</ref>
* Added initial support for basic gameplay persistence (auto-save & auto-load)<ref>https://github.com/xbmc/xbmc/pull/12434</ref>
* Added support for in-game (save RAM) saves<ref>http://github.com/xbmc/xbmc/pull/11380</ref>
* Added support for Keyboard players via Joystick Emulation<ref name="RetroPlayer"/>
* Added support for libretro API and game cores (emulators and games) that support it
* Added [[Game_Add-ons|game clients addons]] for many popular third-party game console emulators and native open source games *
** ''* [[Game_Add-ons|Game clients addons]] for Kodi is changing quickly so checkout the [[Game_Add-ons|game clients addons]] article for a current list''
* ?

=== Live TV and PVR (Personal Video Recorder) ===
* Major GUI actions refactoring to eliminate duplicate and dead code. Add context menu support for Estuary PVR home screen widgets <ref>https://github.com/xbmc/xbmc/pull/10870</ref>
* Guide window: Get rid of obsolete views "channel", "now" and "next" <ref>https://github.com/xbmc/xbmc/pull/10838</ref>
* Core: Refactor and fix "play minimized" settings handling <ref>https://github.com/xbmc/xbmc/pull/11203</ref>
* Guide, channel, video fullscreen, music visualisation window: Direct channel number input. <ref>https://github.com/xbmc/xbmc/pull/11434</ref>
* Settings: Remove setting 'hide connection lost warning' <ref>https://github.com/xbmc/xbmc/pull/11500</ref>
* Search dialog: Refactor and complete implementation of EPG search filter <ref>https://github.com/xbmc/xbmc/pull/11570</ref>
* Timer settings dialog: Prefill recordings folder with timer title <ref>https://github.com/xbmc/xbmc/pull/11679</ref>
* Recordings window: Content view filter <ref>https://github.com/xbmc/xbmc/pull/11704</ref>
* Settings: Remove non-working recording settings defaults <ref>https://github.com/xbmc/xbmc/pull/11746</ref>
* Guide window: 'Smart selection' of epg events. <ref>https://github.com/xbmc/xbmc/pull/11782</ref>
* Channelgroup manager: Add support for radio channel groups <ref>https://github.com/xbmc/xbmc/pull/11877</ref>
* Guide window: Add possibility to switch between horizontal and vertical epg grid view <ref>https://github.com/xbmc/xbmc/pull/11958</ref>
* Search window: improvements and fixes <ref>https://github.com/xbmc/xbmc/pull/12001</ref>
* Estuary home screen: Add Info support to recently played channel widget <ref>https://github.com/xbmc/xbmc/pull/12254</ref>
* Estuary: Add episodename to live tv and recordings osd sub label, cleanup seek bar for live tv <ref>https://github.com/xbmc/xbmc/pull/12306</ref>
* Estuary: PVR info dialog, recordings window: cleanup and extend <ref>https://github.com/xbmc/xbmc/pull/12416</ref>
* Drop 'channel guide' button from epg event info dialog, add 'channel guide' to context menu <ref>https://github.com/xbmc/xbmc/pull/12526</ref>
* Settings: Introduce new setting 'Startup action' and add 'Play TV/Radio <ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Settings: Make 'epg.lingertime' an official setting, remove the respective advanced setting <ref>https://github.com/xbmc/xbmc/pull/12740</ref>
* Setting: Remove obsolete and unused setting 'pvrplayback.scantime' <ref>https://github.com/xbmc/xbmc/pull/12800</ref>
* Core: Fixes/Improvements for multiple enable PVR client addons <ref>https://github.com/xbmc/xbmc/pull/12959</ref>
* Core: Fixes/Improvements for subchannel numbers support (ATSC) <ref>https://github.com/xbmc/xbmc/pull/13069</ref>
* Core: Global direct channel number input & global unique channel numbers <ref>https://github.com/xbmc/xbmc/pull/13135</ref>
* Database: Fix error "Abort due to constraint violation. Query: INSERT INTO channels..." <ref>https://github.com/xbmc/xbmc/pull/13150</ref>
* Estuary: Rework PVR seekbar + Fix PVR info dialog <ref>https://github.com/xbmc/xbmc/pull/13158</ref>
* Core: Make next/previous chapter work for PVR recordings <ref>https://github.com/xbmc/xbmc/pull/13164</ref>
* Direct channel number input: No delay on switch to previous channel with key 0 <ref>https://github.com/xbmc/xbmc/pull/13232</ref>
* Settings: Make shared channel selection optional <ref>https://github.com/xbmc/xbmc/pull/13237</ref>
* Estuary: PVR info panel cleanup <ref>https://github.com/xbmc/xbmc/pull/13255</ref>
* Guide window: 'Go to date' context menu item <ref>https://github.com/xbmc/xbmc/pull/13282</ref>
* Estuary: Season/Episode info in Guide window and dialog <ref>https://github.com/xbmc/xbmc/pull/13300</ref>
* Estuary: Add percent played progress bar to PVR info panel (for recordings) <ref>https://github.com/xbmc/xbmc/pull/13338</ref>
* Guide window: Channel groups selector <ref>https://github.com/xbmc/xbmc/pull/13364</ref>
* Guide window: Tweaks for more consistency and readability <ref>https://github.com/xbmc/xbmc/pull/13402</ref>
* Guide window: Sort content by channel number/channel name/last played, support sort order <ref>https://github.com/xbmc/xbmc/pull/14231</ref>
* OSD: Timeshift: Revised GUI <ref>https://github.com/xbmc/xbmc/pull/14316</ref><ref>https://github.com/xbmc/xbmc/pull/14386</ref>
* OSD: Timeshift: Add support for next and previous buttons<ref>https://github.com/xbmc/xbmc/pull/14387</ref>
* PVR-Addon API changes <ref>https://github.com/xbmc/xbmc/pull/12028</ref><ref>https://github.com/xbmc/xbmc/pull/12303</ref><ref>https://github.com/xbmc/xbmc/pull/12552</ref><ref>https://github.com/xbmc/xbmc/pull/12609</ref><ref>https://github.com/xbmc/xbmc/pull/12660</ref><ref>https://github.com/xbmc/xbmc/pull/12689</ref><ref>https://github.com/xbmc/xbmc/pull/12755</ref><ref>https://github.com/xbmc/xbmc/pull/13228</ref>
* Added, updated, and improved PVR backend clients addons for all popular third-party external [[PVR backend]] platforms:
** New: [[Add-on:Zattoo PVR Client|Zattoo PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** New: [[Add-on:Teleboy PVR Client|Teleboy PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** New: [[Add-on:Sledovanitv.cz PVR Client|Sledovanitv.cz PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR Demo Client|PVR Demo Client]] dummy addon with fake (method stub) [[PVR backend]] for [[PVR]] skinning and regression testing
** [[Add-on:IPTV Simple Client|IPTV Simple Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:HDHomeRun PVR|HDHomeRun]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Digital Devices Octopus NET Client|Digital Devices Octopus NET Client]] PVR Addon backend client maintained and made available by [http://digitaldevices.de/home/ Digital Devices]
** [[Add-on:VU+ / Enigma2 Client|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Njoy N7 PVR Client|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VDR VNSI Client|VDR VNSI Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MythTV PVR Client|MythTV PVR Client]] Addon backend client maintained and available from the Kodi's community
** [[Add-on:NextPVR PVR Client|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Argus TV Client|Argus TV (former ForTheRecord)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBLink PVR Client|DVBLink PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBViewer Client|DVBViewer Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MediaPortal PVR Client|MediaPortal PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community
* ?

=== Add-ons Framework, API, and Manager ===
For full changelogs of all Addons APIs, see [[Leia API changes]], [https://forum.kodi.tv/showthread.php?tid=324598 JSON-RPC], and [http://forum.kodi.tv/forumdisplay.php?fid=26 Add-ons] Development Forums
* Major refactoring of Kodi's core handling and GUI management of binary addons<ref>http://github.com/xbmc/xbmc/pulls?q=label%3A%22Binary+Addons%22+is%3Aclosed</ref>
* Added framework to support VFS (Virtual File System) as binary addons<ref>http://github.com/xbmc/xbmc/pull/8966</ref>
* Added framework support for binary addons for video decoder codecs<ref name="Addon video codec implementation">https://github.com/xbmc/xbmc/pull/12340</ref>
* Added framework support for binary addons for image (picture) decoder codecs
* Added extentions to Kodi's Addons API to support binary addons for video decoder codecs<ref name="Addon video codec implementation"/>
* Added extentions to Kodi's Addons API to support binary addons for image decoder codecs
* Added support for Python addons to use PyCryptoDome crypto module for decryption<ref>https://github.com/xbmc/xbmc/pull/11477</ref>
* Added option to pass HTTP cookies with AVOption to Kodi's Video Player<ref>https://github.com/xbmc/xbmc/pull/12257</ref>
* Added support to allow addons to edit all used controls on their processed window<ref>https://github.com/xbmc/xbmc/pull/12259</ref>
* Added support to allow Python addons to set the videoinfotag path<ref>http://github.com/xbmc/xbmc/pull/11012</ref>
* Added support to allow Python addons to get/set the dbid of a (music) listitem<ref>http://github.com/xbmc/xbmc/pull/10858</ref>
* Added support for mediatype to musicinfotag tag retrieving via Python API<ref>http://github.com/xbmc/xbmc/pull/11110</ref>
* Added support "int/float slider" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11230</ref>
* Added support "setContent for mediawindows" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11258</ref>
* Added help for load of shared library and allow the use of their own addon temp folder<ref>https://github.com/xbmc/xbmc/pull/12379</ref>
* Added support to inspect add-on dependencies prior to installation<ref>https://github.com/xbmc/xbmc/pull/12242</ref>
* Added ability to remove add-on settings upon uninstall<ref>https://github.com/xbmc/xbmc/pull/11499</ref>
* Changed to new addon gui interface for list items to use on addon window<ref>https://github.com/xbmc/xbmc/pull/12214</ref>
* Changed service addons to use event handlers instead of synchronous addon hooks<ref>https://github.com/xbmc/xbmc/pull/12370</ref>
* Updated "Peripheral Addons" for game controllers, gamepads, joysticks, and input peripherals profiles (in Kodi-game repo<ref>http://github.com/kodi-game/ kodi-game repo on GitHub</ref>):
** [http://github.com/xbmc/peripheral.joystick Joystick Controller Addon]
** [http://github.com/kodi-game/peripheral.xarcade X-Arcade (XGaming Tankstick) support for Kodi Addon]
** [http://github.com/kodi-game/peripheral.steamcontroller Steam Controller (gamepad) Addon]
** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.default Default Game Controller Addon (reference game controller addon based on Xbox 360 gamepad)]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.ps PlayStation Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.nes Nintendo NES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.snes Nintendo SNES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.n64 Nintendo N64 Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.gba Nintendo GBA Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.genesis Sega Genesis Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.dreamcast Sega Dreamcast Game Controller Addon]
* ?

=== GUI Engine (Skinning Engine) ===
For full changelog on changes to the skinning engine, see [[Leia API changes]] and the [http://forum.kodi.tv/showthread.php?tid=298565 Skin Development Forum]
* Added windows to support Games and Game OSD in the new default skins (Estuary and Estouchy)
* Added player process info dialog to Kodi's default skin (Estuary)<ref>https://github.com/xbmc/xbmc/pull/11718</ref>
* Added support for addons to use banner and ClearLogo<ref>https://github.com/xbmc/xbmc/pull/12244</ref>
* Added support for skins/gui to allow implicit container referencing for non-media windows<ref>http://github.com/xbmc/xbmc/pull/10883</ref>
* Added support for addons to add "Enable/Disable" to context menu<ref>http://github.com/xbmc/xbmc/pull/11124</ref>
* Added support for remember last used keyboard layout in GUI<ref>http://github.com/xbmc/xbmc/pull/11242</ref>
* Added support for ISO 639-2/T language code retrieval (required by libbluray)<ref>https://github.com/xbmc/xbmc/pull/12258</ref>
* Added window that display Kodi privacy policy in GUI settings under system info<ref>https://github.com/xbmc/xbmc/pull/10785</ref>
* Added support to map a key to browse for subtitle in video fullscreen window<ref>https://github.com/xbmc/xbmc/pull/11649</ref>
* Improved Kodi's GUI engine with optimizations for message handling and SmartRedraw<ref>https://github.com/xbmc/xbmc/pull/12213</ref>
* Improved Kodi's GUI engine support for scaling container layouts<ref>http://github.com/xbmc/xbmc/pull/11229</ref>
* Improved Kodi's GUI engine by allowing %-values for origin, camera and animation attribs<ref>http://github.com/xbmc/xbmc/pull/11233</ref>
* Changed so that context menu reloading loads async to aviod GUI lockup on wait<ref>https://github.com/xbmc/xbmc/pull/11841</ref>
* Updated guilib ABI (for libgui) to version 5.13.0<ref>http://github.com/xbmc/xbmc/pull/11306</ref>
* Updated keyboard layout for some languages and added support Croatian, Slovenian, and Thai (Kedmanee)
* Updated image resource addons (as example weather icons, weather fanart, studio logos, and genre icons)
* ?

=== Platform Independent Playback ===
* Added support for "InputStream" (input stream) addons to pass CryptoSession flags field<ref>https://github.com/xbmc/xbmc/pull/12428</ref>
* Added support for BD-J / Blu-ray Disc Java menu support (requires system Java runtime enviroment)<ref>https://github.com/xbmc/xbmc/pull/12339</ref><ref>https://github.com/xbmc/xbmc/pull/12310</ref>
* Added support for Blu-ray Disc detection and use provided meta data for Blu-ray Disc names<ref>https://github.com/xbmc/xbmc/pull/12488</ref>
* Added support for video buffers to be used by decoders and renderers<ref name="VideoPlayer updates for Leia">https://github.com/xbmc/xbmc/pull/12212</ref>
** Added support for platforms to register custom buffers, like example dma<ref name="VideoPlayer updates for Leia"/>
* Added a VC1-Packet bitstream parser implementation for improved VC-1 playback<ref>http://github.com/xbmc/xbmc/pull/11417</ref>
* Added and updated many (binary) audio decoder and encoder addons for Kodi
* Added a few (binary) video decoder addons for Kodi<ref name="Addon video codec implementation"/>
* Added a "RAW" (libraw based) image decoder addon to Kodi<ref>https://github.com/xbmc/xbmc/pull/11671</ref>
* Improved MMAL playback of H.264 MVC (Blu-ray 3D) stereoscopic video with framepacking decoding on Raspberry Pi
* Improved Stereoscopic 3D playback of 3D videos (as well as better 2D playback of 3D videos)
* Improved and enhanced Blu-ray support (including updated libbluray dependecies from the VideoLAN project<ref>https://github.com/xbmc/xbmc/pull/12305</ref><ref>http://git.videolan.org/?p=libbluray.git;a=blob;f=ChangeLog</ref>
* Improved support for "InputStream" (input stream) addons as system addons
* Updated "InputStream" (input stream) client addons for common network streaming protocols and popular services:
** [http://github.com/xbmc/xbmc/tree/master/addons/kodi.inputstream InputStream Addon (default reference InputStream Addon by Team Kodi]
** [http://github.com/mapfau/inputstream.test Test InputStream Addon (Test InputStream Addon for Kodi's new inputstream interface]
** [http://github.com/peak3d/inputstream.adaptive Adaptive InputStream Addon (InputStream Client addon for several manifest types)]
** [http://github.com/xbmc/repo-binary-addons/tree/master/inputstream.rtmp RTMP InputStream Addon (InputStream Client for RTMP streams using librtmp)]
** [http://github.com/peak3d/inputstream.mpd MPD (MPEG-DASH) InputStream Addon]
** [http://github.com/peak3d/inputstream.smoothstream SmoothStream InputStream Addon for MS-SSTR (SmoothStreamingMedia) Smooth Streaming Protocol]
** [http://github.com/mapfau/inputstream.nxmsl NXMSL InputStream Addon for Netflix style manifests over MSL]
* Updated FFmpeg multimedia codec and demux libraries to stable branch release version [http://www.ffmpeg.org/download.html#release_3.3.2 FFmpeg 3.3 (3.3.2)]<ref>http://git.videolan.org/?p=ffmpeg.git;a=blob_plain;f=Changelog;hb=release/3.3.2 FFmpeg 3.3.2 release changelog</ref><ref>https://github.com/xbmc/xbmc/pull/12358</ref>
* Removed certain audio codecs from core and made them into audio decoder and audio encoder add-ons
* Removed certain video codecs from core and made them into video decoder add-ons<ref name="Addon video codec implementation"/>
* Removed certain image codecs from core and made them into image decoder add-ons
* ?

=== General Library ===
* Addded support to use the Favourites function in context menus<ref>https://github.com/xbmc/xbmc/pull/11967</ref>
* Added support for context menus to favourites home screen widget<ref>https://github.com/xbmc/xbmc/pull/11929</ref>
* Added support to "Sort By Date Added" in Music Video title node<ref>https://github.com/xbmc/xbmc/pull/12495</ref>

=== Music Library ===
* Fix- The use of BAND and ENSEMBLE (Vorbis and APE) tags. <ref>https://github.com/xbmc/xbmc/pull/11735</ref>
* Fix- Music library cleaning so not lock UI and cancel button works. <ref>https://github.com/xbmc/xbmc/pull/13117</ref>
* Fix- Issue of replay gain not being applied if peak value was missing, and also removed the avoid clipping setting. <ref>https://github.com/xbmc/xbmc/pull/11868</ref><ref>https://github.com/xbmc/xbmc/pull/11865</ref>
* Fix- Clean On Update which prevented scraping in some circumstances <ref>https://github.com/xbmc/xbmc/pull/11609</ref>
* Fix- Missing ''* Item Folder'' entry when browsing for artist fanart from Artist Info Dialog <ref>https://github.com/xbmc/xbmc/pull/12625</ref>
* Fix- Handling of duplicate MusicBrainzTrackID within the same album. Previous assumption was that the MusicBrainzTrackID is unique within the same album <ref>https://github.com/xbmc/xbmc/pull/12079</ref>
* Fix- Sort names for artists that are only album artists <ref>https://github.com/xbmc/xbmc/pull/13030</ref>
* Fix- Wrong playback order for smartplaylists, playlists and upnp <ref>https://github.com/xbmc/xbmc/pull/13059</ref>
* Fix- Cancelling of music library export which continued in the background even after cancel button clicked on progress dialog <ref>https://github.com/xbmc/xbmc/pull/13105</ref>
* Fix- Endless rescraping of unfound album <ref>https://github.com/xbmc/xbmc/pull/13752</ref>
* Fix- Art type "thumb" was sometimes being added to a song with an empty URL, preventing artist fanart from being shown on playback of library items from file view. <ref>https://github.com/xbmc/xbmc/pull/13854</ref>
* Improve- Handling of Cue Sheets <ref>https://github.com/xbmc/xbmc/pull/12082</ref>
* Improve- Online scraping of additional artist and album information making better use of Musicbrainz IDs. <ref>https://github.com/xbmc/xbmc/pull/12120</ref><ref>https://github.com/xbmc/xbmc/pull/12597</ref>
* Improve- On clean installs, change default song sort order to Track Number <ref>https://github.com/xbmc/xbmc/pull/12834</ref>
* Improve- FileItem::IsSamePath for albums and artists to prevent false matches <ref>https://github.com/xbmc/xbmc/pull/13585</ref>
* Improve- Album genre inconsistencies <ref>https://github.com/xbmc/xbmc/pull/13042</ref>
* Improve- Avoid unnecessary db access by GUI when app processing GUI_MSG_UPDATE_ITEM messages <ref>https://github.com/xbmc/xbmc/pull/13640</ref>
* Improve- Refactor Artist/Album Information Dialog <ref>https://github.com/xbmc/xbmc/pull/13672</ref>
* Improve- Refactor Song Information Dialog <ref>https://github.com/xbmc/xbmc/pull/13533</ref>
* Improve- Fetching local art for multi-folder albums (disc sets) <ref>https://github.com/xbmc/xbmc/pull/13769</ref>
* Add- Option to rescan the music file tags for existing items in the library <ref>https://github.com/xbmc/xbmc/pull/11557</ref>
* Add- Add processing of WRITER tag for ID3 v2, Vorbis and APE formats <ref>https://github.com/xbmc/xbmc/pull/11735</ref>
* Add- Processing of ARTISTSORT (TSOP), ALBUMARTISTSORT (TS02) and COMPOSERSORT (TSOC) tags to provide a sort name for artists. <ref>https://github.com/xbmc/xbmc/pull/11738</ref>
* Add- New dialog for selection of both artist and album scraper addons, and their settings.<ref>https://github.com/xbmc/xbmc/pull/12987</ref><ref>https://github.com/xbmc/xbmc/pull/12943</ref>
* Add- Additional artist data that Musicbrainz provides: type (person, group, orchestra, choir etc.), gender, and disambiguation comments that help to differentiate artists with the same name <ref>https://github.com/xbmc/xbmc/pull/12963</ref>
* Add- Artist Information Folder - a single location for artist artwork and nfo. This solves numerous issues related to artwork, artist data import and general folder and file structure <ref>https://github.com/xbmc/xbmc/pull/12891</ref>
* Add- Extended Artwork support, making the local art that is picked up automatically on scan configurable. <ref>https://github.com/xbmc/xbmc/pull/13352</ref><ref>https://github.com/xbmc/xbmc/pull/13848</ref><ref>https://github.com/xbmc/xbmc/pull/13491</ref><ref>https://github.com/xbmc/xbmc/pull/13101</ref><ref>https://github.com/xbmc/xbmc/pull/13871</ref>
* Add- Add option to prefer scraped album covers to embedded images <ref>https://github.com/xbmc/xbmc/pull/13812</ref>
* Add- Filter music items by media source <ref>https://github.com/xbmc/xbmc/pull/14012</ref><ref>https://github.com/xbmc/xbmc/pull/14082</ref>

=== Web Scrapers ===
* Added support for Python (script) based web scrapers for Kodi<ref>http://github.com/xbmc/xbmc/pull/9984</ref>
* Refactored and updated many XML based scrapers in Kodi for music, movies, tv shows, and music videos
* Updated music, movies, tv shows, and music video scrapers for Kodi
* ?

=== AudioEngine ===
* Added a new Sndio sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, other BSD Unix based systems, and Linux<ref>https://github.com/xbmc/xbmc/pull/11962</ref>
* Improved the default cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] (Kodi's [[AudioEngine]])
* Improved ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems
* Improved PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop
* Improved OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD and similar BSD Unix based systems
* Improved AUDIOTRACK sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Amlogic]]
* Improved Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]
* Improved DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved CoreAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* Improved Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* Renamed AE_SINK to KODI_AE_SINK
* ?

=== Other ===
* Added a new unified setting for "Startup action" and added "Play TV/Radio"<ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Added support to build Kodi with support for Bluetooth<ref>http://github.com/xbmc/xbmc/pull/11137</ref>
* Added possibility for CMake build system to add additional libraries on install<ref>https://github.com/xbmc/xbmc/pull/12423</ref>
* Updated and improved mappings for new and existing remote controls
* Improved Kodi's JSON-RPC API
* Improved compiling/building and code documentation (following doxygen coding guidelines)
* Changed to use spdlog for Kodi logging as well as improved and further optimized logging (including debug logs)<ref>https://github.com/xbmc/xbmc/pull/11833</ref>
* Changed XML format of setting values for Kodi's settings configuration<ref>https://github.com/xbmc/xbmc/pull/12277</ref>
* Updated default web interface (webinterface is called "Chorus2" and is currently at version 2.4.4)<ref>https://github.com/xbmc/xbmc/pull/11872</ref>
* Updated critical dependency libraries such as openssl, gnutls, and CMake (used to compile Kodi and its binary addons)
* Removed last dependencies of SDL (Simple DirectMedia Layer) which was hardware abstraction for input devices<ref>https://github.com/xbmc/xbmc/pull/12272</ref><ref>https://github.com/xbmc/xbmc/pull/11881</ref>
* Removed all glew (libglew library) dependencies in Kodi's code<ref>http://github.com/xbmc/xbmc/pull/11128</ref>
* ?

=== Android Specific ===
* Added support for speech-to-text in Kodi OSD keyboard on Android TV (triggered by voice button on remote)
* Added support for Android to move the Kodi app to SD card<ref>https://github.com/xbmc/xbmc/pull/12168</ref>
* Added support for Android TV Leanback search and recommendations meta data from Kodi<ref>|https://github.com/xbmc/xbmc/pull/11901</ref>
** Default setting for Android TV Leanback suggestion to random unwatched movies and music albums<ref>https://github.com/xbmc/xbmc/pull/11963</ref>
* Moved to Android NDK 16
* Changed Rendertype from GUILayer to VideoLayer for Android MediaCodecSurface<ref>https://github.com/xbmc/xbmc/pull/12097</ref>
* Changed to use NDK native C interface for Android MediaCodec (for performance gains)<ref>https://github.com/xbmc/xbmc/pull/11931</ref>
* Changed to support ZeroConf via native Android API (and deprecates mDNSresponder)<ref>http://github.com/xbmc/xbmc/pull/11393</ref>
* Changed to support network information via native Android API (and deprecates POSIX)<ref>https://github.com/xbmc/xbmc/pull/12243</ref>
* Changed handling of Kodi's Java interfaces via JNI for better consistency<ref>https://github.com/xbmc/xbmc/pull/12292</ref>
* ?

=== BSD Specific ===
* Improved Kodi support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* ?

=== Linux Specific ===
* Added support for a generic DRM/KMS implementation using GBM to create required surfaces<ref>https://github.com/xbmc/xbmc/pull/11955</ref>
* Added support for Mir windowing system (Mir 1.0) for Kodi<ref>http://github.com/xbmc/xbmc/pull/10898</ref> and added support for VAAPI on Mir using DRM<ref>http://github.com/xbmc/xbmc/pull/11040</ref>
* Added support for the middle mouse button on embedded platforms<ref>https://github.com/xbmc/xbmc/pull/11956</ref>
* Added support more yuv420p bitwidths for direct rendering on Linux<ref>https://github.com/xbmc/xbmc/pull/12479</ref>
* Added support for using VAAPI hardware video decoding with OpenGL ES<ref>https://github.com/xbmc/xbmc/pull/12113</ref>
* Added support for build Kodi with imx support using CMake<ref>http://github.com/xbmc/xbmc/pull/11288</ref>
* Moved the CMake build system to the top of the code tree (moved to root)<ref>http://github.com/xbmc/xbmc/pull/10446</ref>
* Improved support for UltraHD decoding / 4K resolution output when hardware supports it
* Improved ARM processor architecture (using [[Raspberry Pi]] as reference device)
* Improved OpenGL ES and EGL support (using [[Raspberry Pi]] as reference device)
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* Improved XvBA (AMD/ATI) Hardware Video Acceleration (requires XvBA compatible hardware and drivers)
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on Amlogic devices
* Removed the unused and unmaintained OpenMAX video decoder from Kodi's VideoPlayer<ref>https://github.com/xbmc/xbmc/pull/12197</ref>
* Removed support for autotools based build system for Kodi and binary addons (in favour of CMake)<ref>http://github.com/xbmc/xbmc/pull/10429</ref>
* ?

=== iOS Specific ===
* Added support for iOS 10.0 by adding support for compiling Kodi with Xcode 8 IDE and iOS SDK 10.0<ref>https://github.com/xbmc/xbmc/pull/10539</ref>
* Improved Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)
* Improved support for TVOS (Apple's iOS fork for Apple TV 4) in Kodi mainline
* Improved support for iOS on ARM64 (64-bit iOS)
* ?

=== OS X Specific ===
* Added support for compiling Kodi with Xcode 8 IDE for OSX 10.11 (El Capitan) and macOS 10.12 (Sierra)
* Improved Apple VDADecoder Video Acceleration support for (Mac) OS X
* ?

=== Windows Specific ===
* Added support to build Kodi for Windows 64 / Windows for Intel 64-bit (x86-64)<ref>https://github.com/xbmc/xbmc/pull/12065</ref>
* Added support for 3D LUT (3D Lookup Table) and dithering to Windows video renderer<ref name="WinRenderer re-work">https://github.com/xbmc/xbmc/pull/12475</ref>
* Improved support to compiling Kodi for Microsoft's UWP (Universal Windows Platform) APIs
* Changed the inner working of render buffers and rendering methods<ref name="WinRenderer re-work"/>
* Changed to using unicode win32 api methods<ref>https://github.com/xbmc/xbmc/pull/11780</ref>
* Changed windowing systems for screen saver handling on Windows OS platforms
* Changed to make Kodi for Windows platform independent of posix/main.cpp<ref>https://github.com/xbmc/xbmc/pull/12215</ref>
* Removed support for Windows Vista as the operating-system is no longer supported by Microsoft<ref>https://github.com/xbmc/xbmc/pull/11953</ref>
* ?

== References ==
<references/>

== See also ==
* [[Leia API changes]]
{{Changelogs}}

[[Category:Manual]]
[[Category:Leia|*]]
[[Category:Changelogs|18]]

Kodi v18 (Leia) changelog

2018-08-26T08:30:10Z

Ksooo:

{{mininav|[[Releases]] {{l2| [[Leia]] }} }}

{{notice|Kodi v17 (Krypton) final has just been released, so please keep in mind that a final non-alpha/beta v18 (Leia) release is still far far away into the future. As such, these new features/functions and API changes is a placeholder containing changes to the current Kodi mainline (the git master tree repository on GitHub). It is a very much a work in progress, this is only listing changes commited to the master branch after Jarvis branching, and many many many features/functions and API additions, alterations or removal are still subject to future change.}}
{{incomplete}}
{{future|18}}

{{see also|Kodi v18 (Leia) FAQ|Leia API changes|Releases}}

This is a placeholder and Kodi Wiki copy of the condensed changelog for the future Kodi v18.x version (codename: "Leia") releases with a summery of the most important core features and functions as well as other notable changes to key areas of the application software or its user interface.

== Changelog ==

=== Gaming (Games interface and Game Clients)===
* Added a RetroPlayer player core supporting game clients as well as emulator cores via libretro API<ref name="RetroPlayer">RetroPlayer http://forum.kodi.tv/showthread.php?tid=164725</ref><ref>http://github.com/xbmc/xbmc/pull/11022</ref>
* Added extentions to Kodi's Addons AP to support Game Client Addons, supporting Kodi's VFS (Virtual File System), etc.<ref name="RetroPlayer"/>
* Added support for Game Client Addons as new type of addons with just-in-time emulator installation<ref name="RetroPlayer"/>
* Added a Games window and Game OSD (On-Screen-Display) entries to the GUI<ref name="RetroPlayer"/><ref>https://github.com/xbmc/xbmc/pull/12367</ref>
* Added a gaming and game configuration interface for Game settings to the GUI<ref name="RetroPlayer"/>
* Added support for Game Info Tags (game info tag) and exposed properties to Python list items<ref name="RetroPlayer"/>
* Added a savestate (savestate) manager to Kodi for games<ref>http://github.com/xbmc/xbmc/pull/11034</ref>
* Added initial support for basic gameplay persistence (auto-save & auto-load)<ref>https://github.com/xbmc/xbmc/pull/12434</ref>
* Added support for in-game (save RAM) saves<ref>http://github.com/xbmc/xbmc/pull/11380</ref>
* Added support for Keyboard players via Joystick Emulation<ref name="RetroPlayer"/>
* Added support for libretro API and game cores (emulators and games) that support it
* Added [[Game_Add-ons|game clients addons]] for many popular third-party game console emulators and native open source games *
** ''* [[Game_Add-ons|Game clients addons]] for Kodi is changing quickly so checkout the [[Game_Add-ons|game clients addons]] article for a current list''
* ?

=== Live TV and PVR (Personal Video Recorder) ===
* Major GUI actions refactoring to eliminate duplicate and dead code. Add context menu support for Estuary PVR home screen widgets <ref>https://github.com/xbmc/xbmc/pull/10870</ref>
* Guide window: Get rid of obsolete views "channel", "now" and "next" <ref>https://github.com/xbmc/xbmc/pull/10838</ref>
* Core: Refactor and fix "play minimized" settings handling <ref>https://github.com/xbmc/xbmc/pull/11203</ref>
* Guide, channel, video fullscreen, music visualisation window: Direct channel number input. <ref>https://github.com/xbmc/xbmc/pull/11434</ref>
* Settings: Remove setting 'hide connection lost warning' <ref>https://github.com/xbmc/xbmc/pull/11500</ref>
* Search dialog: Refactor and complete implementation of EPG search filter <ref>https://github.com/xbmc/xbmc/pull/11570</ref>
* Timer settings dialog: Prefill recordings folder with timer title <ref>https://github.com/xbmc/xbmc/pull/11679</ref>
* Recordings window: Content view filter <ref>https://github.com/xbmc/xbmc/pull/11704</ref>
* Settings: Remove non-working recording settings defaults <ref>https://github.com/xbmc/xbmc/pull/11746</ref>
* Guide window: 'Smart selection' of epg events. <ref>https://github.com/xbmc/xbmc/pull/11782</ref>
* Channelgroup manager: Add support for radio channel groups <ref>https://github.com/xbmc/xbmc/pull/11877</ref>
* Guide window: Add possibility to switch between horizontal and vertical epg grid view <ref>https://github.com/xbmc/xbmc/pull/11958</ref>
* Search window: improvements and fixes <ref>https://github.com/xbmc/xbmc/pull/12001</ref>
* Estuary home screen: Add Info support to recently played channel widget <ref>https://github.com/xbmc/xbmc/pull/12254</ref>
* Estuary: Add episodename to live tv and recordings osd sub label, cleanup seek bar for live tv <ref>https://github.com/xbmc/xbmc/pull/12306</ref>
* Estuary: PVR info dialog, recordings window: cleanup and extend <ref>https://github.com/xbmc/xbmc/pull/12416</ref>
* Drop 'channel guide' button from epg event info dialog, add 'channel guide' to context menu <ref>https://github.com/xbmc/xbmc/pull/12526</ref>
* Settings: Introduce new setting 'Startup action' and add 'Play TV/Radio <ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Settings: Make 'epg.lingertime' an official setting, remove the respective advanced setting <ref>https://github.com/xbmc/xbmc/pull/12740</ref>
* Setting: Remove obsolete and unused setting 'pvrplayback.scantime' <ref>https://github.com/xbmc/xbmc/pull/12800</ref>
* Core: Fixes/Improvements for multiple enable PVR client addons <ref>https://github.com/xbmc/xbmc/pull/12959</ref>
* Core: Fixes/Improvements for subchannel numbers support (ATSC) <ref>https://github.com/xbmc/xbmc/pull/13069</ref>
* Core: Global direct channel number input & global unique channel numbers <ref>https://github.com/xbmc/xbmc/pull/13135</ref>
* Database: Fix error "Abort due to constraint violation. Query: INSERT INTO channels..." <ref>https://github.com/xbmc/xbmc/pull/13150</ref>
* Estuary: Rework PVR seekbar + Fix PVR info dialog <ref>https://github.com/xbmc/xbmc/pull/13158</ref>
* Core: Make next/previous chapter work for PVR recordings <ref>https://github.com/xbmc/xbmc/pull/13164</ref>
* Direct channel number input: No delay on switch to previous channel with key 0 <ref>https://github.com/xbmc/xbmc/pull/13232</ref>
* Settings: Make shared channel selection optional <ref>https://github.com/xbmc/xbmc/pull/13237</ref>
* Estuary: PVR info panel cleanup <ref>https://github.com/xbmc/xbmc/pull/13255</ref>
* Guide window: 'Go to date' context menu item <ref>https://github.com/xbmc/xbmc/pull/13282</ref>
* Estuary: Season/Episode info in Guide window and dialog <ref>https://github.com/xbmc/xbmc/pull/13300</ref>
* Estuary: Add percent played progress bar to PVR info panel (for recordings) <ref>https://github.com/xbmc/xbmc/pull/13338</ref>
* Guide window: Channel groups selector <ref>https://github.com/xbmc/xbmc/pull/13364</ref>
* Guide window: Tweaks for more consistency and readability <ref>https://github.com/xbmc/xbmc/pull/13402</ref>
* Guide window: Sort content by channel number/channel name/last played, support sort order <ref>https://github.com/xbmc/xbmc/pull/14231</ref>
* OSD: PVR timeshift GUI v2 <ref>https://github.com/xbmc/xbmc/pull/14316</ref>
* PVR-Addon API changes <ref>https://github.com/xbmc/xbmc/pull/12028</ref><ref>https://github.com/xbmc/xbmc/pull/12303</ref><ref>https://github.com/xbmc/xbmc/pull/12552</ref><ref>https://github.com/xbmc/xbmc/pull/12609</ref><ref>https://github.com/xbmc/xbmc/pull/12660</ref><ref>https://github.com/xbmc/xbmc/pull/12689</ref><ref>https://github.com/xbmc/xbmc/pull/12755</ref><ref>https://github.com/xbmc/xbmc/pull/13228</ref>
* Added, updated, and improved PVR backend clients addons for all popular third-party external [[PVR backend]] platforms:
** New: [[Add-on:Zattoo PVR Client|Zattoo PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** New: [[Add-on:Teleboy PVR Client|Teleboy PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** New: [[Add-on:Sledovanitv.cz PVR Client|Sledovanitv.cz PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR Demo Client|PVR Demo Client]] dummy addon with fake (method stub) [[PVR backend]] for [[PVR]] skinning and regression testing
** [[Add-on:IPTV Simple Client|IPTV Simple Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:HDHomeRun PVR|HDHomeRun]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Digital Devices Octopus NET Client|Digital Devices Octopus NET Client]] PVR Addon backend client maintained and made available by [http://digitaldevices.de/home/ Digital Devices]
** [[Add-on:VU+ / Enigma2 Client|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Njoy N7 PVR Client|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VDR VNSI Client|VDR VNSI Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MythTV PVR Client|MythTV PVR Client]] Addon backend client maintained and available from the Kodi's community
** [[Add-on:NextPVR PVR Client|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Argus TV Client|Argus TV (former ForTheRecord)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBLink PVR Client|DVBLink PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBViewer Client|DVBViewer Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MediaPortal PVR Client|MediaPortal PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community
* ?

=== Add-ons Framework, API, and Manager ===
For full changelogs of all Addons APIs, see [[Leia API changes]], [https://forum.kodi.tv/showthread.php?tid=324598 JSON-RPC], and [http://forum.kodi.tv/forumdisplay.php?fid=26 Add-ons] Development Forums
* Major refactoring of Kodi's core handling and GUI management of binary addons<ref>http://github.com/xbmc/xbmc/pulls?q=label%3A%22Binary+Addons%22+is%3Aclosed</ref>
* Added framework to support VFS (Virtual File System) as binary addons<ref>http://github.com/xbmc/xbmc/pull/8966</ref>
* Added framework support for binary addons for video decoder codecs<ref name="Addon video codec implementation">https://github.com/xbmc/xbmc/pull/12340</ref>
* Added framework support for binary addons for image (picture) decoder codecs
* Added extentions to Kodi's Addons API to support binary addons for video decoder codecs<ref name="Addon video codec implementation"/>
* Added extentions to Kodi's Addons API to support binary addons for image decoder codecs
* Added support for Python addons to use PyCryptoDome crypto module for decryption<ref>https://github.com/xbmc/xbmc/pull/11477</ref>
* Added option to pass HTTP cookies with AVOption to Kodi's Video Player<ref>https://github.com/xbmc/xbmc/pull/12257</ref>
* Added support to allow addons to edit all used controls on their processed window<ref>https://github.com/xbmc/xbmc/pull/12259</ref>
* Added support to allow Python addons to set the videoinfotag path<ref>http://github.com/xbmc/xbmc/pull/11012</ref>
* Added support to allow Python addons to get/set the dbid of a (music) listitem<ref>http://github.com/xbmc/xbmc/pull/10858</ref>
* Added support for mediatype to musicinfotag tag retrieving via Python API<ref>http://github.com/xbmc/xbmc/pull/11110</ref>
* Added support "int/float slider" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11230</ref>
* Added support "setContent for mediawindows" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11258</ref>
* Added help for load of shared library and allow the use of their own addon temp folder<ref>https://github.com/xbmc/xbmc/pull/12379</ref>
* Added support to inspect add-on dependencies prior to installation<ref>https://github.com/xbmc/xbmc/pull/12242</ref>
* Added ability to remove add-on settings upon uninstall<ref>https://github.com/xbmc/xbmc/pull/11499</ref>
* Changed to new addon gui interface for list items to use on addon window<ref>https://github.com/xbmc/xbmc/pull/12214</ref>
* Changed service addons to use event handlers instead of synchronous addon hooks<ref>https://github.com/xbmc/xbmc/pull/12370</ref>
* Updated "Peripheral Addons" for game controllers, gamepads, joysticks, and input peripherals profiles (in Kodi-game repo<ref>http://github.com/kodi-game/ kodi-game repo on GitHub</ref>):
** [http://github.com/xbmc/peripheral.joystick Joystick Controller Addon]
** [http://github.com/kodi-game/peripheral.xarcade X-Arcade (XGaming Tankstick) support for Kodi Addon]
** [http://github.com/kodi-game/peripheral.steamcontroller Steam Controller (gamepad) Addon]
** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.default Default Game Controller Addon (reference game controller addon based on Xbox 360 gamepad)]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.ps PlayStation Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.nes Nintendo NES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.snes Nintendo SNES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.n64 Nintendo N64 Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.gba Nintendo GBA Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.genesis Sega Genesis Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.dreamcast Sega Dreamcast Game Controller Addon]
* ?

=== GUI Engine (Skinning Engine) ===
For full changelog on changes to the skinning engine, see [[Leia API changes]] and the [http://forum.kodi.tv/showthread.php?tid=298565 Skin Development Forum]
* Added windows to support Games and Game OSD in the new default skins (Estuary and Estouchy)
* Added player process info dialog to Kodi's default skin (Estuary)<ref>https://github.com/xbmc/xbmc/pull/11718</ref>
* Added support for addons to use banner and ClearLogo<ref>https://github.com/xbmc/xbmc/pull/12244</ref>
* Added support for skins/gui to allow implicit container referencing for non-media windows<ref>http://github.com/xbmc/xbmc/pull/10883</ref>
* Added support for addons to add "Enable/Disable" to context menu<ref>http://github.com/xbmc/xbmc/pull/11124</ref>
* Added support for remember last used keyboard layout in GUI<ref>http://github.com/xbmc/xbmc/pull/11242</ref>
* Added support for ISO 639-2/T language code retrieval (required by libbluray)<ref>https://github.com/xbmc/xbmc/pull/12258</ref>
* Added window that display Kodi privacy policy in GUI settings under system info<ref>https://github.com/xbmc/xbmc/pull/10785</ref>
* Added support to map a key to browse for subtitle in video fullscreen window<ref>https://github.com/xbmc/xbmc/pull/11649</ref>
* Improved Kodi's GUI engine with optimizations for message handling and SmartRedraw<ref>https://github.com/xbmc/xbmc/pull/12213</ref>
* Improved Kodi's GUI engine support for scaling container layouts<ref>http://github.com/xbmc/xbmc/pull/11229</ref>
* Improved Kodi's GUI engine by allowing %-values for origin, camera and animation attribs<ref>http://github.com/xbmc/xbmc/pull/11233</ref>
* Changed so that context menu reloading loads async to aviod GUI lockup on wait<ref>https://github.com/xbmc/xbmc/pull/11841</ref>
* Updated guilib ABI (for libgui) to version 5.13.0<ref>http://github.com/xbmc/xbmc/pull/11306</ref>
* Updated keyboard layout for some languages and added support Croatian, Slovenian, and Thai (Kedmanee)
* Updated image resource addons (as example weather icons, weather fanart, studio logos, and genre icons)
* ?

=== Platform Independent Playback ===
* Added support for "InputStream" (input stream) addons to pass CryptoSession flags field<ref>https://github.com/xbmc/xbmc/pull/12428</ref>
* Added support for BD-J / Blu-ray Disc Java menu support (requires system Java runtime enviroment)<ref>https://github.com/xbmc/xbmc/pull/12339</ref><ref>https://github.com/xbmc/xbmc/pull/12310</ref>
* Added support for Blu-ray Disc detection and use provided meta data for Blu-ray Disc names<ref>https://github.com/xbmc/xbmc/pull/12488</ref>
* Added support for video buffers to be used by decoders and renderers<ref name="VideoPlayer updates for Leia">https://github.com/xbmc/xbmc/pull/12212</ref>
** Added support for platforms to register custom buffers, like example dma<ref name="VideoPlayer updates for Leia"/>
* Added a VC1-Packet bitstream parser implementation for improved VC-1 playback<ref>http://github.com/xbmc/xbmc/pull/11417</ref>
* Added and updated many (binary) audio decoder and encoder addons for Kodi
* Added a few (binary) video decoder addons for Kodi<ref name="Addon video codec implementation"/>
* Added a "RAW" (libraw based) image decoder addon to Kodi<ref>https://github.com/xbmc/xbmc/pull/11671</ref>
* Improved MMAL playback of H.264 MVC (Blu-ray 3D) stereoscopic video with framepacking decoding on Raspberry Pi
* Improved Stereoscopic 3D playback of 3D videos (as well as better 2D playback of 3D videos)
* Improved and enhanced Blu-ray support (including updated libbluray dependecies from the VideoLAN project<ref>https://github.com/xbmc/xbmc/pull/12305</ref><ref>http://git.videolan.org/?p=libbluray.git;a=blob;f=ChangeLog</ref>
* Improved support for "InputStream" (input stream) addons as system addons
* Updated "InputStream" (input stream) client addons for common network streaming protocols and popular services:
** [http://github.com/xbmc/xbmc/tree/master/addons/kodi.inputstream InputStream Addon (default reference InputStream Addon by Team Kodi]
** [http://github.com/mapfau/inputstream.test Test InputStream Addon (Test InputStream Addon for Kodi's new inputstream interface]
** [http://github.com/peak3d/inputstream.adaptive Adaptive InputStream Addon (InputStream Client addon for several manifest types)]
** [http://github.com/xbmc/repo-binary-addons/tree/master/inputstream.rtmp RTMP InputStream Addon (InputStream Client for RTMP streams using librtmp)]
** [http://github.com/peak3d/inputstream.mpd MPD (MPEG-DASH) InputStream Addon]
** [http://github.com/peak3d/inputstream.smoothstream SmoothStream InputStream Addon for MS-SSTR (SmoothStreamingMedia) Smooth Streaming Protocol]
** [http://github.com/mapfau/inputstream.nxmsl NXMSL InputStream Addon for Netflix style manifests over MSL]
* Updated FFmpeg multimedia codec and demux libraries to stable branch release version [http://www.ffmpeg.org/download.html#release_3.3.2 FFmpeg 3.3 (3.3.2)]<ref>http://git.videolan.org/?p=ffmpeg.git;a=blob_plain;f=Changelog;hb=release/3.3.2 FFmpeg 3.3.2 release changelog</ref><ref>https://github.com/xbmc/xbmc/pull/12358</ref>
* Removed certain audio codecs from core and made them into audio decoder and audio encoder add-ons
* Removed certain video codecs from core and made them into video decoder add-ons<ref name="Addon video codec implementation"/>
* Removed certain image codecs from core and made them into image decoder add-ons
* ?

=== General Library ===
* Addded support to use the Favourites function in context menus<ref>https://github.com/xbmc/xbmc/pull/11967</ref>
* Added support for context menus to favourites home screen widget<ref>https://github.com/xbmc/xbmc/pull/11929</ref>
* Added support to "Sort By Date Added" in Music Video title node<ref>https://github.com/xbmc/xbmc/pull/12495</ref>

=== Music Library ===
* Fix- The use of BAND and ENSEMBLE (Vorbis and APE) tags. <ref>https://github.com/xbmc/xbmc/pull/11735</ref>
* Fix- Music library cleaning so not lock UI and cancel button works. <ref>https://github.com/xbmc/xbmc/pull/13117</ref>
* Fix- Issue of replay gain not being applied if peak value was missing, and also removed the avoid clipping setting. <ref>https://github.com/xbmc/xbmc/pull/11868</ref><ref>https://github.com/xbmc/xbmc/pull/11865</ref>
* Fix- Clean On Update which prevented scraping in some circumstances <ref>https://github.com/xbmc/xbmc/pull/11609</ref>
* Fix- Missing ''* Item Folder'' entry when browsing for artist fanart from Artist Info Dialog <ref>https://github.com/xbmc/xbmc/pull/12625</ref>
* Fix- Handling of duplicate MusicBrainzTrackID within the same album. Previous assumption was that the MusicBrainzTrackID is unique within the same album <ref>https://github.com/xbmc/xbmc/pull/12079</ref>
* Fix- Sort names for artists that are only album artists <ref>https://github.com/xbmc/xbmc/pull/13030</ref>
* Fix- Wrong playback order for smartplaylists, playlists and upnp <ref>https://github.com/xbmc/xbmc/pull/13059</ref>
* Fix- Cancelling of music library export which continued in the background even after cancel button clicked on progress dialog <ref>https://github.com/xbmc/xbmc/pull/13105</ref>
* Fix- Endless rescraping of unfound album <ref>https://github.com/xbmc/xbmc/pull/13752</ref>
* Fix- Art type "thumb" was sometimes being added to a song with an empty URL, preventing artist fanart from being shown on playback of library items from file view. <ref>https://github.com/xbmc/xbmc/pull/13854</ref>
* Improve- Handling of Cue Sheets <ref>https://github.com/xbmc/xbmc/pull/12082</ref>
* Improve- Online scraping of additional artist and album information making better use of Musicbrainz IDs. <ref>https://github.com/xbmc/xbmc/pull/12120</ref><ref>https://github.com/xbmc/xbmc/pull/12597</ref>
* Improve- On clean installs, change default song sort order to Track Number <ref>https://github.com/xbmc/xbmc/pull/12834</ref>
* Improve- FileItem::IsSamePath for albums and artists to prevent false matches <ref>https://github.com/xbmc/xbmc/pull/13585</ref>
* Improve- Album genre inconsistencies <ref>https://github.com/xbmc/xbmc/pull/13042</ref>
* Improve- Avoid unnecessary db access by GUI when app processing GUI_MSG_UPDATE_ITEM messages <ref>https://github.com/xbmc/xbmc/pull/13640</ref>
* Improve- Refactor Artist/Album Information Dialog <ref>https://github.com/xbmc/xbmc/pull/13672</ref>
* Improve- Refactor Song Information Dialog <ref>https://github.com/xbmc/xbmc/pull/13533</ref>
* Improve- Fetching local art for multi-folder albums (disc sets) <ref>https://github.com/xbmc/xbmc/pull/13769</ref>
* Add- Option to rescan the music file tags for existing items in the library <ref>https://github.com/xbmc/xbmc/pull/11557</ref>
* Add- Add processing of WRITER tag for ID3 v2, Vorbis and APE formats <ref>https://github.com/xbmc/xbmc/pull/11735</ref>
* Add- Processing of ARTISTSORT (TSOP), ALBUMARTISTSORT (TS02) and COMPOSERSORT (TSOC) tags to provide a sort name for artists. <ref>https://github.com/xbmc/xbmc/pull/11738</ref>
* Add- New dialog for selection of both artist and album scraper addons, and their settings.<ref>https://github.com/xbmc/xbmc/pull/12987</ref><ref>https://github.com/xbmc/xbmc/pull/12943</ref>
* Add- Additional artist data that Musicbrainz provides: type (person, group, orchestra, choir etc.), gender, and disambiguation comments that help to differentiate artists with the same name <ref>https://github.com/xbmc/xbmc/pull/12963</ref>
* Add- Artist Information Folder - a single location for artist artwork and nfo. This solves numerous issues related to artwork, artist data import and general folder and file structure <ref>https://github.com/xbmc/xbmc/pull/12891</ref>
* Add- Extended Artwork support, making the local art that is picked up automatically on scan configurable. <ref>https://github.com/xbmc/xbmc/pull/13352</ref><ref>https://github.com/xbmc/xbmc/pull/13848</ref><ref>https://github.com/xbmc/xbmc/pull/13491</ref><ref>https://github.com/xbmc/xbmc/pull/13101</ref><ref>https://github.com/xbmc/xbmc/pull/13871</ref>
* Add- Add option to prefer scraped album covers to embedded images <ref>https://github.com/xbmc/xbmc/pull/13812</ref>
* Add- Filter music items by media source <ref>https://github.com/xbmc/xbmc/pull/14012</ref><ref>https://github.com/xbmc/xbmc/pull/14082</ref>

=== Web Scrapers ===
* Added support for Python (script) based web scrapers for Kodi<ref>http://github.com/xbmc/xbmc/pull/9984</ref>
* Refactored and updated many XML based scrapers in Kodi for music, movies, tv shows, and music videos
* Updated music, movies, tv shows, and music video scrapers for Kodi
* ?

=== AudioEngine ===
* Added a new Sndio sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, other BSD Unix based systems, and Linux<ref>https://github.com/xbmc/xbmc/pull/11962</ref>
* Improved the default cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] (Kodi's [[AudioEngine]])
* Improved ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems
* Improved PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop
* Improved OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD and similar BSD Unix based systems
* Improved AUDIOTRACK sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Amlogic]]
* Improved Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]
* Improved DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved CoreAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* Improved Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* Renamed AE_SINK to KODI_AE_SINK
* ?

=== Other ===
* Added a new unified setting for "Startup action" and added "Play TV/Radio"<ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Added support to build Kodi with support for Bluetooth<ref>http://github.com/xbmc/xbmc/pull/11137</ref>
* Added possibility for CMake build system to add additional libraries on install<ref>https://github.com/xbmc/xbmc/pull/12423</ref>
* Updated and improved mappings for new and existing remote controls
* Improved Kodi's JSON-RPC API
* Improved compiling/building and code documentation (following doxygen coding guidelines)
* Changed to use spdlog for Kodi logging as well as improved and further optimized logging (including debug logs)<ref>https://github.com/xbmc/xbmc/pull/11833</ref>
* Changed XML format of setting values for Kodi's settings configuration<ref>https://github.com/xbmc/xbmc/pull/12277</ref>
* Updated default web interface (webinterface is called "Chorus2" and is currently at version 2.4.4)<ref>https://github.com/xbmc/xbmc/pull/11872</ref>
* Updated critical dependency libraries such as openssl, gnutls, and CMake (used to compile Kodi and its binary addons)
* Removed last dependencies of SDL (Simple DirectMedia Layer) which was hardware abstraction for input devices<ref>https://github.com/xbmc/xbmc/pull/12272</ref><ref>https://github.com/xbmc/xbmc/pull/11881</ref>
* Removed all glew (libglew library) dependencies in Kodi's code<ref>http://github.com/xbmc/xbmc/pull/11128</ref>
* ?

=== Android Specific ===
* Added support for speech-to-text in Kodi OSD keyboard on Android TV (triggered by voice button on remote)
* Added support for Android to move the Kodi app to SD card<ref>https://github.com/xbmc/xbmc/pull/12168</ref>
* Added support for Android TV Leanback search and recommendations meta data from Kodi<ref>|https://github.com/xbmc/xbmc/pull/11901</ref>
** Default setting for Android TV Leanback suggestion to random unwatched movies and music albums<ref>https://github.com/xbmc/xbmc/pull/11963</ref>
* Moved to Android NDK 16
* Changed Rendertype from GUILayer to VideoLayer for Android MediaCodecSurface<ref>https://github.com/xbmc/xbmc/pull/12097</ref>
* Changed to use NDK native C interface for Android MediaCodec (for performance gains)<ref>https://github.com/xbmc/xbmc/pull/11931</ref>
* Changed to support ZeroConf via native Android API (and deprecates mDNSresponder)<ref>http://github.com/xbmc/xbmc/pull/11393</ref>
* Changed to support network information via native Android API (and deprecates POSIX)<ref>https://github.com/xbmc/xbmc/pull/12243</ref>
* Changed handling of Kodi's Java interfaces via JNI for better consistency<ref>https://github.com/xbmc/xbmc/pull/12292</ref>
* ?

=== BSD Specific ===
* Improved Kodi support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* ?

=== Linux Specific ===
* Added support for a generic DRM/KMS implementation using GBM to create required surfaces<ref>https://github.com/xbmc/xbmc/pull/11955</ref>
* Added support for Mir windowing system (Mir 1.0) for Kodi<ref>http://github.com/xbmc/xbmc/pull/10898</ref> and added support for VAAPI on Mir using DRM<ref>http://github.com/xbmc/xbmc/pull/11040</ref>
* Added support for the middle mouse button on embedded platforms<ref>https://github.com/xbmc/xbmc/pull/11956</ref>
* Added support more yuv420p bitwidths for direct rendering on Linux<ref>https://github.com/xbmc/xbmc/pull/12479</ref>
* Added support for using VAAPI hardware video decoding with OpenGL ES<ref>https://github.com/xbmc/xbmc/pull/12113</ref>
* Added support for build Kodi with imx support using CMake<ref>http://github.com/xbmc/xbmc/pull/11288</ref>
* Moved the CMake build system to the top of the code tree (moved to root)<ref>http://github.com/xbmc/xbmc/pull/10446</ref>
* Improved support for UltraHD decoding / 4K resolution output when hardware supports it
* Improved ARM processor architecture (using [[Raspberry Pi]] as reference device)
* Improved OpenGL ES and EGL support (using [[Raspberry Pi]] as reference device)
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* Improved XvBA (AMD/ATI) Hardware Video Acceleration (requires XvBA compatible hardware and drivers)
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on Amlogic devices
* Removed the unused and unmaintained OpenMAX video decoder from Kodi's VideoPlayer<ref>https://github.com/xbmc/xbmc/pull/12197</ref>
* Removed support for autotools based build system for Kodi and binary addons (in favour of CMake)<ref>http://github.com/xbmc/xbmc/pull/10429</ref>
* ?

=== iOS Specific ===
* Added support for iOS 10.0 by adding support for compiling Kodi with Xcode 8 IDE and iOS SDK 10.0<ref>https://github.com/xbmc/xbmc/pull/10539</ref>
* Improved Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)
* Improved support for TVOS (Apple's iOS fork for Apple TV 4) in Kodi mainline
* Improved support for iOS on ARM64 (64-bit iOS)
* ?

=== OS X Specific ===
* Added support for compiling Kodi with Xcode 8 IDE for OSX 10.11 (El Capitan) and macOS 10.12 (Sierra)
* Improved Apple VDADecoder Video Acceleration support for (Mac) OS X
* ?

=== Windows Specific ===
* Added support to build Kodi for Windows 64 / Windows for Intel 64-bit (x86-64)<ref>https://github.com/xbmc/xbmc/pull/12065</ref>
* Added support for 3D LUT (3D Lookup Table) and dithering to Windows video renderer<ref name="WinRenderer re-work">https://github.com/xbmc/xbmc/pull/12475</ref>
* Improved support to compiling Kodi for Microsoft's UWP (Universal Windows Platform) APIs
* Changed the inner working of render buffers and rendering methods<ref name="WinRenderer re-work"/>
* Changed to using unicode win32 api methods<ref>https://github.com/xbmc/xbmc/pull/11780</ref>
* Changed windowing systems for screen saver handling on Windows OS platforms
* Changed to make Kodi for Windows platform independent of posix/main.cpp<ref>https://github.com/xbmc/xbmc/pull/12215</ref>
* Removed support for Windows Vista as the operating-system is no longer supported by Microsoft<ref>https://github.com/xbmc/xbmc/pull/11953</ref>
* ?

== References ==
<references/>

== See also ==
* [[Leia API changes]]
{{Changelogs}}

[[Category:Manual]]
[[Category:Leia|*]]
[[Category:Changelogs|18]]

Kodi v18 (Leia) changelog

2018-07-31T18:13:01Z

Ksooo:

{{mininav|[[Releases]] {{l2| [[Leia]] }} }}

{{notice|Kodi v17 (Krypton) final has just been released, so please keep in mind that a final non-alpha/beta v18 (Leia) release is still far far away into the future. As such, these new features/functions and API changes is a placeholder containing changes to the current Kodi mainline (the git master tree repository on GitHub). It is a very much a work in progress, this is only listing changes commited to the master branch after Jarvis branching, and many many many features/functions and API additions, alterations or removal are still subject to future change.}}
{{incomplete}}
{{future|18}}

{{see also|Kodi v18 (Leia) FAQ|Leia API changes|Releases}}

This is a placeholder and Kodi Wiki copy of the condensed changelog for the future Kodi v18.x version (codename: "Leia") releases with a summery of the most important core features and functions as well as other notable changes to key areas of the application software or its user interface.

== Changelog ==

=== Gaming (Games interface and Game Clients)===
* Added a RetroPlayer player core supporting game clients as well as emulator cores via libretro API<ref name="RetroPlayer">RetroPlayer http://forum.kodi.tv/showthread.php?tid=164725</ref><ref>http://github.com/xbmc/xbmc/pull/11022</ref>
* Added extentions to Kodi's Addons AP to support Game Client Addons, supporting Kodi's VFS (Virtual File System), etc.<ref name="RetroPlayer"/>
* Added support for Game Client Addons as new type of addons with just-in-time emulator installation<ref name="RetroPlayer"/>
* Added a Games window and Game OSD (On-Screen-Display) entries to the GUI<ref name="RetroPlayer"/><ref>https://github.com/xbmc/xbmc/pull/12367</ref>
* Added a gaming and game configuration interface for Game settings to the GUI<ref name="RetroPlayer"/>
* Added support for Game Info Tags (game info tag) and exposed properties to Python list items<ref name="RetroPlayer"/>
* Added a savestate (savestate) manager to Kodi for games<ref>http://github.com/xbmc/xbmc/pull/11034</ref>
* Added initial support for basic gameplay persistence (auto-save & auto-load)<ref>https://github.com/xbmc/xbmc/pull/12434</ref>
* Added support for in-game (save RAM) saves<ref>http://github.com/xbmc/xbmc/pull/11380</ref>
* Added support for Keyboard players via Joystick Emulation<ref name="RetroPlayer"/>
* Added support for libretro API and game cores (emulators and games) that support it
* Added [[Game_Add-ons|game clients addons]] for many popular third-party game console emulators and native open source games *
** ''* [[Game_Add-ons|Game clients addons]] for Kodi is changing quickly so checkout the [[Game_Add-ons|game clients addons]] article for a current list''
* ?

=== Live TV and PVR (Personal Video Recorder) ===
* Major GUI actions refactoring to eliminate duplicate and dead code. Add context menu support for Estuary PVR home screen widgets <ref>https://github.com/xbmc/xbmc/pull/10870</ref>
* Guide window: Get rid of obsolete views "channel", "now" and "next" <ref>https://github.com/xbmc/xbmc/pull/10838</ref>
* Core: Refactor and fix "play minimized" settings handling <ref>https://github.com/xbmc/xbmc/pull/11203</ref>
* Guide, channel, video fullscreen, music visualisation window: Direct channel number input. <ref>https://github.com/xbmc/xbmc/pull/11434</ref>
* Settings: Remove setting 'hide connection lost warning' <ref>https://github.com/xbmc/xbmc/pull/11500</ref>
* Search dialog: Refactor and complete implementation of EPG search filter <ref>https://github.com/xbmc/xbmc/pull/11570</ref>
* Timer settings dialog: Prefill recordings folder with timer title <ref>https://github.com/xbmc/xbmc/pull/11679</ref>
* Recordings window: Content view filter <ref>https://github.com/xbmc/xbmc/pull/11704</ref>
* Settings: Remove non-working recording settings defaults <ref>https://github.com/xbmc/xbmc/pull/11746</ref>
* Guide window: 'Smart selection' of epg events. <ref>https://github.com/xbmc/xbmc/pull/11782</ref>
* Channelgroup manager: Add support for radio channel groups <ref>https://github.com/xbmc/xbmc/pull/11877</ref>
* Guide window: Add possibility to switch between horizontal and vertical epg grid view <ref>https://github.com/xbmc/xbmc/pull/11958</ref>
* Search window: improvements and fixes <ref>https://github.com/xbmc/xbmc/pull/12001</ref>
* Estuary home screen: Add Info support to recently played channel widget <ref>https://github.com/xbmc/xbmc/pull/12254</ref>
* Estuary: Add episodename to live tv and recordings osd sub label, cleanup seek bar for live tv <ref>https://github.com/xbmc/xbmc/pull/12306</ref>
* Estuary: PVR info dialog, recordings window: cleanup and extend <ref>https://github.com/xbmc/xbmc/pull/12416</ref>
* Drop 'channel guide' button from epg event info dialog, add 'channel guide' to context menu <ref>https://github.com/xbmc/xbmc/pull/12526</ref>
* Settings: Introduce new setting 'Startup action' and add 'Play TV/Radio <ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Settings: Make 'epg.lingertime' an official setting, remove the respective advanced setting <ref>https://github.com/xbmc/xbmc/pull/12740</ref>
* Setting: Remove obsolete and unused setting 'pvrplayback.scantime' <ref>https://github.com/xbmc/xbmc/pull/12800</ref>
* Core: Fixes/Improvements for multiple enable PVR client addons <ref>https://github.com/xbmc/xbmc/pull/12959</ref>
* Core: Fixes/Improvements for subchannel numbers support (ATSC) <ref>https://github.com/xbmc/xbmc/pull/13069</ref>
* Core: Global direct channel number input & global unique channel numbers <ref>https://github.com/xbmc/xbmc/pull/13135</ref>
* Database: Fix error "Abort due to constraint violation. Query: INSERT INTO channels..." <ref>https://github.com/xbmc/xbmc/pull/13150</ref>
* Estuary: Rework PVR seekbar + Fix PVR info dialog <ref>https://github.com/xbmc/xbmc/pull/13158</ref>
* Core: Make next/previous chapter work for PVR recordings <ref>https://github.com/xbmc/xbmc/pull/13164</ref>
* Direct channel number input: No delay on switch to previous channel with key 0 <ref>https://github.com/xbmc/xbmc/pull/13232</ref>
* Settings: Make shared channel selection optional <ref>https://github.com/xbmc/xbmc/pull/13237</ref>
* Estuary: PVR info panel cleanup <ref>https://github.com/xbmc/xbmc/pull/13255</ref>
* Guide window: 'Go to date' context menu item <ref>https://github.com/xbmc/xbmc/pull/13282</ref>
* Estuary: Season/Episode info in Guide window and dialog <ref>https://github.com/xbmc/xbmc/pull/13300</ref>
* Estuary: Add percent played progress bar to PVR info panel (for recordings) <ref>https://github.com/xbmc/xbmc/pull/13338</ref>
* Guide window: Channel groups selector <ref>https://github.com/xbmc/xbmc/pull/13364</ref>
* Guide window: Tweaks for more consistency and readability <ref>https://github.com/xbmc/xbmc/pull/13402</ref>
* Guide window: Sort content by channel number/channel name/last played, support sort order <ref>https://github.com/xbmc/xbmc/pull/14231</ref>
* PVR-Addon API changes <ref>https://github.com/xbmc/xbmc/pull/12028</ref><ref>https://github.com/xbmc/xbmc/pull/12303</ref><ref>https://github.com/xbmc/xbmc/pull/12552</ref><ref>https://github.com/xbmc/xbmc/pull/12609</ref><ref>https://github.com/xbmc/xbmc/pull/12660</ref><ref>https://github.com/xbmc/xbmc/pull/12689</ref><ref>https://github.com/xbmc/xbmc/pull/12755</ref><ref>https://github.com/xbmc/xbmc/pull/13228</ref>
* Added, updated, and improved PVR backend clients addons for all popular third-party external [[PVR backend]] platforms:
** New: [[Add-on:Zattoo PVR Client|Zattoo PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** New: [[Add-on:Teleboy PVR Client|Teleboy PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** New: [[Add-on:Sledovanitv.cz PVR Client|Sledovanitv.cz PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR Demo Client|PVR Demo Client]] dummy addon with fake (method stub) [[PVR backend]] for [[PVR]] skinning and regression testing
** [[Add-on:IPTV Simple Client|IPTV Simple Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:HDHomeRun PVR|HDHomeRun]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Digital Devices Octopus NET Client|Digital Devices Octopus NET Client]] PVR Addon backend client maintained and made available by [http://digitaldevices.de/home/ Digital Devices]
** [[Add-on:VU+ / Enigma2 Client|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Njoy N7 PVR Client|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VDR VNSI Client|VDR VNSI Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MythTV PVR Client|MythTV PVR Client]] Addon backend client maintained and available from the Kodi's community
** [[Add-on:NextPVR PVR Client|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Argus TV Client|Argus TV (former ForTheRecord)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBLink PVR Client|DVBLink PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBViewer Client|DVBViewer Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MediaPortal PVR Client|MediaPortal PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community
* ?

=== Add-ons Framework, API, and Manager ===
For full changelogs of all Addons APIs, see [[Leia API changes]], [https://forum.kodi.tv/showthread.php?tid=324598 JSON-RPC], and [http://forum.kodi.tv/forumdisplay.php?fid=26 Add-ons] Development Forums
* Major refactoring of Kodi's core handling and GUI management of binary addons<ref>http://github.com/xbmc/xbmc/pulls?q=label%3A%22Binary+Addons%22+is%3Aclosed</ref>
* Added framework to support VFS (Virtual File System) as binary addons<ref>http://github.com/xbmc/xbmc/pull/8966</ref>
* Added framework support for binary addons for video decoder codecs<ref name="Addon video codec implementation">https://github.com/xbmc/xbmc/pull/12340</ref>
* Added framework support for binary addons for image (picture) decoder codecs
* Added extentions to Kodi's Addons API to support binary addons for video decoder codecs<ref name="Addon video codec implementation"/>
* Added extentions to Kodi's Addons API to support binary addons for image decoder codecs
* Added support for Python addons to use PyCryptoDome crypto module for decryption<ref>https://github.com/xbmc/xbmc/pull/11477</ref>
* Added option to pass HTTP cookies with AVOption to Kodi's Video Player<ref>https://github.com/xbmc/xbmc/pull/12257</ref>
* Added support to allow addons to edit all used controls on their processed window<ref>https://github.com/xbmc/xbmc/pull/12259</ref>
* Added support to allow Python addons to set the videoinfotag path<ref>http://github.com/xbmc/xbmc/pull/11012</ref>
* Added support to allow Python addons to get/set the dbid of a (music) listitem<ref>http://github.com/xbmc/xbmc/pull/10858</ref>
* Added support for mediatype to musicinfotag tag retrieving via Python API<ref>http://github.com/xbmc/xbmc/pull/11110</ref>
* Added support "int/float slider" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11230</ref>
* Added support "setContent for mediawindows" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11258</ref>
* Added help for load of shared library and allow the use of their own addon temp folder<ref>https://github.com/xbmc/xbmc/pull/12379</ref>
* Added support to inspect add-on dependencies prior to installation<ref>https://github.com/xbmc/xbmc/pull/12242</ref>
* Added ability to remove add-on settings upon uninstall<ref>https://github.com/xbmc/xbmc/pull/11499</ref>
* Changed to new addon gui interface for list items to use on addon window<ref>https://github.com/xbmc/xbmc/pull/12214</ref>
* Changed service addons to use event handlers instead of synchronous addon hooks<ref>https://github.com/xbmc/xbmc/pull/12370</ref>
* Updated "Peripheral Addons" for game controllers, gamepads, joysticks, and input peripherals profiles (in Kodi-game repo<ref>http://github.com/kodi-game/ kodi-game repo on GitHub</ref>):
** [http://github.com/xbmc/peripheral.joystick Joystick Controller Addon]
** [http://github.com/kodi-game/peripheral.xarcade X-Arcade (XGaming Tankstick) support for Kodi Addon]
** [http://github.com/kodi-game/peripheral.steamcontroller Steam Controller (gamepad) Addon]
** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.default Default Game Controller Addon (reference game controller addon based on Xbox 360 gamepad)]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.ps PlayStation Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.nes Nintendo NES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.snes Nintendo SNES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.n64 Nintendo N64 Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.gba Nintendo GBA Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.genesis Sega Genesis Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.dreamcast Sega Dreamcast Game Controller Addon]
* ?

=== GUI Engine (Skinning Engine) ===
For full changelog on changes to the skinning engine, see [[Leia API changes]] and the [http://forum.kodi.tv/showthread.php?tid=298565 Skin Development Forum]
* Added windows to support Games and Game OSD in the new default skins (Estuary and Estouchy)
* Added player process info dialog to Kodi's default skin (Estuary)<ref>https://github.com/xbmc/xbmc/pull/11718</ref>
* Added support for addons to use banner and ClearLogo<ref>https://github.com/xbmc/xbmc/pull/12244</ref>
* Added support for skins/gui to allow implicit container referencing for non-media windows<ref>http://github.com/xbmc/xbmc/pull/10883</ref>
* Added support for addons to add "Enable/Disable" to context menu<ref>http://github.com/xbmc/xbmc/pull/11124</ref>
* Added support for remember last used keyboard layout in GUI<ref>http://github.com/xbmc/xbmc/pull/11242</ref>
* Added support for ISO 639-2/T language code retrieval (required by libbluray)<ref>https://github.com/xbmc/xbmc/pull/12258</ref>
* Added window that display Kodi privacy policy in GUI settings under system info<ref>https://github.com/xbmc/xbmc/pull/10785</ref>
* Added support to map a key to browse for subtitle in video fullscreen window<ref>https://github.com/xbmc/xbmc/pull/11649</ref>
* Improved Kodi's GUI engine with optimizations for message handling and SmartRedraw<ref>https://github.com/xbmc/xbmc/pull/12213</ref>
* Improved Kodi's GUI engine support for scaling container layouts<ref>http://github.com/xbmc/xbmc/pull/11229</ref>
* Improved Kodi's GUI engine by allowing %-values for origin, camera and animation attribs<ref>http://github.com/xbmc/xbmc/pull/11233</ref>
* Changed so that context menu reloading loads async to aviod GUI lockup on wait<ref>https://github.com/xbmc/xbmc/pull/11841</ref>
* Updated guilib ABI (for libgui) to version 5.13.0<ref>http://github.com/xbmc/xbmc/pull/11306</ref>
* Updated keyboard layout for some languages and added support Croatian, Slovenian, and Thai (Kedmanee)
* Updated image resource addons (as example weather icons, weather fanart, studio logos, and genre icons)
* ?

=== Platform Independent Playback ===
* Added support for "InputStream" (input stream) addons to pass CryptoSession flags field<ref>https://github.com/xbmc/xbmc/pull/12428</ref>
* Added support for BD-J / Blu-ray Disc Java menu support (requires system Java runtime enviroment)<ref>https://github.com/xbmc/xbmc/pull/12339</ref><ref>https://github.com/xbmc/xbmc/pull/12310</ref>
* Added support for Blu-ray Disc detection and use provided meta data for Blu-ray Disc names<ref>https://github.com/xbmc/xbmc/pull/12488</ref>
* Added support for video buffers to be used by decoders and renderers<ref name="VideoPlayer updates for Leia">https://github.com/xbmc/xbmc/pull/12212</ref>
** Added support for platforms to register custom buffers, like example dma<ref name="VideoPlayer updates for Leia"/>
* Added a VC1-Packet bitstream parser implementation for improved VC-1 playback<ref>http://github.com/xbmc/xbmc/pull/11417</ref>
* Added and updated many (binary) audio decoder and encoder addons for Kodi
* Added a few (binary) video decoder addons for Kodi<ref name="Addon video codec implementation"/>
* Added a "RAW" (libraw based) image decoder addon to Kodi<ref>https://github.com/xbmc/xbmc/pull/11671</ref>
* Improved MMAL playback of H.264 MVC (Blu-ray 3D) stereoscopic video with framepacking decoding on Raspberry Pi
* Improved Stereoscopic 3D playback of 3D videos (as well as better 2D playback of 3D videos)
* Improved and enhanced Blu-ray support (including updated libbluray dependecies from the VideoLAN project<ref>https://github.com/xbmc/xbmc/pull/12305</ref><ref>http://git.videolan.org/?p=libbluray.git;a=blob;f=ChangeLog</ref>
* Improved support for "InputStream" (input stream) addons as system addons
* Updated "InputStream" (input stream) client addons for common network streaming protocols and popular services:
** [http://github.com/xbmc/xbmc/tree/master/addons/kodi.inputstream InputStream Addon (default reference InputStream Addon by Team Kodi]
** [http://github.com/mapfau/inputstream.test Test InputStream Addon (Test InputStream Addon for Kodi's new inputstream interface]
** [http://github.com/peak3d/inputstream.adaptive Adaptive InputStream Addon (InputStream Client addon for several manifest types)]
** [http://github.com/xbmc/repo-binary-addons/tree/master/inputstream.rtmp RTMP InputStream Addon (InputStream Client for RTMP streams using librtmp)]
** [http://github.com/peak3d/inputstream.mpd MPD (MPEG-DASH) InputStream Addon]
** [http://github.com/peak3d/inputstream.smoothstream SmoothStream InputStream Addon for MS-SSTR (SmoothStreamingMedia) Smooth Streaming Protocol]
** [http://github.com/mapfau/inputstream.nxmsl NXMSL InputStream Addon for Netflix style manifests over MSL]
* Updated FFmpeg multimedia codec and demux libraries to stable branch release version [http://www.ffmpeg.org/download.html#release_3.3.2 FFmpeg 3.3 (3.3.2)]<ref>http://git.videolan.org/?p=ffmpeg.git;a=blob_plain;f=Changelog;hb=release/3.3.2 FFmpeg 3.3.2 release changelog</ref><ref>https://github.com/xbmc/xbmc/pull/12358</ref>
* Removed certain audio codecs from core and made them into audio decoder and audio encoder add-ons
* Removed certain video codecs from core and made them into video decoder add-ons<ref name="Addon video codec implementation"/>
* Removed certain image codecs from core and made them into image decoder add-ons
* ?

=== General Library ===
* Addded support to use the Favourites function in context menus<ref>https://github.com/xbmc/xbmc/pull/11967</ref>
* Added support for context menus to favourites home screen widget<ref>https://github.com/xbmc/xbmc/pull/11929</ref>
* Added support to "Sort By Date Added" in Music Video title node<ref>https://github.com/xbmc/xbmc/pull/12495</ref>

=== Music Library ===
* Fix- The use of BAND and ENSEMBLE (Vorbis and APE) tags. <ref>https://github.com/xbmc/xbmc/pull/11735</ref>
* Fix- Music library cleaning so not lock UI and cancel button works. <ref>https://github.com/xbmc/xbmc/pull/13117</ref>
* Fix- Issue of replay gain not being applied if peak value was missing, and also removed the avoid clipping setting. <ref>https://github.com/xbmc/xbmc/pull/11868</ref><ref>https://github.com/xbmc/xbmc/pull/11865</ref>
* Fix- Clean On Update which prevented scraping in some circumstances <ref>https://github.com/xbmc/xbmc/pull/11609</ref>
* Fix- Missing ''* Item Folder'' entry when browsing for artist fanart from Artist Info Dialog <ref>https://github.com/xbmc/xbmc/pull/12625</ref>
* Fix- Handling of duplicate MusicBrainzTrackID within the same album. Previous assumption was that the MusicBrainzTrackID is unique within the same album <ref>https://github.com/xbmc/xbmc/pull/12079</ref>
* Fix- Sort names for artists that are only album artists <ref>https://github.com/xbmc/xbmc/pull/13030</ref>
* Fix- Wrong playback order for smartplaylists, playlists and upnp <ref>https://github.com/xbmc/xbmc/pull/13059</ref>
* Fix- Cancelling of music library export which continued in the background even after cancel button clicked on progress dialog <ref>https://github.com/xbmc/xbmc/pull/13105</ref>
* Fix- Endless rescraping of unfound album <ref>https://github.com/xbmc/xbmc/pull/13752</ref>
* Fix- Art type "thumb" was sometimes being added to a song with an empty URL, preventing artist fanart from being shown on playback of library items from file view. <ref>https://github.com/xbmc/xbmc/pull/13854</ref>
* Improve- Handling of Cue Sheets <ref>https://github.com/xbmc/xbmc/pull/12082</ref>
* Improve- Online scraping of additional artist and album information making better use of Musicbrainz IDs. <ref>https://github.com/xbmc/xbmc/pull/12120</ref><ref>https://github.com/xbmc/xbmc/pull/12597</ref>
* Improve- On clean installs, change default song sort order to Track Number <ref>https://github.com/xbmc/xbmc/pull/12834</ref>
* Improve- FileItem::IsSamePath for albums and artists to prevent false matches <ref>https://github.com/xbmc/xbmc/pull/13585</ref>
* Improve- Album genre inconsistencies <ref>https://github.com/xbmc/xbmc/pull/13042</ref>
* Improve- Avoid unnecessary db access by GUI when app processing GUI_MSG_UPDATE_ITEM messages <ref>https://github.com/xbmc/xbmc/pull/13640</ref>
* Improve- Refactor Artist/Album Information Dialog <ref>https://github.com/xbmc/xbmc/pull/13672</ref>
* Improve- Refactor Song Information Dialog <ref>https://github.com/xbmc/xbmc/pull/13533</ref>
* Improve- Fetching local art for multi-folder albums (disc sets) <ref>https://github.com/xbmc/xbmc/pull/13769</ref>
* Add- Option to rescan the music file tags for existing items in the library <ref>https://github.com/xbmc/xbmc/pull/11557</ref>
* Add- Add processing of WRITER tag for ID3 v2, Vorbis and APE formats <ref>https://github.com/xbmc/xbmc/pull/11735</ref>
* Add- Processing of ARTISTSORT (TSOP), ALBUMARTISTSORT (TS02) and COMPOSERSORT (TSOC) tags to provide a sort name for artists. <ref>https://github.com/xbmc/xbmc/pull/11738</ref>
* Add- New dialog for selection of both artist and album scraper addons, and their settings.<ref>https://github.com/xbmc/xbmc/pull/12987</ref><ref>https://github.com/xbmc/xbmc/pull/12943</ref>
* Add- Additional artist data that Musicbrainz provides: type (person, group, orchestra, choir etc.), gender, and disambiguation comments that help to differentiate artists with the same name <ref>https://github.com/xbmc/xbmc/pull/12963</ref>
* Add- Artist Information Folder - a single location for artist artwork and nfo. This solves numerous issues related to artwork, artist data import and general folder and file structure <ref>https://github.com/xbmc/xbmc/pull/12891</ref>
* Add- Extended Artwork support, making the local art that is picked up automatically on scan configurable. <ref>https://github.com/xbmc/xbmc/pull/13352</ref><ref>https://github.com/xbmc/xbmc/pull/13848</ref><ref>https://github.com/xbmc/xbmc/pull/13491</ref><ref>https://github.com/xbmc/xbmc/pull/13101</ref><ref>https://github.com/xbmc/xbmc/pull/13871</ref>
* Add- Add option to prefer scraped album covers to embedded images <ref>https://github.com/xbmc/xbmc/pull/13812</ref>
* Add- Filter music items by media source <ref>https://github.com/xbmc/xbmc/pull/14012</ref><ref>https://github.com/xbmc/xbmc/pull/14082</ref>

=== Web Scrapers ===
* Added support for Python (script) based web scrapers for Kodi<ref>http://github.com/xbmc/xbmc/pull/9984</ref>
* Refactored and updated many XML based scrapers in Kodi for music, movies, tv shows, and music videos
* Updated music, movies, tv shows, and music video scrapers for Kodi
* ?

=== AudioEngine ===
* Added a new Sndio sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, other BSD Unix based systems, and Linux<ref>https://github.com/xbmc/xbmc/pull/11962</ref>
* Improved the default cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] (Kodi's [[AudioEngine]])
* Improved ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems
* Improved PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop
* Improved OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD and similar BSD Unix based systems
* Improved AUDIOTRACK sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Amlogic]]
* Improved Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]
* Improved DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved CoreAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* Improved Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* Renamed AE_SINK to KODI_AE_SINK
* ?

=== Other ===
* Added a new unified setting for "Startup action" and added "Play TV/Radio"<ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Added support to build Kodi with support for Bluetooth<ref>http://github.com/xbmc/xbmc/pull/11137</ref>
* Added possibility for CMake build system to add additional libraries on install<ref>https://github.com/xbmc/xbmc/pull/12423</ref>
* Updated and improved mappings for new and existing remote controls
* Improved Kodi's JSON-RPC API
* Improved compiling/building and code documentation (following doxygen coding guidelines)
* Changed to use spdlog for Kodi logging as well as improved and further optimized logging (including debug logs)<ref>https://github.com/xbmc/xbmc/pull/11833</ref>
* Changed XML format of setting values for Kodi's settings configuration<ref>https://github.com/xbmc/xbmc/pull/12277</ref>
* Updated default web interface (webinterface is called "Chorus2" and is currently at version 2.4.4)<ref>https://github.com/xbmc/xbmc/pull/11872</ref>
* Updated critical dependency libraries such as openssl, gnutls, and CMake (used to compile Kodi and its binary addons)
* Removed last dependencies of SDL (Simple DirectMedia Layer) which was hardware abstraction for input devices<ref>https://github.com/xbmc/xbmc/pull/12272</ref><ref>https://github.com/xbmc/xbmc/pull/11881</ref>
* Removed all glew (libglew library) dependencies in Kodi's code<ref>http://github.com/xbmc/xbmc/pull/11128</ref>
* ?

=== Android Specific ===
* Added support for speech-to-text in Kodi OSD keyboard on Android TV (triggered by voice button on remote)
* Added support for Android to move the Kodi app to SD card<ref>https://github.com/xbmc/xbmc/pull/12168</ref>
* Added support for Android TV Leanback search and recommendations meta data from Kodi<ref>|https://github.com/xbmc/xbmc/pull/11901</ref>
** Default setting for Android TV Leanback suggestion to random unwatched movies and music albums<ref>https://github.com/xbmc/xbmc/pull/11963</ref>
* Moved to Android NDK 16
* Changed Rendertype from GUILayer to VideoLayer for Android MediaCodecSurface<ref>https://github.com/xbmc/xbmc/pull/12097</ref>
* Changed to use NDK native C interface for Android MediaCodec (for performance gains)<ref>https://github.com/xbmc/xbmc/pull/11931</ref>
* Changed to support ZeroConf via native Android API (and deprecates mDNSresponder)<ref>http://github.com/xbmc/xbmc/pull/11393</ref>
* Changed to support network information via native Android API (and deprecates POSIX)<ref>https://github.com/xbmc/xbmc/pull/12243</ref>
* Changed handling of Kodi's Java interfaces via JNI for better consistency<ref>https://github.com/xbmc/xbmc/pull/12292</ref>
* ?

=== BSD Specific ===
* Improved Kodi support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* ?

=== Linux Specific ===
* Added support for a generic DRM/KMS implementation using GBM to create required surfaces<ref>https://github.com/xbmc/xbmc/pull/11955</ref>
* Added support for Mir windowing system (Mir 1.0) for Kodi<ref>http://github.com/xbmc/xbmc/pull/10898</ref> and added support for VAAPI on Mir using DRM<ref>http://github.com/xbmc/xbmc/pull/11040</ref>
* Added support for the middle mouse button on embedded platforms<ref>https://github.com/xbmc/xbmc/pull/11956</ref>
* Added support more yuv420p bitwidths for direct rendering on Linux<ref>https://github.com/xbmc/xbmc/pull/12479</ref>
* Added support for using VAAPI hardware video decoding with OpenGL ES<ref>https://github.com/xbmc/xbmc/pull/12113</ref>
* Added support for build Kodi with imx support using CMake<ref>http://github.com/xbmc/xbmc/pull/11288</ref>
* Moved the CMake build system to the top of the code tree (moved to root)<ref>http://github.com/xbmc/xbmc/pull/10446</ref>
* Improved support for UltraHD decoding / 4K resolution output when hardware supports it
* Improved ARM processor architecture (using [[Raspberry Pi]] as reference device)
* Improved OpenGL ES and EGL support (using [[Raspberry Pi]] as reference device)
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* Improved XvBA (AMD/ATI) Hardware Video Acceleration (requires XvBA compatible hardware and drivers)
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on Amlogic devices
* Removed the unused and unmaintained OpenMAX video decoder from Kodi's VideoPlayer<ref>https://github.com/xbmc/xbmc/pull/12197</ref>
* Removed support for autotools based build system for Kodi and binary addons (in favour of CMake)<ref>http://github.com/xbmc/xbmc/pull/10429</ref>
* ?

=== iOS Specific ===
* Added support for iOS 10.0 by adding support for compiling Kodi with Xcode 8 IDE and iOS SDK 10.0<ref>https://github.com/xbmc/xbmc/pull/10539</ref>
* Improved Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)
* Improved support for TVOS (Apple's iOS fork for Apple TV 4) in Kodi mainline
* Improved support for iOS on ARM64 (64-bit iOS)
* ?

=== OS X Specific ===
* Added support for compiling Kodi with Xcode 8 IDE for OSX 10.11 (El Capitan) and macOS 10.12 (Sierra)
* Improved Apple VDADecoder Video Acceleration support for (Mac) OS X
* ?

=== Windows Specific ===
* Added support to build Kodi for Windows 64 / Windows for Intel 64-bit (x86-64)<ref>https://github.com/xbmc/xbmc/pull/12065</ref>
* Added support for 3D LUT (3D Lookup Table) and dithering to Windows video renderer<ref name="WinRenderer re-work">https://github.com/xbmc/xbmc/pull/12475</ref>
* Improved support to compiling Kodi for Microsoft's UWP (Universal Windows Platform) APIs
* Changed the inner working of render buffers and rendering methods<ref name="WinRenderer re-work"/>
* Changed to using unicode win32 api methods<ref>https://github.com/xbmc/xbmc/pull/11780</ref>
* Changed windowing systems for screen saver handling on Windows OS platforms
* Changed to make Kodi for Windows platform independent of posix/main.cpp<ref>https://github.com/xbmc/xbmc/pull/12215</ref>
* Removed support for Windows Vista as the operating-system is no longer supported by Microsoft<ref>https://github.com/xbmc/xbmc/pull/11953</ref>
* ?

== References ==
<references/>

== See also ==
* [[Leia API changes]]
{{Changelogs}}

[[Category:Manual]]
[[Category:Leia|*]]
[[Category:Changelogs|18]]

Kodi v18 (Leia) changelog

2018-07-18T14:31:49Z

Ksooo:

{{mininav|[[Releases]] {{l2| [[Leia]] }} }}

{{notice|Kodi v17 (Krypton) final has just been released, so please keep in mind that a final non-alpha/beta v18 (Leia) release is still far far away into the future. As such, these new features/functions and API changes is a placeholder containing changes to the current Kodi mainline (the git master tree repository on GitHub). It is a very much a work in progress, this is only listing changes commited to the master branch after Jarvis branching, and many many many features/functions and API additions, alterations or removal are still subject to future change.}}
{{incomplete}}
{{future|18}}

{{see also|Kodi v18 (Leia) FAQ|Leia API changes|Releases}}

This is a placeholder and Kodi Wiki copy of the condensed changelog for the future Kodi v18.x version (codename: "Leia") releases with a summery of the most important core features and functions as well as other notable changes to key areas of the application software or its user interface.

== Changelog ==

=== Gaming (Games interface and Game Clients)===
* Added a RetroPlayer player core supporting game clients as well as emulator cores via libretro API<ref name="RetroPlayer">RetroPlayer http://forum.kodi.tv/showthread.php?tid=164725</ref><ref>http://github.com/xbmc/xbmc/pull/11022</ref>
* Added extentions to Kodi's Addons AP to support Game Client Addons, supporting Kodi's VFS (Virtual File System), etc.<ref name="RetroPlayer"/>
* Added support for Game Client Addons as new type of addons with just-in-time emulator installation<ref name="RetroPlayer"/>
* Added a Games window and Game OSD (On-Screen-Display) entries to the GUI<ref name="RetroPlayer"/><ref>https://github.com/xbmc/xbmc/pull/12367</ref>
* Added a gaming and game configuration interface for Game settings to the GUI<ref name="RetroPlayer"/>
* Added support for Game Info Tags (game info tag) and exposed properties to Python list items<ref name="RetroPlayer"/>
* Added a savestate (savestate) manager to Kodi for games<ref>http://github.com/xbmc/xbmc/pull/11034</ref>
* Added initial support for basic gameplay persistence (auto-save & auto-load)<ref>https://github.com/xbmc/xbmc/pull/12434</ref>
* Added support for in-game (save RAM) saves<ref>http://github.com/xbmc/xbmc/pull/11380</ref>
* Added support for Keyboard players via Joystick Emulation<ref name="RetroPlayer"/>
* Added support for libretro API and game cores (emulators and games) that support it
* Added [[Game_Add-ons|game clients addons]] for many popular third-party game console emulators and native open source games *
** ''* [[Game_Add-ons|Game clients addons]] for Kodi is changing quickly so checkout the [[Game_Add-ons|game clients addons]] article for a current list''
* ?

=== Live TV and PVR (Personal Video Recorder) ===
* Major GUI actions refactoring to eliminate duplicate and dead code. Add context menu support for Estuary PVR home screen widgets <ref>https://github.com/xbmc/xbmc/pull/10870</ref>
* Guide window: Get rid of obsolete views "channel", "now" and "next" <ref>https://github.com/xbmc/xbmc/pull/10838</ref>
* Core: Refactor and fix "play minimized" settings handling <ref>https://github.com/xbmc/xbmc/pull/11203</ref>
* Guide, channel, video fullscreen, music visualisation window: Direct channel number input. <ref>https://github.com/xbmc/xbmc/pull/11434</ref>
* Settings: Remove setting 'hide connection lost warning' <ref>https://github.com/xbmc/xbmc/pull/11500</ref>
* Search dialog: Refactor and complete implementation of EPG search filter <ref>https://github.com/xbmc/xbmc/pull/11570</ref>
* Timer settings dialog: Prefill recordings folder with timer title <ref>https://github.com/xbmc/xbmc/pull/11679</ref>
* Recordings window: Content view filter <ref>https://github.com/xbmc/xbmc/pull/11704</ref>
* Settings: Remove non-working recording settings defaults <ref>https://github.com/xbmc/xbmc/pull/11746</ref>
* Guide window: 'Smart selection' of epg events. <ref>https://github.com/xbmc/xbmc/pull/11782</ref>
* Channelgroup manager: Add support for radio channel groups <ref>https://github.com/xbmc/xbmc/pull/11877</ref>
* Guide window: Add possibility to switch between horizontal and vertical epg grid view <ref>https://github.com/xbmc/xbmc/pull/11958</ref>
* Search window: improvements and fixes <ref>https://github.com/xbmc/xbmc/pull/12001</ref>
* Estuary home screen: Add Info support to recently played channel widget <ref>https://github.com/xbmc/xbmc/pull/12254</ref>
* Estuary: Add episodename to live tv and recordings osd sub label, cleanup seek bar for live tv <ref>https://github.com/xbmc/xbmc/pull/12306</ref>
* Estuary: PVR info dialog, recordings window: cleanup and extend <ref>https://github.com/xbmc/xbmc/pull/12416</ref>
* Drop 'channel guide' button from epg event info dialog, add 'channel guide' to context menu <ref>https://github.com/xbmc/xbmc/pull/12526</ref>
* Settings: Introduce new setting 'Startup action' and add 'Play TV/Radio <ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Settings: Make 'epg.lingertime' an official setting, remove the respective advanced setting <ref>https://github.com/xbmc/xbmc/pull/12740</ref>
* Setting: Remove obsolete and unused setting 'pvrplayback.scantime' <ref>https://github.com/xbmc/xbmc/pull/12800</ref>
* Core: Fixes/Improvements for multiple enable PVR client addons <ref>https://github.com/xbmc/xbmc/pull/12959</ref>
* Core: Fixes/Improvements for subchannel numbers support (ATSC) <ref>https://github.com/xbmc/xbmc/pull/13069</ref>
* Core: Global direct channel number input & global unique channel numbers <ref>https://github.com/xbmc/xbmc/pull/13135</ref>
* Database: Fix error "Abort due to constraint violation. Query: INSERT INTO channels..." <ref>https://github.com/xbmc/xbmc/pull/13150</ref>
* Estuary: Rework PVR seekbar + Fix PVR info dialog <ref>https://github.com/xbmc/xbmc/pull/13158</ref>
* Core: Make next/previous chapter work for PVR recordings <ref>https://github.com/xbmc/xbmc/pull/13164</ref>
* Direct channel number input: No delay on switch to previous channel with key 0 <ref>https://github.com/xbmc/xbmc/pull/13232</ref>
* Settings: Make shared channel selection optional <ref>https://github.com/xbmc/xbmc/pull/13237</ref>
* Estuary: PVR info panel cleanup <ref>https://github.com/xbmc/xbmc/pull/13255</ref>
* Guide window: 'Go to date' context menu item <ref>https://github.com/xbmc/xbmc/pull/13282</ref>
* Estuary: Season/Episode info in Guide window and dialog <ref>https://github.com/xbmc/xbmc/pull/13300</ref>
* Estuary: Add percent played progress bar to PVR info panel (for recordings) <ref>https://github.com/xbmc/xbmc/pull/13338</ref>
* Guide window: Channel groups selector <ref>https://github.com/xbmc/xbmc/pull/13364</ref>
* Guide window: Tweaks for more consistency and readability <ref>https://github.com/xbmc/xbmc/pull/13402</ref>
* PVR-Addon API changes <ref>https://github.com/xbmc/xbmc/pull/12028</ref><ref>https://github.com/xbmc/xbmc/pull/12303</ref><ref>https://github.com/xbmc/xbmc/pull/12552</ref><ref>https://github.com/xbmc/xbmc/pull/12609</ref><ref>https://github.com/xbmc/xbmc/pull/12660</ref><ref>https://github.com/xbmc/xbmc/pull/12689</ref><ref>https://github.com/xbmc/xbmc/pull/12755</ref><ref>https://github.com/xbmc/xbmc/pull/13228</ref>
* Added, updated, and improved PVR backend clients addons for all popular third-party external [[PVR backend]] platforms:
** New: [[Add-on:Zattoo PVR Client|Zattoo PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** New: [[Add-on:Teleboy PVR Client|Teleboy PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** New: [[Add-on:Sledovanitv.cz PVR Client|Sledovanitv.cz PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR Demo Client|PVR Demo Client]] dummy addon with fake (method stub) [[PVR backend]] for [[PVR]] skinning and regression testing
** [[Add-on:IPTV Simple Client|IPTV Simple Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:HDHomeRun PVR|HDHomeRun]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Digital Devices Octopus NET Client|Digital Devices Octopus NET Client]] PVR Addon backend client maintained and made available by [http://digitaldevices.de/home/ Digital Devices]
** [[Add-on:VU+ / Enigma2 Client|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Njoy N7 PVR Client|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VDR VNSI Client|VDR VNSI Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MythTV PVR Client|MythTV PVR Client]] Addon backend client maintained and available from the Kodi's community
** [[Add-on:NextPVR PVR Client|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Argus TV Client|Argus TV (former ForTheRecord)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBLink PVR Client|DVBLink PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBViewer Client|DVBViewer Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MediaPortal PVR Client|MediaPortal PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community
* ?

=== Add-ons Framework, API, and Manager ===
For full changelogs of all Addons APIs, see [[Leia API changes]], [https://forum.kodi.tv/showthread.php?tid=324598 JSON-RPC], and [http://forum.kodi.tv/forumdisplay.php?fid=26 Add-ons] Development Forums
* Major refactoring of Kodi's core handling and GUI management of binary addons<ref>http://github.com/xbmc/xbmc/pulls?q=label%3A%22Binary+Addons%22+is%3Aclosed</ref>
* Added framework to support VFS (Virtual File System) as binary addons<ref>http://github.com/xbmc/xbmc/pull/8966</ref>
* Added framework support for binary addons for video decoder codecs<ref name="Addon video codec implementation">https://github.com/xbmc/xbmc/pull/12340</ref>
* Added framework support for binary addons for image (picture) decoder codecs
* Added extentions to Kodi's Addons API to support binary addons for video decoder codecs<ref name="Addon video codec implementation"/>
* Added extentions to Kodi's Addons API to support binary addons for image decoder codecs
* Added support for Python addons to use PyCryptoDome crypto module for decryption<ref>https://github.com/xbmc/xbmc/pull/11477</ref>
* Added option to pass HTTP cookies with AVOption to Kodi's Video Player<ref>https://github.com/xbmc/xbmc/pull/12257</ref>
* Added support to allow addons to edit all used controls on their processed window<ref>https://github.com/xbmc/xbmc/pull/12259</ref>
* Added support to allow Python addons to set the videoinfotag path<ref>http://github.com/xbmc/xbmc/pull/11012</ref>
* Added support to allow Python addons to get/set the dbid of a (music) listitem<ref>http://github.com/xbmc/xbmc/pull/10858</ref>
* Added support for mediatype to musicinfotag tag retrieving via Python API<ref>http://github.com/xbmc/xbmc/pull/11110</ref>
* Added support "int/float slider" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11230</ref>
* Added support "setContent for mediawindows" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11258</ref>
* Added help for load of shared library and allow the use of their own addon temp folder<ref>https://github.com/xbmc/xbmc/pull/12379</ref>
* Added support to inspect add-on dependencies prior to installation<ref>https://github.com/xbmc/xbmc/pull/12242</ref>
* Added ability to remove add-on settings upon uninstall<ref>https://github.com/xbmc/xbmc/pull/11499</ref>
* Changed to new addon gui interface for list items to use on addon window<ref>https://github.com/xbmc/xbmc/pull/12214</ref>
* Changed service addons to use event handlers instead of synchronous addon hooks<ref>https://github.com/xbmc/xbmc/pull/12370</ref>
* Updated "Peripheral Addons" for game controllers, gamepads, joysticks, and input peripherals profiles (in Kodi-game repo<ref>http://github.com/kodi-game/ kodi-game repo on GitHub</ref>):
** [http://github.com/xbmc/peripheral.joystick Joystick Controller Addon]
** [http://github.com/kodi-game/peripheral.xarcade X-Arcade (XGaming Tankstick) support for Kodi Addon]
** [http://github.com/kodi-game/peripheral.steamcontroller Steam Controller (gamepad) Addon]
** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.default Default Game Controller Addon (reference game controller addon based on Xbox 360 gamepad)]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.ps PlayStation Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.nes Nintendo NES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.snes Nintendo SNES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.n64 Nintendo N64 Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.gba Nintendo GBA Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.genesis Sega Genesis Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.dreamcast Sega Dreamcast Game Controller Addon]
* ?

=== GUI Engine (Skinning Engine) ===
For full changelog on changes to the skinning engine, see [[Leia API changes]] and the [http://forum.kodi.tv/showthread.php?tid=298565 Skin Development Forum]
* Added windows to support Games and Game OSD in the new default skins (Estuary and Estouchy)
* Added player process info dialog to Kodi's default skin (Estuary)<ref>https://github.com/xbmc/xbmc/pull/11718</ref>
* Added support for addons to use banner and ClearLogo<ref>https://github.com/xbmc/xbmc/pull/12244</ref>
* Added support for skins/gui to allow implicit container referencing for non-media windows<ref>http://github.com/xbmc/xbmc/pull/10883</ref>
* Added support for addons to add "Enable/Disable" to context menu<ref>http://github.com/xbmc/xbmc/pull/11124</ref>
* Added support for remember last used keyboard layout in GUI<ref>http://github.com/xbmc/xbmc/pull/11242</ref>
* Added support for ISO 639-2/T language code retrieval (required by libbluray)<ref>https://github.com/xbmc/xbmc/pull/12258</ref>
* Added window that display Kodi privacy policy in GUI settings under system info<ref>https://github.com/xbmc/xbmc/pull/10785</ref>
* Added support to map a key to browse for subtitle in video fullscreen window<ref>https://github.com/xbmc/xbmc/pull/11649</ref>
* Improved Kodi's GUI engine with optimizations for message handling and SmartRedraw<ref>https://github.com/xbmc/xbmc/pull/12213</ref>
* Improved Kodi's GUI engine support for scaling container layouts<ref>http://github.com/xbmc/xbmc/pull/11229</ref>
* Improved Kodi's GUI engine by allowing %-values for origin, camera and animation attribs<ref>http://github.com/xbmc/xbmc/pull/11233</ref>
* Changed so that context menu reloading loads async to aviod GUI lockup on wait<ref>https://github.com/xbmc/xbmc/pull/11841</ref>
* Updated guilib ABI (for libgui) to version 5.13.0<ref>http://github.com/xbmc/xbmc/pull/11306</ref>
* Updated keyboard layout for some languages and added support Croatian, Slovenian, and Thai (Kedmanee)
* Updated image resource addons (as example weather icons, weather fanart, studio logos, and genre icons)
* ?

=== Platform Independent Playback ===
* Added support for "InputStream" (input stream) addons to pass CryptoSession flags field<ref>https://github.com/xbmc/xbmc/pull/12428</ref>
* Added support for BD-J / Blu-ray Disc Java menu support (requires system Java runtime enviroment)<ref>https://github.com/xbmc/xbmc/pull/12339</ref><ref>https://github.com/xbmc/xbmc/pull/12310</ref>
* Added support for Blu-ray Disc detection and use provided meta data for Blu-ray Disc names<ref>https://github.com/xbmc/xbmc/pull/12488</ref>
* Added support for video buffers to be used by decoders and renderers<ref name="VideoPlayer updates for Leia">https://github.com/xbmc/xbmc/pull/12212</ref>
** Added support for platforms to register custom buffers, like example dma<ref name="VideoPlayer updates for Leia"/>
* Added a VC1-Packet bitstream parser implementation for improved VC-1 playback<ref>http://github.com/xbmc/xbmc/pull/11417</ref>
* Added and updated many (binary) audio decoder and encoder addons for Kodi
* Added a few (binary) video decoder addons for Kodi<ref name="Addon video codec implementation"/>
* Added a "RAW" (libraw based) image decoder addon to Kodi<ref>https://github.com/xbmc/xbmc/pull/11671</ref>
* Improved MMAL playback of H.264 MVC (Blu-ray 3D) stereoscopic video with framepacking decoding on Raspberry Pi
* Improved Stereoscopic 3D playback of 3D videos (as well as better 2D playback of 3D videos)
* Improved and enhanced Blu-ray support (including updated libbluray dependecies from the VideoLAN project<ref>https://github.com/xbmc/xbmc/pull/12305</ref><ref>http://git.videolan.org/?p=libbluray.git;a=blob;f=ChangeLog</ref>
* Improved support for "InputStream" (input stream) addons as system addons
* Updated "InputStream" (input stream) client addons for common network streaming protocols and popular services:
** [http://github.com/xbmc/xbmc/tree/master/addons/kodi.inputstream InputStream Addon (default reference InputStream Addon by Team Kodi]
** [http://github.com/mapfau/inputstream.test Test InputStream Addon (Test InputStream Addon for Kodi's new inputstream interface]
** [http://github.com/peak3d/inputstream.adaptive Adaptive InputStream Addon (InputStream Client addon for several manifest types)]
** [http://github.com/xbmc/repo-binary-addons/tree/master/inputstream.rtmp RTMP InputStream Addon (InputStream Client for RTMP streams using librtmp)]
** [http://github.com/peak3d/inputstream.mpd MPD (MPEG-DASH) InputStream Addon]
** [http://github.com/peak3d/inputstream.smoothstream SmoothStream InputStream Addon for MS-SSTR (SmoothStreamingMedia) Smooth Streaming Protocol]
** [http://github.com/mapfau/inputstream.nxmsl NXMSL InputStream Addon for Netflix style manifests over MSL]
* Updated FFmpeg multimedia codec and demux libraries to stable branch release version [http://www.ffmpeg.org/download.html#release_3.3.2 FFmpeg 3.3 (3.3.2)]<ref>http://git.videolan.org/?p=ffmpeg.git;a=blob_plain;f=Changelog;hb=release/3.3.2 FFmpeg 3.3.2 release changelog</ref><ref>https://github.com/xbmc/xbmc/pull/12358</ref>
* Removed certain audio codecs from core and made them into audio decoder and audio encoder add-ons
* Removed certain video codecs from core and made them into video decoder add-ons<ref name="Addon video codec implementation"/>
* Removed certain image codecs from core and made them into image decoder add-ons
* ?

=== General Library ===
* Addded support to use the Favourites function in context menus<ref>https://github.com/xbmc/xbmc/pull/11967</ref>
* Added support for context menus to favourites home screen widget<ref>https://github.com/xbmc/xbmc/pull/11929</ref>
* Added support to "Sort By Date Added" in Music Video title node<ref>https://github.com/xbmc/xbmc/pull/12495</ref>

=== Music Library ===
* Fix- The use of BAND and ENSEMBLE (Vorbis and APE) tags. <ref>https://github.com/xbmc/xbmc/pull/11735</ref>
* Fix- Music library cleaning so not lock UI and cancel button works. <ref>https://github.com/xbmc/xbmc/pull/13117</ref>
* Fix- Issue of replay gain not being applied if peak value was missing, and also removed the avoid clipping setting. <ref>https://github.com/xbmc/xbmc/pull/11868</ref><ref>https://github.com/xbmc/xbmc/pull/11865</ref>
* Fix- Clean On Update which prevented scraping in some circumstances <ref>https://github.com/xbmc/xbmc/pull/11609</ref>
* Fix- Missing ''* Item Folder'' entry when browsing for artist fanart from Artist Info Dialog <ref>https://github.com/xbmc/xbmc/pull/12625</ref>
* Fix- Handling of duplicate MusicBrainzTrackID within the same album. Previous assumption was that the MusicBrainzTrackID is unique within the same album <ref>https://github.com/xbmc/xbmc/pull/12079</ref>
* Fix- Sort names for artists that are only album artists <ref>https://github.com/xbmc/xbmc/pull/13030</ref>
* Fix- Wrong playback order for smartplaylists, playlists and upnp <ref>https://github.com/xbmc/xbmc/pull/13059</ref>
* Fix- Cancelling of music library export which continued in the background even after cancel button clicked on progress dialog <ref>https://github.com/xbmc/xbmc/pull/13105</ref>
* Fix- Endless rescraping of unfound album <ref>https://github.com/xbmc/xbmc/pull/13752</ref>
* Fix- Art type "thumb" was sometimes being added to a song with an empty URL, preventing artist fanart from being shown on playback of library items from file view. <ref>https://github.com/xbmc/xbmc/pull/13854</ref>
* Improve- Handling of Cue Sheets <ref>https://github.com/xbmc/xbmc/pull/12082</ref>
* Improve- Online scraping of additional artist and album information making better use of Musicbrainz IDs. <ref>https://github.com/xbmc/xbmc/pull/12120</ref><ref>https://github.com/xbmc/xbmc/pull/12597</ref>
* Improve- On clean installs, change default song sort order to Track Number <ref>https://github.com/xbmc/xbmc/pull/12834</ref>
* Improve- FileItem::IsSamePath for albums and artists to prevent false matches <ref>https://github.com/xbmc/xbmc/pull/13585</ref>
* Improve- Album genre inconsistencies <ref>https://github.com/xbmc/xbmc/pull/13042</ref>
* Improve- Avoid unnecessary db access by GUI when app processing GUI_MSG_UPDATE_ITEM messages <ref>https://github.com/xbmc/xbmc/pull/13640</ref>
* Improve- Refactor Artist/Album Information Dialog <ref>https://github.com/xbmc/xbmc/pull/13672</ref>
* Improve- Refactor Song Information Dialog <ref>https://github.com/xbmc/xbmc/pull/13533</ref>
* Improve- Fetching local art for multi-folder albums (disc sets) <ref>https://github.com/xbmc/xbmc/pull/13769</ref>
* Add- Option to rescan the music file tags for existing items in the library <ref>https://github.com/xbmc/xbmc/pull/11557</ref>
* Add- Add processing of WRITER tag for ID3 v2, Vorbis and APE formats <ref>https://github.com/xbmc/xbmc/pull/11735</ref>
* Add- Processing of ARTISTSORT (TSOP), ALBUMARTISTSORT (TS02) and COMPOSERSORT (TSOC) tags to provide a sort name for artists. <ref>https://github.com/xbmc/xbmc/pull/11738</ref>
* Add- New dialog for selection of both artist and album scraper addons, and their settings.<ref>https://github.com/xbmc/xbmc/pull/12987</ref><ref>https://github.com/xbmc/xbmc/pull/12943</ref>
* Add- Additional artist data that Musicbrainz provides: type (person, group, orchestra, choir etc.), gender, and disambiguation comments that help to differentiate artists with the same name <ref>https://github.com/xbmc/xbmc/pull/12963</ref>
* Add- Artist Information Folder - a single location for artist artwork and nfo. This solves numerous issues related to artwork, artist data import and general folder and file structure <ref>https://github.com/xbmc/xbmc/pull/12891</ref>
* Add- Extended Artwork support, making the local art that is picked up automatically on scan configurable. <ref>https://github.com/xbmc/xbmc/pull/13352</ref><ref>https://github.com/xbmc/xbmc/pull/13848</ref><ref>https://github.com/xbmc/xbmc/pull/13491</ref><ref>https://github.com/xbmc/xbmc/pull/13101</ref><ref>https://github.com/xbmc/xbmc/pull/13871</ref>
* Add- Add option to prefer scraped album covers to embedded images <ref>https://github.com/xbmc/xbmc/pull/13812</ref>
* Add- Filter music items by media source <ref>https://github.com/xbmc/xbmc/pull/14012</ref><ref>https://github.com/xbmc/xbmc/pull/14082</ref>

=== Web Scrapers ===
* Added support for Python (script) based web scrapers for Kodi<ref>http://github.com/xbmc/xbmc/pull/9984</ref>
* Refactored and updated many XML based scrapers in Kodi for music, movies, tv shows, and music videos
* Updated music, movies, tv shows, and music video scrapers for Kodi
* ?

=== AudioEngine ===
* Added a new Sndio sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, other BSD Unix based systems, and Linux<ref>https://github.com/xbmc/xbmc/pull/11962</ref>
* Improved the default cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] (Kodi's [[AudioEngine]])
* Improved ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems
* Improved PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop
* Improved OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD and similar BSD Unix based systems
* Improved AUDIOTRACK sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Amlogic]]
* Improved Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]
* Improved DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved CoreAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* Improved Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* Renamed AE_SINK to KODI_AE_SINK
* ?

=== Other ===
* Added a new unified setting for "Startup action" and added "Play TV/Radio"<ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Added support to build Kodi with support for Bluetooth<ref>http://github.com/xbmc/xbmc/pull/11137</ref>
* Added possibility for CMake build system to add additional libraries on install<ref>https://github.com/xbmc/xbmc/pull/12423</ref>
* Updated and improved mappings for new and existing remote controls
* Improved Kodi's JSON-RPC API
* Improved compiling/building and code documentation (following doxygen coding guidelines)
* Changed to use spdlog for Kodi logging as well as improved and further optimized logging (including debug logs)<ref>https://github.com/xbmc/xbmc/pull/11833</ref>
* Changed XML format of setting values for Kodi's settings configuration<ref>https://github.com/xbmc/xbmc/pull/12277</ref>
* Updated default web interface (webinterface is called "Chorus2" and is currently at version 2.4.4)<ref>https://github.com/xbmc/xbmc/pull/11872</ref>
* Updated critical dependency libraries such as openssl, gnutls, and CMake (used to compile Kodi and its binary addons)
* Removed last dependencies of SDL (Simple DirectMedia Layer) which was hardware abstraction for input devices<ref>https://github.com/xbmc/xbmc/pull/12272</ref><ref>https://github.com/xbmc/xbmc/pull/11881</ref>
* Removed all glew (libglew library) dependencies in Kodi's code<ref>http://github.com/xbmc/xbmc/pull/11128</ref>
* ?

=== Android Specific ===
* Added support for speech-to-text in Kodi OSD keyboard on Android TV (triggered by voice button on remote)
* Added support for Android to move the Kodi app to SD card<ref>https://github.com/xbmc/xbmc/pull/12168</ref>
* Added support for Android TV Leanback search and recommendations meta data from Kodi<ref>|https://github.com/xbmc/xbmc/pull/11901</ref>
** Default setting for Android TV Leanback suggestion to random unwatched movies and music albums<ref>https://github.com/xbmc/xbmc/pull/11963</ref>
* Moved to Android NDK 16
* Changed Rendertype from GUILayer to VideoLayer for Android MediaCodecSurface<ref>https://github.com/xbmc/xbmc/pull/12097</ref>
* Changed to use NDK native C interface for Android MediaCodec (for performance gains)<ref>https://github.com/xbmc/xbmc/pull/11931</ref>
* Changed to support ZeroConf via native Android API (and deprecates mDNSresponder)<ref>http://github.com/xbmc/xbmc/pull/11393</ref>
* Changed to support network information via native Android API (and deprecates POSIX)<ref>https://github.com/xbmc/xbmc/pull/12243</ref>
* Changed handling of Kodi's Java interfaces via JNI for better consistency<ref>https://github.com/xbmc/xbmc/pull/12292</ref>
* ?

=== BSD Specific ===
* Improved Kodi support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* ?

=== Linux Specific ===
* Added support for a generic DRM/KMS implementation using GBM to create required surfaces<ref>https://github.com/xbmc/xbmc/pull/11955</ref>
* Added support for Mir windowing system (Mir 1.0) for Kodi<ref>http://github.com/xbmc/xbmc/pull/10898</ref> and added support for VAAPI on Mir using DRM<ref>http://github.com/xbmc/xbmc/pull/11040</ref>
* Added support for the middle mouse button on embedded platforms<ref>https://github.com/xbmc/xbmc/pull/11956</ref>
* Added support more yuv420p bitwidths for direct rendering on Linux<ref>https://github.com/xbmc/xbmc/pull/12479</ref>
* Added support for using VAAPI hardware video decoding with OpenGL ES<ref>https://github.com/xbmc/xbmc/pull/12113</ref>
* Added support for build Kodi with imx support using CMake<ref>http://github.com/xbmc/xbmc/pull/11288</ref>
* Moved the CMake build system to the top of the code tree (moved to root)<ref>http://github.com/xbmc/xbmc/pull/10446</ref>
* Improved support for UltraHD decoding / 4K resolution output when hardware supports it
* Improved ARM processor architecture (using [[Raspberry Pi]] as reference device)
* Improved OpenGL ES and EGL support (using [[Raspberry Pi]] as reference device)
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* Improved XvBA (AMD/ATI) Hardware Video Acceleration (requires XvBA compatible hardware and drivers)
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on Amlogic devices
* Removed the unused and unmaintained OpenMAX video decoder from Kodi's VideoPlayer<ref>https://github.com/xbmc/xbmc/pull/12197</ref>
* Removed support for autotools based build system for Kodi and binary addons (in favour of CMake)<ref>http://github.com/xbmc/xbmc/pull/10429</ref>
* ?

=== iOS Specific ===
* Added support for iOS 10.0 by adding support for compiling Kodi with Xcode 8 IDE and iOS SDK 10.0<ref>https://github.com/xbmc/xbmc/pull/10539</ref>
* Improved Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)
* Improved support for TVOS (Apple's iOS fork for Apple TV 4) in Kodi mainline
* Improved support for iOS on ARM64 (64-bit iOS)
* ?

=== OS X Specific ===
* Added support for compiling Kodi with Xcode 8 IDE for OSX 10.11 (El Capitan) and macOS 10.12 (Sierra)
* Improved Apple VDADecoder Video Acceleration support for (Mac) OS X
* ?

=== Windows Specific ===
* Added support to build Kodi for Windows 64 / Windows for Intel 64-bit (x86-64)<ref>https://github.com/xbmc/xbmc/pull/12065</ref>
* Added support for 3D LUT (3D Lookup Table) and dithering to Windows video renderer<ref name="WinRenderer re-work">https://github.com/xbmc/xbmc/pull/12475</ref>
* Improved support to compiling Kodi for Microsoft's UWP (Universal Windows Platform) APIs
* Changed the inner working of render buffers and rendering methods<ref name="WinRenderer re-work"/>
* Changed to using unicode win32 api methods<ref>https://github.com/xbmc/xbmc/pull/11780</ref>
* Changed windowing systems for screen saver handling on Windows OS platforms
* Changed to make Kodi for Windows platform independent of posix/main.cpp<ref>https://github.com/xbmc/xbmc/pull/12215</ref>
* Removed support for Windows Vista as the operating-system is no longer supported by Microsoft<ref>https://github.com/xbmc/xbmc/pull/11953</ref>
* ?

== References ==
<references/>

== See also ==
* [[Leia API changes]]
{{Changelogs}}

[[Category:Manual]]
[[Category:Leia|*]]
[[Category:Changelogs|18]]

Kodi v18 (Leia) changelog

2018-01-25T15:48:28Z

Ksooo: /* Live TV and PVR (Personal Video Recorder) */

{{mininav|[[Releases]] {{l2| [[Leia]] }} }}

{{notice|Kodi v17 (Krypton) final has just been released, so please keep in mind that a final non-alpha/beta v18 (Leia) release is still far far away into the future. As such, these new features/functions and API changes is a placeholder containing changes to the current Kodi mainline (the git master tree repository on GitHub). It is a very much a work in progress, this is only listing changes commited to the master branch after Jarvis branching, and many many many features/functions and API additions, alterations or removal are still subject to future change.}}
{{incomplete}}
{{future|18}}

{{see also|Kodi v18 (Leia) FAQ|Leia API changes|Releases}}

This is a placeholder and Kodi Wiki copy of the condensed changelog for the future Kodi v18.x version (codename: "Leia") releases with a summery of the most important core features and functions as well as other notable changes to key areas of the application software or its user interface.

== Changelog ==

=== Gaming (Games interface and Game Clients)===
* Added a RetroPlayer player core supporting game clients as well as emulator cores via libretro API<ref name="RetroPlayer">RetroPlayer http://forum.kodi.tv/showthread.php?tid=164725</ref><ref>http://github.com/xbmc/xbmc/pull/11022</ref>
* Added extentions to Kodi's Addons AP to support Game Client Addons, supporting Kodi's VFS (Virtual File System), etc.<ref name="RetroPlayer"/>
* Added support for Game Client Addons as new type of addons with just-in-time emulator installation<ref name="RetroPlayer"/>
* Added a Games window and Game OSD (On-Screen-Display) entries to the GUI<ref name="RetroPlayer"/><ref>https://github.com/xbmc/xbmc/pull/12367</ref>
* Added a gaming and game configuration interface for Game settings to the GUI<ref name="RetroPlayer"/>
* Added support for Game Info Tags (game info tag) and exposed properties to Python list items<ref name="RetroPlayer"/>
* Added a savestate (savestate) manager to Kodi for games<ref>http://github.com/xbmc/xbmc/pull/11034</ref>
* Added initial support for basic gameplay persistence (auto-save & auto-load)<ref>https://github.com/xbmc/xbmc/pull/12434</ref>
* Added support for in-game (save RAM) saves<ref>http://github.com/xbmc/xbmc/pull/11380</ref>
* Added support for Keyboard players via Joystick Emulation<ref name="RetroPlayer"/>
* Added support for libretro API and game cores (emulators and games) that support it
* Added [[Game_Add-ons|game clients addons]] for many popular third-party game console emulators and native open source games *
** ''* [[Game_Add-ons|Game clients addons]] for Kodi is changing quickly so checkout the [[Game_Add-ons|game clients addons]] article for a current list''
* ?

=== Live TV and PVR (Personal Video Recorder) ===
* Major GUI actions refactoring to eliminate duplicate and dead code. Add context menu support for Estuary PVR home screen widgets <ref>https://github.com/xbmc/xbmc/pull/10870</ref>
* Guide window: Get rid of obsolete views "channel", "now" and "next" <ref>https://github.com/xbmc/xbmc/pull/10838</ref>
* Core: Refactor and fix "play minimized" settings handling <ref>https://github.com/xbmc/xbmc/pull/11203</ref>
* Guide, channel, video fullscreen, music visualisation window: Direct channel number input. <ref>https://github.com/xbmc/xbmc/pull/11434</ref>
* Settings: Remove setting 'hide connection lost warning' <ref>https://github.com/xbmc/xbmc/pull/11500</ref>
* Search dialog: Refactor and complete implementation of EPG search filter <ref>https://github.com/xbmc/xbmc/pull/11570</ref>
* Timer settings dialog: Prefill recordings folder with timer title <ref>https://github.com/xbmc/xbmc/pull/11679</ref>
* Recordings window: Content view filter <ref>https://github.com/xbmc/xbmc/pull/11704</ref>
* Settings: Remove non-working recording settings defaults <ref>https://github.com/xbmc/xbmc/pull/11746</ref>
* Guide window: 'Smart selection' of epg events. <ref>https://github.com/xbmc/xbmc/pull/11782</ref>
* Channelgroup manager: Add support for radio channel groups <ref>https://github.com/xbmc/xbmc/pull/11877</ref>
* Guide window: Add possibility to switch between horizontal and vertical epg grid view <ref>https://github.com/xbmc/xbmc/pull/11958</ref>
* Search window: improvements and fixes <ref>https://github.com/xbmc/xbmc/pull/12001</ref>
* Estuary home screen: Add Info support to recently played channel widget <ref>https://github.com/xbmc/xbmc/pull/12254</ref>
* Estuary: Add episodename to live tv and recordings osd sub label, cleanup seek bar for live tv <ref>https://github.com/xbmc/xbmc/pull/12306</ref>
* Estuary: PVR info dialog, recordings window: cleanup and extend <ref>https://github.com/xbmc/xbmc/pull/12416</ref>
* Drop 'channel guide' button from epg event info dialog, add 'channel guide' to context menu <ref>https://github.com/xbmc/xbmc/pull/12526</ref>
* Settings: Introduce new setting 'Startup action' and add 'Play TV/Radio <ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Settings: Make 'epg.lingertime' an official setting, remove the respective advanced setting <ref>https://github.com/xbmc/xbmc/pull/12740</ref>
* Setting: Remove obsolete and unused setting 'pvrplayback.scantime' <ref>https://github.com/xbmc/xbmc/pull/12800</ref>
* Core: Fixes/Improvements for multiple enable PVR client addons <ref>https://github.com/xbmc/xbmc/pull/12959</ref>
* Core: Fixes/Improvements for subchannel numbers support (ATSC) <ref>https://github.com/xbmc/xbmc/pull/13069</ref>
* Core: Global direct channel number input & global unique channel numbers <ref>https://github.com/xbmc/xbmc/pull/13135</ref>
* Database: Fix error "Abort due to constraint violation. Query: INSERT INTO channels..." <ref>https://github.com/xbmc/xbmc/pull/13150</ref>
* Estuary: Rework PVR seekbar + Fix PVR info dialog <ref>https://github.com/xbmc/xbmc/pull/13158</ref>
* Core: Make next/previous chapter work for PVR recordings <ref>https://github.com/xbmc/xbmc/pull/13164</ref>
* Direct channel number input: No delay on switch to previous channel with key 0 <ref>https://github.com/xbmc/xbmc/pull/13232</ref>
* Settings: Make shared channel selection optional <ref>https://github.com/xbmc/xbmc/pull/13237</ref>
* Estuary: PVR info panel cleanup <ref>https://github.com/xbmc/xbmc/pull/13255</ref>
* Guide window: 'Go to date' context menu item <ref>https://github.com/xbmc/xbmc/pull/13282</ref>
* Estuary: Season/Episode info in Guide window and dialog <ref>https://github.com/xbmc/xbmc/pull/13300</ref>
* Estuary: Add percent played progress bar to PVR info panel (for recordings) <ref>https://github.com/xbmc/xbmc/pull/13338</ref>
* Guide window: Channel groups selector <ref>https://github.com/xbmc/xbmc/pull/13364</ref>
* Guide window: Tweaks for more consistency and readability <ref>https://github.com/xbmc/xbmc/pull/13402</ref>
* PVR-Addon API changes <ref>https://github.com/xbmc/xbmc/pull/12028</ref><ref>https://github.com/xbmc/xbmc/pull/12303</ref><ref>https://github.com/xbmc/xbmc/pull/12552</ref><ref>https://github.com/xbmc/xbmc/pull/12609</ref><ref>https://github.com/xbmc/xbmc/pull/12660</ref><ref>https://github.com/xbmc/xbmc/pull/12689</ref><ref>https://github.com/xbmc/xbmc/pull/12755</ref><ref>https://github.com/xbmc/xbmc/pull/13228</ref>
* Added, updated, and improved PVR backend clients addons for all popular third-party external [[PVR backend]] platforms:
** New: [[Add-on:Zattoo PVR Client|Zattoo PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** New: [[Add-on:Teleboy PVR Client|Teleboy PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR Demo Client|PVR Demo Client]] dummy addon with fake (method stub) [[PVR backend]] for [[PVR]] skinning and regression testing
** [[Add-on:IPTV Simple Client|IPTV Simple Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:HDHomeRun PVR|HDHomeRun]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Digital Devices Octopus NET Client|Digital Devices Octopus NET Client]] PVR Addon backend client maintained and made available by [http://digitaldevices.de/home/ Digital Devices]
** [[Add-on:VU+ / Enigma2 Client|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Njoy N7 PVR Client|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VDR VNSI Client|VDR VNSI Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MythTV PVR Client|MythTV PVR Client]] Addon backend client maintained and available from the Kodi's community
** [[Add-on:NextPVR PVR Client|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Argus TV Client|Argus TV (former ForTheRecord)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBLink PVR Client|DVBLink PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBViewer Client|DVBViewer Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MediaPortal PVR Client|MediaPortal PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community
* ?

=== Add-ons Framework, API, and Manager ===
For full changelogs of all Addons APIs, see [[Leia API changes]], [http://forum.kodi.tv/forumdisplay.php?fid=174 JSON-RPC], and [http://forum.kodi.tv/forumdisplay.php?fid=26 Add-ons] Development Forums
* Major refactoring of Kodi's core handling and GUI management of binary addons<ref>http://github.com/xbmc/xbmc/pulls?q=label%3A%22Binary+Addons%22+is%3Aclosed</ref>
* Added framework to support VFS (Virtual File System) as binary addons<ref>http://github.com/xbmc/xbmc/pull/8966</ref>
* Added framework support for binary addons for video decoder codecs<ref name="Addon video codec implementation">https://github.com/xbmc/xbmc/pull/12340</ref>
* Added framework support for binary addons for image (picture) decoder codecs
* Added extentions to Kodi's Addons API to support binary addons for video decoder codecs<ref name="Addon video codec implementation"/>
* Added extentions to Kodi's Addons API to support binary addons for image decoder codecs
* Added support for Python addons to use PyCryptoDome crypto module for decryption<ref>https://github.com/xbmc/xbmc/pull/11477</ref>
* Added option to pass HTTP cookies with AVOption to Kodi's Video Player<ref>https://github.com/xbmc/xbmc/pull/12257</ref>
* Added support to allow addons to edit all used controls on their processed window<ref>https://github.com/xbmc/xbmc/pull/12259</ref>
* Added support to allow Python addons to set the videoinfotag path<ref>http://github.com/xbmc/xbmc/pull/11012</ref>
* Added support to allow Python addons to get/set the dbid of a (music) listitem<ref>http://github.com/xbmc/xbmc/pull/10858</ref>
* Added support for mediatype to musicinfotag tag retrieving via Python API<ref>http://github.com/xbmc/xbmc/pull/11110</ref>
* Added support "int/float slider" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11230</ref>
* Added support "setContent for mediawindows" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11258</ref>
* Added help for load of shared library and allow the use of their own addon temp folder<ref>https://github.com/xbmc/xbmc/pull/12379</ref>
* Added support to inspect add-on dependencies prior to installation<ref>https://github.com/xbmc/xbmc/pull/12242</ref>
* Added ability to remove add-on settings upon uninstall<ref>https://github.com/xbmc/xbmc/pull/11499</ref>
* Changed to new addon gui interface for list items to use on addon window<ref>https://github.com/xbmc/xbmc/pull/12214</ref>
* Changed service addons to use event handlers instead of synchronous addon hooks<ref>https://github.com/xbmc/xbmc/pull/12370</ref>
* Updated "Peripheral Addons" for game controllers, gamepads, joysticks, and input peripherals profiles (in Kodi-game repo<ref>http://github.com/kodi-game/ kodi-game repo on GitHub</ref>):
** [http://github.com/xbmc/peripheral.joystick Joystick Controller Addon]
** [http://github.com/kodi-game/peripheral.xarcade X-Arcade (XGaming Tankstick) support for Kodi Addon]
** [http://github.com/kodi-game/peripheral.steamcontroller Steam Controller (gamepad) Addon]
** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.default Default Game Controller Addon (reference game controller addon based on Xbox 360 gamepad)]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.ps PlayStation Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.nes Nintendo NES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.snes Nintendo SNES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.n64 Nintendo N64 Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.gba Nintendo GBA Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.genesis Sega Genesis Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.dreamcast Sega Dreamcast Game Controller Addon]
* ?

=== GUI Engine (Skinning Engine) ===
For full changelog on changes to the skinning engine, see [[Leia API changes]] and the [http://forum.kodi.tv/showthread.php?tid=298565 Skin Development Forum]
* Added windows to support Games and Game OSD in the new default skins (Estuary and Estouchy)
* Added player process info dialog to Kodi's default skin (Estuary)<ref>https://github.com/xbmc/xbmc/pull/11718</ref>
* Added support for addons to use banner and ClearLogo<ref>https://github.com/xbmc/xbmc/pull/12244</ref>
* Added support for skins/gui to allow implicit container referencing for non-media windows<ref>http://github.com/xbmc/xbmc/pull/10883</ref>
* Added support for addons to add "Enable/Disable" to context menu<ref>http://github.com/xbmc/xbmc/pull/11124</ref>
* Added support for remember last used keyboard layout in GUI<ref>http://github.com/xbmc/xbmc/pull/11242</ref>
* Added support for ISO 639-2/T language code retrieval (required by libbluray)<ref>https://github.com/xbmc/xbmc/pull/12258</ref>
* Added window that display Kodi privacy policy in GUI settings under system info<ref>https://github.com/xbmc/xbmc/pull/10785</ref>
* Added support to map a key to browse for subtitle in video fullscreen window<ref>https://github.com/xbmc/xbmc/pull/11649</ref>
* Improved Kodi's GUI engine with optimizations for message handling and SmartRedraw<ref>https://github.com/xbmc/xbmc/pull/12213</ref>
* Improved Kodi's GUI engine support for scaling container layouts<ref>http://github.com/xbmc/xbmc/pull/11229</ref>
* Improved Kodi's GUI engine by allowing %-values for origin, camera and animation attribs<ref>http://github.com/xbmc/xbmc/pull/11233</ref>
* Changed so that context menu reloading loads async to aviod GUI lockup on wait<ref>https://github.com/xbmc/xbmc/pull/11841</ref>
* Updated guilib ABI (for libgui) to version 5.13.0<ref>http://github.com/xbmc/xbmc/pull/11306</ref>
* Updated keyboard layout for some languages and added support Croatian, Slovenian, and Thai (Kedmanee)
* Updated image resource addons (as example weather icons, weather fanart, studio logos, and genre icons)
* ?

=== Platform Independent Playback ===
* Added support for "InputStream" (input stream) addons to pass CryptoSession flags field<ref>https://github.com/xbmc/xbmc/pull/12428</ref>
* Added support for BD-J / Blu-ray Disc Java menu support (requires system Java runtime enviroment)<ref>https://github.com/xbmc/xbmc/pull/12339</ref><ref>https://github.com/xbmc/xbmc/pull/12310</ref>
* Added support for Blu-ray Disc detection and use provided meta data for Blu-ray Disc names<ref>https://github.com/xbmc/xbmc/pull/12488</ref>
* Added support for video buffers to be used by decoders and renderers<ref name="VideoPlayer updates for Leia">https://github.com/xbmc/xbmc/pull/12212</ref>
** Added support for platforms to register custom buffers, like example dma<ref name="VideoPlayer updates for Leia"/>
* Added a VC1-Packet bitstream parser implementation for improved VC-1 playback<ref>http://github.com/xbmc/xbmc/pull/11417</ref>
* Added and updated many (binary) audio decoder and encoder addons for Kodi
* Added a few (binary) video decoder addons for Kodi<ref name="Addon video codec implementation"/>
* Added a "RAW" (libraw based) image decoder addon to Kodi<ref>https://github.com/xbmc/xbmc/pull/11671</ref>
* Improved MMAL playback of H.264 MVC (Blu-ray 3D) stereoscopic video with framepacking decoding on Raspberry Pi
* Improved Stereoscopic 3D playback of 3D videos (as well as better 2D playback of 3D videos)
* Improved and enhanced Blu-ray support (including updated libbluray dependecies from the VideoLAN project<ref>https://github.com/xbmc/xbmc/pull/12305</ref><ref>http://git.videolan.org/?p=libbluray.git;a=blob;f=ChangeLog</ref>
* Improved support for "InputStream" (input stream) addons as system addons
* Updated "InputStream" (input stream) client addons for common network streaming protocols and popular services:
** [http://github.com/xbmc/xbmc/tree/master/addons/kodi.inputstream InputStream Addon (default reference InputStream Addon by Team Kodi]
** [http://github.com/mapfau/inputstream.test Test InputStream Addon (Test InputStream Addon for Kodi's new inputstream interface]
** [http://github.com/peak3d/inputstream.adaptive Adaptive InputStream Addon (InputStream Client addon for several manifest types)]
** [http://github.com/xbmc/repo-binary-addons/tree/master/inputstream.rtmp RTMP InputStream Addon (InputStream Client for RTMP streams using librtmp)]
** [http://github.com/peak3d/inputstream.mpd MPD (MPEG-DASH) InputStream Addon]
** [http://github.com/peak3d/inputstream.smoothstream SmoothStream InputStream Addon for MS-SSTR (SmoothStreamingMedia) Smooth Streaming Protocol]
** [http://github.com/mapfau/inputstream.nxmsl NXMSL InputStream Addon for Netflix style manifests over MSL]
* Updated FFmpeg multimedia codec and demux libraries to stable branch release version [http://www.ffmpeg.org/download.html#release_3.3.2 FFmpeg 3.3 (3.3.2)]<ref>http://git.videolan.org/?p=ffmpeg.git;a=blob_plain;f=Changelog;hb=release/3.3.2 FFmpeg 3.3.2 release changelog</ref><ref>https://github.com/xbmc/xbmc/pull/12358</ref>
* Removed certain audio codecs from core and made them into audio decoder and audio encoder add-ons
* Removed certain video codecs from core and made them into video decoder add-ons<ref name="Addon video codec implementation"/>
* Removed certain image codecs from core and made them into image decoder add-ons
* ?

=== Library ===
* Addded support to use the Favourites function in context menus<ref>https://github.com/xbmc/xbmc/pull/11967</ref>
* Added support for context menus to favourites home screen widget<ref>https://github.com/xbmc/xbmc/pull/11929</ref>
* Added support for processing of WRITER tag for ID3 v2, Vorbis and APE formats<ref>https://github.com/xbmc/xbmc/pull/11735</ref>
* Added support for sorting using artist sort name tags in music<ref>https://github.com/xbmc/xbmc/pull/11738</ref>
* Added support to "Sort By Date Added" in Music Video title node<ref>https://github.com/xbmc/xbmc/pull/12495</ref>
* Changed to never cache listing of PVR directories on library scans<ref>https://github.com/xbmc/xbmc/pull/11761</ref>
* ?

=== Web Scrapers ===
* Added support for Python (script) based web scrapers for Kodi<ref>http://github.com/xbmc/xbmc/pull/9984</ref>
* Refactored and updated many XML based scrapers in Kodi for music, movies, tv shows, and music videos
* Updated music, movies, tv shows, and music video scrapers for Kodi
* ?

=== AudioEngine ===
* Added a new Sndio sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, other BSD Unix based systems, and Linux<ref>https://github.com/xbmc/xbmc/pull/11962</ref>
* Improved the default cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] (Kodi's [[AudioEngine]])
* Improved ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems
* Improved PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop
* Improved OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD and similar BSD Unix based systems
* Improved AUDIOTRACK sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Amlogic]]
* Improved Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]
* Improved DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved CoreAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* Improved Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* ?

=== Other ===
* Added a new unified setting for "Startup action" and added "Play TV/Radio"<ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Added support to build Kodi with support for Bluetooth<ref>http://github.com/xbmc/xbmc/pull/11137</ref>
* Added possibility for CMake build system to add additional libraries on install<ref>https://github.com/xbmc/xbmc/pull/12423</ref>
* Updated and improved mappings for new and existing remote controls
* Improved Kodi's JSON-RPC API
* Improved compiling/building and code documentation (following doxygen coding guidelines)
* Changed to use spdlog for Kodi logging as well as improved and further optimized logging (including debug logs)<ref>https://github.com/xbmc/xbmc/pull/11833</ref>
* Changed XML format of setting values for Kodi's settings configuration<ref>https://github.com/xbmc/xbmc/pull/12277</ref>
* Updated default web interface (webinterface is called "Chorus2" and is currently at version 2.4.4)<ref>https://github.com/xbmc/xbmc/pull/11872</ref>
* Updated critical dependency libraries such as openssl, gnutls, and CMake (used to compile Kodi and its binary addons)
* Removed last dependencies of SDL (Simple DirectMedia Layer) which was hardware abstraction for input devices<ref>https://github.com/xbmc/xbmc/pull/12272</ref><ref>https://github.com/xbmc/xbmc/pull/11881</ref>
* Removed all glew (libglew library) dependencies in Kodi's code<ref>http://github.com/xbmc/xbmc/pull/11128</ref>
* ?

=== Android Specific ===
* Added support for speech-to-text in Kodi OSD keyboard on Android TV (triggered by voice button on remote)
* Added support for Android to move the Kodi app to SD card<ref>https://github.com/xbmc/xbmc/pull/12168</ref>
* Added support for Android TV Leanback search and recommendations meta data from Kodi<ref>|https://github.com/xbmc/xbmc/pull/11901</ref>
** Default setting for Android TV Leanback suggestion to random unwatched movies and music albums<ref>https://github.com/xbmc/xbmc/pull/11963</ref>
* Moved to Android NDK 14b
* Changed Rendertype from GUILayer to VideoLayer for Android MediaCodecSurface<ref>https://github.com/xbmc/xbmc/pull/12097</ref>
* Changed to use NDK native C interface for Android MediaCodec (for performance gains)<ref>https://github.com/xbmc/xbmc/pull/11931</ref>
* Changed to support ZeroConf via native Android API (and deprecates mDNSresponder)<ref>http://github.com/xbmc/xbmc/pull/11393</ref>
* Changed to support network information via native Android API (and deprecates POSIX)<ref>https://github.com/xbmc/xbmc/pull/12243</ref>
* Changed handling of Kodi's Java interfaces via JNI for better consistency<ref>https://github.com/xbmc/xbmc/pull/12292</ref>
* ?

=== BSD Specific ===
* Improved Kodi support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* ?

=== Linux Specific ===
* Added support for a generic DRM/KMS implementation using GBM to create required surfaces<ref>https://github.com/xbmc/xbmc/pull/11955</ref>
* Added support for Mir windowing system (Mir 1.0) for Kodi<ref>http://github.com/xbmc/xbmc/pull/10898</ref> and added support for VAAPI on Mir using DRM<ref>http://github.com/xbmc/xbmc/pull/11040</ref>
* Added support for the middle mouse button on embedded platforms<ref>https://github.com/xbmc/xbmc/pull/11956</ref>
* Added support more yuv420p bitwidths for direct rendering on Linux<ref>https://github.com/xbmc/xbmc/pull/12479</ref>
* Added support for using VAAPI hardware video decoding with OpenGL ES<ref>https://github.com/xbmc/xbmc/pull/12113</ref>
* Added support for build Kodi with imx support using CMake<ref>http://github.com/xbmc/xbmc/pull/11288</ref>
* Moved the CMake build system to the top of the code tree (moved to root)<ref>http://github.com/xbmc/xbmc/pull/10446</ref>
* Improved support for UltraHD decoding / 4K resolution output when hardware supports it
* Improved ARM processor architecture (using [[Raspberry Pi]] as reference device)
* Improved OpenGL ES and EGL support (using [[Raspberry Pi]] as reference device)
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* Improved XvBA (AMD/ATI) Hardware Video Acceleration (requires XvBA compatible hardware and drivers)
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on Amlogic devices
* Removed the unused and unmaintained OpenMAX video decoder from Kodi's VideoPlayer<ref>https://github.com/xbmc/xbmc/pull/12197</ref>
* Removed support for autotools based build system for Kodi and binary addons (in favour of CMake)<ref>http://github.com/xbmc/xbmc/pull/10429</ref>
* ?

=== iOS Specific ===
* Added support for iOS 10.0 by adding support for compiling Kodi with Xcode 8 IDE and iOS SDK 10.0<ref>https://github.com/xbmc/xbmc/pull/10539</ref>
* Improved Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)
* Improved support for TVOS (Apple's iOS fork for Apple TV 4) in Kodi mainline
* Improved support for iOS on ARM64 (64-bit iOS)
* ?

=== OS X Specific ===
* Added support for compiling Kodi with Xcode 8 IDE for OSX 10.11 (El Capitan) and macOS 10.12 (Sierra)
* Improved Apple VDADecoder Video Acceleration support for (Mac) OS X
* ?

=== Windows Specific ===
* Added support to build Kodi for Windows 64 / Windows for Intel 64-bit (x86-64)<ref>https://github.com/xbmc/xbmc/pull/12065</ref>
* Added support for 3D LUT (3D Lookup Table) and dithering to Windows video renderer<ref name="WinRenderer re-work">https://github.com/xbmc/xbmc/pull/12475</ref>
* Improved support to compiling Kodi for Microsoft's UWP (Universal Windows Platform) APIs
* Changed the inner working of render buffers and rendering methods<ref name="WinRenderer re-work"/>
* Changed to using unicode win32 api methods<ref>https://github.com/xbmc/xbmc/pull/11780</ref>
* Changed windowing systems for screen saver handling on Windows OS platforms
* Changed to make Kodi for Windows platform independent of posix/main.cpp<ref>https://github.com/xbmc/xbmc/pull/12215</ref>
* Removed support for Windows Vista as the operating-system is no longer supported by Microsoft<ref>https://github.com/xbmc/xbmc/pull/11953</ref>
* ?

== References ==
<references/>

== See also ==
* [[Leia API changes]]
{{Changelogs}}

[[Category:Manual]]
[[Category:Leia|*]]
[[Category:Changelogs|18]]

Kodi v18 (Leia) changelog

2018-01-25T15:47:05Z

Ksooo: /* Live TV and PVR (Personal Video Recorder) */

{{mininav|[[Releases]] {{l2| [[Leia]] }} }}

{{notice|Kodi v17 (Krypton) final has just been released, so please keep in mind that a final non-alpha/beta v18 (Leia) release is still far far away into the future. As such, these new features/functions and API changes is a placeholder containing changes to the current Kodi mainline (the git master tree repository on GitHub). It is a very much a work in progress, this is only listing changes commited to the master branch after Jarvis branching, and many many many features/functions and API additions, alterations or removal are still subject to future change.}}
{{incomplete}}
{{future|18}}

{{see also|Kodi v18 (Leia) FAQ|Leia API changes|Releases}}

This is a placeholder and Kodi Wiki copy of the condensed changelog for the future Kodi v18.x version (codename: "Leia") releases with a summery of the most important core features and functions as well as other notable changes to key areas of the application software or its user interface.

== Changelog ==

=== Gaming (Games interface and Game Clients)===
* Added a RetroPlayer player core supporting game clients as well as emulator cores via libretro API<ref name="RetroPlayer">RetroPlayer http://forum.kodi.tv/showthread.php?tid=164725</ref><ref>http://github.com/xbmc/xbmc/pull/11022</ref>
* Added extentions to Kodi's Addons AP to support Game Client Addons, supporting Kodi's VFS (Virtual File System), etc.<ref name="RetroPlayer"/>
* Added support for Game Client Addons as new type of addons with just-in-time emulator installation<ref name="RetroPlayer"/>
* Added a Games window and Game OSD (On-Screen-Display) entries to the GUI<ref name="RetroPlayer"/><ref>https://github.com/xbmc/xbmc/pull/12367</ref>
* Added a gaming and game configuration interface for Game settings to the GUI<ref name="RetroPlayer"/>
* Added support for Game Info Tags (game info tag) and exposed properties to Python list items<ref name="RetroPlayer"/>
* Added a savestate (savestate) manager to Kodi for games<ref>http://github.com/xbmc/xbmc/pull/11034</ref>
* Added initial support for basic gameplay persistence (auto-save & auto-load)<ref>https://github.com/xbmc/xbmc/pull/12434</ref>
* Added support for in-game (save RAM) saves<ref>http://github.com/xbmc/xbmc/pull/11380</ref>
* Added support for Keyboard players via Joystick Emulation<ref name="RetroPlayer"/>
* Added support for libretro API and game cores (emulators and games) that support it
* Added [[Game_Add-ons|game clients addons]] for many popular third-party game console emulators and native open source games *
** ''* [[Game_Add-ons|Game clients addons]] for Kodi is changing quickly so checkout the [[Game_Add-ons|game clients addons]] article for a current list''
* ?

=== Live TV and PVR (Personal Video Recorder) ===
* Major GUI actions refactoring to eliminate duplicate and dead code. Add context menu support for Estuary PVR home screen widgets <ref>https://github.com/xbmc/xbmc/pull/10870</ref>
* Guide window: Get rid of obsolete views "channel", "now" and "next" <ref>https://github.com/xbmc/xbmc/pull/10838</ref>
* Core: Refactor and fix "play minimized" settings handling <ref>https://github.com/xbmc/xbmc/pull/11203</ref>
* Guide, channel, video fullscreen, music visualisation window: Direct channel number input. <ref>https://github.com/xbmc/xbmc/pull/11434</ref>
* Settings: Remove setting 'hide connection lost warning' <ref>https://github.com/xbmc/xbmc/pull/11500</ref>
* Search dialog: Refactor and complete implementation of EPG search filter <ref>https://github.com/xbmc/xbmc/pull/11570</ref>
* Timer settings dialog: Prefill recordings folder with timer title <ref>https://github.com/xbmc/xbmc/pull/11679</ref>
* Recordings window: Content view filter <ref>https://github.com/xbmc/xbmc/pull/11704</ref>
* Settings: Remove non-working recording settings defaults <ref>https://github.com/xbmc/xbmc/pull/11746</ref>
* Guide window: 'Smart selection' of epg events. <ref>https://github.com/xbmc/xbmc/pull/11782</ref>
* Channelgroup manager: Add support for radio channel groups <ref>https://github.com/xbmc/xbmc/pull/11877</ref>
* Guide window: Add possibility to switch between horizontal and vertical epg grid view <ref>https://github.com/xbmc/xbmc/pull/11958</ref>
* Search window: improvements and fixes <ref>https://github.com/xbmc/xbmc/pull/12001</ref>
* Estuary home screen: Add Info support to recently played channel widget <ref>https://github.com/xbmc/xbmc/pull/12254</ref>
* Estuary: Add episodename to live tv and recordings osd sub label, cleanup seek bar for live tv <ref>https://github.com/xbmc/xbmc/pull/12306</ref>
* Estuary: PVR info dialog, recordings window: cleanup and extend <ref>https://github.com/xbmc/xbmc/pull/12416</ref>
* Drop 'channel guide' button from epg event info dialog, add 'channel guide' to context menu <ref>https://github.com/xbmc/xbmc/pull/12526</ref>
* Settings: Introduce new setting 'Startup action' and add 'Play TV/Radio <ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Settings: Make 'epg.lingertime' an official setting, remove the respective advanced setting <ref>https://github.com/xbmc/xbmc/pull/12740</ref>
* Setting: Remove obsolete and unused setting 'pvrplayback.scantime' <ref>https://github.com/xbmc/xbmc/pull/12800</ref>
* Core: Fixes/Improvements for multiple enable PVR client addons <ref>https://github.com/xbmc/xbmc/pull/12959</ref>
* Core: Fixes/Improvements for subchannel numbers support (ATSC) <ref>https://github.com/xbmc/xbmc/pull/13069</ref>
* Core: Global direct channel number input & global unique channel numbers <ref>https://github.com/xbmc/xbmc/pull/13135</ref>
* Database: Fix error "Abort due to constraint violation. Query: INSERT INTO channels..." <ref>https://github.com/xbmc/xbmc/pull/13150</ref>
* Estuary: Rework PVR seekbar + Fix PVR info dialog <ref>https://github.com/xbmc/xbmc/pull/13158</ref>
* Core: Make next/previous chapter work for PVR recordings <ref>https://github.com/xbmc/xbmc/pull/13164</ref>
* Direct channel number input: No delay on switch to previous channel with key 0 <ref>https://github.com/xbmc/xbmc/pull/13232</ref>
* Settings: Make shared channel selection optional <ref>https://github.com/xbmc/xbmc/pull/13237</ref>
* Estuary: PVR info panel cleanup <ref>https://github.com/xbmc/xbmc/pull/13255</ref>
* Guide window: 'Go to date' context menu item <ref>https://github.com/xbmc/xbmc/pull/13282</ref>
* Estuary: Season/Episode info in Guide window and dialog <ref>https://github.com/xbmc/xbmc/pull/13300</ref>
* Estuary: Add percent played progress bar to PVR info panel (for recordings) <ref>https://github.com/xbmc/xbmc/pull/13338</ref>
* Guide window: Channel groups selector <ref>https://github.com/xbmc/xbmc/pull/13364</ref>
* Guide window: Tweaks for more consistency and readability <ref>https://github.com/xbmc/xbmc/pull/13402</ref>
* PVR-Addon API changes <ref>https://github.com/xbmc/xbmc/pull/12028</ref><ref>https://github.com/xbmc/xbmc/pull/12303</ref><ref>https://github.com/xbmc/xbmc/pull/12552</ref><ref>https://github.com/xbmc/xbmc/pull/12609</ref><ref>https://github.com/xbmc/xbmc/pull/12660</ref><ref>https://github.com/xbmc/xbmc/pull/12689</ref><ref>https://github.com/xbmc/xbmc/pull/12755</ref><ref>https://github.com/xbmc/xbmc/pull/13228</ref>
* Added, updated, and improved PVR backend clients addons for all popular third-party external [[PVR backend]] platforms:
** New: [[Add-on:Zattoo PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** New: [[Add-on:Teleboy PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR Demo Client|PVR Demo Client]] dummy addon with fake (method stub) [[PVR backend]] for [[PVR]] skinning and regression testing
** [[Add-on:IPTV Simple Client|IPTV Simple Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:HDHomeRun PVR|HDHomeRun]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Digital Devices Octopus NET Client|Digital Devices Octopus NET Client]] PVR Addon backend client maintained and made available by [http://digitaldevices.de/home/ Digital Devices]
** [[Add-on:VU+ / Enigma2 Client|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Njoy N7 PVR Client|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VDR VNSI Client|VDR VNSI Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MythTV PVR Client|MythTV PVR Client]] Addon backend client maintained and available from the Kodi's community
** [[Add-on:NextPVR PVR Client|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Argus TV Client|Argus TV (former ForTheRecord)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBLink PVR Client|DVBLink PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBViewer Client|DVBViewer Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MediaPortal PVR Client|MediaPortal PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community
* ?

=== Add-ons Framework, API, and Manager ===
For full changelogs of all Addons APIs, see [[Leia API changes]], [http://forum.kodi.tv/forumdisplay.php?fid=174 JSON-RPC], and [http://forum.kodi.tv/forumdisplay.php?fid=26 Add-ons] Development Forums
* Major refactoring of Kodi's core handling and GUI management of binary addons<ref>http://github.com/xbmc/xbmc/pulls?q=label%3A%22Binary+Addons%22+is%3Aclosed</ref>
* Added framework to support VFS (Virtual File System) as binary addons<ref>http://github.com/xbmc/xbmc/pull/8966</ref>
* Added framework support for binary addons for video decoder codecs<ref name="Addon video codec implementation">https://github.com/xbmc/xbmc/pull/12340</ref>
* Added framework support for binary addons for image (picture) decoder codecs
* Added extentions to Kodi's Addons API to support binary addons for video decoder codecs<ref name="Addon video codec implementation"/>
* Added extentions to Kodi's Addons API to support binary addons for image decoder codecs
* Added support for Python addons to use PyCryptoDome crypto module for decryption<ref>https://github.com/xbmc/xbmc/pull/11477</ref>
* Added option to pass HTTP cookies with AVOption to Kodi's Video Player<ref>https://github.com/xbmc/xbmc/pull/12257</ref>
* Added support to allow addons to edit all used controls on their processed window<ref>https://github.com/xbmc/xbmc/pull/12259</ref>
* Added support to allow Python addons to set the videoinfotag path<ref>http://github.com/xbmc/xbmc/pull/11012</ref>
* Added support to allow Python addons to get/set the dbid of a (music) listitem<ref>http://github.com/xbmc/xbmc/pull/10858</ref>
* Added support for mediatype to musicinfotag tag retrieving via Python API<ref>http://github.com/xbmc/xbmc/pull/11110</ref>
* Added support "int/float slider" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11230</ref>
* Added support "setContent for mediawindows" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11258</ref>
* Added help for load of shared library and allow the use of their own addon temp folder<ref>https://github.com/xbmc/xbmc/pull/12379</ref>
* Added support to inspect add-on dependencies prior to installation<ref>https://github.com/xbmc/xbmc/pull/12242</ref>
* Added ability to remove add-on settings upon uninstall<ref>https://github.com/xbmc/xbmc/pull/11499</ref>
* Changed to new addon gui interface for list items to use on addon window<ref>https://github.com/xbmc/xbmc/pull/12214</ref>
* Changed service addons to use event handlers instead of synchronous addon hooks<ref>https://github.com/xbmc/xbmc/pull/12370</ref>
* Updated "Peripheral Addons" for game controllers, gamepads, joysticks, and input peripherals profiles (in Kodi-game repo<ref>http://github.com/kodi-game/ kodi-game repo on GitHub</ref>):
** [http://github.com/xbmc/peripheral.joystick Joystick Controller Addon]
** [http://github.com/kodi-game/peripheral.xarcade X-Arcade (XGaming Tankstick) support for Kodi Addon]
** [http://github.com/kodi-game/peripheral.steamcontroller Steam Controller (gamepad) Addon]
** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.default Default Game Controller Addon (reference game controller addon based on Xbox 360 gamepad)]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.ps PlayStation Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.nes Nintendo NES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.snes Nintendo SNES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.n64 Nintendo N64 Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.gba Nintendo GBA Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.genesis Sega Genesis Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.dreamcast Sega Dreamcast Game Controller Addon]
* ?

=== GUI Engine (Skinning Engine) ===
For full changelog on changes to the skinning engine, see [[Leia API changes]] and the [http://forum.kodi.tv/showthread.php?tid=298565 Skin Development Forum]
* Added windows to support Games and Game OSD in the new default skins (Estuary and Estouchy)
* Added player process info dialog to Kodi's default skin (Estuary)<ref>https://github.com/xbmc/xbmc/pull/11718</ref>
* Added support for addons to use banner and ClearLogo<ref>https://github.com/xbmc/xbmc/pull/12244</ref>
* Added support for skins/gui to allow implicit container referencing for non-media windows<ref>http://github.com/xbmc/xbmc/pull/10883</ref>
* Added support for addons to add "Enable/Disable" to context menu<ref>http://github.com/xbmc/xbmc/pull/11124</ref>
* Added support for remember last used keyboard layout in GUI<ref>http://github.com/xbmc/xbmc/pull/11242</ref>
* Added support for ISO 639-2/T language code retrieval (required by libbluray)<ref>https://github.com/xbmc/xbmc/pull/12258</ref>
* Added window that display Kodi privacy policy in GUI settings under system info<ref>https://github.com/xbmc/xbmc/pull/10785</ref>
* Added support to map a key to browse for subtitle in video fullscreen window<ref>https://github.com/xbmc/xbmc/pull/11649</ref>
* Improved Kodi's GUI engine with optimizations for message handling and SmartRedraw<ref>https://github.com/xbmc/xbmc/pull/12213</ref>
* Improved Kodi's GUI engine support for scaling container layouts<ref>http://github.com/xbmc/xbmc/pull/11229</ref>
* Improved Kodi's GUI engine by allowing %-values for origin, camera and animation attribs<ref>http://github.com/xbmc/xbmc/pull/11233</ref>
* Changed so that context menu reloading loads async to aviod GUI lockup on wait<ref>https://github.com/xbmc/xbmc/pull/11841</ref>
* Updated guilib ABI (for libgui) to version 5.13.0<ref>http://github.com/xbmc/xbmc/pull/11306</ref>
* Updated keyboard layout for some languages and added support Croatian, Slovenian, and Thai (Kedmanee)
* Updated image resource addons (as example weather icons, weather fanart, studio logos, and genre icons)
* ?

=== Platform Independent Playback ===
* Added support for "InputStream" (input stream) addons to pass CryptoSession flags field<ref>https://github.com/xbmc/xbmc/pull/12428</ref>
* Added support for BD-J / Blu-ray Disc Java menu support (requires system Java runtime enviroment)<ref>https://github.com/xbmc/xbmc/pull/12339</ref><ref>https://github.com/xbmc/xbmc/pull/12310</ref>
* Added support for Blu-ray Disc detection and use provided meta data for Blu-ray Disc names<ref>https://github.com/xbmc/xbmc/pull/12488</ref>
* Added support for video buffers to be used by decoders and renderers<ref name="VideoPlayer updates for Leia">https://github.com/xbmc/xbmc/pull/12212</ref>
** Added support for platforms to register custom buffers, like example dma<ref name="VideoPlayer updates for Leia"/>
* Added a VC1-Packet bitstream parser implementation for improved VC-1 playback<ref>http://github.com/xbmc/xbmc/pull/11417</ref>
* Added and updated many (binary) audio decoder and encoder addons for Kodi
* Added a few (binary) video decoder addons for Kodi<ref name="Addon video codec implementation"/>
* Added a "RAW" (libraw based) image decoder addon to Kodi<ref>https://github.com/xbmc/xbmc/pull/11671</ref>
* Improved MMAL playback of H.264 MVC (Blu-ray 3D) stereoscopic video with framepacking decoding on Raspberry Pi
* Improved Stereoscopic 3D playback of 3D videos (as well as better 2D playback of 3D videos)
* Improved and enhanced Blu-ray support (including updated libbluray dependecies from the VideoLAN project<ref>https://github.com/xbmc/xbmc/pull/12305</ref><ref>http://git.videolan.org/?p=libbluray.git;a=blob;f=ChangeLog</ref>
* Improved support for "InputStream" (input stream) addons as system addons
* Updated "InputStream" (input stream) client addons for common network streaming protocols and popular services:
** [http://github.com/xbmc/xbmc/tree/master/addons/kodi.inputstream InputStream Addon (default reference InputStream Addon by Team Kodi]
** [http://github.com/mapfau/inputstream.test Test InputStream Addon (Test InputStream Addon for Kodi's new inputstream interface]
** [http://github.com/peak3d/inputstream.adaptive Adaptive InputStream Addon (InputStream Client addon for several manifest types)]
** [http://github.com/xbmc/repo-binary-addons/tree/master/inputstream.rtmp RTMP InputStream Addon (InputStream Client for RTMP streams using librtmp)]
** [http://github.com/peak3d/inputstream.mpd MPD (MPEG-DASH) InputStream Addon]
** [http://github.com/peak3d/inputstream.smoothstream SmoothStream InputStream Addon for MS-SSTR (SmoothStreamingMedia) Smooth Streaming Protocol]
** [http://github.com/mapfau/inputstream.nxmsl NXMSL InputStream Addon for Netflix style manifests over MSL]
* Updated FFmpeg multimedia codec and demux libraries to stable branch release version [http://www.ffmpeg.org/download.html#release_3.3.2 FFmpeg 3.3 (3.3.2)]<ref>http://git.videolan.org/?p=ffmpeg.git;a=blob_plain;f=Changelog;hb=release/3.3.2 FFmpeg 3.3.2 release changelog</ref><ref>https://github.com/xbmc/xbmc/pull/12358</ref>
* Removed certain audio codecs from core and made them into audio decoder and audio encoder add-ons
* Removed certain video codecs from core and made them into video decoder add-ons<ref name="Addon video codec implementation"/>
* Removed certain image codecs from core and made them into image decoder add-ons
* ?

=== Library ===
* Addded support to use the Favourites function in context menus<ref>https://github.com/xbmc/xbmc/pull/11967</ref>
* Added support for context menus to favourites home screen widget<ref>https://github.com/xbmc/xbmc/pull/11929</ref>
* Added support for processing of WRITER tag for ID3 v2, Vorbis and APE formats<ref>https://github.com/xbmc/xbmc/pull/11735</ref>
* Added support for sorting using artist sort name tags in music<ref>https://github.com/xbmc/xbmc/pull/11738</ref>
* Added support to "Sort By Date Added" in Music Video title node<ref>https://github.com/xbmc/xbmc/pull/12495</ref>
* Changed to never cache listing of PVR directories on library scans<ref>https://github.com/xbmc/xbmc/pull/11761</ref>
* ?

=== Web Scrapers ===
* Added support for Python (script) based web scrapers for Kodi<ref>http://github.com/xbmc/xbmc/pull/9984</ref>
* Refactored and updated many XML based scrapers in Kodi for music, movies, tv shows, and music videos
* Updated music, movies, tv shows, and music video scrapers for Kodi
* ?

=== AudioEngine ===
* Added a new Sndio sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, other BSD Unix based systems, and Linux<ref>https://github.com/xbmc/xbmc/pull/11962</ref>
* Improved the default cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] (Kodi's [[AudioEngine]])
* Improved ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems
* Improved PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop
* Improved OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD and similar BSD Unix based systems
* Improved AUDIOTRACK sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Amlogic]]
* Improved Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]
* Improved DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved CoreAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* Improved Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* ?

=== Other ===
* Added a new unified setting for "Startup action" and added "Play TV/Radio"<ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Added support to build Kodi with support for Bluetooth<ref>http://github.com/xbmc/xbmc/pull/11137</ref>
* Added possibility for CMake build system to add additional libraries on install<ref>https://github.com/xbmc/xbmc/pull/12423</ref>
* Updated and improved mappings for new and existing remote controls
* Improved Kodi's JSON-RPC API
* Improved compiling/building and code documentation (following doxygen coding guidelines)
* Changed to use spdlog for Kodi logging as well as improved and further optimized logging (including debug logs)<ref>https://github.com/xbmc/xbmc/pull/11833</ref>
* Changed XML format of setting values for Kodi's settings configuration<ref>https://github.com/xbmc/xbmc/pull/12277</ref>
* Updated default web interface (webinterface is called "Chorus2" and is currently at version 2.4.4)<ref>https://github.com/xbmc/xbmc/pull/11872</ref>
* Updated critical dependency libraries such as openssl, gnutls, and CMake (used to compile Kodi and its binary addons)
* Removed last dependencies of SDL (Simple DirectMedia Layer) which was hardware abstraction for input devices<ref>https://github.com/xbmc/xbmc/pull/12272</ref><ref>https://github.com/xbmc/xbmc/pull/11881</ref>
* Removed all glew (libglew library) dependencies in Kodi's code<ref>http://github.com/xbmc/xbmc/pull/11128</ref>
* ?

=== Android Specific ===
* Added support for speech-to-text in Kodi OSD keyboard on Android TV (triggered by voice button on remote)
* Added support for Android to move the Kodi app to SD card<ref>https://github.com/xbmc/xbmc/pull/12168</ref>
* Added support for Android TV Leanback search and recommendations meta data from Kodi<ref>|https://github.com/xbmc/xbmc/pull/11901</ref>
** Default setting for Android TV Leanback suggestion to random unwatched movies and music albums<ref>https://github.com/xbmc/xbmc/pull/11963</ref>
* Moved to Android NDK 14b
* Changed Rendertype from GUILayer to VideoLayer for Android MediaCodecSurface<ref>https://github.com/xbmc/xbmc/pull/12097</ref>
* Changed to use NDK native C interface for Android MediaCodec (for performance gains)<ref>https://github.com/xbmc/xbmc/pull/11931</ref>
* Changed to support ZeroConf via native Android API (and deprecates mDNSresponder)<ref>http://github.com/xbmc/xbmc/pull/11393</ref>
* Changed to support network information via native Android API (and deprecates POSIX)<ref>https://github.com/xbmc/xbmc/pull/12243</ref>
* Changed handling of Kodi's Java interfaces via JNI for better consistency<ref>https://github.com/xbmc/xbmc/pull/12292</ref>
* ?

=== BSD Specific ===
* Improved Kodi support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* ?

=== Linux Specific ===
* Added support for a generic DRM/KMS implementation using GBM to create required surfaces<ref>https://github.com/xbmc/xbmc/pull/11955</ref>
* Added support for Mir windowing system (Mir 1.0) for Kodi<ref>http://github.com/xbmc/xbmc/pull/10898</ref> and added support for VAAPI on Mir using DRM<ref>http://github.com/xbmc/xbmc/pull/11040</ref>
* Added support for the middle mouse button on embedded platforms<ref>https://github.com/xbmc/xbmc/pull/11956</ref>
* Added support more yuv420p bitwidths for direct rendering on Linux<ref>https://github.com/xbmc/xbmc/pull/12479</ref>
* Added support for using VAAPI hardware video decoding with OpenGL ES<ref>https://github.com/xbmc/xbmc/pull/12113</ref>
* Added support for build Kodi with imx support using CMake<ref>http://github.com/xbmc/xbmc/pull/11288</ref>
* Moved the CMake build system to the top of the code tree (moved to root)<ref>http://github.com/xbmc/xbmc/pull/10446</ref>
* Improved support for UltraHD decoding / 4K resolution output when hardware supports it
* Improved ARM processor architecture (using [[Raspberry Pi]] as reference device)
* Improved OpenGL ES and EGL support (using [[Raspberry Pi]] as reference device)
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* Improved XvBA (AMD/ATI) Hardware Video Acceleration (requires XvBA compatible hardware and drivers)
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on Amlogic devices
* Removed the unused and unmaintained OpenMAX video decoder from Kodi's VideoPlayer<ref>https://github.com/xbmc/xbmc/pull/12197</ref>
* Removed support for autotools based build system for Kodi and binary addons (in favour of CMake)<ref>http://github.com/xbmc/xbmc/pull/10429</ref>
* ?

=== iOS Specific ===
* Added support for iOS 10.0 by adding support for compiling Kodi with Xcode 8 IDE and iOS SDK 10.0<ref>https://github.com/xbmc/xbmc/pull/10539</ref>
* Improved Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)
* Improved support for TVOS (Apple's iOS fork for Apple TV 4) in Kodi mainline
* Improved support for iOS on ARM64 (64-bit iOS)
* ?

=== OS X Specific ===
* Added support for compiling Kodi with Xcode 8 IDE for OSX 10.11 (El Capitan) and macOS 10.12 (Sierra)
* Improved Apple VDADecoder Video Acceleration support for (Mac) OS X
* ?

=== Windows Specific ===
* Added support to build Kodi for Windows 64 / Windows for Intel 64-bit (x86-64)<ref>https://github.com/xbmc/xbmc/pull/12065</ref>
* Added support for 3D LUT (3D Lookup Table) and dithering to Windows video renderer<ref name="WinRenderer re-work">https://github.com/xbmc/xbmc/pull/12475</ref>
* Improved support to compiling Kodi for Microsoft's UWP (Universal Windows Platform) APIs
* Changed the inner working of render buffers and rendering methods<ref name="WinRenderer re-work"/>
* Changed to using unicode win32 api methods<ref>https://github.com/xbmc/xbmc/pull/11780</ref>
* Changed windowing systems for screen saver handling on Windows OS platforms
* Changed to make Kodi for Windows platform independent of posix/main.cpp<ref>https://github.com/xbmc/xbmc/pull/12215</ref>
* Removed support for Windows Vista as the operating-system is no longer supported by Microsoft<ref>https://github.com/xbmc/xbmc/pull/11953</ref>
* ?

== References ==
<references/>

== See also ==
* [[Leia API changes]]
{{Changelogs}}

[[Category:Manual]]
[[Category:Leia|*]]
[[Category:Changelogs|18]]

Kodi v18 (Leia) changelog

2018-01-25T15:46:21Z

Ksooo: /* Live TV and PVR (Personal Video Recorder) */

{{mininav|[[Releases]] {{l2| [[Leia]] }} }}

{{notice|Kodi v17 (Krypton) final has just been released, so please keep in mind that a final non-alpha/beta v18 (Leia) release is still far far away into the future. As such, these new features/functions and API changes is a placeholder containing changes to the current Kodi mainline (the git master tree repository on GitHub). It is a very much a work in progress, this is only listing changes commited to the master branch after Jarvis branching, and many many many features/functions and API additions, alterations or removal are still subject to future change.}}
{{incomplete}}
{{future|18}}

{{see also|Kodi v18 (Leia) FAQ|Leia API changes|Releases}}

This is a placeholder and Kodi Wiki copy of the condensed changelog for the future Kodi v18.x version (codename: "Leia") releases with a summery of the most important core features and functions as well as other notable changes to key areas of the application software or its user interface.

== Changelog ==

=== Gaming (Games interface and Game Clients)===
* Added a RetroPlayer player core supporting game clients as well as emulator cores via libretro API<ref name="RetroPlayer">RetroPlayer http://forum.kodi.tv/showthread.php?tid=164725</ref><ref>http://github.com/xbmc/xbmc/pull/11022</ref>
* Added extentions to Kodi's Addons AP to support Game Client Addons, supporting Kodi's VFS (Virtual File System), etc.<ref name="RetroPlayer"/>
* Added support for Game Client Addons as new type of addons with just-in-time emulator installation<ref name="RetroPlayer"/>
* Added a Games window and Game OSD (On-Screen-Display) entries to the GUI<ref name="RetroPlayer"/><ref>https://github.com/xbmc/xbmc/pull/12367</ref>
* Added a gaming and game configuration interface for Game settings to the GUI<ref name="RetroPlayer"/>
* Added support for Game Info Tags (game info tag) and exposed properties to Python list items<ref name="RetroPlayer"/>
* Added a savestate (savestate) manager to Kodi for games<ref>http://github.com/xbmc/xbmc/pull/11034</ref>
* Added initial support for basic gameplay persistence (auto-save & auto-load)<ref>https://github.com/xbmc/xbmc/pull/12434</ref>
* Added support for in-game (save RAM) saves<ref>http://github.com/xbmc/xbmc/pull/11380</ref>
* Added support for Keyboard players via Joystick Emulation<ref name="RetroPlayer"/>
* Added support for libretro API and game cores (emulators and games) that support it
* Added [[Game_Add-ons|game clients addons]] for many popular third-party game console emulators and native open source games *
** ''* [[Game_Add-ons|Game clients addons]] for Kodi is changing quickly so checkout the [[Game_Add-ons|game clients addons]] article for a current list''
* ?

=== Live TV and PVR (Personal Video Recorder) ===
* Major GUI actions refactoring to eliminate duplicate and dead code. Add context menu support for Estuary PVR home screen widgets <ref>https://github.com/xbmc/xbmc/pull/10870</ref>
* Guide window: Get rid of obsolete views "channel", "now" and "next" <ref>https://github.com/xbmc/xbmc/pull/10838</ref>
* Core: Refactor and fix "play minimized" settings handling <ref>https://github.com/xbmc/xbmc/pull/11203</ref>
* Guide, channel, video fullscreen, music visualisation window: Direct channel number input. <ref>https://github.com/xbmc/xbmc/pull/11434</ref>
* Settings: Remove setting 'hide connection lost warning' <ref>https://github.com/xbmc/xbmc/pull/11500</ref>
* Search dialog: Refactor and complete implementation of EPG search filter <ref>https://github.com/xbmc/xbmc/pull/11570</ref>
* Timer settings dialog: Prefill recordings folder with timer title <ref>https://github.com/xbmc/xbmc/pull/11679</ref>
* Recordings window: Content view filter <ref>https://github.com/xbmc/xbmc/pull/11704</ref>
* Settings: Remove non-working recording settings defaults <ref>https://github.com/xbmc/xbmc/pull/11746</ref>
* Guide window: 'Smart selection' of epg events. <ref>https://github.com/xbmc/xbmc/pull/11782</ref>
* Channelgroup manager: Add support for radio channel groups <ref>https://github.com/xbmc/xbmc/pull/11877</ref>
* Guide window: Add possibility to switch between horizontal and vertical epg grid view <ref>https://github.com/xbmc/xbmc/pull/11958</ref>
* Search window: improvements and fixes <ref>https://github.com/xbmc/xbmc/pull/12001</ref>
* Estuary home screen: Add Info support to recently played channel widget <ref>https://github.com/xbmc/xbmc/pull/12254</ref>
* Estuary: Add episodename to live tv and recordings osd sub label, cleanup seek bar for live tv <ref>https://github.com/xbmc/xbmc/pull/12306</ref>
* Estuary: PVR info dialog, recordings window: cleanup and extend <ref>https://github.com/xbmc/xbmc/pull/12416</ref>
* Drop 'channel guide' button from epg event info dialog, add 'channel guide' to context menu <ref>https://github.com/xbmc/xbmc/pull/12526</ref>
* Settings: Introduce new setting 'Startup action' and add 'Play TV/Radio <ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Settings: Make 'epg.lingertime' an official setting, remove the respective advanced setting <ref>https://github.com/xbmc/xbmc/pull/12740</ref>
* Setting: Remove obsolete and unused setting 'pvrplayback.scantime' <ref>https://github.com/xbmc/xbmc/pull/12800</ref>
* Core: Fixes/Improvements for multiple enable PVR client addons <ref>https://github.com/xbmc/xbmc/pull/12959</ref>
* Core: Fixes/Improvements for subchannel numbers support (ATSC) <ref>https://github.com/xbmc/xbmc/pull/13069</ref>
* Core: Global direct channel number input & global unique channel numbers <ref>https://github.com/xbmc/xbmc/pull/13135</ref>
* Database: Fix error "Abort due to constraint violation. Query: INSERT INTO channels..." <ref>https://github.com/xbmc/xbmc/pull/13150</ref>
* Estuary: Rework PVR seekbar + Fix PVR info dialog <ref>https://github.com/xbmc/xbmc/pull/13158</ref>
* Core: Make next/previous chapter work for PVR recordings <ref>https://github.com/xbmc/xbmc/pull/13164</ref>
* Direct channel number input: No delay on switch to previous channel with key 0 <ref>https://github.com/xbmc/xbmc/pull/13232</ref>
* Settings: Make shared channel selection optional <ref>https://github.com/xbmc/xbmc/pull/13237</ref>
* Estuary: PVR info panel cleanup <ref>https://github.com/xbmc/xbmc/pull/13255</ref>
* Guide window: 'Go to date' context menu item <ref>https://github.com/xbmc/xbmc/pull/13282</ref>
* Estuary: Season/Episode info in Guide window and dialog <ref>https://github.com/xbmc/xbmc/pull/13300</ref>
* Estuary: Add percent played progress bar to PVR info panel (for recordings) <ref>https://github.com/xbmc/xbmc/pull/13338</ref>
* Guide window: Channel groups selector <ref>https://github.com/xbmc/xbmc/pull/13364</ref>
* Guide window: Tweaks for more consistency and readability <ref>https://github.com/xbmc/xbmc/pull/13402</ref>
* PVR-Addon API changes <ref>https://github.com/xbmc/xbmc/pull/12028</ref><ref>https://github.com/xbmc/xbmc/pull/12303</ref><ref>https://github.com/xbmc/xbmc/pull/12552</ref><ref>https://github.com/xbmc/xbmc/pull/12609</ref><ref>https://github.com/xbmc/xbmc/pull/12660</ref><ref>https://github.com/xbmc/xbmc/pull/12689</ref><ref>https://github.com/xbmc/xbmc/pull/12755</ref><ref>https://github.com/xbmc/xbmc/pull/13228</ref>
* Added, updated, and improved PVR backend clients addons for all popular third-party external [[PVR backend]] platforms:
** [[Add-on:PVR Demo Client|PVR Demo Client]] dummy addon with fake (method stub) [[PVR backend]] for [[PVR]] skinning and regression testing
** [[Add-on:IPTV Simple Client|IPTV Simple Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:HDHomeRun PVR|HDHomeRun]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Digital Devices Octopus NET Client|Digital Devices Octopus NET Client]] PVR Addon backend client maintained and made available by [http://digitaldevices.de/home/ Digital Devices]
** New: [[Add-on:Zattoo PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** New: [[Add-on:Teleboy PVR Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VU+ / Enigma2 Client|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Njoy N7 PVR Client|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VDR VNSI Client|VDR VNSI Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MythTV PVR Client|MythTV PVR Client]] Addon backend client maintained and available from the Kodi's community
** [[Add-on:NextPVR PVR Client|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Argus TV Client|Argus TV (former ForTheRecord)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBLink PVR Client|DVBLink PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBViewer Client|DVBViewer Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MediaPortal PVR Client|MediaPortal PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community
* ?

=== Add-ons Framework, API, and Manager ===
For full changelogs of all Addons APIs, see [[Leia API changes]], [http://forum.kodi.tv/forumdisplay.php?fid=174 JSON-RPC], and [http://forum.kodi.tv/forumdisplay.php?fid=26 Add-ons] Development Forums
* Major refactoring of Kodi's core handling and GUI management of binary addons<ref>http://github.com/xbmc/xbmc/pulls?q=label%3A%22Binary+Addons%22+is%3Aclosed</ref>
* Added framework to support VFS (Virtual File System) as binary addons<ref>http://github.com/xbmc/xbmc/pull/8966</ref>
* Added framework support for binary addons for video decoder codecs<ref name="Addon video codec implementation">https://github.com/xbmc/xbmc/pull/12340</ref>
* Added framework support for binary addons for image (picture) decoder codecs
* Added extentions to Kodi's Addons API to support binary addons for video decoder codecs<ref name="Addon video codec implementation"/>
* Added extentions to Kodi's Addons API to support binary addons for image decoder codecs
* Added support for Python addons to use PyCryptoDome crypto module for decryption<ref>https://github.com/xbmc/xbmc/pull/11477</ref>
* Added option to pass HTTP cookies with AVOption to Kodi's Video Player<ref>https://github.com/xbmc/xbmc/pull/12257</ref>
* Added support to allow addons to edit all used controls on their processed window<ref>https://github.com/xbmc/xbmc/pull/12259</ref>
* Added support to allow Python addons to set the videoinfotag path<ref>http://github.com/xbmc/xbmc/pull/11012</ref>
* Added support to allow Python addons to get/set the dbid of a (music) listitem<ref>http://github.com/xbmc/xbmc/pull/10858</ref>
* Added support for mediatype to musicinfotag tag retrieving via Python API<ref>http://github.com/xbmc/xbmc/pull/11110</ref>
* Added support "int/float slider" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11230</ref>
* Added support "setContent for mediawindows" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11258</ref>
* Added help for load of shared library and allow the use of their own addon temp folder<ref>https://github.com/xbmc/xbmc/pull/12379</ref>
* Added support to inspect add-on dependencies prior to installation<ref>https://github.com/xbmc/xbmc/pull/12242</ref>
* Added ability to remove add-on settings upon uninstall<ref>https://github.com/xbmc/xbmc/pull/11499</ref>
* Changed to new addon gui interface for list items to use on addon window<ref>https://github.com/xbmc/xbmc/pull/12214</ref>
* Changed service addons to use event handlers instead of synchronous addon hooks<ref>https://github.com/xbmc/xbmc/pull/12370</ref>
* Updated "Peripheral Addons" for game controllers, gamepads, joysticks, and input peripherals profiles (in Kodi-game repo<ref>http://github.com/kodi-game/ kodi-game repo on GitHub</ref>):
** [http://github.com/xbmc/peripheral.joystick Joystick Controller Addon]
** [http://github.com/kodi-game/peripheral.xarcade X-Arcade (XGaming Tankstick) support for Kodi Addon]
** [http://github.com/kodi-game/peripheral.steamcontroller Steam Controller (gamepad) Addon]
** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.default Default Game Controller Addon (reference game controller addon based on Xbox 360 gamepad)]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.ps PlayStation Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.nes Nintendo NES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.snes Nintendo SNES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.n64 Nintendo N64 Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.gba Nintendo GBA Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.genesis Sega Genesis Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.dreamcast Sega Dreamcast Game Controller Addon]
* ?

=== GUI Engine (Skinning Engine) ===
For full changelog on changes to the skinning engine, see [[Leia API changes]] and the [http://forum.kodi.tv/showthread.php?tid=298565 Skin Development Forum]
* Added windows to support Games and Game OSD in the new default skins (Estuary and Estouchy)
* Added player process info dialog to Kodi's default skin (Estuary)<ref>https://github.com/xbmc/xbmc/pull/11718</ref>
* Added support for addons to use banner and ClearLogo<ref>https://github.com/xbmc/xbmc/pull/12244</ref>
* Added support for skins/gui to allow implicit container referencing for non-media windows<ref>http://github.com/xbmc/xbmc/pull/10883</ref>
* Added support for addons to add "Enable/Disable" to context menu<ref>http://github.com/xbmc/xbmc/pull/11124</ref>
* Added support for remember last used keyboard layout in GUI<ref>http://github.com/xbmc/xbmc/pull/11242</ref>
* Added support for ISO 639-2/T language code retrieval (required by libbluray)<ref>https://github.com/xbmc/xbmc/pull/12258</ref>
* Added window that display Kodi privacy policy in GUI settings under system info<ref>https://github.com/xbmc/xbmc/pull/10785</ref>
* Added support to map a key to browse for subtitle in video fullscreen window<ref>https://github.com/xbmc/xbmc/pull/11649</ref>
* Improved Kodi's GUI engine with optimizations for message handling and SmartRedraw<ref>https://github.com/xbmc/xbmc/pull/12213</ref>
* Improved Kodi's GUI engine support for scaling container layouts<ref>http://github.com/xbmc/xbmc/pull/11229</ref>
* Improved Kodi's GUI engine by allowing %-values for origin, camera and animation attribs<ref>http://github.com/xbmc/xbmc/pull/11233</ref>
* Changed so that context menu reloading loads async to aviod GUI lockup on wait<ref>https://github.com/xbmc/xbmc/pull/11841</ref>
* Updated guilib ABI (for libgui) to version 5.13.0<ref>http://github.com/xbmc/xbmc/pull/11306</ref>
* Updated keyboard layout for some languages and added support Croatian, Slovenian, and Thai (Kedmanee)
* Updated image resource addons (as example weather icons, weather fanart, studio logos, and genre icons)
* ?

=== Platform Independent Playback ===
* Added support for "InputStream" (input stream) addons to pass CryptoSession flags field<ref>https://github.com/xbmc/xbmc/pull/12428</ref>
* Added support for BD-J / Blu-ray Disc Java menu support (requires system Java runtime enviroment)<ref>https://github.com/xbmc/xbmc/pull/12339</ref><ref>https://github.com/xbmc/xbmc/pull/12310</ref>
* Added support for Blu-ray Disc detection and use provided meta data for Blu-ray Disc names<ref>https://github.com/xbmc/xbmc/pull/12488</ref>
* Added support for video buffers to be used by decoders and renderers<ref name="VideoPlayer updates for Leia">https://github.com/xbmc/xbmc/pull/12212</ref>
** Added support for platforms to register custom buffers, like example dma<ref name="VideoPlayer updates for Leia"/>
* Added a VC1-Packet bitstream parser implementation for improved VC-1 playback<ref>http://github.com/xbmc/xbmc/pull/11417</ref>
* Added and updated many (binary) audio decoder and encoder addons for Kodi
* Added a few (binary) video decoder addons for Kodi<ref name="Addon video codec implementation"/>
* Added a "RAW" (libraw based) image decoder addon to Kodi<ref>https://github.com/xbmc/xbmc/pull/11671</ref>
* Improved MMAL playback of H.264 MVC (Blu-ray 3D) stereoscopic video with framepacking decoding on Raspberry Pi
* Improved Stereoscopic 3D playback of 3D videos (as well as better 2D playback of 3D videos)
* Improved and enhanced Blu-ray support (including updated libbluray dependecies from the VideoLAN project<ref>https://github.com/xbmc/xbmc/pull/12305</ref><ref>http://git.videolan.org/?p=libbluray.git;a=blob;f=ChangeLog</ref>
* Improved support for "InputStream" (input stream) addons as system addons
* Updated "InputStream" (input stream) client addons for common network streaming protocols and popular services:
** [http://github.com/xbmc/xbmc/tree/master/addons/kodi.inputstream InputStream Addon (default reference InputStream Addon by Team Kodi]
** [http://github.com/mapfau/inputstream.test Test InputStream Addon (Test InputStream Addon for Kodi's new inputstream interface]
** [http://github.com/peak3d/inputstream.adaptive Adaptive InputStream Addon (InputStream Client addon for several manifest types)]
** [http://github.com/xbmc/repo-binary-addons/tree/master/inputstream.rtmp RTMP InputStream Addon (InputStream Client for RTMP streams using librtmp)]
** [http://github.com/peak3d/inputstream.mpd MPD (MPEG-DASH) InputStream Addon]
** [http://github.com/peak3d/inputstream.smoothstream SmoothStream InputStream Addon for MS-SSTR (SmoothStreamingMedia) Smooth Streaming Protocol]
** [http://github.com/mapfau/inputstream.nxmsl NXMSL InputStream Addon for Netflix style manifests over MSL]
* Updated FFmpeg multimedia codec and demux libraries to stable branch release version [http://www.ffmpeg.org/download.html#release_3.3.2 FFmpeg 3.3 (3.3.2)]<ref>http://git.videolan.org/?p=ffmpeg.git;a=blob_plain;f=Changelog;hb=release/3.3.2 FFmpeg 3.3.2 release changelog</ref><ref>https://github.com/xbmc/xbmc/pull/12358</ref>
* Removed certain audio codecs from core and made them into audio decoder and audio encoder add-ons
* Removed certain video codecs from core and made them into video decoder add-ons<ref name="Addon video codec implementation"/>
* Removed certain image codecs from core and made them into image decoder add-ons
* ?

=== Library ===
* Addded support to use the Favourites function in context menus<ref>https://github.com/xbmc/xbmc/pull/11967</ref>
* Added support for context menus to favourites home screen widget<ref>https://github.com/xbmc/xbmc/pull/11929</ref>
* Added support for processing of WRITER tag for ID3 v2, Vorbis and APE formats<ref>https://github.com/xbmc/xbmc/pull/11735</ref>
* Added support for sorting using artist sort name tags in music<ref>https://github.com/xbmc/xbmc/pull/11738</ref>
* Added support to "Sort By Date Added" in Music Video title node<ref>https://github.com/xbmc/xbmc/pull/12495</ref>
* Changed to never cache listing of PVR directories on library scans<ref>https://github.com/xbmc/xbmc/pull/11761</ref>
* ?

=== Web Scrapers ===
* Added support for Python (script) based web scrapers for Kodi<ref>http://github.com/xbmc/xbmc/pull/9984</ref>
* Refactored and updated many XML based scrapers in Kodi for music, movies, tv shows, and music videos
* Updated music, movies, tv shows, and music video scrapers for Kodi
* ?

=== AudioEngine ===
* Added a new Sndio sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, other BSD Unix based systems, and Linux<ref>https://github.com/xbmc/xbmc/pull/11962</ref>
* Improved the default cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] (Kodi's [[AudioEngine]])
* Improved ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems
* Improved PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop
* Improved OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD and similar BSD Unix based systems
* Improved AUDIOTRACK sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Amlogic]]
* Improved Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]
* Improved DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved CoreAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* Improved Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* ?

=== Other ===
* Added a new unified setting for "Startup action" and added "Play TV/Radio"<ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Added support to build Kodi with support for Bluetooth<ref>http://github.com/xbmc/xbmc/pull/11137</ref>
* Added possibility for CMake build system to add additional libraries on install<ref>https://github.com/xbmc/xbmc/pull/12423</ref>
* Updated and improved mappings for new and existing remote controls
* Improved Kodi's JSON-RPC API
* Improved compiling/building and code documentation (following doxygen coding guidelines)
* Changed to use spdlog for Kodi logging as well as improved and further optimized logging (including debug logs)<ref>https://github.com/xbmc/xbmc/pull/11833</ref>
* Changed XML format of setting values for Kodi's settings configuration<ref>https://github.com/xbmc/xbmc/pull/12277</ref>
* Updated default web interface (webinterface is called "Chorus2" and is currently at version 2.4.4)<ref>https://github.com/xbmc/xbmc/pull/11872</ref>
* Updated critical dependency libraries such as openssl, gnutls, and CMake (used to compile Kodi and its binary addons)
* Removed last dependencies of SDL (Simple DirectMedia Layer) which was hardware abstraction for input devices<ref>https://github.com/xbmc/xbmc/pull/12272</ref><ref>https://github.com/xbmc/xbmc/pull/11881</ref>
* Removed all glew (libglew library) dependencies in Kodi's code<ref>http://github.com/xbmc/xbmc/pull/11128</ref>
* ?

=== Android Specific ===
* Added support for speech-to-text in Kodi OSD keyboard on Android TV (triggered by voice button on remote)
* Added support for Android to move the Kodi app to SD card<ref>https://github.com/xbmc/xbmc/pull/12168</ref>
* Added support for Android TV Leanback search and recommendations meta data from Kodi<ref>|https://github.com/xbmc/xbmc/pull/11901</ref>
** Default setting for Android TV Leanback suggestion to random unwatched movies and music albums<ref>https://github.com/xbmc/xbmc/pull/11963</ref>
* Moved to Android NDK 14b
* Changed Rendertype from GUILayer to VideoLayer for Android MediaCodecSurface<ref>https://github.com/xbmc/xbmc/pull/12097</ref>
* Changed to use NDK native C interface for Android MediaCodec (for performance gains)<ref>https://github.com/xbmc/xbmc/pull/11931</ref>
* Changed to support ZeroConf via native Android API (and deprecates mDNSresponder)<ref>http://github.com/xbmc/xbmc/pull/11393</ref>
* Changed to support network information via native Android API (and deprecates POSIX)<ref>https://github.com/xbmc/xbmc/pull/12243</ref>
* Changed handling of Kodi's Java interfaces via JNI for better consistency<ref>https://github.com/xbmc/xbmc/pull/12292</ref>
* ?

=== BSD Specific ===
* Improved Kodi support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* ?

=== Linux Specific ===
* Added support for a generic DRM/KMS implementation using GBM to create required surfaces<ref>https://github.com/xbmc/xbmc/pull/11955</ref>
* Added support for Mir windowing system (Mir 1.0) for Kodi<ref>http://github.com/xbmc/xbmc/pull/10898</ref> and added support for VAAPI on Mir using DRM<ref>http://github.com/xbmc/xbmc/pull/11040</ref>
* Added support for the middle mouse button on embedded platforms<ref>https://github.com/xbmc/xbmc/pull/11956</ref>
* Added support more yuv420p bitwidths for direct rendering on Linux<ref>https://github.com/xbmc/xbmc/pull/12479</ref>
* Added support for using VAAPI hardware video decoding with OpenGL ES<ref>https://github.com/xbmc/xbmc/pull/12113</ref>
* Added support for build Kodi with imx support using CMake<ref>http://github.com/xbmc/xbmc/pull/11288</ref>
* Moved the CMake build system to the top of the code tree (moved to root)<ref>http://github.com/xbmc/xbmc/pull/10446</ref>
* Improved support for UltraHD decoding / 4K resolution output when hardware supports it
* Improved ARM processor architecture (using [[Raspberry Pi]] as reference device)
* Improved OpenGL ES and EGL support (using [[Raspberry Pi]] as reference device)
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* Improved XvBA (AMD/ATI) Hardware Video Acceleration (requires XvBA compatible hardware and drivers)
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on Amlogic devices
* Removed the unused and unmaintained OpenMAX video decoder from Kodi's VideoPlayer<ref>https://github.com/xbmc/xbmc/pull/12197</ref>
* Removed support for autotools based build system for Kodi and binary addons (in favour of CMake)<ref>http://github.com/xbmc/xbmc/pull/10429</ref>
* ?

=== iOS Specific ===
* Added support for iOS 10.0 by adding support for compiling Kodi with Xcode 8 IDE and iOS SDK 10.0<ref>https://github.com/xbmc/xbmc/pull/10539</ref>
* Improved Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)
* Improved support for TVOS (Apple's iOS fork for Apple TV 4) in Kodi mainline
* Improved support for iOS on ARM64 (64-bit iOS)
* ?

=== OS X Specific ===
* Added support for compiling Kodi with Xcode 8 IDE for OSX 10.11 (El Capitan) and macOS 10.12 (Sierra)
* Improved Apple VDADecoder Video Acceleration support for (Mac) OS X
* ?

=== Windows Specific ===
* Added support to build Kodi for Windows 64 / Windows for Intel 64-bit (x86-64)<ref>https://github.com/xbmc/xbmc/pull/12065</ref>
* Added support for 3D LUT (3D Lookup Table) and dithering to Windows video renderer<ref name="WinRenderer re-work">https://github.com/xbmc/xbmc/pull/12475</ref>
* Improved support to compiling Kodi for Microsoft's UWP (Universal Windows Platform) APIs
* Changed the inner working of render buffers and rendering methods<ref name="WinRenderer re-work"/>
* Changed to using unicode win32 api methods<ref>https://github.com/xbmc/xbmc/pull/11780</ref>
* Changed windowing systems for screen saver handling on Windows OS platforms
* Changed to make Kodi for Windows platform independent of posix/main.cpp<ref>https://github.com/xbmc/xbmc/pull/12215</ref>
* Removed support for Windows Vista as the operating-system is no longer supported by Microsoft<ref>https://github.com/xbmc/xbmc/pull/11953</ref>
* ?

== References ==
<references/>

== See also ==
* [[Leia API changes]]
{{Changelogs}}

[[Category:Manual]]
[[Category:Leia|*]]
[[Category:Changelogs|18]]

Kodi v18 (Leia) changelog

2018-01-25T15:43:05Z

Ksooo:

{{mininav|[[Releases]] {{l2| [[Leia]] }} }}

{{notice|Kodi v17 (Krypton) final has just been released, so please keep in mind that a final non-alpha/beta v18 (Leia) release is still far far away into the future. As such, these new features/functions and API changes is a placeholder containing changes to the current Kodi mainline (the git master tree repository on GitHub). It is a very much a work in progress, this is only listing changes commited to the master branch after Jarvis branching, and many many many features/functions and API additions, alterations or removal are still subject to future change.}}
{{incomplete}}
{{future|18}}

{{see also|Kodi v18 (Leia) FAQ|Leia API changes|Releases}}

This is a placeholder and Kodi Wiki copy of the condensed changelog for the future Kodi v18.x version (codename: "Leia") releases with a summery of the most important core features and functions as well as other notable changes to key areas of the application software or its user interface.

== Changelog ==

=== Gaming (Games interface and Game Clients)===
* Added a RetroPlayer player core supporting game clients as well as emulator cores via libretro API<ref name="RetroPlayer">RetroPlayer http://forum.kodi.tv/showthread.php?tid=164725</ref><ref>http://github.com/xbmc/xbmc/pull/11022</ref>
* Added extentions to Kodi's Addons AP to support Game Client Addons, supporting Kodi's VFS (Virtual File System), etc.<ref name="RetroPlayer"/>
* Added support for Game Client Addons as new type of addons with just-in-time emulator installation<ref name="RetroPlayer"/>
* Added a Games window and Game OSD (On-Screen-Display) entries to the GUI<ref name="RetroPlayer"/><ref>https://github.com/xbmc/xbmc/pull/12367</ref>
* Added a gaming and game configuration interface for Game settings to the GUI<ref name="RetroPlayer"/>
* Added support for Game Info Tags (game info tag) and exposed properties to Python list items<ref name="RetroPlayer"/>
* Added a savestate (savestate) manager to Kodi for games<ref>http://github.com/xbmc/xbmc/pull/11034</ref>
* Added initial support for basic gameplay persistence (auto-save & auto-load)<ref>https://github.com/xbmc/xbmc/pull/12434</ref>
* Added support for in-game (save RAM) saves<ref>http://github.com/xbmc/xbmc/pull/11380</ref>
* Added support for Keyboard players via Joystick Emulation<ref name="RetroPlayer"/>
* Added support for libretro API and game cores (emulators and games) that support it
* Added [[Game_Add-ons|game clients addons]] for many popular third-party game console emulators and native open source games *
** ''* [[Game_Add-ons|Game clients addons]] for Kodi is changing quickly so checkout the [[Game_Add-ons|game clients addons]] article for a current list''
* ?

=== Live TV and PVR (Personal Video Recorder) ===
* Major GUI actions refactoring to eliminate duplicate and dead code. Add context menu support for Estuary PVR home screen widgets <ref>https://github.com/xbmc/xbmc/pull/10870</ref>
* Guide window: Get rid of obsolete views "channel", "now" and "next" <ref>https://github.com/xbmc/xbmc/pull/10838</ref>
* Core: Refactor and fix "play minimized" settings handling <ref>https://github.com/xbmc/xbmc/pull/11203</ref>
* Guide, channel, video fullscreen, music visualisation window: Direct channel number input. <ref>https://github.com/xbmc/xbmc/pull/11434</ref>
* Settings: Remove setting 'hide connection lost warning' <ref>https://github.com/xbmc/xbmc/pull/11500</ref>
* Search dialog: Refactor and complete implementation of EPG search filter <ref>https://github.com/xbmc/xbmc/pull/11570</ref>
* Timer settings dialog: Prefill recordings folder with timer title <ref>https://github.com/xbmc/xbmc/pull/11679</ref>
* Recordings window: Content view filter <ref>https://github.com/xbmc/xbmc/pull/11704</ref>
* Settings: Remove non-working recording settings defaults <ref>https://github.com/xbmc/xbmc/pull/11746</ref>
* Guide window: 'Smart selection' of epg events. <ref>https://github.com/xbmc/xbmc/pull/11782</ref>
* Channelgroup manager: Add support for radio channel groups <ref>https://github.com/xbmc/xbmc/pull/11877</ref>
* Guide window: Add possibility to switch between horizontal and vertical epg grid view <ref>https://github.com/xbmc/xbmc/pull/11958</ref>
* Search window: improvements and fixes <ref>https://github.com/xbmc/xbmc/pull/12001</ref>
* Estuary home screen: Add Info support to recently played channel widget <ref>https://github.com/xbmc/xbmc/pull/12254</ref>
* Estuary: Add episodename to live tv and recordings osd sub label, cleanup seek bar for live tv <ref>https://github.com/xbmc/xbmc/pull/12306</ref>
* Estuary: PVR info dialog, recordings window: cleanup and extend <ref>https://github.com/xbmc/xbmc/pull/12416</ref>
* Drop 'channel guide' button from epg event info dialog, add 'channel guide' to context menu <ref>https://github.com/xbmc/xbmc/pull/12526</ref>
* Settings: Introduce new setting 'Startup action' and add 'Play TV/Radio <ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Settings: Make 'epg.lingertime' an official setting, remove the respective advanced setting <ref>https://github.com/xbmc/xbmc/pull/12740</ref>
* Setting: Remove obsolete and unused setting 'pvrplayback.scantime' <ref>https://github.com/xbmc/xbmc/pull/12800</ref>
* Core: Fixes/Improvements for multiple enable PVR client addons <ref>https://github.com/xbmc/xbmc/pull/12959</ref>
* Core: Fixes/Improvements for subchannel numbers support (ATSC) <ref>https://github.com/xbmc/xbmc/pull/13069</ref>
* Core: Global direct channel number input & global unique channel numbers <ref>https://github.com/xbmc/xbmc/pull/13135</ref>
* Database: Fix error "Abort due to constraint violation. Query: INSERT INTO channels..." <ref>https://github.com/xbmc/xbmc/pull/13150</ref>
* Estuary: Rework PVR seekbar + Fix PVR info dialog <ref>https://github.com/xbmc/xbmc/pull/13158</ref>
* Core: Make next/previous chapter work for PVR recordings <ref>https://github.com/xbmc/xbmc/pull/13164</ref>
* Direct channel number input: No delay on switch to previous channel with key 0 <ref>https://github.com/xbmc/xbmc/pull/13232</ref>
* Settings: Make shared channel selection optional <ref>https://github.com/xbmc/xbmc/pull/13237</ref>
* Estuary: PVR info panel cleanup <ref>https://github.com/xbmc/xbmc/pull/13255</ref>
* Guide window: 'Go to date' context menu item <ref>https://github.com/xbmc/xbmc/pull/13282</ref>
* Estuary: Season/Episode info in Guide window and dialog <ref>https://github.com/xbmc/xbmc/pull/13300</ref>
* Estuary: Add percent played progress bar to PVR info panel (for recordings) <ref>https://github.com/xbmc/xbmc/pull/13338</ref>
* Guide window: Channel groups selector <ref>https://github.com/xbmc/xbmc/pull/13364</ref>
* Guide window: Tweaks for more consistency and readability <ref>https://github.com/xbmc/xbmc/pull/13402</ref>
* PVR-Addon API changes <ref>https://github.com/xbmc/xbmc/pull/12028</ref><ref>https://github.com/xbmc/xbmc/pull/12303</ref><ref>https://github.com/xbmc/xbmc/pull/12552</ref><ref>https://github.com/xbmc/xbmc/pull/12609</ref><ref>https://github.com/xbmc/xbmc/pull/12660</ref><ref>https://github.com/xbmc/xbmc/pull/12689</ref><ref>https://github.com/xbmc/xbmc/pull/12755</ref><ref>https://github.com/xbmc/xbmc/pull/13228</ref>
* Added, updated, and improved PVR backend clients addons for all popular third-party external [[PVR backend]] platforms:
** [[Add-on:PVR Demo Client|PVR Demo Client]] dummy addon with fake (method stub) [[PVR backend]] for [[PVR]] skinning and regression testing
** [[Add-on:IPTV Simple Client|IPTV Simple Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:HDHomeRun PVR|HDHomeRun]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Digital Devices Octopus NET Client|Digital Devices Octopus NET Client]] PVR Addon backend client maintained and made available by [http://digitaldevices.de/home/ Digital Devices]
** [[Add-on:VU+ / Enigma2 Client|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Njoy N7 PVR Client|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VDR VNSI Client|VDR VNSI Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MythTV PVR Client|MythTV PVR Client]] Addon backend client maintained and available from the Kodi's community
** [[Add-on:NextPVR PVR Client|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Argus TV Client|Argus TV (former ForTheRecord)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBLink PVR Client|DVBLink PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBViewer Client|DVBViewer Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MediaPortal PVR Client|MediaPortal PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community
* ?

=== Add-ons Framework, API, and Manager ===
For full changelogs of all Addons APIs, see [[Leia API changes]], [http://forum.kodi.tv/forumdisplay.php?fid=174 JSON-RPC], and [http://forum.kodi.tv/forumdisplay.php?fid=26 Add-ons] Development Forums
* Major refactoring of Kodi's core handling and GUI management of binary addons<ref>http://github.com/xbmc/xbmc/pulls?q=label%3A%22Binary+Addons%22+is%3Aclosed</ref>
* Added framework to support VFS (Virtual File System) as binary addons<ref>http://github.com/xbmc/xbmc/pull/8966</ref>
* Added framework support for binary addons for video decoder codecs<ref name="Addon video codec implementation">https://github.com/xbmc/xbmc/pull/12340</ref>
* Added framework support for binary addons for image (picture) decoder codecs
* Added extentions to Kodi's Addons API to support binary addons for video decoder codecs<ref name="Addon video codec implementation"/>
* Added extentions to Kodi's Addons API to support binary addons for image decoder codecs
* Added support for Python addons to use PyCryptoDome crypto module for decryption<ref>https://github.com/xbmc/xbmc/pull/11477</ref>
* Added option to pass HTTP cookies with AVOption to Kodi's Video Player<ref>https://github.com/xbmc/xbmc/pull/12257</ref>
* Added support to allow addons to edit all used controls on their processed window<ref>https://github.com/xbmc/xbmc/pull/12259</ref>
* Added support to allow Python addons to set the videoinfotag path<ref>http://github.com/xbmc/xbmc/pull/11012</ref>
* Added support to allow Python addons to get/set the dbid of a (music) listitem<ref>http://github.com/xbmc/xbmc/pull/10858</ref>
* Added support for mediatype to musicinfotag tag retrieving via Python API<ref>http://github.com/xbmc/xbmc/pull/11110</ref>
* Added support "int/float slider" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11230</ref>
* Added support "setContent for mediawindows" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11258</ref>
* Added help for load of shared library and allow the use of their own addon temp folder<ref>https://github.com/xbmc/xbmc/pull/12379</ref>
* Added support to inspect add-on dependencies prior to installation<ref>https://github.com/xbmc/xbmc/pull/12242</ref>
* Added ability to remove add-on settings upon uninstall<ref>https://github.com/xbmc/xbmc/pull/11499</ref>
* Changed to new addon gui interface for list items to use on addon window<ref>https://github.com/xbmc/xbmc/pull/12214</ref>
* Changed service addons to use event handlers instead of synchronous addon hooks<ref>https://github.com/xbmc/xbmc/pull/12370</ref>
* Updated "Peripheral Addons" for game controllers, gamepads, joysticks, and input peripherals profiles (in Kodi-game repo<ref>http://github.com/kodi-game/ kodi-game repo on GitHub</ref>):
** [http://github.com/xbmc/peripheral.joystick Joystick Controller Addon]
** [http://github.com/kodi-game/peripheral.xarcade X-Arcade (XGaming Tankstick) support for Kodi Addon]
** [http://github.com/kodi-game/peripheral.steamcontroller Steam Controller (gamepad) Addon]
** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.default Default Game Controller Addon (reference game controller addon based on Xbox 360 gamepad)]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.ps PlayStation Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.nes Nintendo NES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.snes Nintendo SNES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.n64 Nintendo N64 Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.gba Nintendo GBA Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.genesis Sega Genesis Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.dreamcast Sega Dreamcast Game Controller Addon]
* ?

=== GUI Engine (Skinning Engine) ===
For full changelog on changes to the skinning engine, see [[Leia API changes]] and the [http://forum.kodi.tv/showthread.php?tid=298565 Skin Development Forum]
* Added windows to support Games and Game OSD in the new default skins (Estuary and Estouchy)
* Added player process info dialog to Kodi's default skin (Estuary)<ref>https://github.com/xbmc/xbmc/pull/11718</ref>
* Added support for addons to use banner and ClearLogo<ref>https://github.com/xbmc/xbmc/pull/12244</ref>
* Added support for skins/gui to allow implicit container referencing for non-media windows<ref>http://github.com/xbmc/xbmc/pull/10883</ref>
* Added support for addons to add "Enable/Disable" to context menu<ref>http://github.com/xbmc/xbmc/pull/11124</ref>
* Added support for remember last used keyboard layout in GUI<ref>http://github.com/xbmc/xbmc/pull/11242</ref>
* Added support for ISO 639-2/T language code retrieval (required by libbluray)<ref>https://github.com/xbmc/xbmc/pull/12258</ref>
* Added window that display Kodi privacy policy in GUI settings under system info<ref>https://github.com/xbmc/xbmc/pull/10785</ref>
* Added support to map a key to browse for subtitle in video fullscreen window<ref>https://github.com/xbmc/xbmc/pull/11649</ref>
* Improved Kodi's GUI engine with optimizations for message handling and SmartRedraw<ref>https://github.com/xbmc/xbmc/pull/12213</ref>
* Improved Kodi's GUI engine support for scaling container layouts<ref>http://github.com/xbmc/xbmc/pull/11229</ref>
* Improved Kodi's GUI engine by allowing %-values for origin, camera and animation attribs<ref>http://github.com/xbmc/xbmc/pull/11233</ref>
* Changed so that context menu reloading loads async to aviod GUI lockup on wait<ref>https://github.com/xbmc/xbmc/pull/11841</ref>
* Updated guilib ABI (for libgui) to version 5.13.0<ref>http://github.com/xbmc/xbmc/pull/11306</ref>
* Updated keyboard layout for some languages and added support Croatian, Slovenian, and Thai (Kedmanee)
* Updated image resource addons (as example weather icons, weather fanart, studio logos, and genre icons)
* ?

=== Platform Independent Playback ===
* Added support for "InputStream" (input stream) addons to pass CryptoSession flags field<ref>https://github.com/xbmc/xbmc/pull/12428</ref>
* Added support for BD-J / Blu-ray Disc Java menu support (requires system Java runtime enviroment)<ref>https://github.com/xbmc/xbmc/pull/12339</ref><ref>https://github.com/xbmc/xbmc/pull/12310</ref>
* Added support for Blu-ray Disc detection and use provided meta data for Blu-ray Disc names<ref>https://github.com/xbmc/xbmc/pull/12488</ref>
* Added support for video buffers to be used by decoders and renderers<ref name="VideoPlayer updates for Leia">https://github.com/xbmc/xbmc/pull/12212</ref>
** Added support for platforms to register custom buffers, like example dma<ref name="VideoPlayer updates for Leia"/>
* Added a VC1-Packet bitstream parser implementation for improved VC-1 playback<ref>http://github.com/xbmc/xbmc/pull/11417</ref>
* Added and updated many (binary) audio decoder and encoder addons for Kodi
* Added a few (binary) video decoder addons for Kodi<ref name="Addon video codec implementation"/>
* Added a "RAW" (libraw based) image decoder addon to Kodi<ref>https://github.com/xbmc/xbmc/pull/11671</ref>
* Improved MMAL playback of H.264 MVC (Blu-ray 3D) stereoscopic video with framepacking decoding on Raspberry Pi
* Improved Stereoscopic 3D playback of 3D videos (as well as better 2D playback of 3D videos)
* Improved and enhanced Blu-ray support (including updated libbluray dependecies from the VideoLAN project<ref>https://github.com/xbmc/xbmc/pull/12305</ref><ref>http://git.videolan.org/?p=libbluray.git;a=blob;f=ChangeLog</ref>
* Improved support for "InputStream" (input stream) addons as system addons
* Updated "InputStream" (input stream) client addons for common network streaming protocols and popular services:
** [http://github.com/xbmc/xbmc/tree/master/addons/kodi.inputstream InputStream Addon (default reference InputStream Addon by Team Kodi]
** [http://github.com/mapfau/inputstream.test Test InputStream Addon (Test InputStream Addon for Kodi's new inputstream interface]
** [http://github.com/peak3d/inputstream.adaptive Adaptive InputStream Addon (InputStream Client addon for several manifest types)]
** [http://github.com/xbmc/repo-binary-addons/tree/master/inputstream.rtmp RTMP InputStream Addon (InputStream Client for RTMP streams using librtmp)]
** [http://github.com/peak3d/inputstream.mpd MPD (MPEG-DASH) InputStream Addon]
** [http://github.com/peak3d/inputstream.smoothstream SmoothStream InputStream Addon for MS-SSTR (SmoothStreamingMedia) Smooth Streaming Protocol]
** [http://github.com/mapfau/inputstream.nxmsl NXMSL InputStream Addon for Netflix style manifests over MSL]
* Updated FFmpeg multimedia codec and demux libraries to stable branch release version [http://www.ffmpeg.org/download.html#release_3.3.2 FFmpeg 3.3 (3.3.2)]<ref>http://git.videolan.org/?p=ffmpeg.git;a=blob_plain;f=Changelog;hb=release/3.3.2 FFmpeg 3.3.2 release changelog</ref><ref>https://github.com/xbmc/xbmc/pull/12358</ref>
* Removed certain audio codecs from core and made them into audio decoder and audio encoder add-ons
* Removed certain video codecs from core and made them into video decoder add-ons<ref name="Addon video codec implementation"/>
* Removed certain image codecs from core and made them into image decoder add-ons
* ?

=== Library ===
* Addded support to use the Favourites function in context menus<ref>https://github.com/xbmc/xbmc/pull/11967</ref>
* Added support for context menus to favourites home screen widget<ref>https://github.com/xbmc/xbmc/pull/11929</ref>
* Added support for processing of WRITER tag for ID3 v2, Vorbis and APE formats<ref>https://github.com/xbmc/xbmc/pull/11735</ref>
* Added support for sorting using artist sort name tags in music<ref>https://github.com/xbmc/xbmc/pull/11738</ref>
* Added support to "Sort By Date Added" in Music Video title node<ref>https://github.com/xbmc/xbmc/pull/12495</ref>
* Changed to never cache listing of PVR directories on library scans<ref>https://github.com/xbmc/xbmc/pull/11761</ref>
* ?

=== Web Scrapers ===
* Added support for Python (script) based web scrapers for Kodi<ref>http://github.com/xbmc/xbmc/pull/9984</ref>
* Refactored and updated many XML based scrapers in Kodi for music, movies, tv shows, and music videos
* Updated music, movies, tv shows, and music video scrapers for Kodi
* ?

=== AudioEngine ===
* Added a new Sndio sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, other BSD Unix based systems, and Linux<ref>https://github.com/xbmc/xbmc/pull/11962</ref>
* Improved the default cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] (Kodi's [[AudioEngine]])
* Improved ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems
* Improved PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop
* Improved OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD and similar BSD Unix based systems
* Improved AUDIOTRACK sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Amlogic]]
* Improved Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]
* Improved DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved CoreAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* Improved Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* ?

=== Other ===
* Added a new unified setting for "Startup action" and added "Play TV/Radio"<ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Added support to build Kodi with support for Bluetooth<ref>http://github.com/xbmc/xbmc/pull/11137</ref>
* Added possibility for CMake build system to add additional libraries on install<ref>https://github.com/xbmc/xbmc/pull/12423</ref>
* Updated and improved mappings for new and existing remote controls
* Improved Kodi's JSON-RPC API
* Improved compiling/building and code documentation (following doxygen coding guidelines)
* Changed to use spdlog for Kodi logging as well as improved and further optimized logging (including debug logs)<ref>https://github.com/xbmc/xbmc/pull/11833</ref>
* Changed XML format of setting values for Kodi's settings configuration<ref>https://github.com/xbmc/xbmc/pull/12277</ref>
* Updated default web interface (webinterface is called "Chorus2" and is currently at version 2.4.4)<ref>https://github.com/xbmc/xbmc/pull/11872</ref>
* Updated critical dependency libraries such as openssl, gnutls, and CMake (used to compile Kodi and its binary addons)
* Removed last dependencies of SDL (Simple DirectMedia Layer) which was hardware abstraction for input devices<ref>https://github.com/xbmc/xbmc/pull/12272</ref><ref>https://github.com/xbmc/xbmc/pull/11881</ref>
* Removed all glew (libglew library) dependencies in Kodi's code<ref>http://github.com/xbmc/xbmc/pull/11128</ref>
* ?

=== Android Specific ===
* Added support for speech-to-text in Kodi OSD keyboard on Android TV (triggered by voice button on remote)
* Added support for Android to move the Kodi app to SD card<ref>https://github.com/xbmc/xbmc/pull/12168</ref>
* Added support for Android TV Leanback search and recommendations meta data from Kodi<ref>|https://github.com/xbmc/xbmc/pull/11901</ref>
** Default setting for Android TV Leanback suggestion to random unwatched movies and music albums<ref>https://github.com/xbmc/xbmc/pull/11963</ref>
* Moved to Android NDK 14b
* Changed Rendertype from GUILayer to VideoLayer for Android MediaCodecSurface<ref>https://github.com/xbmc/xbmc/pull/12097</ref>
* Changed to use NDK native C interface for Android MediaCodec (for performance gains)<ref>https://github.com/xbmc/xbmc/pull/11931</ref>
* Changed to support ZeroConf via native Android API (and deprecates mDNSresponder)<ref>http://github.com/xbmc/xbmc/pull/11393</ref>
* Changed to support network information via native Android API (and deprecates POSIX)<ref>https://github.com/xbmc/xbmc/pull/12243</ref>
* Changed handling of Kodi's Java interfaces via JNI for better consistency<ref>https://github.com/xbmc/xbmc/pull/12292</ref>
* ?

=== BSD Specific ===
* Improved Kodi support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* ?

=== Linux Specific ===
* Added support for a generic DRM/KMS implementation using GBM to create required surfaces<ref>https://github.com/xbmc/xbmc/pull/11955</ref>
* Added support for Mir windowing system (Mir 1.0) for Kodi<ref>http://github.com/xbmc/xbmc/pull/10898</ref> and added support for VAAPI on Mir using DRM<ref>http://github.com/xbmc/xbmc/pull/11040</ref>
* Added support for the middle mouse button on embedded platforms<ref>https://github.com/xbmc/xbmc/pull/11956</ref>
* Added support more yuv420p bitwidths for direct rendering on Linux<ref>https://github.com/xbmc/xbmc/pull/12479</ref>
* Added support for using VAAPI hardware video decoding with OpenGL ES<ref>https://github.com/xbmc/xbmc/pull/12113</ref>
* Added support for build Kodi with imx support using CMake<ref>http://github.com/xbmc/xbmc/pull/11288</ref>
* Moved the CMake build system to the top of the code tree (moved to root)<ref>http://github.com/xbmc/xbmc/pull/10446</ref>
* Improved support for UltraHD decoding / 4K resolution output when hardware supports it
* Improved ARM processor architecture (using [[Raspberry Pi]] as reference device)
* Improved OpenGL ES and EGL support (using [[Raspberry Pi]] as reference device)
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* Improved XvBA (AMD/ATI) Hardware Video Acceleration (requires XvBA compatible hardware and drivers)
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on Amlogic devices
* Removed the unused and unmaintained OpenMAX video decoder from Kodi's VideoPlayer<ref>https://github.com/xbmc/xbmc/pull/12197</ref>
* Removed support for autotools based build system for Kodi and binary addons (in favour of CMake)<ref>http://github.com/xbmc/xbmc/pull/10429</ref>
* ?

=== iOS Specific ===
* Added support for iOS 10.0 by adding support for compiling Kodi with Xcode 8 IDE and iOS SDK 10.0<ref>https://github.com/xbmc/xbmc/pull/10539</ref>
* Improved Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)
* Improved support for TVOS (Apple's iOS fork for Apple TV 4) in Kodi mainline
* Improved support for iOS on ARM64 (64-bit iOS)
* ?

=== OS X Specific ===
* Added support for compiling Kodi with Xcode 8 IDE for OSX 10.11 (El Capitan) and macOS 10.12 (Sierra)
* Improved Apple VDADecoder Video Acceleration support for (Mac) OS X
* ?

=== Windows Specific ===
* Added support to build Kodi for Windows 64 / Windows for Intel 64-bit (x86-64)<ref>https://github.com/xbmc/xbmc/pull/12065</ref>
* Added support for 3D LUT (3D Lookup Table) and dithering to Windows video renderer<ref name="WinRenderer re-work">https://github.com/xbmc/xbmc/pull/12475</ref>
* Improved support to compiling Kodi for Microsoft's UWP (Universal Windows Platform) APIs
* Changed the inner working of render buffers and rendering methods<ref name="WinRenderer re-work"/>
* Changed to using unicode win32 api methods<ref>https://github.com/xbmc/xbmc/pull/11780</ref>
* Changed windowing systems for screen saver handling on Windows OS platforms
* Changed to make Kodi for Windows platform independent of posix/main.cpp<ref>https://github.com/xbmc/xbmc/pull/12215</ref>
* Removed support for Windows Vista as the operating-system is no longer supported by Microsoft<ref>https://github.com/xbmc/xbmc/pull/11953</ref>
* ?

== References ==
<references/>

== See also ==
* [[Leia API changes]]
{{Changelogs}}

[[Category:Manual]]
[[Category:Leia|*]]
[[Category:Changelogs|18]]

Kodi v18 (Leia) changelog

2018-01-25T15:39:15Z

Ksooo:

{{mininav|[[Releases]] {{l2| [[Leia]] }} }}

{{notice|Kodi v17 (Krypton) final has just been released, so please keep in mind that a final non-alpha/beta v18 (Leia) release is still far far away into the future. As such, these new features/functions and API changes is a placeholder containing changes to the current Kodi mainline (the git master tree repository on GitHub). It is a very much a work in progress, this is only listing changes commited to the master branch after Jarvis branching, and many many many features/functions and API additions, alterations or removal are still subject to future change.}}
{{incomplete}}
{{future|18}}

{{see also|Kodi v18 (Leia) FAQ|Leia API changes|Releases}}

This is a placeholder and Kodi Wiki copy of the condensed changelog for the future Kodi v18.x version (codename: "Leia") releases with a summery of the most important core features and functions as well as other notable changes to key areas of the application software or its user interface.

== Changelog ==

=== Gaming (Games interface and Game Clients)===
* Added a RetroPlayer player core supporting game clients as well as emulator cores via libretro API<ref name="RetroPlayer">RetroPlayer http://forum.kodi.tv/showthread.php?tid=164725</ref><ref>http://github.com/xbmc/xbmc/pull/11022</ref>
* Added extentions to Kodi's Addons AP to support Game Client Addons, supporting Kodi's VFS (Virtual File System), etc.<ref name="RetroPlayer"/>
* Added support for Game Client Addons as new type of addons with just-in-time emulator installation<ref name="RetroPlayer"/>
* Added a Games window and Game OSD (On-Screen-Display) entries to the GUI<ref name="RetroPlayer"/><ref>https://github.com/xbmc/xbmc/pull/12367</ref>
* Added a gaming and game configuration interface for Game settings to the GUI<ref name="RetroPlayer"/>
* Added support for Game Info Tags (game info tag) and exposed properties to Python list items<ref name="RetroPlayer"/>
* Added a savestate (savestate) manager to Kodi for games<ref>http://github.com/xbmc/xbmc/pull/11034</ref>
* Added initial support for basic gameplay persistence (auto-save & auto-load)<ref>https://github.com/xbmc/xbmc/pull/12434</ref>
* Added support for in-game (save RAM) saves<ref>http://github.com/xbmc/xbmc/pull/11380</ref>
* Added support for Keyboard players via Joystick Emulation<ref name="RetroPlayer"/>
* Added support for libretro API and game cores (emulators and games) that support it
* Added [[Game_Add-ons|game clients addons]] for many popular third-party game console emulators and native open source games *
** ''* [[Game_Add-ons|Game clients addons]] for Kodi is changing quickly so checkout the [[Game_Add-ons|game clients addons]] article for a current list''
* ?

=== Live TV and PVR (Personal Video Recorder) ===
* Major GUI actions refactoring to eliminate duplicate and dead code. Add context menu support for Estuary PVR home screen widgets <ref>https://github.com/xbmc/xbmc/pull/10870</ref>
* Guide window: Get rid of obsolete views "channel", "now" and "next" <ref>https://github.com/xbmc/xbmc/pull/10838</ref>
* Core: Refactor and fix "play minimized" settings handling <ref>https://github.com/xbmc/xbmc/pull/11203</ref>
* Guide, channel, video fullscreen, music visualisation window: Direct channel number input. <ref>https://github.com/xbmc/xbmc/pull/11434</ref>
* Settings: Remove setting 'hide connection lost warning' <ref>https://github.com/xbmc/xbmc/pull/11500</ref>
* Search dialog: Refactor and complete implementation of EPG search filter <ref>https://github.com/xbmc/xbmc/pull/11570</ref>
* Timer settings dialog: Prefill recordings folder with timer title <ref>https://github.com/xbmc/xbmc/pull/11679</ref>
* Recordings window: Content view filter <ref>https://github.com/xbmc/xbmc/pull/11704</ref>
* Settings: Remove non-working recording settings defaults <ref>https://github.com/xbmc/xbmc/pull/11746</ref>
* Guide window: 'Smart selection' of epg events. <ref>https://github.com/xbmc/xbmc/pull/11782</ref>
* Channelgroup manager: Add support for radio channel groups <ref>https://github.com/xbmc/xbmc/pull/11877</ref>
* Guide window: Add possibility to switch between horizontal and vertical epg grid view <ref>https://github.com/xbmc/xbmc/pull/11958</ref>
* Search window: improvements and fixes <ref>https://github.com/xbmc/xbmc/pull/12001</ref>
* Estuary home screen: Add Info support to recently played channel widget <ref>https://github.com/xbmc/xbmc/pull/12254</ref>
* Estuary: Add episodename to live tv and recordings osd sub label, cleanup seek bar for live tv <ref>https://github.com/xbmc/xbmc/pull/12306</ref>
* Estuary: PVR info dialog, recordings window: cleanup and extend <ref>https://github.com/xbmc/xbmc/pull/12416</ref>
* Drop 'channel guide' button from epg event info dialog, add 'channel guide' to context menu <ref>https://github.com/xbmc/xbmc/pull/12526</ref>
* Settings: Introduce new setting 'Startup action' and add 'Play TV/Radio <ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Settings: Make 'epg.lingertime' an official setting, remove the respective advanced setting <ref>https://github.com/xbmc/xbmc/pull/12740</ref>
* Setting: Remove obsolete and unused setting 'pvrplayback.scantime' <ref>https://github.com/xbmc/xbmc/pull/12800</ref>
* Core: Fixes/Improvements for multiple enable PVR client addons <ref>https://github.com/xbmc/xbmc/pull/12959</ref>
* Core: Fixes/Improvements for subchannel numbers support (ATSC) <ref>https://github.com/xbmc/xbmc/pull/13069</ref>
* Core: Global direct channel number input & global unique channel numbers <ref>https://github.com/xbmc/xbmc/pull/13135</ref>
* Database: Fix error "Abort due to constraint violation. Query: INSERT INTO channels..." <ref>https://github.com/xbmc/xbmc/pull/13150</ref>
* Estuary: Rework PVR seekbar + Fix PVR info dialog <ref>https://github.com/xbmc/xbmc/pull/13158</ref>
* Core: Make next/previous chapter work for PVR recordings <ref>https://github.com/xbmc/xbmc/pull/13164</ref>
* Direct channel number input: No delay on switch to previous channel with key 0 <ref>https://github.com/xbmc/xbmc/pull/13232</ref>
* Settings: Make shared channel selection optional <ref>https://github.com/xbmc/xbmc/pull/13237</ref>
* Estuary: PVR info panel cleanup <ref>https://github.com/xbmc/xbmc/pull/13255</ref>
* Guide window: 'Go to date' context menu item <ref>https://github.com/xbmc/xbmc/pull/13282</ref>
* Estuary: Season/Episode info in Guide window and dialog <ref>https://github.com/xbmc/xbmc/pull/13300</ref>
* Estuary: Add percent played progress bar to PVR info panel (for recordings) <ref>https://github.com/xbmc/xbmc/pull/13338</ref>
* Guide window: Channel groups selector <ref>https://github.com/xbmc/xbmc/pull/13364</ref>
* Guide window: Tweaks for more consistency and readability <ref>https://github.com/xbmc/xbmc/pull/13402</ref>
* PVR-Addon API changes <ref>https://github.com/xbmc/xbmc/pull/12028</ref><ref>https://github.com/xbmc/xbmc/pull/12303</ref><ref>https://github.com/xbmc/xbmc/pull/12552</ref><ref>https://github.com/xbmc/xbmc/pull/12609</ref><ref>https://github.com/xbmc/xbmc/pull/12660</ref><ref>https://github.com/xbmc/xbmc/pull/12689</ref><ref>https://github.com/xbmc/xbmc/pull/12755</ref><ref>https://github.com/xbmc/xbmc/pull/13228</ref>
* Added, updated, and improved PVR backend clients addons for all popular third-party external [[PVR backend]] platforms:
** [[Add-on:PVR Demo Client|PVR Demo Client]] dummy addon with fake (method stub) [[PVR backend]] for [[PVR]] skinning and regression testing
** [[Add-on:IPTV Simple Client|IPTV Simple Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:HDHomeRun PVR|HDHomeRun]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Digital Devices Octopus NET Client|Digital Devices Octopus NET Client]] PVR Addon backend client maintained and made available by [http://digitaldevices.de/home/ Digital Devices]
** [[Add-on:VU+ / Enigma2 Client|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Njoy N7 PVR Client|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VDR VNSI Client|VDR VNSI Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MythTV PVR Client|MythTV PVR Client]] Addon backend client maintained and available from the Kodi's community
** [[Add-on:NextPVR PVR Client|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Argus TV Client|Argus TV (former ForTheRecord)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBLink PVR Client|DVBLink PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBViewer Client|DVBViewer Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MediaPortal PVR Client|MediaPortal PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community
* ?

=== Add-ons Framework, API, and Manager ===
For full changelogs of all Addons APIs, see [[Leia API changes]], [http://forum.kodi.tv/forumdisplay.php?fid=174 JSON-RPC], and [http://forum.kodi.tv/forumdisplay.php?fid=26 Add-ons] Development Forums
* Major refactoring of Kodi's core handling and GUI management of binary addons<ref>http://github.com/xbmc/xbmc/pulls?q=label%3A%22Binary+Addons%22+is%3Aclosed</ref>
* Added framework to support VFS (Virtual File System) as binary addons<ref>http://github.com/xbmc/xbmc/pull/8966</ref>
* Added framework support for binary addons for video decoder codecs<ref name="Addon video codec implementation">https://github.com/xbmc/xbmc/pull/12340</ref>
* Added framework support for binary addons for image (picture) decoder codecs
* Added extentions to Kodi's Addons API to support binary addons for video decoder codecs<ref name="Addon video codec implementation"/>
* Added extentions to Kodi's Addons API to support binary addons for image decoder codecs
* Added support for Python addons to use PyCryptoDome crypto module for decryption<ref>https://github.com/xbmc/xbmc/pull/11477</ref>
* Added option to pass HTTP cookies with AVOption to Kodi's Video Player<ref>https://github.com/xbmc/xbmc/pull/12257</ref>
* Added support to allow addons to edit all used controls on their processed window<ref>https://github.com/xbmc/xbmc/pull/12259</ref>
* Added support to allow Python addons to set the videoinfotag path<ref>http://github.com/xbmc/xbmc/pull/11012</ref>
* Added support to allow Python addons to get/set the dbid of a (music) listitem<ref>http://github.com/xbmc/xbmc/pull/10858</ref>
* Added support for mediatype to musicinfotag tag retrieving via Python API<ref>http://github.com/xbmc/xbmc/pull/11110</ref>
* Added support "int/float slider" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11230</ref>
* Added support "setContent for mediawindows" to Kodi's Python API<ref>http://github.com/xbmc/xbmc/pull/11258</ref>
* Added help for load of shared library and allow the use of their own addon temp folder<ref>https://github.com/xbmc/xbmc/pull/12379</ref>
* Added support to inspect add-on dependencies prior to installation<ref>https://github.com/xbmc/xbmc/pull/12242</ref>
* Added ability to remove add-on settings upon uninstall<ref>https://github.com/xbmc/xbmc/pull/11499</ref>
* Changed to new addon gui interface for list items to use on addon window<ref>https://github.com/xbmc/xbmc/pull/12214</ref>
* Changed service addons to use event handlers instead of synchronous addon hooks<ref>https://github.com/xbmc/xbmc/pull/12370</ref>
* Updated "Peripheral Addons" for game controllers, gamepads, joysticks, and input peripherals profiles (in Kodi-game repo<ref>http://github.com/kodi-game/ kodi-game repo on GitHub</ref>):
** [http://github.com/xbmc/peripheral.joystick Joystick Controller Addon]
** [http://github.com/kodi-game/peripheral.xarcade X-Arcade (XGaming Tankstick) support for Kodi Addon]
** [http://github.com/kodi-game/peripheral.steamcontroller Steam Controller (gamepad) Addon]
** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.default Default Game Controller Addon (reference game controller addon based on Xbox 360 gamepad)]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.ps PlayStation Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.nes Nintendo NES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.snes Nintendo SNES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.n64 Nintendo N64 Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.gba Nintendo GBA Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.genesis Sega Genesis Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.dreamcast Sega Dreamcast Game Controller Addon]
* ?

=== GUI Engine (Skinning Engine) ===
For full changelog on changes to the skinning engine, see [[Leia API changes]] and the [http://forum.kodi.tv/showthread.php?tid=298565 Skin Development Forum]
* Added windows to support Games and Game OSD in the new default skins (Estuary and Estouchy)
* Added player process info dialog to Kodi's default skin (Estuary)<ref>https://github.com/xbmc/xbmc/pull/11718</ref>
* Added support for addons to use banner and ClearLogo<ref>https://github.com/xbmc/xbmc/pull/12244</ref>
* Added support for skins/gui to allow implicit container referencing for non-media windows<ref>http://github.com/xbmc/xbmc/pull/10883</ref>
* Added support for addons to add "Enable/Disable" to context menu<ref>http://github.com/xbmc/xbmc/pull/11124</ref>
* Added support for remember last used keyboard layout in GUI<ref>http://github.com/xbmc/xbmc/pull/11242</ref>
* Added support for ISO 639-2/T language code retrieval (required by libbluray)<ref>https://github.com/xbmc/xbmc/pull/12258</ref>
* Added window that display Kodi privacy policy in GUI settings under system info<ref>https://github.com/xbmc/xbmc/pull/10785</ref>
* Added support to map a key to browse for subtitle in video fullscreen window<ref>https://github.com/xbmc/xbmc/pull/11649</ref>
* Improved Kodi's GUI engine with optimizations for message handling and SmartRedraw<ref>https://github.com/xbmc/xbmc/pull/12213</ref>
* Improved Kodi's GUI engine support for scaling container layouts<ref>http://github.com/xbmc/xbmc/pull/11229</ref>
* Improved Kodi's GUI engine by allowing %-values for origin, camera and animation attribs<ref>http://github.com/xbmc/xbmc/pull/11233</ref>
* Changed so that context menu reloading loads async to aviod GUI lockup on wait<ref>https://github.com/xbmc/xbmc/pull/11841</ref>
* Changed so PVR GUI code is moved from PVR core components (part of major PVR GUI refactoring)<ref>https://github.com/xbmc/xbmc/pull/11676</ref><ref name="PVR context menu rewrite & major gui actions refactoring"/>
* Updated guilib ABI (for libgui) to version 5.13.0<ref>http://github.com/xbmc/xbmc/pull/11306</ref>
* Updated keyboard layout for some languages and added support Croatian, Slovenian, and Thai (Kedmanee)
* Updated image resource addons (as example weather icons, weather fanart, studio logos, and genre icons)
* ?

=== Platform Independent Playback ===
* Added support for "InputStream" (input stream) addons to pass CryptoSession flags field<ref>https://github.com/xbmc/xbmc/pull/12428</ref>
* Added support for BD-J / Blu-ray Disc Java menu support (requires system Java runtime enviroment)<ref>https://github.com/xbmc/xbmc/pull/12339</ref><ref>https://github.com/xbmc/xbmc/pull/12310</ref>
* Added support for Blu-ray Disc detection and use provided meta data for Blu-ray Disc names<ref>https://github.com/xbmc/xbmc/pull/12488</ref>
* Added support for video buffers to be used by decoders and renderers<ref name="VideoPlayer updates for Leia">https://github.com/xbmc/xbmc/pull/12212</ref>
** Added support for platforms to register custom buffers, like example dma<ref name="VideoPlayer updates for Leia"/>
* Added a VC1-Packet bitstream parser implementation for improved VC-1 playback<ref>http://github.com/xbmc/xbmc/pull/11417</ref>
* Added and updated many (binary) audio decoder and encoder addons for Kodi
* Added a few (binary) video decoder addons for Kodi<ref name="Addon video codec implementation"/>
* Added a "RAW" (libraw based) image decoder addon to Kodi<ref>https://github.com/xbmc/xbmc/pull/11671</ref>
* Improved MMAL playback of H.264 MVC (Blu-ray 3D) stereoscopic video with framepacking decoding on Raspberry Pi
* Improved Stereoscopic 3D playback of 3D videos (as well as better 2D playback of 3D videos)
* Improved and enhanced Blu-ray support (including updated libbluray dependecies from the VideoLAN project<ref>https://github.com/xbmc/xbmc/pull/12305</ref><ref>http://git.videolan.org/?p=libbluray.git;a=blob;f=ChangeLog</ref>
* Improved support for "InputStream" (input stream) addons as system addons
* Updated "InputStream" (input stream) client addons for common network streaming protocols and popular services:
** [http://github.com/xbmc/xbmc/tree/master/addons/kodi.inputstream InputStream Addon (default reference InputStream Addon by Team Kodi]
** [http://github.com/mapfau/inputstream.test Test InputStream Addon (Test InputStream Addon for Kodi's new inputstream interface]
** [http://github.com/peak3d/inputstream.adaptive Adaptive InputStream Addon (InputStream Client addon for several manifest types)]
** [http://github.com/xbmc/repo-binary-addons/tree/master/inputstream.rtmp RTMP InputStream Addon (InputStream Client for RTMP streams using librtmp)]
** [http://github.com/peak3d/inputstream.mpd MPD (MPEG-DASH) InputStream Addon]
** [http://github.com/peak3d/inputstream.smoothstream SmoothStream InputStream Addon for MS-SSTR (SmoothStreamingMedia) Smooth Streaming Protocol]
** [http://github.com/mapfau/inputstream.nxmsl NXMSL InputStream Addon for Netflix style manifests over MSL]
* Updated FFmpeg multimedia codec and demux libraries to stable branch release version [http://www.ffmpeg.org/download.html#release_3.3.2 FFmpeg 3.3 (3.3.2)]<ref>http://git.videolan.org/?p=ffmpeg.git;a=blob_plain;f=Changelog;hb=release/3.3.2 FFmpeg 3.3.2 release changelog</ref><ref>https://github.com/xbmc/xbmc/pull/12358</ref>
* Removed certain audio codecs from core and made them into audio decoder and audio encoder add-ons
* Removed certain video codecs from core and made them into video decoder add-ons<ref name="Addon video codec implementation"/>
* Removed certain image codecs from core and made them into image decoder add-ons
* ?

=== Library ===
* Addded support to use the Favourites function in context menus<ref>https://github.com/xbmc/xbmc/pull/11967</ref>
* Added support for context menus to favourites home screen widget<ref>https://github.com/xbmc/xbmc/pull/11929</ref>
* Added support for processing of WRITER tag for ID3 v2, Vorbis and APE formats<ref>https://github.com/xbmc/xbmc/pull/11735</ref>
* Added support for sorting using artist sort name tags in music<ref>https://github.com/xbmc/xbmc/pull/11738</ref>
* Added support to "Sort By Date Added" in Music Video title node<ref>https://github.com/xbmc/xbmc/pull/12495</ref>
* Changed to never cache listing of PVR directories on library scans<ref>https://github.com/xbmc/xbmc/pull/11761</ref>
* ?

=== Web Scrapers ===
* Added support for Python (script) based web scrapers for Kodi<ref>http://github.com/xbmc/xbmc/pull/9984</ref>
* Refactored and updated many XML based scrapers in Kodi for music, movies, tv shows, and music videos
* Updated music, movies, tv shows, and music video scrapers for Kodi
* ?

=== AudioEngine ===
* Added a new Sndio sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, other BSD Unix based systems, and Linux<ref>https://github.com/xbmc/xbmc/pull/11962</ref>
* Improved the default cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] (Kodi's [[AudioEngine]])
* Improved ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems
* Improved PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop
* Improved OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD and similar BSD Unix based systems
* Improved AUDIOTRACK sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Amlogic]]
* Improved Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]
* Improved DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved CoreAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* Improved Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* ?

=== Other ===
* Added a new unified setting for "Startup action" and added "Play TV/Radio"<ref>https://github.com/xbmc/xbmc/pull/12548</ref>
* Added support to build Kodi with support for Bluetooth<ref>http://github.com/xbmc/xbmc/pull/11137</ref>
* Added possibility for CMake build system to add additional libraries on install<ref>https://github.com/xbmc/xbmc/pull/12423</ref>
* Updated and improved mappings for new and existing remote controls
* Improved Kodi's JSON-RPC API
* Improved compiling/building and code documentation (following doxygen coding guidelines)
* Changed to use spdlog for Kodi logging as well as improved and further optimized logging (including debug logs)<ref>https://github.com/xbmc/xbmc/pull/11833</ref>
* Changed XML format of setting values for Kodi's settings configuration<ref>https://github.com/xbmc/xbmc/pull/12277</ref>
* Updated default web interface (webinterface is called "Chorus2" and is currently at version 2.4.4)<ref>https://github.com/xbmc/xbmc/pull/11872</ref>
* Updated critical dependency libraries such as openssl, gnutls, and CMake (used to compile Kodi and its binary addons)
* Removed last dependencies of SDL (Simple DirectMedia Layer) which was hardware abstraction for input devices<ref>https://github.com/xbmc/xbmc/pull/12272</ref><ref>https://github.com/xbmc/xbmc/pull/11881</ref>
* Removed all glew (libglew library) dependencies in Kodi's code<ref>http://github.com/xbmc/xbmc/pull/11128</ref>
* ?

=== Android Specific ===
* Added support for speech-to-text in Kodi OSD keyboard on Android TV (triggered by voice button on remote)
* Added support for Android to move the Kodi app to SD card<ref>https://github.com/xbmc/xbmc/pull/12168</ref>
* Added support for Android TV Leanback search and recommendations meta data from Kodi<ref>|https://github.com/xbmc/xbmc/pull/11901</ref>
** Default setting for Android TV Leanback suggestion to random unwatched movies and music albums<ref>https://github.com/xbmc/xbmc/pull/11963</ref>
* Moved to Android NDK 14b
* Changed Rendertype from GUILayer to VideoLayer for Android MediaCodecSurface<ref>https://github.com/xbmc/xbmc/pull/12097</ref>
* Changed to use NDK native C interface for Android MediaCodec (for performance gains)<ref>https://github.com/xbmc/xbmc/pull/11931</ref>
* Changed to support ZeroConf via native Android API (and deprecates mDNSresponder)<ref>http://github.com/xbmc/xbmc/pull/11393</ref>
* Changed to support network information via native Android API (and deprecates POSIX)<ref>https://github.com/xbmc/xbmc/pull/12243</ref>
* Changed handling of Kodi's Java interfaces via JNI for better consistency<ref>https://github.com/xbmc/xbmc/pull/12292</ref>
* ?

=== BSD Specific ===
* Improved Kodi support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* ?

=== Linux Specific ===
* Added support for a generic DRM/KMS implementation using GBM to create required surfaces<ref>https://github.com/xbmc/xbmc/pull/11955</ref>
* Added support for Mir windowing system (Mir 1.0) for Kodi<ref>http://github.com/xbmc/xbmc/pull/10898</ref> and added support for VAAPI on Mir using DRM<ref>http://github.com/xbmc/xbmc/pull/11040</ref>
* Added support for the middle mouse button on embedded platforms<ref>https://github.com/xbmc/xbmc/pull/11956</ref>
* Added support more yuv420p bitwidths for direct rendering on Linux<ref>https://github.com/xbmc/xbmc/pull/12479</ref>
* Added support for using VAAPI hardware video decoding with OpenGL ES<ref>https://github.com/xbmc/xbmc/pull/12113</ref>
* Added support for build Kodi with imx support using CMake<ref>http://github.com/xbmc/xbmc/pull/11288</ref>
* Moved the CMake build system to the top of the code tree (moved to root)<ref>http://github.com/xbmc/xbmc/pull/10446</ref>
* Improved support for UltraHD decoding / 4K resolution output when hardware supports it
* Improved ARM processor architecture (using [[Raspberry Pi]] as reference device)
* Improved OpenGL ES and EGL support (using [[Raspberry Pi]] as reference device)
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* Improved XvBA (AMD/ATI) Hardware Video Acceleration (requires XvBA compatible hardware and drivers)
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on Amlogic devices
* Removed the unused and unmaintained OpenMAX video decoder from Kodi's VideoPlayer<ref>https://github.com/xbmc/xbmc/pull/12197</ref>
* Removed support for autotools based build system for Kodi and binary addons (in favour of CMake)<ref>http://github.com/xbmc/xbmc/pull/10429</ref>
* ?

=== iOS Specific ===
* Added support for iOS 10.0 by adding support for compiling Kodi with Xcode 8 IDE and iOS SDK 10.0<ref>https://github.com/xbmc/xbmc/pull/10539</ref>
* Improved Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)
* Improved support for TVOS (Apple's iOS fork for Apple TV 4) in Kodi mainline
* Improved support for iOS on ARM64 (64-bit iOS)
* ?

=== OS X Specific ===
* Added support for compiling Kodi with Xcode 8 IDE for OSX 10.11 (El Capitan) and macOS 10.12 (Sierra)
* Improved Apple VDADecoder Video Acceleration support for (Mac) OS X
* ?

=== Windows Specific ===
* Added support to build Kodi for Windows 64 / Windows for Intel 64-bit (x86-64)<ref>https://github.com/xbmc/xbmc/pull/12065</ref>
* Added support for 3D LUT (3D Lookup Table) and dithering to Windows video renderer<ref name="WinRenderer re-work">https://github.com/xbmc/xbmc/pull/12475</ref>
* Improved support to compiling Kodi for Microsoft's UWP (Universal Windows Platform) APIs
* Changed the inner working of render buffers and rendering methods<ref name="WinRenderer re-work"/>
* Changed to using unicode win32 api methods<ref>https://github.com/xbmc/xbmc/pull/11780</ref>
* Changed windowing systems for screen saver handling on Windows OS platforms
* Changed to make Kodi for Windows platform independent of posix/main.cpp<ref>https://github.com/xbmc/xbmc/pull/12215</ref>
* Removed support for Windows Vista as the operating-system is no longer supported by Microsoft<ref>https://github.com/xbmc/xbmc/pull/11953</ref>
* ?

== References ==
<references/>

== See also ==
* [[Leia API changes]]
{{Changelogs}}

[[Category:Manual]]
[[Category:Leia|*]]
[[Category:Changelogs|18]]

Advancedsettings.xml

2017-10-23T12:53:09Z

Ksooo: /* Removed tags */

{{TOC right}}{{mininav|[[Settings]]|page=advancedsettings.xml}}
{{bigger|{{note|'''The advancedsettings.xml file does not exist by default. You have to create it first!'''}} }}

<section begin="intro" />The [[advancedsettings.xml]] file, which does not exist by default, can be created by a user in their '''[[userdata folder]]'''.

This file is used for advanced settings and options that do not have GUI controls inside of {{kodi}}. Some settings are experimental or very rarely set, so they can only be used via the advancedsettings.xml file. The file is simply a plain text file and can be edited by various text editors, so long as the name is "advancedsettings.xml". These advanced settings can be used to tweak various things such as episode naming patterns, special network ports, special behaviors, and more.<section end="intro" />

The following page will describe the structure of the advancedsettings.xml file and the various individual settings.

{{note|
# All XML tags must be lowercase. The start and end of the advancedsettings.xml file must have the <advancedsettings> and </advancedsettings> tags.
# Kodi will only read the advancedsettings.xml file when it starts up. If you make changes while it is running then you must restart Kodi.
# For some Windows versions, Kodi has two <code>\userdata\</code> folders. The correct one to put the advancedsettings.xml file in is not the one in Program Files, but in <code>%appdata%\Kodi\userdata\.</code>}}

== Layout ==

The layout of <code>advancedsettings.xml</code> is as follows:

<syntaxhighlight lang="xml" enclose="div">
<advancedsettings>
<setting>value</setting>
...
<setting>value</setting>
</advancedsettings>
</syntaxhighlight>

where "setting" gives the name of the setting, and "value" gives its value.

A list of the available "setting" strings and their values is given below.

= List of available settings =

== Troubleshooting settings ==

=== loglevel ===
{{Anchor|.3Cloglevel.3E}}
{{see also|debug log}}
<section begin="loglevel" />
{{xml setting
| tag name = loglevel
| tag attribute = hide
| tag attribute values =
{{option values
| value1= true | value1 description= Hides "enable debugging" guisetting.
| value2= false | value2 description= "enable debugging" guisetting will switch between min(loglevel, 0) and max(loglevel, 2) for off and on respectively. '''(Default)'''
}}
| tag attribute default values = true
| option values =
{{option values
| value1= -1 | value1 description= No logging, suppresses all log output
| value2= 0 | value2 description= Normal logging, only logging errors '''(Default)'''
| value3= 1 | value3 description= Debug logging ''(without showing text on screen)''
| value4= 2 | value4 description= Debug logging with freemem, fps and cpu usage shown on screen
| value5= 3 | value5 description= Debug logging with freemem, fps and cpu usage and full smb logging
}}
| default values = 0
| description =
The logging level that Kodi will use to log errors and information. The "hide" attribute is optional.
| example =
Example:
<syntaxhighlight lang="xml" enclose="div">
<loglevel hide="false">1</loglevel>
</syntaxhighlight>

<br />

{{Note| If debugging is switched on in the GUI, loglevel will be set to 2 (''log to both file and on-screen information''); this will over-ride any <code>advancedsettings.xml</code> setting.}}<br />

{{Note| If debugging is switched on in the GUI when Kodi is shut down, then it will be automatically be re-enabled at level 2 when it is re-started. This is true even if 'hide' is subsequently set to 'true' - in other words, if you enable it in the GUI and then hide the GUI toggle, it will stay on level 2 irrespective of what you subsequently set in <code>advancedsettings.xml</code>.}}<br />
}}
<section end="loglevel" />

=== jsonrpc ===
{{Anchor|.3Cjsonrpc.3E}}
To make it easier for developers using the [[JSON RPC]] API in their (third party) applications to debug during development the json output of Kodi can be prettified by setting '''compactoutput''' to '''false'''. Default json output mode is a compact print which does not contain any unnecessary whitespaces and therefore is difficult to read for humans.
Furthermore using the '''tcpport''' setting it is possible to change the default TCP port used by Kodi for JSON RPC (which is 9090) to any other valid port.

Example:
<syntaxhighlight lang="xml" enclose="div">
<jsonrpc>
<compactoutput>false</compactoutput>
<tcpport>9999</tcpport>
</jsonrpc>
</syntaxhighlight>

== Audio/video playback settings ==

=== skiploopfilter ===
{{anchor|.3Cskiploopfilter.3E}}
The amount of the loop filter to skip on h.264 decoding. This can help the performance of slower machines when decoding h264 content. Values, in decreasing CPU usage (and decreasing quality)
* -16 None
* 0 Skip only empty frames (default)
* 8 Skip non-reference frames
* 16 Skip bi-dir frames
* 32 Skip all non-key frames
* 48 Skip all frames
Example:
<syntaxhighlight lang="xml" enclose="div">
<skiploopfilter>8</skiploopfilter>
</syntaxhighlight>

=== video ===
{{anchor|.3Cvideo.3E}}

The <video> section also includes the following child-tags, which have their own sections:
*[[#cleandatetime]]
*[[#cleanstrings]]
*[[#excludefromscan]]
*[[#excludefromlisting]]
*[[#excludetvshowsfromscan]]

{{note|Some tags that have a "third-level" and are grouped together are highlighted in color.}}

{| class="prettytable"
! Tag !! Description
|-
|
<syntaxhighlight lang="xml">
<video>
</syntaxhighlight>
| Parent tag that all other child tags need to be placed inside of. Do not use more than one '''<code><video></code>''' tag, but instead place all other child-tags within a single '''<code><video></video></code>''' set.
|-
|
<syntaxhighlight lang="xml">
<subsdelayrange>10</subsdelayrange>
</syntaxhighlight>
| Delay range for subtitles, in seconds.
|-
|
<syntaxhighlight lang="xml">
<audiodelayrange>10</audiodelayrange>
</syntaxhighlight>
| Delay range for audio/video sync, in seconds.
|-
|
<syntaxhighlight lang="xml">
<usetimeseeking>true</usetimeseeking>
</syntaxhighlight>
| Whether to use time based or percentage based seeking. {{small see also|HOW-TO:Modify time seeking}}
|-
|
<syntaxhighlight lang="xml">
<timeseekforwardbig>600</timeseekforwardbig>
<timeseekbackwardbig>-600</timeseekbackwardbig>
</syntaxhighlight>
| Time to seek forward in seconds when doing a long seek. Defaults to 600 (10 minutes) and -600 (-10 minutes) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang="xml">
<percentseekforward>2</percentseekforward>
<percentseekbackward>-2</percentseekbackward>
</syntaxhighlight>
| Amount to seek forward as a percentage, when doing a short seek. Defaults to 2 (2%) and -2 (2%) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang="xml">
<percentseekforwardbig>10</percentseekforwardbig>
<percentseekbackwardbig>-10</percentseekbackwardbig>
</syntaxhighlight>
| Amount to seek forward as a percentage, when doing a long seek. Defaults to 10 (10%) and -10 (10%) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang="xml">
<fullscreenonmoviestart>true</fullscreenonmoviestart>
</syntaxhighlight>
| Whether to go to fullscreen or not when starting a movie. Defaults to true.
|-
|
<syntaxhighlight lang="xml">
<defaultplayer>VideoPlayer</defaultplayer>
</syntaxhighlight>
| Set the default video player: VideoPlayer or an external player. See '''[[External players]]''' for more info.
|-
|
<syntaxhighlight lang="xml">
<excludefromscan>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromscan>
</syntaxhighlight>
| Regular expressions that if evaluated to true won't be added to library. It is possible to add multiple <code><regexp></code> tags to match multiple patterns
|-
|
<syntaxhighlight lang="xml">
<excludefromlisting>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>
</syntaxhighlight>
| Regular expressions that if evaluated to true won't be displayed in files view.
|-
|
<syntaxhighlight lang="xml">
<playcountminimumpercent>90</playcountminimumpercent>
</syntaxhighlight>
| Minimum percentage that has to be played before it is marked as watched. Set to 101 to never auto-mark items as watched. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang="xml">
<ignoresecondsatstart>180</ignoresecondsatstart>
</syntaxhighlight>
| Number of seconds to ignore at video start after which a resume point is created. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang="xml">
<ignorepercentatend>8</ignorepercentatend>
</syntaxhighlight>
| Percentage of video to ignore at the end. If you stop watching the video here no resume point is created. Set to 101 to never save a resume point. The video is already marked as watched at 90%, see above. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang="xml">
<vdpauscaling>true</vdpauscaling>
</syntaxhighlight>
| Scales with vdpau instead of opengl and turns on its HQ scaler when available, enabling this might slow down rendering and cause framedrops especially on ION systems, this setting requires a vdpau feature set C GPU.
|-
|
<syntaxhighlight lang="xml">
<enablehighqualityhwscalers>true</enablehighqualityhwscalers>
</syntaxhighlight>
| Allow turning on the spline36 and lanczos3 shader (for GL builds).
|-
|
<syntaxhighlight lang="xml">
<dxvaallowhqscaling>false</dxvaallowhqscaling>
</syntaxhighlight>
| Enables high quality video upscaling for Windows.
|-
|
<syntaxhighlight lang="xml">
<ppffmpegdeinterlacing>linblenddeint</ppffmpegdeinterlacing>
</syntaxhighlight>
| Override the deinterlacing options passed to libpostproc.
|-
|
<syntaxhighlight lang="xml">
<ppffmpegpostprocessing>ha:128:7,va,dr</ppffmpegpostprocessing>
</syntaxhighlight>
| Override the post processing options passed to libpostproc when 'Video post-processing' is activated in GUI Videos-Settings-Playback.
|-
|
<syntaxhighlight lang="xml">
<autoscalemaxfps>30</autoscalemaxfps>
</syntaxhighlight>
| When scaling method is set to auto, bilinear is chosen when the fps is higher than this limit, the default is 30.
|-
|
<syntaxhighlight lang="xml">
<adjustrefreshrate>
</syntaxhighlight>
| style="background:#CADCFB;" | Settings for when "Adjust refreshrate to match video fps" is enabled in the video playback GUI settings.
|-
|
<syntaxhighlight lang="xml">
<override>
<fps>23.976</fps>
<refresh>60.0</refresh>
</override>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' "Adjust refreshrate to match video fps" will try to select the best refreshrate for the video fps but it doesn't always get it right, for example it might switch to an unsupported refreshrate. You can add overrides here to switch to a certain refreshrate based on video fps. It's possible to add as many overrides as you need. Overrides are processed in order, if the first one doesn't match the fps or no refreshrates match that override, it will try the next one until no overrides are left.

* '''fps''' - if the fps is between 23.966 and 23.986
* '''refresh''' - switch to the first found refreshrate that is between 59.99 and 60.01
|-
|
<syntaxhighlight lang="xml">
<override>
<fpsmin>29.96</fpsmin>
<fpsmax>30.01</fpsmax>
<refreshmin>59.0</refreshmin>
<refreshmax>61.0</refreshmax>
</override>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -'''
* '''fpsmin''' / '''fpsmin''' - You can also specify the fps range yourself.
* '''refreshmin''' / '''refreshmax''' - Same for the refreshrate
|-
|
<syntaxhighlight lang="xml">
<fallback>
<refresh>50.0</refresh>
</fallback>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' If none of the overrides match, or none of the refreshrates match any of the fps matching overrides, it will choose a fallback refreshrate. Fallbacks are process in order, if the first fallback doesn't match any refreshrate, it will try the next one until no fallbacks are left.

* '''refresh''' - Switch to the first found refreshrate that is between 49.99 and 50.01.
|-
|
<syntaxhighlight lang="xml">
<fallback>
<refreshmin>49.0</refreshmin>
<refreshmax>51.0</refreshmax>
</fallback>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' You can also specify the range for the fallback yourself.

If none of the overrides match the video fps, or no refreshrates match any of the fps matching overrides, and no fallbacks are specified or no refreshrates match any fallbacks, it will automatically choose the best refreshrate (same as having no overrides and fallbacks).
|-
|
<syntaxhighlight lang="xml">
</adjustrefreshrate>
</syntaxhighlight>
| style="background:#CADCFB;" |
|-
|
<syntaxhighlight lang="xml">
<checkdxvacompatibility>value</checkdxvacompatibility>
</syntaxhighlight>
| Advanced setting not present: let Kodi autodetect cards that support H.264 profile > L4.1. Set value to false to enable DXVA no matter what. Set value to true if Kodi doesn't autodetect that the graphics card doesn't support > L4.1.
|-
|
<syntaxhighlight lang="xml">
<useocclusionquery>-1</useocclusionquery>
</syntaxhighlight>
| Use an occlusion query when capturing videoframes, -1 means auto detect, 0 means disabled, 1 means enabled, the default is -1.
|-
|
<syntaxhighlight lang="xml">
<fpsdetect>1</fpsdetect>
</syntaxhighlight>
| FPS detection for video playback
* 0 = trust codec fps
* 1 = recalculate from video timestamps with uniform spacing
* 2 = recalculate from video timestamps always
|-
|
<syntaxhighlight lang="xml">
<latency>
</syntaxhighlight>
| style="background:#F0E68C;"| Start of '''latency''' tags. Display latency (video lag). Latency is given in msecs.
|-
|
<syntaxhighlight lang="xml">
<delay>0</delay>
</syntaxhighlight>
| style="background:#F0E68C;" | Global default display latency.
|-
|
<syntaxhighlight lang="xml">
<refresh></refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | Override latency for given display (not video) refresh rates. When Kodi is in windowed mode, override is ignored. Multiple overrides are allowed.

Syntax of an override entry:
<syntaxhighlight lang="xml">
<refresh>
<min>, <max> refresh rate range, OR
<rate> exact refresh rate
<delay> display latency for the given refresh rate
</refresh>
</syntaxhighlight>
|-
|
<syntaxhighlight lang="xml">
<refresh>
<min>23</min>
<max>24</max>
<delay>125</delay>
</refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | '''Example:''' display has 125 msec latency at 23-24 Hz
|-
|
<syntaxhighlight lang="xml">
<refresh>
<rate>50</rate>
<delay>50</delay>
</refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | '''Example:''' display has 50 msec latency at 50 (+/-0.01) Hz
|-
|
<syntaxhighlight lang="xml">
</latency>
</syntaxhighlight>
| style="background:#F0E68C;" |
|-
|
<syntaxhighlight lang="xml">
<stereoscopicregex3d>[-. _]3d[-. _]</stereoscopicregex3d>
<stereoscopicregexsbs>[-. _]h?sbs[-. _]</stereoscopicregexsbs>
<stereoscopicregextab>[-. _]h?tab[-. _]</stereoscopicregextab>
</syntaxhighlight>
| Filename triggers for 3D (stereoscopic) mode.
|-
|
<syntaxhighlight lang="xml">
<assfixedworks>false</assfixedworks>
</syntaxhighlight>
| Position behavior of ass subtitiles when setting "subtitle position on screen" set to "fixed". True to show at the fixed position set in video calibration. False to show at the bottom of video (default).
|-
|
<syntaxhighlight lang="xml">
</video>
</syntaxhighlight>
|
|}

=== audio ===
{{anchor|.3Caudio.3E}}
<syntaxhighlight lang="xml" enclose="div">
<audio>

<headroom>0</headroom>

<defaultplayer>paplayer</defaultplayer>

<excludefromscan>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromscan>

<excludefromlisting>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromlisting>

<ac3downmixgain>12.0</ac3downmixgain>

<playcountminimumpercent>99</playcountminimumpercent>

<applydrc>-1.0</applydrc>

<limiterhold>0.025</limiterhold>

<limiterrelease>0.1</limiterrelease>
</audio>
</syntaxhighlight>

For more information on the configuration of audio under Frodo see [[AudioEngine/HOW-TO: Configure audio]]

=== edl ===
{{anchor|.3Cedl.3E}}
{{main|EDL}}
Commercial break detection not as good you think it could be? Are some commercial breaks in a series of adverts not being skipped? Are some parts being skipped that are clearly not commercials? Does the end of the previous recording still show? The following advanced settings can be used to better identify full commercial break sequences, remove incorrectly flagged commercial breaks, and have playback start at the actual beginning of the recording.

<syntaxhighlight lang="xml" enclose="div">
<edl>

<mergeshortcommbreaks>false</mergeshortcommbreaks>

<maxcommbreaklength>250</maxcommbreaklength>

<mincommbreaklength>90</mincommbreaklength>

<maxcommbreakgap>120</maxcommbreakgap>

<commbreakautowait>0</commbreakautowait>

<commbreakautowind>0</commbreakautowind>
</edl>
</syntaxhighlight>

=== pvr ===
{{anchor|.3Cpvr.3E}}
<syntaxhighlight lang="xml" enclose="div">
<pvr>
<timecorrection>0</timecorrection> 
<infotoggleinterval>3000</infotoggleinterval> 
<channeliconsautoscan>true</channeliconsautoscan> 
<autoscaniconsuserset>false</autoscaniconsuserset> 
<numericchannelswitchtimeout>1000</numericchannelswitchtimeout> 
</pvr>
</syntaxhighlight>

=== epg ===
{{anchor|.3Cpvr.3E}}
<syntaxhighlight lang="xml" enclose="div">
<epg>
<updatecheckinterval>300</updatecheckinterval> 
<cleanupinterval>900</cleanupinterval> 
<activetagcheckinterval>60</activetagcheckinterval> 
<retryinterruptedupdateinterval>30</retryinterruptedupdateinterval> 
<updateemptytagsinterval>60</updateemptytagsinterval> 
<displayupdatepopup>true</displayupdatepopup> 
<displayincrementalupdatepopup>false</displayincrementalupdatepopup> 
</epg>
</syntaxhighlight>

=== forcedswaptime ===
{{anchor|.3Cforcedswaptime.3E}}
Use to force a backbuffer->frontbuffer swap while vsync is enabled. Set to the time (in ms) to allow for the swap (e.g. <forcedswaptime>1</forcedswaptime> is typical).

Default: Off



== Video library settings ==

=== videoextensions ===
{{anchor|.3Cvideoextensions.3E}}<section begin="videoextensions" />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Video windows.

Default extensions for VIDEOS:
<pre>
.m4v .3g2 .3gp .nsv .tp .ts .ty .strm .pls .rm .rmvb .mpd .m3u .m3u8 .ifo .mov .qt .divx .xvid
.bivx .vob .nrg .pva .wmv .asf .asx .ogm .m2v .avi .dat .mpg .mpeg .mp4 .mkv .mk3d .avc .vp3
.svq3 .nuv .viv .dv .fli .flv .001 .wpl .vdr .dvr-ms .xsp .mts .m2t .m2ts .evo .ogv .sdp .avs
.rec .url .pxml .vc1 .h264 .rcv .rss .mpls .webm .bdmv .wtv
</pre>
Examples:
<syntaxhighlight lang="xml" enclose="div">
<videoextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</videoextensions>
</syntaxhighlight>
<section end="videoextensions" />

=== discstubextensions ===
{{anchor|.3Cdiscstubextensions.3E}}
{{main|Media stubs}}
A list of additional file-extensions that will (<tt><add></tt>) or will not (<tt><remove></tt>) be treated as disc stubs.

Default extensions for DISC STUBS:
<pre>
.disc
</pre>

Examples:
<syntaxhighlight lang="xml" enclose="div">
<discstubextensions>
<add>.dvd|.blu</add>
<remove>.cd|.vhs</remove>
</discstubextensions>
</syntaxhighlight>

=== languagecodes ===
{{anchor|.3Clanguagecodes.3E}}
Translation table for subtitle and audio names. Contains entries of the form

<syntaxhighlight lang="xml" enclose="div">
<languagecodes>
<code>
<short>alt</short>
<long>Alternate</long>
</code>
</languagecodes>
</syntaxhighlight>

=== sorttokens ===
{{anchor|.3Csorttokens.3E}}
Allows you to specify additional tokens that will be ignored at the start of lines during sorting.
{{note|Sort tokens are case sensitive.}}
<syntaxhighlight lang="xml" enclose="div">
<sorttokens>
<token>the</token>
</sorttokens>
</syntaxhighlight>

=== moviestacking ===
{{anchor|.3Cmoviestacking.3E}}<section begin="moviestacking" />
{{main|File stacking}}
This is used by the [[file stacking]] algorithm to combine multi-part files and contains a list of "''[[Regular Expression (RegEx) Tutorial|regular expressions]]''". For stacking videos that are contained in folders, such as VIDEO_TS folders, see '''[[advancedsettings.xml#folderstacking|<folderstacking>]]'''

As of v9.11, video stacking regular expressions '''must''' contain exactly four (4) capture expressions.

Default:
<syntaxhighlight lang="xml" enclose="div">
<moviestacking>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[0-9]+)(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[a-d])(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ ._-]*[a-d])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="append"</tt> or <tt>append="yes"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the end.

Example:
<syntaxhighlight lang="xml" enclose="div">
<moviestacking action="append">

<regexp>(.*?)([ ._-]*[0-9])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="prepend"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the beginning.

Example:
<syntaxhighlight lang="xml" enclose="div">
<moviestacking action="prepend">
<regexp>(Title)(Volume)(Ignore)(Extension)</regexp>
</moviestacking>
</syntaxhighlight>

If no argument is supplied, or the argument <tt>append="no"</tt> is supplied, the default moviestacking regular expressions are overwritten by the user specified ones.
<section end="moviestacking" />

=== folderstacking ===
{{main|File stacking}}
This is similar to '''[[advancedsettings.xml#moviestacking|<moviestacking>]]''', but is used for videos that are contained in folders that use the folder names to stack, such as VIDEO_TS folders (DVD rips that are not in ISO format).

Default:
<syntaxhighlight lang="xml" enclose="div">
<folderstacking>

<regexp>((cd|dvd|dis[ck])[0-9]+)$</regexp>
</folderstacking>
</syntaxhighlight>

=== cleandatetime ===
{{anchor|.3Ccleandatetime.3E}}
Matches a year number in a string using a ''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''

Default expression:
<syntaxhighlight lang="xml" enclose="div">
<video>
<cleandatetime>(.+[^ _\,\.\[\]\-])[ _\.\[\]\-]+(19[0-9][0-9]|20[0-1][0-9])([ _\,\.\[\]\-][^0-9]|$)</cleandatetime>
</video>
</syntaxhighlight>
:* The string found before will be used as basis string getting cleaned by the cleanstrings expressions.
:* By default date formats like MM:YY are ignored.

=== cleanstrings ===
{{anchor|.3Ccleanstrings.3E}}
Clean unwanted characters from filenames or folders by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. Please note that everything right of the match (at the end of the file name) is removed, so if you would have a file named ''Super movie.mp4'' and would add <tt><regexp> </regexp></tt> (only a space), the only thing that would be left is ''Super'', which is probably not what you want.

Default expressions:
<syntaxhighlight lang="xml" enclose="div">
<video>
<cleanstrings>
<regexp>[ _\,\.\[\]\-](ac3|dts|custom|dc|divx|divx5|dsr|dsrip|dutch|dvd|dvdrip|dvdscr|dvdscreener|screener|dvdivx|cam|fragment|fs|hdtv|hdrip|hdtvrip|internal|limited|multisubs|ntsc|ogg|ogm|pal|pdtv|proper|repack|rerip|retail|cd[1-9]|r3|r5|bd5|se|svcd|swedish|german|read.nfo|nfofix|unrated|ws|telesync|ts|telecine|tc|brrip|bdrip|480p|480i|576p|576i|720p|720i|1080p|1080i|hrhd|hrhdtv|hddvd|bluray|x264|h264|xvid|xvidvd|xxx|www.www|\[.*\])([ _\,\.\[\]\-]|$)</regexp>
<regexp>(\[.*\])</regexp>
</cleanstrings>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== tvshowmatching ===
{{anchor|.3Ctvshowmatching.3E}}
Matches the season and episode numbers in file paths by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

Defaults:
<syntaxhighlight lang="xml" enclose="div">
<tvshowmatching>
<regexp>s([0-9]+)[ ._x-]*e([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)([^\\\\/]*)$</regexp> 
<regexp>[\._ -]()[Ee][Pp]_?([0-9]+)([^\\/]*)$</regexp> 
<regexp>([0-9]{4})[\.-]([0-9]{2})[\.-]([0-9]{2})</regexp> 
<regexp>([0-9]{2})[\.-]([0-9]{2})[\.-]([0-9]{4})</regexp> 
<regexp>[\\/\._ \[\(-]([0-9]+)x([0-9]+)([^\\/]*)$</regexp> 
<regexp>[\\/\._ -]([0-9]+)([0-9][0-9])([\._ -][^\\/]*)$</regexp> 
<regexp>[\/._ -]p(?:ar)?t[_. -]()([ivx]+)([._ -][^\/]*)$</regexp> 
</tvshowmatching>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)
:* Paths are converted to lower case before matching.
:* Examples of matching regexps for certain filenames can be found on the [[TV Shows (Video Library)|TV shows]] page.

:* For multi-episode matching to work, there needs to be a third set of parentheses '()' at the end, this part is fed back into the regexp engine.

:* A [http://forum.kodi.tv/showthread.php?t=51614 forum thread] has a discussion of pre-made regex lists to match common names. These might improve Kodi's ability to match TV show names in some situations, at the risk of additional false positives.

==== Filenames without Season ====
There are two methods to add episodes without a season in their file path. Both ways will force the season to '1' by default, so that you can use
the 'Use Absolute Ordering (Single Season)' setting from the TheTvDb.com scraper.

; Simple Method ''(XBMC v9.11 onwards and Kodi)''
: Use only one pair of parentheses
<syntaxhighlight lang="xml" enclose="div"><regexp>[/\._ \-]([0-9]+)</regexp></syntaxhighlight>
; Advanced Method ''(XBMC v10.05 onwards and Kodi)''
: Supports multi-episode files without season
: Use an empty pair of parentheses for the season
<syntaxhighlight lang="xml" enclose="div"><regexp>[/\._ \-]()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

; Specifying Default Season ''(XBMC v12.0 onwards and Kodi)''
It is possible to set the default season for specific regular expressions by setting the 'defaultseason' attribute.
: Works with both the simple method and advanced method
: If not used, the season will be set to '1'
: Useful for setting specials to season '0'
<syntaxhighlight lang="xml" enclose="div"><regexp defaultseason="0">[/\._ \-]X()([0-9]+)(-[0-9]+)?</regexp>
<regexp defaultseason="1">[/\._ \-]E()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

=== tvmultipartmatching ===
{{anchor|.3Ctvmultipartmatching.3E}}
Matches a multipart episode number based on a previously identified episode file, using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''.

Default:
<syntaxhighlight lang="xml" enclose="div">
<tvmultipartmatching>^[-_ex]+([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)</tvmultipartmatching>
</syntaxhighlight>
:* Text matching is compared case-insensitive.
:* Specifying this option '''replaces''' the default value

=== excludefromscan ===
{{anchor|.3Cexcludefromscan.3E}}
Matches filenames or folders which should be excluded from a library scan (except tvshows) using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. This can be for both Video or Audio sections of <tt>advancedsettings.xml</tt>.

Defaults:
<syntaxhighlight lang="xml" enclose="div">
<video>
<excludefromscan>
<regexp>-trailer</regexp>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludefromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== excludefromlisting ===
{{anchor|.3Cexcludefromlisting.3E}}
<syntaxhighlight lang="xml" enclose="div">
<video>
<excludefromlisting> 
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>
</video>
</syntaxhighlight>

=== excludetvshowsfromscan ===
{{anchor|.3Cexcludetvshowsfromscan.3E}}
Matches filenames or folders which should be excluded from a tvshow library scan using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

Defaults:
<syntaxhighlight lang="xml" enclose="div">
<video>
<excludetvshowsfromscan>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludetvshowsfromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== trailermatching ===
{{anchor|.3Ctrailermatching.3E}}
Contains "''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''" syntax (commonly referred to as "''[[Regular Expression (RegEx) Tutorial|RegEx]]''" or "''[[Regular Expression (RegEx) Tutorial|RegExp]]''") to match the locally stored trailers to movies in the library.

<syntaxhighlight lang="xml" enclose="div">
<trailermatching>

<regexp>(.*?)(_Trailer)(\.[^.]+)$</regexp>
</trailermatching>
</syntaxhighlight>

=== videolibrary ===
{{anchor|.3Cvideolibrary.3E}}
Options specific to the Video Library

<syntaxhighlight lang="xml" enclose="div">
<videolibrary>
<allitemsonbottom>false</allitemsonbottom> 
<cleanonupdate>false</cleanonupdate> 
<usefasthash>true</usefasthash> 
<recentlyaddeditems>35</recentlyaddeditems> 
<itemseparator> / </itemseparator> 
<exportautothumbs>false</exportautothumbs> 
<importwatchedstate>false</importwatchedstate> 
<importresumepoint>false</importresumepoint> 
<dateadded>1</dateadded> 
</videolibrary>
</syntaxhighlight>

=== videoscanner ===
{{anchor|.3Cvideoscanner.3E}}
Options specific to the Video scanner
<syntaxhighlight lang="xml" enclose="div">
<videoscanner>
<ignoreerrors>true</ignoreerrors> 
</videoscanner>
</syntaxhighlight>

== Library artwork ==

=== imageres ===
{{anchor|.3Cimageres.3E}}
This tag is new for v12 (Frodo), replacing <thumbsize>.

<section begin="imageres description" />Specify the maximal resolution that art should be resized to in pixels. The width is automatically calculated as being 16/9*height. The image will be resized to fit within this size. e.g. an image that is 2000x500 will be cached at size 1280x320. An image that is 500x800 will be cached at size 450x720 using the default value of 720.<section end="imageres description" />

<syntaxhighlight lang="xml" enclose="div">
<imageres>720</imageres>
</syntaxhighlight>

=== fanartres ===
{{anchor|.3Cfanartres.3E}}
This tag is new for v12 (Frodo), replacing <fanartheight>.

<section begin="fanartres description" />Specify the resolution that cached fanart should be resized to in pixels. The width is automatically calculated as being 16/9*height. Only images that are exactly 16x9 and equal to or greater than this resolution will be cached at this size - all other images will be cached using <imageres>. The default value is 1080.<section end="fanartres description" />

<syntaxhighlight lang="xml" enclose="div">
<fanartres>1080</fanartres>
</syntaxhighlight>

=== fanart ===
{{anchor|.3Cfanart.3E}}
As of v12 (Frodo), this tag is only used for music and not video.

A list of additional files to try when searching for fanart images. (The defaults are fanart.jpg and fanart.png which can be removed.)

Example:
<syntaxhighlight lang="xml" enclose="div">
<fanart>
<remove>fanart.jpg</remove>
<add>backdrop.jpg</add>
</fanart>
</syntaxhighlight>

=== musicthumbs ===
{{anchor|.3Cmusicthumbs.3E}}
<section begin="musicthumbs" />A list of additional files to try when searching for music thumbnail images. (The default is folder.jpg which can be removed.)

Example:
<syntaxhighlight lang="xml" enclose="div">
<musicthumbs>
<remove>folder.jpg</remove>
<add>thumb.jpg|cover.jpg</add>
</musicthumbs>
</syntaxhighlight><section end="musicthumbs" />

=== imagescalingalgorithm ===
Specify the image scaling algorithm for image resizing/caching i.e. posters, fanart, etc.
<br />
<syntaxhighlight lang="xml" enclose="div">
<imagescalingalgorithm>bicubic</imagescalingalgorithm>
</syntaxhighlight>

[https://github.com/xbmc/xbmc/blob/1a8753d5cd93890dc6a9f9d4b2ce8848066ea5d0/xbmc/pictures/PictureScalingAlgorithm.cpp#L32-L43 Available image scaling algorithms]

<syntaxhighlight lang="text" enclose="div">
fast_bilinear
bilinear
bicubic
experimental
nearest_neighbor
averaging_area
bicublin
gaussian
sinc
lanczos
bicubic_spline
</syntaxhighlight>

== Video and music library settings ==

=== playlistasfolders ===
{{anchor|.3Cplaylistasfolders.3E}}
In the recent releases, playlists are treated as folders. Selecting a playlist no longer plays it, but opens it, as if it were a folder.

Set to false to revert to the previous behaviour. When you select a playlist, its content is added to the list of elements to be played.

:{{note|This setting will not affect smart playlists, they will always show as folders.}}

;Example
<syntaxhighlight lang="xml" enclose="div">
<playlistasfolders>true</playlistasfolders>
</syntaxhighlight>

=== playlistretries ===
{{anchor|.3Cplaylistretries.3E}}
The number of retries attempted if a source is offline. With this control you can alter the number of consecutive failed items before a playlist fails.

Default:
<syntaxhighlight lang="xml" enclose="div">
<playlistretries>100</playlistretries>
</syntaxhighlight>

=== playlisttimeout ===
{{anchor|.3Cplaylisttimeout.3E}}
The timeout, in seconds, before item failure.

Default:
<syntaxhighlight lang="xml" enclose="div">
<playlisttimeout>20</playlisttimeout>
</syntaxhighlight>

=== musicdatabase/videodatabase ===
{{anchor|.3Cmusicdatabase.3E/.3Cvideodatabase.3E|musicdatabase/videodatabase|database tags music/video/tv/epg/adsp}}
{{main|MySQL}}
<section begin="videodatabase" />
Allows advanced customization of the default database settings for music, video, TV, EPG, and ADSP databases.

:{{note| '''It is HIGHLY recommended that you not attempt to place an sqlite3 database outside of kodi's path. sqlite3 contains no filesystem abstraction, so this will plain break on any non-local (as far as Kodi is concerned) paths. Use this for mysql only.'''}}

'''Parent tags:'''

* '''<videodatabase>'''
* '''<musicdatabase>'''
* '''<tvdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
* '''<epgdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
* '''<adspdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
{{MySQL warning}}

'''Child tags: '''

;<type>
: ''Required'' - Can be either "sqlite3" or "mysql" (default: sqlite3)

;<host>
:''Required'' -
* sqlite3: defines the relative path to the database file (eg. /usr/local/kodi/databases).
* mysql: defines the host of the mysql socket (eg. localhost, 192.168.0.1, etc)

;<port>
: ''Optional'' -
* sqlite3: silently ignored
* mysql: defines the port of the mysql socket (default: 3306)

;<name>
: ''Optional'' -
:by default "MyVideos"+DB number will be used.
* sqlite3: defines the name of the database file to read from, excluding the ".db" extension.
* mysql: defines the name of the database to use

;<user>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the user with privileged access to the database

;<pass>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the password for the user with privileged access to the database

;<compression>
: ''Optional'' - Defaults to false. Set to "true" to enable MySQL compression protocol. Performance benefit is going to be largely dependent on the network bandwidth, latency between database and clients and on the size of the result sets. [https://github.com/xbmc/xbmc/pull/6484]
: {{Note|Slower clients (such as the RPi and others) won't benefit from it as the zlib de-compression overhead is higher than the actual compression savings}}

;<key>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<cert>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ca>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<capath>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ciphers>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

'''Examples:'''

1) Configure a database for MySQL.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', '''<epgdatabase>''', and '''<adspdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang="xml" enclose="div">
<videodatabase>
<type>mysql</type>
<host>192.168.0.10</host>
<name>kodi_video</name>
<user>kodi</user>
<pass>kodi</pass>
</videodatabase>
</syntaxhighlight>

2) Configure a database for an sqlite database.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', '''<epgdatabase>''', and '''<adspdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang="xml" enclose="div">
<musicdatabase>
<type>sqlite3</type>
<host>/usr/local/share/kodi/databases</host>
</musicdatabase>
</syntaxhighlight>

<section end="videodatabase" />

=== externalplayer ===
{{anchor|.3Cexternalplayer.3E}}
{{see|External players}}

== Music settings ==

=== musicextensions ===
{{anchor|.3Cmusicextensions.3E}}
<section begin="musicextensions" />
Default extensions for MUSIC:
<pre>
.nsv .m4a .flac .aac .strm .pls .rm .rma .mpa .wav .wma .ogg .mp3 .mp2 .m3u .gdm .imf .m15 .sfx
.uni .ac3 .dts .aif .aiff .wpl .ape .mac .mpc .mp+ .mpp .shn .wv .dsp .xsp .xwav .waa .wvs .wam
.gcm .idsp .mpdsp .mss .spt .rsd .sap .cmc .cmr .dmc .mpt .mpd .rmt .tmc .tm8 .tm2 .oga .url
.pxml .tta .rss .wtv .mka .tak .opus .dff .dsf .m4b .cue .zip .rar
</pre>

It is possible to add or remove extensions for Music, using the following XML tags. Useful if you keep, say, FLAC and mp3 versions of music in the same folder. The <remove> tag can be used to remove mp3 from being listed in the library, leaving only the higher quality FLAC being displayed.

<musicextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</musicextensions>

<section end="musicextensions" />

=== cddbaddress ===
{{anchor|.3Ccddbaddress.3E}}
The address of the online CDDb database. You may set this to another freedb mirror if there is a more suitable one.

Default:
<syntaxhighlight lang="XML" enclose="div>
<cddbaddress>freedb.freedb.org</cddbaddress>
</syntaxhighlight>

=== songinfoduration ===
{{anchor|.3Csonginfoduration.3E}}
This controls how long the song information will remain onscreen when the song changes during visualisations. The valid range is "1" to "Indefinite (0)", in seconds. This does not include the duration of any transition effects.

Default:
<syntaxhighlight lang="xml" enclose="div">
<songinfoduration>10</songinfoduration>
</syntaxhighlight>

=== musicfilenamefilters ===
{{anchor|.3Cmusicfilenamefilters.3E}}
Contains filters to match music information (artist, title etc.) from a tag-less music filename. The first <filter> to match completely is used. Matched items include:

<pre>
%A - Artist
%T - Title
%B - Album
%N - Track number
%S - Part of set (disk number)
%D - Duration
%G - Genre
%Y - Year
%R - Rating
</pre>

Example:
<syntaxhighlight lang="xml" enclose="div">
<musicfilenamefilters>
<filter>%A - %T</filter>
</musicfilenamefilters>
</syntaxhighlight>

=== musiclibrary ===
{{anchor|.3Cmusiclibrary.3E}}
Options specific to the Music Library

<syntaxhighlight lang="xml" enclose="div">
<musiclibrary>
<hideallitems>true</hideallitems>  
<allitemsonbottom>true</allitemsonbottom> 
<promptfulltagscan>false</promptfulltagscan> 
<recentlyaddeditems>35</recentlyaddeditems> 
<albumformat>%B - %Y</albumformat> 
<prioritiseapetags>true</prioritiseapetags> 
<itemseparator> / </itemseparator> 
<artistseparators> 
<separator>;</separator>
<separator>:</separator>
<separator>|</separator>
<separator> feat. </separator>
<separator> ft. </separator>
</artistseparators>
<dateadded>1</dateadded> 
</musiclibrary>
</syntaxhighlight>
<br />
{{Note|Changing the <itemseparator> or <artistseparators> will only affect newly added items. Even a rescan won't change the added ones, you have to remove the music source(s) and add them again, or delete the music database to achieve this. This process should be made easier in v18 using <promptfulltagscan> (that is not available in v17)}}

== Photos settings ==

=== pictureextensions ===
{{anchor|.3Cpictureextensions.3E}}
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Pictures window.

Default extensions for PICTURES:
<pre>
.png .jpg .jpeg .bmp .gif .ico .tif .tiff .tga .pcx .cbz .cbr .rss .webp .jp2 .apng
</pre>

Examples:
<syntaxhighlight lang="xml" enclose="div">
<pictureextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</pictureextensions>
</syntaxhighlight>

=== pictureexcludes ===
{{anchor|.3Cpictureexcludes.3E}}
Matches filenames or folders which should be excluded from being displayed in My Pictures using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

<syntaxhighlight lang="xml" enclose="div">
<pictureexcludes> 
<regexp>small</regexp>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</pictureexcludes>
</syntaxhighlight>

=== slideshow ===
{{anchor|.3Cslideshow.3E}}
<syntaxhighlight lang="xml" enclose="div">
<slideshow>

<panamount>2.5</panamount>

<zoomamount>5.0</zoomamount>



<blackbarcompensation>20</blackbarcompensation>
</slideshow>
</syntaxhighlight>

== Network settings ==

=== samba ===
{{anchor|.3Csamba.3E}}
<syntaxhighlight lang="xml" enclose="div">
<samba>
<doscodepage></doscodepage> 
<clienttimeout>10</clienttimeout> 
<statfiles>true</statfiles> 
</samba>
</syntaxhighlight>

=== hosts ===
{{anchor|.3Cfhosts.3E}}
Static dns entries which take precedence over your dns server.
<syntaxhighlight lang="xml" enclose="div">
<hosts>
<entry name="HOSTNAME">IPADDRESS</entry>
</hosts>
</syntaxhighlight>

=== network ===
{{anchor|.3Cnetwork.3E}}
{{see also|HOW-TO:Modify the cache}}
<syntaxhighlight lang="xml" enclose="div">
<network>
<curlclienttimeout>10</curlclienttimeout> 
<curllowspeedtime>20</curllowspeedtime> 
<curlretries>2</curlretries> 
<httpproxyusername></httpproxyusername> 
<httpproxypassword></httpproxypassword> 
</network>
</syntaxhighlight>

{{Note|In Kodi v17, the three buffer settings are removed from the <code><network></code> tag and now placed under the new <code><cache></code> tag. See '''[[#cache]]''' for full details.}}

=== cache ===
{{see also|HOW-TO:Modify the cache}}
<syntaxhighlight lang="xml" enclose="div">
<cache>
<memorysize>0</memorysize> 
<buffermode>0</buffermode> 
<readfactor>4.0</readfactor> 
</cache>
</syntaxhighlight>

=== airtunesport ===
{{anchor|.3Cairtunesport.3E}}<section begin="airtunesport" />
This overwrites the defalt listening port of the AirTunes server (announced via zeroconf).
<section end="airtunesport" />

=== airplayport ===
{{anchor|.3Cairplayport.3E}}<section begin="airplayport" />
This overwrites the default listening port of the AirPlay server (announced via zeroconf).
<section end="airplayport" />

== File system settings ==

=== packagefoldersize ===
<section begin="packagefoldersize" />
{{anchor|.3Cpackagefoldersize.3E}}
{{xml setting
| tag name = packagefoldersize
| option type = numerical
| option values =
| default values = 200
| platform = all
| XBMC version = 12
| description = The amount (in megabytes) of add-on zip packages saved from previous add-on installs. These packages are mainly used for the [[add-on]] rollback feature. Increasing the size should increase the amount of past versions saved. Defaults to 200 MB.
| example = Example: <syntaxhighlight lang="xml" enclose="div"><packagefoldersize>200</packagefoldersize> </syntaxhighlight>
}}
<section end="packagefoldersize" />

=== detectasudf ===
{{anchor|.3Cdetectasudf.3E}}
Set to true if you wish to detect joint ISO9660/UDF disks as UDF.

Default: False

=== pathsubstitution ===
{{anchor|.3Cpathsubstitution.3E}}
{{main|Path substitution}}
Path substitutions are for use for redirecting file paths. These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for Kodi to handle.

Default: No path substitutions defined.

Example:
<syntaxhighlight lang="xml" enclose="div">
<pathsubstitution>
<substitute>
<from>G:\dvds\</from>
<to>smb://somecomputer/g-share/dvds/</to> 
</substitute>
</pathsubstitution>
</syntaxhighlight>

== Input control settings ==

=== remotedelay ===
{{anchor|.3Cremotedelay.3E}}
The repeat delay for a LIRC remote control. A delay value between 1 and 20 before a remote button starts repeating on a long keypress (i.e. continuously sending button pushes while it's held down).

Default: 3
<syntaxhighlight lang="xml" enclose="div">
<remotedelay>10</remotedelay>
</syntaxhighlight>

=== controllerdeadzone ===
{{anchor|.3Ccontrollerdeadzone.3E}}
This advanced settings has been removed. See [[HOW-TO:Controller deadzone]].

=== enablemultimediakeys ===
{{anchor|.3Cenablemultimediakeys.3E}}
This setting only has any effect on Windows versions of Kodi, and only applies to builds from 28th May 2011 onwards.
In Windows the multimedia keys generate a WM_APPCOMMAND message in addition the keypress. Kodi processes both keypresses and the WM_APPCOMMAND messages, and the end result would be that the command is executed twice. To avoid this, by default multimedia keypresses are disabled. Although it should rarely be necessary, the enablemultimediakeys setting allows you to enable the multimedia keys.

Example:
<syntaxhighlight lang="xml" enclose="div">
<enablemultimediakeys>true</enablemultimediakeys>
</syntaxhighlight>

=== seeksteps ===
{{Main|Skip steps}}

This setting changes which increments are available in the settings GUI for additive seeking. Note that <code><seeksteps></code> is not used to actually choose which seek steps are enabled.

'''Default:'''
<syntaxhighlight lang="xml" enclose="div">
<seeksteps>7, 15, 30, 60, 180, 300, 600, 900, 1800</seeksteps>
</syntaxhighlight>

{{editor note|the defaults need to be updated for seeksteps.}}

=== touchscreen ===
{{anchor|.3Ctouchscreen.3E}}
This setting allows you to move/align the origin of the touch screen with the origin of the display used. If touch input does not result in a correct movement of the mouse pointer, the behaviour can be corrected with an offset and a stretch/compress factor.

Example:
<syntaxhighlight lang="xml" enclose="div">
<touchscreen>
<x_offset>0</x_offset> 
<y_offset>0</y_offset> 
<x_stretch_factor>1.0</x_stretch_factor> 
<y_stretch_factor>1.0</y_stretch_factor> 
</touchscreen>
</syntaxhighlight>

== Other interface settings ==

=== window ===
{{anchor|.3Cwindow.3E}}
{{note|This is a "hidden" guisettings.xml setting (defined by the mouse moving the window size), but it is mentioned here because it is a particularly useful override when used in advancedsettings.xml}}
This allows you to manually set the default size of Kodi's windowed mode. If you resize the window, it will return to the set size when restarting.

WIDTH and HEIGHT are the values for each dimension, in pixels.

<syntaxhighlight lang="xml" enclose="div">
<window>
<width>WIDTH</width>
<height>HEIGHT</height>
</window>
</syntaxhighlight>

=== restrictcapsmask ===
{{anchor|.3Crestrictcapsmask.3E}}
Windows only. A bitmask to prevent Kodi from using detected texture capabilities of the GPU. This helps work around buggy hardware/drivers.

1: prevent the use of compressed textures (DXT1, DXT3, DXT5)
2: prevent the use of non-power-of-two dimensions for textures
4: prevent the use of compressed textures with non-power-of-two dimensions.

<syntaxhighlight lang="xml" enclose="div">
<restrictcapsmask>0</restrictcapsmask>
</syntaxhighlight>

=== algorithmdirtyregions ===
{{anchor|.3Calgorithmdirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="algorithmdirtyregions" />{{note|Some GPU/hardware configurations will have some minor issues (such as a visual "flicker"). For those situations try mode 2 or use the default (mode 3, which requires no advancedsetting). Almost all ARM-based devices (such as [[Android]]) willl likely have flickering issues.}}

Enable dirty-region processing. Dirty regions are any parts of the screen that have changed since the last frame. By not re-rendering what hasn't changed the GUI can be sped up. Because all GPUs work differently, only Mode 3, combined with nofliptimeout=0, is guaranteed to work for everyone without flickering issues. This mode will reduce CPU/GPU usage, but will not increase GUI speed.

{| class="prettytable"
! value !! result !! description
|-
! 0
| Off
| The entire viewport is always rendered.
|-
! 1
|Union
|All dirty regions are grouped into the smallest possible rectangle. This is typically the fastest mode for slower GPUs due to only making one pass.
|-
! 2
| {{nowrap|Cost reduction}}
| Each dirty region is presented separately, in as many passes as there are regions.
|-
! 3
| {{nowrap|Whole Screen}}
| The entire screen is rendered if there are any dirty regions. This, combined with nofliptimeout is a safe default for drivers that clear buffer contents (manifests as blinking or vibrating images). '''Default'''
|}<section end="algorithmdirtyregions" />

Example:
<syntaxhighlight lang="xml" enclose="div">
<gui>
<algorithmdirtyregions>1</algorithmdirtyregions>
</gui>
</syntaxhighlight>

=== visualizedirtyregions ===
{{anchor|.3Cvisualizedirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="visualizedirtyregions" />Enable dirty-region visualization. Paints a rectangle over marked controls.

* true: on
* false: off '''(Default)'''

{{note|This is only a development mode and isn't of use to normal users.}}
<section end="visualizedirtyregions" />
Example:
<syntaxhighlight lang="xml" enclose="div">
<gui>
<visualizedirtyregions>true</visualizedirtyregions>
</gui>
</syntaxhighlight>

=== showexitbutton ===
{{anchor|.3Cshowexitbutton.3E}}
Setting to hide the exit button, useful for people running appliance based setups where exit would only confuse/complicate the user. Modifiable via the advancedsettings.xml by setting showexitbutton to false, default is true (show)

Example:
<syntaxhighlight lang="xml" enclose="div">
<showexitbutton>true</showexitbutton>
</syntaxhighlight>

=== fullscreen ===
{{anchor|.3Cfullscreen.3E}}
Starts Kodi in full screen (check resolutions!).

<syntaxhighlight lang="xml" enclose="div">
<fullscreen>false</fullscreen>
</syntaxhighlight>

=== splash ===
{{anchor|.3Csplash.3E}}
Set to false if you wish to disable the startup splash image. Defaults to true.

<syntaxhighlight lang="xml" enclose="div">
<splash>true</splash>
</syntaxhighlight>

=== cputempcommand ===
{{anchor|.3Ccputempcommand.3E}}
Provide a shell command Kodi will use to get CPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia and Raspberry Pi</u>
<syntaxhighlight lang="xml" enclose="div">
<cputempcommand>sed -e 's/$[0-9]*$[0-9]\{3\}.*/\1 C/' /sys/class/thermal/thermal_zone0/temp</cputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang="xml" enclose="div">
<cputempcommand>echo "$(sensors -u | tail -n64 | grep temp1_input | awk '{print $2 }' |awk '{printf("%d\n",$1 + 0.5);}') C"</cputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang="xml" enclose="div">
<cputempcommand>sensors|sed -ne "s/temp1: \+[-+]$[0-9]\+$.*/\1 C/p"</cputempcommand>
</syntaxhighlight>

=== gputempcommand ===
{{anchor|.3Cgputempcommand.3E}}
Provide a shell command Kodi will use to get GPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia</u>
<syntaxhighlight lang="xml" enclose="div">
<gputempcommand>echo "$(nvidia-settings -tq gpuCoreTemp) C"</gputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang="xml" enclose="div">
<gputempcommand>echo "$(nvidia-smi -q -d TEMPERATURE | grep Gpu | cut -c35-36) C"</gputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang="xml" enclose="div">
<gputempcommand>/usr/bin/aticonfig --od-gettemperature | grep Temperature | cut -f 2 -d "-" | cut -f 1 -d "." | sed -e "s, ,," | sed 's/$/ C/'</gputempcommand>
</syntaxhighlight>

;<u>For Raspberry Pi</u>
<syntaxhighlight lang="xml" enclose="div">
<gputempcommand>/opt/vc/bin/vcgencmd measure_temp | sed -e "s/temp=//" -e "s/\..*'/ /"</gputempcommand>
</syntaxhighlight>

=== glrectanglehack ===
{{anchor|.3Cglrectanglehack.3E}}
Problems with ghosting or videos which are only played back in the left upper quarter? The following ATI hack may solve it.
<syntaxhighlight lang="xml" enclose="div">
<glrectanglehack>yes</glrectanglehack>
</syntaxhighlight>

=== alwaysontop ===
{{anchor|.3Calwaysontop.3E}}
Added in XBMC v9.11 (Windows OS only). Keeps Kodi always on top when windowed.
<syntaxhighlight lang="xml" enclose="div">
<alwaysontop>yes</alwaysontop>
</syntaxhighlight>

There is also a fake fullscreen GUI option in Kodi's settings.

== Removed tags ==
{{anchor|Recently removed tags}}
* {{anchor|.3Cthumbsize.3E}}'''<thumbsize>''' - replaced by <[[#imageres|imageres]]> in v12 Frodo
* {{anchor|.3Cfanartheight.3E}}'''<fanartheight>''' - replaced by <[[#fanartres|fanartres]]> in v12 Frodo
* {{anchor|.3Cdvdthumbs.3E}}'''<dvdthumbs>''' - removed in v12 Frodo
* {{anchor|.3Cbusydialogdelayms.3E}}'''<busydialogdelayms>''' - removed in v12 Frodo
* {{anchor|.3Cbginfoloadermaxthreads.3E}}'''<bginfoloadermaxthreads>''' - removed in v13 Gotham
* '''<showepginfoonselect>''' - replaced by a GUI setting in v13 Gotham
* '''<resample>''', '''<forceDirectSound>''', '''<audiophile>''', '''<audiosinkbufferdurationmsec>''', '''<allowtranscode44100>''', and '''<streamsilence>''' - These were various sub-tags for <audio> that were removed in v13 Gotham and either replaced by GUI settings or were no longer needed.
* {{anchor|.3Cenableairtunesdebuglog.3E}}'''<enableairtunesdebuglog>''' - replaced by a GUI option in v14 Helix
* '''<videoDisableHi10pMultithreading>''' - renamed to <disableswmultithreading> in v14 Helix
* '''<hideallitems>''' - For both the <code><videolibrary></code> and <code><musiclibrary></code> sections, this is replaced by a GUI option in v15 Isengard
* '''<SmallStepBackSeconds>''' - In v15 the <code>SmallStepBack</code> [[action ID]] has been replaced by <code>seek(-7)</code> in default keymaps. See '''[[skip steps]]''' for details. When the original <code>SmallStepBack</code> action ID is used it defaults to the first backwards [[skip steps|additive seeking value]].
* '''<timeseekforward>/<timeseekbackward>''' - In v15 these tags are replaced by GUI options via [[skip steps|additive seeking]], which is configured in the GUI. See '''[[skip steps]]''' for details.
* {{anchor|.3Ckaraoke.3E}}'''<karaoke>''' - In v16 all of the karaoke features in Kodi were removed.
* '''<useddsfanart>''' - removed in v17 Krypton.
* '''<cachemembuffersize>''' and '''<readbufferfactor>''' - In v17 '''<cachemembuffersize>''' is renamed to '''<memorysize>''' and <code><readbufferfactor></code> is renamed to <code><readfactor></code>. In addition, all three buffer related settings in <network> are moved out of <network> and into a new <cache> parent tag.
* '''<minvideocachelevel>''', '''<minaudiocachelevel>''', and '''<cacheindvdplayer>''' have been removed in v17.
* '''<useffmpegvda>''' - Tag was only used for development testing. Removed in v17.
* '''<nofliptimeout>''' - Removed in v17
* '''<blackbarcolour>''' - Removed in v17 (maybe?)
* '''<disableswmultithreading>''' - Removed in v17 (maybe?)
* {{anchor|.3Cmeasurerefreshrate.3E}}'''<measurerefreshrate>''' - Removed in v17 or v18?
* {{anchor|.3Cmyth.3E}}'''<myth>''' - Removed sometime between v16 to v18
* {{anchor|.3Ctuxbox.3E}}'''<tuxbox>''' - Removed
* '''<backgroundupdate>''' - Removed
* '''<hideemptyseries>''' - Replaced by a GUI option.
* '''<mymovies>''' and child tag '''<categoriestogenres>''' - Removed
* '''<albumssortbyartistthenyear'''> - Removed
* '''<albumformatright>''' - Removed
* {{anchor|.3Cremoterepeat.3E}}'''<remoterepeat>''' - Removed
* {{anchor|.3Callowd3d9ex.3E}}'''<allowd3d9ex>''' and {{anchor|.3Cforced3d9ex.3E}}'''<forced3d9ex>''' - Removed sometime between v16 to v18
* '''<lingertime>''' - Replaced by a GUI setting in v18

== guisettings.xml settings ==
You can also define the settings normally defined in the GUI (and stored in guisettings.xml) in advancedsettings.xml. Most guisettings.xml settings defined in advancedsettings.xml will override the guisettings.xml values, and the settings will be removed completely from the interface.

The easiest way to include a guisettings.xml setting is to first change the setting in the interface to the value that you want, and then open the '''[[userdata]]/guisettings.xml''' file and find the XML entry that corresponds to that setting.

Then just add that entry to the advancedsettings.xml file.

For instance, to set the Font Character Set (found in the appearance setting, in the Look and Feel section), you'd open up guisettings.xml and find:

<syntaxhighlight lang="xml" enclose="div">
<lookandfeel>
<charset>Hebrew (Windows)</charset>
</lookandfeel>
</syntaxhighlight>

Simply take that entry and place it in advancedsettings.xml. The option in Kodi's interface for the character set will then no longer be visible, and Kodi will always use the Hebrew (Windows) character set.

{{Updated|17}}
{{DISPLAYTITLE:advancedsettings.xml}}

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

Advancedsettings.xml

2017-10-23T12:50:17Z

Ksooo: /* Removed tags */

{{TOC right}}{{mininav|[[Settings]]|page=advancedsettings.xml}}
{{bigger|{{note|'''The advancedsettings.xml file does not exist by default. You have to create it first!'''}} }}

<section begin="intro" />The [[advancedsettings.xml]] file, which does not exist by default, can be created by a user in their '''[[userdata folder]]'''.

This file is used for advanced settings and options that do not have GUI controls inside of {{kodi}}. Some settings are experimental or very rarely set, so they can only be used via the advancedsettings.xml file. The file is simply a plain text file and can be edited by various text editors, so long as the name is "advancedsettings.xml". These advanced settings can be used to tweak various things such as episode naming patterns, special network ports, special behaviors, and more.<section end="intro" />

The following page will describe the structure of the advancedsettings.xml file and the various individual settings.

{{note|
# All XML tags must be lowercase. The start and end of the advancedsettings.xml file must have the <advancedsettings> and </advancedsettings> tags.
# Kodi will only read the advancedsettings.xml file when it starts up. If you make changes while it is running then you must restart Kodi.
# For some Windows versions, Kodi has two <code>\userdata\</code> folders. The correct one to put the advancedsettings.xml file in is not the one in Program Files, but in <code>%appdata%\Kodi\userdata\.</code>}}

== Layout ==

The layout of <code>advancedsettings.xml</code> is as follows:

<syntaxhighlight lang="xml" enclose="div">
<advancedsettings>
<setting>value</setting>
...
<setting>value</setting>
</advancedsettings>
</syntaxhighlight>

where "setting" gives the name of the setting, and "value" gives its value.

A list of the available "setting" strings and their values is given below.

= List of available settings =

== Troubleshooting settings ==

=== loglevel ===
{{Anchor|.3Cloglevel.3E}}
{{see also|debug log}}
<section begin="loglevel" />
{{xml setting
| tag name = loglevel
| tag attribute = hide
| tag attribute values =
{{option values
| value1= true | value1 description= Hides "enable debugging" guisetting.
| value2= false | value2 description= "enable debugging" guisetting will switch between min(loglevel, 0) and max(loglevel, 2) for off and on respectively. '''(Default)'''
}}
| tag attribute default values = true
| option values =
{{option values
| value1= -1 | value1 description= No logging, suppresses all log output
| value2= 0 | value2 description= Normal logging, only logging errors '''(Default)'''
| value3= 1 | value3 description= Debug logging ''(without showing text on screen)''
| value4= 2 | value4 description= Debug logging with freemem, fps and cpu usage shown on screen
| value5= 3 | value5 description= Debug logging with freemem, fps and cpu usage and full smb logging
}}
| default values = 0
| description =
The logging level that Kodi will use to log errors and information. The "hide" attribute is optional.
| example =
Example:
<syntaxhighlight lang="xml" enclose="div">
<loglevel hide="false">1</loglevel>
</syntaxhighlight>

<br />

{{Note| If debugging is switched on in the GUI, loglevel will be set to 2 (''log to both file and on-screen information''); this will over-ride any <code>advancedsettings.xml</code> setting.}}<br />

{{Note| If debugging is switched on in the GUI when Kodi is shut down, then it will be automatically be re-enabled at level 2 when it is re-started. This is true even if 'hide' is subsequently set to 'true' - in other words, if you enable it in the GUI and then hide the GUI toggle, it will stay on level 2 irrespective of what you subsequently set in <code>advancedsettings.xml</code>.}}<br />
}}
<section end="loglevel" />

=== jsonrpc ===
{{Anchor|.3Cjsonrpc.3E}}
To make it easier for developers using the [[JSON RPC]] API in their (third party) applications to debug during development the json output of Kodi can be prettified by setting '''compactoutput''' to '''false'''. Default json output mode is a compact print which does not contain any unnecessary whitespaces and therefore is difficult to read for humans.
Furthermore using the '''tcpport''' setting it is possible to change the default TCP port used by Kodi for JSON RPC (which is 9090) to any other valid port.

Example:
<syntaxhighlight lang="xml" enclose="div">
<jsonrpc>
<compactoutput>false</compactoutput>
<tcpport>9999</tcpport>
</jsonrpc>
</syntaxhighlight>

== Audio/video playback settings ==

=== skiploopfilter ===
{{anchor|.3Cskiploopfilter.3E}}
The amount of the loop filter to skip on h.264 decoding. This can help the performance of slower machines when decoding h264 content. Values, in decreasing CPU usage (and decreasing quality)
* -16 None
* 0 Skip only empty frames (default)
* 8 Skip non-reference frames
* 16 Skip bi-dir frames
* 32 Skip all non-key frames
* 48 Skip all frames
Example:
<syntaxhighlight lang="xml" enclose="div">
<skiploopfilter>8</skiploopfilter>
</syntaxhighlight>

=== video ===
{{anchor|.3Cvideo.3E}}

The <video> section also includes the following child-tags, which have their own sections:
*[[#cleandatetime]]
*[[#cleanstrings]]
*[[#excludefromscan]]
*[[#excludefromlisting]]
*[[#excludetvshowsfromscan]]

{{note|Some tags that have a "third-level" and are grouped together are highlighted in color.}}

{| class="prettytable"
! Tag !! Description
|-
|
<syntaxhighlight lang="xml">
<video>
</syntaxhighlight>
| Parent tag that all other child tags need to be placed inside of. Do not use more than one '''<code><video></code>''' tag, but instead place all other child-tags within a single '''<code><video></video></code>''' set.
|-
|
<syntaxhighlight lang="xml">
<subsdelayrange>10</subsdelayrange>
</syntaxhighlight>
| Delay range for subtitles, in seconds.
|-
|
<syntaxhighlight lang="xml">
<audiodelayrange>10</audiodelayrange>
</syntaxhighlight>
| Delay range for audio/video sync, in seconds.
|-
|
<syntaxhighlight lang="xml">
<usetimeseeking>true</usetimeseeking>
</syntaxhighlight>
| Whether to use time based or percentage based seeking. {{small see also|HOW-TO:Modify time seeking}}
|-
|
<syntaxhighlight lang="xml">
<timeseekforwardbig>600</timeseekforwardbig>
<timeseekbackwardbig>-600</timeseekbackwardbig>
</syntaxhighlight>
| Time to seek forward in seconds when doing a long seek. Defaults to 600 (10 minutes) and -600 (-10 minutes) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang="xml">
<percentseekforward>2</percentseekforward>
<percentseekbackward>-2</percentseekbackward>
</syntaxhighlight>
| Amount to seek forward as a percentage, when doing a short seek. Defaults to 2 (2%) and -2 (2%) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang="xml">
<percentseekforwardbig>10</percentseekforwardbig>
<percentseekbackwardbig>-10</percentseekbackwardbig>
</syntaxhighlight>
| Amount to seek forward as a percentage, when doing a long seek. Defaults to 10 (10%) and -10 (10%) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang="xml">
<fullscreenonmoviestart>true</fullscreenonmoviestart>
</syntaxhighlight>
| Whether to go to fullscreen or not when starting a movie. Defaults to true.
|-
|
<syntaxhighlight lang="xml">
<defaultplayer>VideoPlayer</defaultplayer>
</syntaxhighlight>
| Set the default video player: VideoPlayer or an external player. See '''[[External players]]''' for more info.
|-
|
<syntaxhighlight lang="xml">
<excludefromscan>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromscan>
</syntaxhighlight>
| Regular expressions that if evaluated to true won't be added to library. It is possible to add multiple <code><regexp></code> tags to match multiple patterns
|-
|
<syntaxhighlight lang="xml">
<excludefromlisting>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>
</syntaxhighlight>
| Regular expressions that if evaluated to true won't be displayed in files view.
|-
|
<syntaxhighlight lang="xml">
<playcountminimumpercent>90</playcountminimumpercent>
</syntaxhighlight>
| Minimum percentage that has to be played before it is marked as watched. Set to 101 to never auto-mark items as watched. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang="xml">
<ignoresecondsatstart>180</ignoresecondsatstart>
</syntaxhighlight>
| Number of seconds to ignore at video start after which a resume point is created. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang="xml">
<ignorepercentatend>8</ignorepercentatend>
</syntaxhighlight>
| Percentage of video to ignore at the end. If you stop watching the video here no resume point is created. Set to 101 to never save a resume point. The video is already marked as watched at 90%, see above. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang="xml">
<vdpauscaling>true</vdpauscaling>
</syntaxhighlight>
| Scales with vdpau instead of opengl and turns on its HQ scaler when available, enabling this might slow down rendering and cause framedrops especially on ION systems, this setting requires a vdpau feature set C GPU.
|-
|
<syntaxhighlight lang="xml">
<enablehighqualityhwscalers>true</enablehighqualityhwscalers>
</syntaxhighlight>
| Allow turning on the spline36 and lanczos3 shader (for GL builds).
|-
|
<syntaxhighlight lang="xml">
<dxvaallowhqscaling>false</dxvaallowhqscaling>
</syntaxhighlight>
| Enables high quality video upscaling for Windows.
|-
|
<syntaxhighlight lang="xml">
<ppffmpegdeinterlacing>linblenddeint</ppffmpegdeinterlacing>
</syntaxhighlight>
| Override the deinterlacing options passed to libpostproc.
|-
|
<syntaxhighlight lang="xml">
<ppffmpegpostprocessing>ha:128:7,va,dr</ppffmpegpostprocessing>
</syntaxhighlight>
| Override the post processing options passed to libpostproc when 'Video post-processing' is activated in GUI Videos-Settings-Playback.
|-
|
<syntaxhighlight lang="xml">
<autoscalemaxfps>30</autoscalemaxfps>
</syntaxhighlight>
| When scaling method is set to auto, bilinear is chosen when the fps is higher than this limit, the default is 30.
|-
|
<syntaxhighlight lang="xml">
<adjustrefreshrate>
</syntaxhighlight>
| style="background:#CADCFB;" | Settings for when "Adjust refreshrate to match video fps" is enabled in the video playback GUI settings.
|-
|
<syntaxhighlight lang="xml">
<override>
<fps>23.976</fps>
<refresh>60.0</refresh>
</override>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' "Adjust refreshrate to match video fps" will try to select the best refreshrate for the video fps but it doesn't always get it right, for example it might switch to an unsupported refreshrate. You can add overrides here to switch to a certain refreshrate based on video fps. It's possible to add as many overrides as you need. Overrides are processed in order, if the first one doesn't match the fps or no refreshrates match that override, it will try the next one until no overrides are left.

* '''fps''' - if the fps is between 23.966 and 23.986
* '''refresh''' - switch to the first found refreshrate that is between 59.99 and 60.01
|-
|
<syntaxhighlight lang="xml">
<override>
<fpsmin>29.96</fpsmin>
<fpsmax>30.01</fpsmax>
<refreshmin>59.0</refreshmin>
<refreshmax>61.0</refreshmax>
</override>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -'''
* '''fpsmin''' / '''fpsmin''' - You can also specify the fps range yourself.
* '''refreshmin''' / '''refreshmax''' - Same for the refreshrate
|-
|
<syntaxhighlight lang="xml">
<fallback>
<refresh>50.0</refresh>
</fallback>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' If none of the overrides match, or none of the refreshrates match any of the fps matching overrides, it will choose a fallback refreshrate. Fallbacks are process in order, if the first fallback doesn't match any refreshrate, it will try the next one until no fallbacks are left.

* '''refresh''' - Switch to the first found refreshrate that is between 49.99 and 50.01.
|-
|
<syntaxhighlight lang="xml">
<fallback>
<refreshmin>49.0</refreshmin>
<refreshmax>51.0</refreshmax>
</fallback>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' You can also specify the range for the fallback yourself.

If none of the overrides match the video fps, or no refreshrates match any of the fps matching overrides, and no fallbacks are specified or no refreshrates match any fallbacks, it will automatically choose the best refreshrate (same as having no overrides and fallbacks).
|-
|
<syntaxhighlight lang="xml">
</adjustrefreshrate>
</syntaxhighlight>
| style="background:#CADCFB;" |
|-
|
<syntaxhighlight lang="xml">
<checkdxvacompatibility>value</checkdxvacompatibility>
</syntaxhighlight>
| Advanced setting not present: let Kodi autodetect cards that support H.264 profile > L4.1. Set value to false to enable DXVA no matter what. Set value to true if Kodi doesn't autodetect that the graphics card doesn't support > L4.1.
|-
|
<syntaxhighlight lang="xml">
<useocclusionquery>-1</useocclusionquery>
</syntaxhighlight>
| Use an occlusion query when capturing videoframes, -1 means auto detect, 0 means disabled, 1 means enabled, the default is -1.
|-
|
<syntaxhighlight lang="xml">
<fpsdetect>1</fpsdetect>
</syntaxhighlight>
| FPS detection for video playback
* 0 = trust codec fps
* 1 = recalculate from video timestamps with uniform spacing
* 2 = recalculate from video timestamps always
|-
|
<syntaxhighlight lang="xml">
<latency>
</syntaxhighlight>
| style="background:#F0E68C;"| Start of '''latency''' tags. Display latency (video lag). Latency is given in msecs.
|-
|
<syntaxhighlight lang="xml">
<delay>0</delay>
</syntaxhighlight>
| style="background:#F0E68C;" | Global default display latency.
|-
|
<syntaxhighlight lang="xml">
<refresh></refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | Override latency for given display (not video) refresh rates. When Kodi is in windowed mode, override is ignored. Multiple overrides are allowed.

Syntax of an override entry:
<syntaxhighlight lang="xml">
<refresh>
<min>, <max> refresh rate range, OR
<rate> exact refresh rate
<delay> display latency for the given refresh rate
</refresh>
</syntaxhighlight>
|-
|
<syntaxhighlight lang="xml">
<refresh>
<min>23</min>
<max>24</max>
<delay>125</delay>
</refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | '''Example:''' display has 125 msec latency at 23-24 Hz
|-
|
<syntaxhighlight lang="xml">
<refresh>
<rate>50</rate>
<delay>50</delay>
</refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | '''Example:''' display has 50 msec latency at 50 (+/-0.01) Hz
|-
|
<syntaxhighlight lang="xml">
</latency>
</syntaxhighlight>
| style="background:#F0E68C;" |
|-
|
<syntaxhighlight lang="xml">
<stereoscopicregex3d>[-. _]3d[-. _]</stereoscopicregex3d>
<stereoscopicregexsbs>[-. _]h?sbs[-. _]</stereoscopicregexsbs>
<stereoscopicregextab>[-. _]h?tab[-. _]</stereoscopicregextab>
</syntaxhighlight>
| Filename triggers for 3D (stereoscopic) mode.
|-
|
<syntaxhighlight lang="xml">
<assfixedworks>false</assfixedworks>
</syntaxhighlight>
| Position behavior of ass subtitiles when setting "subtitle position on screen" set to "fixed". True to show at the fixed position set in video calibration. False to show at the bottom of video (default).
|-
|
<syntaxhighlight lang="xml">
</video>
</syntaxhighlight>
|
|}

=== audio ===
{{anchor|.3Caudio.3E}}
<syntaxhighlight lang="xml" enclose="div">
<audio>

<headroom>0</headroom>

<defaultplayer>paplayer</defaultplayer>

<excludefromscan>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromscan>

<excludefromlisting>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromlisting>

<ac3downmixgain>12.0</ac3downmixgain>

<playcountminimumpercent>99</playcountminimumpercent>

<applydrc>-1.0</applydrc>

<limiterhold>0.025</limiterhold>

<limiterrelease>0.1</limiterrelease>
</audio>
</syntaxhighlight>

For more information on the configuration of audio under Frodo see [[AudioEngine/HOW-TO: Configure audio]]

=== edl ===
{{anchor|.3Cedl.3E}}
{{main|EDL}}
Commercial break detection not as good you think it could be? Are some commercial breaks in a series of adverts not being skipped? Are some parts being skipped that are clearly not commercials? Does the end of the previous recording still show? The following advanced settings can be used to better identify full commercial break sequences, remove incorrectly flagged commercial breaks, and have playback start at the actual beginning of the recording.

<syntaxhighlight lang="xml" enclose="div">
<edl>

<mergeshortcommbreaks>false</mergeshortcommbreaks>

<maxcommbreaklength>250</maxcommbreaklength>

<mincommbreaklength>90</mincommbreaklength>

<maxcommbreakgap>120</maxcommbreakgap>

<commbreakautowait>0</commbreakautowait>

<commbreakautowind>0</commbreakautowind>
</edl>
</syntaxhighlight>

=== pvr ===
{{anchor|.3Cpvr.3E}}
<syntaxhighlight lang="xml" enclose="div">
<pvr>
<timecorrection>0</timecorrection> 
<infotoggleinterval>3000</infotoggleinterval> 
<channeliconsautoscan>true</channeliconsautoscan> 
<autoscaniconsuserset>false</autoscaniconsuserset> 
<numericchannelswitchtimeout>1000</numericchannelswitchtimeout> 
</pvr>
</syntaxhighlight>

=== epg ===
{{anchor|.3Cpvr.3E}}
<syntaxhighlight lang="xml" enclose="div">
<epg>
<updatecheckinterval>300</updatecheckinterval> 
<cleanupinterval>900</cleanupinterval> 
<activetagcheckinterval>60</activetagcheckinterval> 
<retryinterruptedupdateinterval>30</retryinterruptedupdateinterval> 
<updateemptytagsinterval>60</updateemptytagsinterval> 
<displayupdatepopup>true</displayupdatepopup> 
<displayincrementalupdatepopup>false</displayincrementalupdatepopup> 
</epg>
</syntaxhighlight>

=== forcedswaptime ===
{{anchor|.3Cforcedswaptime.3E}}
Use to force a backbuffer->frontbuffer swap while vsync is enabled. Set to the time (in ms) to allow for the swap (e.g. <forcedswaptime>1</forcedswaptime> is typical).

Default: Off



== Video library settings ==

=== videoextensions ===
{{anchor|.3Cvideoextensions.3E}}<section begin="videoextensions" />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Video windows.

Default extensions for VIDEOS:
<pre>
.m4v .3g2 .3gp .nsv .tp .ts .ty .strm .pls .rm .rmvb .mpd .m3u .m3u8 .ifo .mov .qt .divx .xvid
.bivx .vob .nrg .pva .wmv .asf .asx .ogm .m2v .avi .dat .mpg .mpeg .mp4 .mkv .mk3d .avc .vp3
.svq3 .nuv .viv .dv .fli .flv .001 .wpl .vdr .dvr-ms .xsp .mts .m2t .m2ts .evo .ogv .sdp .avs
.rec .url .pxml .vc1 .h264 .rcv .rss .mpls .webm .bdmv .wtv
</pre>
Examples:
<syntaxhighlight lang="xml" enclose="div">
<videoextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</videoextensions>
</syntaxhighlight>
<section end="videoextensions" />

=== discstubextensions ===
{{anchor|.3Cdiscstubextensions.3E}}
{{main|Media stubs}}
A list of additional file-extensions that will (<tt><add></tt>) or will not (<tt><remove></tt>) be treated as disc stubs.

Default extensions for DISC STUBS:
<pre>
.disc
</pre>

Examples:
<syntaxhighlight lang="xml" enclose="div">
<discstubextensions>
<add>.dvd|.blu</add>
<remove>.cd|.vhs</remove>
</discstubextensions>
</syntaxhighlight>

=== languagecodes ===
{{anchor|.3Clanguagecodes.3E}}
Translation table for subtitle and audio names. Contains entries of the form

<syntaxhighlight lang="xml" enclose="div">
<languagecodes>
<code>
<short>alt</short>
<long>Alternate</long>
</code>
</languagecodes>
</syntaxhighlight>

=== sorttokens ===
{{anchor|.3Csorttokens.3E}}
Allows you to specify additional tokens that will be ignored at the start of lines during sorting.
{{note|Sort tokens are case sensitive.}}
<syntaxhighlight lang="xml" enclose="div">
<sorttokens>
<token>the</token>
</sorttokens>
</syntaxhighlight>

=== moviestacking ===
{{anchor|.3Cmoviestacking.3E}}<section begin="moviestacking" />
{{main|File stacking}}
This is used by the [[file stacking]] algorithm to combine multi-part files and contains a list of "''[[Regular Expression (RegEx) Tutorial|regular expressions]]''". For stacking videos that are contained in folders, such as VIDEO_TS folders, see '''[[advancedsettings.xml#folderstacking|<folderstacking>]]'''

As of v9.11, video stacking regular expressions '''must''' contain exactly four (4) capture expressions.

Default:
<syntaxhighlight lang="xml" enclose="div">
<moviestacking>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[0-9]+)(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[a-d])(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ ._-]*[a-d])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="append"</tt> or <tt>append="yes"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the end.

Example:
<syntaxhighlight lang="xml" enclose="div">
<moviestacking action="append">

<regexp>(.*?)([ ._-]*[0-9])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="prepend"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the beginning.

Example:
<syntaxhighlight lang="xml" enclose="div">
<moviestacking action="prepend">
<regexp>(Title)(Volume)(Ignore)(Extension)</regexp>
</moviestacking>
</syntaxhighlight>

If no argument is supplied, or the argument <tt>append="no"</tt> is supplied, the default moviestacking regular expressions are overwritten by the user specified ones.
<section end="moviestacking" />

=== folderstacking ===
{{main|File stacking}}
This is similar to '''[[advancedsettings.xml#moviestacking|<moviestacking>]]''', but is used for videos that are contained in folders that use the folder names to stack, such as VIDEO_TS folders (DVD rips that are not in ISO format).

Default:
<syntaxhighlight lang="xml" enclose="div">
<folderstacking>

<regexp>((cd|dvd|dis[ck])[0-9]+)$</regexp>
</folderstacking>
</syntaxhighlight>

=== cleandatetime ===
{{anchor|.3Ccleandatetime.3E}}
Matches a year number in a string using a ''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''

Default expression:
<syntaxhighlight lang="xml" enclose="div">
<video>
<cleandatetime>(.+[^ _\,\.\[\]\-])[ _\.\[\]\-]+(19[0-9][0-9]|20[0-1][0-9])([ _\,\.\[\]\-][^0-9]|$)</cleandatetime>
</video>
</syntaxhighlight>
:* The string found before will be used as basis string getting cleaned by the cleanstrings expressions.
:* By default date formats like MM:YY are ignored.

=== cleanstrings ===
{{anchor|.3Ccleanstrings.3E}}
Clean unwanted characters from filenames or folders by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. Please note that everything right of the match (at the end of the file name) is removed, so if you would have a file named ''Super movie.mp4'' and would add <tt><regexp> </regexp></tt> (only a space), the only thing that would be left is ''Super'', which is probably not what you want.

Default expressions:
<syntaxhighlight lang="xml" enclose="div">
<video>
<cleanstrings>
<regexp>[ _\,\.\[\]\-](ac3|dts|custom|dc|divx|divx5|dsr|dsrip|dutch|dvd|dvdrip|dvdscr|dvdscreener|screener|dvdivx|cam|fragment|fs|hdtv|hdrip|hdtvrip|internal|limited|multisubs|ntsc|ogg|ogm|pal|pdtv|proper|repack|rerip|retail|cd[1-9]|r3|r5|bd5|se|svcd|swedish|german|read.nfo|nfofix|unrated|ws|telesync|ts|telecine|tc|brrip|bdrip|480p|480i|576p|576i|720p|720i|1080p|1080i|hrhd|hrhdtv|hddvd|bluray|x264|h264|xvid|xvidvd|xxx|www.www|\[.*\])([ _\,\.\[\]\-]|$)</regexp>
<regexp>(\[.*\])</regexp>
</cleanstrings>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== tvshowmatching ===
{{anchor|.3Ctvshowmatching.3E}}
Matches the season and episode numbers in file paths by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

Defaults:
<syntaxhighlight lang="xml" enclose="div">
<tvshowmatching>
<regexp>s([0-9]+)[ ._x-]*e([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)([^\\\\/]*)$</regexp> 
<regexp>[\._ -]()[Ee][Pp]_?([0-9]+)([^\\/]*)$</regexp> 
<regexp>([0-9]{4})[\.-]([0-9]{2})[\.-]([0-9]{2})</regexp> 
<regexp>([0-9]{2})[\.-]([0-9]{2})[\.-]([0-9]{4})</regexp> 
<regexp>[\\/\._ \[\(-]([0-9]+)x([0-9]+)([^\\/]*)$</regexp> 
<regexp>[\\/\._ -]([0-9]+)([0-9][0-9])([\._ -][^\\/]*)$</regexp> 
<regexp>[\/._ -]p(?:ar)?t[_. -]()([ivx]+)([._ -][^\/]*)$</regexp> 
</tvshowmatching>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)
:* Paths are converted to lower case before matching.
:* Examples of matching regexps for certain filenames can be found on the [[TV Shows (Video Library)|TV shows]] page.

:* For multi-episode matching to work, there needs to be a third set of parentheses '()' at the end, this part is fed back into the regexp engine.

:* A [http://forum.kodi.tv/showthread.php?t=51614 forum thread] has a discussion of pre-made regex lists to match common names. These might improve Kodi's ability to match TV show names in some situations, at the risk of additional false positives.

==== Filenames without Season ====
There are two methods to add episodes without a season in their file path. Both ways will force the season to '1' by default, so that you can use
the 'Use Absolute Ordering (Single Season)' setting from the TheTvDb.com scraper.

; Simple Method ''(XBMC v9.11 onwards and Kodi)''
: Use only one pair of parentheses
<syntaxhighlight lang="xml" enclose="div"><regexp>[/\._ \-]([0-9]+)</regexp></syntaxhighlight>
; Advanced Method ''(XBMC v10.05 onwards and Kodi)''
: Supports multi-episode files without season
: Use an empty pair of parentheses for the season
<syntaxhighlight lang="xml" enclose="div"><regexp>[/\._ \-]()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

; Specifying Default Season ''(XBMC v12.0 onwards and Kodi)''
It is possible to set the default season for specific regular expressions by setting the 'defaultseason' attribute.
: Works with both the simple method and advanced method
: If not used, the season will be set to '1'
: Useful for setting specials to season '0'
<syntaxhighlight lang="xml" enclose="div"><regexp defaultseason="0">[/\._ \-]X()([0-9]+)(-[0-9]+)?</regexp>
<regexp defaultseason="1">[/\._ \-]E()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

=== tvmultipartmatching ===
{{anchor|.3Ctvmultipartmatching.3E}}
Matches a multipart episode number based on a previously identified episode file, using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''.

Default:
<syntaxhighlight lang="xml" enclose="div">
<tvmultipartmatching>^[-_ex]+([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)</tvmultipartmatching>
</syntaxhighlight>
:* Text matching is compared case-insensitive.
:* Specifying this option '''replaces''' the default value

=== excludefromscan ===
{{anchor|.3Cexcludefromscan.3E}}
Matches filenames or folders which should be excluded from a library scan (except tvshows) using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. This can be for both Video or Audio sections of <tt>advancedsettings.xml</tt>.

Defaults:
<syntaxhighlight lang="xml" enclose="div">
<video>
<excludefromscan>
<regexp>-trailer</regexp>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludefromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== excludefromlisting ===
{{anchor|.3Cexcludefromlisting.3E}}
<syntaxhighlight lang="xml" enclose="div">
<video>
<excludefromlisting> 
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>
</video>
</syntaxhighlight>

=== excludetvshowsfromscan ===
{{anchor|.3Cexcludetvshowsfromscan.3E}}
Matches filenames or folders which should be excluded from a tvshow library scan using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

Defaults:
<syntaxhighlight lang="xml" enclose="div">
<video>
<excludetvshowsfromscan>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludetvshowsfromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== trailermatching ===
{{anchor|.3Ctrailermatching.3E}}
Contains "''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''" syntax (commonly referred to as "''[[Regular Expression (RegEx) Tutorial|RegEx]]''" or "''[[Regular Expression (RegEx) Tutorial|RegExp]]''") to match the locally stored trailers to movies in the library.

<syntaxhighlight lang="xml" enclose="div">
<trailermatching>

<regexp>(.*?)(_Trailer)(\.[^.]+)$</regexp>
</trailermatching>
</syntaxhighlight>

=== videolibrary ===
{{anchor|.3Cvideolibrary.3E}}
Options specific to the Video Library

<syntaxhighlight lang="xml" enclose="div">
<videolibrary>
<allitemsonbottom>false</allitemsonbottom> 
<cleanonupdate>false</cleanonupdate> 
<usefasthash>true</usefasthash> 
<recentlyaddeditems>35</recentlyaddeditems> 
<itemseparator> / </itemseparator> 
<exportautothumbs>false</exportautothumbs> 
<importwatchedstate>false</importwatchedstate> 
<importresumepoint>false</importresumepoint> 
<dateadded>1</dateadded> 
</videolibrary>
</syntaxhighlight>

=== videoscanner ===
{{anchor|.3Cvideoscanner.3E}}
Options specific to the Video scanner
<syntaxhighlight lang="xml" enclose="div">
<videoscanner>
<ignoreerrors>true</ignoreerrors> 
</videoscanner>
</syntaxhighlight>

== Library artwork ==

=== imageres ===
{{anchor|.3Cimageres.3E}}
This tag is new for v12 (Frodo), replacing <thumbsize>.

<section begin="imageres description" />Specify the maximal resolution that art should be resized to in pixels. The width is automatically calculated as being 16/9*height. The image will be resized to fit within this size. e.g. an image that is 2000x500 will be cached at size 1280x320. An image that is 500x800 will be cached at size 450x720 using the default value of 720.<section end="imageres description" />

<syntaxhighlight lang="xml" enclose="div">
<imageres>720</imageres>
</syntaxhighlight>

=== fanartres ===
{{anchor|.3Cfanartres.3E}}
This tag is new for v12 (Frodo), replacing <fanartheight>.

<section begin="fanartres description" />Specify the resolution that cached fanart should be resized to in pixels. The width is automatically calculated as being 16/9*height. Only images that are exactly 16x9 and equal to or greater than this resolution will be cached at this size - all other images will be cached using <imageres>. The default value is 1080.<section end="fanartres description" />

<syntaxhighlight lang="xml" enclose="div">
<fanartres>1080</fanartres>
</syntaxhighlight>

=== fanart ===
{{anchor|.3Cfanart.3E}}
As of v12 (Frodo), this tag is only used for music and not video.

A list of additional files to try when searching for fanart images. (The defaults are fanart.jpg and fanart.png which can be removed.)

Example:
<syntaxhighlight lang="xml" enclose="div">
<fanart>
<remove>fanart.jpg</remove>
<add>backdrop.jpg</add>
</fanart>
</syntaxhighlight>

=== musicthumbs ===
{{anchor|.3Cmusicthumbs.3E}}
<section begin="musicthumbs" />A list of additional files to try when searching for music thumbnail images. (The default is folder.jpg which can be removed.)

Example:
<syntaxhighlight lang="xml" enclose="div">
<musicthumbs>
<remove>folder.jpg</remove>
<add>thumb.jpg|cover.jpg</add>
</musicthumbs>
</syntaxhighlight><section end="musicthumbs" />

=== imagescalingalgorithm ===
Specify the image scaling algorithm for image resizing/caching i.e. posters, fanart, etc.
<br />
<syntaxhighlight lang="xml" enclose="div">
<imagescalingalgorithm>bicubic</imagescalingalgorithm>
</syntaxhighlight>

[https://github.com/xbmc/xbmc/blob/1a8753d5cd93890dc6a9f9d4b2ce8848066ea5d0/xbmc/pictures/PictureScalingAlgorithm.cpp#L32-L43 Available image scaling algorithms]

<syntaxhighlight lang="text" enclose="div">
fast_bilinear
bilinear
bicubic
experimental
nearest_neighbor
averaging_area
bicublin
gaussian
sinc
lanczos
bicubic_spline
</syntaxhighlight>

== Video and music library settings ==

=== playlistasfolders ===
{{anchor|.3Cplaylistasfolders.3E}}
In the recent releases, playlists are treated as folders. Selecting a playlist no longer plays it, but opens it, as if it were a folder.

Set to false to revert to the previous behaviour. When you select a playlist, its content is added to the list of elements to be played.

:{{note|This setting will not affect smart playlists, they will always show as folders.}}

;Example
<syntaxhighlight lang="xml" enclose="div">
<playlistasfolders>true</playlistasfolders>
</syntaxhighlight>

=== playlistretries ===
{{anchor|.3Cplaylistretries.3E}}
The number of retries attempted if a source is offline. With this control you can alter the number of consecutive failed items before a playlist fails.

Default:
<syntaxhighlight lang="xml" enclose="div">
<playlistretries>100</playlistretries>
</syntaxhighlight>

=== playlisttimeout ===
{{anchor|.3Cplaylisttimeout.3E}}
The timeout, in seconds, before item failure.

Default:
<syntaxhighlight lang="xml" enclose="div">
<playlisttimeout>20</playlisttimeout>
</syntaxhighlight>

=== musicdatabase/videodatabase ===
{{anchor|.3Cmusicdatabase.3E/.3Cvideodatabase.3E|musicdatabase/videodatabase|database tags music/video/tv/epg/adsp}}
{{main|MySQL}}
<section begin="videodatabase" />
Allows advanced customization of the default database settings for music, video, TV, EPG, and ADSP databases.

:{{note| '''It is HIGHLY recommended that you not attempt to place an sqlite3 database outside of kodi's path. sqlite3 contains no filesystem abstraction, so this will plain break on any non-local (as far as Kodi is concerned) paths. Use this for mysql only.'''}}

'''Parent tags:'''

* '''<videodatabase>'''
* '''<musicdatabase>'''
* '''<tvdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
* '''<epgdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
* '''<adspdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
{{MySQL warning}}

'''Child tags: '''

;<type>
: ''Required'' - Can be either "sqlite3" or "mysql" (default: sqlite3)

;<host>
:''Required'' -
* sqlite3: defines the relative path to the database file (eg. /usr/local/kodi/databases).
* mysql: defines the host of the mysql socket (eg. localhost, 192.168.0.1, etc)

;<port>
: ''Optional'' -
* sqlite3: silently ignored
* mysql: defines the port of the mysql socket (default: 3306)

;<name>
: ''Optional'' -
:by default "MyVideos"+DB number will be used.
* sqlite3: defines the name of the database file to read from, excluding the ".db" extension.
* mysql: defines the name of the database to use

;<user>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the user with privileged access to the database

;<pass>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the password for the user with privileged access to the database

;<compression>
: ''Optional'' - Defaults to false. Set to "true" to enable MySQL compression protocol. Performance benefit is going to be largely dependent on the network bandwidth, latency between database and clients and on the size of the result sets. [https://github.com/xbmc/xbmc/pull/6484]
: {{Note|Slower clients (such as the RPi and others) won't benefit from it as the zlib de-compression overhead is higher than the actual compression savings}}

;<key>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<cert>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ca>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<capath>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ciphers>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

'''Examples:'''

1) Configure a database for MySQL.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', '''<epgdatabase>''', and '''<adspdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang="xml" enclose="div">
<videodatabase>
<type>mysql</type>
<host>192.168.0.10</host>
<name>kodi_video</name>
<user>kodi</user>
<pass>kodi</pass>
</videodatabase>
</syntaxhighlight>

2) Configure a database for an sqlite database.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', '''<epgdatabase>''', and '''<adspdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang="xml" enclose="div">
<musicdatabase>
<type>sqlite3</type>
<host>/usr/local/share/kodi/databases</host>
</musicdatabase>
</syntaxhighlight>

<section end="videodatabase" />

=== externalplayer ===
{{anchor|.3Cexternalplayer.3E}}
{{see|External players}}

== Music settings ==

=== musicextensions ===
{{anchor|.3Cmusicextensions.3E}}
<section begin="musicextensions" />
Default extensions for MUSIC:
<pre>
.nsv .m4a .flac .aac .strm .pls .rm .rma .mpa .wav .wma .ogg .mp3 .mp2 .m3u .gdm .imf .m15 .sfx
.uni .ac3 .dts .aif .aiff .wpl .ape .mac .mpc .mp+ .mpp .shn .wv .dsp .xsp .xwav .waa .wvs .wam
.gcm .idsp .mpdsp .mss .spt .rsd .sap .cmc .cmr .dmc .mpt .mpd .rmt .tmc .tm8 .tm2 .oga .url
.pxml .tta .rss .wtv .mka .tak .opus .dff .dsf .m4b .cue .zip .rar
</pre>

It is possible to add or remove extensions for Music, using the following XML tags. Useful if you keep, say, FLAC and mp3 versions of music in the same folder. The <remove> tag can be used to remove mp3 from being listed in the library, leaving only the higher quality FLAC being displayed.

<musicextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</musicextensions>

<section end="musicextensions" />

=== cddbaddress ===
{{anchor|.3Ccddbaddress.3E}}
The address of the online CDDb database. You may set this to another freedb mirror if there is a more suitable one.

Default:
<syntaxhighlight lang="XML" enclose="div>
<cddbaddress>freedb.freedb.org</cddbaddress>
</syntaxhighlight>

=== songinfoduration ===
{{anchor|.3Csonginfoduration.3E}}
This controls how long the song information will remain onscreen when the song changes during visualisations. The valid range is "1" to "Indefinite (0)", in seconds. This does not include the duration of any transition effects.

Default:
<syntaxhighlight lang="xml" enclose="div">
<songinfoduration>10</songinfoduration>
</syntaxhighlight>

=== musicfilenamefilters ===
{{anchor|.3Cmusicfilenamefilters.3E}}
Contains filters to match music information (artist, title etc.) from a tag-less music filename. The first <filter> to match completely is used. Matched items include:

<pre>
%A - Artist
%T - Title
%B - Album
%N - Track number
%S - Part of set (disk number)
%D - Duration
%G - Genre
%Y - Year
%R - Rating
</pre>

Example:
<syntaxhighlight lang="xml" enclose="div">
<musicfilenamefilters>
<filter>%A - %T</filter>
</musicfilenamefilters>
</syntaxhighlight>

=== musiclibrary ===
{{anchor|.3Cmusiclibrary.3E}}
Options specific to the Music Library

<syntaxhighlight lang="xml" enclose="div">
<musiclibrary>
<hideallitems>true</hideallitems>  
<allitemsonbottom>true</allitemsonbottom> 
<promptfulltagscan>false</promptfulltagscan> 
<recentlyaddeditems>35</recentlyaddeditems> 
<albumformat>%B - %Y</albumformat> 
<prioritiseapetags>true</prioritiseapetags> 
<itemseparator> / </itemseparator> 
<artistseparators> 
<separator>;</separator>
<separator>:</separator>
<separator>|</separator>
<separator> feat. </separator>
<separator> ft. </separator>
</artistseparators>
<dateadded>1</dateadded> 
</musiclibrary>
</syntaxhighlight>
<br />
{{Note|Changing the <itemseparator> or <artistseparators> will only affect newly added items. Even a rescan won't change the added ones, you have to remove the music source(s) and add them again, or delete the music database to achieve this. This process should be made easier in v18 using <promptfulltagscan> (that is not available in v17)}}

== Photos settings ==

=== pictureextensions ===
{{anchor|.3Cpictureextensions.3E}}
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Pictures window.

Default extensions for PICTURES:
<pre>
.png .jpg .jpeg .bmp .gif .ico .tif .tiff .tga .pcx .cbz .cbr .rss .webp .jp2 .apng
</pre>

Examples:
<syntaxhighlight lang="xml" enclose="div">
<pictureextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</pictureextensions>
</syntaxhighlight>

=== pictureexcludes ===
{{anchor|.3Cpictureexcludes.3E}}
Matches filenames or folders which should be excluded from being displayed in My Pictures using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

<syntaxhighlight lang="xml" enclose="div">
<pictureexcludes> 
<regexp>small</regexp>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</pictureexcludes>
</syntaxhighlight>

=== slideshow ===
{{anchor|.3Cslideshow.3E}}
<syntaxhighlight lang="xml" enclose="div">
<slideshow>

<panamount>2.5</panamount>

<zoomamount>5.0</zoomamount>



<blackbarcompensation>20</blackbarcompensation>
</slideshow>
</syntaxhighlight>

== Network settings ==

=== samba ===
{{anchor|.3Csamba.3E}}
<syntaxhighlight lang="xml" enclose="div">
<samba>
<doscodepage></doscodepage> 
<clienttimeout>10</clienttimeout> 
<statfiles>true</statfiles> 
</samba>
</syntaxhighlight>

=== hosts ===
{{anchor|.3Cfhosts.3E}}
Static dns entries which take precedence over your dns server.
<syntaxhighlight lang="xml" enclose="div">
<hosts>
<entry name="HOSTNAME">IPADDRESS</entry>
</hosts>
</syntaxhighlight>

=== network ===
{{anchor|.3Cnetwork.3E}}
{{see also|HOW-TO:Modify the cache}}
<syntaxhighlight lang="xml" enclose="div">
<network>
<curlclienttimeout>10</curlclienttimeout> 
<curllowspeedtime>20</curllowspeedtime> 
<curlretries>2</curlretries> 
<httpproxyusername></httpproxyusername> 
<httpproxypassword></httpproxypassword> 
</network>
</syntaxhighlight>

{{Note|In Kodi v17, the three buffer settings are removed from the <code><network></code> tag and now placed under the new <code><cache></code> tag. See '''[[#cache]]''' for full details.}}

=== cache ===
{{see also|HOW-TO:Modify the cache}}
<syntaxhighlight lang="xml" enclose="div">
<cache>
<memorysize>0</memorysize> 
<buffermode>0</buffermode> 
<readfactor>4.0</readfactor> 
</cache>
</syntaxhighlight>

=== airtunesport ===
{{anchor|.3Cairtunesport.3E}}<section begin="airtunesport" />
This overwrites the defalt listening port of the AirTunes server (announced via zeroconf).
<section end="airtunesport" />

=== airplayport ===
{{anchor|.3Cairplayport.3E}}<section begin="airplayport" />
This overwrites the default listening port of the AirPlay server (announced via zeroconf).
<section end="airplayport" />

== File system settings ==

=== packagefoldersize ===
<section begin="packagefoldersize" />
{{anchor|.3Cpackagefoldersize.3E}}
{{xml setting
| tag name = packagefoldersize
| option type = numerical
| option values =
| default values = 200
| platform = all
| XBMC version = 12
| description = The amount (in megabytes) of add-on zip packages saved from previous add-on installs. These packages are mainly used for the [[add-on]] rollback feature. Increasing the size should increase the amount of past versions saved. Defaults to 200 MB.
| example = Example: <syntaxhighlight lang="xml" enclose="div"><packagefoldersize>200</packagefoldersize> </syntaxhighlight>
}}
<section end="packagefoldersize" />

=== detectasudf ===
{{anchor|.3Cdetectasudf.3E}}
Set to true if you wish to detect joint ISO9660/UDF disks as UDF.

Default: False

=== pathsubstitution ===
{{anchor|.3Cpathsubstitution.3E}}
{{main|Path substitution}}
Path substitutions are for use for redirecting file paths. These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for Kodi to handle.

Default: No path substitutions defined.

Example:
<syntaxhighlight lang="xml" enclose="div">
<pathsubstitution>
<substitute>
<from>G:\dvds\</from>
<to>smb://somecomputer/g-share/dvds/</to> 
</substitute>
</pathsubstitution>
</syntaxhighlight>

== Input control settings ==

=== remotedelay ===
{{anchor|.3Cremotedelay.3E}}
The repeat delay for a LIRC remote control. A delay value between 1 and 20 before a remote button starts repeating on a long keypress (i.e. continuously sending button pushes while it's held down).

Default: 3
<syntaxhighlight lang="xml" enclose="div">
<remotedelay>10</remotedelay>
</syntaxhighlight>

=== controllerdeadzone ===
{{anchor|.3Ccontrollerdeadzone.3E}}
This advanced settings has been removed. See [[HOW-TO:Controller deadzone]].

=== enablemultimediakeys ===
{{anchor|.3Cenablemultimediakeys.3E}}
This setting only has any effect on Windows versions of Kodi, and only applies to builds from 28th May 2011 onwards.
In Windows the multimedia keys generate a WM_APPCOMMAND message in addition the keypress. Kodi processes both keypresses and the WM_APPCOMMAND messages, and the end result would be that the command is executed twice. To avoid this, by default multimedia keypresses are disabled. Although it should rarely be necessary, the enablemultimediakeys setting allows you to enable the multimedia keys.

Example:
<syntaxhighlight lang="xml" enclose="div">
<enablemultimediakeys>true</enablemultimediakeys>
</syntaxhighlight>

=== seeksteps ===
{{Main|Skip steps}}

This setting changes which increments are available in the settings GUI for additive seeking. Note that <code><seeksteps></code> is not used to actually choose which seek steps are enabled.

'''Default:'''
<syntaxhighlight lang="xml" enclose="div">
<seeksteps>7, 15, 30, 60, 180, 300, 600, 900, 1800</seeksteps>
</syntaxhighlight>

{{editor note|the defaults need to be updated for seeksteps.}}

=== touchscreen ===
{{anchor|.3Ctouchscreen.3E}}
This setting allows you to move/align the origin of the touch screen with the origin of the display used. If touch input does not result in a correct movement of the mouse pointer, the behaviour can be corrected with an offset and a stretch/compress factor.

Example:
<syntaxhighlight lang="xml" enclose="div">
<touchscreen>
<x_offset>0</x_offset> 
<y_offset>0</y_offset> 
<x_stretch_factor>1.0</x_stretch_factor> 
<y_stretch_factor>1.0</y_stretch_factor> 
</touchscreen>
</syntaxhighlight>

== Other interface settings ==

=== window ===
{{anchor|.3Cwindow.3E}}
{{note|This is a "hidden" guisettings.xml setting (defined by the mouse moving the window size), but it is mentioned here because it is a particularly useful override when used in advancedsettings.xml}}
This allows you to manually set the default size of Kodi's windowed mode. If you resize the window, it will return to the set size when restarting.

WIDTH and HEIGHT are the values for each dimension, in pixels.

<syntaxhighlight lang="xml" enclose="div">
<window>
<width>WIDTH</width>
<height>HEIGHT</height>
</window>
</syntaxhighlight>

=== restrictcapsmask ===
{{anchor|.3Crestrictcapsmask.3E}}
Windows only. A bitmask to prevent Kodi from using detected texture capabilities of the GPU. This helps work around buggy hardware/drivers.

1: prevent the use of compressed textures (DXT1, DXT3, DXT5)
2: prevent the use of non-power-of-two dimensions for textures
4: prevent the use of compressed textures with non-power-of-two dimensions.

<syntaxhighlight lang="xml" enclose="div">
<restrictcapsmask>0</restrictcapsmask>
</syntaxhighlight>

=== algorithmdirtyregions ===
{{anchor|.3Calgorithmdirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="algorithmdirtyregions" />{{note|Some GPU/hardware configurations will have some minor issues (such as a visual "flicker"). For those situations try mode 2 or use the default (mode 3, which requires no advancedsetting). Almost all ARM-based devices (such as [[Android]]) willl likely have flickering issues.}}

Enable dirty-region processing. Dirty regions are any parts of the screen that have changed since the last frame. By not re-rendering what hasn't changed the GUI can be sped up. Because all GPUs work differently, only Mode 3, combined with nofliptimeout=0, is guaranteed to work for everyone without flickering issues. This mode will reduce CPU/GPU usage, but will not increase GUI speed.

{| class="prettytable"
! value !! result !! description
|-
! 0
| Off
| The entire viewport is always rendered.
|-
! 1
|Union
|All dirty regions are grouped into the smallest possible rectangle. This is typically the fastest mode for slower GPUs due to only making one pass.
|-
! 2
| {{nowrap|Cost reduction}}
| Each dirty region is presented separately, in as many passes as there are regions.
|-
! 3
| {{nowrap|Whole Screen}}
| The entire screen is rendered if there are any dirty regions. This, combined with nofliptimeout is a safe default for drivers that clear buffer contents (manifests as blinking or vibrating images). '''Default'''
|}<section end="algorithmdirtyregions" />

Example:
<syntaxhighlight lang="xml" enclose="div">
<gui>
<algorithmdirtyregions>1</algorithmdirtyregions>
</gui>
</syntaxhighlight>

=== visualizedirtyregions ===
{{anchor|.3Cvisualizedirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="visualizedirtyregions" />Enable dirty-region visualization. Paints a rectangle over marked controls.

* true: on
* false: off '''(Default)'''

{{note|This is only a development mode and isn't of use to normal users.}}
<section end="visualizedirtyregions" />
Example:
<syntaxhighlight lang="xml" enclose="div">
<gui>
<visualizedirtyregions>true</visualizedirtyregions>
</gui>
</syntaxhighlight>

=== showexitbutton ===
{{anchor|.3Cshowexitbutton.3E}}
Setting to hide the exit button, useful for people running appliance based setups where exit would only confuse/complicate the user. Modifiable via the advancedsettings.xml by setting showexitbutton to false, default is true (show)

Example:
<syntaxhighlight lang="xml" enclose="div">
<showexitbutton>true</showexitbutton>
</syntaxhighlight>

=== fullscreen ===
{{anchor|.3Cfullscreen.3E}}
Starts Kodi in full screen (check resolutions!).

<syntaxhighlight lang="xml" enclose="div">
<fullscreen>false</fullscreen>
</syntaxhighlight>

=== splash ===
{{anchor|.3Csplash.3E}}
Set to false if you wish to disable the startup splash image. Defaults to true.

<syntaxhighlight lang="xml" enclose="div">
<splash>true</splash>
</syntaxhighlight>

=== cputempcommand ===
{{anchor|.3Ccputempcommand.3E}}
Provide a shell command Kodi will use to get CPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia and Raspberry Pi</u>
<syntaxhighlight lang="xml" enclose="div">
<cputempcommand>sed -e 's/$[0-9]*$[0-9]\{3\}.*/\1 C/' /sys/class/thermal/thermal_zone0/temp</cputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang="xml" enclose="div">
<cputempcommand>echo "$(sensors -u | tail -n64 | grep temp1_input | awk '{print $2 }' |awk '{printf("%d\n",$1 + 0.5);}') C"</cputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang="xml" enclose="div">
<cputempcommand>sensors|sed -ne "s/temp1: \+[-+]$[0-9]\+$.*/\1 C/p"</cputempcommand>
</syntaxhighlight>

=== gputempcommand ===
{{anchor|.3Cgputempcommand.3E}}
Provide a shell command Kodi will use to get GPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia</u>
<syntaxhighlight lang="xml" enclose="div">
<gputempcommand>echo "$(nvidia-settings -tq gpuCoreTemp) C"</gputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang="xml" enclose="div">
<gputempcommand>echo "$(nvidia-smi -q -d TEMPERATURE | grep Gpu | cut -c35-36) C"</gputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang="xml" enclose="div">
<gputempcommand>/usr/bin/aticonfig --od-gettemperature | grep Temperature | cut -f 2 -d "-" | cut -f 1 -d "." | sed -e "s, ,," | sed 's/$/ C/'</gputempcommand>
</syntaxhighlight>

;<u>For Raspberry Pi</u>
<syntaxhighlight lang="xml" enclose="div">
<gputempcommand>/opt/vc/bin/vcgencmd measure_temp | sed -e "s/temp=//" -e "s/\..*'/ /"</gputempcommand>
</syntaxhighlight>

=== glrectanglehack ===
{{anchor|.3Cglrectanglehack.3E}}
Problems with ghosting or videos which are only played back in the left upper quarter? The following ATI hack may solve it.
<syntaxhighlight lang="xml" enclose="div">
<glrectanglehack>yes</glrectanglehack>
</syntaxhighlight>

=== alwaysontop ===
{{anchor|.3Calwaysontop.3E}}
Added in XBMC v9.11 (Windows OS only). Keeps Kodi always on top when windowed.
<syntaxhighlight lang="xml" enclose="div">
<alwaysontop>yes</alwaysontop>
</syntaxhighlight>

There is also a fake fullscreen GUI option in Kodi's settings.

== Removed tags ==
{{anchor|Recently removed tags}}
* {{anchor|.3Cthumbsize.3E}}'''<thumbsize>''' - replaced by <[[#imageres|imageres]]> in v12 Frodo
* {{anchor|.3Cfanartheight.3E}}'''<fanartheight>''' - replaced by <[[#fanartres|fanartres]]> in v12 Frodo
* {{anchor|.3Cdvdthumbs.3E}}'''<dvdthumbs>''' - removed in v12 Frodo
* {{anchor|.3Cbusydialogdelayms.3E}}'''<busydialogdelayms>''' - removed in v12 Frodo
* {{anchor|.3Cbginfoloadermaxthreads.3E}}'''<bginfoloadermaxthreads>''' - removed in v13 Gotham
* '''<showepginfoonselect>''' - replaced by a GUI setting in v13 Gotham
* '''<resample>''', '''<forceDirectSound>''', '''<audiophile>''', '''<audiosinkbufferdurationmsec>''', '''<allowtranscode44100>''', and '''<streamsilence>''' - These were various sub-tags for <audio> that were removed in v13 Gotham and either replaced by GUI settings or were no longer needed.
* {{anchor|.3Cenableairtunesdebuglog.3E}}'''<enableairtunesdebuglog>''' - replaced by a GUI option in v14 Helix
* '''<videoDisableHi10pMultithreading>''' - renamed to <disableswmultithreading> in v14 Helix
* '''<hideallitems>''' - For both the <code><videolibrary></code> and <code><musiclibrary></code> sections, this is replaced by a GUI option in v15 Isengard
* '''<SmallStepBackSeconds>''' - In v15 the <code>SmallStepBack</code> [[action ID]] has been replaced by <code>seek(-7)</code> in default keymaps. See '''[[skip steps]]''' for details. When the original <code>SmallStepBack</code> action ID is used it defaults to the first backwards [[skip steps|additive seeking value]].
* '''<timeseekforward>/<timeseekbackward>''' - In v15 these tags are replaced by GUI options via [[skip steps|additive seeking]], which is configured in the GUI. See '''[[skip steps]]''' for details.
* {{anchor|.3Ckaraoke.3E}}'''<karaoke>''' - In v16 all of the karaoke features in Kodi were removed.
* '''<useddsfanart>''' - removed in v17 Krypton.
* '''<cachemembuffersize>''' and '''<readbufferfactor>''' - In v17 <cachemembuffersize> is renamed to <memorysize> and <code><readbufferfactor></code> is renamed to <code><readfactor></code>. In addition, all three buffer related settings in <network> are moved out of <network> and into a new <cache> parent tag.
* '''<minvideocachelevel>''', '''<minaudiocachelevel>''', and '''<cacheindvdplayer>''' have been removed in v17.
* '''<useffmpegvda>''' - Tag was only used for development testing. Removed in v17.
* '''<nofliptimeout>''' - Removed in v17
* '''<blackbarcolour>''' - Removed in v17 (maybe?)
* '''<disableswmultithreading>''' - Removed in v17 (maybe?)
* {{anchor|.3Cmeasurerefreshrate.3E}}'''<measurerefreshrate>''' - Removed in v17 or v18?
* {{anchor|.3Cmyth.3E}}'''<myth>''' - Removed sometime between v16 to v18
* {{anchor|.3Ctuxbox.3E}}'''<tuxbox>''' - Removed
* '''<backgroundupdate>''' - Removed
* '''<hideemptyseries>''' - Replaced by a GUI option.
* '''<mymovies>''' and child tag '''<categoriestogenres>''' - Removed
* '''<albumssortbyartistthenyear'''> - Removed
* '''<albumformatright>''' - Removed
* {{anchor|.3Cremoterepeat.3E}}'''<remoterepeat>''' - Removed
* {{anchor|.3Callowd3d9ex.3E}}'''<allowd3d9ex>''' and {{anchor|.3Cforced3d9ex.3E}}'''<forced3d9ex>''' - Removed sometime between v16 to v18
* '''<lingertime>''' - Removed in v18

== guisettings.xml settings ==
You can also define the settings normally defined in the GUI (and stored in guisettings.xml) in advancedsettings.xml. Most guisettings.xml settings defined in advancedsettings.xml will override the guisettings.xml values, and the settings will be removed completely from the interface.

The easiest way to include a guisettings.xml setting is to first change the setting in the interface to the value that you want, and then open the '''[[userdata]]/guisettings.xml''' file and find the XML entry that corresponds to that setting.

Then just add that entry to the advancedsettings.xml file.

For instance, to set the Font Character Set (found in the appearance setting, in the Look and Feel section), you'd open up guisettings.xml and find:

<syntaxhighlight lang="xml" enclose="div">
<lookandfeel>
<charset>Hebrew (Windows)</charset>
</lookandfeel>
</syntaxhighlight>

Simply take that entry and place it in advancedsettings.xml. The option in Kodi's interface for the character set will then no longer be visible, and Kodi will always use the Hebrew (Windows) character set.

{{Updated|17}}
{{DISPLAYTITLE:advancedsettings.xml}}

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

Advancedsettings.xml

2017-10-23T12:46:39Z

Ksooo: /* epg */

{{TOC right}}{{mininav|[[Settings]]|page=advancedsettings.xml}}
{{bigger|{{note|'''The advancedsettings.xml file does not exist by default. You have to create it first!'''}} }}

<section begin="intro" />The [[advancedsettings.xml]] file, which does not exist by default, can be created by a user in their '''[[userdata folder]]'''.

This file is used for advanced settings and options that do not have GUI controls inside of {{kodi}}. Some settings are experimental or very rarely set, so they can only be used via the advancedsettings.xml file. The file is simply a plain text file and can be edited by various text editors, so long as the name is "advancedsettings.xml". These advanced settings can be used to tweak various things such as episode naming patterns, special network ports, special behaviors, and more.<section end="intro" />

The following page will describe the structure of the advancedsettings.xml file and the various individual settings.

{{note|
# All XML tags must be lowercase. The start and end of the advancedsettings.xml file must have the <advancedsettings> and </advancedsettings> tags.
# Kodi will only read the advancedsettings.xml file when it starts up. If you make changes while it is running then you must restart Kodi.
# For some Windows versions, Kodi has two <code>\userdata\</code> folders. The correct one to put the advancedsettings.xml file in is not the one in Program Files, but in <code>%appdata%\Kodi\userdata\.</code>}}

== Layout ==

The layout of <code>advancedsettings.xml</code> is as follows:

<syntaxhighlight lang="xml" enclose="div">
<advancedsettings>
<setting>value</setting>
...
<setting>value</setting>
</advancedsettings>
</syntaxhighlight>

where "setting" gives the name of the setting, and "value" gives its value.

A list of the available "setting" strings and their values is given below.

= List of available settings =

== Troubleshooting settings ==

=== loglevel ===
{{Anchor|.3Cloglevel.3E}}
{{see also|debug log}}
<section begin="loglevel" />
{{xml setting
| tag name = loglevel
| tag attribute = hide
| tag attribute values =
{{option values
| value1= true | value1 description= Hides "enable debugging" guisetting.
| value2= false | value2 description= "enable debugging" guisetting will switch between min(loglevel, 0) and max(loglevel, 2) for off and on respectively. '''(Default)'''
}}
| tag attribute default values = true
| option values =
{{option values
| value1= -1 | value1 description= No logging, suppresses all log output
| value2= 0 | value2 description= Normal logging, only logging errors '''(Default)'''
| value3= 1 | value3 description= Debug logging ''(without showing text on screen)''
| value4= 2 | value4 description= Debug logging with freemem, fps and cpu usage shown on screen
| value5= 3 | value5 description= Debug logging with freemem, fps and cpu usage and full smb logging
}}
| default values = 0
| description =
The logging level that Kodi will use to log errors and information. The "hide" attribute is optional.
| example =
Example:
<syntaxhighlight lang="xml" enclose="div">
<loglevel hide="false">1</loglevel>
</syntaxhighlight>

<br />

{{Note| If debugging is switched on in the GUI, loglevel will be set to 2 (''log to both file and on-screen information''); this will over-ride any <code>advancedsettings.xml</code> setting.}}<br />

{{Note| If debugging is switched on in the GUI when Kodi is shut down, then it will be automatically be re-enabled at level 2 when it is re-started. This is true even if 'hide' is subsequently set to 'true' - in other words, if you enable it in the GUI and then hide the GUI toggle, it will stay on level 2 irrespective of what you subsequently set in <code>advancedsettings.xml</code>.}}<br />
}}
<section end="loglevel" />

=== jsonrpc ===
{{Anchor|.3Cjsonrpc.3E}}
To make it easier for developers using the [[JSON RPC]] API in their (third party) applications to debug during development the json output of Kodi can be prettified by setting '''compactoutput''' to '''false'''. Default json output mode is a compact print which does not contain any unnecessary whitespaces and therefore is difficult to read for humans.
Furthermore using the '''tcpport''' setting it is possible to change the default TCP port used by Kodi for JSON RPC (which is 9090) to any other valid port.

Example:
<syntaxhighlight lang="xml" enclose="div">
<jsonrpc>
<compactoutput>false</compactoutput>
<tcpport>9999</tcpport>
</jsonrpc>
</syntaxhighlight>

== Audio/video playback settings ==

=== skiploopfilter ===
{{anchor|.3Cskiploopfilter.3E}}
The amount of the loop filter to skip on h.264 decoding. This can help the performance of slower machines when decoding h264 content. Values, in decreasing CPU usage (and decreasing quality)
* -16 None
* 0 Skip only empty frames (default)
* 8 Skip non-reference frames
* 16 Skip bi-dir frames
* 32 Skip all non-key frames
* 48 Skip all frames
Example:
<syntaxhighlight lang="xml" enclose="div">
<skiploopfilter>8</skiploopfilter>
</syntaxhighlight>

=== video ===
{{anchor|.3Cvideo.3E}}

The <video> section also includes the following child-tags, which have their own sections:
*[[#cleandatetime]]
*[[#cleanstrings]]
*[[#excludefromscan]]
*[[#excludefromlisting]]
*[[#excludetvshowsfromscan]]

{{note|Some tags that have a "third-level" and are grouped together are highlighted in color.}}

{| class="prettytable"
! Tag !! Description
|-
|
<syntaxhighlight lang="xml">
<video>
</syntaxhighlight>
| Parent tag that all other child tags need to be placed inside of. Do not use more than one '''<code><video></code>''' tag, but instead place all other child-tags within a single '''<code><video></video></code>''' set.
|-
|
<syntaxhighlight lang="xml">
<subsdelayrange>10</subsdelayrange>
</syntaxhighlight>
| Delay range for subtitles, in seconds.
|-
|
<syntaxhighlight lang="xml">
<audiodelayrange>10</audiodelayrange>
</syntaxhighlight>
| Delay range for audio/video sync, in seconds.
|-
|
<syntaxhighlight lang="xml">
<usetimeseeking>true</usetimeseeking>
</syntaxhighlight>
| Whether to use time based or percentage based seeking. {{small see also|HOW-TO:Modify time seeking}}
|-
|
<syntaxhighlight lang="xml">
<timeseekforwardbig>600</timeseekforwardbig>
<timeseekbackwardbig>-600</timeseekbackwardbig>
</syntaxhighlight>
| Time to seek forward in seconds when doing a long seek. Defaults to 600 (10 minutes) and -600 (-10 minutes) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang="xml">
<percentseekforward>2</percentseekforward>
<percentseekbackward>-2</percentseekbackward>
</syntaxhighlight>
| Amount to seek forward as a percentage, when doing a short seek. Defaults to 2 (2%) and -2 (2%) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang="xml">
<percentseekforwardbig>10</percentseekforwardbig>
<percentseekbackwardbig>-10</percentseekbackwardbig>
</syntaxhighlight>
| Amount to seek forward as a percentage, when doing a long seek. Defaults to 10 (10%) and -10 (10%) respectively. ''{{small|See also: [[HOW-TO:Modify time seeking]] }}''
|-
|
<syntaxhighlight lang="xml">
<fullscreenonmoviestart>true</fullscreenonmoviestart>
</syntaxhighlight>
| Whether to go to fullscreen or not when starting a movie. Defaults to true.
|-
|
<syntaxhighlight lang="xml">
<defaultplayer>VideoPlayer</defaultplayer>
</syntaxhighlight>
| Set the default video player: VideoPlayer or an external player. See '''[[External players]]''' for more info.
|-
|
<syntaxhighlight lang="xml">
<excludefromscan>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromscan>
</syntaxhighlight>
| Regular expressions that if evaluated to true won't be added to library. It is possible to add multiple <code><regexp></code> tags to match multiple patterns
|-
|
<syntaxhighlight lang="xml">
<excludefromlisting>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>
</syntaxhighlight>
| Regular expressions that if evaluated to true won't be displayed in files view.
|-
|
<syntaxhighlight lang="xml">
<playcountminimumpercent>90</playcountminimumpercent>
</syntaxhighlight>
| Minimum percentage that has to be played before it is marked as watched. Set to 101 to never auto-mark items as watched. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang="xml">
<ignoresecondsatstart>180</ignoresecondsatstart>
</syntaxhighlight>
| Number of seconds to ignore at video start after which a resume point is created. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang="xml">
<ignorepercentatend>8</ignorepercentatend>
</syntaxhighlight>
| Percentage of video to ignore at the end. If you stop watching the video here no resume point is created. Set to 101 to never save a resume point. The video is already marked as watched at 90%, see above. ''{{small|See also: [[HOW-TO:Modify automatic watch and resume points]] }}''
|-
|
<syntaxhighlight lang="xml">
<vdpauscaling>true</vdpauscaling>
</syntaxhighlight>
| Scales with vdpau instead of opengl and turns on its HQ scaler when available, enabling this might slow down rendering and cause framedrops especially on ION systems, this setting requires a vdpau feature set C GPU.
|-
|
<syntaxhighlight lang="xml">
<enablehighqualityhwscalers>true</enablehighqualityhwscalers>
</syntaxhighlight>
| Allow turning on the spline36 and lanczos3 shader (for GL builds).
|-
|
<syntaxhighlight lang="xml">
<dxvaallowhqscaling>false</dxvaallowhqscaling>
</syntaxhighlight>
| Enables high quality video upscaling for Windows.
|-
|
<syntaxhighlight lang="xml">
<ppffmpegdeinterlacing>linblenddeint</ppffmpegdeinterlacing>
</syntaxhighlight>
| Override the deinterlacing options passed to libpostproc.
|-
|
<syntaxhighlight lang="xml">
<ppffmpegpostprocessing>ha:128:7,va,dr</ppffmpegpostprocessing>
</syntaxhighlight>
| Override the post processing options passed to libpostproc when 'Video post-processing' is activated in GUI Videos-Settings-Playback.
|-
|
<syntaxhighlight lang="xml">
<autoscalemaxfps>30</autoscalemaxfps>
</syntaxhighlight>
| When scaling method is set to auto, bilinear is chosen when the fps is higher than this limit, the default is 30.
|-
|
<syntaxhighlight lang="xml">
<adjustrefreshrate>
</syntaxhighlight>
| style="background:#CADCFB;" | Settings for when "Adjust refreshrate to match video fps" is enabled in the video playback GUI settings.
|-
|
<syntaxhighlight lang="xml">
<override>
<fps>23.976</fps>
<refresh>60.0</refresh>
</override>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' "Adjust refreshrate to match video fps" will try to select the best refreshrate for the video fps but it doesn't always get it right, for example it might switch to an unsupported refreshrate. You can add overrides here to switch to a certain refreshrate based on video fps. It's possible to add as many overrides as you need. Overrides are processed in order, if the first one doesn't match the fps or no refreshrates match that override, it will try the next one until no overrides are left.

* '''fps''' - if the fps is between 23.966 and 23.986
* '''refresh''' - switch to the first found refreshrate that is between 59.99 and 60.01
|-
|
<syntaxhighlight lang="xml">
<override>
<fpsmin>29.96</fpsmin>
<fpsmax>30.01</fpsmax>
<refreshmin>59.0</refreshmin>
<refreshmax>61.0</refreshmax>
</override>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -'''
* '''fpsmin''' / '''fpsmin''' - You can also specify the fps range yourself.
* '''refreshmin''' / '''refreshmax''' - Same for the refreshrate
|-
|
<syntaxhighlight lang="xml">
<fallback>
<refresh>50.0</refresh>
</fallback>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' If none of the overrides match, or none of the refreshrates match any of the fps matching overrides, it will choose a fallback refreshrate. Fallbacks are process in order, if the first fallback doesn't match any refreshrate, it will try the next one until no fallbacks are left.

* '''refresh''' - Switch to the first found refreshrate that is between 49.99 and 50.01.
|-
|
<syntaxhighlight lang="xml">
<fallback>
<refreshmin>49.0</refreshmin>
<refreshmax>51.0</refreshmax>
</fallback>
</syntaxhighlight>
| style="background:#CADCFB;" | '''Example -''' You can also specify the range for the fallback yourself.

If none of the overrides match the video fps, or no refreshrates match any of the fps matching overrides, and no fallbacks are specified or no refreshrates match any fallbacks, it will automatically choose the best refreshrate (same as having no overrides and fallbacks).
|-
|
<syntaxhighlight lang="xml">
</adjustrefreshrate>
</syntaxhighlight>
| style="background:#CADCFB;" |
|-
|
<syntaxhighlight lang="xml">
<checkdxvacompatibility>value</checkdxvacompatibility>
</syntaxhighlight>
| Advanced setting not present: let Kodi autodetect cards that support H.264 profile > L4.1. Set value to false to enable DXVA no matter what. Set value to true if Kodi doesn't autodetect that the graphics card doesn't support > L4.1.
|-
|
<syntaxhighlight lang="xml">
<useocclusionquery>-1</useocclusionquery>
</syntaxhighlight>
| Use an occlusion query when capturing videoframes, -1 means auto detect, 0 means disabled, 1 means enabled, the default is -1.
|-
|
<syntaxhighlight lang="xml">
<fpsdetect>1</fpsdetect>
</syntaxhighlight>
| FPS detection for video playback
* 0 = trust codec fps
* 1 = recalculate from video timestamps with uniform spacing
* 2 = recalculate from video timestamps always
|-
|
<syntaxhighlight lang="xml">
<latency>
</syntaxhighlight>
| style="background:#F0E68C;"| Start of '''latency''' tags. Display latency (video lag). Latency is given in msecs.
|-
|
<syntaxhighlight lang="xml">
<delay>0</delay>
</syntaxhighlight>
| style="background:#F0E68C;" | Global default display latency.
|-
|
<syntaxhighlight lang="xml">
<refresh></refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | Override latency for given display (not video) refresh rates. When Kodi is in windowed mode, override is ignored. Multiple overrides are allowed.

Syntax of an override entry:
<syntaxhighlight lang="xml">
<refresh>
<min>, <max> refresh rate range, OR
<rate> exact refresh rate
<delay> display latency for the given refresh rate
</refresh>
</syntaxhighlight>
|-
|
<syntaxhighlight lang="xml">
<refresh>
<min>23</min>
<max>24</max>
<delay>125</delay>
</refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | '''Example:''' display has 125 msec latency at 23-24 Hz
|-
|
<syntaxhighlight lang="xml">
<refresh>
<rate>50</rate>
<delay>50</delay>
</refresh>
</syntaxhighlight>
| style="background:#F0E68C;" | '''Example:''' display has 50 msec latency at 50 (+/-0.01) Hz
|-
|
<syntaxhighlight lang="xml">
</latency>
</syntaxhighlight>
| style="background:#F0E68C;" |
|-
|
<syntaxhighlight lang="xml">
<stereoscopicregex3d>[-. _]3d[-. _]</stereoscopicregex3d>
<stereoscopicregexsbs>[-. _]h?sbs[-. _]</stereoscopicregexsbs>
<stereoscopicregextab>[-. _]h?tab[-. _]</stereoscopicregextab>
</syntaxhighlight>
| Filename triggers for 3D (stereoscopic) mode.
|-
|
<syntaxhighlight lang="xml">
<assfixedworks>false</assfixedworks>
</syntaxhighlight>
| Position behavior of ass subtitiles when setting "subtitle position on screen" set to "fixed". True to show at the fixed position set in video calibration. False to show at the bottom of video (default).
|-
|
<syntaxhighlight lang="xml">
</video>
</syntaxhighlight>
|
|}

=== audio ===
{{anchor|.3Caudio.3E}}
<syntaxhighlight lang="xml" enclose="div">
<audio>

<headroom>0</headroom>

<defaultplayer>paplayer</defaultplayer>

<excludefromscan>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromscan>

<excludefromlisting>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromlisting>

<ac3downmixgain>12.0</ac3downmixgain>

<playcountminimumpercent>99</playcountminimumpercent>

<applydrc>-1.0</applydrc>

<limiterhold>0.025</limiterhold>

<limiterrelease>0.1</limiterrelease>
</audio>
</syntaxhighlight>

For more information on the configuration of audio under Frodo see [[AudioEngine/HOW-TO: Configure audio]]

=== edl ===
{{anchor|.3Cedl.3E}}
{{main|EDL}}
Commercial break detection not as good you think it could be? Are some commercial breaks in a series of adverts not being skipped? Are some parts being skipped that are clearly not commercials? Does the end of the previous recording still show? The following advanced settings can be used to better identify full commercial break sequences, remove incorrectly flagged commercial breaks, and have playback start at the actual beginning of the recording.

<syntaxhighlight lang="xml" enclose="div">
<edl>

<mergeshortcommbreaks>false</mergeshortcommbreaks>

<maxcommbreaklength>250</maxcommbreaklength>

<mincommbreaklength>90</mincommbreaklength>

<maxcommbreakgap>120</maxcommbreakgap>

<commbreakautowait>0</commbreakautowait>

<commbreakautowind>0</commbreakautowind>
</edl>
</syntaxhighlight>

=== pvr ===
{{anchor|.3Cpvr.3E}}
<syntaxhighlight lang="xml" enclose="div">
<pvr>
<timecorrection>0</timecorrection> 
<infotoggleinterval>3000</infotoggleinterval> 
<channeliconsautoscan>true</channeliconsautoscan> 
<autoscaniconsuserset>false</autoscaniconsuserset> 
<numericchannelswitchtimeout>1000</numericchannelswitchtimeout> 
</pvr>
</syntaxhighlight>

=== epg ===
{{anchor|.3Cpvr.3E}}
<syntaxhighlight lang="xml" enclose="div">
<epg>
<updatecheckinterval>300</updatecheckinterval> 
<cleanupinterval>900</cleanupinterval> 
<activetagcheckinterval>60</activetagcheckinterval> 
<retryinterruptedupdateinterval>30</retryinterruptedupdateinterval> 
<updateemptytagsinterval>60</updateemptytagsinterval> 
<displayupdatepopup>true</displayupdatepopup> 
<displayincrementalupdatepopup>false</displayincrementalupdatepopup> 
</epg>
</syntaxhighlight>

=== forcedswaptime ===
{{anchor|.3Cforcedswaptime.3E}}
Use to force a backbuffer->frontbuffer swap while vsync is enabled. Set to the time (in ms) to allow for the swap (e.g. <forcedswaptime>1</forcedswaptime> is typical).

Default: Off



== Video library settings ==

=== videoextensions ===
{{anchor|.3Cvideoextensions.3E}}<section begin="videoextensions" />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Video windows.

Default extensions for VIDEOS:
<pre>
.m4v .3g2 .3gp .nsv .tp .ts .ty .strm .pls .rm .rmvb .mpd .m3u .m3u8 .ifo .mov .qt .divx .xvid
.bivx .vob .nrg .pva .wmv .asf .asx .ogm .m2v .avi .dat .mpg .mpeg .mp4 .mkv .mk3d .avc .vp3
.svq3 .nuv .viv .dv .fli .flv .001 .wpl .vdr .dvr-ms .xsp .mts .m2t .m2ts .evo .ogv .sdp .avs
.rec .url .pxml .vc1 .h264 .rcv .rss .mpls .webm .bdmv .wtv
</pre>
Examples:
<syntaxhighlight lang="xml" enclose="div">
<videoextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</videoextensions>
</syntaxhighlight>
<section end="videoextensions" />

=== discstubextensions ===
{{anchor|.3Cdiscstubextensions.3E}}
{{main|Media stubs}}
A list of additional file-extensions that will (<tt><add></tt>) or will not (<tt><remove></tt>) be treated as disc stubs.

Default extensions for DISC STUBS:
<pre>
.disc
</pre>

Examples:
<syntaxhighlight lang="xml" enclose="div">
<discstubextensions>
<add>.dvd|.blu</add>
<remove>.cd|.vhs</remove>
</discstubextensions>
</syntaxhighlight>

=== languagecodes ===
{{anchor|.3Clanguagecodes.3E}}
Translation table for subtitle and audio names. Contains entries of the form

<syntaxhighlight lang="xml" enclose="div">
<languagecodes>
<code>
<short>alt</short>
<long>Alternate</long>
</code>
</languagecodes>
</syntaxhighlight>

=== sorttokens ===
{{anchor|.3Csorttokens.3E}}
Allows you to specify additional tokens that will be ignored at the start of lines during sorting.
{{note|Sort tokens are case sensitive.}}
<syntaxhighlight lang="xml" enclose="div">
<sorttokens>
<token>the</token>
</sorttokens>
</syntaxhighlight>

=== moviestacking ===
{{anchor|.3Cmoviestacking.3E}}<section begin="moviestacking" />
{{main|File stacking}}
This is used by the [[file stacking]] algorithm to combine multi-part files and contains a list of "''[[Regular Expression (RegEx) Tutorial|regular expressions]]''". For stacking videos that are contained in folders, such as VIDEO_TS folders, see '''[[advancedsettings.xml#folderstacking|<folderstacking>]]'''

As of v9.11, video stacking regular expressions '''must''' contain exactly four (4) capture expressions.

Default:
<syntaxhighlight lang="xml" enclose="div">
<moviestacking>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[0-9]+)(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[a-d])(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ ._-]*[a-d])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="append"</tt> or <tt>append="yes"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the end.

Example:
<syntaxhighlight lang="xml" enclose="div">
<moviestacking action="append">

<regexp>(.*?)([ ._-]*[0-9])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="prepend"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the beginning.

Example:
<syntaxhighlight lang="xml" enclose="div">
<moviestacking action="prepend">
<regexp>(Title)(Volume)(Ignore)(Extension)</regexp>
</moviestacking>
</syntaxhighlight>

If no argument is supplied, or the argument <tt>append="no"</tt> is supplied, the default moviestacking regular expressions are overwritten by the user specified ones.
<section end="moviestacking" />

=== folderstacking ===
{{main|File stacking}}
This is similar to '''[[advancedsettings.xml#moviestacking|<moviestacking>]]''', but is used for videos that are contained in folders that use the folder names to stack, such as VIDEO_TS folders (DVD rips that are not in ISO format).

Default:
<syntaxhighlight lang="xml" enclose="div">
<folderstacking>

<regexp>((cd|dvd|dis[ck])[0-9]+)$</regexp>
</folderstacking>
</syntaxhighlight>

=== cleandatetime ===
{{anchor|.3Ccleandatetime.3E}}
Matches a year number in a string using a ''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''

Default expression:
<syntaxhighlight lang="xml" enclose="div">
<video>
<cleandatetime>(.+[^ _\,\.\[\]\-])[ _\.\[\]\-]+(19[0-9][0-9]|20[0-1][0-9])([ _\,\.\[\]\-][^0-9]|$)</cleandatetime>
</video>
</syntaxhighlight>
:* The string found before will be used as basis string getting cleaned by the cleanstrings expressions.
:* By default date formats like MM:YY are ignored.

=== cleanstrings ===
{{anchor|.3Ccleanstrings.3E}}
Clean unwanted characters from filenames or folders by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. Please note that everything right of the match (at the end of the file name) is removed, so if you would have a file named ''Super movie.mp4'' and would add <tt><regexp> </regexp></tt> (only a space), the only thing that would be left is ''Super'', which is probably not what you want.

Default expressions:
<syntaxhighlight lang="xml" enclose="div">
<video>
<cleanstrings>
<regexp>[ _\,\.\[\]\-](ac3|dts|custom|dc|divx|divx5|dsr|dsrip|dutch|dvd|dvdrip|dvdscr|dvdscreener|screener|dvdivx|cam|fragment|fs|hdtv|hdrip|hdtvrip|internal|limited|multisubs|ntsc|ogg|ogm|pal|pdtv|proper|repack|rerip|retail|cd[1-9]|r3|r5|bd5|se|svcd|swedish|german|read.nfo|nfofix|unrated|ws|telesync|ts|telecine|tc|brrip|bdrip|480p|480i|576p|576i|720p|720i|1080p|1080i|hrhd|hrhdtv|hddvd|bluray|x264|h264|xvid|xvidvd|xxx|www.www|\[.*\])([ _\,\.\[\]\-]|$)</regexp>
<regexp>(\[.*\])</regexp>
</cleanstrings>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== tvshowmatching ===
{{anchor|.3Ctvshowmatching.3E}}
Matches the season and episode numbers in file paths by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

Defaults:
<syntaxhighlight lang="xml" enclose="div">
<tvshowmatching>
<regexp>s([0-9]+)[ ._x-]*e([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)([^\\\\/]*)$</regexp> 
<regexp>[\._ -]()[Ee][Pp]_?([0-9]+)([^\\/]*)$</regexp> 
<regexp>([0-9]{4})[\.-]([0-9]{2})[\.-]([0-9]{2})</regexp> 
<regexp>([0-9]{2})[\.-]([0-9]{2})[\.-]([0-9]{4})</regexp> 
<regexp>[\\/\._ \[\(-]([0-9]+)x([0-9]+)([^\\/]*)$</regexp> 
<regexp>[\\/\._ -]([0-9]+)([0-9][0-9])([\._ -][^\\/]*)$</regexp> 
<regexp>[\/._ -]p(?:ar)?t[_. -]()([ivx]+)([._ -][^\/]*)$</regexp> 
</tvshowmatching>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)
:* Paths are converted to lower case before matching.
:* Examples of matching regexps for certain filenames can be found on the [[TV Shows (Video Library)|TV shows]] page.

:* For multi-episode matching to work, there needs to be a third set of parentheses '()' at the end, this part is fed back into the regexp engine.

:* A [http://forum.kodi.tv/showthread.php?t=51614 forum thread] has a discussion of pre-made regex lists to match common names. These might improve Kodi's ability to match TV show names in some situations, at the risk of additional false positives.

==== Filenames without Season ====
There are two methods to add episodes without a season in their file path. Both ways will force the season to '1' by default, so that you can use
the 'Use Absolute Ordering (Single Season)' setting from the TheTvDb.com scraper.

; Simple Method ''(XBMC v9.11 onwards and Kodi)''
: Use only one pair of parentheses
<syntaxhighlight lang="xml" enclose="div"><regexp>[/\._ \-]([0-9]+)</regexp></syntaxhighlight>
; Advanced Method ''(XBMC v10.05 onwards and Kodi)''
: Supports multi-episode files without season
: Use an empty pair of parentheses for the season
<syntaxhighlight lang="xml" enclose="div"><regexp>[/\._ \-]()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

; Specifying Default Season ''(XBMC v12.0 onwards and Kodi)''
It is possible to set the default season for specific regular expressions by setting the 'defaultseason' attribute.
: Works with both the simple method and advanced method
: If not used, the season will be set to '1'
: Useful for setting specials to season '0'
<syntaxhighlight lang="xml" enclose="div"><regexp defaultseason="0">[/\._ \-]X()([0-9]+)(-[0-9]+)?</regexp>
<regexp defaultseason="1">[/\._ \-]E()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

=== tvmultipartmatching ===
{{anchor|.3Ctvmultipartmatching.3E}}
Matches a multipart episode number based on a previously identified episode file, using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''.

Default:
<syntaxhighlight lang="xml" enclose="div">
<tvmultipartmatching>^[-_ex]+([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)</tvmultipartmatching>
</syntaxhighlight>
:* Text matching is compared case-insensitive.
:* Specifying this option '''replaces''' the default value

=== excludefromscan ===
{{anchor|.3Cexcludefromscan.3E}}
Matches filenames or folders which should be excluded from a library scan (except tvshows) using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. This can be for both Video or Audio sections of <tt>advancedsettings.xml</tt>.

Defaults:
<syntaxhighlight lang="xml" enclose="div">
<video>
<excludefromscan>
<regexp>-trailer</regexp>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludefromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== excludefromlisting ===
{{anchor|.3Cexcludefromlisting.3E}}
<syntaxhighlight lang="xml" enclose="div">
<video>
<excludefromlisting> 
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>
</video>
</syntaxhighlight>

=== excludetvshowsfromscan ===
{{anchor|.3Cexcludetvshowsfromscan.3E}}
Matches filenames or folders which should be excluded from a tvshow library scan using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

Defaults:
<syntaxhighlight lang="xml" enclose="div">
<video>
<excludetvshowsfromscan>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludetvshowsfromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== trailermatching ===
{{anchor|.3Ctrailermatching.3E}}
Contains "''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''" syntax (commonly referred to as "''[[Regular Expression (RegEx) Tutorial|RegEx]]''" or "''[[Regular Expression (RegEx) Tutorial|RegExp]]''") to match the locally stored trailers to movies in the library.

<syntaxhighlight lang="xml" enclose="div">
<trailermatching>

<regexp>(.*?)(_Trailer)(\.[^.]+)$</regexp>
</trailermatching>
</syntaxhighlight>

=== videolibrary ===
{{anchor|.3Cvideolibrary.3E}}
Options specific to the Video Library

<syntaxhighlight lang="xml" enclose="div">
<videolibrary>
<allitemsonbottom>false</allitemsonbottom> 
<cleanonupdate>false</cleanonupdate> 
<usefasthash>true</usefasthash> 
<recentlyaddeditems>35</recentlyaddeditems> 
<itemseparator> / </itemseparator> 
<exportautothumbs>false</exportautothumbs> 
<importwatchedstate>false</importwatchedstate> 
<importresumepoint>false</importresumepoint> 
<dateadded>1</dateadded> 
</videolibrary>
</syntaxhighlight>

=== videoscanner ===
{{anchor|.3Cvideoscanner.3E}}
Options specific to the Video scanner
<syntaxhighlight lang="xml" enclose="div">
<videoscanner>
<ignoreerrors>true</ignoreerrors> 
</videoscanner>
</syntaxhighlight>

== Library artwork ==

=== imageres ===
{{anchor|.3Cimageres.3E}}
This tag is new for v12 (Frodo), replacing <thumbsize>.

<section begin="imageres description" />Specify the maximal resolution that art should be resized to in pixels. The width is automatically calculated as being 16/9*height. The image will be resized to fit within this size. e.g. an image that is 2000x500 will be cached at size 1280x320. An image that is 500x800 will be cached at size 450x720 using the default value of 720.<section end="imageres description" />

<syntaxhighlight lang="xml" enclose="div">
<imageres>720</imageres>
</syntaxhighlight>

=== fanartres ===
{{anchor|.3Cfanartres.3E}}
This tag is new for v12 (Frodo), replacing <fanartheight>.

<section begin="fanartres description" />Specify the resolution that cached fanart should be resized to in pixels. The width is automatically calculated as being 16/9*height. Only images that are exactly 16x9 and equal to or greater than this resolution will be cached at this size - all other images will be cached using <imageres>. The default value is 1080.<section end="fanartres description" />

<syntaxhighlight lang="xml" enclose="div">
<fanartres>1080</fanartres>
</syntaxhighlight>

=== fanart ===
{{anchor|.3Cfanart.3E}}
As of v12 (Frodo), this tag is only used for music and not video.

A list of additional files to try when searching for fanart images. (The defaults are fanart.jpg and fanart.png which can be removed.)

Example:
<syntaxhighlight lang="xml" enclose="div">
<fanart>
<remove>fanart.jpg</remove>
<add>backdrop.jpg</add>
</fanart>
</syntaxhighlight>

=== musicthumbs ===
{{anchor|.3Cmusicthumbs.3E}}
<section begin="musicthumbs" />A list of additional files to try when searching for music thumbnail images. (The default is folder.jpg which can be removed.)

Example:
<syntaxhighlight lang="xml" enclose="div">
<musicthumbs>
<remove>folder.jpg</remove>
<add>thumb.jpg|cover.jpg</add>
</musicthumbs>
</syntaxhighlight><section end="musicthumbs" />

=== imagescalingalgorithm ===
Specify the image scaling algorithm for image resizing/caching i.e. posters, fanart, etc.
<br />
<syntaxhighlight lang="xml" enclose="div">
<imagescalingalgorithm>bicubic</imagescalingalgorithm>
</syntaxhighlight>

[https://github.com/xbmc/xbmc/blob/1a8753d5cd93890dc6a9f9d4b2ce8848066ea5d0/xbmc/pictures/PictureScalingAlgorithm.cpp#L32-L43 Available image scaling algorithms]

<syntaxhighlight lang="text" enclose="div">
fast_bilinear
bilinear
bicubic
experimental
nearest_neighbor
averaging_area
bicublin
gaussian
sinc
lanczos
bicubic_spline
</syntaxhighlight>

== Video and music library settings ==

=== playlistasfolders ===
{{anchor|.3Cplaylistasfolders.3E}}
In the recent releases, playlists are treated as folders. Selecting a playlist no longer plays it, but opens it, as if it were a folder.

Set to false to revert to the previous behaviour. When you select a playlist, its content is added to the list of elements to be played.

:{{note|This setting will not affect smart playlists, they will always show as folders.}}

;Example
<syntaxhighlight lang="xml" enclose="div">
<playlistasfolders>true</playlistasfolders>
</syntaxhighlight>

=== playlistretries ===
{{anchor|.3Cplaylistretries.3E}}
The number of retries attempted if a source is offline. With this control you can alter the number of consecutive failed items before a playlist fails.

Default:
<syntaxhighlight lang="xml" enclose="div">
<playlistretries>100</playlistretries>
</syntaxhighlight>

=== playlisttimeout ===
{{anchor|.3Cplaylisttimeout.3E}}
The timeout, in seconds, before item failure.

Default:
<syntaxhighlight lang="xml" enclose="div">
<playlisttimeout>20</playlisttimeout>
</syntaxhighlight>

=== musicdatabase/videodatabase ===
{{anchor|.3Cmusicdatabase.3E/.3Cvideodatabase.3E|musicdatabase/videodatabase|database tags music/video/tv/epg/adsp}}
{{main|MySQL}}
<section begin="videodatabase" />
Allows advanced customization of the default database settings for music, video, TV, EPG, and ADSP databases.

:{{note| '''It is HIGHLY recommended that you not attempt to place an sqlite3 database outside of kodi's path. sqlite3 contains no filesystem abstraction, so this will plain break on any non-local (as far as Kodi is concerned) paths. Use this for mysql only.'''}}

'''Parent tags:'''

* '''<videodatabase>'''
* '''<musicdatabase>'''
* '''<tvdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
* '''<epgdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
* '''<adspdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
{{MySQL warning}}

'''Child tags: '''

;<type>
: ''Required'' - Can be either "sqlite3" or "mysql" (default: sqlite3)

;<host>
:''Required'' -
* sqlite3: defines the relative path to the database file (eg. /usr/local/kodi/databases).
* mysql: defines the host of the mysql socket (eg. localhost, 192.168.0.1, etc)

;<port>
: ''Optional'' -
* sqlite3: silently ignored
* mysql: defines the port of the mysql socket (default: 3306)

;<name>
: ''Optional'' -
:by default "MyVideos"+DB number will be used.
* sqlite3: defines the name of the database file to read from, excluding the ".db" extension.
* mysql: defines the name of the database to use

;<user>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the user with privileged access to the database

;<pass>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the password for the user with privileged access to the database

;<compression>
: ''Optional'' - Defaults to false. Set to "true" to enable MySQL compression protocol. Performance benefit is going to be largely dependent on the network bandwidth, latency between database and clients and on the size of the result sets. [https://github.com/xbmc/xbmc/pull/6484]
: {{Note|Slower clients (such as the RPi and others) won't benefit from it as the zlib de-compression overhead is higher than the actual compression savings}}

;<key>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<cert>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ca>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<capath>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ciphers>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

'''Examples:'''

1) Configure a database for MySQL.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', '''<epgdatabase>''', and '''<adspdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang="xml" enclose="div">
<videodatabase>
<type>mysql</type>
<host>192.168.0.10</host>
<name>kodi_video</name>
<user>kodi</user>
<pass>kodi</pass>
</videodatabase>
</syntaxhighlight>

2) Configure a database for an sqlite database.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', '''<epgdatabase>''', and '''<adspdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang="xml" enclose="div">
<musicdatabase>
<type>sqlite3</type>
<host>/usr/local/share/kodi/databases</host>
</musicdatabase>
</syntaxhighlight>

<section end="videodatabase" />

=== externalplayer ===
{{anchor|.3Cexternalplayer.3E}}
{{see|External players}}

== Music settings ==

=== musicextensions ===
{{anchor|.3Cmusicextensions.3E}}
<section begin="musicextensions" />
Default extensions for MUSIC:
<pre>
.nsv .m4a .flac .aac .strm .pls .rm .rma .mpa .wav .wma .ogg .mp3 .mp2 .m3u .gdm .imf .m15 .sfx
.uni .ac3 .dts .aif .aiff .wpl .ape .mac .mpc .mp+ .mpp .shn .wv .dsp .xsp .xwav .waa .wvs .wam
.gcm .idsp .mpdsp .mss .spt .rsd .sap .cmc .cmr .dmc .mpt .mpd .rmt .tmc .tm8 .tm2 .oga .url
.pxml .tta .rss .wtv .mka .tak .opus .dff .dsf .m4b .cue .zip .rar
</pre>

It is possible to add or remove extensions for Music, using the following XML tags. Useful if you keep, say, FLAC and mp3 versions of music in the same folder. The <remove> tag can be used to remove mp3 from being listed in the library, leaving only the higher quality FLAC being displayed.

<musicextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</musicextensions>

<section end="musicextensions" />

=== cddbaddress ===
{{anchor|.3Ccddbaddress.3E}}
The address of the online CDDb database. You may set this to another freedb mirror if there is a more suitable one.

Default:
<syntaxhighlight lang="XML" enclose="div>
<cddbaddress>freedb.freedb.org</cddbaddress>
</syntaxhighlight>

=== songinfoduration ===
{{anchor|.3Csonginfoduration.3E}}
This controls how long the song information will remain onscreen when the song changes during visualisations. The valid range is "1" to "Indefinite (0)", in seconds. This does not include the duration of any transition effects.

Default:
<syntaxhighlight lang="xml" enclose="div">
<songinfoduration>10</songinfoduration>
</syntaxhighlight>

=== musicfilenamefilters ===
{{anchor|.3Cmusicfilenamefilters.3E}}
Contains filters to match music information (artist, title etc.) from a tag-less music filename. The first <filter> to match completely is used. Matched items include:

<pre>
%A - Artist
%T - Title
%B - Album
%N - Track number
%S - Part of set (disk number)
%D - Duration
%G - Genre
%Y - Year
%R - Rating
</pre>

Example:
<syntaxhighlight lang="xml" enclose="div">
<musicfilenamefilters>
<filter>%A - %T</filter>
</musicfilenamefilters>
</syntaxhighlight>

=== musiclibrary ===
{{anchor|.3Cmusiclibrary.3E}}
Options specific to the Music Library

<syntaxhighlight lang="xml" enclose="div">
<musiclibrary>
<hideallitems>true</hideallitems>  
<allitemsonbottom>true</allitemsonbottom> 
<promptfulltagscan>false</promptfulltagscan> 
<recentlyaddeditems>35</recentlyaddeditems> 
<albumformat>%B - %Y</albumformat> 
<prioritiseapetags>true</prioritiseapetags> 
<itemseparator> / </itemseparator> 
<artistseparators> 
<separator>;</separator>
<separator>:</separator>
<separator>|</separator>
<separator> feat. </separator>
<separator> ft. </separator>
</artistseparators>
<dateadded>1</dateadded> 
</musiclibrary>
</syntaxhighlight>
<br />
{{Note|Changing the <itemseparator> or <artistseparators> will only affect newly added items. Even a rescan won't change the added ones, you have to remove the music source(s) and add them again, or delete the music database to achieve this. This process should be made easier in v18 using <promptfulltagscan> (that is not available in v17)}}

== Photos settings ==

=== pictureextensions ===
{{anchor|.3Cpictureextensions.3E}}
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Pictures window.

Default extensions for PICTURES:
<pre>
.png .jpg .jpeg .bmp .gif .ico .tif .tiff .tga .pcx .cbz .cbr .rss .webp .jp2 .apng
</pre>

Examples:
<syntaxhighlight lang="xml" enclose="div">
<pictureextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</pictureextensions>
</syntaxhighlight>

=== pictureexcludes ===
{{anchor|.3Cpictureexcludes.3E}}
Matches filenames or folders which should be excluded from being displayed in My Pictures using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

<syntaxhighlight lang="xml" enclose="div">
<pictureexcludes> 
<regexp>small</regexp>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</pictureexcludes>
</syntaxhighlight>

=== slideshow ===
{{anchor|.3Cslideshow.3E}}
<syntaxhighlight lang="xml" enclose="div">
<slideshow>

<panamount>2.5</panamount>

<zoomamount>5.0</zoomamount>



<blackbarcompensation>20</blackbarcompensation>
</slideshow>
</syntaxhighlight>

== Network settings ==

=== samba ===
{{anchor|.3Csamba.3E}}
<syntaxhighlight lang="xml" enclose="div">
<samba>
<doscodepage></doscodepage> 
<clienttimeout>10</clienttimeout> 
<statfiles>true</statfiles> 
</samba>
</syntaxhighlight>

=== hosts ===
{{anchor|.3Cfhosts.3E}}
Static dns entries which take precedence over your dns server.
<syntaxhighlight lang="xml" enclose="div">
<hosts>
<entry name="HOSTNAME">IPADDRESS</entry>
</hosts>
</syntaxhighlight>

=== network ===
{{anchor|.3Cnetwork.3E}}
{{see also|HOW-TO:Modify the cache}}
<syntaxhighlight lang="xml" enclose="div">
<network>
<curlclienttimeout>10</curlclienttimeout> 
<curllowspeedtime>20</curllowspeedtime> 
<curlretries>2</curlretries> 
<httpproxyusername></httpproxyusername> 
<httpproxypassword></httpproxypassword> 
</network>
</syntaxhighlight>

{{Note|In Kodi v17, the three buffer settings are removed from the <code><network></code> tag and now placed under the new <code><cache></code> tag. See '''[[#cache]]''' for full details.}}

=== cache ===
{{see also|HOW-TO:Modify the cache}}
<syntaxhighlight lang="xml" enclose="div">
<cache>
<memorysize>0</memorysize> 
<buffermode>0</buffermode> 
<readfactor>4.0</readfactor> 
</cache>
</syntaxhighlight>

=== airtunesport ===
{{anchor|.3Cairtunesport.3E}}<section begin="airtunesport" />
This overwrites the defalt listening port of the AirTunes server (announced via zeroconf).
<section end="airtunesport" />

=== airplayport ===
{{anchor|.3Cairplayport.3E}}<section begin="airplayport" />
This overwrites the default listening port of the AirPlay server (announced via zeroconf).
<section end="airplayport" />

== File system settings ==

=== packagefoldersize ===
<section begin="packagefoldersize" />
{{anchor|.3Cpackagefoldersize.3E}}
{{xml setting
| tag name = packagefoldersize
| option type = numerical
| option values =
| default values = 200
| platform = all
| XBMC version = 12
| description = The amount (in megabytes) of add-on zip packages saved from previous add-on installs. These packages are mainly used for the [[add-on]] rollback feature. Increasing the size should increase the amount of past versions saved. Defaults to 200 MB.
| example = Example: <syntaxhighlight lang="xml" enclose="div"><packagefoldersize>200</packagefoldersize> </syntaxhighlight>
}}
<section end="packagefoldersize" />

=== detectasudf ===
{{anchor|.3Cdetectasudf.3E}}
Set to true if you wish to detect joint ISO9660/UDF disks as UDF.

Default: False

=== pathsubstitution ===
{{anchor|.3Cpathsubstitution.3E}}
{{main|Path substitution}}
Path substitutions are for use for redirecting file paths. These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for Kodi to handle.

Default: No path substitutions defined.

Example:
<syntaxhighlight lang="xml" enclose="div">
<pathsubstitution>
<substitute>
<from>G:\dvds\</from>
<to>smb://somecomputer/g-share/dvds/</to> 
</substitute>
</pathsubstitution>
</syntaxhighlight>

== Input control settings ==

=== remotedelay ===
{{anchor|.3Cremotedelay.3E}}
The repeat delay for a LIRC remote control. A delay value between 1 and 20 before a remote button starts repeating on a long keypress (i.e. continuously sending button pushes while it's held down).

Default: 3
<syntaxhighlight lang="xml" enclose="div">
<remotedelay>10</remotedelay>
</syntaxhighlight>

=== controllerdeadzone ===
{{anchor|.3Ccontrollerdeadzone.3E}}
This advanced settings has been removed. See [[HOW-TO:Controller deadzone]].

=== enablemultimediakeys ===
{{anchor|.3Cenablemultimediakeys.3E}}
This setting only has any effect on Windows versions of Kodi, and only applies to builds from 28th May 2011 onwards.
In Windows the multimedia keys generate a WM_APPCOMMAND message in addition the keypress. Kodi processes both keypresses and the WM_APPCOMMAND messages, and the end result would be that the command is executed twice. To avoid this, by default multimedia keypresses are disabled. Although it should rarely be necessary, the enablemultimediakeys setting allows you to enable the multimedia keys.

Example:
<syntaxhighlight lang="xml" enclose="div">
<enablemultimediakeys>true</enablemultimediakeys>
</syntaxhighlight>

=== seeksteps ===
{{Main|Skip steps}}

This setting changes which increments are available in the settings GUI for additive seeking. Note that <code><seeksteps></code> is not used to actually choose which seek steps are enabled.

'''Default:'''
<syntaxhighlight lang="xml" enclose="div">
<seeksteps>7, 15, 30, 60, 180, 300, 600, 900, 1800</seeksteps>
</syntaxhighlight>

{{editor note|the defaults need to be updated for seeksteps.}}

=== touchscreen ===
{{anchor|.3Ctouchscreen.3E}}
This setting allows you to move/align the origin of the touch screen with the origin of the display used. If touch input does not result in a correct movement of the mouse pointer, the behaviour can be corrected with an offset and a stretch/compress factor.

Example:
<syntaxhighlight lang="xml" enclose="div">
<touchscreen>
<x_offset>0</x_offset> 
<y_offset>0</y_offset> 
<x_stretch_factor>1.0</x_stretch_factor> 
<y_stretch_factor>1.0</y_stretch_factor> 
</touchscreen>
</syntaxhighlight>

== Other interface settings ==

=== window ===
{{anchor|.3Cwindow.3E}}
{{note|This is a "hidden" guisettings.xml setting (defined by the mouse moving the window size), but it is mentioned here because it is a particularly useful override when used in advancedsettings.xml}}
This allows you to manually set the default size of Kodi's windowed mode. If you resize the window, it will return to the set size when restarting.

WIDTH and HEIGHT are the values for each dimension, in pixels.

<syntaxhighlight lang="xml" enclose="div">
<window>
<width>WIDTH</width>
<height>HEIGHT</height>
</window>
</syntaxhighlight>

=== restrictcapsmask ===
{{anchor|.3Crestrictcapsmask.3E}}
Windows only. A bitmask to prevent Kodi from using detected texture capabilities of the GPU. This helps work around buggy hardware/drivers.

1: prevent the use of compressed textures (DXT1, DXT3, DXT5)
2: prevent the use of non-power-of-two dimensions for textures
4: prevent the use of compressed textures with non-power-of-two dimensions.

<syntaxhighlight lang="xml" enclose="div">
<restrictcapsmask>0</restrictcapsmask>
</syntaxhighlight>

=== algorithmdirtyregions ===
{{anchor|.3Calgorithmdirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="algorithmdirtyregions" />{{note|Some GPU/hardware configurations will have some minor issues (such as a visual "flicker"). For those situations try mode 2 or use the default (mode 3, which requires no advancedsetting). Almost all ARM-based devices (such as [[Android]]) willl likely have flickering issues.}}

Enable dirty-region processing. Dirty regions are any parts of the screen that have changed since the last frame. By not re-rendering what hasn't changed the GUI can be sped up. Because all GPUs work differently, only Mode 3, combined with nofliptimeout=0, is guaranteed to work for everyone without flickering issues. This mode will reduce CPU/GPU usage, but will not increase GUI speed.

{| class="prettytable"
! value !! result !! description
|-
! 0
| Off
| The entire viewport is always rendered.
|-
! 1
|Union
|All dirty regions are grouped into the smallest possible rectangle. This is typically the fastest mode for slower GPUs due to only making one pass.
|-
! 2
| {{nowrap|Cost reduction}}
| Each dirty region is presented separately, in as many passes as there are regions.
|-
! 3
| {{nowrap|Whole Screen}}
| The entire screen is rendered if there are any dirty regions. This, combined with nofliptimeout is a safe default for drivers that clear buffer contents (manifests as blinking or vibrating images). '''Default'''
|}<section end="algorithmdirtyregions" />

Example:
<syntaxhighlight lang="xml" enclose="div">
<gui>
<algorithmdirtyregions>1</algorithmdirtyregions>
</gui>
</syntaxhighlight>

=== visualizedirtyregions ===
{{anchor|.3Cvisualizedirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="visualizedirtyregions" />Enable dirty-region visualization. Paints a rectangle over marked controls.

* true: on
* false: off '''(Default)'''

{{note|This is only a development mode and isn't of use to normal users.}}
<section end="visualizedirtyregions" />
Example:
<syntaxhighlight lang="xml" enclose="div">
<gui>
<visualizedirtyregions>true</visualizedirtyregions>
</gui>
</syntaxhighlight>

=== showexitbutton ===
{{anchor|.3Cshowexitbutton.3E}}
Setting to hide the exit button, useful for people running appliance based setups where exit would only confuse/complicate the user. Modifiable via the advancedsettings.xml by setting showexitbutton to false, default is true (show)

Example:
<syntaxhighlight lang="xml" enclose="div">
<showexitbutton>true</showexitbutton>
</syntaxhighlight>

=== fullscreen ===
{{anchor|.3Cfullscreen.3E}}
Starts Kodi in full screen (check resolutions!).

<syntaxhighlight lang="xml" enclose="div">
<fullscreen>false</fullscreen>
</syntaxhighlight>

=== splash ===
{{anchor|.3Csplash.3E}}
Set to false if you wish to disable the startup splash image. Defaults to true.

<syntaxhighlight lang="xml" enclose="div">
<splash>true</splash>
</syntaxhighlight>

=== cputempcommand ===
{{anchor|.3Ccputempcommand.3E}}
Provide a shell command Kodi will use to get CPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia and Raspberry Pi</u>
<syntaxhighlight lang="xml" enclose="div">
<cputempcommand>sed -e 's/$[0-9]*$[0-9]\{3\}.*/\1 C/' /sys/class/thermal/thermal_zone0/temp</cputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang="xml" enclose="div">
<cputempcommand>echo "$(sensors -u | tail -n64 | grep temp1_input | awk '{print $2 }' |awk '{printf("%d\n",$1 + 0.5);}') C"</cputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang="xml" enclose="div">
<cputempcommand>sensors|sed -ne "s/temp1: \+[-+]$[0-9]\+$.*/\1 C/p"</cputempcommand>
</syntaxhighlight>

=== gputempcommand ===
{{anchor|.3Cgputempcommand.3E}}
Provide a shell command Kodi will use to get GPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia</u>
<syntaxhighlight lang="xml" enclose="div">
<gputempcommand>echo "$(nvidia-settings -tq gpuCoreTemp) C"</gputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang="xml" enclose="div">
<gputempcommand>echo "$(nvidia-smi -q -d TEMPERATURE | grep Gpu | cut -c35-36) C"</gputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang="xml" enclose="div">
<gputempcommand>/usr/bin/aticonfig --od-gettemperature | grep Temperature | cut -f 2 -d "-" | cut -f 1 -d "." | sed -e "s, ,," | sed 's/$/ C/'</gputempcommand>
</syntaxhighlight>

;<u>For Raspberry Pi</u>
<syntaxhighlight lang="xml" enclose="div">
<gputempcommand>/opt/vc/bin/vcgencmd measure_temp | sed -e "s/temp=//" -e "s/\..*'/ /"</gputempcommand>
</syntaxhighlight>

=== glrectanglehack ===
{{anchor|.3Cglrectanglehack.3E}}
Problems with ghosting or videos which are only played back in the left upper quarter? The following ATI hack may solve it.
<syntaxhighlight lang="xml" enclose="div">
<glrectanglehack>yes</glrectanglehack>
</syntaxhighlight>

=== alwaysontop ===
{{anchor|.3Calwaysontop.3E}}
Added in XBMC v9.11 (Windows OS only). Keeps Kodi always on top when windowed.
<syntaxhighlight lang="xml" enclose="div">
<alwaysontop>yes</alwaysontop>
</syntaxhighlight>

There is also a fake fullscreen GUI option in Kodi's settings.

== Removed tags ==
{{anchor|Recently removed tags}}
* {{anchor|.3Cthumbsize.3E}}'''<thumbsize>''' - replaced by <[[#imageres|imageres]]> in v12 Frodo
* {{anchor|.3Cfanartheight.3E}}'''<fanartheight>''' - replaced by <[[#fanartres|fanartres]]> in v12 Frodo
* {{anchor|.3Cdvdthumbs.3E}}'''<dvdthumbs>''' - removed in v12 Frodo
* {{anchor|.3Cbusydialogdelayms.3E}}'''<busydialogdelayms>''' - removed in v12 Frodo
* {{anchor|.3Cbginfoloadermaxthreads.3E}}'''<bginfoloadermaxthreads>''' - removed in v13 Gotham
* '''<showepginfoonselect>''' - replaced by a GUI setting in v13 Gotham
* '''<resample>''', '''<forceDirectSound>''', '''<audiophile>''', '''<audiosinkbufferdurationmsec>''', '''<allowtranscode44100>''', and '''<streamsilence>''' - These were various sub-tags for <audio> that were removed in v13 Gotham and either replaced by GUI settings or were no longer needed.
* {{anchor|.3Cenableairtunesdebuglog.3E}}'''<enableairtunesdebuglog>''' - replaced by a GUI option in v14 Helix
* '''<videoDisableHi10pMultithreading>''' - renamed to <disableswmultithreading> in v14 Helix
* '''<hideallitems>''' - For both the <code><videolibrary></code> and <code><musiclibrary></code> sections, this is replaced by a GUI option in v15 Isengard
* '''<SmallStepBackSeconds>''' - In v15 the <code>SmallStepBack</code> [[action ID]] has been replaced by <code>seek(-7)</code> in default keymaps. See '''[[skip steps]]''' for details. When the original <code>SmallStepBack</code> action ID is used it defaults to the first backwards [[skip steps|additive seeking value]].
* '''<timeseekforward>/<timeseekbackward>''' - In v15 these tags are replaced by GUI options via [[skip steps|additive seeking]], which is configured in the GUI. See '''[[skip steps]]''' for details.
* {{anchor|.3Ckaraoke.3E}}'''<karaoke>''' - In v16 all of the karaoke features in Kodi were removed.
* '''<useddsfanart>''' - removed in v17 Krypton.
* '''<cachemembuffersize>''' and '''<readbufferfactor>''' - In v17 <cachemembuffersize> is renamed to <memorysize> and <code><readbufferfactor></code> is renamed to <code><readfactor></code>. In addition, all three buffer related settings in <network> are moved out of <network> and into a new <cache> parent tag.
* '''<minvideocachelevel>''', '''<minaudiocachelevel>''', and '''<cacheindvdplayer>''' have been removed in v17.
* '''<useffmpegvda>''' - Tag was only used for development testing. Removed in v17.
* '''<nofliptimeout>''' - Removed in v17
* '''<blackbarcolour>''' - Removed in v17 (maybe?)
* '''<disableswmultithreading>''' - Removed in v17 (maybe?)
* {{anchor|.3Cmeasurerefreshrate.3E}}'''<measurerefreshrate>''' - Removed in v17 or v18?
* {{anchor|.3Cmyth.3E}}'''<myth>''' - Removed sometime between v16 to v18
* {{anchor|.3Ctuxbox.3E}}'''<tuxbox>''' - Removed
* '''<backgroundupdate>''' - Removed
* '''<hideemptyseries>''' - Replaced by a GUI option.
* '''<mymovies>''' and child tag '''<categoriestogenres>''' - Removed
* '''<albumssortbyartistthenyear'''> - Removed
* '''<albumformatright>''' - Removed
* {{anchor|.3Cremoterepeat.3E}}'''<remoterepeat>''' - Removed
* {{anchor|.3Callowd3d9ex.3E}}'''<allowd3d9ex>''' and {{anchor|.3Cforced3d9ex.3E}}'''<forced3d9ex>''' - Removed sometime between v16 to v18

== guisettings.xml settings ==
You can also define the settings normally defined in the GUI (and stored in guisettings.xml) in advancedsettings.xml. Most guisettings.xml settings defined in advancedsettings.xml will override the guisettings.xml values, and the settings will be removed completely from the interface.

The easiest way to include a guisettings.xml setting is to first change the setting in the interface to the value that you want, and then open the '''[[userdata]]/guisettings.xml''' file and find the XML entry that corresponds to that setting.

Then just add that entry to the advancedsettings.xml file.

For instance, to set the Font Character Set (found in the appearance setting, in the Look and Feel section), you'd open up guisettings.xml and find:

<syntaxhighlight lang="xml" enclose="div">
<lookandfeel>
<charset>Hebrew (Windows)</charset>
</lookandfeel>
</syntaxhighlight>

Simply take that entry and place it in advancedsettings.xml. The option in Kodi's interface for the character set will then no longer be visible, and Kodi will always use the Hebrew (Windows) character set.

{{Updated|17}}
{{DISPLAYTITLE:advancedsettings.xml}}

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

Advancedsettings.xml

2017-02-15T22:37:05Z

Ksooo:

{{TOC right}}{{mininav|[[Settings]]|page=advancedsettings.xml}}
{{bigger|{{note|'''The advancedsettings.xml file does not exist by default. You have to create it first!'''}} }}

<section begin="intro" />The [[advancedsettings.xml]] file, which does not exist by default, can be created by a user in their '''[[userdata folder]]'''.

This file is used for advanced settings and options that do not have GUI controls inside of {{kodi}}. Some settings are experimental or very rarely set, so they can only be used via the advancedsettings.xml file. The file is simply a plain text file and can be edited by various text editors, so long as the name is "advancedsettings.xml". These advanced settings can be used to tweak various things such as episode naming patterns, special network ports, special behaviors, and more.<section end="intro" />

The following page will describe the structure of the advancedsettings.xml file and the various individual settings.

{{note|
# All XML tags must be lowercase. The start and end of the advancedsettings.xml file must have the <advancedsettings> and </advancedsettings> tags.
# Kodi will only read the advancedsettings.xml file when it starts up. If you make changes while it is running then you must restart Kodi.
# For some Windows versions, Kodi has two <code>\userdata\</code> folders. The correct one to put the advancedsettings.xml file in is not the one in Program Files, but in <code>%appdata%\Kodi\userdata\.</code>}}

== Layout ==

The layout of <code>advancedsettings.xml</code> is as follows:

<syntaxhighlight lang="xml" enclose="div">
<advancedsettings>
<setting>value</setting>
...
<setting>value</setting>
</advancedsettings>
</syntaxhighlight>

where "setting" gives the name of the setting, and "value" gives it's value.

A list of the available "setting" strings and their values is given below.

= List of available settings =

== Troubleshooting settings ==

=== loglevel ===
{{Anchor|.3Cloglevel.3E}}
{{see also|debug log}}
<section begin="loglevel" />
{{xml setting
| tag name = loglevel
| tag attribute = hide
| tag attribute values =
{{option values
| value1= true | value1 description= Hides "enable debugging" guisetting.
| value2= false | value2 description= "enable debugging" guisetting will switch between min(loglevel, 0) and max(loglevel, 2) for off and on respectively. '''(Default)'''
}}
| tag attribute default values = true
| option values =
{{option values
| value1= -1 | value1 description= No logging, suppresses all log output
| value2= 0 | value2 description= Normal logging, only logging errors '''(Default)'''
| value3= 1 | value3 description= Debug logging ''(without showing text on screen)''
| value4= 2 | value4 description= Debug logging with freemem, fps and cpu usage shown on screen
| value5= 3 | value5 description= Debug logging with freemem, fps and cpu usage and full smb logging
}}
| default values = 0
| description =
The logging level that Kodi will use to log errors and information. The "hide" attribute is optional.
| example =
Example:
<syntaxhighlight lang="xml" enclose="div">
<loglevel hide="false">1</loglevel>
</syntaxhighlight>

<br />

{{Note| If debugging is switched on in the GUI, loglevel will be set to 2 (''log to both file and on-screen information''); this will over-ride any <code>advancedsettings.xml</code> setting.}}<br />

{{Note| If debugging is switched on in the GUI when Kodi is shut down, then it will be automatically be re-enabled at level 2 when it is re-started. This is true even if 'hide' is subsequently set to 'true' - in other words, if you enable it in the GUI and then hide the GUI toggle, it will stay on level 2 irrespective of what you subsequently set in <code>advancedsettings.xml</code>.}}<br />
}}
<section end="loglevel" />

=== jsonrpc ===
{{Anchor|.3Cjsonrpc.3E}}
To make it easier for developers using the [[JSON RPC]] API in their (third party) applications to debug during development the json output of Kodi can be prettified by setting '''compactoutput''' to '''false'''. Default json output mode is a compact print which does not contain any unnecessary whitespaces and therefore is difficult to read for humans.
Furthermore using the '''tcpport''' setting it is possible to change the default TCP port used by Kodi for JSON RPC (which is 9090) to any other valid port.

Example:
<syntaxhighlight lang="xml" enclose="div">
<jsonrpc>
<compactoutput>false</compactoutput>
<tcpport>9999</tcpport>
</jsonrpc>
</syntaxhighlight>

=== other - enableairtunesdebuglog ===
{{see|#enableairtunesdebuglog}}

== Audio/video playback settings ==

=== skiploopfilter ===
{{anchor|.3Cskiploopfilter.3E}}
The amount of the loop filter to skip on h264 decoding. This can help the performance of slower machines when decoding h264 content. Values, in decreasing CPU usage (and decreasing quality)
* -16 None
* 0 Skip only empty frames (default)
* 8 Skip non-reference frames (default on ATV)
* 16 Skip bi-dir frames
* 32 Skip all non-key frames
* 48 Skip all frames
Example:
<syntaxhighlight lang="xml" enclose="div">
<skiploopfilter>8</skiploopfilter>
</syntaxhighlight>

=== video ===
{{anchor|.3Cvideo.3E}}
{{see also|HOW-TO:Modify automatic watch and resume points|HOW-TO:Modify time seeking}}
<syntaxhighlight lang="xml" enclose="div">
<video>
<subsdelayrange>10</subsdelayrange> 
<audiodelayrange>10</audiodelayrange> 

<smallstepbackseconds>7</smallstepbackseconds>  
<usetimeseeking>true</usetimeseeking> 
<timeseekforward>30</timeseekforward>  
<timeseekbackward>-30</timeseekbackward>  
<timeseekforwardbig>600</timeseekforwardbig> 
<timeseekbackwardbig>-600</timeseekbackwardbig> 
<percentseekforward>2</percentseekforward> 
<percentseekbackward>-2</percentseekbackward> 
<percentseekforwardbig>10</percentseekforwardbig> 
<percentseekbackwardbig>-10</percentseekbackwardbig> 

<blackbarcolour>1</blackbarcolour> 

<fullscreenonmoviestart>true</fullscreenonmoviestart> 

<defaultplayer>dvdplayer</defaultplayer> 

<excludefromscan> 
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromscan>
<excludefromlisting> 
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>

<playcountminimumpercent>90</playcountminimumpercent> 
<ignoresecondsatstart>180</ignoresecondsatstart> 
<ignorepercentatend>8</ignorepercentatend> 

<forcevaapienabled>true</forcevaapienabled> 

<vdpauscaling>true</vdpauscaling> 

<enablehighqualityhwscalers>true</enablehighqualityhwscalers> 

<dxvaallowhqscaling>false</dxvaallowhqscaling> 

<ppffmpegdeinterlacing>linblenddeint</ppffmpegdeinterlacing> 

<ppffmpegpostprocessing>ha:128:7,va,dr</ppffmpegpostprocessing> 
<autoscalemaxfps>30</autoscalemaxfps> 


<adjustrefreshrate>



<override>
<fps>23.976</fps> 
<refresh>60.0</refresh> 
</override>

<override>
<fpsmin>29.96</fpsmin> 
<fpsmax>30.01</fpsmax>
<refreshmin>59.0</refreshmin> 
<refreshmax>61.0</refreshmax>
</override>


<fallback>
<refresh>50.0</refresh> 
</fallback>


<fallback>
<refreshmin>49.0</refreshmin>
<refreshmax>51.0</refreshmax>
</fallback>


</adjustrefreshrate>

<checkdxvacompatibility>value</checkdxvacompatibility> 

<useocclusionquery>-1</useocclusionquery> 
<fpsdetect>1</fpsdetect> 

<latency> 

<delay>0</delay> 




<refresh>
<min>23</min>
<max>24</max>
<delay>125</delay>
</refresh>


<refresh>
<rate>50</rate>
<delay>50</delay>
</refresh>

</latency>

<stereoscopicregex3d>[-. _]3d[-. _]</stereoscopicregex3d> 
<stereoscopicregexsbs>[-. _]h?sbs[-. _]</stereoscopicregexsbs>
<stereoscopicregextab>[-. _]h?tab[-. _]</stereoscopicregextab>

<stagefright> 
<useavccodec>-1</useavccodec>
<usehevccodec>-1</usehevccodec> 
<usevc1codec>-1</usevc1codec>
<usevpxcodec>-1</usevpxcodec>
<usemp4codec>-1</usemp4codec>
<usempeg2codec>-1</usempeg2codec>
<useswrenderer>false</useswrenderer>
</stagefright>

<disableswmultithreading>false</disableswmultithreading> 

<assfixedworks>false</assfixedworks> 

</video>
</syntaxhighlight>

=== audio ===
{{anchor|.3Caudio.3E}}
<syntaxhighlight lang="xml" enclose="div">
<audio>

<headroom>0</headroom>

<defaultplayer>paplayer</defaultplayer>

<excludefromscan>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromscan>

<excludefromlisting>
<regexp>[-\._ ](podcast)[-\._ ]</regexp>
</excludefromlisting>

<ac3downmixgain>12.0</ac3downmixgain>

<playcountminimumpercent>99</playcountminimumpercent>

<applydrc>-1.0</applydrc>

<dvdplayerignoredtsinwav>false</dvdplayerignoredtsinwav>

<limiterhold>0.025</limiterhold>

<limiterrelease>0.1</limiterrelease>
</audio>
</syntaxhighlight>

For more information on the configuration of audio under Frodo see [[AudioEngine/HOW-TO: Configure audio]]

=== measurerefreshrate ===
{{anchor|.3Cmeasurerefreshrate.3E}}
When using "Sync playback to display" on Windows, the detected refreshrate might be wrong.
When enabling measurerefreshrate, the refreshrate is measured instead, which makes it more accurate.

<syntaxhighlight lang="xml" enclose="div">
<measurerefreshrate>true</measurerefreshrate>
</syntaxhighlight>

=== edl ===
{{anchor|.3Cedl.3E}}
{{main|EDL}}
Commercial break detection not as good you think it could be? Are some commercial breaks in a series of adverts not being skipped? Are some parts being skipped that are clearly not commercials? Does the end of the previous recording still show? The following advanced settings can be used to better identify full commercial break sequences, remove incorrectly flagged commercial breaks, and have playback start at the actual beginning of the recording.

<syntaxhighlight lang="xml" enclose="div">
<edl>

<mergeshortcommbreaks>false</mergeshortcommbreaks>

<maxcommbreaklength>250</maxcommbreaklength>

<mincommbreaklength>90</mincommbreaklength>

<maxcommbreakgap>120</maxcommbreakgap>

<commbreakautowait>0</commbreakautowait>

<commbreakautowind>0</commbreakautowind>
</edl>
</syntaxhighlight>

=== pvr ===
{{anchor|.3Cpvr.3E}}
<syntaxhighlight lang="xml" enclose="div">
<pvr>
<timecorrection>0</timecorrection> 
<infotoggleinterval>3000</infotoggleinterval> 
</syntaxhighlight>
{{future box|17|2=The following PVR cache tags are removed in Kodi v17.
<syntaxhighlight lang="xml" enclose="div">
<minvideocachelevel>5</minvideocachelevel> 
<minaudiocachelevel>10</minaudiocachelevel> 
<cacheindvdplayer>true</cacheindvdplayer> 
</syntaxhighlight>
}}
<syntaxhighlight lang="xml" enclose="div">
<channeliconsautoscan>true</channeliconsautoscan> 
<autoscaniconsuserset>false</autoscaniconsuserset> 
<numericchannelswitchtimeout>1000</numericchannelswitchtimeout> 
</pvr>
</syntaxhighlight>

=== epg ===
{{anchor|.3Cpvr.3E}}
<syntaxhighlight lang="xml" enclose="div">
<epg>
<lingertime>1440</lingertime> 
<updatecheckinterval>300</updatecheckinterval> 
<cleanupinterval>900</cleanupinterval> 
<activetagcheckinterval>60</activetagcheckinterval> 
<retryinterruptedupdateinterval>30</retryinterruptedupdateinterval> 
<updateemptytagsinterval>60</updateemptytagsinterval> 
<displayupdatepopup>true</displayupdatepopup> 
<displayincrementalupdatepopup>false</displayincrementalupdatepopup> 
</epg>
</syntaxhighlight>

=== forcedswaptime ===
{{anchor|.3Cforcedswaptime.3E}}
Use to force a backbuffer->frontbuffer swap while vsync is enabled. Set to the time (in ms) to allow for the swap (e.g. <forcedswaptime>1</forcedswaptime> is typical).

Default: Off



== Video library settings ==

=== videoextensions ===
{{anchor|.3Cvideoextensions.3E}}<section begin="videoextensions" />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Video windows.

Default extensions for VIDEOS:
<pre>
.m4v .3gp .nsv .ts .ty .strm .rm .rmvb .m3u .ifo .mov .qt .divx .xvid .bivx .vob .nrg .img
.iso .pva .wmv .asf .asx .ogm .m2v .avi .bin .dat .dvr-ms .mpg .mpeg .mp4 .mkv .avc .vp3
.svq3 .nuv .viv .dv .fli .flv .rar .001 .wpl .zip
</pre>
Examples:
<syntaxhighlight lang="xml" enclose="div">
<videoextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</videoextensions>
</syntaxhighlight>
<section end="videoextensions" />

=== discstubextensions ===
{{anchor|.3Cdiscstubextensions.3E}}
{{main|Media stubs}}
A list of additional file-extensions that will (<tt><add></tt>) or will not (<tt><remove></tt>) be treated as disc stubs.

Default extensions for DISC STUBS:
<pre>
.disc
</pre>

Examples:
<syntaxhighlight lang="xml" enclose="div">
<discstubextensions>
<add>.dvd|.blu</add>
<remove>.cd|.vhs</remove>
</discstubextensions>
</syntaxhighlight>

=== languagecodes ===
{{anchor|.3Clanguagecodes.3E}}
Translation table for subtitle and audio names. Contains entries of the form

<syntaxhighlight lang="xml" enclose="div">
<languagecodes>
<code>
<short>alt</short>
<long>Alternate</long>
</code>
</languagecodes>
</syntaxhighlight>

=== sorttokens ===
{{anchor|.3Csorttokens.3E}}
Allows you to specify additional tokens that will be ignored at the start of lines during sorting.
{{note|Sort tokens are case sensitive.}}
<syntaxhighlight lang="xml" enclose="div">
<sorttokens>
<token>the</token>
</sorttokens>
</syntaxhighlight>

=== moviestacking ===
{{anchor|.3Cmoviestacking.3E}}<section begin="moviestacking" />
{{main|File stacking}}
This is used by the [[file stacking]] algorithm to combine multi-part files and contains a list of "''[[Regular Expression (RegEx) Tutorial|regular expressions]]''". For stacking videos that are contained in folders, such as VIDEO_TS folders, see '''[[advancedsettings.xml#folderstacking|<folderstacking>]]'''

As of v9.11, video stacking regular expressions '''must''' contain exactly four (4) capture expressions.

Default:
<syntaxhighlight lang="xml" enclose="div">
<moviestacking>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[0-9]+)(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[a-d])(.*?)(\.[^.]+)$</regexp>

<regexp>(.*?)([ ._-]*[a-d])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="append"</tt> or <tt>append="yes"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the end.

Example:
<syntaxhighlight lang="xml" enclose="div">
<moviestacking action="append">

<regexp>(.*?)([ ._-]*[0-9])(.*?)(\.[^.]+)$</regexp>
</moviestacking>
</syntaxhighlight>

If the argument <tt>action="prepend"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the beginning.

Example:
<syntaxhighlight lang="xml" enclose="div">
<moviestacking action="prepend">
<regexp>(Title)(Volume)(Ignore)(Extension)</regexp>
</moviestacking>
</syntaxhighlight>

If no argument is supplied, or the argument <tt>append="no"</tt> is supplied, the default moviestacking regular expressions are overwritten by the user specified ones.
<section end="moviestacking" />

=== folderstacking ===
{{main|File stacking}}
This is similar to '''[[advancedsettings.xml#moviestacking|<moviestacking>]]''', but is used for videos that are contained in folders that use the folder names to stack, such as VIDEO_TS folders (DVD rips that are not in ISO format).

Default:
<syntaxhighlight lang="xml" enclose="div">
<folderstacking>

<regexp>((cd|dvd|dis[ck])[0-9]+)$</regexp>
</folderstacking>
</syntaxhighlight>

=== cleandatetime ===
{{anchor|.3Ccleandatetime.3E}}
Matches a year number in a string using a ''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''

Default expression:
<syntaxhighlight lang="xml" enclose="div">
<video>
<cleandatetime>(.+[^ _\,\.\[\]\-])[ _\.\[\]\-]+(19[0-9][0-9]|20[0-1][0-9])([ _\,\.\[\]\-][^0-9]|$)</cleandatetime>
</video>
</syntaxhighlight>
:* The string found before will be used as basis string getting cleaned by the cleanstrings expressions.
:* By default date formats like MM:YY are ignored.

=== cleanstrings ===
{{anchor|.3Ccleanstrings.3E}}
Clean unwanted characters from filenames or folders by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. Please note that everything right of the match (at the end of the file name) is removed, so if you would have a file named ''Super movie.mp4'' and would add <tt><regexp> </regexp></tt> (only a space), the only thing that would be left is ''Super'', which is probably not what you want.

Default expressions:
<syntaxhighlight lang="xml" enclose="div">
<video>
<cleanstrings>
<regexp>[ _\,\.\[\]\-](ac3|dts|custom|dc|divx|divx5|dsr|dsrip|dutch|dvd|dvdrip|dvdscr|dvdscreener|screener|dvdivx|cam|fragment|fs|hdtv|hdrip|hdtvrip|internal|limited|multisubs|ntsc|ogg|ogm|pal|pdtv|proper|repack|rerip|retail|cd[1-9]|r3|r5|bd5|se|svcd|swedish|german|read.nfo|nfofix|unrated|ws|telesync|ts|telecine|tc|brrip|bdrip|480p|480i|576p|576i|720p|720i|1080p|1080i|hrhd|hrhdtv|hddvd|bluray|x264|h264|xvid|xvidvd|xxx|www.www|\[.*\])([ _\,\.\[\]\-]|$)</regexp>
<regexp>(\[.*\])</regexp>
</cleanstrings>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== tvshowmatching ===
{{anchor|.3Ctvshowmatching.3E}}
Matches the season and episode numbers in file paths by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

{{future note|17|Kodi v17 adds "S01xE02". The following patterns reflect the new defaults for v17. These patterns will also work in Kodi v16, but are not included by default.}}

Defaults:
<syntaxhighlight lang="xml" enclose="div">
<tvshowmatching>
<regexp>s([0-9]+)[ ._x-]*e([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)([^\\\\/]*)$</regexp> 
<regexp>[\._ -]()[Ee][Pp]_?([0-9]+)([^\\/]*)$</regexp> 
<regexp>([0-9]{4})[\.-]([0-9]{2})[\.-]([0-9]{2})</regexp> 
<regexp>([0-9]{2})[\.-]([0-9]{2})[\.-]([0-9]{4})</regexp> 
<regexp>[\\/\._ \[\(-]([0-9]+)x([0-9]+)([^\\/]*)$</regexp> 
<regexp>[\\/\._ -]([0-9]+)([0-9][0-9])([\._ -][^\\/]*)$</regexp> 
<regexp>[\/._ -]p(?:ar)?t[_. -]()([ivx]+)([._ -][^\/]*)$</regexp> 
</tvshowmatching>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)
:* Paths are converted to lower case before matching.
:* Examples of matching regexps for certain filenames can be found on the [[TV Shows (Video Library)|TV shows]] page.

:* For multi-episode matching to work, there needs to be a third set of parentheses '()' at the end, this part is fed back into the regexp engine.

:* A [http://forum.kodi.tv/showthread.php?t=51614 forum thread] has a discussion of pre-made regex lists to match common names. These might improve Kodi's ability to match TV show names in some situations, at the risk of additional false positives.

==== Filenames without Season ====
There are two methods to add episodes without a season in their file path. Both ways will force the season to '1' by default, so that you can use
the 'Use Absolute Ordering (Single Season)' setting from the TheTvDb.com scraper.

; Simple Method ''(XBMC v9.11 onwards and Kodi)''
: Use only one pair of parentheses
<syntaxhighlight lang="xml" enclose="div"><regexp>[/\._ \-]([0-9]+)</regexp></syntaxhighlight>
; Advanced Method ''(XBMC v10.05 onwards and Kodi)''
: Supports multi-episode files without season
: Use an empty pair of parentheses for the season
<syntaxhighlight lang="xml" enclose="div"><regexp>[/\._ \-]()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

; Specifying Default Season ''(XBMC v12.0 onwards and Kodi)''
It is possible to set the default season for specific regular expressions by setting the 'defaultseason' attribute.
: Works with both the simple method and advanced method
: If not used, the season will be set to '1'
: Useful for setting specials to season '0'
<syntaxhighlight lang="xml" enclose="div"><regexp defaultseason="0">[/\._ \-]X()([0-9]+)(-[0-9]+)?</regexp>
<regexp defaultseason="1">[/\._ \-]E()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight>

=== tvmultipartmatching ===
{{anchor|.3Ctvmultipartmatching.3E}}
Matches a multipart episode number based on a previously identified episode file, using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''.

Default:
<syntaxhighlight lang="xml" enclose="div">
<tvmultipartmatching>^[-_ex]+([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)</tvmultipartmatching>
</syntaxhighlight>
:* Text matching is compared case-insensitive.
:* Specifying this option '''replaces''' the default value

=== excludefromscan ===
{{anchor|.3Cexcludefromscan.3E}}
Matches filenames or folders which should be excluded from a library scan (except tvshows) using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. This can be for both Video or Audio sections of <tt>advancedsettings.xml</tt>.

Defaults:
<syntaxhighlight lang="xml" enclose="div">
<video>
<excludefromscan>
<regexp>-trailer</regexp>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludefromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== excludefromlisting ===
{{anchor|.3Cexcludefromlisting.3E}}
<syntaxhighlight lang="xml" enclose="div">
<video>
<excludefromlisting> 
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</excludefromlisting>
</video>
</syntaxhighlight>

=== excludetvshowsfromscan ===
{{anchor|.3Cexcludetvshowsfromscan.3E}}
Matches filenames or folders which should be excluded from a tvshow library scan using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

Defaults:
<syntaxhighlight lang="xml" enclose="div">
<video>
<excludetvshowsfromscan>
<regexp>[!-._ \\/]sample[-._ \\/]</regexp>
</excludetvshowsfromscan>
</video>
</syntaxhighlight>

:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)

=== trailermatching ===
{{anchor|.3Ctrailermatching.3E}}
Contains "''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''" syntax (commonly referred to as "''[[Regular Expression (RegEx) Tutorial|RegEx]]''" or "''[[Regular Expression (RegEx) Tutorial|RegExp]]''") to match the locally stored trailers to movies in the library.

<syntaxhighlight lang="xml" enclose="div">
<trailermatching>

<regexp>(.*?)(_Trailer)(\.[^.]+)$</regexp>
</trailermatching>
</syntaxhighlight>

=== videolibrary ===
{{anchor|.3Cvideolibrary.3E}}
Options specific to the Video Library

<syntaxhighlight lang="xml" enclose="div">
<videolibrary>
<allitemsonbottom>false</allitemsonbottom> 
<backgroundupdate>false</backgroundupdate> 

<cleanonupdate>false</cleanonupdate> 
<usefasthash>true</usefasthash> 
<hideemptyseries>false</hideemptyseries> 
<recentlyaddeditems>35</recentlyaddeditems> 
<itemseparator> / </itemseparator> 
<exportautothumbs>false</exportautothumbs> 
<importwatchedstate>false</importwatchedstate> 
<importresumepoint>false</importresumepoint> 
<mymovies> 
<categoriestogenres>false</categoriestogenres> 
</mymovies>
<dateadded>1</dateadded> 
</videolibrary>
</syntaxhighlight>

=== videoscanner ===
{{anchor|.3Cvideoscanner.3E}}
Options specific to the Video scanner
<syntaxhighlight lang="xml" enclose="div">
<videoscanner>
<ignoreerrors>true</ignoreerrors> 
</videoscanner>
</syntaxhighlight>

=== myth ===
{{anchor|.3Cmyth.3E}}
Not seeing all the recordings you expected in the Movies folder? If so, it's very likely that the electronic program guide (EPG) used by MythTV doesn't accurately distinguish between TV Shows and Movies all the time. The following setting allows the length of the recording to also be used to determine if a recording is a Movie.

<syntaxhighlight lang="xml" enclose="div">
<myth>

<movielength>0</movielength>
</myth>
</syntaxhighlight>

== Library artwork ==

=== imageres ===
{{anchor|.3Cimageres.3E}}
This tag is new for v12 (Frodo), replacing <thumbsize>.

<section begin="imageres description" />Specify the maximal resolution that art should be resized to in pixels. The width is automatically calculated as being 16/9*height. The image will be resized to fit within this size. e.g. an image that is 2000x500 will be cached at size 1280x320. An image that is 500x800 will be cached at size 450x720 using the default value of 720.<section end="imageres description" />

<syntaxhighlight lang="xml" enclose="div">
<imageres>720</imageres>
</syntaxhighlight>

=== fanartres ===
{{anchor|.3Cfanartres.3E}}
This tag is new for v12 (Frodo), replacing <fanartheight>.

<section begin="fanartres description" />Specify the resolution that cached fanart should be resized to in pixels. The width is automatically calculated as being 16/9*height. Only images that are exactly 16x9 and equal to or greater than this resolution will be cached at this size - all other images will be cached using <imageres>. The default value is 1080.<section end="fanartres description" />

<syntaxhighlight lang="xml" enclose="div">
<fanartres>1080</fanartres>
</syntaxhighlight>

=== fanart ===
{{anchor|.3Cfanart.3E}}
As of v12 (Frodo), this tag is only used for music and not video.

A list of additional files to try when searching for fanart images. (The defaults are fanart.jpg and fanart.png which can be removed.)

Example:
<syntaxhighlight lang="xml" enclose="div">
<fanart>
<remove>fanart.jpg</remove>
<add>backdrop.jpg</add>
</fanart>
</syntaxhighlight>

=== musicthumbs ===
{{anchor|.3Cmusicthumbs.3E}}
A list of additional files to try when searching for music thumbnail images. (The default is folder.jpg which can be removed.)

Example:
<syntaxhighlight lang="xml" enclose="div">
<musicthumbs>
<remove>folder.jpg</remove>
<add>thumb.jpg|cover.jpg</add>
</musicthumbs>
</syntaxhighlight>

=== imagescalingalgorithm ===
Specify the image scaling algorithm for image resizing/caching i.e. posters, fanart, etc.
<br />
<syntaxhighlight lang="xml" enclose="div">
<imagescalingalgorithm>bicubic</imagescalingalgorithm>
</syntaxhighlight>

[https://github.com/xbmc/xbmc/blob/1a8753d5cd93890dc6a9f9d4b2ce8848066ea5d0/xbmc/pictures/PictureScalingAlgorithm.cpp#L32-L43 Available image scaling algorithms]

<syntaxhighlight lang="text" enclose="div">
fast_bilinear
bilinear
bicubic
experimental
nearest_neighbor
averaging_area
bicublin
gaussian
sinc
lanczos
bicubic_spline
</syntaxhighlight>

== Video and music library settings ==

=== playlistasfolders ===
{{anchor|.3Cplaylistasfolders.3E}}
In the recent releases, playlists are treated as folders. Selecting a playlist no longer plays it, but opens it, as if it were a folder.

Set to false to revert to the previous behaviour. When you select a playlist, its content is added to the list of elements to be played.

:{{note|This setting will not affect smart playlists, they will always show as folders.}}

;Example
<syntaxhighlight lang="xml" enclose="div">
<playlistasfolders>true</playlistasfolders>
</syntaxhighlight>

=== playlistretries ===
{{anchor|.3Cplaylistretries.3E}}
The number of retries attempted if a source is offline. With this control you can alter the number of consecutive failed items before a playlist fails.

Default:
<syntaxhighlight lang="xml" enclose="div">
<playlistretries>100</playlistretries>
</syntaxhighlight>

=== playlisttimeout ===
{{anchor|.3Cplaylisttimeout.3E}}
The timeout, in seconds, before item failure.

Default:
<syntaxhighlight lang="xml" enclose="div">
<playlisttimeout>20</playlisttimeout>
</syntaxhighlight>

=== musicdatabase/videodatabase ===
{{anchor|.3Cmusicdatabase.3E/.3Cvideodatabase.3E|musicdatabase/videodatabase|database tags music/video/tv/epg/adsp}}
{{main|MySQL}}
<section begin="videodatabase" />
Allows advanced customization of the default database settings for music, video, TV, EPG, and ADSP databases.

:{{note| '''It is HIGHLY recommended that you not attempt to place an sqlite3 database outside of kodi's path. sqlite3 contains no filesystem abstraction, so this will plain break on any non-local (as far as Kodi is concerned) paths. Use this for mysql only.'''}}

'''Parent tags:'''

* '''<videodatabase>'''
* '''<musicdatabase>'''
* '''<tvdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
* '''<epgdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
* '''<adspdatabase>''' - Highly experimental/unstable and no practical benefit for most users. '''Avoid using.'''
{{MySQL warning}}

'''Child tags: '''

;<type>
: ''Required'' - Can be either "sqlite3" or "mysql" (default: sqlite3)

;<host>
:''Required'' -
* sqlite3: defines the relative path to the database file (eg. /usr/local/kodi/databases).
* mysql: defines the host of the mysql socket (eg. localhost, 192.168.0.1, etc)

;<port>
: ''Optional'' -
* sqlite3: silently ignored
* mysql: defines the port of the mysql socket (default: 3306)

;<name>
: ''Optional'' -
:by default "MyVideos"+DB number will be used.
* sqlite3: defines the name of the database file to read from, excluding the ".db" extension.
* mysql: defines the name of the database to use

;<user>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the user with privileged access to the database

;<pass>
: ''Required for MySQL'' -
* sqlite3: silently ignored
* mysql: defines the password for the user with privileged access to the database

;<compression>
: ''Optional'' - Defaults to false. Set to "true" to enable MySQL compression protocol. Performance benefit is going to be largely dependent on the network bandwidth, latency between database and clients and on the size of the result sets. [https://github.com/xbmc/xbmc/pull/6484]
: {{Note|Slower clients (such as the RPi and others) won't benefit from it as the zlib de-compression overhead is higher than the actual compression savings}}

;<key>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<cert>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ca>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<capath>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

;<ciphers>
: ''Optional'' - SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]

'''Examples:'''

1) Configure a database for MySQL.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', '''<epgdatabase>''', and '''<adspdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang="xml" enclose="div">
<videodatabase>
<type>mysql</type>
<host>192.168.0.10</host>
<name>kodi_video</name>
<user>kodi</user>
<pass>kodi</pass>
</videodatabase>
</syntaxhighlight>

2) Configure a database for an sqlite database.
:{{note| ''The '''<videodatabase>''', '''<musicdatabase>''', '''<tvdatabase>''', '''<epgdatabase>''', and '''<adspdatabase>''' tags are interchangeable here.''}}
<syntaxhighlight lang="xml" enclose="div">
<musicdatabase>
<type>sqlite3</type>
<host>/usr/local/share/kodi/databases</host>
</musicdatabase>
</syntaxhighlight>

<section end="videodatabase" />

=== externalplayer ===
{{anchor|.3Cexternalplayer.3E}}
{{see|External players}}

== Music settings ==

=== musicextensions ===
{{anchor|.3Cmusicextensions.3E}}
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Music windows.

Default extensions for MUSIC:
<pre>
.nsv .m4a .flac .aac .strm .pls .rm .mpa .wav .wma .ogg .mp3 .mp2 .m3u .mod .amf .669 .dmf .dsm .far .gdm
.imf .it .m15 .med .okt .s3m .stm .sfx .ult .uni .xm .sid .ac3 .dts .cue .aif .aiff .wpl .ape .mac .mpc
.mp+ .mpp .shn .zip .rar .wv .nsf .spc .gym .adplug .adx .dsp .adp .ymf .ast .afc .hps .xsp
</pre>

Examples:
<syntaxhighlight lang="xml" enclose="div">
<musicextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</musicextensions>
</syntaxhighlight>

=== cddbaddress ===
{{anchor|.3Ccddbaddress.3E}}
The address of the online CDDb database. You may set this to another freedb mirror if there is a more suitable one.

Default:
<syntaxhighlight lang="XML" enclose="div>
<cddbaddress>freedb.freedb.org</cddbaddress>
</syntaxhighlight>

=== songinfoduration ===
{{anchor|.3Csonginfoduration.3E}}
This controls how long the song information will remain onscreen when the song changes during visualisations. The valid range is "1" to "Indefinite (0)", in seconds. This does not include the duration of any transition effects.

Default:
<syntaxhighlight lang="xml" enclose="div">
<songinfoduration>10</songinfoduration>
</syntaxhighlight>

=== musicfilenamefilters ===
{{anchor|.3Cmusicfilenamefilters.3E}}
Contains filters to match music information (artist, title etc.) from a tag-less music filename. The first <filter> to match completely is used. Matched items include:

<pre>
%A - Artist
%T - Title
%B - Album
%N - Track number
%S - Part of set (disk number)
%D - Duration
%G - Genre
%Y - Year
%R - Rating
</pre>

Example:
<syntaxhighlight lang="xml" enclose="div">
<musicfilenamefilters>
<filter>%A - %T</filter>
</musicfilenamefilters>
</syntaxhighlight>

=== musiclibrary ===
{{anchor|.3Cmusiclibrary.3E}}
Options specific to the Music Library

<syntaxhighlight lang="xml" enclose="div">
<musiclibrary>
<hideallitems>true</hideallitems>  
<allitemsonbottom>true</allitemsonbottom> 
<backgroundupdate>true</backgroundupdate> 
<recentlyaddeditems>35</recentlyaddeditems> 
<albumssortbyartistthenyear>true</albumssortbyartistthenyear> 
<albumformat>%B - %Y</albumformat> 
<albumformatright>%A</albumformatright> 
<prioritiseapetags>true</prioritiseapetags> 
<itemseparator> / </itemseparator> 
</musiclibrary>
</syntaxhighlight>
<br />
{{Note|Changing the <itemseparator> will only affect newly added items. Even a rescan won't change the added ones, you have to delete the music database to achieve this.}}

== Photos settings ==

=== pictureextensions ===
{{anchor|.3Cpictureextensions.3E}}
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Pictures window.

Default extensions for PICTURES:
<pre>
.png .jpg .jpeg .bmp .gif .ico .tif .tiff .tga .pcx .cbz .zip .cbr .rar .m3u
</pre>

Examples:
<syntaxhighlight lang="xml" enclose="div">
<pictureextensions>
<add>.ex1|.ex2</add>
<remove>.ex3|.ex4</remove>
</pictureextensions>
</syntaxhighlight>

=== pictureexcludes ===
{{anchor|.3Cpictureexcludes.3E}}
Matches filenames or folders which should be excluded from being displayed in My Pictures using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''

<syntaxhighlight lang="xml" enclose="div">
<pictureexcludes> 
<regexp>small</regexp>
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
</pictureexcludes>
</syntaxhighlight>

=== slideshow ===
{{anchor|.3Cslideshow.3E}}
<syntaxhighlight lang="xml" enclose="div">
<slideshow>

<panamount>2.5</panamount>

<zoomamount>5.0</zoomamount>



<blackbarcompensation>20</blackbarcompensation>
</slideshow>
</syntaxhighlight>

== Network settings ==

=== samba ===
{{anchor|.3Csamba.3E}}
<syntaxhighlight lang="xml" enclose="div">
<samba>
<doscodepage></doscodepage> 
<clienttimeout>10</clienttimeout> 
<statfiles>true</statfiles> 
</samba>
</syntaxhighlight>

=== hosts ===
{{anchor|.3Cfhosts.3E}}
Static dns entries which take precedence over your dns server.
<syntaxhighlight lang="xml" enclose="div">
<hosts>
<entry name="HOSTNAME">IPADDRESS</entry>
</hosts>
</syntaxhighlight>

=== network ===
{{anchor|.3Cnetwork.3E}}
{{see also|HOW-TO:Modify the cache}}
<syntaxhighlight lang="xml" enclose="div">
<network>
<curlclienttimeout>10</curlclienttimeout> 
<curllowspeedtime>20</curllowspeedtime> 
<curlretries>2</curlretries> 
<httpproxyusername></httpproxyusername> 
<httpproxypassword></httpproxypassword> 
<cachemembuffersize>20971520</cachemembuffersize> 
<buffermode>0</buffermode> 
<readbufferfactor>4.0</readbufferfactor> 
</network>
</syntaxhighlight>

{{Future note|17|In the upcoming Kodi v17, the three buffer settings are removed from the <code><network></code> tag and now placed under the new <code><cache></code> tag. Also, <code><cachemembuffersize></code> is renamed to <code><memorysize></code> and <code><readbufferfactor></code> is renamed to <code><readfactor></code>. See '''[[#cache]]''' for full details.}}

=== cache ===
{{Future box|17|2=In Kodi v17, the following tags are removed from <code><network></code> and placed under a new <code><cache></code> tag. Also, <code><cachemembuffersize></code> is renamed to <code><memorysize></code> and <code><readbufferfactor></code> is renamed to <code><readfactor></code>.
{{see also|HOW-TO:Modify the cache}}
<syntaxhighlight lang="xml" enclose="div">
<cache>
<memorysize>0</memorysize> 
<buffermode>0</buffermode> 
<readfactor>4.0</readfactor> 
</cache>
</syntaxhighlight>
}}

=== tuxbox ===
{{anchor|.3Ctuxbox.3E}}
<syntaxhighlight lang="xml" enclose="div">
<tuxbox>

<audiochannelselection>false</audiochannelselection>

<submenuselection>false</submenuselection>

<defaultrootmenu>0</defaultrootmenu>

<defaultsubmenu>4</defaultsubmenu>

<pictureicon>true</pictureicon>

<epgrequesttime>10</epgrequesttime>

<zapwaittime>0</zapwaittime>
</tuxbox>
</syntaxhighlight>

=== airtunesport ===
{{anchor|.3Cairtunesport.3E}}<section begin="airtunesport" />
This overwrites the defalt listening port of the AirTunes server (announced via zeroconf).
<section end="airtunesport" />

=== airplayport ===
{{anchor|.3Cairplayport.3E}}<section begin="airplayport" />
This overwrites the default listening port of the AirPlay server (announced via zeroconf).
<section end="airplayport" />

== File system settings ==

=== packagefoldersize ===
<section begin="packagefoldersize" />
{{anchor|.3Cpackagefoldersize.3E}}
{{xml setting
| tag name = packagefoldersize
| option type = numerical
| option values =
| default values = 200
| platform = all
| XBMC version = 12
| description = The amount (in megabytes) of add-on zip packages saved from previous add-on installs. These packages are mainly used for the [[add-on]] rollback feature. Increasing the size should increase the amount of past versions saved.
| example = Example: <syntaxhighlight lang="xml" enclose="div"><packagefoldersize>200</packagefoldersize> </syntaxhighlight>
}}
<section end="packagefoldersize" />
=== detectasudf ===
{{anchor|.3Cdetectasudf.3E}}
Set to true if you wish to detect joint ISO9660/UDF disks as UDF.

Default: False

=== pathsubstitution ===
{{anchor|.3Cpathsubstitution.3E}}
{{main|Path substitution}}
Path substitutions are for use for redirecting file paths. These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for Kodi to handle.

Default: No path substitutions defined.

Example:
<syntaxhighlight lang="xml" enclose="div">
<pathsubstitution>
<substitute>
<from>G:\dvds\</from>
<to>smb://somecomputer/g-share/dvds/</to> 
</substitute>
</pathsubstitution>
</syntaxhighlight>

== Input control settings ==

=== remotedelay ===
{{anchor|.3Cremotedelay.3E}}
The repeat delay for a LIRC remote control. A delay value between 1 and 20 before a remote button starts repeating on a long keypress (i.e. continuously sending button pushes while it's held down).

Default: 3
<syntaxhighlight lang="xml" enclose="div">
<remotedelay>10</remotedelay>
</syntaxhighlight>

=== remoterepeat ===
{{anchor|.3Cremoterepeat.3E}}
This used to adjust the amount of time in milliseconds between repeated keystrokes. Used to prevent key-bounce, in other words prevents Kodi (lirc?) seeing one key press as multiple key presses with certain remotes.

<syntaxhighlight lang="xml" enclose="div">
<remoterepeat>800</remoterepeat>
</syntaxhighlight>

=== controllerdeadzone ===
{{anchor|.3Ccontrollerdeadzone.3E}}
The controller deadzone is the region of movement around the center which is not recognized by the device. Because joysticks can have noise (report motion when still) and bias (report an offset when centered), spurious events can be reported even though the controller isn't being touched. If you notice these kinds of events, you most likely need to increase your controller's deadzone (both axes recommended). The values range from 0.0 (no deadzone, Kodi will see all input your controller is capable of registering) to 1.0 (it will ignore all input inside of the device's physical limits).

<syntaxhighlight lang="xml" enclose="div">
<controllerdeadzone>0.2</controllerdeadzone>
</syntaxhighlight>

=== enablemultimediakeys ===
{{anchor|.3Cenablemultimediakeys.3E}}
This setting only has any effect on Windows versions of Kodi, and only applies to builds from 28th May 2011 onwards.
In Windows the multimedia keys generate a WM_APPCOMMAND message in addition the keypress. Kodi processes both keypresses and the WM_APPCOMMAND messages, and the end result would be that the command is executed twice. To avoid this, by default multimedia keypresses are disabled. Although it should rarely be necessary, the enablemultimediakeys setting allows you to enable the multimedia keys.

Example:
<syntaxhighlight lang="xml" enclose="div">
<enablemultimediakeys>true</enablemultimediakeys>
</syntaxhighlight>

=== seeksteps ===
{{Main|Skip steps}}

This setting changes which increments are available in the settings GUI for additive seeking. Note that <code><seeksteps></code> is not used to actually choose which seek steps are enabled.

'''Default:'''
<syntaxhighlight lang="xml" enclose="div">
<seeksteps>7, 15, 30, 60, 180, 300, 600, 900, 1800</seeksteps>
</syntaxhighlight>

{{editor note|the defaults need to be updated for seeksteps.}}

=== touchscreen ===
{{anchor|.3Ctouchscreen.3E}}
This setting allows you to move/align the origin of the touch screen with the origin of the display used. If touch input does not result in a correct movement of the mouse pointer, the behaviour can be corrected with an offset and a stretch/compress factor.

Example:
<syntaxhighlight lang="xml" enclose="div">
<touchscreen>
<x_offset>0</x_offset> 
<y_offset>0</y_offset> 
<x_stretch_factor>1.0</x_stretch_factor> 
<y_stretch_factor>1.0</y_stretch_factor> 
</touchscreen>
</syntaxhighlight>

== Other interface settings ==

=== window ===
{{anchor|.3Cwindow.3E}}
This allows you to manually set the default size of Kodi's windowed mode. If you resize the window, it will return to the set size when restarting.

WIDTH and HEIGHT are the values for each dimension, in pixels.

<syntaxhighlight lang="xml" enclose="div">
<window><width>WIDTH</width><height>HEIGHT</height></window>
</syntaxhighlight>

=== allowd3d9ex ===
{{anchor|.3Callowd3d9ex.3E}}
Applies only to Windows Vista and up. Values: true/false. Allows Kodi to use Direct3D 9Ex, which is a bit more stable and robust than Direct3D 9.

Default:
<syntaxhighlight lang="xml" enclose="div">
<allowd3d9ex>true</allowd3d9ex>
</syntaxhighlight>

=== restrictcapsmask ===
{{anchor|.3Crestrictcapsmask.3E}}
Windows only. A bitmask to prevent Kodi from using detected texture capabilities of the GPU. This helps work around buggy hardware/drivers.

1: prevent the use of compressed textures (DXT1, DXT3, DXT5)
2: prevent the use of non-power-of-two dimensions for textures
4: prevent the use of compressed textures with non-power-of-two dimensions.

<syntaxhighlight lang="xml" enclose="div">
<restrictcapsmask>0</restrictcapsmask>
</syntaxhighlight>

=== forced3d9ex ===
{{anchor|.3Cforced3d9ex.3E}}
Windows only: Kodi attempts to detect drivers released for a version earlier than Vista, to avoid using advanced features which are often not emulated correctly. The detection may be incorrect and this setting allows forcing the using of D3D9Ex.

<syntaxhighlight lang="xml" enclose="div">
<forced3d9ex>false</forced3d9ex>
</syntaxhighlight>

=== algorithmdirtyregions ===
{{anchor|.3Calgorithmdirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="algorithmdirtyregions" /> {{note|Some GPU/hardware configurations will have some minor issues (such as a visual "flicker"). For those situations try mode 2 or use the default (mode 3, which requires no advancedsetting). Almost all ARM-based devices (such as [[Android]]) willl likely have flickering issues.}}

Enable dirty-region processing. Dirty regions are any parts of the screen that have changed since the last frame. By not re-rendering what hasn't changed the GUI can be sped up. Because all GPUs work differently, only Mode 3, combined with nofliptimeout=0, is guaranteed to work for everyone without flickering issues. This mode will reduce CPU/GPU usage, but will not increase GUI speed.

{| class="prettytable"
! value !! result !! description
|-
! 0
| Off
| The entire viewport is always rendered.
|-
! 1
|Union
|All dirty regions are grouped into the smallest possible rectangle. This is typically the fastest mode for slower GPUs due to only making one pass.
|-
! 2
| {{nowrap|Cost reduction}}
| Each dirty region is presented separately, in as many passes as there are regions.
|-
! 3
| {{nowrap|Whole Screen}}
| The entire screen is rendered if there are any dirty regions. This, combined with nofliptimeout is a safe default for drivers that clear buffer contents (manifests as blinking or vibrating images). '''Default'''
|}<section end="algorithmdirtyregions" />

Example:
<syntaxhighlight lang="xml" enclose="div">
<gui>
<algorithmdirtyregions>1</algorithmdirtyregions>
</gui>
</syntaxhighlight>

=== nofliptimeout ===
{{anchor|.3Cnofliptimeout.3E}}
{{see also|HOW-TO:Modify dirty regions}}
{{future note|17|nofliptimeout will be removed from the upcoming Kodi v17.}}

<section begin="nofliptimeout" />Specifies the timeout in milliseconds after which Kodi will not flip the graphics buffers anymore when nothing has been rendered, this lowers both CPU and GPU usage. Sometimes adjusting this value can help prevent flickering.

* -1: disabled
* 0 or higher: timeout in milliseconds '''(0 is default)'''
<section end="nofliptimeout" />
Example:
<syntaxhighlight lang="xml" enclose="div">
<gui>
<nofliptimeout>1000</nofliptimeout>
</gui>
</syntaxhighlight>

=== visualizedirtyregions ===
{{anchor|.3Cvisualizedirtyregions.3E}}
{{see also|HOW-TO:Modify dirty regions}}
<section begin="visualizedirtyregions" />Enable dirty-region visualization. Paints a rectangle over marked controls.

* true: on
* false: off '''(Default)'''

{{note|This is only a development mode and isn't of use to normal users.}}
<section end="visualizedirtyregions" />
Example:
<syntaxhighlight lang="xml" enclose="div">
<gui>
<visualizedirtyregions>true</visualizedirtyregions>
</gui>
</syntaxhighlight>

=== showexitbutton ===
{{anchor|.3Cshowexitbutton.3E}}
Setting to hide the exit button, useful for people running appliance based setup's where exit would only confuse/complicate the user. Modifiable via the advancedsettings.xml by setting showexitbutton to false, default is true (show)

Example:
<syntaxhighlight lang="xml" enclose="div">
<showexitbutton>true</showexitbutton>
</syntaxhighlight>

=== fullscreen ===
{{anchor|.3Cfullscreen.3E}}
Starts Kodi in full screen (check resolutions!).

<syntaxhighlight lang="xml" enclose="div">
<fullscreen>false</fullscreen>
</syntaxhighlight>

=== splash ===
{{anchor|.3Csplash.3E}}
Set to false if you wish to disable the startup splash image. Defaults to true.

<syntaxhighlight lang="xml" enclose="div">
<splash>true</splash>
</syntaxhighlight>

=== cputempcommand ===
{{anchor|.3Ccputempcommand.3E}}
Provide a shell command Kodi will use to get CPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia and Raspberry Pi</u>
<syntaxhighlight lang="xml" enclose="div">
<cputempcommand>sed -e 's/$[0-9]*$[0-9]\{3\}.*/\1 C/' /sys/class/thermal/thermal_zone0/temp</cputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang="xml" enclose="div">
<cputempcommand>echo "$(sensors -u | tail -n64 | grep temp1_input | awk '{print $2 }' |awk '{printf("%d\n",$1 + 0.5);}') C"</cputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang="xml" enclose="div">
<cputempcommand>sensors|sed -ne "s/temp1: \+[-+]$[0-9]\+$.*/\1 C/p"</cputempcommand>
</syntaxhighlight>

=== gputempcommand ===
{{anchor|.3Cgputempcommand.3E}}
Provide a shell command Kodi will use to get GPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br />
;<u>For Nvidia</u>
<syntaxhighlight lang="xml" enclose="div">
<gputempcommand>echo "$(nvidia-settings -tq gpuCoreTemp) C"</gputempcommand>
</syntaxhighlight>
or
<syntaxhighlight lang="xml" enclose="div">
<gputempcommand>echo "$(nvidia-smi -q -d TEMPERATURE | grep Gpu | cut -c35-36) C"</gputempcommand>
</syntaxhighlight>
;<u>For ATI/AMD</u>
<syntaxhighlight lang="xml" enclose="div">
<gputempcommand>/usr/bin/aticonfig --od-gettemperature | grep Temperature | cut -f 2 -d "-" | cut -f 1 -d "." | sed -e "s, ,," | sed 's/$/ C/'</gputempcommand>
</syntaxhighlight>

;<u>For Raspberry Pi</u>
<syntaxhighlight lang="xml" enclose="div">
<gputempcommand>/opt/vc/bin/vcgencmd measure_temp | sed -e "s/temp=//" -e "s/\..*'/ /"</gputempcommand>
</syntaxhighlight>

=== glrectanglehack ===
{{anchor|.3Cglrectanglehack.3E}}
Problems with ghosting or videos which are only played back in the left upper quarter? The following ATI hack may solve it.
<syntaxhighlight lang="xml" enclose="div">
<glrectanglehack>yes</glrectanglehack>
</syntaxhighlight>

=== alwaysontop ===
{{anchor|.3Calwaysontop.3E}}
Added in XBMC v9.11 (Windows OS only). Keeps Kodi always on top when windowed.
<syntaxhighlight lang="xml" enclose="div">
<alwaysontop>yes</alwaysontop>
</syntaxhighlight>

Alternate code.
<syntaxhighlight lang="xml" enclose="div">
<videoscreen>
<fakefullscreen>false</fakefullscreen>
</videoscreen>
</syntaxhighlight>

== Removed tags ==
{{anchor|Recently removed tags}}
* {{anchor|.3Cthumbsize.3E}}'''<thumbsize>''' - replaced by <[[#imageres|imageres]]> in v12 Frodo
* {{anchor|.3Cfanartheight.3E}}'''<fanartheight>''' - replaced by <[[#fanartres|fanartres]]> in v12 Frodo
* {{anchor|.3Cdvdthumbs.3E}}'''<dvdthumbs>''' - removed in v12 Frodo
* {{anchor|.3Cbusydialogdelayms.3E}}'''<busydialogdelayms>''' - removed in v12 Frodo
* {{anchor|.3Cbginfoloadermaxthreads.3E}}'''<bginfoloadermaxthreads>''' - removed in v13 Gotham
* '''<showepginfoonselect>''' - replaced by a GUI setting in v13 Gotham
* '''<resample>''', '''<forceDirectSound>''', '''<audiophile>''', '''<audiosinkbufferdurationmsec>''', '''<allowtranscode44100>''', and '''<streamsilence>''' - These were various sub-tags for <audio> that were removed in v13 Gotham and either replaced by GUI settings or were no longer needed.
* {{anchor|.3Cenableairtunesdebuglog.3E}}'''<enableairtunesdebuglog>''' - replaced by a GUI option in v14 Helix
* '''<videoDisableHi10pMultithreading>''' - renamed to <disableswmultithreading> in v14 Helix
* '''<hideallitems>''' - For both the <code><videolibrary></code> and <code><musiclibrary></code> sections, this is replaced by a GUI option in v15 Isengard
* '''<SmallStepBackSeconds>''' - In v15 the <code>SmallStepBack</code> [[action ID]] has been replaced by <code>seek(-7)</code> in default keymaps. See '''[[skip steps]]''' for details. When the original <code>SmallStepBack</code> action ID is used it defaults to the first backwards [[skip steps|additive seeking value]].
* '''<timeseekforward>/<timeseekbackward>''' - In v15 these tags are replaced by GUI options via [[skip steps|additive seeking]], which is configured in the GUI. See '''[[skip steps]]''' for details.
* {{anchor|.3Ckaraoke.3E}}'''<karaoke>''' - In v16 all of the karaoke features in Kodi were removed.
* '''<useddsfanart>''' - removed in v17 Krypton.
* '''<cachemembuffersize>''' and '''<readbufferfactor>''' - In v17 <cachemembuffersize> is renamed to <memorysize> and <code><readbufferfactor></code> is renamed to <code><readfactor></code>. In addition, all three buffer related settings in <network> are moved out of <network> and into a new <cache> parent tag.
* '''<minvideocachelevel>''', '''<minaudiocachelevel>''', and '''<cacheindvdplayer>''' have been removed in v17.
* '''<useffmpegvda>''' - Tag was only used for development testing. Removed in v17.

== guisettings.xml settings ==
You can also define the settings normally defined in the GUI (and stored in guisettings.xml) in advancedsettings.xml. Most guisettings.xml settings defined in advancedsettings.xml will override the guisettings.xml values, and the settings will be removed completely from the interface.

The easiest way to include a guisettings.xml setting is to first change the setting in the interface to the value that you want, and then open the '''[[userdata]]/guisettings.xml''' file and find the XML entry that corresponds to that setting.

Then just add that entry to the advancedsettings.xml file.

For instance, to set the Font Character Set (found in the appearance setting, in the Look and Feel section), you'd open up guisettings.xml and find:

<syntaxhighlight lang="xml" enclose="div">
<lookandfeel>
<charset>Hebrew (Windows)</charset>
</lookandfeel>
</syntaxhighlight>

Simply take that entry and place it in advancedsettings.xml. The option in Kodi's interface for the character set will then no longer be visible, and Kodi will always use the Hebrew (Windows) character set.

{{Updated|15}}
{{DISPLAYTITLE:advancedsettings.xml}}

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

Archive:Kodi v17 (Krypton) changelog

2016-11-11T07:34:16Z

Ksooo:

{{mininav|[[Releases]] {{l2| [[Krypton]] }} }}

{{notice|Kodi v16 (Jarvis) final have just recently been released, so please keep in mind that a final non-alpha/beta v17 (Krypton) release is still far away into the future. As such, these new features/functions and API changes is a placeholder containing changes to the current Kodi mainline (the git master tree repository on GitHub). It is a very much a work in progress, this is only listing changes commited to the master branch after Jarvis branching, and many many many features/functions and API additions, alterations or removal are still subject to future change.}}
{{incomplete}}
{{future|17}}

{{see also|Kodi v17 (Krypton) FAQ|Krypton API changes|Releases}}

This is a placeholder and Kodi Wiki copy of the condensed changelog for the future Kodi v17.x version (codename: "Krypton") releases with a summery of the most important core features and functions as well as other notable changes to key areas of the application software or its user interface.

== Changelog ==

=== Live TV and PVR (Personal Video Recorder) ===
* Added enhancement/improvements to PVR addon API (connection state change handling, asynchronous updates & more)<ref>http://github.com/xbmc/xbmc/pull/8736</ref> <ref>http://github.com/xbmc/xbmc/pull/9295</ref><ref>http://github.com/xbmc/xbmc/pull/9662</ref>
* Added support for navigation controls between [[EDL]] (commercial skipping) during PVR recodings playback<ref>http://github.com/xbmc/xbmc/pull/10064</ref>
* Added support for sorting channels by 'last played' in the Channels window<ref>http://github.com/xbmc/xbmc/pull/9248</ref>
* Added support to changing of timer type for existing timers to ex. change a episode timer to a series timer<ref>http://github.com/xbmc/xbmc/pull/10057</ref>
* Added support to echo up important Status info to Timer Rules in the Timer rules window<ref>http://github.com/xbmc/xbmc/pull/8732</ref>
* Added option to hide disabled timers in the Timer window<ref>http://github.com/xbmc/xbmc/pull/8543</ref>
* Added support for 'Edit timer' & 'Delete timer' rules to context menu in the EPG & Search windows<ref>http://github.com/xbmc/xbmc/pull/8713</ref><ref>http://github.com/xbmc/xbmc/pull/9370</ref>
* Added support to allow timer creation for EPG in recent past in the EPG window<ref>http://github.com/xbmc/xbmc/pull/8447</ref>
* Added support to use timer logos depending on its state in the EPG window<ref>http://github.com/xbmc/xbmc/pull/9012</ref><ref>http://github.com/xbmc/xbmc/pull/9636</ref><ref>http://github.com/xbmc/xbmc/pull/9657</ref>
* Added "ShowTimerRule" builtin to allow key mapping for "add timer" dialog pre-filled for epg-based timer rule<ref>http://github.com/xbmc/xbmc/pull/9370</ref>
* Added 'recent recordings' widget (core support and Estuary PVR home screen)<ref>http://github.com/xbmc/xbmc/pull/10438</ref>
* Added vertical scrollbar to Guide window to allow channel navigation using the mouse (core support and Estuary change)<ref>http://github.com/xbmc/xbmc/pull/10450</ref>
* Added support for JSON-RPC API sync PVR types fields with current implementation<ref>http://github.com/xbmc/xbmc/pull/10074</ref>
* Improveed playback of live streams as PVR Live TV streams can now be identified as "live"
* Improved Kodi's Eventlog with extentions to PVR events for 'create/delete timers, timer rules', 'start/stop recordings'<ref>http://github.com/xbmc/xbmc/pull/8374</ref>
* Improved PVR Guide window performance, especially on first open<ref>http://github.com/xbmc/xbmc/pull/9370</ref><ref>http://github.com/xbmc/xbmc/pull/9453</ref>
* Changes to have separate windows for 'Timer Rules' from 'Timers'<ref>http://github.com/xbmc/xbmc/pull/8561</ref>
* Changes to separate TV and Radio recordings in the Recordings window<ref>http://github.com/xbmc/xbmc/pull/9319</ref>
* Changes to make 'group items' setting be persistent in the Recordings window<ref>http://github.com/xbmc/xbmc/pull/10101</ref>
* Changes to recordings window which now respects "default select action" settings value<ref>http://github.com/xbmc/xbmc/pull/10333</ref>
* Changes to instant recording behavior to make it configurable (fixed-time vs. current show vs. interactive)<ref>http://github.com/xbmc/xbmc/pull/9847</ref>
* Refactoring of the PVR Manager (PVRManager) so addons are now owned by Kodi's addon system<ref>http://github.com/xbmc/xbmc/pull/9429</ref>
* Added, updated, and improved PVR backend clients addons for all popular third-party external [[PVR backend]] platforms:
** New: [[Add-on:DigitalDevices Octopus NET Client|DigitalDevices Octopus NET Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VDR VNSI Client|VDR VNSI Client]] PVR Addon backend client maintained and available from Team Kodi
** [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP Client]] PVR Addon backend client maintained and available from Team Kodi
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:HDHomeRun PVR|HDHomeRun]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VU+ / Enigma2 Client|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Njoy N7 PVR Client|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MythTV PVR Client|MythTV PVR Client]] Addon backend client maintained and available from the Kodi's community
** [[Add-on:NextPVR PVR Client|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Argus TV Client|Argus TV (former ForTheRecord)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBLink PVR Client|DVBLink PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBViewer Client|DVBViewer Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MediaPortal PVR Client|MediaPortal PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:IPTV Simple Client|IPTV Simple Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR Demo Client|PVR Demo Client]] dummy addon with fake (method stub) [[PVR backend]] for [[PVR]] skinning and regression testing

=== Add-ons Framework, API, and Manager ===
For full changelogs of all Addons APIs, see [[Krypton API changes]], [http://forum.kodi.tv/forumdisplay.php?fid=174 JSON-RPC], and [http://forum.kodi.tv/forumdisplay.php?fid=26 Add-ons] Development Forums
* Added a new API level system to binary addons, refactoring the binary addon library interface for Kodi<ref>http://github.com/xbmc/xbmc/pull/9659</ref>
* Added a new input system with an API for keyboard and game controllers as "Peripheral Addons"<ref name="Controller input system">PR #8807 Controller input system http://github.com/xbmc/xbmc/pull/8807</ref>
* Added API support for "Peripheral Addons" for updatable configuration of input devices<ref name="Controller input system"/>
* Added support for game controller peripheral addons to system addons<ref>http://github.com/xbmc/xbmc/pull/9374</ref>
* Added a user-mappable Joystick (Peripheral) Addon for joysticks and gamepad abstraction APIs<ref>http://github.com/kodi-game/peripheral.joystick</ref><ref name="Controller input system"/><ref>http://github.com/xbmc/xbmc/pull/9376</ref>
* Added "Peripheral Addons" for game controllers, gamepads, joysticks, and input peripherals (in repo<ref>http://github.com/kodi-game/ kodi-game repo on GitHub</ref>):
** [http://github.com/kodi-game/peripheral.joystick Joystick Controller Addon]
** [http://github.com/kodi-game/peripheral.xarcade X-Arcade (XGaming Tankstick) support for Kodi Addon]
** [http://github.com/kodi-game/peripheral.steamcontroller Steam Controller (gamepad) Addon]
** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.default Default Game Controller Addon (reference game controller addon based on Xbox 360 gamepad)]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.ps PlayStation Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.nes Nintendo NES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.snes Nintendo SNES Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.n64 Nintendo N64 Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.gba Nintendo GBA Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.genesis Sega Genesis Game Controller Addon]
*** [http://github.com/kodi-game/kodi-game-controllers/tree/master/addons/game.controller.dreamcast Sega Dreamcast Game Controller Addon]
* Added support for method to get our useragent string<ref>http://github.com/xbmc/xbmc/pull/8643</ref>
* Added support for Addons to include screenshots to be visible in Kodi's Addons Manager
* Added support for skins to display 'recently installed' or 'recently updated' addon list in Addon Manager<ref name="Recently installed or update">Recently installed or update http://kodi.tv/kodi-v17-krypton-alpha-2/</ref>
* Added setting for enabling/disabling ZIP installation of addons from unknown sources (disbaled by default)<ref name="Unknown sources">Unknown sources... http://kodi.tv/kodi-v17-krypton-alpha-2/</ref><ref>http://github.com/xbmc/xbmc/pull/8857</ref>
* Added a lot of Doxygen related Addons documentation regarding builtin commands to Documentation<ref>http://github.com/xbmc/xbmc/pull/9433</ref>

=== GUI Engine (Skinning Engine) ===
For full changelog on changes to the skinning engine, see [[Krypton API changes]] and the [http://forum.kodi.tv/showthread.php?tid=250862 Skin Development Forum]
* Added a new default skin called Estuary, with themes & colors, (moving Confluence to addon repo)<ref name="brand new look">A brand new look for future Kodi versions http://kodi.tv/a-brand-new-look-for-future-kodi-versions/</ref><ref>http://github.com/xbmc/xbmc/pull/9235</ref>
* Added a new default touch-screen enabled skin called Estouchy (moving Re-Touched to addon repo)<ref name="brand new look"/><ref>http://github.com/xbmc/xbmc/pull/9222</ref>
* Added a new Color Manager to handle loading of madVR 3D LUT ICC profiles for color correction<ref>http://github.com/xbmc/xbmc/pull/9731</ref>
* Added a new FFmpeg based image loader to guilib for loading pictures<ref>http://github.com/xbmc/xbmc/pull/8370</ref>
* Added a new FFmpeg based image thumbnails implementation<ref>http://github.com/xbmc/xbmc/pull/8583</ref>
* Added experimental limited support to guilib for animated APNG images in skin textures and backgrounds/posters<ref>http://github.com/xbmc/xbmc/pull/8937</ref>
* Added experimental limited support to guilib for animated GIF images in skin textures and backgrounds/posters<ref>http://github.com/xbmc/xbmc/pull/8937</ref>
* Added support for [[EDL|commercial skipping]] notifications and toggle action<ref>http://github.com/xbmc/xbmc/pull/9399</ref>
* Added support for defaultcontrol to grouplists to allow skins to define defaults<ref>http://github.com/xbmc/xbmc/pull/8501</ref>
* Added support for 'InstallAddon' builtin to allow skins to install addons on demand<ref>http://github.com/xbmc/xbmc/pull/8419</ref>
* Added Skin.SelectBool builtin support for skinning<ref>http://github.com/xbmc/xbmc/pull/8303</ref>
* Added support for multi-touch to display adjustment for touch panel calibration<ref>http://github.com/xbmc/xbmc/pull/9160</ref>
* Improved skinning PVR section by unifying and/or seperating different PVR related windows
* Update guilib ABI (for libgui) to version 5.11.0<ref>http://github.com/xbmc/xbmc/pull/8948</ref>
* Updated keyboard layout for some languages and added new keyboard layout for French AZERTY & Italian QWERTY
* Changed context menus by refactoring to a global item based system to unify them<ref>http://github.com/xbmc/xbmc/pull/9257</ref>
* Changed GetThumbSize() to m_imageResso so bookmark/chapter images are same resolution as posters
* Changed background loading of thumbnails so that it is enabled by default
* Changed default icons with updated versions

=== Platform Independent Playback ===
* Major refactoring of Kodi's built-in video player core (which also been renamed from "[[DVDPlayer]]" to "VideoPlayer")<ref name="First wave of changes">Video Player - First wave of changes http://kodi.tv/kodi-v17-krypton-alpha-2/</ref><ref name="VideoPlayer Development">VideoPlayer Development Forum (developers only) http://forum.kodi.tv/forumdisplay.php?fid=240</ref><ref name="VideoPlayer refactoring">PR #8486 VideoPlayer refactoring initial pull request http://github.com/xbmc/xbmc/pull/8486</ref>
* Added support for "InputStream" binary addon extension point that can serve as input stream for VideoPlayer<ref>http://github.com/xbmc/xbmc/pull/9173</ref><ref>http://github.com/xbmc/xbmc/pull/9162</ref>
* Added support for "InputStream" (input stream) addons to system addons<ref>http://github.com/xbmc/xbmc/pull/9373</ref>
* Added "InputStream" (input stream) client addons for common network streaming protocols and popular services:
** [http://github.com/xbmc/xbmc/tree/master/addons/kodi.inputstream InputStream Addon (default reference InputStream Addon by Team Kodi]
** [http://github.com/mapfau/inputstream.test Test InputStream Addon (Test InputStream Addon for Kodi's new inputstream interface]
** [http://github.com/xbmc/repo-binary-addons/tree/master/inputstream.rtmp RTMP InputStream Addon (InputStream Client for RTMP streams using librtmp)]
** [http://github.com/xbmc/repo-binary-addons/tree/master/inputstream.mpd MPD (MPEG-DASH) InputStream Addon]
** [http://github.com/xbmc/repo-binary-addons/tree/master/inputstream.smoothstream SmoothStream InputStream Addon for MS-SSTR (SmoothStreamingMedia) Smooth Streaming Protocol]
** [http://github.com/mapfau/inputstream.nxmsl NXMSL InputStream Addon for Netflix style manifests over MSL]
* Added support for 3D LUT (3D Lookup Table) & simple ICC profile linking support for color correction<ref>http://github.com/xbmc/xbmc/pull/9731</ref>
* Added video stream selection to audio/subtitle dialogue to choose between multiple videos<ref name="VideoPlayer Development"/><ref name="VideoPlayer refactoring"/>
* Added support for dithering for OpenGL rendering (part of VideoPlayer refactoring)<ref name="VideoPlayer Development"/><ref name="VideoPlayer refactoring"/>
* Added support for gapless playback on stream change (with the new VideoPlayer)<ref>http://github.com/xbmc/xbmc/pull/8886</ref>
* Added two new view modes that zoom depending on aspect ratio to match the screen heigh<ref>http://github.com/xbmc/xbmc/pull/10318</ref>
* Added method for requesting desired video resolution to demuxer to new VideoPlayer<ref>http://github.com/xbmc/xbmc/pull/9531</ref>
* Added multi-stream input demuxer to support a video stream with external audio tracks/streams<ref name="First wave of changes"/><ref>http://github.com/xbmc/xbmc/pull/9286</ref>
* Added support to change playback speed with audio enabled between 0.8 to 1.5 of normal speed with 'tempo' controls<ref>http://github.com/xbmc/xbmc/pull/10216</ref><ref>http://github.com/xbmc/xbmc/pull/10164</ref>
* Added support for external PGS/.sup (Blu-ray Disc) subtitles<ref>http://github.com/xbmc/xbmc/pull/9559</ref>
* Added support for hardware video acceleration of DVD-Video (with the new VideoPlayer)<ref name="First wave of changes"/>
* Added and improved several [[Audio DSP]] (Digital Signal Processing) plugins and ADSP addons for Kodi's [[AudioEngine]]<ref>http://github.com/xbmc/repo-binary-addons/</ref>
* Added and updated many audio decoder and encoder addons for Kodi<ref>http://github.com/xbmc/repo-binary-addons/</ref>
* Changed video renderers to separate graphics rendering from main thread (part of VideoPlayer refactoring)<ref name="VideoPlayer Development"/>
* Improved A/V sync during video playback which reduce time required for audio sync (part of VideoPlayer refactoring)<ref name="VideoPlayer Development"/><ref name="VideoPlayer refactoring"/>
* Improved switching refresh rates during video playback (part of VideoPlayer refactoring)<ref name="First wave of changes"/><ref name="VideoPlayer Development"/><ref name="VideoPlayer refactoring"/>
* Improved audio pass-through support during video playback (part of VideoPlayer refactoring)<ref name="VideoPlayer Development"/><ref name="VideoPlayer refactoring"/>
* Improved MMAL playback of H.264 MVC (Blu-ray [[3D]]) stereoscopic video with framepacking decoding on Raspberry Pi
* Improved Stereoscopic 3D playback of 3D videos (as well as better 2D playback of 3D videos)
* Improved and enhanced Blu-ray support (including updated libbluray dependecies from the VideoLAN project<ref>http://git.videolan.org/?p=libbluray.git;a=blob;f=ChangeLog</ref>)<ref>http://github.com/xbmc/xbmc/pull/10056</ref>
* Upgraded FFmpeg multimedia codec and demux libraries to stable branch release version [http://www.ffmpeg.org/download.html#release_3.1.5 FFmpeg 3.1.5]<ref>http://git.videolan.org/?p=ffmpeg.git;a=blob_plain;f=Changelog;hb=release/3.1.5 FFmpeg 3.1.5 release changelog</ref><ref>http://github.com/xbmc/xbmc/pull/10746</ref>
* Removed certain audio codecs from core and made them into audio decoder and audio encoder add-ons

=== Library ===
* Added support for scraping, storing, and displaying multiple ratings from different sources<ref>http://github.com/xbmc/xbmc/pull/8080</ref>
* Added support for user rating to the OSD (On Screen Display) for music playback<ref>http://github.com/xbmc/xbmc/pull/9094</ref>
* Added support for rating and votes label for specific rating<ref>http://github.com/xbmc/xbmc/pull/8788</ref>
* Added support to filtering by userrating in the mediafilter dialog<ref>http://github.com/xbmc/xbmc/pull/8553</ref>
* Added support to include watched status for movies in actor search dialog<ref>http://github.com/xbmc/xbmc/pull/10688</ref>
* Added artist roles tag to the music library to handle tags for ex. Composer, Conductor, DJMixer, etc.<ref>http://github.com/xbmc/xbmc/pull/8015</ref>
* Added support for MOOD tag scanning for FLAC, Ogg, Xiph, Vorbis, ASF and MP4 audio files to music library<ref>http://github.com/xbmc/xbmc/pull/8905</ref>
* Added option to exclude singles in recently played albums (set to enabled by default)
* Added support for showning "in progress tv shows" in the filesystem-tree<ref>http://github.com/xbmc/xbmc/pull/8261</ref>
* Added support Audio and Subtitle Track Count to Smart Playlist selections filtering<ref>http://github.com/xbmc/xbmc/pull/8333</ref>
* Added support to sort actors by number of movies they are in<ref>http://github.com/xbmc/xbmc/pull/8576</ref>
* Added support to sort discography ascending by years
* Added support for a method to retrieve video tags<ref>http://github.com/xbmc/xbmc/pull/7369</ref>
* Added ability to JSON-RPC API to return user ratings
* Improved performance for tag scanning and browsing speed in the Music library
* Improved database performance for addons accessing library

=== Web Scrapers ===
* Refactoring and updated scrapers in Kodi for music, movies, tv shows, and music videos
* Added possibility to get information from both .nfo and scraper

=== AudioEngine ===
* Added initial support for [[Audio DSP]] (Digital Signal Processing) plugins and addons for Kodi's [[AudioEngine]][http://forum.kodi.tv/forumdisplay.php?fid=235]
* Improved the default cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] (Kodi's [[AudioEngine]])
* Improved ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems
* Improved PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop
* Improved OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD and similar BSD Unix based systems
* Improved AudioTrack sink for [[AudioEngine#ActiveAE|ActiveAE]] for Android
* Improved Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]
* Improved DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved CoreAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* Improved Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS

=== Other ===
* Added support for game controller haptics (rumble motors) when the user receives a notification<ref>http://github.com/xbmc/xbmc/pull/9663</ref>
* Added support for AppVeyor CI (CI for Windows) build server for regression testing of Kodi and binary addons<ref>http://github.com/xbmc/xbmc/pull/9258</ref>
* Added support building binary addons to Travis build server for regression testing of Kodi<ref>http://github.com/xbmc/xbmc/pull/9103</ref>
* Added support for auto creating code documentation with Doxygen including To-Do list ([http://codedocs.xyz/xbmc/xbmc/ http://codedocs.xyz/xbmc/xbmc/] )
* Added documentation for skinning API to Doxygen, and moved PyDocs of Kodi API to Doxygen
* Added support for IPv6 via cURL
* Added default for the WeTek Play USB remote to peripherals as input device<ref>http://github.com/xbmc/xbmc/pull/10169</ref>
* Added and updated many audio visualization and screensaver addons for Kodi<ref>http://github.com/xbmc/repo-binary-addons/</ref>
* Improved code stability, performance. and security, as well as general code clean-up in many core areas
* Improved render capture which is used by [[Ambilight]] implementations (such as example [[Add-on:Kodi Boblight|Boblight]])
* Improved the the integrated UPnP / DNLA Media Server and Client<ref>http://github.com/xbmc/xbmc/pull/8045</ref><ref>http://github.com/xbmc/xbmc/pull/8051</ref>
* Improved AirPlay compatibility support for iOS 8 (via updated libshairplay)<ref>http://github.com/xbmc/xbmc/pull/8180</ref>
* Improved Kodi's JSON-RPC API
* Improved the the integrated web server (used for remote control web interface and more)
* Improved [[CEC|HDMI CEC (Consumer Electronics Control)]] support for [http://libcec.pulse-eight.com/ Pulse-Eight's LibCEC]
* Improved "long-press" support functionality of a single button on a remote control

* Updated community maintained translations to over 60+ languages to date for Kodi via [[Translation System|Transifex Translation System]]
* Updated critical dependency libraries such as sqlite, openssl, gnutls, and CMake (used to compile binary addons)
* Removed support for RAW image decoding (with removal of CxImage as FFmpeg do not support RAW<ref>http://github.com/xbmc/xbmc/pull/8662</ref><ref>http://github.com/xbmc/xbmc/pull/8583</ref>)
* Removed CxImage, Libgif, and JpegIO (C/C++ libraries) as dependencies in favor of FFmpeg image decoding<ref>http://github.com/xbmc/xbmc/pull/8662</ref><ref>http://github.com/xbmc/xbmc/pull/8583</ref><ref>http://github.com/xbmc/xbmc/pull/9055</ref>
* Removed all Boost (C++ libraries) and libsquish as dependencies<ref>http://github.com/xbmc/xbmc/pull/9021</ref><ref>http://github.com/xbmc/xbmc/pull/9092</ref>

=== Android Specific ===
* Moved to Android API 21 and SDK 21 with NDK 10 as minimum, meaning at least Android 5.0 is now required<ref>http://github.com/xbmc/xbmc/pull/9688</ref><ref>http://github.com/xbmc/xbmc/pull/9517</ref><ref>http://github.com/xbmc/xbmc/pull/9528</ref>
* Moved jni into its own separate project / submodule (jni backports from SPMC)<ref>http://github.com/xbmc/xbmc/pull/10808</ref>
* Added support for audio pass-through for DTS-HD, DTS-X, Dolby TrueHD, and Dolby ATMOS
* Added support in CMake to debug binary-addon packaging issues on Android<ref>http://github.com/xbmc/xbmc/pull/10803</ref>
* Improved MediaCodec API video decoding implementations support for Android 5.0 (API level 21) and later
* Improved automatic refresh rate switching support for video playback on Android 5.0 & later (>= API 21), inc. Android TV
* Improved support for UltraHD decoding / 4K resolution output when HW supports it
* Improved playback of HEVC, VC-1 / WMV 9, and VP9 hardware video decoding when using Android's MediaCodec API
* Removed AMLCodec hardware accelerated video decoding support for Android on Amlogic devices<ref>http://github.com/xbmc/xbmc/pull/9688</ref>

=== BSD Specific ===
* Added new CMake based build system of Kodi and binary addons for BSD (as well as for Linux, OSX, and Windows)<ref>http://github.com/xbmc/xbmc/pull/9083</ref><ref>http://github.com/xbmc/xbmc/pull/10087</ref>
* Improved Kodi support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)

=== Linux Specific ===
* Added new CMake based build system of Kodi and binary addons for Linux (as well as for BSD, OSX, and Windows)<ref>http://github.com/xbmc/xbmc/pull/9083</ref>
* Added multi-architecture/distribution support to Kodi's CMake build system for Linux<ref>http://github.com/xbmc/xbmc/pull/10359</ref>
* Added support for HEVC Main 10 profile (10-bit) hardware video decoding via VAAPI if hardware support it
* Added support for VP9 hardware video acceleration via VAAPI if supported by display drivers<ref>http://github.com/xbmc/xbmc/pull/8624</ref>
* Added support for EGL for X11 (which adds zero copy rendering for VAAPI)<ref name="VideoPlayer Development"/><ref name="VideoPlayer refactoring"/>
* Added support for zero copy interface to FFmpeg for MMAL renderer on Raspberry Pi<ref>http://github.com/xbmc/xbmc/pull/9384</ref>
* Added support for Clang compiler building of Kodi
* Added support for generating Debian packages with Kodi's shiny new CMake/CPack system<ref>http://github.com/xbmc/xbmc/pull/9987</ref>
* Added warning that GNU Build System (Autotools) will be removed soon as deprecated<ref>http://github.com/xbmc/xbmc/pull/10797</ref>
* Improved multi-touch support, and improved touch and gesture support on Linux
* Improved support for UltraHD decoding / 4K resolution output when hardware supports it
* Improved OpenGL ES and EGL support (using [[Raspberry Pi]] as reference devices)
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* Improved XvBA (AMD/ATI) Hardware Video Acceleration (requires XvBA compatible hardware and drivers)
* Improved OpenMAX Video Acceleration API support for Linux (using Raspberry Pi as reference hardware)
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on [[Amlogic]] devices
* Improved AMD/Intel x86-64 64-bit (AMD64 / IA-64t CPU architectures) support under Linux
* Removed Wayland display server protocol support (as depended heavily on removed Boost C++ libraries)<ref>http://github.com/xbmc/xbmc/pull/8980</ref>

=== iOS Specific ===
* Added support for iOS 10.0 by adding support for compiling Kodi with Xcode 8 IDE and iOS SDK 10.0<ref>http://github.com/xbmc/xbmc/pull/10530</ref>
* Added support for TVOS (Apple's iOS fork for Apple TV 4) to Kodi mainline
* Added support to build iOS for ARM64 (64-bit iOS)
* Improved Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)
* Improved touch and gesture support for iOS based iDevice platforms (iPad, iPod, and iPhone)

=== OS X Specific ===
* Added new CMake based build system of Kodi and binary addons for OSX (as well as for Linux, BSD, and Windows)<ref>http://github.com/xbmc/xbmc/pull/9083</ref>
* Added “Copy to Kodi” functionality on iOS (for “Open In” Kodi feature in iOS)
* Added support for compiling Kodi with Xcode 8 IDE for OSX 10.11 (El Capitan) and macOS 10.12 (Sierra)<ref>http://github.com/xbmc/xbmc/pull/10530</ref>
* Improved Apple VDADecoder Video Acceleration support for (Mac) OS X

=== Windows Specific ===
* Converted Kodi to an Desktop Bridge UWP (Universal Windows Platform) compatible app for Windows 10 (x86 only)<ref name="Kodi goes Windows Store">http://kodi.tv/kodi-goes-windows-store/ Kodi goes Windows Store</ref>
* Added initial support to compile Kodi for Microsoft's UWP (Universal Windows Platform) APIs<ref name="Kodi goes Windows Store"/>
* Added new CMake based build system of Kodi and binary addons for Windows (as well as for Linux, BSD, and OSX)<ref>http://github.com/xbmc/xbmc/pull/9083</ref>
* Added support for HEVC Main 10 profile (10-bit) hardware video decoding via DXVA on Windows if drivers support it
* Added support for 10 to 16 bit video output through the DXVA renderer
* Improved rendering system for DirectX 11 and Direct3D 11 native support on Microsoft Windows
* Improved DXVA/DXVA2 (DirectX Video Acceleration) support (requires DXVA/DXVA2 compatible hardware & drivers)
* Changed all external libraries to be built with Microsoft Visual Studio 2015
* Removed unneeded DXVA to D3D11VA wrapper as we now build FFmpeg with D3D11VA support and use it directly<ref>http://github.com/xbmc/xbmc/pull/9198</ref>

== References ==
<references/>

== See also ==
* [[Krypton API changes]]
{{Changelogs}}

[[Category:Manual]]
[[Category:Krypton|*]]
[[Category:Changelogs|17]]

Archive:Kodi v17 (Krypton) changelog

2016-09-12T12:23:14Z

Ksooo: /* Live TV and PVR (Personal Video Recorder) */

{{mininav|[[Releases]] {{l2| [[Krypton]] }} }}

{{notice|Kodi v16 (Jarvis) final have just recently been released, so please keep in mind that a final non-alpha/beta v17 (Krypton) release is still far away into the future. As such, these new features/functions and API changes is a placeholder containing changes to the current Kodi mainline (the git master tree repository on GitHub). It is a very much a work in progress, this is only listing changes commited to the master branch after Jatvis branching, and many many many features/functions and API additions or removals are subject to future change.}}
{{incomplete}}
{{future|17}}

{{see also|Kodi v17 (Krypton) FAQ|Krypton API changes|Releases}}

This is a placeholder and Kodi Wiki copy of the condensed changelog for the future Kodi v17.x version (codename: "Krypton") releases with a summery of the most important core features and functions as well as other notable changes to key areas of the application software or its user interface.

== Changelog ==

=== Live TV and PVR (Personal Video Recorder) ===
* Refactoring of PVR Manager (PVRManager) so addons are now owned by the addon system<ref>http://github.com/xbmc/xbmc/pull/9429</ref>
* Added enhancement/improvements to PVR addon API (connection state change handling, asynchronous updates & more)<ref>http://github.com/xbmc/xbmc/pull/8736</ref> <ref>http://github.com/xbmc/xbmc/pull/9295</ref><ref>http://github.com/xbmc/xbmc/pull/9662</ref>
* Added support for navigation controls between [[EDL]] (commercial skipping) during PVR recodings playback<ref>http://github.com/xbmc/xbmc/pull/10064</ref>
* Added support for sorting channels by 'last played' in the Channels window<ref>http://github.com/xbmc/xbmc/pull/9248</ref>
* Added support to changing of timer type for existing timers to ex. change a episode timer to a series timer<ref>http://github.com/xbmc/xbmc/pull/10057</ref>
* Added support to echo up important Status info to Timer Rules in the Timer rules window<ref>http://github.com/xbmc/xbmc/pull/8732</ref>
* Added option to hide disabled timers in the Timer window<ref>http://github.com/xbmc/xbmc/pull/8543</ref>
* Added support for 'Edit timer' & 'Delete timer' rules to context menu in the EPG & Search windows<ref>http://github.com/xbmc/xbmc/pull/8713</ref><ref>http://github.com/xbmc/xbmc/pull/9370</ref>
* Added support to allow timer creation for EPG in recent past in the EPG window<ref>http://github.com/xbmc/xbmc/pull/8447</ref>
* Added support to use timer logos depending on its state in the EPG window<ref>http://github.com/xbmc/xbmc/pull/9012</ref><ref>http://github.com/xbmc/xbmc/pull/9636</ref><ref>http://github.com/xbmc/xbmc/pull/9657</ref>
* Make instant recording behavior configurable (fixed-time vs. current show vs. interactive)<ref>http://github.com/xbmc/xbmc/pull/9847</ref>
* Added "ShowTimerRule" builtin to allow key mapping for "add timer" dialog pre-filled for epg-based timer rule<ref>http://github.com/xbmc/xbmc/pull/9370</ref>
* Added support for JSON-RPC API sync PVR types fields with current implementation<ref>http://github.com/xbmc/xbmc/pull/10074</ref>
* Improveed playback of live streams as PVR Live TV streams can now be identified as "live"
* Improved Kodi's Eventlog with extentions to PVR events for 'create/delete timers, timer rules', 'start/stop recordings'<ref>http://github.com/xbmc/xbmc/pull/8374</ref>
* Improved PVR Guide window performance, especially on first open<ref>http://github.com/xbmc/xbmc/pull/9370</ref><ref>http://github.com/xbmc/xbmc/pull/9453</ref>
* Changes to have separate windows for 'Timer Rules' from 'Timers'<ref>http://github.com/xbmc/xbmc/pull/8561</ref>
* Changes to separate TV and Radio recordings in the Recordings window<ref>http://github.com/xbmc/xbmc/pull/9319</ref>
* Changes to make 'group items' setting be persistent in the Recordings window<ref>http://github.com/xbmc/xbmc/pull/10101</ref>
* Recordings window now respects "default select action" settings value<ref>http://github.com/xbmc/xbmc/pull/10333</ref>
* Added 'recent recordings' widget (core support and Estuary PVR home screen)<ref>http://github.com/xbmc/xbmc/pull/10438</ref>
* Added vertical scrollbar to Guide window to allow channel navigation using the mouse (core support and Estuary change)<ref>http://github.com/xbmc/xbmc/pull/10450</ref>
* Added, updated, and improved PVR backend clients addons for all popular third-party external [[PVR backend]] platforms:
** [[Add-on:PVR Demo Client|PVR Demo Client]] dummy addon with fake (method stub) [[PVR backend]] for [[PVR]] skinning and regression testing
** [[Add-on:IPTV Simple Client|IPTV Simple Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:HDHomeRun PVR|HDHomeRun]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VU+ / Enigma2 Client|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Njoy N7 PVR Client|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:VDR VNSI Client|VDR VNSI Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MythTV PVR Client|MythTV PVR Client]] Addon backend client maintained and available from the Kodi's community
** [[Add-on:NextPVR PVR Client|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:Argus TV Client|Argus TV (former ForTheRecord)]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBLink PVR Client|DVBLink PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:DVBViewer Client|DVBViewer Client]] PVR Addon backend client maintained and available from Kodi's community
** [[Add-on:MediaPortal PVR Client|MediaPortal PVR Client]] Addon backend client maintained and available from Kodi's community
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community

=== Add-ons Framework, API, and Manager ===
For full changelogs of all Addons APIs, see [[Krypton API changes]], [http://forum.kodi.tv/forumdisplay.php?fid=174 JSON-RPC], and [http://forum.kodi.tv/forumdisplay.php?fid=26 Add-ons] Development Forums
* Added a new API level system to binary addons, refactoring the binary addon library interface for Kodi<ref>http://github.com/xbmc/xbmc/pull/9659</ref>
* Added a new input system with an API for keyboard and game controllers as "Peripheral Addons"<ref name="Controller input system">PR #8807 Controller input system http://github.com/xbmc/xbmc/pull/8807</ref>
* Added API support for "Peripheral Addons" for updatable configuration of input devices<ref name="Controller input system"/>
* Added support for game controller to system addons<ref>http://github.com/xbmc/xbmc/pull/9374</ref>
* Added a user-mappable Joystick (Peripheral) Addon for joysticks and gamepad abstraction APIs<ref>http://github.com/kodi-game/peripheral.joystick</ref><ref name="Controller input system"/><ref>http://github.com/xbmc/xbmc/pull/9376</ref>
* Added support for "InputStream" binary addon extension point that can serve as input stream for VideoPlayer<ref>http://github.com/xbmc/xbmc/pull/9173</ref><ref>http://github.com/xbmc/xbmc/pull/9162</ref>
* Added support for inputstream (input stream) to system addons<ref>http://github.com/xbmc/xbmc/pull/9373</ref>
* Added support for method to get our useragent string<ref>http://github.com/xbmc/xbmc/pull/8643</ref>
* Added support for Addons to include screenshots to be visible in Kodi's Addons Manager
* Added support for skins to display 'recently installed' or 'recently updated' addon list in Addon Manager<ref name="Recently installed or update">Recently installed or update http://kodi.tv/kodi-v17-krypton-alpha-2/</ref>
* Added setting for enabling/disabling ZIP installation of addons from unknown sources (disbaled by default)<ref name="Unknown sources">Unknown sources... http://kodi.tv/kodi-v17-krypton-alpha-2/</ref><ref>http://github.com/xbmc/xbmc/pull/8857</ref>
* Added a lot of Doxygen related Addons documentation regarding builtin commands to Documentation<ref>http://github.com/xbmc/xbmc/pull/9433</ref>

=== GUI Engine (Skinning Engine) ===
For full changelog on changes to the skinning engine, see [[Krypton API changes]] and the [http://forum.kodi.tv/showthread.php?tid=250862 Skin Development Forum]
* Added a new default skin called Estuary, with themes & colors, (moving Confluence to addon repo)<ref name="brand new look">A brand new look for future Kodi versions http://kodi.tv/a-brand-new-look-for-future-kodi-versions/</ref><ref>http://github.com/xbmc/xbmc/pull/9235</ref>
* Added a new default touch-screen enabled skin called Estouchy (moving Re-Touched to addon repo)<ref name="brand new look"/><ref>http://github.com/xbmc/xbmc/pull/9222</ref>
* Added a new Color Manager to handle loading of madVR 3D LUT ICC profiles for color correction<ref>http://github.com/xbmc/xbmc/pull/9731</ref>
* Added a new FFmpeg based image loader to guilib for loading pictures<ref>http://github.com/xbmc/xbmc/pull/8370</ref>
* Added a new FFmpeg based image thumbnails implementation<ref>http://github.com/xbmc/xbmc/pull/8583</ref>
* Added experimental limited support to guilib for animated APNG images in skin textures and backgrounds/posters<ref>http://github.com/xbmc/xbmc/pull/8937</ref>
* Added experimental limited support to guilib for animated GIF images in skin textures and backgrounds/posters<ref>http://github.com/xbmc/xbmc/pull/8937</ref>
* Added support for [[EDL|commercial skipping]] notifications and toggle action<ref>http://github.com/xbmc/xbmc/pull/9399</ref>
* Added support for defaultcontrol to grouplists to allow skins to define defaults<ref>http://github.com/xbmc/xbmc/pull/8501</ref>
* Added support for 'InstallAddon' builtin to allow skins to install addons on demand<ref>http://github.com/xbmc/xbmc/pull/8419</ref>
* Added Skin.SelectBool builtin support for skinning<ref>http://github.com/xbmc/xbmc/pull/8303</ref>
* Added support for multi-touch to display adjustment for touch panel calibration<ref>http://github.com/xbmc/xbmc/pull/9160</ref>
* Improved skinning PVR section by unifying and/or seperating different PVR related windows
* Update guilib ABI (for libgui) to version 5.11.0<ref>http://github.com/xbmc/xbmc/pull/8948</ref>
* Updated keyboard layout for some languages and added a new keyboard layout for French AZERTY
* Changed context menus by refactoring to a global item based system to unify them<ref>http://github.com/xbmc/xbmc/pull/9257</ref>
* Changed GetThumbSize() to m_imageResso so bookmark/chapter images are same resolution as posters
* Changed background loading of thumbnails so that it is enabled by default
* Changed default icons with updated versions

=== Platform Independent Playback ===
* Major refactoring of Kodi's built-in video player core (which will also be renamed from "[[DVDPlayer]]" to "VideoPlayer")<ref name="First wave of changes">Video Player - First wave of changes http://kodi.tv/kodi-v17-krypton-alpha-2/</ref><ref name="VideoPlayer Development">VideoPlayer Development Forum (developers only) http://forum.kodi.tv/forumdisplay.php?fid=240</ref><ref name="VideoPlayer refactoring">PR #8486 VideoPlayer refactoring initial pull request http://github.com/xbmc/xbmc/pull/8486</ref>
* Added support for 3D LUT (3D Lookup Table) & simple ICC profile linking support for color correction<ref>http://github.com/xbmc/xbmc/pull/9731</ref>
* Added video stream selection to audio/subtitle dialogue to choose between multiple videos<ref name="VideoPlayer Development"/><ref name="VideoPlayer refactoring"/>
* Added support for dithering for OpenGL rendering (part of VideoPlayer refactoring)<ref name="VideoPlayer Development"/><ref name="VideoPlayer refactoring"/>
* Added support for gapless playback on stream change (with the new VideoPlayer)<ref>http://github.com/xbmc/xbmc/pull/8886</ref>
* Added method for requesting desired video resolution to demuxer to new VideoPlayer<ref>http://github.com/xbmc/xbmc/pull/9531</ref>
* Added multi-stream input demuxer to support a video stream with external audio tracks/streams<ref name="First wave of changes"/><ref>http://github.com/xbmc/xbmc/pull/9286</ref>
* Added support to change playback speed with audio enabled between 0.8 to 1.5 of normal speed with 'tempo' controls<ref>http://github.com/xbmc/xbmc/pull/10216</ref><ref>http://github.com/xbmc/xbmc/pull/10164</ref>
* Added support for external PGS/.sup (Blu-ray Disc) subtitles<ref>http://github.com/xbmc/xbmc/pull/9559</ref>
* Added support for hardware video acceleration of DVD-Video (with the new VideoPlayer)<ref name="First wave of changes"/>
* Changed video renderers to separate graphics rendering from main thread (part of VideoPlayer refactoring)<ref name="VideoPlayer Development"/>
* Improved A/V sync during video playback which reduce time required for audio sync (part of VideoPlayer refactoring)<ref name="VideoPlayer Development"/><ref name="VideoPlayer refactoring"/>
* Improved switching refresh rates during video playback (part of VideoPlayer refactoring)<ref name="First wave of changes"/><ref name="VideoPlayer Development"/><ref name="VideoPlayer refactoring"/>
* Improved audio pass-through support during video playback (part of VideoPlayer refactoring)<ref name="VideoPlayer Development"/><ref name="VideoPlayer refactoring"/>
* Improved MMAL playback of H.264 MVC (Blu-ray 3D) stereoscopic video with framepacking decoding on Raspberry Pi
* Improved Stereoscopic 3D playback of 3D videos (as well as better 2D playback of 3D videos)
* Improved and enhanced Blu-ray support (including updated libbluray dependecies from the VideoLAN project<ref>http://git.videolan.org/?p=libbluray.git;a=blob;f=ChangeLog</ref>)<ref>http://github.com/xbmc/xbmc/pull/10056</ref>
* Upgraded FFmpeg multimedia codec and demux libraries to stable branch release version [http://www.ffmpeg.org/download.html#release_3.1.2 FFmpeg 3.1.2]<ref>http://git.videolan.org/?p=ffmpeg.git;a=blob_plain;f=Changelog;hb=release/3.1.2 FFmpeg 3.1.2 release changelog</ref><ref>http://github.com/xbmc/xbmc/pull/10262</ref>
* Removed certain audio codecs from core and made them into audio decoder and audio encoder add-ons

=== Library ===
* Added support for scraping, storing, and displaying multiple ratings from different sources<ref>http://github.com/xbmc/xbmc/pull/8080</ref>
* Added support for user rating to the OSD (On Screen Display) for music playback<ref>http://github.com/xbmc/xbmc/pull/9094</ref>
* Added support for rating and votes label for specific rating<ref>http://github.com/xbmc/xbmc/pull/8788</ref>
* Added support to filtering by userrating in the mediafilter dialog<ref>http://github.com/xbmc/xbmc/pull/8553</ref>
* Added artist roles tag to the music library to handle tags for ex. Composer, Conductor, DJMixer, etc.<ref>http://github.com/xbmc/xbmc/pull/8015</ref>
* Added support for MOOD tag scanning for FLAC, Ogg, Xiph, Vorbis, ASF and MP4 audio files to music library<ref>http://github.com/xbmc/xbmc/pull/8905</ref>
* Added support for showning "in progress tv shows" in the filesystem-tree<ref>http://github.com/xbmc/xbmc/pull/8261</ref>
* Added support Audio and Subtitle Track Count to Smart Playlist selections filtering<ref>http://github.com/xbmc/xbmc/pull/8333</ref>
* Added support to sort actors by number of movies they are in<ref>http://github.com/xbmc/xbmc/pull/8576</ref>
* Added support to sort discography ascending by years
* Added support for a method to retrieve video tags<ref>http://github.com/xbmc/xbmc/pull/7369</ref>
* Improved performance for tag scanning and browsing speed in the Music library
* Improved database performance for addons accessing library

=== Web Scrapers ===
* Refactor and updated scrapers in Kodi for music, movies, tv shows, and music videos

=== AudioEngine ===
* Added initial support for [[Audio DSP]] (Digital Signal Processing) plugins and addons for Kodi's [[AudioEngine]][http://forum.kodi.tv/forumdisplay.php?fid=235]
* Improved the default cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] (Kodi's [[AudioEngine]])
* Improved ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems
* Improved PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop
* Improved OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD and similar BSD Unix based systems
* Improved AUDIOTRACK sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Amlogic]]
* Improved Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]
* Improved DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows
* Improved CoreAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS
* Improved Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS

=== Other ===
* Added support for game controller haptics (rumble motors) when the user receives a notification<ref>http://github.com/xbmc/xbmc/pull/9663</ref>
* Added support for AppVeyor CI (CI for Windows) build server for regression testing of Kodi and binary addons<ref>http://github.com/xbmc/xbmc/pull/9258</ref>
* Added support building binary addons to Travis build server for regression testing of Kodi<ref>http://github.com/xbmc/xbmc/pull/9103</ref>
* Added support for auto creating code documentation with Doxygen including To-Do list ([https://codedocs.xyz/xbmc/xbmc/ https://codedocs.xyz/xbmc/xbmc/] )
* Added documentation for skinning API to Doxygen, and moved PyDocs of Kodi API to Doxygen
* Added support for IPv6 via cURL
* Improved code stability, performance. and security, as well as general code clean-up in many core areas
* Improved render capture which is used by [[Ambilight]] implementations (such as example [[Add-on:Kodi Boblight|Boblight]])
* Improved the the integrated UPnP / DNLA Media Server and Client<ref>http://github.com/xbmc/xbmc/pull/8045</ref><ref>http://github.com/xbmc/xbmc/pull/8051</ref>
* Improved AirPlay compatibility support for iOS 8 (via updated libshairplay)<ref>http://github.com/xbmc/xbmc/pull/8180</ref>
* Improved Kodi's JSON-RPC API
* Improved the the integrated web server (used for remote control web interface and more)
* Improved [[CEC|HDMI CEC (Consumer Electronics Control)]] support for [http://libcec.pulse-eight.com/ Pulse-Eight's LibCEC]
* Improved "long-press" support functionality of a single button on a remote control
* Updated community maintained translations to over 60+ languages to date for Kodi via [[Translation System|Transifex Translation System]]
* Updated critical dependency libraries such as sqlite, openssl, gnutls, and CMake (used to compile binary addons)
* Removed support for RAW image decoding (with removal of CxImage as FFmpeg do not support RAW<ref>http://github.com/xbmc/xbmc/pull/8662</ref><ref>http://github.com/xbmc/xbmc/pull/8583</ref>)
* Removed CxImage, Libgif, and JpegIO (C/C++ libraries) as dependencies in favor of FFmpeg image decoding<ref>http://github.com/xbmc/xbmc/pull/8662</ref><ref>http://github.com/xbmc/xbmc/pull/8583</ref><ref>http://github.com/xbmc/xbmc/pull/9055</ref>
* Removed all Boost (C++ libraries) and libsquish as dependencies<ref>http://github.com/xbmc/xbmc/pull/9021</ref><ref>http://github.com/xbmc/xbmc/pull/9092</ref>

=== Android Specific ===
* Moved to Android API 21 and SDK 21 with NDK 10 as minimum, meaning at least Android 5.0 is now required<ref>http://github.com/xbmc/xbmc/pull/9688</ref><ref>http://github.com/xbmc/xbmc/pull/9517</ref><ref>http://github.com/xbmc/xbmc/pull/9528</ref>
* Added support for audio pass-through for DTS-HD, DTS-X, Dolby TrueHD, and Dolby ATMOS
* Improved MediaCodec API video decoding implementations support for Android 5.0 (API level 21) and later
* Improved automatic refresh rate switching support for video playback on Android 5.0 & later (>= API 21), inc. Android TV
* Improved support for UltraHD decoding / 4K resolution output when HW supports it
* Improved playback of HEVC, VC-1 / WMV 9, and VP9 hardware video decoding when using Android's MediaCodec API
* Removed AMLCodec hardware accelerated video decoding support for Android on Amlogic devices<ref>http://github.com/xbmc/xbmc/pull/9688</ref>

=== BSD Specific ===
* Improved Kodi support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)

=== Linux Specific ===
* Added new CMake based build system of Kodi and binary addons for Linux (as well as for OSX and Windows<ref>http://github.com/xbmc/xbmc/pull/9083</ref>
* Added support for HEVC Main 10 profile (10-bit) hardware video decoding via VAAPI if hardware support it
* Added support for VP9 hardware video acceleration via VAAPI if supported by display drivers<ref>http://github.com/xbmc/xbmc/pull/8624</ref>
* Added support for EGL for X11 (which adds zero copy rendering for VAAPI)<ref name="VideoPlayer Development"/><ref name="VideoPlayer refactoring"/>
* Added support for zero copy interface to FFmpeg for MMAL renderer on Raspberry Pi<ref>http://github.com/xbmc/xbmc/pull/9384</ref>
* Added support for Clang compiler building of Kodi
* Added support for generating Debian packages with Kodi's shiny new CMake/CPack system<ref>http://github.com/xbmc/xbmc/pull/9987</ref>
* Improved multi-touch support, and improved touch and gesture support on Linux
* Improved support for UltraHD decoding / 4K resolution output when hardware supports it
* Improved OpenGL ES and EGL support (using [[Raspberry Pi]] as reference devices)
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)
* Improved XvBA (AMD/ATI) Hardware Video Acceleration (requires XvBA compatible hardware and drivers)
* Improved OpenMAX Video Acceleration API support for Linux (using Raspberry Pi as reference hardware)
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on [[Amlogic]] devices
* Improved AMD/Intel x86-64 64-bit (AMD64 / IA-64t CPU architectures) support under Linux
* Removed Wayland display server protocol support (as depended heavily on removed Boost C++ libraries)<ref>http://github.com/xbmc/xbmc/pull/8980</ref>

=== iOS Specific ===
* Added support for TVOS (Apple's iOS fork for Apple TV 4) to Kodi mainline
* Added support to build iOS for ARM64 (64-bit iOS)
* Improved Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)
* Improved touch and gesture support for iOS based iDevice platforms (iPad, iPod, and iPhone)

=== OS X Specific ===
* Added new CMake based build system of Kodi and binary addons for OSX (as well as for Linux and Windows<ref>http://github.com/xbmc/xbmc/pull/9083</ref>
* Added “Copy to Kodi” functionality on iOS (for “Open In” Kodi feature in iOS)
* Improved Apple VDADecoder Video Acceleration support for (Mac) OS X

=== Windows Specific ===
* Added new CMake based build system of Kodi and binary addons for Windows (as well as for Linux and OSX)<ref>http://github.com/xbmc/xbmc/pull/9083</ref>
* Added support for HEVC Main 10 profile (10-bit) hardware video decoding via DXVA on Windows if drivers support it
* Added support for 10 to 16 bit video output through the DXVA renderer
* Improved rendering system for DirectX 11 and Direct3D 11 native support on Microsoft Windows
* Improved DXVA/DXVA2 (DirectX Video Acceleration) support (requires DXVA/DXVA2 compatible hardware & drivers)
* Changed all external libraries to be built with Microsoft Visual Studio 2015
* Removed unneeded DXVA to D3D11VA wrapper as we now build FFmpeg with D3D11VA support and use it directly<ref>http://github.com/xbmc/xbmc/pull/9198</ref>

== References ==
<references/>

== See also ==
* [[Krypton API changes]]
{{Changelogs}}

[[Category:Manual]]
[[Category:Krypton|*]]
[[Category:Changelogs|17]]

Archive:Kodi v17 (Krypton) changelog

2016-07-30T09:19:47Z

Ksooo: /* Live TV and PVR (Personal Video Recorder) */

Archive:Kodi v17 (Krypton) changelog

2016-07-30T09:17:31Z

Ksooo: /* Live TV and PVR (Personal Video Recorder) */

Archive:Kodi v17 (Krypton) changelog

2016-07-30T08:58:55Z

Ksooo: /* Live TV and PVR (Personal Video Recorder) */

Archive:Development advisors

2015-10-11T10:16:25Z

Ksooo:

{| class="wikitable sortable"
|-
! Component !! Dev(s) who can sign off on that area
|-
| Android specific feature || Koying,davilla,theuni
|-
| Audio playback (audio/video files) || fritsch, FernetMenta,
|-
| BSD Specific feature || Fneufneu
|-
| Blu-ray menu navigation or playback || elupus, ace20022
|-
| Build System || Althekiller, memphiz, spiff, wsnipex
|-
| DVD-Video menu navigation and playback || Voyager, elupus
|-
| Database / Library for Music || JMarshall, night199-uk, Montellese
|-
| Database / Library for Videos (Movies and TV-Shows) || JMarshall, Montellese
|-
| Graphical User Interface (GUI) || JMarshall,pieh
|-
| Installer / Initial Setup Guide (Wizards) || spiff
|-
| Karaoke || oldnemesis
|-
| General control input system || jhsrennie , spiff, davilla, koying, montellese , garbear, jm
|-
| Linux Distribution (Operating-System) || wsnipex ,lcapriotti
|-
| Linux specific features || wsnipex ,althekiller, spiff, topfs2
|-
| Mac OS X specific feature || davilla , memphiz
|-
| PVR (Personal Video Recorder) || opdenkamp, Jalle19, ksooo, xhaggi
|-
| Pictures Viewing / Slideshow Display || ulion
|-
| Playlists (Audio or Video) || Montellese
|-
| Python Code and/or Scripts || jfcarroll
|-
| VFS || spiff, ulion,
|-
| Scraper (Music/Video Metadata collector) || olympia , scudlee, mathias
|-
| Skin / Theme (Navigation, Look and Feel) || ronie, jmarshall, jezz_x
|-
| Subtitles || elupus , ace20022, voyager
|-
| Thumbnails / Covers / Posters / FanArt || jmarshall
|-
| Translation / Language files / Internationalization || alanwww1 , blittan
|-
| UPnP/DNLA || alcoheca , elupus, Montellese
|-
| Video playback (inc. audio in video and codecs) || elupus , abalier, fernetmenta, davilla, koying, popcornmix, gimli
|-
| Weather forecasts || ronie
|-
| Web Server / Web Interface / Web API / JSON-RPC || Montellese , topfs2
|-
| Windows (Win32) Distribution / Installer || WiSo , Martijn
|-
| Windows specific feature || WiSo , Karlson2k, ace20022
|-
| iOS Specific feature || Memphiz
|-
| rpi || popcornmix, gimli
|-
| addon system (installing/interface/handling) || spiff, opdenkamp, jm
|-
| retroplayer || garbear
|-
| General code reviewing (coding quality, unspecific) || Althekiller, jm, elupus, montellese
|-
| Settings system || Montellese, althekiller
|}

[[Category:Development]]
[[Category:DevCon 2013 ideas]]