JSON-RPC API/v12

From Official Kodi Wiki
Jump to navigation Jump to search
JSON-RPC Pages
Main JSON-RPC Page
- v8 (Krypton)
- v10 (Leia)
- v12 (Matrix)
- v13 (Nexus)
- v14 (Omega)
Examples
All JSON-RPC Pages
Home icon grey.png   ▶ Development ▶ JSON-RPC API ▶ v12

Version 12 is the stable version of Kodi's JSON-RPC API and is published with the release of v19 (Matrix). This document has been updated to version 12.3.0. Recent changes are announced on the forum

It comes with support for WebSockets as an alternative transport for third party clients. Using WebSockets will allow webinterfaces (which are currently restricted to the HTTP transport only) to get access to a bidirectional transport with Kodi's JSON-RPC API and can therefore also profit from additional features like notifications.


JSON-RPC 2.0 compatibility

Version Method calls Notifications
(server-side)
Notifications
(client-side)
Parameters
by-name
Parameters
by-position
Batch requests
Version 6 Yes Yes Yes Yes Yes Yes

Documentation (JSON Schema)

Supported features of JSON Schema

Schema IETF Draft 03
type Yes
properties Yes
patternProperties No
additionalProperties Yes
items Yes
additionalItems Yes
required Yes
dependencies No
minimum Yes
maximum Yes
Schema IETF Draft 03
exclusiveMinimum Yes
exclusiveMaximum Yes
minItems Yes
maxItems Yes
uniqueItems Yes
pattern No
minLength Yes
maxLength Yes
enum Yes
default Yes
Schema IETF Draft 03
title No
description Yes
format No
divisibleBy Yes
disallow No
extends Yes
id Yes
$ref Yes
$schema No
Hyper Schema No

Error message

If Kodi detects a bad or missing parameter in a JSON-RPC request it returns an error object. The JSON schema description of that error object is

{
  "type": "object",
  "properties": {
    "code": { "type": "integer", "required": true },
    "message": { "type": "string", "required": true },
    "data": { "type": "object",
      "properties": {
        "method": { "type": "string", "required": true },
        "stack": { "type": "object", "id": "Error.Stack",
          "properties": {
            "name": { "type": "string", "required": true },
            "type": { "type": "string", "required": true },
            "message": { "type": "string", "required": true },
            "property": { "$ref": "Error.Stack" }
          }
        }
      }
    }
  }
}

Namespaces

The Kodi JSON-RPC API is split up into namespaces, which contain methods that can be called. These namespaces are:

Namespace Description
Addons List, enable and execute addons.
Application Application information and control.
AudioLibrary Audio Library information.
Favourites Favourites GetFavourites and AddFavourite.
Files Shares information & filesystem listings.
GUI Window properties and activation.
Input Allows limited navigation within Kodi.
JSONRPC A variety of standard JSONRPC calls.
PVR Live TV control.
Player Manages all available players.
Playlist Playlist modification.
Profiles Support for Profiles operations to Kodi.
Settings Allows manipulation of Kodi settings.
System System controls and information.
Textures Supplies GetTextures and RemoveTexture. Textures are images.
VideoLibrary Video Library information.
XBMC Dumping ground for very Kodi specific operations.

Methods

Addons

Addons.ExecuteAddon

Executes the given addon with the given parameters (if possible)
Permissions:

  • ExecuteAddon

Parameters:

  1. string addonid
  2. [mixed: object|array|string params = ""]
  3. [boolean wait = False]

Returns:

Type: string

Addons.GetAddonDetails

Gets the details of a specific addon
Permissions:

  • ReadData

Parameters:

  1. string addonid
  2. [Addon.Fields properties]

Returns:

Type: object
Properties:

  1. Addon.Details addon
  2. List.LimitsReturned limits

Addons.GetAddons

Gets all available addons
Permissions:

  • ReadData

Parameters:

  1. [Addon.Types type = unknown]
  2. [Addon.Content content = unknown] (Content provided by the addon. Only considered for plugins and scripts.)
  3. [mixed: boolean|string enabled = all]
  4. [Addon.Fields properties]
  5. [List.Limits limits]
  6. [mixed: boolean|string installed = True]

Returns:

Type: object
Properties:

  1. [array[ Addon.Details ] addons]
  2. List.LimitsReturned limits

Addons.SetAddonEnabled

Enables/Disables a specific addon
Permissions:

  • ManageAddon

Parameters:

  1. string addonid
  2. Global.Toggle enabled

Returns:

Type: string

Application

Application.GetProperties

Retrieves the values of the given properties
Permissions:

  • ReadData

Parameters:

  1. array[ Application.Property.Name ] properties

Returns:

Type: Application.Property.Value

Application.Quit

Quit application
Permissions:

  • ControlPower

Returns:

Type: string

Application.SetMute

Toggle mute/unmute
Permissions:

  • ControlPlayback

Parameters:

  1. Global.Toggle mute

Returns:

Type: boolean (Mute state)

Application.SetVolume

Set the current volume
Permissions:

  • ControlPlayback

Parameters:

  1. mixed: integer|Global.IncrementDecrement volume

Returns:

Type: integer

AudioLibrary

AudioLibrary.Clean

Cleans the audio library from non-existent items
Permissions:

  • RemoveData

Parameters:

  1. [boolean showdialogs = True] (Whether or not to show the progress bar or any other GUI dialog)

Returns:

Type: string

AudioLibrary.Export

Exports all items from the audio library
Permissions:

  • WriteFile

Parameters:

  1. [mixed: object|object options]

Returns:

Type: string

AudioLibrary.GetAlbumDetails

Retrieve details about a specific album
Permissions:

  • ReadData

Parameters:

  1. Library.Id albumid
  2. [Audio.Fields.Album properties]

Returns:

Type: object
Properties:

  1. [Audio.Details.Album albumdetails]

AudioLibrary.GetAlbums

Retrieve all albums from specified artist (and role) or that has songs of the specified genre
Permissions:

  • ReadData

Parameters:

  1. [Audio.Fields.Album properties]
  2. [List.Limits limits]
  3. [List.Sort sort]
  4. [mixed: object|object|object|object|object|object|object|object|List.Filter.Albums filter]
  5. [boolean includesingles = False]
  6. [boolean allroles = False] (Whether or not to include all roles when filtering by artist, rather than the default of excluding other contributions. When true it overrides any role filter value.)

Returns:

Type: object
Properties:

  1. [array[ Audio.Details.Album ] albums]
  2. List.LimitsReturned limits

AudioLibrary.GetArtistDetails

Retrieve details about a specific artist
Permissions:

  • ReadData

Parameters:

  1. Library.Id artistid
  2. [Audio.Fields.Artist properties]

Returns:

Type: object
Properties:

  1. [Audio.Details.Artist artistdetails]

AudioLibrary.GetArtists

Retrieve all artists. For backward compatibility by default this implicitly does not include those that only contribute other roles, however absolutely all artists can be returned using allroles=true
Permissions:

  • ReadData

Parameters:

  1. [Optional.Boolean albumartistsonly = None] (Whether or not to only include album artists rather than the artists of only individual songs as well. If the parameter is not passed or is passed as null the GUI setting will be used)
  2. [Audio.Fields.Artist properties]
  3. [List.Limits limits]
  4. [List.Sort sort]
  5. [mixed: object|object|object|object|object|object|object|object|object|object|object|object|object|object|object|List.Filter.Artists filter]
  6. [boolean allroles = False] (Whether or not to include all artists irrespective of the role they contributed. When true it overrides any role filter value.)

Returns:

Type: object
Properties:

  1. [array[ Audio.Details.Artist ] artists]
  2. List.LimitsReturned limits

AudioLibrary.GetAvailableArt

Retrieve all potential art URLs for a media item by art type
Permissions:

  • ReadData

Parameters:

  1. mixed: object|object item
  2. [string arttype = ""]

Returns:

Type: object
Properties:

  1. array availableart

AudioLibrary.GetAvailableArtTypes

Retrieve a list of potential art types for a media item
Permissions:

  • ReadData

Parameters:

  1. mixed: object|object item

Returns:

Type: object
Properties:

  1. array availablearttypes

AudioLibrary.GetGenres

Retrieve all genres
Permissions:

  • ReadData

Parameters:

  1. [Library.Fields.Genre properties]
  2. [List.Limits limits]
  3. [List.Sort sort]

Returns:

Type: object
Properties:

  1. array[ Library.Details.Genre ] genres
  2. List.LimitsReturned limits

AudioLibrary.GetProperties

Retrieves the values of the music library properties
Permissions:

  • ReadData

Parameters:

  1. array[ Audio.Property.Name ] properties

Returns:

Type: Audio.Property.Value

AudioLibrary.GetRecentlyAddedAlbums

Retrieve recently added albums
Permissions:

  • ReadData

Parameters:

  1. [Audio.Fields.Album properties]
  2. [List.Limits limits]
  3. [List.Sort sort]

Returns:

Type: object
Properties:

  1. [array[ Audio.Details.Album ] albums]
  2. List.LimitsReturned limits

AudioLibrary.GetRecentlyAddedSongs

Retrieve recently added songs
Permissions:

  • ReadData

Parameters:

  1. [List.Amount albumlimit = -1] (The amount of recently added albums from which to return the songs)
  2. [Audio.Fields.Song properties]
  3. [List.Limits limits]
  4. [List.Sort sort]

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. [array[ Audio.Details.Song ] songs]

AudioLibrary.GetRecentlyPlayedAlbums

Retrieve recently played albums
Permissions:

  • ReadData

Parameters:

  1. [Audio.Fields.Album properties]
  2. [List.Limits limits]
  3. [List.Sort sort]

Returns:

Type: object
Properties:

  1. [array[ Audio.Details.Album ] albums]
  2. List.LimitsReturned limits

AudioLibrary.GetRecentlyPlayedSongs

Retrieve recently played songs
Permissions:

  • ReadData

Parameters:

  1. [Audio.Fields.Song properties]
  2. [List.Limits limits]
  3. [List.Sort sort]

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. [array[ Audio.Details.Song ] songs]

AudioLibrary.GetRoles

Retrieve all contributor roles
Permissions:

  • ReadData

Parameters:

  1. [Audio.Fields.Role properties]
  2. [List.Limits limits]
  3. [List.Sort sort]

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. array[ Audio.Details.Role ] roles

AudioLibrary.GetSongDetails

Retrieve details about a specific song
Permissions:

  • ReadData

Parameters:

  1. Library.Id songid
  2. [Audio.Fields.Song properties]

Returns:

Type: object
Properties:

  1. [Audio.Details.Song songdetails]

AudioLibrary.GetSongs

Retrieve all songs from specified album, artist or genre
Permissions:

  • ReadData

Parameters:

  1. [Audio.Fields.Song properties]
  2. [List.Limits limits]
  3. [List.Sort sort]
  4. [mixed: object|object|object|object|object|object|object|object|object|object|List.Filter.Songs filter]
  5. [boolean includesingles = True] (Only songs from albums are returned when false, but overridden when singlesonly parameter is true)
  6. [boolean allroles = False] (Whether or not to include all roles when filtering by artist, rather than default of excluding other contributors. When true it overrides any role filter value.)
  7. [boolean singlesonly = False] (Only singles are returned when true, and overrides includesingles parameter)

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. [array[ Audio.Details.Song ] songs]

AudioLibrary.GetSources

Get all music sources, including unique ID
Permissions:

  • ReadData

Parameters:

  1. [Library.Fields.Source properties]
  2. [List.Limits limits]
  3. [List.Sort sort]

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. array[ Library.Details.Source ] sources

AudioLibrary.Scan

Scans the audio sources for new library items
Permissions:

  • UpdateData

Parameters:

  1. [string directory = ""]
  2. [boolean showdialogs = True] (Whether or not to show the progress bar or any other GUI dialog)

Returns:

Type: string

AudioLibrary.SetAlbumDetails

Update the given album with the given details
Permissions:

  • UpdateData

Parameters:

  1. Library.Id albumid
  2. [Optional.String title = None]
  3. [mixed: null|Array.String artist = None]
  4. [Optional.String description = None]
  5. [mixed: null|Array.String genre = None]
  6. [mixed: null|Array.String theme = None]
  7. [mixed: null|Array.String mood = None]
  8. [mixed: null|Array.String style = None]
  9. [Optional.String type = None]
  10. [Optional.String albumlabel = None]
  11. [Optional.Number rating = None]
  12. [Optional.Integer year = None]
  13. [Optional.Integer userrating = None]
  14. [Optional.Integer votes = None]
  15. [Optional.String musicbrainzalbumid = None]
  16. [Optional.String musicbrainzreleasegroupid = None]
  17. [Optional.String sortartist = None]
  18. [Optional.String displayartist = None]
  19. [mixed: null|Array.String musicbrainzalbumartistid = None]
  20. [mixed: null|Media.Artwork.Set art = None]
  21. [Optional.Boolean isboxset = None]
  22. [Optional.String releasedate = None]
  23. [Optional.String originaldate = None]

Returns:

Type: string

AudioLibrary.SetArtistDetails

Update the given artist with the given details
Permissions:

  • UpdateData

Parameters:

  1. Library.Id artistid
  2. [Optional.String artist = None]
  3. [mixed: null|Array.String instrument = None]
  4. [mixed: null|Array.String style = None]
  5. [mixed: null|Array.String mood = None]
  6. [Optional.String born = None]
  7. [Optional.String formed = None]
  8. [Optional.String description = None]
  9. [mixed: null|Array.String genre = None]
  10. [Optional.String died = None]
  11. [Optional.String disbanded = None]
  12. [mixed: null|Array.String yearsactive = None]
  13. [Optional.String musicbrainzartistid = None]
  14. [Optional.String sortname = None]
  15. [Optional.String type = None]
  16. [Optional.String gender = None]
  17. [Optional.String disambiguation = None]
  18. [mixed: null|Media.Artwork.Set art = None]

Returns:

Type: string

AudioLibrary.SetSongDetails

Update the given song with the given details
Permissions:

  • UpdateData

Parameters:

  1. Library.Id songid
  2. [Optional.String title = None]
  3. [mixed: null|Array.String artist = None]
  4. [mixed: null|Array.String genre = None]
  5. [Optional.Integer year = None]
  6. [Optional.Number rating = None]
  7. [Optional.Integer track = None]
  8. [Optional.Integer disc = None]
  9. [Optional.Integer duration = None]
  10. [Optional.String comment = None]
  11. [Optional.String musicbrainztrackid = None]
  12. [Optional.String musicbrainzartistid = None]
  13. [Optional.Integer playcount = None]
  14. [Optional.String lastplayed = None]
  15. [Optional.Integer userrating = None]
  16. [Optional.Integer votes = None]
  17. [Optional.String displayartist = None]
  18. [Optional.String sortartist = None]
  19. [Optional.String mood = None]
  20. [mixed: null|Media.Artwork.Set art = None]
  21. [Optional.String disctitle = None]
  22. [Optional.String releasedate = None]
  23. [Optional.String originaldate = None]
  24. [Optional.Integer bpm = None]

Returns:

Type: string

Favourites

Favourites.AddFavourite

Add a favourite with the given details
Permissions:

  • UpdateData

Parameters:

  1. string title
  2. Favourite.Type type
  3. [Optional.String path = None] (Required for media, script and androidapp favourites types)
  4. [Optional.String window = None] (Required for window favourite type)
  5. [Optional.String windowparameter = None]
  6. [Optional.String thumbnail = None]

Returns:

Type: string

Favourites.GetFavourites

Retrieve all favourites
Permissions:

  • ReadData

Parameters:

  1. [mixed: null|Favourite.Type type = None]
  2. [Favourite.Fields.Favourite properties]

Returns:

Type: object
Properties:

  1. [array[ Favourite.Details.Favourite ] favourites]
  2. List.LimitsReturned limits

Files

Files.Download

Downloads the given file
Permissions:

  • ReadData

Parameters:

  1. string path

Returns:

Type: any

Files.GetDirectory

Get the directories and files in the given directory
Permissions:

  • ReadData

Parameters:

  1. string directory
  2. [Files.Media media = files]
  3. [List.Fields.Files properties]
  4. [List.Sort sort]
  5. [List.Limits limits] (Limits are applied after getting the directory content thus retrieval is not faster when they are applied.)

Returns:

Type: object
Properties:

  1. array[ List.Item.File ] files
  2. List.LimitsReturned limits

Files.GetFileDetails

Get details for a specific file
Permissions:

  • ReadData

Parameters:

  1. string file (Full path to the file)
  2. [Files.Media media = files]
  3. [List.Fields.Files properties]

Returns:

Type: object
Properties:

  1. List.Item.File filedetails

Files.GetSources

Get the sources of the media windows
Permissions:

  • ReadData

Parameters:

  1. Files.Media media
  2. [List.Limits limits]
  3. [List.Sort sort]

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. List.Items.Sources sources

Files.PrepareDownload

Provides a way to download a given file (e.g. providing an URL to the real file location)
Permissions:

  • ReadData

Parameters:

  1. string path

Returns:

Type: object
Properties:

  1. any details (Transport specific details on how/from where to download the given file)
  2. string mode (Direct mode allows using Files.Download whereas redirect mode requires the usage of a different protocol)
  3. string protocol

Files.SetFileDetails

Update the given specific file with the given details
Permissions:

  • UpdateData

Parameters:

  1. string file (Full path to the file)
  2. Files.Media media (File type to update correct database. Currently only "video" is supported.)
  3. [Optional.Integer playcount = None]
  4. [Optional.String lastplayed = None] (Setting a valid lastplayed without a playcount will force playcount to 1.)
  5. [mixed: null|Video.Resume resume = None]

Returns:

Type: string

GUI

GUI.ActivateWindow

Activates the given window
Permissions:

  • ControlGUI

Parameters:

  1. GUI.Window window
  2. [array[string] parameters]

Returns:

Type: string

GUI.GetProperties

Retrieves the values of the given properties
Permissions:

  • ReadData

Parameters:

  1. array[ GUI.Property.Name ] properties

Returns:

Type: GUI.Property.Value

GUI.GetStereoscopicModes

Returns the supported stereoscopic modes of the GUI
Permissions:

  • ReadData

Returns:

Type: object
Properties:

  1. [array[ GUI.Stereoscopy.Mode ] stereoscopicmodes]

GUI.SetFullscreen

Toggle fullscreen/GUI
Permissions:

  • ControlGUI

Parameters:

  1. Global.Toggle fullscreen

Returns:

Type: boolean (Fullscreen state)

GUI.SetStereoscopicMode

Sets the stereoscopic mode of the GUI to the given mode
Permissions:

  • ControlGUI

Parameters:

  1. string mode

Returns:

Type: string

GUI.ShowNotification

Shows a GUI notification
Permissions:

  • ControlGUI

Parameters:

  1. string title
  2. string message
  3. [mixed: string|string image = ""]
  4. [integer displaytime = 5000] (The time in milliseconds the notification will be visible)

Returns:

Type: string

Input

Input.Back

Goes back in GUI
Permissions:

  • Navigate

Returns:

Type: string

Input.ButtonEvent

Send a button press event
Permissions:

  • Navigate

Parameters:

  1. string button (Button name)
  2. string keymap (Keymap name (KB, XG, R1, or R2))
  3. [integer holdtime = 0] (Number of milliseconds to simulate button hold.)

Returns:

Type: string

Input.ContextMenu

Shows the context menu
Permissions:

  • Navigate

Returns:

Type: string

Input.Down

Navigate down in GUI
Permissions:

  • Navigate

Returns:

Type: string

Input.ExecuteAction

Execute a specific action
Permissions:

  • Navigate

Parameters:

  1. Input.Action action

Returns:

Type: string

Input.Home

Goes to home window in GUI
Permissions:

  • Navigate

Returns:

Type: string

Input.Info

