Difference between revisions of "Script sources"

From Official Kodi Wiki
Jump to navigation Jump to search
m (Bot: Automated text replacement (-class="wikitable" +class="prettytable" & -Available Tags +Available tags & -<source +<syntaxhighlight & -</source> +</syntaxhighlight>))
m
 
(10 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{mininav|[[Development]]|[[Add-on development]]|[[Python development]]}}
{{mininav|[[Development]]|[[Add-on development]]|[[About Add-ons]]}}
==What XBMC requires for your add-on==
==What Kodi requires for your add-on==
For XBMC to know what to do with your addon, we require your script, and an addon.xml file. See [[Add-ons for XBMC (Developement)|add-ons for XBMC]] for more information on addon.xml, including how you add descriptions to your addon for users. A plugin source extends XBMC via the xbmc.python.script extension point. The layout of the XML describing this extension point is as follows:
<section begin="intro" />For Kodi to know what to do with your addon, we require your script, and an addon.xml file. The layout of the XML describing this extension point is as follows:<section end="intro" />


<syntaxhighlight lang="xml">
See [[Add-on development|add-ons for Kodi]] for more information on addon.xml, including how you add descriptions to your addon for users. A script extends Kodi via the xbmc.python.script extension point.
 
<syntaxhighlight lang="xml" enclose="div">
   <extension point="xbmc.python.script"
   <extension point="xbmc.python.script"
             library="default.py" />
             library="default.py" />
Line 12: Line 14:
   "xbmc.python.script"          This is the standard Script extension point
   "xbmc.python.script"          This is the standard Script extension point


below listed extensions will not appear in the Scripts/Programs window and can only be run via skin shortcuts
below listed extensions will not appear in the Addons/Programs window and can only be run via skin shortcuts


   "xbmc.python.weather"        Used for weather scripts
   "xbmc.python.weather"        Used for weather scripts
Line 21: Line 23:


Example of "xbmc.python.script":
Example of "xbmc.python.script":
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml" enclose="div">
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<addon id="script.rss.editor"
<addon id="script.globalsearch" name="Global Search" version="9.0.5" provider-name="ronie">
      name="RSS Editor"
<requires>
      version="1.5.6"
<import addon="xbmc.python" version="3.0.0"/>
      provider-name="rwparris2">
</requires>
  <requires>
<extension point="xbmc.python.script" library="default.py"/>
    <import addon="xbmc.python" version="1.0"/>
<extension point="xbmc.addon.metadata">
  </requires>
<summary lang="en_GB">Search your library.</summary>
  <extension point="xbmc.python.script"
<description lang="en_GB">This addon can find any item in your video and music library.</description>
            library="default.py" />
<platform>all</platform>
  <extension point="xbmc.addon.metadata">
<license>GPL-2.0-only</license>
    <platform>all</platform>
<forum>https://forum.kodi.tv/showthread.php?tid=109301</forum>
    <minversion>28764</minversion>
<source>https://gitlab.com/ronie/script.globalsearch/</source>
    <summary lang="en">A Script for editing XBMC's built in RSS Ticker</summary>
<assets>
    <description lang="en">A Script for editing XBMC's built in RSS Ticker</description>
<icon>resources/icon.png</icon>
  </extension>
<fanart>resources/fanart.jpg</fanart>
</assets>
<news>- add support for searching musicvideos by artist name</news>
</extension>
</addon>
</addon>
</syntaxhighlight>
</syntaxhighlight>


== Interacting with XBMC ==
== Interacting with Kodi ==
Given that your script can return information to the user, you may wish to allow some (or all) of the information you provide to be translatable. You do this by providing a strings.xml file (in resources/language/<name_of_language>/strings.xml) which associates integer id's with each label. XBMC then handles loading these string files and ensuring that the users' locale information is taken into account. To display strings you use the '''getString''' function in the [[xbmcaddon module]].
Given that your script can return information to the user, you may wish to allow some (or all) of the information you provide to be translatable. You do this by providing a strings.po file (in resources/language/<name_of_language>/strings.po) which associates integer id's with each label. Kodi then handles loading these string files and ensuring that the users' locale information is taken into account. To display strings you use the '''getString''' function in the Xbmcaddon_module.




== See also ==
== See also ==
* [[Add-ons]]
* [[Add-ons]]
* [[:Category:All add-ons]]
* [[Unofficial add-on repositories]]
* [[3rd party add-on repositories]]
'''Development:'''
'''Development:'''
* [[Add-on development]]
* [[Add-on development]]
* [[Addon Settings]]
* [[Add-on_settings]]
* [[Python development]]
* [[Add-on repositories]]
* [[Add-on repositories]]
* [[Official add-on repository]]
* [[Official add-on repository]]


[[Category:Python Tutorial]]
 
[[Category:Python]]
[[Category:Python]]
[[Category:Settings]]
[[Category:Add-on development]]
[[Category:How-to]]
[[Category:Add-ons]]
[[Category:Addon Development]]
[[Category:Development]]

Latest revision as of 23:14, 29 January 2021

Home icon grey.png   ▶ Development ▶ Add-on development ▶ About Add-ons ▶ Script sources

1 What Kodi requires for your add-on

For Kodi to know what to do with your addon, we require your script, and an addon.xml file. The layout of the XML describing this extension point is as follows:

See add-ons for Kodi for more information on addon.xml, including how you add descriptions to your addon for users. A script extends Kodi via the xbmc.python.script extension point.

<extension point="xbmc.python.script"
             library="default.py" />

list of extension points and their explanation:

  "xbmc.python.script"          This is the standard Script extension point

below listed extensions will not appear in the Addons/Programs window and can only be run via skin shortcuts

  "xbmc.python.weather"        Used for weather scripts
  "xbmc.python.subtitles"      Used for subtitle scripts
  "xbmc.python.lyrics"         Used for lyrics scripts
  "xbmc.python.library"        Used for skin dependent scripts (e.g. recently added script)


Example of "xbmc.python.script":

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<addon id="script.globalsearch" name="Global Search" version="9.0.5" provider-name="ronie">
	<requires>
		<import addon="xbmc.python" version="3.0.0"/>
	</requires>
	<extension point="xbmc.python.script" library="default.py"/>
	<extension point="xbmc.addon.metadata">
		<summary lang="en_GB">Search your library.</summary>
		<description lang="en_GB">This addon can find any item in your video and music library.</description>
		<platform>all</platform>
		<license>GPL-2.0-only</license>
		<forum>https://forum.kodi.tv/showthread.php?tid=109301</forum>
		<source>https://gitlab.com/ronie/script.globalsearch/</source>
		<assets>
			<icon>resources/icon.png</icon>
			<fanart>resources/fanart.jpg</fanart>
		</assets>
		<news>- add support for searching musicvideos by artist name</news>
	</extension>
</addon>

2 Interacting with Kodi

Given that your script can return information to the user, you may wish to allow some (or all) of the information you provide to be translatable. You do this by providing a strings.po file (in resources/language/<name_of_language>/strings.po) which associates integer id's with each label. Kodi then handles loading these string files and ensuring that the users' locale information is taken into account. To display strings you use the getString function in the Xbmcaddon_module.


3 See also

Development: