This is an old revision of the document!
Executing a script from a Kodi plugin add-on
As explained into the article How to write a Kodi Addon it is possible to create script add-ons or plugin add-ons using Python (starting with Kodi 19 Matrix it is possible tu use the embedded Python 3). A plugin add-on is simply a container of media elements generally organized as a directory, without specific playing capabilities. The play of a content is generally delegated to the native Kodi players (video, audio or pictures).
If you want, it is possibile to customize the action associated to a ListItem (a media element shown into the plugin directory), overriding the default player. It is possible to launch a generic external Python program or run a Kodi script add-on.
Executing an external Python program
This statement executes a Python script (it must be Python) that resides on the filesystem. The special://home prefix actually refers to the home directory of the Kodi program. In my case it means the /home/kodi/.kodi/ directory.
xbmc.executescript('special://home/bin/my-script.py')
The following example adds a context menu item to a ListItem contained into a plugin directory. Selecting that menu item will will launch the script passing it an argument. Also in this case the script must be a Python script:
li = xbmcgui.ListItem(label='Item title') li.addContextMenuItems([('Run myScript', 'RunScript(special://home/bin/my-script.py,arg1)')])