Shows the information dialog
Permissions:

  • Navigate

Returns:

Type: string

Input.Left

Navigate left in GUI
Permissions:

  • Navigate

Returns:

Type: string

Input.Right

Navigate right in GUI
Permissions:

  • Navigate

Returns:

Type: string

Input.Select

Select current item in GUI
Permissions:

  • Navigate

Returns:

Type: string

Input.SendText

Send a generic (unicode) text
Permissions:

  • Navigate

Parameters:

  1. string text (Unicode text)
  2. [boolean done = True] (Whether this is the whole input or not (closes an open input dialog if true).)

Returns:

Type: string

Input.ShowCodec

Show codec information of the playing item
Permissions:

  • Navigate

Returns:

Type: string

Input.ShowOSD

Show the on-screen display for the current player
Permissions:

  • Navigate

Returns:

Type: string

Input.ShowPlayerProcessInfo

Show player process information of the playing item, like video decoder, pixel format, pvr signal strength, ...
Permissions:

  • Navigate

Returns:

Type: string

Input.Up

Navigate up in GUI
Permissions:

  • Navigate

Returns:

Type: string

JSONRPC

JSONRPC.GetConfiguration

Get client-specific configurations
Permissions:

  • ReadData

Returns:

Type: Configuration

JSONRPC.Introspect

Enumerates all actions and descriptions
Permissions:

  • ReadData

Parameters:

  1. [boolean getdescriptions = True]
  2. [boolean getmetadata = False]
  3. [boolean filterbytransport = True]
  4. [object filter]

Returns:

Type: object

JSONRPC.NotifyAll

Notify all other connected clients
Permissions:

  • ReadData

Parameters:

  1. string sender
  2. string message
  3. [any data = None]

Returns:

Type: any

JSONRPC.Permission

Retrieve the clients permissions
Permissions:

  • ReadData

Returns:

Type: object
Properties:

  1. boolean controlgui
  2. boolean controlnotify
  3. boolean controlplayback
  4. boolean controlpower
  5. boolean controlpvr
  6. boolean controlsystem
  7. boolean executeaddon
  8. boolean manageaddon
  9. boolean navigate
  10. boolean readdata
  11. boolean removedata
  12. boolean updatedata
  13. boolean writefile

JSONRPC.Ping

Ping responder
Permissions:

  • ReadData

Returns:

Type: string

JSONRPC.SetConfiguration

Change the client-specific configuration
Permissions:

  • ControlNotify

Parameters:

  1. [object notifications]

Returns:

Type: Configuration

JSONRPC.Version

Retrieve the JSON-RPC protocol version.
Permissions:

  • ReadData

Returns:

Type: object
Properties:

  1. object version

PVR

PVR.AddTimer

Adds a timer to record the given show one times or a timer rule to record all showings of the given show or adds a reminder timer or reminder timer rule
Permissions:

  • ControlPVR

Parameters:

  1. Library.Id broadcastid (the broadcast id of the item to record)
  2. [boolean timerrule = False] (controls whether to create a timer rule or a onetime timer)
  3. [boolean reminder = False] (controls whether to create a reminder timer or a recording timer)

Returns:

Type: string

PVR.DeleteTimer

Deletes a onetime timer or a timer rule
Permissions:

  • ControlPVR

Parameters:

  1. Library.Id timerid (the id of the onetime timer or timer rule to delete)

Returns:

Type: string

PVR.GetBroadcastDetails

Retrieves the details of a specific broadcast
Permissions:

  • ReadData

Parameters:

  1. Library.Id broadcastid
  2. [PVR.Fields.Broadcast properties]

Returns:

Type: object
Properties:

  1. [PVR.Details.Broadcast broadcastdetails]

PVR.GetBroadcastIsPlayable

Retrieves whether or not a broadcast is playable
Permissions:

  • ReadData

Parameters:

  1. Library.Id broadcastid (the id of the broadcast to to check for playability)

Returns:

Type: boolean

PVR.GetBroadcasts

Retrieves the program of a specific channel
Permissions:

  • ReadData

Parameters:

  1. Library.Id channelid
  2. [PVR.Fields.Broadcast properties]
  3. [List.Limits limits]

Returns:

Type: object
Properties:

  1. array[ PVR.Details.Broadcast ] broadcasts
  2. List.LimitsReturned limits

PVR.GetChannelDetails

Retrieves the details of a specific channel
Permissions:

  • ReadData

Parameters:

  1. Library.Id channelid
  2. [PVR.Fields.Channel properties]

Returns:

Type: object
Properties:

  1. [PVR.Details.Channel channeldetails]

PVR.GetChannelGroupDetails

Retrieves the details of a specific channel group
Permissions:

  • ReadData

Parameters:

  1. PVR.ChannelGroup.Id channelgroupid
  2. [object channels]

Returns:

Type: object
Properties:

  1. [PVR.Details.ChannelGroup.Extended channelgroupdetails]

PVR.GetChannelGroups

Retrieves the channel groups for the specified type
Permissions:

  • ReadData

Parameters:

  1. PVR.Channel.Type channeltype
  2. [List.Limits limits]

Returns:

Type: object
Properties:

  1. array[ PVR.Details.ChannelGroup ] channelgroups
  2. List.LimitsReturned limits

PVR.GetChannels

Retrieves the channel list
Permissions:

  • ReadData

Parameters:

  1. PVR.ChannelGroup.Id channelgroupid
  2. [PVR.Fields.Channel properties]
  3. [List.Limits limits]
  4. [List.Sort sort]

Returns:

Type: object
Properties:

  1. array[ PVR.Details.Channel ] channels
  2. List.LimitsReturned limits

PVR.GetClients

Retrieves the enabled PVR clients and their capabilities
Permissions:

  • ReadData

Parameters:

  1. [List.Limits limits]

Returns:

Type: object
Properties:

  1. array[ PVR.Details.Client ] clients
  2. List.LimitsReturned limits

PVR.GetProperties

Retrieves the values of the given properties
Permissions:

  • ReadData

Parameters:

  1. array[ PVR.Property.Name ] properties

Returns:

Type: PVR.Property.Value

PVR.GetRecordingDetails

Retrieves the details of a specific recording
Permissions:

  • ReadData

Parameters:

  1. Library.Id recordingid
  2. [PVR.Fields.Recording properties]

Returns:

Type: object
Properties:

  1. [PVR.Details.Recording recordingdetails]

PVR.GetRecordings

Retrieves the recordings
Permissions:

  • ReadData

Parameters:

  1. [PVR.Fields.Recording properties]
  2. [List.Limits limits]
  3. [List.Sort sort]

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. array[ PVR.Details.Recording ] recordings

PVR.GetTimerDetails

Retrieves the details of a specific timer
Permissions:

  • ReadData

Parameters:

  1. Library.Id timerid
  2. [PVR.Fields.Timer properties]

Returns:

Type: object
Properties:

  1. [PVR.Details.Timer timerdetails]

PVR.GetTimers

Retrieves the timers
Permissions:

  • ReadData

Parameters:

  1. [PVR.Fields.Timer properties]
  2. [List.Limits limits]
  3. [List.Sort sort]

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. array[ PVR.Details.Timer ] timers

PVR.Record

Toggle recording of a channel
Permissions:

  • ControlPVR

Parameters:

  1. [Global.Toggle record = toggle]
  2. [mixed: string|Library.Id channel = current]

Returns:

Type: string

PVR.Scan

Starts a channel scan
Permissions:

  • ControlPVR

Parameters:

  1. [Library.Id clientid = -1] (Specify a PVR client id to avoid UI dialog, optional in kodi 19, required in kodi 20)

Returns:

Type: string

PVR.ToggleTimer

Creates or deletes a onetime timer or timer rule for a given show. If it exists, it will be deleted. If it does not exist, it will be created
Permissions:

  • ControlPVR

Parameters:

  1. Library.Id broadcastid (the broadcast id of the item to toggle a onetime timer or time rule for)
  2. [boolean timerrule = False] (controls whether to create / delete a timer rule or a onetime timer)

Returns:

Type: string

Player

Player.AddSubtitle

Add subtitle to the player
Permissions:

  • ControlPlayback

Parameters:

  1. Player.Id playerid
  2. string subtitle (Local path or remote URL to the subtitle file to load)

Returns:

Type: string

Player.GetActivePlayers

Returns all active players
Permissions:

  • ReadData

Returns:

Type: array

Player.GetItem

Retrieves the currently played item
Permissions:

  • ReadData

Parameters:

  1. Player.Id playerid
  2. [List.Fields.All properties]

Returns:

Type: object
Properties:

  1. List.Item.All item

Player.GetPlayers

Get a list of available players
Permissions:

  • ReadData

Parameters:

  1. [string media = all]

Returns:

Type: array

Player.GetProperties

Retrieves the values of the given properties
Permissions:

  • ReadData

Parameters:

  1. Player.Id playerid
  2. array[ Player.Property.Name ] properties

Returns:

Type: Player.Property.Value

Player.GetViewMode

Get view mode of video player
Permissions:

  • ReadData

Returns:

Type: object
Properties:

  1. boolean nonlinearstretch
  2. number pixelratio
  3. number verticalshift
  4. Player.ViewMode viewmode
  5. number zoom

Player.GoTo

Go to previous/next/specific item in the playlist
Permissions:

  • ControlPlayback

Parameters:

  1. Player.Id playerid
  2. mixed: string|Playlist.Position to

Returns:

Type: string

Player.Move

If picture is zoomed move viewport left/right/up/down otherwise skip previous/next
Permissions:

  • ControlPlayback

Parameters:

  1. Player.Id playerid
  2. string direction

Returns:

Type: string

Player.Open

Start playback of either the playlist with the given ID, a slideshow with the pictures from the given directory or a single file or an item from the database.
Permissions:

  • ControlPlayback

Parameters:

  1. [mixed: object|Playlist.Item|object|object|object|object|object item]
  2. [object options]

Returns:

Type: string

Player.PlayPause

Pauses or unpause playback and returns the new state
Permissions:

  • ControlPlayback

