Add-on settings conversion: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Created page with "=Converting addon settings= ==type="text"== <syntaxhighlight lang="xml" enclose="div"> <setting type="text" id="test01" label="32001" default=""/> </syntaxhighlight> {{hidden...")
 
No edit summary
Line 1: Line 1:
=Converting addon settings=
=Converting addon settings=
==Preface==
As of Kodi 18 Leia it is possible to write your addon settings in the same setting format as Kodi uses.
Due to many initial issues, it is not recommended to convert your settings if your addon is in the Leia addon repo.
In Kodi 19 Matrix, those bugs have been fixed, so we recommend to convert your addon setting if you plan to submit your addon to the Matrix addon repo (or higher).
==Structure==
The structure of your settings.xml file should look like this
<syntaxhighlight lang="xml" enclose="div">
<?xml version="1.0" ?>
<settings version="1">
<section id="addon">
<category id="1" label="" help="">
<group id="1" label="">
<setting id="" type="" label="" help="">
<control type="" format=""/>
</setting>
</group>
</category>
</section>
</settings>
</syntaxhighlight>
- your addon settings file can only have one '''<section>''' tag. (the use of multiple sections is reserved for kodi's main settings.xml file)
- you can use multiple '''<category>''' tags, just like in the old addon settings format.
- the '''<group>''' tag is a replacement for the old '''sep''' and '''lsep''' types, you can define multiple groups in order to group a number of settings.
=Setting types=


==type="text"==
==type="text"==

Revision as of 01:21, 14 December 2019

Converting addon settings

Preface

As of Kodi 18 Leia it is possible to write your addon settings in the same setting format as Kodi uses. Due to many initial issues, it is not recommended to convert your settings if your addon is in the Leia addon repo.

In Kodi 19 Matrix, those bugs have been fixed, so we recommend to convert your addon setting if you plan to submit your addon to the Matrix addon repo (or higher).

Structure

The structure of your settings.xml file should look like this

<?xml version="1.0" ?>
<settings version="1">
	<section id="addon">
		<category id="1" label="" help="">
			<group id="1" label="">
				<setting id="" type="" label="" help="">
					<control type="" format=""/>
				</setting>
			</group>
		</category>
	</section>
</settings>

- your addon settings file can only have one <section> tag. (the use of multiple sections is reserved for kodi's main settings.xml file) - you can use multiple <category> tags, just like in the old addon settings format. - the <group> tag is a replacement for the old sep and lsep types, you can define multiple groups in order to group a number of settings.

Setting types

type="text"

<setting type="text" id="test01" label="32001" default=""/>


<setting type="text" id="test02" label="32002" default="" option="hidden"/>


<setting type="text" id="test03" label="32003" default="" option="urlencoded"/>


type="ipaddress"

<setting type="ipaddress" id="test04" label="32004"/>


type="number"

<setting type="number" id="test05" label="32005"/>


type="date"

<setting type="date" id="test06" label="32006" default="2015-03-12"/>


type="time"

<setting type="time" id="test07" label="32007" default="13:13"/>


type="bool"

<setting type="bool" id="test08" label="32008" default="false"/>


type="select"

<setting type="select" id="test09" label="32009" lvalues="11|12|13|14"/>


type="select"

<setting type="select" id="test10" label="32010" values="aa|bb|cc|dd"/>


type="addon"

<setting type="addon" id="test11" label="32011" default="" addontype="xbmc.metadata.scraper.movies"/>


<setting type="addon" id="test12" label="32012" default="" addontype="xbmc.metadata.scraper.movies" multiselect="true"/>


type="enum"

<setting type="enum" id="test13" label="32013" lvalues="11|12|13|14"/>


<setting type="enum" id="test14" label="32014" values="aa|bb|cc|dd"/>


type="labelenum"

<setting type="labelenum" id="test15" label="32015" lvalues="11|12|13|14"/>


<setting type="labelenum" id="test16" label="32016" values="bb|aa|dd|cc" sort="yes"/>


type="slider"

<setting type="slider" id="test17" label="32017" default="20" range="5,5,100" option="int"/>


<setting type="slider" id="test18" label="32018" default="0.5" range="0.0,0.1,1.0" option="float"/>


<setting type="slider" id="test19" label="32019" default="20" range="0,1,100" option="percent"/>


type="file"

<setting type="file" id="test20" label="32020" default=""/>


type="audio"

<setting type="audio" id="test21" label="32021" default=""/>


type="video"

<setting type="video" id="test22" label="32022" default=""/>


type="image"

<setting type="image" id="test23" label="32023" default=""/>


type="executable"

<setting type="executable" id="test24" label="32024" default=""/>


type="folder"

<setting type="folder" id="test25" label="32025" default=""/>


<setting type="folder" id="test26" label="32026" default="" option="writeable"/>


<setting type="folder" id="test27" label="32027" default="" source="videos"/>


<setting type="folder" id="test28" label="32028" default="" source="music"/>


<setting type="folder" id="test29" label="32029" default="" source="pictures"/>


<setting type="folder" id="test30" label="32030" default="" source="programs"/>


<setting type="folder" id="test31" label="32031" default="" source="files"/>


<setting type="folder" id="test32" label="32032" default="" source="local"/>


type="action"

<setting type="action" id="test33" label="32033" action="RunScript(script.globalsearch)"/>


<setting type="action" id="test34" label="32034" action="RunScript(script.globalsearch)" option="close"/>


type="fileenum"

<setting type="fileenum" id="test35" label="32035" values="resources"/>


<setting type="fileenum" id="test36" label="32036" values="resources" mask="/"/>


<setting type="fileenum" id="test37" label="32037" values="resources" mask="*.txt"/>