Parameters:

  1. Player.Id playerid
  2. [Global.Toggle play = toggle]

Returns:

Type: Player.Speed

Player.Rotate

Rotates current picture
Permissions:

  • ControlPlayback

Parameters:

  1. Player.Id playerid
  2. [string value = clockwise]

Returns:

Type: string

Player.Seek

Seek through the playing item
Permissions:

  • ControlPlayback

Parameters:

  1. Player.Id playerid
  2. mixed: object|object|object|object value

Returns:

Type: object
Properties:

  1. [Player.Position.Percentage percentage]
  2. [Global.Time time] (A duration.)
  3. [Global.Time totaltime] (A duration.)

Player.SetAudioStream

Set the audio stream played by the player
Permissions:

  • ControlPlayback

Parameters:

  1. Player.Id playerid
  2. mixed: string|integer stream

Returns:

Type: string

Player.SetPartymode

Turn partymode on or off
Permissions:

  • ControlPlayback

Parameters:

  1. Player.Id playerid
  2. Global.Toggle partymode

Returns:

Type: string

Player.SetRepeat

Set the repeat mode of the player
Permissions:

  • ControlPlayback

Parameters:

  1. Player.Id playerid
  2. mixed: Player.Repeat|string repeat

Returns:

Type: string

Player.SetShuffle

Shuffle/Unshuffle items in the player
Permissions:

  • ControlPlayback

Parameters:

  1. Player.Id playerid
  2. Global.Toggle shuffle

Returns:

Type: string

Player.SetSpeed

Set the speed of the current playback
Permissions:

  • ControlPlayback

Parameters:

  1. Player.Id playerid
  2. mixed: integer|Global.IncrementDecrement speed

Returns:

Type: Player.Speed

Player.SetSubtitle

Set the subtitle displayed by the player
Permissions:

  • ControlPlayback

Parameters:

  1. Player.Id playerid
  2. mixed: string|integer subtitle
  3. [boolean enable = False] (Whether to enable subtitles to be displayed after setting the new subtitle)

Returns:

Type: string

Player.SetVideoStream

Set the video stream played by the player
Permissions:

  • ControlPlayback

Parameters:

  1. Player.Id playerid
  2. mixed: string|integer stream

Returns:

Type: string

Player.SetViewMode

Set view mode of video player
Permissions:

  • ControlPlayback

Parameters:

  1. mixed: Player.CustomViewMode|Player.ViewMode viewmode

Returns:

Type: string

Player.Stop

Stops playback
Permissions:

  • ControlPlayback

Parameters:

  1. Player.Id playerid

Returns:

Type: string

Player.Zoom

Zoom current picture
Permissions:

  • ControlPlayback

Parameters:

  1. Player.Id playerid
  2. mixed: string|integer zoom

Returns:

Type: string

Playlist

Playlist.Add

Add item(s) to playlist
Permissions:

  • ControlPlayback

Parameters:

  1. Playlist.Id playlistid
  2. mixed: Playlist.Item|array item

Returns:

Type: string

Playlist.Clear

Clear playlist
Permissions:

  • ControlPlayback

Parameters:

  1. Playlist.Id playlistid

Returns:

Type: string

Playlist.GetItems

Get all items from playlist
Permissions:

  • ReadData

Parameters:

  1. Playlist.Id playlistid
  2. [List.Fields.All properties]
  3. [List.Limits limits]
  4. [List.Sort sort]

Returns:

Type: object
Properties:

  1. array[ List.Item.All ] items
  2. List.LimitsReturned limits

Playlist.GetPlaylists

Returns all existing playlists
Permissions:

  • ReadData

Returns:

Type: array

Playlist.GetProperties

Retrieves the values of the given properties
Permissions:

  • ReadData

Parameters:

  1. Playlist.Id playlistid
  2. array[ Playlist.Property.Name ] properties

Returns:

Type: Playlist.Property.Value

Playlist.Insert

Insert item(s) into playlist. Does not work for picture playlists (aka slideshows).
Permissions:

  • ControlPlayback

Parameters:

  1. Playlist.Id playlistid
  2. Playlist.Position position
  3. mixed: Playlist.Item|array item

Returns:

Type: string

Playlist.Remove

Remove item from playlist. Does not work for picture playlists (aka slideshows).
Permissions:

  • ControlPlayback

Parameters:

  1. Playlist.Id playlistid
  2. Playlist.Position position

Returns:

Type: string

Playlist.Swap

Swap items in the playlist. Does not work for picture playlists (aka slideshows).
Permissions:

  • ControlPlayback

Parameters:

  1. Playlist.Id playlistid
  2. Playlist.Position position1
  3. Playlist.Position position2

Returns:

Type: string

Profiles

Profiles.GetCurrentProfile

Retrieve the current profile
Permissions:

  • ReadData

Parameters:

  1. [Profiles.Fields.Profile properties]

Returns:

Type: Profiles.Details.Profile

Profiles.GetProfiles

Retrieve all profiles
Permissions:

  • ReadData

Parameters:

  1. [Profiles.Fields.Profile properties]
  2. [List.Limits limits]
  3. [List.Sort sort]

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. array[ Profiles.Details.Profile ] profiles

Profiles.LoadProfile

Load the specified profile
Permissions:

  • Navigate

Parameters:

  1. string profile (Profile name)
  2. [boolean prompt = False] (Prompt for password)
  3. [Profiles.Password password]

Returns:

Type: string

Settings

Settings.GetCategories

Retrieves all setting categories
Permissions:

  • ReadData

Parameters:

  1. [Setting.Level level = standard]
  2. [string section = ""]
  3. [string properties]

Returns:

Type: object
Properties:

  1. [array[ Setting.Details.Category ] categories]

Settings.GetSections

Retrieves all setting sections
Permissions:

  • ReadData

Parameters:

  1. [Setting.Level level = standard]
  2. [Setting.Level properties]

Returns:

Type: object
Properties:

  1. [array[ Setting.Details.Section ] sections]

Settings.GetSettingValue

Retrieves the value of a setting
Permissions:

  • ReadData

Parameters:

  1. string setting

Returns:

Type: object
Properties:

  1. Setting.Value.Extended value

Settings.GetSettings

Retrieves all settings
Permissions:

  • ReadData

Parameters:

  1. [Setting.Level level = standard]
  2. [mixed: object filter]

Returns:

Type: object
Properties:

  1. [array[ Setting.Details.Setting ] settings]

Settings.ResetSettingValue

Resets the value of a setting
Permissions:

  • ReadData

Parameters:

  1. string setting

Returns:

Type: string

Settings.SetSettingValue

Changes the value of a setting
Permissions:

  • ReadData

Parameters:

  1. string setting
  2. Setting.Value.Extended value

Returns:

Type: boolean

System

System.EjectOpticalDrive

Ejects or closes the optical disc drive (if available)
Permissions:

  • ControlSystem

Returns:

Type: string

System.GetProperties

Retrieves the values of the given properties
Permissions:

  • ReadData

Parameters:

  1. array[ System.Property.Name ] properties

Returns:

Type: System.Property.Value

System.Hibernate

Puts the system running Kodi into hibernate mode
Permissions:

  • ControlPower

Returns:

Type: string

System.Reboot

Reboots the system running Kodi
Permissions:

  • ControlPower

Returns:

Type: string

System.Shutdown

Shuts the system running Kodi down
Permissions:

  • ControlPower

Returns:

Type: string

System.Suspend

Suspends the system running Kodi
Permissions:

  • ControlPower

Returns:

Type: string

Textures

Textures.GetTextures

Retrieve all textures
Permissions:

  • ReadData

Parameters:

  1. [Textures.Fields.Texture properties]
  2. [List.Filter.Textures filter]

Returns:

Type: object
Properties:

  1. array[ Textures.Details.Texture ] textures

Textures.RemoveTexture

Remove the specified texture
Permissions:

  • RemoveData

Parameters:

  1. Library.Id textureid (Texture database identifier)

Returns:

Type: string

VideoLibrary

VideoLibrary.Clean

Cleans the video library for non-existent items
Permissions:

  • RemoveData

Parameters:

  1. [boolean showdialogs = True] (Whether or not to show the progress bar or any other GUI dialog)
  2. [string content = video] (Content type to clean for)
  3. [string directory = ""] (Path to the directory to clean up; performs a global cleanup if not specified)

Returns:

Type: string

VideoLibrary.Export

Exports all items from the video library
Permissions:

  • WriteFile

Parameters:

  1. [mixed: object|object options]

Returns:

Type: string

VideoLibrary.GetAvailableArt

Retrieve all potential art URLs for a media item by art type
Permissions:

  • ReadData

Parameters:

  1. mixed: object|object|object|object|object|object item
  2. [string arttype = ""]

Returns:

Type: object
Properties:

  1. array availableart

VideoLibrary.GetAvailableArtTypes

Retrieve a list of potential art types for a media item
Permissions:

  • ReadData

Parameters:

  1. mixed: object|object|object|object|object|object item

Returns:

Type: object
Properties:

  1. array availablearttypes

VideoLibrary.GetEpisodeDetails

Retrieve details about a specific tv show episode
Permissions:

  • ReadData

Parameters:

  1. Library.Id episodeid
  2. [Video.Fields.Episode properties]

Returns:

Type: object
Properties:

  1. [Video.Details.Episode episodedetails]

VideoLibrary.GetEpisodes

Retrieve all tv show episodes
Permissions:

  • ReadData

Parameters:

  1. [Library.Id tvshowid = -1]
  2. [integer season = -1]
  3. [Video.Fields.Episode properties]
  4. [List.Limits limits]
  5. [List.Sort sort]
  6. [mixed: object|object|object|object|object|List.Filter.Episodes filter]

Returns:

Type: object
Properties:

  1. [array[ Video.Details.Episode ] episodes]
  2. List.LimitsReturned limits

VideoLibrary.GetGenres

Retrieve all genres
Permissions:

  • ReadData

Parameters:

  1. string type
  2. [Library.Fields.Genre properties]
  3. [List.Limits limits]
  4. [List.Sort sort]

Returns:

Type: object
Properties:

  1. array[ Library.Details.Genre ] genres
  2. List.LimitsReturned limits

VideoLibrary.GetInProgressTVShows

Retrieve all in progress tvshows
Permissions:

  • ReadData

Parameters:

  1. [Video.Fields.TVShow properties]
  2. [List.Limits limits]
  3. [List.Sort sort]

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. [array[ Video.Details.TVShow ] tvshows]

VideoLibrary.GetMovieDetails

Retrieve details about a specific movie
Permissions:

  • ReadData

Parameters:

  1. Library.Id movieid
  2. [Video.Fields.Movie properties]

Returns:

Type: object
Properties:

  1. [Video.Details.Movie moviedetails]

VideoLibrary.GetMovieSetDetails

Retrieve details about a specific movie set
Permissions:

  • ReadData

Parameters:

  1. Library.Id setid
  2. [Video.Fields.MovieSet properties]
  3. [object movies]

Returns:

Type: object
Properties:

  1. [Video.Details.MovieSet.Extended setdetails]

VideoLibrary.GetMovieSets

Retrieve all movie sets
Permissions:

  • ReadData

Parameters:

  1. [Video.Fields.MovieSet properties]
  2. [List.Limits limits]
  3. [List.Sort sort]

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. [array[ Video.Details.MovieSet ] sets]

VideoLibrary.GetMovies

Retrieve all movies
Permissions:

  • ReadData

Parameters:

  1. [Video.Fields.Movie properties]
  2. [List.Limits limits]
  3. [List.Sort sort]
  4. [mixed: object|object|object|object|object|object|object|object|object|object|List.Filter.Movies filter]

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. [array[ Video.Details.Movie ] movies]

VideoLibrary.GetMusicVideoDetails

Retrieve details about a specific music video
Permissions:

  • ReadData

Parameters:

  1. Library.Id musicvideoid
  2. [Video.Fields.MusicVideo properties]

Returns:

Type: object
Properties:

  1. [Video.Details.MusicVideo musicvideodetails]

VideoLibrary.GetMusicVideos

Retrieve all music videos
Permissions:

  • ReadData

Parameters:

  1. [Video.Fields.MusicVideo properties]
  2. [List.Limits limits]
  3. [List.Sort sort]
  4. [mixed: object|object|object|object|object|object|object|List.Filter.MusicVideos filter]

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. [array[ Video.Details.MusicVideo ] musicvideos]

VideoLibrary.GetRecentlyAddedEpisodes

Retrieve all recently added tv episodes
Permissions:

  • ReadData

Parameters:

  1. [Video.Fields.Episode properties]
  2. [List.Limits limits]
  3. [List.Sort sort]

Returns:

Type: object
Properties:

  1. [array[ Video.Details.Episode ] episodes]
  2. List.LimitsReturned limits

VideoLibrary.GetRecentlyAddedMovies

Retrieve all recently added movies
Permissions:

  • ReadData

Parameters:

  1. [Video.Fields.Movie properties]
  2. [List.Limits limits]
  3. [List.Sort sort]

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. [array[ Video.Details.Movie ] movies]

VideoLibrary.GetRecentlyAddedMusicVideos

Retrieve all recently added music videos
Permissions:

  • ReadData

Parameters:

  1. [Video.Fields.MusicVideo properties]
  2. [List.Limits limits]
  3. [List.Sort sort]

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. [array[ Video.Details.MusicVideo ] musicvideos]

VideoLibrary.GetSeasonDetails

Retrieve details about a specific tv show season
Permissions:

  • ReadData

Parameters:

  1. Library.Id seasonid
  2. [Video.Fields.Season properties]

Returns:

Type: object
Properties:

  1. [Video.Details.Season seasondetails]

VideoLibrary.GetSeasons

Retrieve all tv seasons
Permissions:

  • ReadData

Parameters:

  1. [Library.Id tvshowid = -1]
  2. [Video.Fields.Season properties]
  3. [List.Limits limits]
  4. [List.Sort sort]

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. [array[ Video.Details.Season ] seasons]

VideoLibrary.GetTVShowDetails

Retrieve details about a specific tv show
Permissions:

  • ReadData

Parameters:

  1. Library.Id tvshowid
  2. [Video.Fields.TVShow properties]

Returns:

Type: object
Properties:

  1. [Video.Details.TVShow tvshowdetails]

VideoLibrary.GetTVShows

Retrieve all tv shows
Permissions:

  • ReadData

Parameters:

  1. [Video.Fields.TVShow properties]
  2. [List.Limits limits]
  3. [List.Sort sort]
  4. [mixed: object|object|object|object|object|object|List.Filter.TVShows filter]

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. [array[ Video.Details.TVShow ] tvshows]

VideoLibrary.GetTags

Retrieve all tags
Permissions:

  • ReadData

Parameters:

  1. string type
  2. [Library.Fields.Tag properties]
  3. [List.Limits limits]
  4. [List.Sort sort]

Returns:

Type: object
Properties:

  1. List.LimitsReturned limits
  2. array[ Library.Details.Tag ] tags

VideoLibrary.RefreshEpisode

Refresh the given episode in the library
Permissions:

  • UpdateData

Parameters:

  1. Library.Id episodeid
  2. [boolean ignorenfo = False] (Whether or not to ignore a local NFO if present.)
  3. [string title = ""] (Title to use for searching (instead of determining it from the item's filename/path).)

Returns:

Type: string

VideoLibrary.RefreshMovie

Refresh the given movie in the library
Permissions:

  • UpdateData

Parameters:

  1. Library.Id movieid
  2. [boolean ignorenfo = False] (Whether or not to ignore a local NFO if present.)
  3. [string title = ""] (Title to use for searching (instead of determining it from the item's filename/path).)

Returns:

Type: string

VideoLibrary.RefreshMusicVideo

Refresh the given music video in the library
Permissions:

  • UpdateData

Parameters:

  1. Library.Id musicvideoid
  2. [boolean ignorenfo = False] (Whether or not to ignore a local NFO if present.)
  3. [string title = ""] (Title to use for searching (instead of determining it from the item's filename/path).)

Returns:

Type: string

VideoLibrary.RefreshTVShow

Refresh the given tv show in the library
Permissions:

  • UpdateData

Parameters:

  1. Library.Id tvshowid
  2. [boolean ignorenfo = False] (Whether or not to ignore a local NFO if present.)
  3. [boolean refreshepisodes = False] (Whether or not to refresh all episodes belonging to the TV show.)
  4. [string title = ""] (Title to use for searching (instead of determining it from the item's filename/path).)

Returns:

Type: string

VideoLibrary.RemoveEpisode

Removes the given episode from the library
Permissions:

  • RemoveData

Parameters:

  1. Library.Id episodeid

Returns:

Type: string

VideoLibrary.RemoveMovie

Removes the given movie from the library
Permissions:

  • RemoveData

Parameters:

  1. Library.Id movieid

Returns:

Type: string

VideoLibrary.RemoveMusicVideo

Removes the given music video from the library
Permissions:

  • RemoveData

Parameters:

  1. Library.Id musicvideoid

Returns:

Type: string

VideoLibrary.RemoveTVShow

Removes the given tv show from the library
Permissions:

  • RemoveData

Parameters:

  1. Library.Id tvshowid

Returns:

Type: string

VideoLibrary.Scan

Scans the video sources for new library items
Permissions:

  • UpdateData

Parameters:

  1. [string directory = ""]
  2. [boolean showdialogs = True] (Whether or not to show the progress bar or any other GUI dialog)

Returns:

Type: string

VideoLibrary.SetEpisodeDetails

Update the given episode with the given details
Permissions:

  • UpdateData

Parameters:

  1. Library.Id episodeid
  2. [Optional.String title = None]
  3. [Optional.Integer playcount = None]
  4. [Optional.Integer runtime = None] (Runtime in seconds)
  5. [mixed: null|Array.String director = None]
  6. [Optional.String plot = None]
  7. [Optional.Number rating = None]
  8. [Optional.String votes = None]
  9. [Optional.String lastplayed = None]
  10. [mixed: null|Array.String writer = None]
  11. [Optional.String firstaired = None]
  12. [Optional.String productioncode = None]
  13. [Optional.Integer season = None]
  14. [Optional.Integer episode = None]
  15. [Optional.String originaltitle = None]
  16. [Optional.String thumbnail = None]
  17. [Optional.String fanart = None]
  18. [mixed: null|Media.Artwork.Set art = None]
  19. [mixed: null|Video.Resume resume = None]
  20. [Optional.Integer userrating = None]
  21. [Video.Ratings.Set ratings]
  22. [Optional.String dateadded = None]
  23. [mixed: null|Media.UniqueID.Set uniqueid = None]

Returns:

Type: string

VideoLibrary.SetMovieDetails

Update the given movie with the given details
Permissions:

  • UpdateData

Parameters:

  1. Library.Id movieid
  2. [Optional.String title = None]
  3. [Optional.Integer playcount = None]
  4. [Optional.Integer runtime = None] (Runtime in seconds)
  5. [mixed: null|Array.String director = None]
  6. [mixed: null|Array.String studio = None]
  7. [Optional.Integer year = None] (linked with premiered. Overridden by premiered parameter)
  8. [Optional.String plot = None]
  9. [mixed: null|Array.String genre = None]
  10. [Optional.Number rating = None]
  11. [Optional.String mpaa = None]
  12. [Optional.String imdbnumber = None]
  13. [Optional.String votes = None]
  14. [Optional.String lastplayed = None]
  15. [Optional.String originaltitle = None]
  16. [Optional.String trailer = None]
  17. [Optional.String tagline = None]
  18. [Optional.String plotoutline = None]
  19. [mixed: null|Array.String writer = None]
  20. [mixed: null|Array.String country = None]
  21. [Optional.Integer top250 = None]
  22. [Optional.String sorttitle = None]
  23. [Optional.String set = None]
  24. [mixed: null|Array.String showlink = None]
  25. [Optional.String thumbnail = None]
  26. [Optional.String fanart = None]
  27. [mixed: null|Array.String tag = None]
  28. [mixed: null|Media.Artwork.Set art = None]
  29. [mixed: null|Video.Resume resume = None]
  30. [Optional.Integer userrating = None]
  31. [Video.Ratings.Set ratings]
  32. [Optional.String dateadded = None]
  33. [Optional.String premiered = None] (linked with year. Overrides year)
  34. [mixed: null|Media.UniqueID.Set uniqueid = None]

Returns:

Type: string

VideoLibrary.SetMovieSetDetails

Update the given movie set with the given details
Permissions:

  • UpdateData

Parameters:

  1. Library.Id setid
  2. [Optional.String title = None]
  3. [mixed: null|Media.Artwork.Set art = None]
  4. [Optional.String plot = None]

Returns:

Type: string

VideoLibrary.SetMusicVideoDetails

Update the given music video with the given details
Permissions:

  • UpdateData

Parameters:

  1. Library.Id musicvideoid
  2. [Optional.String title = None]
  3. [Optional.Integer playcount = None]
  4. [Optional.Integer runtime = None] (Runtime in seconds)
  5. [mixed: null|Array.String director = None]
  6. [mixed: null|Array.String studio = None]
  7. [Optional.Integer year = None] (linked with premiered. Overridden by premiered parameter)
  8. [Optional.String plot = None]
  9. [Optional.String album = None]
  10. [mixed: null|Array.String artist = None]
  11. [mixed: null|Array.String genre = None]
  12. [Optional.Integer track = None]
  13. [Optional.String lastplayed = None]
  14. [Optional.String thumbnail = None]
  15. [Optional.String fanart = None]
  16. [mixed: null|Array.String tag = None]
  17. [mixed: null|Media.Artwork.Set art = None]
  18. [mixed: null|Video.Resume resume = None]
  19. [Optional.Number rating = None]
  20. [Optional.Integer userrating = None]
  21. [Optional.String dateadded = None]
  22. [Optional.String premiered = None] (linked with year. Overrides year)

Returns:

Type: string

VideoLibrary.SetSeasonDetails

Update the given season with the given details
Permissions:

  • UpdateData

Parameters:

  1. Library.Id seasonid
  2. [mixed: null|Media.Artwork.Set art = None]
  3. [Optional.Integer userrating = None]
  4. [Optional.String title = None]

Returns:

Type: string

VideoLibrary.SetTVShowDetails

Update the given tvshow with the given details
Permissions:

  • UpdateData

Parameters:

  1. Library.Id tvshowid
  2. [Optional.String title = None]
  3. [Optional.Integer playcount = None]
  4. [mixed: null|Array.String studio = None]
  5. [Optional.String plot = None]
  6. [mixed: null|Array.String genre = None]
  7. [Optional.Number rating = None]
  8. [Optional.String mpaa = None]
  9. [Optional.String imdbnumber = None]
  10. [Optional.String premiered = None]
  11. [Optional.String votes = None]
  12. [Optional.String lastplayed = None]
  13. [Optional.String originaltitle = None]
  14. [Optional.String sorttitle = None]
  15. [Optional.String episodeguide = None]
  16. [Optional.String thumbnail = None]
  17. [Optional.String fanart = None]
  18. [mixed: null|Array.String tag = None]
  19. [mixed: null|Media.Artwork.Set art = None]
  20. [Optional.Integer userrating = None]
  21. [Video.Ratings.Set ratings]
  22. [Optional.String dateadded = None]
  23. [Optional.Integer runtime = None] (Runtime in seconds)
  24. [Optional.String status = None] (Valid values: 'returning series', 'in production', 'planned', 'cancelled', 'ended')
  25. [mixed: null|Media.UniqueID.Set uniqueid = None]

Returns:

Type: string

XBMC

XBMC.GetInfoBooleans

Retrieve info booleans about Kodi and the system
Permissions:

  • ReadData

Parameters:

  1. array[string] booleans

Returns:

Type: object (Object containing key-value pairs of the retrieved info booleans)

XBMC.GetInfoLabels

Retrieve info labels about Kodi and the system
Permissions:

  • ReadData

Parameters:

  1. array[string] labels (See http://kodi.wiki/view/InfoLabels for a list of possible info labels)

Returns:

Type: object (Object containing key-value pairs of the retrieved info labels)

Global Types

Addon

Addon.Content

Type: string

Addon.Details

Extends:

Properties:

  • string addonid
  • [string author]
  • [mixed: boolean|string broken]
  • [array dependencies]
  • [mixed: boolean|string deprecated]
  • [string description]
  • [string disclaimer]
  • [boolean enabled]
  • [array extrainfo]
  • [string fanart]
  • [boolean installed]
  • [string name]
  • [string path]
  • [integer rating]
  • [string summary]
  • [string thumbnail]
  • Addon.Types type
  • [string version]

Addon.Fields

Extends:

Addon.Types

Type: string

Application

Application.Property.Name

Type: string

Application.Property.Value

Type: object
Properties:

  • [string language]
  • [boolean muted]
  • [string name]
  • [Array.String sorttokens]
  • [object version]
  • [integer volume]

Array

Array.Integer

Type: array

Array.String

Type: array

Audio

Audio.Album.ReleaseType

Type: string

Audio.Artist.Roles

Type: array

Audio.Contributors

Type: array

Audio.Details.Album

Extends:

Properties:

Audio.Details.Artist

Extends:

Properties:

Audio.Details.Base

Extends:

Properties:

Audio.Details.Genres

Type: array

Audio.Details.Media

Extends:

Properties:

  • [Array.String artist]
  • [Array.Integer artistid]
  • [string displayartist]
  • [Array.String musicbrainzalbumartistid]
  • [string originaldate]
  • [number rating]
  • [string releasedate]
  • [string sortartist]
  • [string title]
  • [integer userrating]
  • [integer votes]
  • [integer year]

Audio.Details.Role

Extends:

Properties:

Audio.Details.Song

Extends:

Properties:

  • [string album]
  • [Array.String albumartist]
  • [Array.Integer albumartistid]
  • [Library.Id albumid = -1]
  • [Audio.Album.ReleaseType albumreleasetype = album]
  • [any bitrate]
  • [any bpm]
  • [any channels]
  • [string comment]
  • [Audio.Contributors contributors]
  • [integer disc]
  • [string disctitle]
  • [string displaycomposer]
  • [string displayconductor]
  • [string displaylyricist]
  • [string displayorchestra]
  • [integer duration]
  • [string file]
  • [Array.Integer genreid]
  • [string lastplayed]
  • [string lyrics]
  • [string mood]
  • [Array.String musicbrainzartistid]
  • [string musicbrainztrackid]
  • [integer playcount]
  • [any samplerate]
  • Library.Id songid
  • [Array.Integer sourceid]
  • [integer track]

Audio.Fields.Album

Extends:

Audio.Fields.Artist

Extends:

Audio.Fields.Role

Extends:

Audio.Fields.Song

Extends:

Audio.Property.Name

Type: string

Audio.Property.Value

Type: object
Properties:

  • [string albumslastadded]
  • [string albumsmodified]
  • [string artistlinksupdated]
  • [string artistslastadded]
  • [string artistsmodified]
  • [string genreslastadded]
  • [string librarylastcleaned]
  • [string librarylastupdated]
  • [Library.Id missingartistid = -1]
  • [string songslastadded]
  • [string songsmodified]

Configuration

Configuration

Type: object
Properties:

Configuration.Notifications

Type: object
Properties:

  • boolean application
  • boolean audiolibrary
  • boolean gui
  • boolean input
  • boolean other
  • boolean player
  • boolean playlist
  • boolean pvr
  • boolean system
  • boolean videolibrary

Favourite

Favourite.Details.Favourite

Type: object
Properties:

  • [string path]
  • [string thumbnail]
  • string title
  • Favourite.Type type
  • [string window]
  • [string windowparameter]

Favourite.Fields.Favourite

Extends:

Favourite.Type

Type: string

Files

Files.Media

Type: string

GUI

GUI.Property.Name

Type: string

GUI.Property.Value

Type: object
Properties:

  • [object currentcontrol]
  • [object currentwindow]
  • [boolean fullscreen]
  • [object skin]
  • [GUI.Stereoscopy.Mode stereoscopicmode]

GUI.Stereoscopy.Mode

Type: object
Properties:

  • string label
  • string mode

GUI.Window

Type: string

Global

Global.IncrementDecrement

Type: string

Global.String.NotEmpty

Type: string

Global.Time

Type: object
Properties:

  • integer hours
  • integer milliseconds
  • integer minutes
  • integer seconds

Global.Toggle

Type: mixed

Global.Weekday

Type: string

Input

Input.Action

Type: string

Item

Item.CustomProperties

Type: object

Item.Details.Base

Type: object
Properties:

  • string label

Item.Fields.Base

Type: array

Library

Library.Details.Genre

Extends:

Properties:

Library.Details.Source

Extends:

Properties:

Library.Details.Tag

Extends:

Properties:

Library.Fields.Genre

Extends:

Library.Fields.Source

Extends:

Library.Fields.Tag

Extends:

Library.Id

Type: integer

List

List.Amount

Type: integer

List.Fields.All

Extends:

List.Fields.Files

Extends:

List.Filter.Albums

Type: mixed

List.Filter.Artists

Type: mixed

List.Filter.Episodes

Type: mixed

List.Filter.Fields.Albums

Type: string

List.Filter.Fields.Artists

Type: string

List.Filter.Fields.Episodes

Type: string

List.Filter.Fields.Movies

Type: string

List.Filter.Fields.MusicVideos

Type: string

List.Filter.Fields.Songs

Type: string

List.Filter.Fields.TVShows

Type: string

List.Filter.Fields.Textures

Type: string

List.Filter.Movies

Type: mixed

List.Filter.MusicVideos

Type: mixed

List.Filter.Operators

Type: string

List.Filter.Rule

Type: object
Properties:

List.Filter.Rule.Albums

Extends:

Properties:

List.Filter.Rule.Artists

Extends:

Properties:

List.Filter.Rule.Episodes

Extends:

Properties:

List.Filter.Rule.Movies

Extends:

Properties:

List.Filter.Rule.MusicVideos

Extends:

Properties:

List.Filter.Rule.Songs

Extends:

Properties:

List.Filter.Rule.TVShows

Extends:

Properties:

List.Filter.Rule.Textures

Extends:

Properties:

List.Filter.Songs

Type: mixed

List.Filter.TVShows

Type: mixed

List.Filter.Textures

Type: mixed

List.Item.All

Extends:

Properties:

  • [string channel]
  • [integer channelnumber]
  • [PVR.Channel.Type channeltype = tv]
  • [string endtime]
  • [boolean hidden]
  • [boolean locked]
  • [string starttime]
  • [integer subchannelnumber]

List.Item.Base

Extends:

Properties:

  • [string album]
  • [Array.String albumartist]
  • [Array.Integer albumartistid]
  • [Library.Id albumid = -1]
  • [string albumlabel]
  • [Audio.Album.ReleaseType albumreleasetype = album]
  • [string albumstatus]
  • [integer bitrate]
  • [integer bpm]
  • [Video.Cast cast]
  • [integer channels]
  • [string comment]
  • [boolean compilation]
  • [Audio.Contributors contributors]
  • [Array.String country]
  • [Item.CustomProperties customproperties]
  • [string description]
  • [integer disc]
  • [string disctitle]
  • [string displaycomposer]
  • [string displayconductor]
  • [string displaylyricist]
  • [string displayorchestra]
  • [integer duration]
  • [string dynpath]
  • [integer episode]
  • [string episodeguide]
  • [string firstaired]
  • [Library.Id id = -1]
  • [string imdbnumber]
  • [boolean isboxset]
  • [string lyrics]
  • [string mediapath]
  • [Array.String mood]
  • [string mpaa]
  • [Array.String musicbrainzartistid]
  • [string musicbrainztrackid]
  • [string originaldate]
  • [string originaltitle]
  • [string plotoutline]
  • [string premiered]
  • [string productioncode]
  • [string releasedate]
  • [Audio.Album.ReleaseType releasetype = album]
  • [integer samplerate]
  • [integer season]
  • [string set]
  • [Library.Id setid = -1]
  • [Array.String showlink]
  • [string showtitle]
  • [string sorttitle]
  • [integer specialsortepisode]
  • [integer specialsortseason]
  • [Array.String studio]
  • [Array.String style]
  • [Array.String tag]
  • [string tagline]
  • [Array.String theme]
  • [integer top250]
  • [integer totaldiscs]
  • [integer track]
  • [string trailer]
  • [Library.Id tvshowid = -1]
  • [string type = unknown]
  • [Media.UniqueID uniqueid]
  • [string votes]
  • [integer watchedepisodes]
  • [Array.String writer]

List.Item.File

Extends:

Properties:

  • string file
  • string filetype
  • [string lastmodified]
  • [string mimetype]
  • [integer size]

List.Items.Sources

Type: array

List.Limits

Type: object
Properties:

List.LimitsReturned

Type: object
Properties:

List.Sort

Type: object
Properties:

  • [boolean ignorearticle]
  • [string method = none]
  • [string order = ascending]
  • [boolean useartistsortname]

Media

Media.Artwork

Type: object
Properties:

Media.Artwork.Set

Type: object
Properties:

Media.Details.Base

Extends:

Properties:

  • [string fanart]
  • [string thumbnail]

Media.UniqueID

Type: object

Media.UniqueID.Set

Type: object

Notifications

Notifications.Item

Type: mixed

Notifications.Item.Type

Type: string

Optional

Optional.Boolean

Type: mixed

Optional.Integer

Type: mixed

Optional.Number

Type: mixed

Optional.String

Type: mixed

PVR

PVR.Channel.Type

Type: string

PVR.ChannelGroup.Id

Type: mixed

PVR.Details.Broadcast

Extends:

Properties:

  • Library.Id broadcastid
  • [string cast]
  • [Library.Id clientid = -1]
  • [string director]
  • [string endtime]
  • [string episodename]
  • [integer episodenum]
  • [integer episodepart]
  • [string firstaired]
  • [string genre]
  • [boolean hasrecording]
  • [boolean hasreminder]
  • [boolean hastimer]
  • [boolean hastimerrule]
  • [integer imdbnumber]
  • [boolean isactive]
  • [boolean isplayable]
  • [boolean isseries]
  • [string originaltitle]
  • [integer parentalrating]
  • [string plot]
  • [string plotoutline]
  • [integer progress]
  • [number progresspercentage]
  • [integer rating]
  • [string recording]
  • [integer runtime]
  • [string starttime]
  • [string thumbnail]
  • [string title]
  • [boolean wasactive]
  • [string writer]
  • [integer year]

PVR.Details.Channel

Extends:

Properties:

PVR.Details.ChannelGroup

Extends:

Properties:

PVR.Details.ChannelGroup.Extended

Extends:

Properties:

PVR.Details.Client

Extends:

Properties:

  • [string addonid]
  • Library.Id clientid
  • [boolean supportschannelgroups]
  • [boolean supportschannelscan]
  • [boolean supportsepg]
  • [boolean supportsradio]
  • [boolean supportsrecordings]
  • [boolean supportstimers]
  • [boolean supportstv]

PVR.Details.Recording

Extends:

Properties:

  • [Media.Artwork art]
  • [string channel]
  • [integer channeluid]
  • [Library.Id clientid = -1]
  • [string directory]
  • [string endtime]
  • [integer epgeventid]
  • [integer episode]
  • [string file]
  • [string genre]
  • [string icon]
  • [boolean isdeleted]
  • [integer lifetime]
  • [integer playcount]
  • [string plot]
  • [string plotoutline]
  • [boolean radio]
  • Library.Id recordingid
  • [Video.Resume resume]
  • [integer runtime]
  • [integer season]
  • [string showtitle]
  • [string starttime]
  • [string streamurl]
  • [string title]

PVR.Details.Timer

Extends:

Properties:

  • [Library.Id broadcastid = -1]
  • [Library.Id channelid = -1]
  • [Library.Id clientid = -1]
  • [string directory]
  • [boolean endanytime]
  • [integer endmargin]
  • [string endtime]
  • [string epgsearchstring]
  • [integer epguid]
  • [string file]
  • [string firstday]
  • [boolean fulltextepgsearch]
  • [boolean ismanual]
  • [boolean isradio]
  • [boolean isreadonly]
  • [boolean isreminder]
  • [boolean istimerrule]
  • [integer lifetime]
  • [integer maxrecordings]
  • [integer preventduplicateepisodes]
  • [integer priority]
  • [integer recordinggroup]
  • [integer runtime]
  • [boolean startanytime]
  • [integer startmargin]
  • [string starttime]
  • [PVR.TimerState state = unknown]
  • [string summary]
  • Library.Id timerid
  • [string title]
  • [array weekdays]

PVR.Fields.Broadcast

Extends:

PVR.Fields.Channel

Extends:

PVR.Fields.Client

Extends:

PVR.Fields.Recording

Extends:

PVR.Fields.Timer

Extends:

PVR.Property.Name

Type: string

PVR.Property.Value

Type: object
Properties:

  • [boolean available]
  • [boolean recording]
  • [boolean scanning]

PVR.TimerState

Type: string

Player

Player.Audio.Stream

Type: object
Properties:

  • integer bitrate
  • integer channels
  • string codec
  • integer index
  • boolean isdefault
  • boolean isimpaired
  • boolean isoriginal
  • string language
  • string name
  • integer samplerate

Player.CustomViewMode

Type: object
Properties:

Player.Id

Type: integer

Player.Notifications.Data

Type: object
Properties:

Player.Notifications.Player

Type: object
Properties:

Player.Notifications.Player.Seek

Extends:

Properties:

Player.Position.Percentage

Type: number

Player.Position.Time

Type: object
Properties:

  • [integer hours]
  • [integer milliseconds]
  • [integer minutes]
  • [integer seconds]

Player.Property.Name

Type: string

Player.Property.Value

Type: object
Properties:

Player.Repeat

Type: string

Player.Speed

Type: object
Properties:

  • [integer speed]

Player.Subtitle

Type: object
Properties:

  • integer index
  • boolean isdefault
  • boolean isforced
  • boolean isimpaired
  • string language
  • string name

Player.Type

Type: string

Player.Video.Stream

Type: object
Properties:

  • string codec
  • integer height
  • integer index
  • string language
  • string name
  • integer width

Player.ViewMode

Type: string

Playlist

Playlist.Id

Type: integer

Playlist.Item

Type: mixed

Playlist.Position

Type: integer

Playlist.Property.Name

Type: string

Playlist.Property.Value

Type: object
Properties:

Playlist.Type

Type: string

Profiles

Profiles.Details.Profile

Extends:

Properties:

  • [integer lockmode]
  • [string thumbnail]

Profiles.Fields.Profile

Extends:

Profiles.Password

Type: object
Properties:

  • [string encryption = md5]
  • string value

Setting

Setting.Details.Base

Type: object
Properties:

  • [string help]
  • string id
  • string label

Setting.Details.Category

Extends:

Properties:

  • [array groups]

Setting.Details.Control

Type: mixed

Setting.Details.ControlBase

Type: object
Properties:

  • boolean delayed
  • string format
  • string type

Setting.Details.ControlButton

Extends:

Properties:

  • string type

Setting.Details.ControlCheckmark

Extends:

Properties:

  • string format
  • string type

Setting.Details.ControlEdit

Extends:

Properties:

  • boolean hidden
  • string type
  • boolean verifynewvalue

Setting.Details.ControlHeading

Extends:

Properties:

  • [string heading]

Setting.Details.ControlLabel

Extends:

Properties:

  • string format
  • string type

Setting.Details.ControlList

Extends:

Properties:

  • boolean multiselect
  • string type

Setting.Details.ControlRange

Extends:

Properties:

  • string formatlabel
  • string formatvalue
  • string type

Setting.Details.ControlSlider

Extends:

Properties:

  • string formatlabel
  • boolean popup
  • string type

Setting.Details.ControlSpinner

Extends:

Properties:

  • [string formatlabel]
  • [string minimumlabel]
  • string type

Setting.Details.Group

Type: object
Properties:

  • string id
  • [array settings]

Setting.Details.Section

Extends:

Properties:

  • [array categories]

Setting.Details.Setting

Type: mixed

Setting.Details.SettingAction

Extends:

Properties:

  • string data

Setting.Details.SettingAddon

Extends:

Properties:

Setting.Details.SettingBase

Extends:

Properties:

Setting.Details.SettingBool

Extends:

Properties:

  • boolean default
  • boolean value

Setting.Details.SettingDate

Extends:

Setting.Details.SettingInt

Extends:

Properties:

  • integer default
  • [integer maximum]
  • [integer minimum]
  • [array options]
  • [integer step]
  • integer value

Setting.Details.SettingList

Extends:

Properties:

Setting.Details.SettingNumber

Extends:

Properties:

  • number default
  • number maximum
  • number minimum
  • number step
  • number value

Setting.Details.SettingPath

Extends:

Properties:

  • [array sources]
  • boolean writable

Setting.Details.SettingString

Extends:

Properties:

  • boolean allowempty
  • string default
  • [array options]
  • string value

Setting.Details.SettingTime

Extends:

Setting.Level

Type: string

Setting.Type

Type: string

Setting.Value

Type: mixed

Setting.Value.Extended

Type: mixed

Setting.Value.List

Type: array

System

System.Property.Name

Type: string

System.Property.Value

Type: object
Properties:

  • [boolean canhibernate]
  • [boolean canreboot]
  • [boolean canshutdown]
  • [boolean cansuspend]

Textures

Textures.Details.Size

Type: object
Properties:

  • [integer height]
  • [string lastused]
  • [integer size]
  • [integer usecount]
  • [integer width]

Textures.Details.Texture

Type: object
Properties:

  • [string cachedurl]
  • [string imagehash]
  • [string lasthashcheck]
  • [array sizes]
  • [Library.Id textureid = -1]
  • [string url]

Textures.Fields.Texture

Extends:

Video

Video.Cast

Type: array

Video.Details.Base

Extends:

Properties:

Video.Details.Episode

Extends:

Properties:

  • [Video.Cast cast]
  • [integer episode]
  • Library.Id episodeid
  • [string firstaired]
  • [string originaltitle]
  • [string productioncode]
  • [number rating]
  • [any ratings]
  • [integer season]
  • [Library.Id seasonid = -1]
  • [string showtitle]
  • [integer specialsortepisode]
  • [integer specialsortseason]
  • [Library.Id tvshowid = -1]
  • [Media.UniqueID uniqueid]
  • [integer userrating]
  • [string votes]
  • [Array.String writer]

Video.Details.File

Extends:

Properties:

Video.Details.Item

Extends:

Properties:

  • [string dateadded]
  • [string file]
  • [string lastplayed]
  • [string plot]

Video.Details.Media

Extends:

Properties:

  • [string title]

Video.Details.Movie

Extends:

Properties:

Video.Details.MovieSet

Extends:

Properties:

Video.Details.MovieSet.Extended

Extends:

Properties:

Video.Details.MusicVideo

Extends:

Properties:

Video.Details.Season

Extends:

Properties:

  • [integer episode]
  • integer season
  • Library.Id seasonid
  • [string showtitle]
  • [string title]
  • [Library.Id tvshowid = -1]
  • [integer userrating]
  • [integer watchedepisodes]

Video.Details.TVShow

Extends:

Properties:

  • [Video.Cast cast]
  • [integer episode]
  • [string episodeguide]
  • [Array.String genre]
  • [string imdbnumber]
  • [string mpaa]
  • [string originaltitle]
  • [string premiered]
  • [number rating]
  • [any ratings]
  • [integer runtime]
  • [integer season]
  • [string sorttitle]
  • [string status]
  • [Array.String studio]
  • [Array.String tag]
  • Library.Id tvshowid
  • [Media.UniqueID uniqueid]
  • [integer userrating]
  • [string votes]
  • [integer watchedepisodes]
  • [integer year]

Video.Fields.Episode

Extends:

Video.Fields.Movie

Extends:

Video.Fields.MovieSet

Extends:

Video.Fields.MusicVideo

Extends:

Video.Fields.Season

Extends:

Video.Fields.TVShow

Extends:

Video.Rating

Type: object
Properties:

  • [boolean default]
  • number rating
  • [integer votes]

Video.Ratings

Type: object

Video.Ratings.Set

Type: object

Video.Resume

Type: object
Properties:

  • [number position]
  • [number total]

Video.Streams

Type: object
Properties:

  • [array audio]
  • [array subtitle]
  • [array video]

Notifications

Application

Application.OnVolumeChanged

The volume of the application has changed.
Parameters:

  1. string sender
  2. object data:
    • boolean muted
    • integer volume

AudioLibrary

AudioLibrary.OnCleanFinished

The audio library has been cleaned.
Parameters:

  1. string sender
  2. string data

AudioLibrary.OnCleanStarted

An audio library clean operation has started.
Parameters:

  1. string sender
  2. string data

AudioLibrary.OnExport

An audio library export has finished.
Parameters:

  1. string sender
  2. [object data]:
    • [integer failcount = 0]
    • [string file = ""]

AudioLibrary.OnRemove

An audio item has been removed.
Parameters:

  1. string sender
  2. object data:

AudioLibrary.OnScanFinished

Scanning the audio library has been finished.
Parameters:

  1. string sender
  2. string data

AudioLibrary.OnScanStarted

An audio library scan has started.
Parameters:

  1. string sender
  2. string data

AudioLibrary.OnUpdate

An audio item has been updated.
Parameters:

  1. string sender
  2. object data:

GUI

GUI.OnDPMSActivated

Energy saving/DPMS has been activated.
Parameters:

  1. string sender
  2. string data

GUI.OnDPMSDeactivated

Energy saving/DPMS has been deactivated.
Parameters:

  1. string sender
  2. string data

GUI.OnScreensaverActivated

The screensaver has been activated.
Parameters:

  1. string sender
  2. string data

GUI.OnScreensaverDeactivated

The screensaver has been deactivated.
Parameters:

  1. string sender
  2. object data:
    • boolean shuttingdown

Input

Input.OnInputFinished

The user has provided the requested input.
Parameters:

  1. string sender
  2. string data

Input.OnInputRequested

The user is requested to provide some information.
Parameters:

  1. string sender
  2. object data:
    • string title
    • string type
    • string value

Player

Player.OnAVChange

Audio- or videostream has changed. If there is no ID available extra information will be provided.
Parameters:

  1. string sender
  2. Player.Notifications.Data data

Player.OnAVStart

Playback of a media item has been started and first frame is available. If there is no ID available extra information will be provided.
Parameters:

  1. string sender
  2. Player.Notifications.Data data

Player.OnPause

Playback of a media item has been paused. If there is no ID available extra information will be provided.
Parameters:

  1. string sender
  2. Player.Notifications.Data data

Player.OnPlay

Playback of a media item has been started or the playback speed has changed. If there is no ID available extra information will be provided.
Parameters:

  1. string sender
  2. Player.Notifications.Data data

Player.OnPropertyChanged

A property of the playing items has changed.
Parameters:

  1. string sender
  2. object data:

Player.OnResume

Playback of a media item has been resumed. If there is no ID available extra information will be provided.
Parameters:

  1. string sender
  2. Player.Notifications.Data data

Player.OnSeek

The playback position has been changed. If there is no ID available extra information will be provided.
Parameters:

  1. string sender
  2. object data:

Player.OnSpeedChanged

Speed of the playback of a media item has been changed. If there is no ID available extra information will be provided.
Parameters:

  1. string sender
  2. Player.Notifications.Data data

Player.OnStop

Playback of a media item has been stopped. If there is no ID available extra information will be provided.
Parameters:

  1. string sender
  2. object data:

Playlist

Playlist.OnAdd

A playlist item has been added.
Parameters:

  1. string sender
  2. object data:

Playlist.OnClear

A playlist item has been cleared.
Parameters:

  1. string sender
  2. object data:

Playlist.OnRemove

A playlist item has been removed.
Parameters:

  1. string sender
  2. object data:

System

System.OnLowBattery

The system is on low battery.
Parameters:

  1. string sender
  2. string data

System.OnQuit

Kodi will be closed.
Parameters:

  1. string sender
  2. object data:
    • integer exitcode

System.OnRestart

The system will be restarted.
Parameters:

  1. string sender
  2. string data

System.OnSleep

The system will be suspended.
Parameters:

  1. string sender
  2. string data

System.OnWake

The system woke up from suspension.
Parameters:

  1. string sender
  2. string data

VideoLibrary

VideoLibrary.OnCleanFinished

The video library has been cleaned.
Parameters:

  1. string sender
  2. string data

VideoLibrary.OnCleanStarted

A video library clean operation has started.
Parameters:

  1. string sender
  2. string data

VideoLibrary.OnExport

A video library export has finished.
Parameters:

  1. string sender
  2. [object data]:
    • [integer failcount = 0]
    • [string file = ""]
    • [string root = ""]

VideoLibrary.OnRefresh

The video library has been refreshed and a home screen reload might be necessary.
Parameters:

  1. string sender
  2. string data

VideoLibrary.OnRemove

A video item has been removed.
Parameters:

  1. string sender
  2. object data:

VideoLibrary.OnScanFinished

Scanning the video library has been finished.
Parameters:

  1. string sender
  2. string data

VideoLibrary.OnScanStarted

A video library scan has started.
Parameters:

  1. string sender
  2. string data

VideoLibrary.OnUpdate

A video item has been updated.
Parameters:

  1. string sender
  2. object data:

External links