JSON-RPC API v6 (Frodo)

JSON-RPC Pages
	Main JSON-RPC Page
	- v8 (Krypton)
	- v10 (Leia)
	- v12 (Matrix)
	- v13 (Nexus)
	- v14 (Omega)
	Examples
	All JSON-RPC Pages

Template:DevsHeader

Template:Frodo
Version 6 is a stable version of XBMC's JSON-RPC API and is published with the release of Eden. 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 XBMC's JSON-RPC API and can therefore also profit from additional features like notifications.

A rough and incomplete list of changes compared to version 4 can be found here. A more complete and detailed list can be found in the forum.

JSON-RPC 2.0 compatibility

Version	Method calls	Notifications (server-side)	Notifications (client-side)	Parameters by-name	Parameters by-position	Batch requests
Version 5	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 XBMC 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 XBMC JSON-RPC API is split up into namespaces, which contain methods that can be called. These namespaces are:

JSONRPC          A variety of standard JSONRPC calls
Player           Manages all available players
Playlist         Playlist modification
Files            Shares information
AudioLibrary     Audio Library information
VideoLibrary     Video Library information
Input            Allows limited navigation within XBMC
Application      Application information and control
System           System controls and information
XBMC             Dumping ground for very XBMC specific operations

Methods

Addons

Addons.ExecuteAddon

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

ExecuteAddon

Parameters:

string addonid
[ mixed params = null ]
[ boolean wait = False ]

Returns: string

JSON Schema Description

{
  "description": "Executes the given addon with the given parameters (if possible)", 
  "params": [
    {
      "name": "addonid", 
      "type": "string", 
      "required": true
    }, 
    {
      "name": "params", 
      "type": [
        {
          "type": "object", 
          "additionalProperties": {
            "type": "string", 
            "default": ""
          }
        }, 
        {
          "type": "array", 
          "items": {
            "type": "string"
          }
        }
      ], 
      "default": null
    }, 
    {
      "name": "wait", 
      "type": "boolean", 
      "default": false
    }
  ], 
  "returns": {
    "type": "string"
  }
}

Addons.GetAddonDetails

Gets the details of a specific addon
Permissions:

ReadData

Parameters:

string addonid
[ Addon.Fields properties ]

Returns:

Type: object
Properties:

Addon.Details addon
List.LimitsReturned limits

JSON Schema Description

{
  "description": "Gets the details of a specific addon", 
  "params": [
    {
      "name": "addonid", 
      "type": "string", 
      "required": true
    }, 
    {
      "$ref": "Addon.Fields", 
      "name": "properties"
    }
  ], 
  "returns": {
    "properties": {
      "addon": {
        "$ref": "Addon.Details", 
        "required": true
      }, 
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }
    }, 
    "type": "object"
  }
}

Addons.GetAddons

Gets all available addons
Permissions:

ReadData

Parameters:

[ Addon.Types type = "unknown" ]
[ Addon.Content content = "unknown" ]
[ mixed enabled = "all" ]
[ Addon.Fields properties ]
[ List.Limits limits ]

Returns:

Type: object
Properties:

List.LimitsReturned limits
[ Addon.Details[] addons ]

JSON Schema Description

{
  "description": "Gets all available addons", 
  "params": [
    {
      "$ref": "Addon.Types", 
      "name": "type", 
      "default": "unknown"
    }, 
    {
      "$ref": "Addon.Content", 
      "description": "Content provided by the addon. Only considered for plugins and scripts.", 
      "name": "content", 
      "default": "unknown"
    }, 
    {
      "name": "enabled", 
      "type": [
        {
          "type": "boolean"
        }, 
        {
          "type": "string", 
          "enums": [
            "all"
          ]
        }
      ], 
      "default": "all"
    }, 
    {
      "$ref": "Addon.Fields", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "addons": {
        "type": "array", 
        "items": {
          "$ref": "Addon.Details"
        }
      }
    }, 
    "type": "object"
  }
}

Addons.SetAddonEnabled

Enables/Disables a specific addon
Permissions:

ManageAddon

Parameters:

string addonid
Global.Toggle enabled

Returns: string

JSON Schema Description

{
  "description": "Enables/Disables a specific addon", 
  "params": [
    {
      "name": "addonid", 
      "type": "string", 
      "required": true
    }, 
    {
      "$ref": "Global.Toggle", 
      "name": "enabled", 
      "required": true
    }
  ], 
  "returns": {
    "type": "string"
  }
}

Application

Application.GetProperties

Retrieves the values of the given properties
Permissions:

ReadData

Parameters:

Application.Property.Name[] properties

Returns: Application.Property.Value

JSON Schema Description

{
  "description": "Retrieves the values of the given properties", 
  "params": [
    {
      "name": "properties", 
      "type": "array", 
      "required": true, 
      "items": {
        "$ref": "Application.Property.Name"
      }, 
      "uniqueItems": true
    }
  ], 
  "returns": {
    "$ref": "Application.Property.Value"
  }
}

Application.Quit

Quit application
Permissions:

ControlPower

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Quit application", "params": [], "returns": { "type": "string" } }

Application.SetMute

Toggle mute/unmute
Permissions:

ControlPlayback

Parameters:

Global.Toggle mute

Returns: boolean

JSON Schema Description
{ "description": "Toggle mute/unmute", "params": [ { "$ref": "Global.Toggle", "name": "mute", "required": true } ], "returns": { "description": "Mute state", "type": "boolean" } }

Application.SetVolume

Set the current volume
Permissions:

ControlPlayback

Parameters:

mixed volume

Returns: integer

JSON Schema Description

{
  "description": "Set the current volume", 
  "params": [
    {
      "name": "volume", 
      "type": [
        {
          "maximum": 100, 
          "type": "integer", 
          "minimum": 0
        }, 
        {
          "$ref": "Global.IncrementDecrement"
        }
      ], 
      "required": true
    }
  ], 
  "returns": {
    "type": "integer"
  }
}

AudioLibrary

AudioLibrary.Clean

Cleans the audio library from non-existent items
Permissions:

RemoveData

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Cleans the audio library from non-existent items", "params": [], "returns": { "type": "string" } }

AudioLibrary.Export

Exports all items from the audio library
Permissions:

WriteFile

Parameters:

[ mixed options ]

Returns: string

JSON Schema Description

{
  "description": "Exports all items from the audio library", 
  "params": [
    {
      "name": "options", 
      "type": [
        {
          "properties": {
            "path": {
              "description": "Path to the directory to where the data should be exported", 
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "overwrite": {
              "description": "Whether to overwrite existing exported files", 
              "type": "boolean", 
              "default": false
            }, 
            "images": {
              "description": "Whether to export thumbnails and fanart images", 
              "type": "boolean", 
              "default": false
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }
      ]
    }
  ], 
  "returns": {
    "type": "string"
  }
}

AudioLibrary.GetAlbumDetails

Retrieve details about a specific album
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

[ Audio.Details.Album albumdetails ]

JSON Schema Description

{
  "description": "Retrieve details about a specific album", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "albumid", 
      "required": true
    }, 
    {
      "$ref": "Audio.Fields.Album", 
      "name": "properties"
    }
  ], 
  "returns": {
    "properties": {
      "albumdetails": {
        "$ref": "Audio.Details.Album"
      }
    }, 
    "type": "object"
  }
}

AudioLibrary.GetAlbums

Retrieve all albums from specified artist or genre
Permissions:

ReadData

Parameters:

[ Audio.Fields.Album properties ]
[ List.Limits limits ]
[ List.Sort sort ]
[ mixed filter ]

Returns:

Type: object
Properties:

List.LimitsReturned limits
[ Audio.Details.Album[] albums ]

JSON Schema Description

{
  "description": "Retrieve all albums from specified artist or genre", 
  "params": [
    {
      "$ref": "Audio.Fields.Album", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }, 
    {
      "name": "filter", 
      "type": [
        {
          "properties": {
            "genreid": {
              "$ref": "Library.Id", 
              "required": true
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "genre": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "artistid": {
              "$ref": "Library.Id", 
              "required": true
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "artist": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "$ref": "List.Filter.Albums"
        }
      ]
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "albums": {
        "type": "array", 
        "items": {
          "$ref": "Audio.Details.Album"
        }
      }
    }, 
    "type": "object"
  }
}

AudioLibrary.GetArtistDetails

Retrieve details about a specific artist
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

[ Audio.Details.Artist artistdetails ]

JSON Schema Description

{
  "description": "Retrieve details about a specific artist", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "artistid", 
      "required": true
    }, 
    {
      "$ref": "Audio.Fields.Artist", 
      "name": "properties"
    }
  ], 
  "returns": {
    "properties": {
      "artistdetails": {
        "$ref": "Audio.Details.Artist"
      }
    }, 
    "type": "object"
  }
}

AudioLibrary.GetArtists

Retrieve all artists
Permissions:

ReadData

Parameters:

[ Optional.Boolean albumartistsonly = null ]
[ Audio.Fields.Artist properties ]
[ List.Limits limits ]
[ List.Sort sort ]
[ mixed filter ]

Returns:

Type: object
Properties:

[ Audio.Details.Artist[] artists ]
List.LimitsReturned limits

JSON Schema Description

{
  "description": "Retrieve all artists", 
  "params": [
    {
      "$ref": "Optional.Boolean", 
      "description": "Whether or not to include artists only appearing in compilations. If the parameter is not passed or is passed as null the GUI setting will be used", 
      "name": "albumartistsonly", 
      "default": null
    }, 
    {
      "$ref": "Audio.Fields.Artist", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }, 
    {
      "name": "filter", 
      "type": [
        {
          "properties": {
            "genreid": {
              "$ref": "Library.Id", 
              "required": true
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "genre": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "albumid": {
              "$ref": "Library.Id", 
              "required": true
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "album": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "songid": {
              "$ref": "Library.Id", 
              "required": true
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "$ref": "List.Filter.Artists"
        }
      ]
    }
  ], 
  "returns": {
    "properties": {
      "artists": {
        "type": "array", 
        "items": {
          "$ref": "Audio.Details.Artist"
        }
      }, 
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }
    }, 
    "type": "object"
  }
}

AudioLibrary.GetGenres

Retrieve all genres
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

List.LimitsReturned limits
Library.Details.Genre[] genres

JSON Schema Description

{
  "description": "Retrieve all genres", 
  "params": [
    {
      "$ref": "Library.Fields.Genre", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "genres": {
        "type": "array", 
        "required": true, 
        "items": {
          "$ref": "Library.Details.Genre"
        }
      }
    }, 
    "type": "object"
  }
}

AudioLibrary.GetRecentlyAddedAlbums

Retrieve recently added albums
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

List.LimitsReturned limits
[ Audio.Details.Album[] albums ]

JSON Schema Description

{
  "description": "Retrieve recently added albums", 
  "params": [
    {
      "$ref": "Audio.Fields.Album", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "albums": {
        "type": "array", 
        "items": {
          "$ref": "Audio.Details.Album"
        }
      }
    }, 
    "type": "object"
  }
}

AudioLibrary.GetRecentlyAddedSongs

Retrieve recently added songs
Permissions:

ReadData

Parameters:

[ List.Amount albumlimit = -1 ]
[ Audio.Fields.Song properties ]
[ List.Limits limits ]
[ List.Sort sort ]

Returns:

Type: object
Properties:

[ Audio.Details.Song[] songs ]
List.LimitsReturned limits

JSON Schema Description

{
  "description": "Retrieve recently added songs", 
  "params": [
    {
      "$ref": "List.Amount", 
      "description": "The amount of recently added albums from which to return the songs", 
      "name": "albumlimit", 
      "default": -1
    }, 
    {
      "$ref": "Audio.Fields.Song", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }
  ], 
  "returns": {
    "properties": {
      "songs": {
        "type": "array", 
        "items": {
          "$ref": "Audio.Details.Song"
        }
      }, 
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }
    }, 
    "type": "object"
  }
}

AudioLibrary.GetRecentlyPlayedAlbums

Retrieve recently played albums
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

List.LimitsReturned limits
[ Audio.Details.Album[] albums ]

JSON Schema Description

{
  "description": "Retrieve recently played albums", 
  "params": [
    {
      "$ref": "Audio.Fields.Album", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "albums": {
        "type": "array", 
        "items": {
          "$ref": "Audio.Details.Album"
        }
      }
    }, 
    "type": "object"
  }
}

AudioLibrary.GetRecentlyPlayedSongs

Retrieve recently played songs
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

[ Audio.Details.Song[] songs ]
List.LimitsReturned limits

JSON Schema Description

{
  "description": "Retrieve recently played songs", 
  "params": [
    {
      "$ref": "Audio.Fields.Song", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }
  ], 
  "returns": {
    "properties": {
      "songs": {
        "type": "array", 
        "items": {
          "$ref": "Audio.Details.Song"
        }
      }, 
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }
    }, 
    "type": "object"
  }
}

AudioLibrary.GetSongDetails

Retrieve details about a specific song
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

[ Audio.Details.Song songdetails ]

JSON Schema Description

{
  "description": "Retrieve details about a specific song", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "songid", 
      "required": true
    }, 
    {
      "$ref": "Audio.Fields.Song", 
      "name": "properties"
    }
  ], 
  "returns": {
    "properties": {
      "songdetails": {
        "$ref": "Audio.Details.Song"
      }
    }, 
    "type": "object"
  }
}

AudioLibrary.GetSongs

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

ReadData

Parameters:

[ Audio.Fields.Song properties ]
[ List.Limits limits ]
[ List.Sort sort ]
[ mixed filter ]

Returns:

Type: object
Properties:

[ Audio.Details.Song[] songs ]
List.LimitsReturned limits

JSON Schema Description

{
  "description": "Retrieve all songs from specified album, artist or genre", 
  "params": [
    {
      "$ref": "Audio.Fields.Song", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }, 
    {
      "name": "filter", 
      "type": [
        {
          "properties": {
            "genreid": {
              "$ref": "Library.Id", 
              "required": true
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "genre": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "artistid": {
              "$ref": "Library.Id", 
              "required": true
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "artist": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "albumid": {
              "$ref": "Library.Id", 
              "required": true
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "album": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "$ref": "List.Filter.Songs"
        }
      ]
    }
  ], 
  "returns": {
    "properties": {
      "songs": {
        "type": "array", 
        "items": {
          "$ref": "Audio.Details.Song"
        }
      }, 
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }
    }, 
    "type": "object"
  }
}

AudioLibrary.Scan

Scans the audio sources for new library items
Permissions:

UpdateData

Parameters:

[ string directory = "" ]

Returns: string

JSON Schema Description
{ "description": "Scans the audio sources for new library items", "params": [ { "name": "directory", "type": "string", "default": "" } ], "returns": { "type": "string" } }

AudioLibrary.SetAlbumDetails

Update the given album with the given details
Permissions:

UpdateData

Parameters:

Library.Id albumid
[ Optional.String title = null ]
[ mixed artist = null ]
[ Optional.String description = null ]
[ mixed genre = null ]
[ mixed theme = null ]
[ mixed mood = null ]
[ mixed style = null ]
[ Optional.String type = null ]
[ Optional.String albumlabel = null ]
[ Optional.Integer rating = null ]
[ Optional.Integer year = null ]

Returns: string

JSON Schema Description

{
  "description": "Update the given album with the given details", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "albumid", 
      "required": true
    }, 
    {
      "$ref": "Optional.String", 
      "name": "title", 
      "default": null
    }, 
    {
      "name": "artist", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "description", 
      "default": null
    }, 
    {
      "name": "genre", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "name": "theme", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "name": "mood", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "name": "style", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "type", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "albumlabel", 
      "default": null
    }, 
    {
      "$ref": "Optional.Integer", 
      "name": "rating", 
      "default": null
    }, 
    {
      "$ref": "Optional.Integer", 
      "name": "year", 
      "default": null
    }
  ], 
  "returns": {
    "type": "string"
  }
}

AudioLibrary.SetArtistDetails

Update the given artist with the given details
Permissions:

UpdateData

Parameters:

Library.Id artistid
[ Optional.String artist = null ]
[ mixed instrument = null ]
[ mixed style = null ]
[ mixed mood = null ]
[ Optional.String born = null ]
[ Optional.String formed = null ]
[ Optional.String description = null ]
[ mixed genre = null ]
[ Optional.String died = null ]
[ Optional.String disbanded = null ]
[ mixed yearsactive = null ]

Returns: string

JSON Schema Description

{
  "description": "Update the given artist with the given details", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "artistid", 
      "required": true
    }, 
    {
      "$ref": "Optional.String", 
      "name": "artist", 
      "default": null
    }, 
    {
      "name": "instrument", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "name": "style", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "name": "mood", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "born", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "formed", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "description", 
      "default": null
    }, 
    {
      "name": "genre", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "died", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "disbanded", 
      "default": null
    }, 
    {
      "name": "yearsactive", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }
  ], 
  "returns": {
    "type": "string"
  }
}

AudioLibrary.SetSongDetails

Update the given song with the given details
Permissions:

UpdateData

Parameters:

Library.Id songid
[ Optional.String title = null ]
[ mixed artist = null ]
[ mixed albumartist = null ]
[ mixed genre = null ]
[ Optional.Integer year = null ]
[ Optional.Integer rating = null ]
[ Optional.String album = null ]
[ Optional.Integer track = null ]
[ Optional.Integer disc = null ]
[ Optional.Integer duration = null ]
[ Optional.String comment = null ]
[ Optional.String musicbrainztrackid = null ]
[ Optional.String musicbrainzartistid = null ]
[ Optional.String musicbrainzalbumid = null ]
[ Optional.String musicbrainzalbumartistid = null ]

Returns: string

JSON Schema Description

{
  "description": "Update the given song with the given details", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "songid", 
      "required": true
    }, 
    {
      "$ref": "Optional.String", 
      "name": "title", 
      "default": null
    }, 
    {
      "name": "artist", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "name": "albumartist", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "name": "genre", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "$ref": "Optional.Integer", 
      "name": "year", 
      "default": null
    }, 
    {
      "$ref": "Optional.Integer", 
      "name": "rating", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "album", 
      "default": null
    }, 
    {
      "$ref": "Optional.Integer", 
      "name": "track", 
      "default": null
    }, 
    {
      "$ref": "Optional.Integer", 
      "name": "disc", 
      "default": null
    }, 
    {
      "$ref": "Optional.Integer", 
      "name": "duration", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "comment", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "musicbrainztrackid", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "musicbrainzartistid", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "musicbrainzalbumid", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "musicbrainzalbumartistid", 
      "default": null
    }
  ], 
  "returns": {
    "type": "string"
  }
}

Files

Files.Download

Downloads the given file
Permissions:

ReadData

Parameters:

string path

Returns: any

JSON Schema Description
{ "description": "Downloads the given file", "params": [ { "name": "path", "type": "string", "required": true } ], "returns": { "type": "any" } }

Files.GetDirectory

Get the directories and files in the given directory
Permissions:

ReadData

Parameters:

string directory
[ Files.Media media = "files" ]
[ List.Fields.Files properties ]
[ List.Sort sort ]

Returns:

Type: object
Properties:

List.LimitsReturned limits
List.Item.File[] files

JSON Schema Description

{
  "description": "Get the directories and files in the given directory", 
  "params": [
    {
      "name": "directory", 
      "type": "string", 
      "required": true
    }, 
    {
      "$ref": "Files.Media", 
      "name": "media", 
      "default": "files"
    }, 
    {
      "$ref": "List.Fields.Files", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "files": {
        "type": "array", 
        "required": true, 
        "items": {
          "$ref": "List.Item.File"
        }
      }
    }, 
    "type": "object"
  }
}

Files.GetFileDetails

Get details for a specific file
Permissions:

ReadData

Parameters:

string file
[ Files.Media media = "files" ]
[ List.Fields.Files properties ]

Returns:

Type: object
Properties:

List.Item.File filedetails

JSON Schema Description

{
  "description": "Get details for a specific file", 
  "params": [
    {
      "description": "Full path to the file", 
      "type": "string", 
      "required": true, 
      "name": "file"
    }, 
    {
      "$ref": "Files.Media", 
      "name": "media", 
      "default": "files"
    }, 
    {
      "$ref": "List.Fields.Files", 
      "name": "properties"
    }
  ], 
  "returns": {
    "properties": {
      "filedetails": {
        "$ref": "List.Item.File", 
        "required": true
      }
    }, 
    "type": "object"
  }
}

Files.GetSources

Get the sources of the media windows
Permissions:

ReadData

Parameters:

Files.Media media
[ List.Limits limits ]
[ List.Sort sort ]

Returns:

Type: object
Properties:

List.LimitsReturned limits
List.Items.Sources sources

JSON Schema Description

{
  "description": "Get the sources of the media windows", 
  "params": [
    {
      "$ref": "Files.Media", 
      "name": "media", 
      "required": true
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "sources": {
        "$ref": "List.Items.Sources", 
        "required": true
      }
    }, 
    "type": "object"
  }
}

Files.PrepareDownload

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

ReadData

Parameters:

string path

Returns:

Type: object
Properties:

any details
string protocol
string mode

JSON Schema Description

{
  "description": "Provides a way to download a given file (e.g. providing an URL to the real file location)", 
  "params": [
    {
      "name": "path", 
      "type": "string", 
      "required": true
    }
  ], 
  "returns": {
    "properties": {
      "details": {
        "description": "Transport specific details on how/from where to download the given file", 
        "type": "any", 
        "required": true
      }, 
      "protocol": {
        "required": true, 
        "type": "string", 
        "enums": [
          "http"
        ]
      }, 
      "mode": {
        "required": true, 
        "description": "Direct mode allows using Files.Download whereas redirect mode requires the usage of a different protocol", 
        "type": "string", 
        "enums": [
          "redirect", 
          "direct"
        ]
      }
    }, 
    "type": "object"
  }
}

GUI

GUI.ActivateWindow

Activates the given window
Permissions:

ControlGUI

Parameters:

GUI.Window window
[ array[1..X] parameters ]

Returns: string

JSON Schema Description

{
  "description": "Activates the given window", 
  "params": [
    {
      "$ref": "GUI.Window", 
      "name": "window", 
      "required": true
    }, 
    {
      "name": "parameters", 
      "type": "array", 
      "items": {
        "type": "string", 
        "minLength": 1
      }, 
      "minItems": 1
    }
  ], 
  "returns": {
    "type": "string"
  }
}

GUI.GetProperties

Retrieves the values of the given properties
Permissions:

ReadData

Parameters:

GUI.Property.Name[] properties

Returns: GUI.Property.Value

JSON Schema Description

{
  "description": "Retrieves the values of the given properties", 
  "params": [
    {
      "name": "properties", 
      "type": "array", 
      "required": true, 
      "items": {
        "$ref": "GUI.Property.Name"
      }, 
      "uniqueItems": true
    }
  ], 
  "returns": {
    "$ref": "GUI.Property.Value"
  }
}

GUI.SetFullscreen

Toggle fullscreen/GUI
Permissions:

ControlGUI

Parameters:

Global.Toggle fullscreen

Returns: boolean

JSON Schema Description
{ "description": "Toggle fullscreen/GUI", "params": [ { "$ref": "Global.Toggle", "name": "fullscreen", "required": true } ], "returns": { "description": "Fullscreen state", "type": "boolean" } }

GUI.ShowNotification

Shows a GUI notification
Permissions:

ControlGUI

Parameters:

string title
string message
[ mixed image = "" ]
[ integer displaytime = 5000 ]

Returns: string

JSON Schema Description

{
  "description": "Shows a GUI notification", 
  "params": [
    {
      "name": "title", 
      "type": "string", 
      "required": true
    }, 
    {
      "name": "message", 
      "type": "string", 
      "required": true
    }, 
    {
      "name": "image", 
      "type": [
        {
          "type": "string", 
          "enums": [
            "info", 
            "warning", 
            "error"
          ]
        }, 
        {
          "type": "string"
        }
      ], 
      "default": ""
    }, 
    {
      "description": "The time in milliseconds the notification will be visible", 
      "type": "integer", 
      "minimum": 1500, 
      "name": "displaytime", 
      "default": 5000
    }
  ], 
  "returns": {
    "type": "string"
  }
}

Input

Input.Back

Goes back in GUI
Permissions:

Navigate

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Goes back in GUI", "params": [], "returns": { "type": "string" } }

Input.ContextMenu

Shows the context menu
Permissions:

Navigate

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Shows the context menu", "params": [], "returns": { "type": "string" } }

Input.Down

Navigate down in GUI
Permissions:

Navigate

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Navigate down in GUI", "params": [], "returns": { "type": "string" } }

Input.ExecuteAction

Execute a specific action
Permissions:

Navigate

Parameters:

Input.Action action

Returns: string

JSON Schema Description
{ "description": "Execute a specific action", "params": [ { "$ref": "Input.Action", "name": "action", "required": true } ], "returns": { "type": "string" } }

Input.Home

Goes to home window in GUI
Permissions:

Navigate

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Goes to home window in GUI", "params": [], "returns": { "type": "string" } }

Input.Info

Shows the information dialog
Permissions:

Navigate

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Shows the information dialog", "params": [], "returns": { "type": "string" } }

Input.Left

Navigate left in GUI
Permissions:

Navigate

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Navigate left in GUI", "params": [], "returns": { "type": "string" } }

Input.Right

Navigate right in GUI
Permissions:

Navigate

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Navigate right in GUI", "params": [], "returns": { "type": "string" } }

Input.Select

Select current item in GUI
Permissions:

Navigate

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Select current item in GUI", "params": [], "returns": { "type": "string" } }

Input.SendText

Send a generic (unicode) text
Permissions:

Navigate

Parameters:

string text
[ boolean done = True ]

Returns: string

JSON Schema Description

{
  "description": "Send a generic (unicode) text", 
  "params": [
    {
      "description": "Unicode text", 
      "type": "string", 
      "required": true, 
      "name": "text"
    }, 
    {
      "description": "Whether this is the whole input or not (closes an open input dialog if true).", 
      "type": "boolean", 
      "name": "done", 
      "default": true
    }
  ], 
  "returns": {
    "type": "string"
  }
}

Input.ShowCodec

Show codec information of the playing item
Permissions:

Navigate

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Show codec information of the playing item", "params": [], "returns": { "type": "string" } }

Input.ShowOSD

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

Navigate

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Show the on-screen display for the current player", "params": [], "returns": { "type": "string" } }

Input.Up

Navigate up in GUI
Permissions:

Navigate

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Navigate up in GUI", "params": [], "returns": { "type": "string" } }

JSONRPC

JSONRPC.GetConfiguration

Get client-specific configurations
Permissions:

ReadData

Parameters: None
Returns: Configuration

JSON Schema Description
{ "description": "Get client-specific configurations", "params": [], "returns": { "$ref": "Configuration" } }

JSONRPC.Introspect

Enumerates all actions and descriptions
Permissions:

ReadData

Parameters:

[ boolean getdescriptions = True ]
[ boolean getmetadata = False ]
[ boolean filterbytransport = True ]
[ object filter ]

Properties:

[ boolean getreferences = True ]
string id
string type

Returns:

Type: object

JSON Schema Description

{
  "description": "Enumerates all actions and descriptions", 
  "params": [
    {
      "name": "getdescriptions", 
      "type": "boolean", 
      "default": true
    }, 
    {
      "name": "getmetadata", 
      "type": "boolean", 
      "default": false
    }, 
    {
      "name": "filterbytransport", 
      "type": "boolean", 
      "default": true
    }, 
    {
      "name": "filter", 
      "type": "object", 
      "properties": {
        "getreferences": {
          "description": "Whether or not to print the schema for referenced types", 
          "type": "boolean", 
          "default": true
        }, 
        "id": {
          "description": "Name of a namespace, method or type", 
          "type": "string", 
          "required": true
        }, 
        "type": {
          "required": true, 
          "description": "Type of the given name", 
          "type": "string", 
          "enums": [
            "method", 
            "namespace", 
            "type", 
            "notification"
          ]
        }
      }
    }
  ], 
  "returns": {
    "type": "object", 
    "additionalProperties": false
  }
}

JSONRPC.NotifyAll

Notify all other connected clients
Permissions:

ReadData

Parameters:

string sender
string message
[ any data = null ]

Returns: any

JSON Schema Description

{
  "description": "Notify all other connected clients", 
  "params": [
    {
      "name": "sender", 
      "type": "string", 
      "required": true
    }, 
    {
      "name": "message", 
      "type": "string", 
      "required": true
    }, 
    {
      "name": "data", 
      "type": "any", 
      "default": null
    }
  ], 
  "returns": {
    "type": "any"
  }
}

JSONRPC.Permission

Retrieve the clients permissions
Permissions:

ReadData

Parameters: None
Returns:

Type: object
Properties:

boolean controlpower
boolean controlsystem
boolean controlnotify
boolean controlpvr
boolean manageaddon
boolean updatedata
boolean writefile
boolean executeaddon
boolean readdata
boolean controlplayback
boolean controlgui
boolean navigate
boolean removedata

JSON Schema Description

{
  "description": "Retrieve the clients permissions", 
  "params": [], 
  "returns": {
    "properties": {
      "controlpower": {
        "type": "boolean", 
        "required": true
      }, 
      "controlsystem": {
        "type": "boolean", 
        "required": true
      }, 
      "controlnotify": {
        "type": "boolean", 
        "required": true
      }, 
      "controlpvr": {
        "type": "boolean", 
        "required": true
      }, 
      "manageaddon": {
        "type": "boolean", 
        "required": true
      }, 
      "updatedata": {
        "type": "boolean", 
        "required": true
      }, 
      "writefile": {
        "type": "boolean", 
        "required": true
      }, 
      "executeaddon": {
        "type": "boolean", 
        "required": true
      }, 
      "readdata": {
        "type": "boolean", 
        "required": true
      }, 
      "controlplayback": {
        "type": "boolean", 
        "required": true
      }, 
      "controlgui": {
        "type": "boolean", 
        "required": true
      }, 
      "navigate": {
        "type": "boolean", 
        "required": true
      }, 
      "removedata": {
        "type": "boolean", 
        "required": true
      }
    }, 
    "type": "object"
  }
}

JSONRPC.Ping

Ping responder
Permissions:

ReadData

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Ping responder", "params": [], "returns": { "type": "string" } }

JSONRPC.SetConfiguration

Change the client-specific configuration
Permissions:

ControlNotify

Parameters:

[ object notifications ]

Properties:

[ Optional.Boolean videolibrary = null ]
[ Optional.Boolean system = null ]
[ Optional.Boolean player = null ]
[ Optional.Boolean gui = null ]
[ Optional.Boolean input = null ]
[ Optional.Boolean audiolibrary = null ]
[ Optional.Boolean other = null ]
[ Optional.Boolean playlist = null ]
[ Optional.Boolean application = null ]

Returns: Configuration

JSON Schema Description

{
  "description": "Change the client-specific configuration", 
  "params": [
    {
      "name": "notifications", 
      "type": "object", 
      "properties": {
        "videolibrary": {
          "$ref": "Optional.Boolean", 
          "default": null
        }, 
        "system": {
          "$ref": "Optional.Boolean", 
          "default": null
        }, 
        "player": {
          "$ref": "Optional.Boolean", 
          "default": null
        }, 
        "gui": {
          "$ref": "Optional.Boolean", 
          "default": null
        }, 
        "input": {
          "$ref": "Optional.Boolean", 
          "default": null
        }, 
        "audiolibrary": {
          "$ref": "Optional.Boolean", 
          "default": null
        }, 
        "other": {
          "$ref": "Optional.Boolean", 
          "default": null
        }, 
        "playlist": {
          "$ref": "Optional.Boolean", 
          "default": null
        }, 
        "application": {
          "$ref": "Optional.Boolean", 
          "default": null
        }
      }
    }
  ], 
  "returns": {
    "$ref": "Configuration"
  }
}

JSONRPC.Version

Retrieve the jsonrpc protocol version
Permissions:

ReadData

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Retrieve the jsonrpc protocol version", "params": [], "returns": { "type": "string" } }

PVR

PVR.GetChannelDetails

Retrieves the details of a specific channel
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

[ PVR.Details.Channel channeldetails ]

JSON Schema Description

{
  "description": "Retrieves the details of a specific channel", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "channelid", 
      "required": true
    }, 
    {
      "$ref": "PVR.Fields.Channel", 
      "name": "properties"
    }
  ], 
  "returns": {
    "properties": {
      "channeldetails": {
        "$ref": "PVR.Details.Channel"
      }
    }, 
    "type": "object"
  }
}

PVR.GetChannelGroupDetails

Retrieves the details of a specific channel group
Permissions:

ReadData

Parameters:

PVR.ChannelGroup.Id channelgroupid
[ object channels ]

Properties:

[ List.Limits limits ]
[ PVR.Fields.Channel properties ]

Returns:

Type: object
Properties:

[ PVR.Details.ChannelGroup.Extended channelgroupdetails ]

JSON Schema Description

{
  "description": "Retrieves the details of a specific channel group", 
  "params": [
    {
      "$ref": "PVR.ChannelGroup.Id", 
      "name": "channelgroupid", 
      "required": true
    }, 
    {
      "name": "channels", 
      "type": "object", 
      "properties": {
        "limits": {
          "$ref": "List.Limits"
        }, 
        "properties": {
          "$ref": "PVR.Fields.Channel"
        }
      }
    }
  ], 
  "returns": {
    "properties": {
      "channelgroupdetails": {
        "$ref": "PVR.Details.ChannelGroup.Extended"
      }
    }, 
    "type": "object"
  }
}

PVR.GetChannelGroups

Retrieves the channel groups for the specified type
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

List.LimitsReturned limits
PVR.Details.ChannelGroup[] channelgroups

JSON Schema Description

{
  "description": "Retrieves the channel groups for the specified type", 
  "params": [
    {
      "$ref": "PVR.Channel.Type", 
      "name": "channeltype", 
      "required": true
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "channelgroups": {
        "type": "array", 
        "required": true, 
        "items": {
          "$ref": "PVR.Details.ChannelGroup"
        }
      }
    }, 
    "type": "object"
  }
}

PVR.GetChannels

Retrieves the channel list
Permissions:

ReadData

Parameters:

PVR.ChannelGroup.Id channelgroupid
[ PVR.Fields.Channel properties ]
[ List.Limits limits ]

Returns:

Type: object
Properties:

List.LimitsReturned limits
PVR.Details.Channel[] channels

JSON Schema Description

{
  "description": "Retrieves the channel list", 
  "params": [
    {
      "$ref": "PVR.ChannelGroup.Id", 
      "name": "channelgroupid", 
      "required": true
    }, 
    {
      "$ref": "PVR.Fields.Channel", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "channels": {
        "type": "array", 
        "required": true, 
        "items": {
          "$ref": "PVR.Details.Channel"
        }
      }
    }, 
    "type": "object"
  }
}

PVR.GetProperties

Retrieves the values of the given properties
Permissions:

ReadData

Parameters:

PVR.Property.Name[] properties

Returns: PVR.Property.Value

JSON Schema Description

{
  "description": "Retrieves the values of the given properties", 
  "params": [
    {
      "name": "properties", 
      "type": "array", 
      "required": true, 
      "items": {
        "$ref": "PVR.Property.Name"
      }, 
      "uniqueItems": true
    }
  ], 
  "returns": {
    "$ref": "PVR.Property.Value"
  }
}

PVR.Record

Toggle recording of a channel
Permissions:

ControlPVR

Parameters:

[ Global.Toggle record = "toggle" ]
[ mixed channel = "current" ]

Returns: string

JSON Schema Description

{
  "description": "Toggle recording of a channel", 
  "params": [
    {
      "$ref": "Global.Toggle", 
      "name": "record", 
      "default": "toggle"
    }, 
    {
      "name": "channel", 
      "type": [
        {
          "type": "string", 
          "enums": [
            "current"
          ]
        }, 
        {
          "$ref": "Library.Id"
        }
      ], 
      "default": "current"
    }
  ], 
  "returns": {
    "type": "string"
  }
}

PVR.Scan

Starts a channel scan
Permissions:

ControlPVR

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Starts a channel scan", "params": [], "returns": { "type": "string" } }

Player

Player.GetActivePlayers

Returns all active players
Permissions:

ReadData

Parameters: None
Returns:

Type: array

JSON Schema Description

{
  "description": "Returns all active players", 
  "params": [], 
  "returns": {
    "type": "array", 
    "items": {
      "properties": {
        "type": {
          "$ref": "Player.Type", 
          "required": true
        }, 
        "playerid": {
          "$ref": "Player.Id", 
          "required": true
        }
      }, 
      "type": "object"
    }, 
    "uniqueItems": true
  }
}

Player.GetItem

Retrieves the currently played item
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

List.Item.All item

JSON Schema Description

{
  "description": "Retrieves the currently played item", 
  "params": [
    {
      "$ref": "Player.Id", 
      "name": "playerid", 
      "required": true
    }, 
    {
      "$ref": "List.Fields.All", 
      "name": "properties"
    }
  ], 
  "returns": {
    "properties": {
      "item": {
        "$ref": "List.Item.All", 
        "required": true
      }
    }, 
    "type": "object"
  }
}

Player.GetProperties

Retrieves the values of the given properties
Permissions:

ReadData

Parameters:

Player.Id playerid
Player.Property.Name[] properties

Returns: Player.Property.Value

JSON Schema Description

{
  "description": "Retrieves the values of the given properties", 
  "params": [
    {
      "$ref": "Player.Id", 
      "name": "playerid", 
      "required": true
    }, 
    {
      "name": "properties", 
      "type": "array", 
      "required": true, 
      "items": {
        "$ref": "Player.Property.Name"
      }, 
      "uniqueItems": true
    }
  ], 
  "returns": {
    "$ref": "Player.Property.Value"
  }
}

Player.GoTo

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

ControlPlayback

Parameters:

Player.Id playerid
mixed to

Returns: string

JSON Schema Description

{
  "description": "Go to previous/next/specific item in the playlist", 
  "params": [
    {
      "$ref": "Player.Id", 
      "name": "playerid", 
      "required": true
    }, 
    {
      "name": "to", 
      "type": [
        {
          "type": "string", 
          "enums": [
            "previous", 
            "next"
          ]
        }, 
        {
          "$ref": "Playlist.Position", 
          "description": "position in playlist"
        }
      ], 
      "required": true
    }
  ], 
  "returns": {
    "type": "string"
  }
}

Player.Move

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

ControlPlayback

Parameters:

Player.Id playerid
string direction

Returns: string

JSON Schema Description

{
  "description": "If picture is zoomed move viewport left/right/up/down otherwise skip previous/next", 
  "params": [
    {
      "$ref": "Player.Id", 
      "name": "playerid", 
      "required": true
    }, 
    {
      "required": true, 
      "name": "direction", 
      "type": "string", 
      "enums": [
        "left", 
        "right", 
        "up", 
        "down"
      ]
    }
  ], 
  "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:

[ mixed item ]
[ object options ]

Properties:

[ mixed resume = False ]
[ Optional.Boolean shuffled = null ]
[ mixed repeat = null ]

Returns: string

JSON Schema Description

{
  "description": "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.", 
  "params": [
    {
      "name": "item", 
      "type": [
        {
          "properties": {
            "playlistid": {
              "$ref": "Playlist.Id", 
              "required": true
            }, 
            "position": {
              "$ref": "Playlist.Position", 
              "default": 0
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "$ref": "Playlist.Item"
        }, 
        {
          "properties": {
            "recursive": {
              "type": "boolean", 
              "default": true
            }, 
            "random": {
              "description": "Deprecated, use the shuffled property of the options parameter instead", 
              "type": "boolean", 
              "default": true
            }, 
            "path": {
              "type": "string", 
              "required": true
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "partymode": {
              "type": [
                {
                  "type": "string", 
                  "enums": [
                    "music", 
                    "video"
                  ]
                }, 
                {
                  "description": "Path to a smartplaylist (*.xsp) file", 
                  "type": "string", 
                  "minLength": 5
                }
              ], 
              "default": ""
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "channelid": {
              "$ref": "Library.Id", 
              "required": true
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }
      ]
    }, 
    {
      "name": "options", 
      "type": "object", 
      "properties": {
        "resume": {
          "type": [
            {
              "description": "Whether to resume from the resume point or not", 
              "type": "boolean"
            }, 
            {
              "$ref": "Player.Position.Percentage", 
              "description": "Percentage value to start from"
            }, 
            {
              "$ref": "Player.Position.Time", 
              "description": "Time to start from"
            }
          ], 
          "default": false
        }, 
        "shuffled": {
          "$ref": "Optional.Boolean", 
          "default": null
        }, 
        "repeat": {
          "type": [
            {
              "type": "null"
            }, 
            {
              "$ref": "Player.Repeat"
            }
          ], 
          "default": null
        }
      }, 
      "additionalProperties": false
    }
  ], 
  "returns": {
    "type": "string"
  }
}

Player.PlayPause

Pauses or unpause playback and returns the new state
Permissions:

ControlPlayback

Parameters:

Player.Id playerid
[ Global.Toggle play = "toggle" ]

Returns: Player.Speed

JSON Schema Description

{
  "description": "Pauses or unpause playback and returns the new state", 
  "params": [
    {
      "$ref": "Player.Id", 
      "name": "playerid", 
      "required": true
    }, 
    {
      "$ref": "Global.Toggle", 
      "name": "play", 
      "default": "toggle"
    }
  ], 
  "returns": {
    "$ref": "Player.Speed"
  }
}

Player.Rotate

Rotates current picture
Permissions:

ControlPlayback

Parameters:

Player.Id playerid
[ string value = "clockwise" ]

Returns: string

JSON Schema Description

{
  "description": "Rotates current picture", 
  "params": [
    {
      "$ref": "Player.Id", 
      "name": "playerid", 
      "required": true
    }, 
    {
      "name": "value", 
      "type": "string", 
      "enums": [
        "clockwise", 
        "counterclockwise"
      ], 
      "default": "clockwise"
    }
  ], 
  "returns": {
    "type": "string"
  }
}

Player.Seek

Seek through the playing item
Permissions:

ControlPlayback

Parameters:

Player.Id playerid
mixed value

Returns:

Type: object
Properties:

[ Global.Time time ]
[ Player.Position.Percentage percentage = 0 ]
[ Global.Time totaltime ]

JSON Schema Description

{
  "description": "Seek through the playing item", 
  "params": [
    {
      "$ref": "Player.Id", 
      "name": "playerid", 
      "required": true
    }, 
    {
      "name": "value", 
      "type": [
        {
          "$ref": "Player.Position.Percentage", 
          "description": "Percentage value to seek to"
        }, 
        {
          "$ref": "Player.Position.Time", 
          "description": "Time to seek to"
        }, 
        {
          "description": "Seek by predefined jumps", 
          "type": "string", 
          "enums": [
            "smallforward", 
            "smallbackward", 
            "bigforward", 
            "bigbackward"
          ]
        }
      ], 
      "required": true
    }
  ], 
  "returns": {
    "properties": {
      "time": {
        "$ref": "Global.Time"
      }, 
      "percentage": {
        "$ref": "Player.Position.Percentage", 
        "default": 0
      }, 
      "totaltime": {
        "$ref": "Global.Time"
      }
    }, 
    "type": "object"
  }
}

Player.SetAudioStream

Set the audio stream played by the player
Permissions:

ControlPlayback

Parameters:

Player.Id playerid
mixed stream

Returns: string

JSON Schema Description

{
  "description": "Set the audio stream played by the player", 
  "params": [
    {
      "$ref": "Player.Id", 
      "name": "playerid", 
      "required": true
    }, 
    {
      "name": "stream", 
      "type": [
        {
          "type": "string", 
          "enums": [
            "previous", 
            "next"
          ]
        }, 
        {
          "description": "Index of the audio stream to play", 
          "type": "integer", 
          "minimum": 0
        }
      ], 
      "required": true
    }
  ], 
  "returns": {
    "type": "string"
  }
}

Player.SetPartymode

Turn partymode on or off
Permissions:

ControlPlayback

Parameters:

Player.Id playerid
Global.Toggle partymode

Returns: string

JSON Schema Description

{
  "description": "Turn partymode on or off", 
  "params": [
    {
      "$ref": "Player.Id", 
      "name": "playerid", 
      "required": true
    }, 
    {
      "$ref": "Global.Toggle", 
      "name": "partymode", 
      "required": true
    }
  ], 
  "returns": {
    "type": "string"
  }
}

Player.SetRepeat

Set the repeat mode of the player
Permissions:

ControlPlayback

Parameters:

Player.Id playerid
mixed repeat

Returns: string

JSON Schema Description

{
  "description": "Set the repeat mode of the player", 
  "params": [
    {
      "$ref": "Player.Id", 
      "name": "playerid", 
      "required": true
    }, 
    {
      "name": "repeat", 
      "type": [
        {
          "$ref": "Player.Repeat"
        }, 
        {
          "type": "string", 
          "enums": [
            "cycle"
          ]
        }
      ], 
      "required": true
    }
  ], 
  "returns": {
    "type": "string"
  }
}

Player.SetShuffle

Shuffle/Unshuffle items in the player
Permissions:

ControlPlayback

Parameters:

Player.Id playerid
Global.Toggle shuffle

Returns: string

JSON Schema Description

{
  "description": "Shuffle/Unshuffle items in the player", 
  "params": [
    {
      "$ref": "Player.Id", 
      "name": "playerid", 
      "required": true
    }, 
    {
      "$ref": "Global.Toggle", 
      "name": "shuffle", 
      "required": true
    }
  ], 
  "returns": {
    "type": "string"
  }
}

Player.SetSpeed

Set the speed of the current playback
Permissions:

ControlPlayback

Parameters:

Player.Id playerid
mixed speed

Returns: Player.Speed

JSON Schema Description

{
  "description": "Set the speed of the current playback", 
  "params": [
    {
      "$ref": "Player.Id", 
      "name": "playerid", 
      "required": true
    }, 
    {
      "name": "speed", 
      "type": [
        {
          "type": "integer", 
          "enums": [
            -32, 
            -16, 
            -8, 
            -4, 
            -2, 
            -1, 
            0, 
            1, 
            2, 
            4, 
            8, 
            16, 
            32
          ]
        }, 
        {
          "$ref": "Global.IncrementDecrement"
        }
      ], 
      "required": true
    }
  ], 
  "returns": {
    "$ref": "Player.Speed"
  }
}

Player.SetSubtitle

Set the subtitle displayed by the player
Permissions:

ControlPlayback

Parameters:

Player.Id playerid
mixed subtitle
[ boolean enable = False ]

Returns: string

JSON Schema Description

{
  "description": "Set the subtitle displayed by the player", 
  "params": [
    {
      "$ref": "Player.Id", 
      "name": "playerid", 
      "required": true
    }, 
    {
      "name": "subtitle", 
      "type": [
        {
          "type": "string", 
          "enums": [
            "previous", 
            "next", 
            "off", 
            "on"
          ]
        }, 
        {
          "description": "Index of the subtitle to display", 
          "type": "integer", 
          "minimum": 0
        }
      ], 
      "required": true
    }, 
    {
      "description": "Whether to enable subtitles to be displayed after setting the new subtitle", 
      "type": "boolean", 
      "name": "enable", 
      "default": false
    }
  ], 
  "returns": {
    "type": "string"
  }
}

Player.Stop

Stops playback
Permissions:

ControlPlayback

Parameters:

Player.Id playerid

Returns: string

JSON Schema Description
{ "description": "Stops playback", "params": [ { "$ref": "Player.Id", "name": "playerid", "required": true } ], "returns": { "type": "string" } }

Player.Zoom

Zoom current picture
Permissions:

ControlPlayback

Parameters:

Player.Id playerid
mixed zoom

Returns: string

JSON Schema Description

{
  "description": "Zoom current picture", 
  "params": [
    {
      "$ref": "Player.Id", 
      "name": "playerid", 
      "required": true
    }, 
    {
      "name": "zoom", 
      "type": [
        {
          "type": "string", 
          "enums": [
            "in", 
            "out"
          ]
        }, 
        {
          "description": "zoom level", 
          "type": "integer", 
          "minimum": 1, 
          "maximum": 10
        }
      ], 
      "required": true
    }
  ], 
  "returns": {
    "type": "string"
  }
}

Playlist

Playlist.Add

Add item(s) to playlist
Permissions:

ControlPlayback

Parameters:

Playlist.Id playlistid
Playlist.Item item

Returns: string

JSON Schema Description

{
  "description": "Add item(s) to playlist", 
  "params": [
    {
      "$ref": "Playlist.Id", 
      "name": "playlistid", 
      "required": true
    }, 
    {
      "$ref": "Playlist.Item", 
      "name": "item", 
      "required": true
    }
  ], 
  "returns": {
    "type": "string"
  }
}

Playlist.Clear

Clear playlist
Permissions:

ControlPlayback

Parameters:

Playlist.Id playlistid

Returns: string

JSON Schema Description
{ "description": "Clear playlist", "params": [ { "$ref": "Playlist.Id", "name": "playlistid", "required": true } ], "returns": { "type": "string" } }

Playlist.GetItems

Get all items from playlist
Permissions:

ReadData

Parameters:

Playlist.Id playlistid
[ List.Fields.All properties ]
[ List.Limits limits ]
[ List.Sort sort ]

Returns:

Type: object
Properties:

List.LimitsReturned limits
List.Item.All[] items

JSON Schema Description

{
  "description": "Get all items from playlist", 
  "params": [
    {
      "$ref": "Playlist.Id", 
      "name": "playlistid", 
      "required": true
    }, 
    {
      "$ref": "List.Fields.All", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "items": {
        "type": "array", 
        "required": true, 
        "items": {
          "$ref": "List.Item.All"
        }
      }
    }, 
    "type": "object"
  }
}

Playlist.GetPlaylists

Returns all existing playlists
Permissions:

ReadData

Parameters: None
Returns:

Type: array

JSON Schema Description

{
  "description": "Returns all existing playlists", 
  "params": [], 
  "returns": {
    "type": "array", 
    "items": {
      "properties": {
        "type": {
          "$ref": "Playlist.Type", 
          "required": true
        }, 
        "playlistid": {
          "$ref": "Playlist.Id", 
          "required": true
        }
      }, 
      "type": "object"
    }, 
    "uniqueItems": true
  }
}

Playlist.GetProperties

Retrieves the values of the given properties
Permissions:

ReadData

Parameters:

Playlist.Id playlistid
Playlist.Property.Name[] properties

Returns: Playlist.Property.Value

JSON Schema Description

{
  "description": "Retrieves the values of the given properties", 
  "params": [
    {
      "$ref": "Playlist.Id", 
      "name": "playlistid", 
      "required": true
    }, 
    {
      "name": "properties", 
      "type": "array", 
      "required": true, 
      "items": {
        "$ref": "Playlist.Property.Name"
      }, 
      "uniqueItems": true
    }
  ], 
  "returns": {
    "$ref": "Playlist.Property.Value"
  }
}

Playlist.Insert

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

ControlPlayback

Parameters:

Playlist.Id playlistid
Playlist.Position position
Playlist.Item item

Returns: string

JSON Schema Description

{
  "description": "Insert item(s) into playlist. Does not work for picture playlists (aka slideshows).", 
  "params": [
    {
      "$ref": "Playlist.Id", 
      "name": "playlistid", 
      "required": true
    }, 
    {
      "$ref": "Playlist.Position", 
      "name": "position", 
      "required": true
    }, 
    {
      "$ref": "Playlist.Item", 
      "name": "item", 
      "required": true
    }
  ], 
  "returns": {
    "type": "string"
  }
}

Playlist.Remove

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

ControlPlayback

Parameters:

Playlist.Id playlistid
Playlist.Position position

Returns: string

JSON Schema Description

{
  "description": "Remove item from playlist. Does not work for picture playlists (aka slideshows).", 
  "params": [
    {
      "$ref": "Playlist.Id", 
      "name": "playlistid", 
      "required": true
    }, 
    {
      "$ref": "Playlist.Position", 
      "name": "position", 
      "required": true
    }
  ], 
  "returns": {
    "type": "string"
  }
}

Playlist.Swap

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

ControlPlayback

Parameters:

Playlist.Id playlistid
Playlist.Position position1
Playlist.Position position2

Returns: string

JSON Schema Description

{
  "description": "Swap items in the playlist. Does not work for picture playlists (aka slideshows).", 
  "params": [
    {
      "$ref": "Playlist.Id", 
      "name": "playlistid", 
      "required": true
    }, 
    {
      "$ref": "Playlist.Position", 
      "name": "position1", 
      "required": true
    }, 
    {
      "$ref": "Playlist.Position", 
      "name": "position2", 
      "required": true
    }
  ], 
  "returns": {
    "type": "string"
  }
}

System

System.EjectOpticalDrive

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

ControlSystem

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Ejects or closes the optical disc drive (if available)", "params": [], "returns": { "type": "string" } }

System.GetProperties

Retrieves the values of the given properties
Permissions:

ReadData

Parameters:

System.Property.Name[] properties

Returns: System.Property.Value

JSON Schema Description

{
  "description": "Retrieves the values of the given properties", 
  "params": [
    {
      "name": "properties", 
      "type": "array", 
      "required": true, 
      "items": {
        "$ref": "System.Property.Name"
      }, 
      "uniqueItems": true
    }
  ], 
  "returns": {
    "$ref": "System.Property.Value"
  }
}

System.Hibernate

Puts the system running XBMC into hibernate mode
Permissions:

ControlPower

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Puts the system running XBMC into hibernate mode", "params": [], "returns": { "type": "string" } }

System.Reboot

Reboots the system running XBMC
Permissions:

ControlPower

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Reboots the system running XBMC", "params": [], "returns": { "type": "string" } }

System.Shutdown

Shuts the system running XBMC down
Permissions:

ControlPower

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Shuts the system running XBMC down", "params": [], "returns": { "type": "string" } }

System.Suspend

Suspends the system running XBMC
Permissions:

ControlPower

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Suspends the system running XBMC", "params": [], "returns": { "type": "string" } }

VideoLibrary

VideoLibrary.Clean

Cleans the video library from non-existent items
Permissions:

RemoveData

Parameters: None
Returns: string

JSON Schema Description
{ "description": "Cleans the video library from non-existent items", "params": [], "returns": { "type": "string" } }

VideoLibrary.Export

Exports all items from the video library
Permissions:

WriteFile

Parameters:

[ mixed options ]

Returns: string

JSON Schema Description

{
  "description": "Exports all items from the video library", 
  "params": [
    {
      "name": "options", 
      "type": [
        {
          "properties": {
            "path": {
              "description": "Path to the directory to where the data should be exported", 
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "actorthumbs": {
              "description": "Whether to export actor thumbnails", 
              "type": "boolean", 
              "default": false
            }, 
            "overwrite": {
              "description": "Whether to overwrite existing exported files", 
              "type": "boolean", 
              "default": false
            }, 
            "images": {
              "description": "Whether to export thumbnails and fanart images", 
              "type": "boolean", 
              "default": false
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }
      ]
    }
  ], 
  "returns": {
    "type": "string"
  }
}

VideoLibrary.GetEpisodeDetails

Retrieve details about a specific tv show episode
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

[ Video.Details.Episode episodedetails ]

JSON Schema Description

{
  "description": "Retrieve details about a specific tv show episode", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "episodeid", 
      "required": true
    }, 
    {
      "$ref": "Video.Fields.Episode", 
      "name": "properties"
    }
  ], 
  "returns": {
    "properties": {
      "episodedetails": {
        "$ref": "Video.Details.Episode"
      }
    }, 
    "type": "object"
  }
}

VideoLibrary.GetEpisodes

Retrieve all tv show episodes
Permissions:

ReadData

Parameters:

[ Library.Id tvshowid = -1 ]
[ integer season = -1 ]
[ Video.Fields.Episode properties ]
[ List.Limits limits ]
[ List.Sort sort ]
[ mixed filter ]

Returns:

Type: object
Properties:

List.LimitsReturned limits
[ Video.Details.Episode[] episodes ]

JSON Schema Description

{
  "description": "Retrieve all tv show episodes", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "tvshowid", 
      "default": -1
    }, 
    {
      "name": "season", 
      "type": "integer", 
      "minimum": 0, 
      "default": -1
    }, 
    {
      "$ref": "Video.Fields.Episode", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }, 
    {
      "name": "filter", 
      "type": [
        {
          "properties": {
            "genreid": {
              "$ref": "Library.Id", 
              "description": "Requires tvshowid to be set", 
              "required": true
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "genre": {
              "description": "Requires tvshowid to be set", 
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "year": {
              "required": true, 
              "type": "integer", 
              "minimum": 0
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "actor": {
              "description": "Requires tvshowid to be set", 
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "director": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "$ref": "List.Filter.Episodes"
        }
      ]
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "episodes": {
        "type": "array", 
        "items": {
          "$ref": "Video.Details.Episode"
        }
      }
    }, 
    "type": "object"
  }
}

VideoLibrary.GetGenres

Retrieve all genres
Permissions:

ReadData

Parameters:

string type
[ Library.Fields.Genre properties ]
[ List.Limits limits ]
[ List.Sort sort ]

Returns:

Type: object
Properties:

List.LimitsReturned limits
Library.Details.Genre[] genres

JSON Schema Description

{
  "description": "Retrieve all genres", 
  "params": [
    {
      "required": true, 
      "name": "type", 
      "type": "string", 
      "enums": [
        "movie", 
        "tvshow", 
        "musicvideo"
      ]
    }, 
    {
      "$ref": "Library.Fields.Genre", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "genres": {
        "type": "array", 
        "required": true, 
        "items": {
          "$ref": "Library.Details.Genre"
        }
      }
    }, 
    "type": "object"
  }
}

VideoLibrary.GetMovieDetails

Retrieve details about a specific movie
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

[ Video.Details.Movie moviedetails ]

JSON Schema Description

{
  "description": "Retrieve details about a specific movie", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "movieid", 
      "required": true
    }, 
    {
      "$ref": "Video.Fields.Movie", 
      "name": "properties"
    }
  ], 
  "returns": {
    "properties": {
      "moviedetails": {
        "$ref": "Video.Details.Movie"
      }
    }, 
    "type": "object"
  }
}

VideoLibrary.GetMovieSetDetails

Retrieve details about a specific movie set
Permissions:

ReadData

Parameters:

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

Properties:

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

Returns:

Type: object
Properties:

[ Video.Details.MovieSet.Extended setdetails ]

JSON Schema Description

{
  "description": "Retrieve details about a specific movie set", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "setid", 
      "required": true
    }, 
    {
      "$ref": "Video.Fields.MovieSet", 
      "name": "properties"
    }, 
    {
      "name": "movies", 
      "type": "object", 
      "properties": {
        "limits": {
          "$ref": "List.Limits"
        }, 
        "properties": {
          "$ref": "Video.Fields.Movie"
        }, 
        "sort": {
          "$ref": "List.Sort"
        }
      }
    }
  ], 
  "returns": {
    "properties": {
      "setdetails": {
        "$ref": "Video.Details.MovieSet.Extended"
      }
    }, 
    "type": "object"
  }
}

VideoLibrary.GetMovieSets

Retrieve all movie sets
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

[ Video.Details.MovieSet[] sets ]
List.LimitsReturned limits

JSON Schema Description

{
  "description": "Retrieve all movie sets", 
  "params": [
    {
      "$ref": "Video.Fields.MovieSet", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }
  ], 
  "returns": {
    "properties": {
      "sets": {
        "type": "array", 
        "items": {
          "$ref": "Video.Details.MovieSet"
        }
      }, 
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }
    }, 
    "type": "object"
  }
}

VideoLibrary.GetMovies

Retrieve all movies
Permissions:

ReadData

Parameters:

[ Video.Fields.Movie properties ]
[ List.Limits limits ]
[ List.Sort sort ]
[ mixed filter ]

Returns:

Type: object
Properties:

List.LimitsReturned limits
[ Video.Details.Movie[] movies ]

JSON Schema Description

{
  "description": "Retrieve all movies", 
  "params": [
    {
      "$ref": "Video.Fields.Movie", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }, 
    {
      "name": "filter", 
      "type": [
        {
          "properties": {
            "genreid": {
              "$ref": "Library.Id", 
              "required": true
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "genre": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "year": {
              "required": true, 
              "type": "integer", 
              "minimum": 0
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "actor": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "director": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "studio": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "country": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "setid": {
              "$ref": "Library.Id", 
              "required": true
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "set": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "tag": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "$ref": "List.Filter.Movies"
        }
      ]
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "movies": {
        "type": "array", 
        "items": {
          "$ref": "Video.Details.Movie"
        }
      }
    }, 
    "type": "object"
  }
}

VideoLibrary.GetMusicVideoDetails

Retrieve details about a specific music video
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

[ Video.Details.MusicVideo musicvideodetails ]

JSON Schema Description

{
  "description": "Retrieve details about a specific music video", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "musicvideoid", 
      "required": true
    }, 
    {
      "$ref": "Video.Fields.MusicVideo", 
      "name": "properties"
    }
  ], 
  "returns": {
    "properties": {
      "musicvideodetails": {
        "$ref": "Video.Details.MusicVideo"
      }
    }, 
    "type": "object"
  }
}

VideoLibrary.GetMusicVideos

Retrieve all music videos
Permissions:

ReadData

Parameters:

[ Video.Fields.MusicVideo properties ]
[ List.Limits limits ]
[ List.Sort sort ]
[ mixed filter ]

Returns:

Type: object
Properties:

List.LimitsReturned limits
[ Video.Details.MusicVideo[] musicvideos ]

JSON Schema Description

{
  "description": "Retrieve all music videos", 
  "params": [
    {
      "$ref": "Video.Fields.MusicVideo", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }, 
    {
      "name": "filter", 
      "type": [
        {
          "properties": {
            "artist": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "genreid": {
              "$ref": "Library.Id", 
              "required": true
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "genre": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "year": {
              "required": true, 
              "type": "integer", 
              "minimum": 0
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "director": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "studio": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "tag": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "$ref": "List.Filter.MusicVideos"
        }
      ]
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "musicvideos": {
        "type": "array", 
        "items": {
          "$ref": "Video.Details.MusicVideo"
        }
      }
    }, 
    "type": "object"
  }
}

VideoLibrary.GetRecentlyAddedEpisodes

Retrieve all recently added tv episodes
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

List.LimitsReturned limits
[ Video.Details.Episode[] episodes ]

JSON Schema Description

{
  "description": "Retrieve all recently added tv episodes", 
  "params": [
    {
      "$ref": "Video.Fields.Episode", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "episodes": {
        "type": "array", 
        "items": {
          "$ref": "Video.Details.Episode"
        }
      }
    }, 
    "type": "object"
  }
}

VideoLibrary.GetRecentlyAddedMovies

Retrieve all recently added movies
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

List.LimitsReturned limits
[ Video.Details.Movie[] movies ]

JSON Schema Description

{
  "description": "Retrieve all recently added movies", 
  "params": [
    {
      "$ref": "Video.Fields.Movie", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "movies": {
        "type": "array", 
        "items": {
          "$ref": "Video.Details.Movie"
        }
      }
    }, 
    "type": "object"
  }
}

VideoLibrary.GetRecentlyAddedMusicVideos

Retrieve all recently added music videos
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

List.LimitsReturned limits
[ Video.Details.MusicVideo[] musicvideos ]

JSON Schema Description

{
  "description": "Retrieve all recently added music videos", 
  "params": [
    {
      "$ref": "Video.Fields.MusicVideo", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "musicvideos": {
        "type": "array", 
        "items": {
          "$ref": "Video.Details.MusicVideo"
        }
      }
    }, 
    "type": "object"
  }
}

VideoLibrary.GetSeasons

Retrieve all tv seasons
Permissions:

ReadData

Parameters:

Library.Id tvshowid
[ Video.Fields.Season properties ]
[ List.Limits limits ]
[ List.Sort sort ]

Returns:

Type: object
Properties:

List.LimitsReturned limits
[ Video.Details.Season[] seasons ]

JSON Schema Description

{
  "description": "Retrieve all tv seasons", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "tvshowid", 
      "required": true
    }, 
    {
      "$ref": "Video.Fields.Season", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }
  ], 
  "returns": {
    "properties": {
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }, 
      "seasons": {
        "type": "array", 
        "items": {
          "$ref": "Video.Details.Season"
        }
      }
    }, 
    "type": "object"
  }
}

VideoLibrary.GetTVShowDetails

Retrieve details about a specific tv show
Permissions:

ReadData

Parameters:

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

Returns:

Type: object
Properties:

[ Video.Details.TVShow tvshowdetails ]

JSON Schema Description

{
  "description": "Retrieve details about a specific tv show", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "tvshowid", 
      "required": true
    }, 
    {
      "$ref": "Video.Fields.TVShow", 
      "name": "properties"
    }
  ], 
  "returns": {
    "properties": {
      "tvshowdetails": {
        "$ref": "Video.Details.TVShow"
      }
    }, 
    "type": "object"
  }
}

VideoLibrary.GetTVShows

Retrieve all tv shows
Permissions:

ReadData

Parameters:

[ Video.Fields.TVShow properties ]
[ List.Limits limits ]
[ List.Sort sort ]
[ mixed filter ]

Returns:

Type: object
Properties:

[ Video.Details.TVShow[] tvshows ]
List.LimitsReturned limits

JSON Schema Description

{
  "description": "Retrieve all tv shows", 
  "params": [
    {
      "$ref": "Video.Fields.TVShow", 
      "name": "properties"
    }, 
    {
      "$ref": "List.Limits", 
      "name": "limits"
    }, 
    {
      "$ref": "List.Sort", 
      "name": "sort"
    }, 
    {
      "name": "filter", 
      "type": [
        {
          "properties": {
            "genreid": {
              "$ref": "Library.Id", 
              "required": true
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "genre": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "year": {
              "required": true, 
              "type": "integer", 
              "minimum": 0
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "actor": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "studio": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "properties": {
            "tag": {
              "type": "string", 
              "required": true, 
              "minLength": 1
            }
          }, 
          "type": "object", 
          "additionalProperties": false
        }, 
        {
          "$ref": "List.Filter.TVShows"
        }
      ]
    }
  ], 
  "returns": {
    "properties": {
      "tvshows": {
        "type": "array", 
        "items": {
          "$ref": "Video.Details.TVShow"
        }
      }, 
      "limits": {
        "$ref": "List.LimitsReturned", 
        "required": true
      }
    }, 
    "type": "object"
  }
}

VideoLibrary.RemoveEpisode

Removes the given episode from the library
Permissions:

RemoveData

Parameters:

Library.Id episodeid

Returns: string

JSON Schema Description
{ "description": "Removes the given episode from the library", "params": [ { "$ref": "Library.Id", "name": "episodeid", "required": true } ], "returns": { "type": "string" } }

VideoLibrary.RemoveMovie

Removes the given movie from the library
Permissions:

RemoveData

Parameters:

Library.Id movieid

Returns: string

JSON Schema Description
{ "description": "Removes the given movie from the library", "params": [ { "$ref": "Library.Id", "name": "movieid", "required": true } ], "returns": { "type": "string" } }

VideoLibrary.RemoveMusicVideo

Removes the given music video from the library
Permissions:

RemoveData

Parameters:

Library.Id musicvideoid

Returns: string

JSON Schema Description
{ "description": "Removes the given music video from the library", "params": [ { "$ref": "Library.Id", "name": "musicvideoid", "required": true } ], "returns": { "type": "string" } }

VideoLibrary.RemoveTVShow

Removes the given tv show from the library
Permissions:

RemoveData

Parameters:

Library.Id tvshowid

Returns: string

JSON Schema Description
{ "description": "Removes the given tv show from the library", "params": [ { "$ref": "Library.Id", "name": "tvshowid", "required": true } ], "returns": { "type": "string" } }

VideoLibrary.Scan

Scans the video sources for new library items
Permissions:

UpdateData

Parameters:

[ string directory = "" ]

Returns: string

JSON Schema Description
{ "description": "Scans the video sources for new library items", "params": [ { "name": "directory", "type": "string", "default": "" } ], "returns": { "type": "string" } }

VideoLibrary.SetEpisodeDetails

Update the given episode with the given details
Permissions:

UpdateData

Parameters:

Library.Id episodeid
[ Optional.String title = null ]
[ Optional.Integer playcount = null ]
[ Optional.String runtime = null ]
[ mixed director = null ]
[ Optional.String plot = null ]
[ Optional.Number rating = null ]
[ Optional.String votes = null ]
[ Optional.String lastplayed = null ]
[ mixed writer = null ]
[ Optional.String firstaired = null ]
[ Optional.String productioncode = null ]
[ Optional.Integer season = null ]
[ Optional.Integer episode = null ]
[ Optional.String originaltitle = null ]
[ Optional.String thumbnail = null ]
[ Optional.String fanart = null ]
[ mixed art = null ]

Returns: string

JSON Schema Description

{
  "description": "Update the given episode with the given details", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "episodeid", 
      "required": true
    }, 
    {
      "$ref": "Optional.String", 
      "name": "title", 
      "default": null
    }, 
    {
      "$ref": "Optional.Integer", 
      "name": "playcount", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "runtime", 
      "default": null
    }, 
    {
      "name": "director", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "plot", 
      "default": null
    }, 
    {
      "$ref": "Optional.Number", 
      "name": "rating", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "votes", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "lastplayed", 
      "default": null
    }, 
    {
      "name": "writer", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "firstaired", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "productioncode", 
      "default": null
    }, 
    {
      "$ref": "Optional.Integer", 
      "name": "season", 
      "default": null
    }, 
    {
      "$ref": "Optional.Integer", 
      "name": "episode", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "originaltitle", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "thumbnail", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "fanart", 
      "default": null
    }, 
    {
      "name": "art", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Media.Artwork"
        }
      ], 
      "default": null
    }
  ], 
  "returns": {
    "type": "string"
  }
}

VideoLibrary.SetMovieDetails

Update the given movie with the given details
Permissions:

UpdateData

Parameters:

Library.Id movieid
[ Optional.String title = null ]
[ Optional.Integer playcount = null ]
[ Optional.String runtime = null ]
[ mixed director = null ]
[ mixed studio = null ]
[ Optional.Integer year = null ]
[ Optional.String plot = null ]
[ mixed genre = null ]
[ Optional.Number rating = null ]
[ Optional.String mpaa = null ]
[ Optional.String imdbnumber = null ]
[ Optional.String votes = null ]
[ Optional.String lastplayed = null ]
[ Optional.String originaltitle = null ]
[ Optional.String trailer = null ]
[ Optional.String tagline = null ]
[ Optional.String plotoutline = null ]
[ mixed writer = null ]
[ mixed country = null ]
[ Optional.Integer top250 = null ]
[ Optional.String sorttitle = null ]
[ Optional.String set = null ]
[ mixed showlink = null ]
[ Optional.String thumbnail = null ]
[ Optional.String fanart = null ]
[ mixed tag = null ]
[ mixed art = null ]

Returns: string

JSON Schema Description

{
  "description": "Update the given movie with the given details", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "movieid", 
      "required": true
    }, 
    {
      "$ref": "Optional.String", 
      "name": "title", 
      "default": null
    }, 
    {
      "$ref": "Optional.Integer", 
      "name": "playcount", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "runtime", 
      "default": null
    }, 
    {
      "name": "director", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "name": "studio", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "$ref": "Optional.Integer", 
      "name": "year", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "plot", 
      "default": null
    }, 
    {
      "name": "genre", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "$ref": "Optional.Number", 
      "name": "rating", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "mpaa", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "imdbnumber", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "votes", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "lastplayed", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "originaltitle", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "trailer", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "tagline", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "plotoutline", 
      "default": null
    }, 
    {
      "name": "writer", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "name": "country", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "$ref": "Optional.Integer", 
      "name": "top250", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "sorttitle", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "set", 
      "default": null
    }, 
    {
      "name": "showlink", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "thumbnail", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "fanart", 
      "default": null
    }, 
    {
      "name": "tag", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "name": "art", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Media.Artwork"
        }
      ], 
      "default": null
    }
  ], 
  "returns": {
    "type": "string"
  }
}

VideoLibrary.SetMusicVideoDetails

Update the given music video with the given details
Permissions:

UpdateData

Parameters:

Library.Id musicvideoid
[ Optional.String title = null ]
[ Optional.Integer playcount = null ]
[ Optional.String runtime = null ]
[ mixed director = null ]
[ mixed studio = null ]
[ Optional.Integer year = null ]
[ Optional.String plot = null ]
[ Optional.String album = null ]
[ mixed artist = null ]
[ mixed genre = null ]
[ Optional.Integer track = null ]
[ Optional.String lastplayed = null ]
[ Optional.String thumbnail = null ]
[ Optional.String fanart = null ]
[ mixed tag = null ]
[ mixed art = null ]

Returns: string

JSON Schema Description

{
  "description": "Update the given music video with the given details", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "musicvideoid", 
      "required": true
    }, 
    {
      "$ref": "Optional.String", 
      "name": "title", 
      "default": null
    }, 
    {
      "$ref": "Optional.Integer", 
      "name": "playcount", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "runtime", 
      "default": null
    }, 
    {
      "name": "director", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "name": "studio", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "$ref": "Optional.Integer", 
      "name": "year", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "plot", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "album", 
      "default": null
    }, 
    {
      "name": "artist", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "name": "genre", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "$ref": "Optional.Integer", 
      "name": "track", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "lastplayed", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "thumbnail", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "fanart", 
      "default": null
    }, 
    {
      "name": "tag", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "name": "art", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Media.Artwork"
        }
      ], 
      "default": null
    }
  ], 
  "returns": {
    "type": "string"
  }
}

VideoLibrary.SetTVShowDetails

Update the given tvshow with the given details
Permissions:

UpdateData

Parameters:

Library.Id tvshowid
[ Optional.String title = null ]
[ Optional.Integer playcount = null ]
[ mixed studio = null ]
[ Optional.String plot = null ]
[ mixed genre = null ]
[ Optional.Number rating = null ]
[ Optional.String mpaa = null ]
[ Optional.String imdbnumber = null ]
[ Optional.String premiered = null ]
[ Optional.String votes = null ]
[ Optional.String lastplayed = null ]
[ Optional.String originaltitle = null ]
[ Optional.String sorttitle = null ]
[ Optional.String episodeguide = null ]
[ Optional.String thumbnail = null ]
[ Optional.String fanart = null ]
[ mixed tag = null ]
[ mixed art = null ]

Returns: string

JSON Schema Description

{
  "description": "Update the given tvshow with the given details", 
  "params": [
    {
      "$ref": "Library.Id", 
      "name": "tvshowid", 
      "required": true
    }, 
    {
      "$ref": "Optional.String", 
      "name": "title", 
      "default": null
    }, 
    {
      "$ref": "Optional.Integer", 
      "name": "playcount", 
      "default": null
    }, 
    {
      "name": "studio", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "plot", 
      "default": null
    }, 
    {
      "name": "genre", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "$ref": "Optional.Number", 
      "name": "rating", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "mpaa", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "imdbnumber", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "premiered", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "votes", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "lastplayed", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "originaltitle", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "sorttitle", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "episodeguide", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "thumbnail", 
      "default": null
    }, 
    {
      "$ref": "Optional.String", 
      "name": "fanart", 
      "default": null
    }, 
    {
      "name": "tag", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Array.String"
        }
      ], 
      "default": null
    }, 
    {
      "name": "art", 
      "type": [
        {
          "type": "null"
        }, 
        {
          "$ref": "Media.Artwork"
        }
      ], 
      "default": null
    }
  ], 
  "returns": {
    "type": "string"
  }
}

XBMC

XBMC.GetInfoBooleans

Retrieve info booleans about XBMC and the system
Permissions:

ReadData

Parameters:

array[1..X] booleans

Returns:

Type: object

JSON Schema Description

{
  "description": "Retrieve info booleans about XBMC and the system", 
  "params": [
    {
      "name": "booleans", 
      "type": "array", 
      "required": true, 
      "items": {
        "type": "string"
      }, 
      "minItems": 1
    }
  ], 
  "returns": {
    "description": "Object containing key-value pairs of the retrieved info booleans", 
    "type": "object", 
    "additionalProperties": {
      "type": "string", 
      "default": ""
    }
  }
}

XBMC.GetInfoLabels

Retrieve info labels about XBMC and the system
Permissions:

ReadData

Parameters:

array[1..X] labels

Returns:

Type: object

JSON Schema Description

{
  "description": "Retrieve info labels about XBMC and the system", 
  "params": [
    {
      "type": "array", 
      "required": true, 
      "items": {
        "type": "string"
      }, 
      "minItems": 1, 
      "description": "See http://wiki.xbmc.org/index.php?title=InfoLabels for a list of possible info labels", 
      "name": "labels"
    }
  ], 
  "returns": {
    "description": "Object containing key-value pairs of the retrieved info labels", 
    "type": "object", 
    "additionalProperties": {
      "type": "string", 
      "default": ""
    }
  }
}

Global types

Addon

Addon.Content

Type: string

JSON Schema Description
{ "id": "Addon.Content", "type": "string", "enums": [ "unknown", "video", "audio", "image", "executable" ], "default": "unknown" }

Addon.Details

Extends:

Item.Details.Base

Properties:

[ string disclaimer = "" ]
[ string thumbnail = "" ]
Addon.Types type
[ string version = "" ]
[ string path = "" ]
string addonid
[ array dependencies ]
[ mixed broken = null ]
[ string summary = "" ]
[ boolean enabled = False ]
[ array extrainfo ]
[ string fanart = "" ]
[ string author = "" ]
[ string description = "" ]
[ string name = "" ]
[ integer rating = 0 ]

JSON Schema Description

{
  "id": "Addon.Details", 
  "extends": "Item.Details.Base", 
  "properties": {
    "disclaimer": {
      "type": "string", 
      "default": ""
    }, 
    "thumbnail": {
      "type": "string", 
      "default": ""
    }, 
    "type": {
      "$ref": "Addon.Types", 
      "required": true
    }, 
    "version": {
      "type": "string", 
      "default": ""
    }, 
    "path": {
      "type": "string", 
      "default": ""
    }, 
    "addonid": {
      "type": "string", 
      "required": true
    }, 
    "dependencies": {
      "type": "array", 
      "items": {
        "properties": {
          "addonid": {
            "type": "string", 
            "required": true
          }, 
          "optional": {
            "type": "boolean", 
            "required": true
          }, 
          "version": {
            "type": "string", 
            "required": true
          }
        }, 
        "type": "object"
      }
    }, 
    "broken": {
      "type": [
        {
          "type": "boolean"
        }, 
        {
          "type": "string"
        }
      ], 
      "default": null
    }, 
    "summary": {
      "type": "string", 
      "default": ""
    }, 
    "enabled": {
      "type": "boolean", 
      "default": false
    }, 
    "extrainfo": {
      "type": "array", 
      "items": {
        "properties": {
          "key": {
            "type": "string", 
            "required": true
          }, 
          "value": {
            "type": "string", 
            "required": true
          }
        }, 
        "type": "object"
      }
    }, 
    "fanart": {
      "type": "string", 
      "default": ""
    }, 
    "author": {
      "type": "string", 
      "default": ""
    }, 
    "description": {
      "type": "string", 
      "default": ""
    }, 
    "name": {
      "type": "string", 
      "default": ""
    }, 
    "rating": {
      "type": "integer", 
      "default": 0
    }
  }
}

Addon.Fields

Extends:

Item.Fields.Base

JSON Schema Description

{
  "id": "Addon.Fields", 
  "extends": "Item.Fields.Base", 
  "items": {
    "type": "string", 
    "enums": [
      "name", 
      "version", 
      "summary", 
      "description", 
      "path", 
      "author", 
      "thumbnail", 
      "disclaimer", 
      "fanart", 
      "dependencies", 
      "broken", 
      "extrainfo", 
      "rating", 
      "enabled"
    ]
  }
}

Addon.Types

Type: string

JSON Schema Description

{
  "id": "Addon.Types", 
  "type": "string", 
  "enums": [
    "unknown", 
    "xbmc.metadata.scraper.albums", 
    "xbmc.metadata.scraper.artists", 
    "xbmc.metadata.scraper.movies", 
    "xbmc.metadata.scraper.musicvideos", 
    "xbmc.metadata.scraper.tvshows", 
    "xbmc.ui.screensaver", 
    "xbmc.player.musicviz", 
    "xbmc.python.pluginsource", 
    "xbmc.python.script", 
    "xbmc.python.weather", 
    "xbmc.python.subtitles", 
    "xbmc.python.lyrics", 
    "xbmc.gui.skin", 
    "xbmc.gui.webinterface", 
    "xbmc.addon.video", 
    "xbmc.addon.audio", 
    "xbmc.addon.image", 
    "xbmc.addon.executable", 
    "xbmc.service"
  ], 
  "default": "unknown"
}

Application

Application.Property.Name

Type: string

JSON Schema Description
{ "id": "Application.Property.Name", "type": "string", "enums": [ "volume", "muted", "name", "version" ], "default": "volume" }

Application.Property.Value

Type: object
Properties:

[ string name = "" ]
[ integer volume = 0 ]
[ object version ]

Properties:

- [ mixed revision = null ]
- integer minor
- string tag
- integer major

[ boolean muted = False ]

JSON Schema Description

{
  "id": "Application.Property.Value", 
  "type": "object", 
  "properties": {
    "name": {
      "type": "string", 
      "minLength": 1, 
      "default": ""
    }, 
    "volume": {
      "maximum": 100, 
      "type": "integer", 
      "minimum": 0, 
      "default": 0
    }, 
    "version": {
      "properties": {
        "revision": {
          "type": [
            {
              "type": "string"
            }, 
            {
              "type": "integer"
            }
          ], 
          "default": null
        }, 
        "minor": {
          "required": true, 
          "type": "integer", 
          "minimum": 0
        }, 
        "tag": {
          "required": true, 
          "type": "string", 
          "enums": [
            "prealpha", 
            "alpha", 
            "beta", 
            "releasecandidate", 
            "stable"
          ]
        }, 
        "major": {
          "required": true, 
          "type": "integer", 
          "minimum": 0
        }
      }, 
      "type": "object"
    }, 
    "muted": {
      "type": "boolean", 
      "default": false
    }
  }
}

Array

Array.Integer

Type: array

JSON Schema Description
{ "id": "Array.Integer", "type": "array", "items": { "type": "integer" } }

Array.String

Type: array

JSON Schema Description
{ "id": "Array.String", "type": "array", "items": { "type": "string", "minLength": 1 } }

Audio

Audio.Details.Album

Extends:

Audio.Details.Media

Properties:

[ Array.String theme ]
[ string type = "" ]
[ integer playcount = 0 ]
[ string albumlabel = "" ]
[ string description = "" ]
[ Array.String mood ]
Library.Id albumid
[ Array.String style ]

JSON Schema Description

{
  "id": "Audio.Details.Album", 
  "extends": "Audio.Details.Media", 
  "properties": {
    "theme": {
      "$ref": "Array.String"
    }, 
    "type": {
      "type": "string", 
      "default": ""
    }, 
    "playcount": {
      "type": "integer", 
      "default": 0
    }, 
    "albumlabel": {
      "type": "string", 
      "default": ""
    }, 
    "description": {
      "type": "string", 
      "default": ""
    }, 
    "mood": {
      "$ref": "Array.String"
    }, 
    "albumid": {
      "$ref": "Library.Id", 
      "required": true
    }, 
    "style": {
      "$ref": "Array.String"
    }
  }
}

Audio.Details.Artist

Extends:

Audio.Details.Base

Properties:

[ string died = "" ]
[ Array.String yearsactive ]
Library.Id artistid
[ Array.String instrument ]
[ Array.String style ]
[ string disbanded = "" ]
[ string formed = "" ]
[ string born = "" ]
string artist
[ string musicbrainzartistid = "" ]
[ Array.String mood ]
[ string description = "" ]

JSON Schema Description

{
  "id": "Audio.Details.Artist", 
  "extends": "Audio.Details.Base", 
  "properties": {
    "died": {
      "type": "string", 
      "default": ""
    }, 
    "yearsactive": {
      "$ref": "Array.String"
    }, 
    "artistid": {
      "$ref": "Library.Id", 
      "required": true
    }, 
    "instrument": {
      "$ref": "Array.String"
    }, 
    "style": {
      "$ref": "Array.String"
    }, 
    "disbanded": {
      "type": "string", 
      "default": ""
    }, 
    "formed": {
      "type": "string", 
      "default": ""
    }, 
    "born": {
      "type": "string", 
      "default": ""
    }, 
    "artist": {
      "type": "string", 
      "required": true
    }, 
    "musicbrainzartistid": {
      "type": "string", 
      "default": ""
    }, 
    "mood": {
      "$ref": "Array.String"
    }, 
    "description": {
      "type": "string", 
      "default": ""
    }
  }
}

Audio.Details.Base

Extends:

Media.Details.Base

Properties:

[ Array.String genre ]

JSON Schema Description
{ "id": "Audio.Details.Base", "extends": "Media.Details.Base", "properties": { "genre": { "$ref": "Array.String" } } }

Audio.Details.Media

Extends:

Audio.Details.Base

Properties:

[ string title = "" ]
[ string musicbrainzalbumid = "" ]
[ integer year = 0 ]
[ Array.String artist ]
[ string musicbrainzalbumartistid = "" ]
[ integer rating = 0 ]

JSON Schema Description

{
  "id": "Audio.Details.Media", 
  "extends": "Audio.Details.Base", 
  "properties": {
    "title": {
      "type": "string", 
      "default": ""
    }, 
    "musicbrainzalbumid": {
      "type": "string", 
      "default": ""
    }, 
    "year": {
      "type": "integer", 
      "default": 0
    }, 
    "artist": {
      "$ref": "Array.String"
    }, 
    "musicbrainzalbumartistid": {
      "type": "string", 
      "default": ""
    }, 
    "rating": {
      "type": "integer", 
      "default": 0
    }
  }
}

Audio.Details.Song

Extends:

Audio.Details.Media

Properties:

[ integer playcount = 0 ]
[ integer duration = 0 ]
[ integer disc = 0 ]
[ integer track = 0 ]
[ Array.String albumartist ]
[ string file = "" ]
[ Library.Id albumid = -1 ]
[ string musicbrainztrackid = "" ]
[ string lastplayed = "" ]
[ string musicbrainzartistid = "" ]
[ string lyrics = "" ]
[ string comment = "" ]
Library.Id songid
[ string album = "" ]

JSON Schema Description

{
  "id": "Audio.Details.Song", 
  "extends": "Audio.Details.Media", 
  "properties": {
    "playcount": {
      "type": "integer", 
      "default": 0
    }, 
    "duration": {
      "type": "integer", 
      "default": 0
    }, 
    "disc": {
      "type": "integer", 
      "default": 0
    }, 
    "track": {
      "type": "integer", 
      "default": 0
    }, 
    "albumartist": {
      "$ref": "Array.String"
    }, 
    "file": {
      "type": "string", 
      "default": ""
    }, 
    "albumid": {
      "$ref": "Library.Id", 
      "default": -1
    }, 
    "musicbrainztrackid": {
      "type": "string", 
      "default": ""
    }, 
    "lastplayed": {
      "type": "string", 
      "default": ""
    }, 
    "musicbrainzartistid": {
      "type": "string", 
      "default": ""
    }, 
    "lyrics": {
      "type": "string", 
      "default": ""
    }, 
    "comment": {
      "type": "string", 
      "default": ""
    }, 
    "songid": {
      "$ref": "Library.Id", 
      "required": true
    }, 
    "album": {
      "type": "string", 
      "default": ""
    }
  }
}

Audio.Fields.Album

Extends:

Item.Fields.Base

JSON Schema Description

{
  "id": "Audio.Fields.Album", 
  "extends": "Item.Fields.Base", 
  "items": {
    "type": "string", 
    "enums": [
      "title", 
      "description", 
      "artist", 
      "genre", 
      "theme", 
      "mood", 
      "style", 
      "type", 
      "albumlabel", 
      "rating", 
      "year", 
      "musicbrainzalbumid", 
      "musicbrainzalbumartistid", 
      "fanart", 
      "thumbnail", 
      "playcount"
    ]
  }
}

Audio.Fields.Artist

Extends:

Item.Fields.Base

JSON Schema Description

{
  "id": "Audio.Fields.Artist", 
  "extends": "Item.Fields.Base", 
  "items": {
    "type": "string", 
    "enums": [
      "instrument", 
      "style", 
      "mood", 
      "born", 
      "formed", 
      "description", 
      "genre", 
      "died", 
      "disbanded", 
      "yearsactive", 
      "musicbrainzartistid", 
      "fanart", 
      "thumbnail"
    ]
  }
}

Audio.Fields.Song

Extends:

Item.Fields.Base

JSON Schema Description

{
  "id": "Audio.Fields.Song", 
  "extends": "Item.Fields.Base", 
  "items": {
    "type": "string", 
    "enums": [
      "title", 
      "artist", 
      "albumartist", 
      "genre", 
      "year", 
      "rating", 
      "album", 
      "track", 
      "duration", 
      "comment", 
      "lyrics", 
      "musicbrainztrackid", 
      "musicbrainzartistid", 
      "musicbrainzalbumid", 
      "musicbrainzalbumartistid", 
      "playcount", 
      "fanart", 
      "thumbnail", 
      "file", 
      "albumid", 
      "lastplayed", 
      "disc"
    ]
  }
}

Configuration

Type: object
Properties:

Configuration.Notifications notifications

JSON Schema Description
{ "id": "Configuration", "type": "object", "required": true, "properties": { "notifications": { "$ref": "Configuration.Notifications", "required": true } } }

Configuration.Notifications

Type: object
Properties:

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

JSON Schema Description

{
  "id": "Configuration.Notifications", 
  "type": "object", 
  "properties": {
    "videolibrary": {
      "type": "boolean", 
      "required": true
    }, 
    "system": {
      "type": "boolean", 
      "required": true
    }, 
    "player": {
      "type": "boolean", 
      "required": true
    }, 
    "gui": {
      "type": "boolean", 
      "required": true
    }, 
    "input": {
      "type": "boolean", 
      "required": true
    }, 
    "audiolibrary": {
      "type": "boolean", 
      "required": true
    }, 
    "other": {
      "type": "boolean", 
      "required": true
    }, 
    "playlist": {
      "type": "boolean", 
      "required": true
    }, 
    "application": {
      "type": "boolean", 
      "required": true
    }, 
    "pvr": {
      "type": "boolean", 
      "required": true
    }
  }, 
  "additionalProperties": false
}

Files

Files.Media

Type: string

JSON Schema Description
{ "id": "Files.Media", "type": "string", "enums": [ "video", "music", "pictures", "files", "programs" ], "default": "video" }

GUI

GUI.Property.Name

Type: string

JSON Schema Description
{ "id": "GUI.Property.Name", "type": "string", "enums": [ "currentwindow", "currentcontrol", "skin", "fullscreen" ], "default": "currentwindow" }

GUI.Property.Value

Type: object
Properties:

[ object skin ]

Properties:

- string id
- [ string name = "" ]

[ object currentcontrol ]

Properties:

- string label

[ object currentwindow ]

Properties:

- string label
- integer id

[ boolean fullscreen = False ]

JSON Schema Description

{
  "id": "GUI.Property.Value", 
  "type": "object", 
  "properties": {
    "skin": {
      "properties": {
        "id": {
          "type": "string", 
          "required": true, 
          "minLength": 1
        }, 
        "name": {
          "type": "string", 
          "default": ""
        }
      }, 
      "type": "object"
    }, 
    "currentcontrol": {
      "properties": {
        "label": {
          "type": "string", 
          "required": true
        }
      }, 
      "type": "object"
    }, 
    "currentwindow": {
      "properties": {
        "label": {
          "type": "string", 
          "required": true
        }, 
        "id": {
          "type": "integer", 
          "required": true
        }
      }, 
      "type": "object"
    }, 
    "fullscreen": {
      "type": "boolean", 
      "default": false
    }
  }
}

GUI.Window

Type: string

JSON Schema Description

{
  "id": "GUI.Window", 
  "type": "string", 
  "enums": [
    "home", 
    "programs", 
    "pictures", 
    "filemanager", 
    "files", 
    "settings", 
    "music", 
    "video", 
    "videos", 
    "tv", 
    "pvr", 
    "pvrguideinfo", 
    "pvrrecordinginfo", 
    "pvrtimersetting", 
    "pvrgroupmanager", 
    "pvrchannelmanager", 
    "pvrguidesearch", 
    "pvrchannelscan", 
    "pvrupdateprogress", 
    "pvrosdchannels", 
    "pvrosdguide", 
    "pvrosddirector", 
    "pvrosdcutter", 
    "pvrosdteletext", 
    "systeminfo", 
    "testpattern", 
    "screencalibration", 
    "guicalibration", 
    "picturessettings", 
    "programssettings", 
    "weathersettings", 
    "musicsettings", 
    "systemsettings", 
    "videossettings", 
    "networksettings", 
    "servicesettings", 
    "appearancesettings", 
    "pvrsettings", 
    "tvsettings", 
    "scripts", 
    "videofiles", 
    "videolibrary", 
    "videoplaylist", 
    "loginscreen", 
    "profiles", 
    "skinsettings", 
    "addonbrowser", 
    "yesnodialog", 
    "progressdialog", 
    "virtualkeyboard", 
    "volumebar", 
    "submenu", 
    "favourites", 
    "contextmenu", 
    "infodialog", 
    "numericinput", 
    "gamepadinput", 
    "shutdownmenu", 
    "mutebug", 
    "playercontrols", 
    "seekbar", 
    "musicosd", 
    "addonsettings", 
    "visualisationsettings", 
    "visualisationpresetlist", 
    "osdvideosettings", 
    "osdaudiosettings", 
    "videobookmarks", 
    "filebrowser", 
    "networksetup", 
    "mediasource", 
    "profilesettings", 
    "locksettings", 
    "contentsettings", 
    "songinformation", 
    "smartplaylisteditor", 
    "smartplaylistrule", 
    "busydialog", 
    "pictureinfo", 
    "accesspoints", 
    "fullscreeninfo", 
    "karaokeselector", 
    "karaokelargeselector", 
    "sliderdialog", 
    "addoninformation", 
    "musicplaylist", 
    "musicfiles", 
    "musiclibrary", 
    "musicplaylisteditor", 
    "teletext", 
    "selectdialog", 
    "musicinformation", 
    "okdialog", 
    "movieinformation", 
    "textviewer", 
    "fullscreenvideo", 
    "fullscreenlivetv", 
    "visualisation", 
    "slideshow", 
    "filestackingdialog", 
    "karaoke", 
    "weather", 
    "screensaver", 
    "videoosd", 
    "videomenu", 
    "videotimeseek", 
    "musicoverlay", 
    "videooverlay", 
    "startwindow", 
    "startup", 
    "peripherals", 
    "peripheralsettings", 
    "extendedprogressdialog", 
    "mediafilter"
  ], 
  "default": "home"
}

Global

Global.IncrementDecrement

Type: string

JSON Schema Description
{ "id": "Global.IncrementDecrement", "type": "string", "enums": [ "increment", "decrement" ], "default": "increment" }

Global.String.NotEmpty

Type: string

JSON Schema Description
{ "id": "Global.String.NotEmpty", "type": "string", "minLength": 1, "default": "" }

Global.Time

Type: object
Properties:

integer milliseconds
integer seconds
integer minutes
integer hours

JSON Schema Description

{
  "id": "Global.Time", 
  "type": "object", 
  "properties": {
    "milliseconds": {
      "required": true, 
      "maximum": 999, 
      "type": "integer", 
      "minimum": 0
    }, 
    "seconds": {
      "required": true, 
      "maximum": 59, 
      "type": "integer", 
      "minimum": 0
    }, 
    "minutes": {
      "required": true, 
      "maximum": 59, 
      "type": "integer", 
      "minimum": 0
    }, 
    "hours": {
      "required": true, 
      "maximum": 23, 
      "type": "integer", 
      "minimum": 0
    }
  }, 
  "additionalProperties": false
}

Global.Toggle

Type: mixed

JSON Schema Description
{ "id": "Global.Toggle", "type": [ { "type": "boolean" }, { "type": "string", "enums": [ "toggle" ] } ], "default": null }

Input

Input.Action

Type: string

JSON Schema Description

{
  "id": "Input.Action", 
  "type": "string", 
  "enums": [
    "left", 
    "right", 
    "up", 
    "down", 
    "pageup", 
    "pagedown", 
    "select", 
    "highlight", 
    "parentdir", 
    "parentfolder", 
    "back", 
    "previousmenu", 
    "info", 
    "pause", 
    "stop", 
    "skipnext", 
    "skipprevious", 
    "fullscreen", 
    "aspectratio", 
    "stepforward", 
    "stepback", 
    "bigstepforward", 
    "bigstepback", 
    "osd", 
    "showsubtitles", 
    "nextsubtitle", 
    "codecinfo", 
    "nextpicture", 
    "previouspicture", 
    "zoomout", 
    "zoomin", 
    "playlist", 
    "queue", 
    "zoomnormal", 
    "zoomlevel1", 
    "zoomlevel2", 
    "zoomlevel3", 
    "zoomlevel4", 
    "zoomlevel5", 
    "zoomlevel6", 
    "zoomlevel7", 
    "zoomlevel8", 
    "zoomlevel9", 
    "nextcalibration", 
    "resetcalibration", 
    "analogmove", 
    "rotate", 
    "rotateccw", 
    "close", 
    "subtitledelayminus", 
    "subtitledelay", 
    "subtitledelayplus", 
    "audiodelayminus", 
    "audiodelay", 
    "audiodelayplus", 
    "subtitleshiftup", 
    "subtitleshiftdown", 
    "subtitlealign", 
    "audionextlanguage", 
    "verticalshiftup", 
    "verticalshiftdown", 
    "nextresolution", 
    "audiotoggledigital", 
    "number0", 
    "number1", 
    "number2", 
    "number3", 
    "number4", 
    "number5", 
    "number6", 
    "number7", 
    "number8", 
    "number9", 
    "osdleft", 
    "osdright", 
    "osdup", 
    "osddown", 
    "osdselect", 
    "osdvalueplus", 
    "osdvalueminus", 
    "smallstepback", 
    "fastforward", 
    "rewind", 
    "play", 
    "playpause", 
    "delete", 
    "copy", 
    "move", 
    "mplayerosd", 
    "hidesubmenu", 
    "screenshot", 
    "rename", 
    "togglewatched", 
    "scanitem", 
    "reloadkeymaps", 
    "volumeup", 
    "volumedown", 
    "mute", 
    "backspace", 
    "scrollup", 
    "scrolldown", 
    "analogfastforward", 
    "analogrewind", 
    "moveitemup", 
    "moveitemdown", 
    "contextmenu", 
    "shift", 
    "symbols", 
    "cursorleft", 
    "cursorright", 
    "showtime", 
    "analogseekforward", 
    "analogseekback", 
    "showpreset", 
    "presetlist", 
    "nextpreset", 
    "previouspreset", 
    "lockpreset", 
    "randompreset", 
    "increasevisrating", 
    "decreasevisrating", 
    "showvideomenu", 
    "enter", 
    "increaserating", 
    "decreaserating", 
    "togglefullscreen", 
    "nextscene", 
    "previousscene", 
    "nextletter", 
    "prevletter", 
    "jumpsms2", 
    "jumpsms3", 
    "jumpsms4", 
    "jumpsms5", 
    "jumpsms6", 
    "jumpsms7", 
    "jumpsms8", 
    "jumpsms9", 
    "filter", 
    "filterclear", 
    "filtersms2", 
    "filtersms3", 
    "filtersms4", 
    "filtersms5", 
    "filtersms6", 
    "filtersms7", 
    "filtersms8", 
    "filtersms9", 
    "firstpage", 
    "lastpage", 
    "guiprofile", 
    "red", 
    "green", 
    "yellow", 
    "blue", 
    "increasepar", 
    "decreasepar", 
    "volampup", 
    "volampdown", 
    "channelup", 
    "channeldown", 
    "previouschannelgroup", 
    "nextchannelgroup", 
    "leftclick", 
    "rightclick", 
    "middleclick", 
    "doubleclick", 
    "wheelup", 
    "wheeldown", 
    "mousedrag", 
    "mousemove", 
    "noop"
  ], 
  "default": "left"
}

Item

Item.Details.Base

Type: object
Properties:

string label

JSON Schema Description
{ "id": "Item.Details.Base", "type": "object", "properties": { "label": { "type": "string", "required": true } } }

Item.Fields.Base

Type: array

JSON Schema Description
{ "id": "Item.Fields.Base", "type": "array", "items": { "type": "string" }, "uniqueItems": true }

Library

Library.Details.Genre

Extends:

Item.Details.Base

Properties:

[ string title = "" ]
[ string thumbnail = "" ]
Library.Id genreid

JSON Schema Description

{
  "id": "Library.Details.Genre", 
  "extends": "Item.Details.Base", 
  "properties": {
    "title": {
      "type": "string", 
      "default": ""
    }, 
    "thumbnail": {
      "type": "string", 
      "default": ""
    }, 
    "genreid": {
      "$ref": "Library.Id", 
      "required": true
    }
  }
}

Library.Fields.Genre

Extends:

Item.Fields.Base

JSON Schema Description
{ "id": "Library.Fields.Genre", "extends": "Item.Fields.Base", "items": { "type": "string", "enums": [ "title", "thumbnail" ] } }

Library.Id

Type: integer

JSON Schema Description
{ "id": "Library.Id", "type": "integer", "minimum": 1, "default": -1 }

List

List.Amount

Type: integer

JSON Schema Description
{ "id": "List.Amount", "type": "integer", "minimum": 0, "default": -1 }

List.Fields.All

Extends:

Item.Fields.Base

JSON Schema Description

{
  "id": "List.Fields.All", 
  "extends": "Item.Fields.Base", 
  "items": {
    "type": "string", 
    "enums": [
      "title", 
      "artist", 
      "albumartist", 
      "genre", 
      "year", 
      "rating", 
      "album", 
      "track", 
      "duration", 
      "comment", 
      "lyrics", 
      "musicbrainztrackid", 
      "musicbrainzartistid", 
      "musicbrainzalbumid", 
      "musicbrainzalbumartistid", 
      "playcount", 
      "fanart", 
      "director", 
      "trailer", 
      "tagline", 
      "plot", 
      "plotoutline", 
      "originaltitle", 
      "lastplayed", 
      "writer", 
      "studio", 
      "mpaa", 
      "cast", 
      "country", 
      "imdbnumber", 
      "premiered", 
      "productioncode", 
      "runtime", 
      "set", 
      "showlink", 
      "streamdetails", 
      "top250", 
      "votes", 
      "firstaired", 
      "season", 
      "episode", 
      "showtitle", 
      "thumbnail", 
      "file", 
      "resume", 
      "artistid", 
      "albumid", 
      "tvshowid", 
      "setid", 
      "watchedepisodes", 
      "disc", 
      "tag", 
      "art", 
      "channel", 
      "channeltype", 
      "hidden", 
      "locked", 
      "channelnumber", 
      "starttime", 
      "endtime"
    ]
  }
}

List.Fields.Files

Extends:

Item.Fields.Base

JSON Schema Description

{
  "id": "List.Fields.Files", 
  "extends": "Item.Fields.Base", 
  "items": {
    "type": "string", 
    "enums": [
      "title", 
      "artist", 
      "albumartist", 
      "genre", 
      "year", 
      "rating", 
      "album", 
      "track", 
      "duration", 
      "comment", 
      "lyrics", 
      "musicbrainztrackid", 
      "musicbrainzartistid", 
      "musicbrainzalbumid", 
      "musicbrainzalbumartistid", 
      "playcount", 
      "fanart", 
      "director", 
      "trailer", 
      "tagline", 
      "plot", 
      "plotoutline", 
      "originaltitle", 
      "lastplayed", 
      "writer", 
      "studio", 
      "mpaa", 
      "cast", 
      "country", 
      "imdbnumber", 
      "premiered", 
      "productioncode", 
      "runtime", 
      "set", 
      "showlink", 
      "streamdetails", 
      "top250", 
      "votes", 
      "firstaired", 
      "season", 
      "episode", 
      "showtitle", 
      "thumbnail", 
      "file", 
      "resume", 
      "artistid", 
      "albumid", 
      "tvshowid", 
      "setid", 
      "size", 
      "lastmodified", 
      "mimetype", 
      "watchedepisodes", 
      "disc"
    ]
  }
}

List.Filter.Albums

Type: mixed

JSON Schema Description

{
  "id": "List.Filter.Albums", 
  "type": [
    {
      "properties": {
        "and": {
          "type": "array", 
          "required": true, 
          "items": {
            "$ref": "List.Filter.Albums"
          }, 
          "minItems": 1
        }
      }, 
      "type": "object"
    }, 
    {
      "properties": {
        "or": {
          "type": "array", 
          "required": true, 
          "items": {
            "$ref": "List.Filter.Albums"
          }, 
          "minItems": 1
        }
      }, 
      "type": "object"
    }, 
    {
      "$ref": "List.Filter.Rule.Albums"
    }
  ]
}

List.Filter.Artists

Type: mixed

JSON Schema Description

{
  "id": "List.Filter.Artists", 
  "type": [
    {
      "properties": {
        "and": {
          "type": "array", 
          "required": true, 
          "items": {
            "$ref": "List.Filter.Artists"
          }, 
          "minItems": 1
        }
      }, 
      "type": "object"
    }, 
    {
      "properties": {
        "or": {
          "type": "array", 
          "required": true, 
          "items": {
            "$ref": "List.Filter.Artists"
          }, 
          "minItems": 1
        }
      }, 
      "type": "object"
    }, 
    {
      "$ref": "List.Filter.Rule.Artists"
    }
  ]
}

List.Filter.Episodes

Type: mixed

JSON Schema Description

{
  "id": "List.Filter.Episodes", 
  "type": [
    {
      "properties": {
        "and": {
          "type": "array", 
          "required": true, 
          "items": {
            "$ref": "List.Filter.Episodes"
          }, 
          "minItems": 1
        }
      }, 
      "type": "object"
    }, 
    {
      "properties": {
        "or": {
          "type": "array", 
          "required": true, 
          "items": {
            "$ref": "List.Filter.Episodes"
          }, 
          "minItems": 1
        }
      }, 
      "type": "object"
    }, 
    {
      "$ref": "List.Filter.Rule.Episodes"
    }
  ]
}

List.Filter.Fields.Albums

Type: string

JSON Schema Description

{
  "id": "List.Filter.Fields.Albums", 
  "type": "string", 
  "enums": [
    "genre", 
    "album", 
    "artist", 
    "albumartist", 
    "year", 
    "review", 
    "themes", 
    "moods", 
    "styles", 
    "type", 
    "label", 
    "rating", 
    "playcount", 
    "playlist"
  ], 
  "default": "genre"
}

List.Filter.Fields.Artists

Type: string

JSON Schema Description

{
  "id": "List.Filter.Fields.Artists", 
  "type": "string", 
  "enums": [
    "artist", 
    "genre", 
    "moods", 
    "styles", 
    "instruments", 
    "biography", 
    "born", 
    "bandformed", 
    "disbanded", 
    "died", 
    "playlist"
  ], 
  "default": "artist"
}

List.Filter.Fields.Episodes

Type: string

JSON Schema Description

{
  "id": "List.Filter.Fields.Episodes", 
  "type": "string", 
  "enums": [
    "title", 
    "tvshow", 
    "plot", 
    "votes", 
    "rating", 
    "time", 
    "writers", 
    "airdate", 
    "playcount", 
    "lastplayed", 
    "inprogress", 
    "genre", 
    "year", 
    "director", 
    "actor", 
    "episode", 
    "season", 
    "filename", 
    "path", 
    "studio", 
    "mpaarating", 
    "dateadded", 
    "videoresolution", 
    "audiochannels", 
    "videocodec", 
    "audiocodec", 
    "audiolanguage", 
    "subtitlelanguage", 
    "videoaspect", 
    "playlist"
  ], 
  "default": "title"
}

List.Filter.Fields.Movies

Type: string

JSON Schema Description

{
  "id": "List.Filter.Fields.Movies", 
  "type": "string", 
  "enums": [
    "title", 
    "plot", 
    "plotoutline", 
    "tagline", 
    "votes", 
    "rating", 
    "time", 
    "writers", 
    "playcount", 
    "lastplayed", 
    "inprogress", 
    "genre", 
    "country", 
    "year", 
    "director", 
    "actor", 
    "mpaarating", 
    "top250", 
    "studio", 
    "hastrailer", 
    "filename", 
    "path", 
    "set", 
    "tag", 
    "dateadded", 
    "videoresolution", 
    "audiochannels", 
    "videocodec", 
    "audiocodec", 
    "audiolanguage", 
    "subtitlelanguage", 
    "videoaspect", 
    "playlist"
  ], 
  "default": "title"
}

List.Filter.Fields.MusicVideos

Type: string

JSON Schema Description

{
  "id": "List.Filter.Fields.MusicVideos", 
  "type": "string", 
  "enums": [
    "title", 
    "genre", 
    "album", 
    "year", 
    "artist", 
    "filename", 
    "path", 
    "playcount", 
    "lastplayed", 
    "time", 
    "director", 
    "studio", 
    "plot", 
    "dateadded", 
    "videoresolution", 
    "audiochannels", 
    "videocodec", 
    "audiocodec", 
    "audiolanguage", 
    "subtitlelanguage", 
    "videoaspect", 
    "playlist"
  ], 
  "default": "title"
}

List.Filter.Fields.Songs

Type: string

JSON Schema Description

{
  "id": "List.Filter.Fields.Songs", 
  "type": "string", 
  "enums": [
    "genre", 
    "album", 
    "artist", 
    "albumartist", 
    "title", 
    "year", 
    "time", 
    "tracknumber", 
    "filename", 
    "path", 
    "playcount", 
    "lastplayed", 
    "rating", 
    "comment", 
    "dateadded", 
    "playlist"
  ], 
  "default": "genre"
}

List.Filter.Fields.TVShows

Type: string

JSON Schema Description

{
  "required": true, 
  "id": "List.Filter.Fields.TVShows", 
  "type": "string", 
  "enums": [
    "title", 
    "plot", 
    "status", 
    "votes", 
    "rating", 
    "year", 
    "genre", 
    "director", 
    "actor", 
    "numepisodes", 
    "numwatched", 
    "playcount", 
    "path", 
    "studio", 
    "mpaarating", 
    "dateadded", 
    "lastplayed", 
    "inprogress", 
    "playlist"
  ]
}

List.Filter.Movies

Type: mixed

JSON Schema Description

{
  "id": "List.Filter.Movies", 
  "type": [
    {
      "properties": {
        "and": {
          "type": "array", 
          "required": true, 
          "items": {
            "$ref": "List.Filter.Movies"
          }, 
          "minItems": 1
        }
      }, 
      "type": "object"
    }, 
    {
      "properties": {
        "or": {
          "type": "array", 
          "required": true, 
          "items": {
            "$ref": "List.Filter.Movies"
          }, 
          "minItems": 1
        }
      }, 
      "type": "object"
    }, 
    {
      "$ref": "List.Filter.Rule.Movies"
    }
  ]
}

List.Filter.MusicVideos

Type: mixed

JSON Schema Description

{
  "id": "List.Filter.MusicVideos", 
  "type": [
    {
      "properties": {
        "and": {
          "type": "array", 
          "required": true, 
          "items": {
            "$ref": "List.Filter.MusicVideos"
          }, 
          "minItems": 1
        }
      }, 
      "type": "object"
    }, 
    {
      "properties": {
        "or": {
          "type": "array", 
          "required": true, 
          "items": {
            "$ref": "List.Filter.MusicVideos"
          }, 
          "minItems": 1
        }
      }, 
      "type": "object"
    }, 
    {
      "$ref": "List.Filter.Rule.MusicVideos"
    }
  ]
}

List.Filter.Operators

Type: string

JSON Schema Description

{
  "required": true, 
  "id": "List.Filter.Operators", 
  "type": "string", 
  "enums": [
    "contains", 
    "doesnotcontain", 
    "is", 
    "isnot", 
    "startswith", 
    "endswith", 
    "greaterthan", 
    "lessthan", 
    "after", 
    "before", 
    "inthelast", 
    "notinthelast", 
    "true", 
    "false", 
    "between"
  ]
}

List.Filter.Rule

Type: object
Properties:

mixed value
List.Filter.Operators operator

JSON Schema Description

{
  "id": "List.Filter.Rule", 
  "type": "object", 
  "properties": {
    "value": {
      "type": [
        {
          "type": "string"
        }, 
        {
          "type": "array", 
          "items": {
            "type": "string"
          }
        }
      ], 
      "required": true
    }, 
    "operator": {
      "$ref": "List.Filter.Operators", 
      "required": true
    }
  }
}

List.Filter.Rule.Albums

Extends:

List.Filter.Rule

Properties:

List.Filter.Fields.Albums field

JSON Schema Description
{ "id": "List.Filter.Rule.Albums", "extends": "List.Filter.Rule", "properties": { "field": { "$ref": "List.Filter.Fields.Albums", "required": true } } }

List.Filter.Rule.Artists

Extends:

List.Filter.Rule

Properties:

List.Filter.Fields.Artists field

JSON Schema Description
{ "id": "List.Filter.Rule.Artists", "extends": "List.Filter.Rule", "properties": { "field": { "$ref": "List.Filter.Fields.Artists", "required": true } } }

List.Filter.Rule.Episodes

Extends:

List.Filter.Rule

Properties:

List.Filter.Fields.Episodes field

JSON Schema Description
{ "id": "List.Filter.Rule.Episodes", "extends": "List.Filter.Rule", "properties": { "field": { "$ref": "List.Filter.Fields.Episodes", "required": true } } }

List.Filter.Rule.Movies

Extends:

List.Filter.Rule

Properties:

List.Filter.Fields.Movies field

JSON Schema Description
{ "id": "List.Filter.Rule.Movies", "extends": "List.Filter.Rule", "properties": { "field": { "$ref": "List.Filter.Fields.Movies", "required": true } } }

List.Filter.Rule.MusicVideos

Extends:

List.Filter.Rule

Properties:

List.Filter.Fields.MusicVideos field

JSON Schema Description
{ "id": "List.Filter.Rule.MusicVideos", "extends": "List.Filter.Rule", "properties": { "field": { "$ref": "List.Filter.Fields.MusicVideos", "required": true } } }

List.Filter.Rule.Songs

Extends:

List.Filter.Rule

Properties:

List.Filter.Fields.Songs field

JSON Schema Description
{ "id": "List.Filter.Rule.Songs", "extends": "List.Filter.Rule", "properties": { "field": { "$ref": "List.Filter.Fields.Songs", "required": true } } }

List.Filter.Rule.TVShows

Extends:

List.Filter.Rule

Properties:

List.Filter.Fields.TVShows field

JSON Schema Description
{ "id": "List.Filter.Rule.TVShows", "extends": "List.Filter.Rule", "properties": { "field": { "$ref": "List.Filter.Fields.TVShows", "required": true } } }

List.Filter.Songs

Type: mixed

JSON Schema Description

{
  "id": "List.Filter.Songs", 
  "type": [
    {
      "properties": {
        "and": {
          "type": "array", 
          "required": true, 
          "items": {
            "$ref": "List.Filter.Songs"
          }, 
          "minItems": 1
        }
      }, 
      "type": "object"
    }, 
    {
      "properties": {
        "or": {
          "type": "array", 
          "required": true, 
          "items": {
            "$ref": "List.Filter.Songs"
          }, 
          "minItems": 1
        }
      }, 
      "type": "object"
    }, 
    {
      "$ref": "List.Filter.Rule.Songs"
    }
  ]
}

List.Filter.TVShows

Type: mixed

JSON Schema Description

{
  "id": "List.Filter.TVShows", 
  "type": [
    {
      "properties": {
        "and": {
          "type": "array", 
          "required": true, 
          "items": {
            "$ref": "List.Filter.TVShows"
          }, 
          "minItems": 1
        }
      }, 
      "type": "object"
    }, 
    {
      "properties": {
        "or": {
          "type": "array", 
          "required": true, 
          "items": {
            "$ref": "List.Filter.TVShows"
          }, 
          "minItems": 1
        }
      }, 
      "type": "object"
    }, 
    {
      "$ref": "List.Filter.Rule.TVShows"
    }
  ]
}

List.Item.All

Extends:

Video.Details.File
Audio.Details.Media

Properties:

[ string channel = "" ]
[ integer top250 = 0 ]
[ PVR.Channel.Type channeltype = "tv" ]
[ string trailer = "" ]
[ integer disc = 0 ]
[ integer track = 0 ]
[ string firstaired = "" ]
[ Library.Id albumid = -1 ]
[ string originaltitle = "" ]
[ string premiered = "" ]
[ string type = "unknown" ]
[ Array.String writer ]
[ Video.Cast cast ]
[ string mpaa = "" ]
[ string productioncode = "" ]
[ string musicbrainzartistid = "" ]
[ integer episode = 0 ]
[ Array.String country ]
[ string votes = "" ]
[ string tagline = "" ]
[ boolean hidden = False ]
[ string showtitle = "" ]
[ Library.Id id = -1 ]
[ boolean locked = False ]
[ string endtime = "" ]
[ Library.Id setid = -1 ]
[ integer duration = 0 ]
[ Array.String showlink ]
[ Array.String studio ]
[ integer channelnumber = 0 ]
[ string imdbnumber = "" ]
[ Library.Id tvshowid = -1 ]
[ string musicbrainztrackid = "" ]
[ integer watchedepisodes = 0 ]
[ integer season = 0 ]
[ Array.String albumartist ]
[ Array.String tag ]
[ string lyrics = "" ]
[ string starttime = "" ]
[ string album = "" ]
[ string set = "" ]
[ string plotoutline = "" ]
[ string comment = "" ]

JSON Schema Description

{
  "id": "List.Item.All", 
  "extends": [
    "Video.Details.File", 
    "Audio.Details.Media"
  ], 
  "properties": {
    "channel": {
      "type": "string", 
      "default": ""
    }, 
    "top250": {
      "type": "integer", 
      "default": 0
    }, 
    "channeltype": {
      "$ref": "PVR.Channel.Type", 
      "default": "tv"
    }, 
    "trailer": {
      "type": "string", 
      "default": ""
    }, 
    "disc": {
      "type": "integer", 
      "default": 0
    }, 
    "track": {
      "type": "integer", 
      "default": 0
    }, 
    "firstaired": {
      "type": "string", 
      "default": ""
    }, 
    "albumid": {
      "$ref": "Library.Id", 
      "default": -1
    }, 
    "originaltitle": {
      "type": "string", 
      "default": ""
    }, 
    "premiered": {
      "type": "string", 
      "default": ""
    }, 
    "type": {
      "type": "string", 
      "enums": [
        "unknown", 
        "movie", 
        "episode", 
        "musicvideo", 
        "song", 
        "picture", 
        "channel"
      ], 
      "default": "unknown"
    }, 
    "writer": {
      "$ref": "Array.String"
    }, 
    "cast": {
      "$ref": "Video.Cast"
    }, 
    "mpaa": {
      "type": "string", 
      "default": ""
    }, 
    "productioncode": {
      "type": "string", 
      "default": ""
    }, 
    "musicbrainzartistid": {
      "type": "string", 
      "default": ""
    }, 
    "episode": {
      "type": "integer", 
      "default": 0
    }, 
    "country": {
      "$ref": "Array.String"
    }, 
    "votes": {
      "type": "string", 
      "default": ""
    }, 
    "tagline": {
      "type": "string", 
      "default": ""
    }, 
    "hidden": {
      "type": "boolean", 
      "default": false
    }, 
    "showtitle": {
      "type": "string", 
      "default": ""
    }, 
    "id": {
      "$ref": "Library.Id", 
      "default": -1
    }, 
    "locked": {
      "type": "boolean", 
      "default": false
    }, 
    "endtime": {
      "type": "string", 
      "default": ""
    }, 
    "setid": {
      "$ref": "Library.Id", 
      "default": -1
    }, 
    "duration": {
      "type": "integer", 
      "default": 0
    }, 
    "showlink": {
      "$ref": "Array.String"
    }, 
    "studio": {
      "$ref": "Array.String"
    }, 
    "channelnumber": {
      "type": "integer", 
      "default": 0
    }, 
    "imdbnumber": {
      "type": "string", 
      "default": ""
    }, 
    "tvshowid": {
      "$ref": "Library.Id", 
      "default": -1
    }, 
    "musicbrainztrackid": {
      "type": "string", 
      "default": ""
    }, 
    "watchedepisodes": {
      "type": "integer", 
      "default": 0
    }, 
    "season": {
      "type": "integer", 
      "default": 0
    }, 
    "albumartist": {
      "$ref": "Array.String"
    }, 
    "tag": {
      "$ref": "Array.String"
    }, 
    "lyrics": {
      "type": "string", 
      "default": ""
    }, 
    "starttime": {
      "type": "string", 
      "default": ""
    }, 
    "album": {
      "type": "string", 
      "default": ""
    }, 
    "set": {
      "type": "string", 
      "default": ""
    }, 
    "plotoutline": {
      "type": "string", 
      "default": ""
    }, 
    "comment": {
      "type": "string", 
      "default": ""
    }
  }
}

List.Item.File

Extends:

List.Item.All

Properties:

[ integer size = 0 ]
string file
string filetype
[ string lastmodified = "" ]
[ string mimetype = "" ]

JSON Schema Description

{
  "id": "List.Item.File", 
  "extends": "List.Item.All", 
  "properties": {
    "size": {
      "description": "Size of the file in kB (1000 Byte)", 
      "type": "integer", 
      "default": 0
    }, 
    "file": {
      "type": "string", 
      "required": true
    }, 
    "filetype": {
      "required": true, 
      "type": "string", 
      "enums": [
        "file", 
        "directory"
      ]
    }, 
    "lastmodified": {
      "type": "string", 
      "default": ""
    }, 
    "mimetype": {
      "type": "string", 
      "default": ""
    }
  }
}

List.Items.Sources

Type: array

JSON Schema Description
{ "id": "List.Items.Sources", "type": "array", "items": { "properties": { "file": { "type": "string", "required": true } }, "extends": "Item.Details.Base" } }

List.Limits

Type: object
Properties:

[ List.Amount end = -1 ]
[ integer start = 0 ]

JSON Schema Description

{
  "id": "List.Limits", 
  "type": "object", 
  "properties": {
    "end": {
      "$ref": "List.Amount", 
      "description": "Index of the last item to return", 
      "default": -1
    }, 
    "start": {
      "description": "Index of the first item to return", 
      "type": "integer", 
      "minimum": 0, 
      "default": 0
    }
  }, 
  "additionalProperties": false
}

List.LimitsReturned

Type: object
Properties:

[ List.Amount end = -1 ]
integer total
[ integer start = 0 ]

JSON Schema Description

{
  "id": "List.LimitsReturned", 
  "type": "object", 
  "properties": {
    "end": {
      "$ref": "List.Amount", 
      "default": -1
    }, 
    "total": {
      "required": true, 
      "type": "integer", 
      "minimum": 0
    }, 
    "start": {
      "type": "integer", 
      "minimum": 0, 
      "default": 0
    }
  }, 
  "additionalProperties": false
}

List.Sort

Type: object
Properties:

[ boolean ignorearticle = False ]
[ string order = "ascending" ]
[ string method = "none" ]

JSON Schema Description

{
  "id": "List.Sort", 
  "type": "object", 
  "properties": {
    "ignorearticle": {
      "type": "boolean", 
      "default": false
    }, 
    "order": {
      "type": "string", 
      "enums": [
        "ascending", 
        "descending"
      ], 
      "default": "ascending"
    }, 
    "method": {
      "type": "string", 
      "enums": [
        "none", 
        "label", 
        "date", 
        "size", 
        "file", 
        "path", 
        "drivetype", 
        "title", 
        "track", 
        "time", 
        "artist", 
        "album", 
        "albumtype", 
        "genre", 
        "country", 
        "year", 
        "rating", 
        "votes", 
        "top250", 
        "programcount", 
        "playlist", 
        "episode", 
        "season", 
        "totalepisodes", 
        "watchedepisodes", 
        "tvshowstatus", 
        "tvshowtitle", 
        "sorttitle", 
        "productioncode", 
        "mpaa", 
        "studio", 
        "dateadded", 
        "lastplayed", 
        "playcount", 
        "listeners", 
        "bitrate", 
        "random"
      ], 
      "default": "none"
    }
  }
}

Media

Media.Artwork

Type: object
Properties:

[ Global.String.NotEmpty thumb = "" ]
[ Global.String.NotEmpty banner = "" ]
[ Global.String.NotEmpty poster = "" ]
[ Global.String.NotEmpty fanart = "" ]

JSON Schema Description

{
  "id": "Media.Artwork", 
  "type": "object", 
  "properties": {
    "thumb": {
      "$ref": "Global.String.NotEmpty", 
      "default": ""
    }, 
    "banner": {
      "$ref": "Global.String.NotEmpty", 
      "default": ""
    }, 
    "poster": {
      "$ref": "Global.String.NotEmpty", 
      "default": ""
    }, 
    "fanart": {
      "$ref": "Global.String.NotEmpty", 
      "default": ""
    }
  }, 
  "additionalProperties": {
    "$ref": "Global.String.NotEmpty", 
    "default": ""
  }
}

Media.Details.Base

Extends:

Item.Details.Base

Properties:

[ string thumbnail = "" ]
[ string fanart = "" ]

JSON Schema Description
{ "id": "Media.Details.Base", "extends": "Item.Details.Base", "properties": { "thumbnail": { "type": "string", "default": "" }, "fanart": { "type": "string", "default": "" } } }

Notifications

Notifications.Item

Type: mixed

JSON Schema Description

{
  "id": "Notifications.Item", 
  "type": [
    {
      "description": "An unknown item does not have any additional information.", 
      "type": "object", 
      "properties": {
        "type": {
          "$ref": "Notifications.Item.Type", 
          "required": true
        }
      }
    }, 
    {
      "description": "An item known to the database has an identification.", 
      "type": "object", 
      "properties": {
        "id": {
          "$ref": "Library.Id", 
          "required": true
        }, 
        "type": {
          "$ref": "Notifications.Item.Type", 
          "required": true
        }
      }
    }, 
    {
      "description": "A movie item has a title and may have a release year.", 
      "type": "object", 
      "properties": {
        "title": {
          "type": "string", 
          "required": true
        }, 
        "year": {
          "type": "integer", 
          "default": 0
        }, 
        "type": {
          "$ref": "Notifications.Item.Type", 
          "required": true
        }
      }
    }, 
    {
      "description": "A tv episode has a title and may have an episode number, season number and the title of the show it belongs to.", 
      "type": "object", 
      "properties": {
        "title": {
          "type": "string", 
          "required": true
        }, 
        "showtitle": {
          "type": "string", 
          "default": ""
        }, 
        "episode": {
          "type": "integer", 
          "default": 0
        }, 
        "type": {
          "$ref": "Notifications.Item.Type", 
          "required": true
        }, 
        "season": {
          "type": "integer", 
          "default": 0
        }
      }
    }, 
    {
      "description": "A music video has a title and may have an album and an artist.", 
      "type": "object", 
      "properties": {
        "artist": {
          "type": "string", 
          "default": ""
        }, 
        "title": {
          "type": "string", 
          "required": true
        }, 
        "type": {
          "$ref": "Notifications.Item.Type", 
          "required": true
        }, 
        "album": {
          "type": "string", 
          "default": ""
        }
      }
    }, 
    {
      "description": "A song has a title and may have an album, an artist and a track number.", 
      "type": "object", 
      "properties": {
        "artist": {
          "type": "string", 
          "default": ""
        }, 
        "title": {
          "type": "string", 
          "required": true
        }, 
        "track": {
          "type": "integer", 
          "default": 0
        }, 
        "type": {
          "$ref": "Notifications.Item.Type", 
          "required": true
        }, 
        "album": {
          "type": "string", 
          "default": ""
        }
      }
    }, 
    {
      "description": "A picture has a file path.", 
      "type": "object", 
      "properties": {
        "file": {
          "type": "string", 
          "required": true
        }, 
        "type": {
          "$ref": "Notifications.Item.Type", 
          "required": true
        }
      }
    }, 
    {
      "description": "A PVR channel is either a radio or tv channel and has a title.", 
      "type": "object", 
      "properties": {
        "title": {
          "type": "string", 
          "required": true
        }, 
        "id": {
          "$ref": "Library.Id", 
          "required": true
        }, 
        "type": {
          "$ref": "Notifications.Item.Type", 
          "required": true
        }, 
        "channeltype": {
          "$ref": "PVR.Channel.Type", 
          "required": true
        }
      }
    }
  ]
}

Notifications.Item.Type

Type: string

JSON Schema Description
{ "id": "Notifications.Item.Type", "type": "string", "enums": [ "unknown", "movie", "episode", "musicvideo", "song", "picture", "channel" ], "default": "unknown" }

Optional

Optional.Boolean

Type: mixed

JSON Schema Description
{ "id": "Optional.Boolean", "type": [ { "type": "null" }, { "type": "boolean" } ], "default": null }

Optional.Integer

Type: mixed

JSON Schema Description
{ "id": "Optional.Integer", "type": [ { "type": "null" }, { "type": "integer" } ], "default": null }

Optional.Number

Type: mixed

JSON Schema Description
{ "id": "Optional.Number", "type": [ { "type": "null" }, { "type": "number" } ], "default": null }

Optional.String

Type: mixed

JSON Schema Description
{ "id": "Optional.String", "type": [ { "type": "null" }, { "type": "string" } ], "default": null }

PVR

PVR.Channel.Type

Type: string

JSON Schema Description
{ "id": "PVR.Channel.Type", "type": "string", "enums": [ "tv", "radio" ], "default": "tv" }

PVR.ChannelGroup.Id

Type: mixed

JSON Schema Description
{ "id": "PVR.ChannelGroup.Id", "type": [ { "$ref": "Library.Id" }, { "type": "string", "enums": [ "alltv", "allradio" ] } ], "default": null }

PVR.Details.Channel

Extends:

Item.Details.Base

Properties:

[ string channel = "" ]
[ string thumbnail = "" ]
[ string lastplayed = "" ]
[ PVR.Channel.Type channeltype = "tv" ]
Library.Id channelid
[ boolean locked = False ]
[ boolean hidden = False ]

JSON Schema Description

{
  "id": "PVR.Details.Channel", 
  "extends": "Item.Details.Base", 
  "properties": {
    "channel": {
      "type": "string", 
      "default": ""
    }, 
    "thumbnail": {
      "type": "string", 
      "default": ""
    }, 
    "lastplayed": {
      "type": "string", 
      "default": ""
    }, 
    "channeltype": {
      "$ref": "PVR.Channel.Type", 
      "default": "tv"
    }, 
    "channelid": {
      "$ref": "Library.Id", 
      "required": true
    }, 
    "locked": {
      "type": "boolean", 
      "default": false
    }, 
    "hidden": {
      "type": "boolean", 
      "default": false
    }
  }
}

PVR.Details.ChannelGroup

Extends:

Item.Details.Base

Properties:

Library.Id channelgroupid
PVR.Channel.Type channeltype

JSON Schema Description

{
  "id": "PVR.Details.ChannelGroup", 
  "extends": "Item.Details.Base", 
  "properties": {
    "channelgroupid": {
      "$ref": "Library.Id", 
      "required": true
    }, 
    "channeltype": {
      "$ref": "PVR.Channel.Type", 
      "required": true
    }
  }
}

PVR.Details.ChannelGroup.Extended

Extends:

PVR.Details.ChannelGroup

Properties:

List.LimitsReturned limits
[ PVR.Details.Channel[] channels ]

JSON Schema Description

{
  "id": "PVR.Details.ChannelGroup.Extended", 
  "extends": "PVR.Details.ChannelGroup", 
  "properties": {
    "limits": {
      "$ref": "List.LimitsReturned", 
      "required": true
    }, 
    "channels": {
      "type": "array", 
      "items": {
        "$ref": "PVR.Details.Channel"
      }
    }
  }
}

PVR.Fields.Channel

Extends:

Item.Fields.Base

JSON Schema Description
{ "id": "PVR.Fields.Channel", "extends": "Item.Fields.Base", "items": { "type": "string", "enums": [ "thumbnail", "channeltype", "hidden", "locked", "channel", "lastplayed" ] } }

PVR.Property.Name

Type: string

JSON Schema Description
{ "id": "PVR.Property.Name", "type": "string", "enums": [ "available", "recording", "scanning" ], "default": "available" }

PVR.Property.Value

Type: object
Properties:

[ boolean recording = False ]
[ boolean scanning = False ]
[ boolean available = False ]

JSON Schema Description

{
  "id": "PVR.Property.Value", 
  "type": "object", 
  "properties": {
    "recording": {
      "type": "boolean", 
      "default": false
    }, 
    "scanning": {
      "type": "boolean", 
      "default": false
    }, 
    "available": {
      "type": "boolean", 
      "default": false
    }
  }
}

Player

Player.Audio.Stream

Type: object
Properties:

string language
string name
integer index

JSON Schema Description

{
  "id": "Player.Audio.Stream", 
  "type": "object", 
  "properties": {
    "language": {
      "type": "string", 
      "required": true
    }, 
    "name": {
      "type": "string", 
      "required": true
    }, 
    "index": {
      "required": true, 
      "type": "integer", 
      "minimum": 0
    }
  }
}

Player.Audio.Stream.Extended

Extends:

Player.Audio.Stream

Properties:

integer bitrate
string codec
integer channels

JSON Schema Description

{
  "id": "Player.Audio.Stream.Extended", 
  "extends": "Player.Audio.Stream", 
  "properties": {
    "bitrate": {
      "type": "integer", 
      "required": true
    }, 
    "codec": {
      "type": "string", 
      "required": true
    }, 
    "channels": {
      "type": "integer", 
      "required": true
    }
  }
}

Player.Id

Type: integer

JSON Schema Description
{ "id": "Player.Id", "type": "integer", "minimum": 0, "maximum": 2, "default": -1 }

Player.Notifications.Data

Type: object
Properties:

Player.Notifications.Player player
Notifications.Item item

JSON Schema Description

{
  "id": "Player.Notifications.Data", 
  "type": "object", 
  "properties": {
    "player": {
      "$ref": "Player.Notifications.Player", 
      "required": true
    }, 
    "item": {
      "$ref": "Notifications.Item", 
      "required": true
    }
  }
}

Player.Notifications.Player

Type: object
Properties:

[ integer speed = 0 ]
Player.Id playerid

JSON Schema Description
{ "id": "Player.Notifications.Player", "type": "object", "properties": { "speed": { "type": "integer", "default": 0 }, "playerid": { "$ref": "Player.Id", "required": true } } }

Player.Notifications.Player.Seek

Extends:

Player.Notifications.Player

Properties:

[ Global.Time time ]
[ Global.Time seekoffset ]

JSON Schema Description
{ "id": "Player.Notifications.Player.Seek", "extends": "Player.Notifications.Player", "properties": { "time": { "$ref": "Global.Time" }, "seekoffset": { "$ref": "Global.Time" } } }

Player.Position.Percentage

Type: number

JSON Schema Description
{ "id": "Player.Position.Percentage", "type": "number", "minimum": 0, "maximum": 100, "default": 0 }

Player.Position.Time

Type: object
Properties:

[ integer milliseconds = 0 ]
[ integer seconds = 0 ]
[ integer minutes = 0 ]
[ integer hours = 0 ]

JSON Schema Description

{
  "id": "Player.Position.Time", 
  "type": "object", 
  "properties": {
    "milliseconds": {
      "maximum": 999, 
      "type": "integer", 
      "minimum": 0, 
      "default": 0
    }, 
    "seconds": {
      "maximum": 59, 
      "type": "integer", 
      "minimum": 0, 
      "default": 0
    }, 
    "minutes": {
      "maximum": 59, 
      "type": "integer", 
      "minimum": 0, 
      "default": 0
    }, 
    "hours": {
      "maximum": 23, 
      "type": "integer", 
      "minimum": 0, 
      "default": 0
    }
  }, 
  "additionalProperties": false
}

Player.Property.Name

Type: string

JSON Schema Description

{
  "id": "Player.Property.Name", 
  "type": "string", 
  "enums": [
    "type", 
    "partymode", 
    "speed", 
    "time", 
    "percentage", 
    "totaltime", 
    "playlistid", 
    "position", 
    "repeat", 
    "shuffled", 
    "canseek", 
    "canchangespeed", 
    "canmove", 
    "canzoom", 
    "canrotate", 
    "canshuffle", 
    "canrepeat", 
    "currentaudiostream", 
    "audiostreams", 
    "subtitleenabled", 
    "currentsubtitle", 
    "subtitles", 
    "live"
  ], 
  "default": "type"
}

Player.Property.Value

Type: object
Properties:

[ boolean canchangespeed = False ]
[ Player.Type type = "video" ]
[ Player.Position.Percentage percentage = 0 ]
[ Playlist.Position position = -1 ]
[ boolean subtitleenabled = False ]
[ Global.Time time ]
[ boolean partymode = False ]
[ boolean canmove = False ]
[ boolean live = False ]
[ integer speed = 0 ]
[ Playlist.Id playlistid = -1 ]
[ Player.Audio.Stream.Extended currentaudiostream ]
[ boolean shuffled = False ]
[ boolean canzoom = False ]
[ boolean canshuffle = False ]
[ Global.Time totaltime ]
[ Player.Subtitle[] subtitles ]
[ Player.Subtitle currentsubtitle ]
[ boolean canseek = False ]
[ boolean canrepeat = False ]
[ Player.Audio.Stream[] audiostreams ]
[ Player.Repeat repeat = "off" ]
[ boolean canrotate = False ]

JSON Schema Description

{
  "id": "Player.Property.Value", 
  "type": "object", 
  "properties": {
    "canchangespeed": {
      "type": "boolean", 
      "default": false
    }, 
    "type": {
      "$ref": "Player.Type", 
      "default": "video"
    }, 
    "percentage": {
      "$ref": "Player.Position.Percentage", 
      "default": 0
    }, 
    "position": {
      "$ref": "Playlist.Position", 
      "default": -1
    }, 
    "subtitleenabled": {
      "type": "boolean", 
      "default": false
    }, 
    "time": {
      "$ref": "Global.Time"
    }, 
    "partymode": {
      "type": "boolean", 
      "default": false
    }, 
    "canmove": {
      "type": "boolean", 
      "default": false
    }, 
    "live": {
      "type": "boolean", 
      "default": false
    }, 
    "speed": {
      "type": "integer", 
      "default": 0
    }, 
    "playlistid": {
      "$ref": "Playlist.Id", 
      "default": -1
    }, 
    "currentaudiostream": {
      "$ref": "Player.Audio.Stream.Extended"
    }, 
    "shuffled": {
      "type": "boolean", 
      "default": false
    }, 
    "canzoom": {
      "type": "boolean", 
      "default": false
    }, 
    "canshuffle": {
      "type": "boolean", 
      "default": false
    }, 
    "totaltime": {
      "$ref": "Global.Time"
    }, 
    "subtitles": {
      "type": "array", 
      "items": {
        "$ref": "Player.Subtitle"
      }
    }, 
    "currentsubtitle": {
      "$ref": "Player.Subtitle"
    }, 
    "canseek": {
      "type": "boolean", 
      "default": false
    }, 
    "canrepeat": {
      "type": "boolean", 
      "default": false
    }, 
    "audiostreams": {
      "type": "array", 
      "items": {
        "$ref": "Player.Audio.Stream"
      }
    }, 
    "repeat": {
      "$ref": "Player.Repeat", 
      "default": "off"
    }, 
    "canrotate": {
      "type": "boolean", 
      "default": false
    }
  }
}

Player.Repeat

Type: string

JSON Schema Description
{ "id": "Player.Repeat", "type": "string", "enums": [ "off", "one", "all" ], "default": "off" }

Player.Speed

Type: object
Properties:

[ integer speed = 0 ]

JSON Schema Description
{ "id": "Player.Speed", "type": "object", "required": true, "properties": { "speed": { "type": "integer", "default": 0 } } }

Player.Subtitle

Type: object
Properties:

string language
string name
integer index

JSON Schema Description

{
  "id": "Player.Subtitle", 
  "type": "object", 
  "properties": {
    "language": {
      "type": "string", 
      "required": true
    }, 
    "name": {
      "type": "string", 
      "required": true
    }, 
    "index": {
      "required": true, 
      "type": "integer", 
      "minimum": 0
    }
  }
}

Player.Type

Type: string

JSON Schema Description
{ "id": "Player.Type", "type": "string", "enums": [ "video", "audio", "picture" ], "default": "video" }

Playlist

Playlist.Id

Type: integer

JSON Schema Description
{ "id": "Playlist.Id", "type": "integer", "minimum": 0, "maximum": 2, "default": -1 }

Playlist.Item

Type: mixed

JSON Schema Description

{
  "id": "Playlist.Item", 
  "type": [
    {
      "properties": {
        "file": {
          "description": "Path to a file (not a directory) to be added to the playlist", 
          "type": "string", 
          "required": true
        }
      }, 
      "type": "object", 
      "additionalProperties": false
    }, 
    {
      "properties": {
        "directory": {
          "type": "string", 
          "required": true
        }
      }, 
      "type": "object", 
      "additionalProperties": false
    }, 
    {
      "properties": {
        "movieid": {
          "$ref": "Library.Id", 
          "required": true
        }
      }, 
      "type": "object", 
      "additionalProperties": false
    }, 
    {
      "properties": {
        "episodeid": {
          "$ref": "Library.Id", 
          "required": true
        }
      }, 
      "type": "object", 
      "additionalProperties": false
    }, 
    {
      "properties": {
        "musicvideoid": {
          "$ref": "Library.Id", 
          "required": true
        }
      }, 
      "type": "object", 
      "additionalProperties": false
    }, 
    {
      "properties": {
        "artistid": {
          "$ref": "Library.Id", 
          "required": true
        }
      }, 
      "type": "object", 
      "additionalProperties": false
    }, 
    {
      "properties": {
        "albumid": {
          "$ref": "Library.Id", 
          "required": true
        }
      }, 
      "type": "object", 
      "additionalProperties": false
    }, 
    {
      "properties": {
        "songid": {
          "$ref": "Library.Id", 
          "required": true
        }
      }, 
      "type": "object", 
      "additionalProperties": false
    }, 
    {
      "properties": {
        "genreid": {
          "$ref": "Library.Id", 
          "description": "Identification of a genre from the AudioLibrary", 
          "required": true
        }
      }, 
      "type": "object", 
      "additionalProperties": false
    }
  ]
}

Playlist.Position

Type: integer

JSON Schema Description
{ "id": "Playlist.Position", "type": "integer", "minimum": 0, "default": -1 }

Playlist.Property.Name

Type: string

JSON Schema Description
{ "id": "Playlist.Property.Name", "type": "string", "enums": [ "type", "size" ], "default": "type" }

Playlist.Property.Value

Type: object
Properties:

[ integer size = 0 ]
[ Playlist.Type type = "unknown" ]

JSON Schema Description
{ "id": "Playlist.Property.Value", "type": "object", "properties": { "size": { "type": "integer", "minimum": 0, "default": 0 }, "type": { "$ref": "Playlist.Type", "default": "unknown" } } }

Playlist.Type

Type: string

JSON Schema Description
{ "id": "Playlist.Type", "type": "string", "enums": [ "unknown", "video", "audio", "picture", "mixed" ], "default": "unknown" }

System

System.Property.Name

Type: string

JSON Schema Description
{ "id": "System.Property.Name", "type": "string", "enums": [ "canshutdown", "cansuspend", "canhibernate", "canreboot" ], "default": "canshutdown" }

System.Property.Value

Type: object
Properties:

[ boolean canshutdown = False ]
[ boolean cansuspend = False ]
[ boolean canhibernate = False ]
[ boolean canreboot = False ]

JSON Schema Description

{
  "id": "System.Property.Value", 
  "type": "object", 
  "properties": {
    "canshutdown": {
      "type": "boolean", 
      "default": false
    }, 
    "cansuspend": {
      "type": "boolean", 
      "default": false
    }, 
    "canhibernate": {
      "type": "boolean", 
      "default": false
    }, 
    "canreboot": {
      "type": "boolean", 
      "default": false
    }
  }
}

Video

Video.Cast

Type: array

JSON Schema Description

{
  "id": "Video.Cast", 
  "type": "array", 
  "items": {
    "properties": {
      "name": {
        "type": "string", 
        "required": true
      }, 
      "role": {
        "type": "string", 
        "required": true
      }, 
      "thumbnail": {
        "type": "string", 
        "default": ""
      }
    }, 
    "type": "object", 
    "additionalProperties": false
  }
}

Video.Details.Base

Extends:

Media.Details.Base

Properties:

[ Media.Artwork art ]
[ integer playcount = 0 ]

JSON Schema Description
{ "id": "Video.Details.Base", "extends": "Media.Details.Base", "properties": { "art": { "$ref": "Media.Artwork" }, "playcount": { "type": "integer", "default": 0 } } }

Video.Details.Episode

Extends:

Video.Details.File

Properties:

[ string showtitle = "" ]
[ object uniqueid ]
[ string firstaired = "" ]
[ Video.Cast cast ]
[ string originaltitle = "" ]
[ string votes = "" ]
Library.Id episodeid
[ Array.String writer ]
[ integer season = 0 ]
[ string productioncode = "" ]
[ integer episode = 0 ]
[ Library.Id tvshowid = -1 ]
[ number rating = 0 ]

JSON Schema Description

{
  "id": "Video.Details.Episode", 
  "extends": "Video.Details.File", 
  "properties": {
    "showtitle": {
      "type": "string", 
      "default": ""
    }, 
    "uniqueid": {
      "type": "object", 
      "additionalProperties": {
        "type": "string", 
        "minLength": 1, 
        "default": ""
      }
    }, 
    "firstaired": {
      "type": "string", 
      "default": ""
    }, 
    "cast": {
      "$ref": "Video.Cast"
    }, 
    "originaltitle": {
      "type": "string", 
      "default": ""
    }, 
    "votes": {
      "type": "string", 
      "default": ""
    }, 
    "episodeid": {
      "$ref": "Library.Id", 
      "required": true
    }, 
    "writer": {
      "$ref": "Array.String"
    }, 
    "season": {
      "type": "integer", 
      "default": 0
    }, 
    "productioncode": {
      "type": "string", 
      "default": ""
    }, 
    "episode": {
      "type": "integer", 
      "default": 0
    }, 
    "tvshowid": {
      "$ref": "Library.Id", 
      "default": -1
    }, 
    "rating": {
      "type": "number", 
      "default": 0
    }
  }
}

Video.Details.File

Extends:

Video.Details.Item

Properties:

[ Video.Resume resume ]
[ Video.Streams streamdetails ]
[ string runtime = "" ]
[ Array.String director ]

JSON Schema Description

{
  "id": "Video.Details.File", 
  "extends": "Video.Details.Item", 
  "properties": {
    "resume": {
      "$ref": "Video.Resume"
    }, 
    "streamdetails": {
      "$ref": "Video.Streams"
    }, 
    "runtime": {
      "type": "string", 
      "default": ""
    }, 
    "director": {
      "$ref": "Array.String"
    }
  }
}

Video.Details.Item

Extends:

Video.Details.Media

Properties:

[ string lastplayed = "" ]
[ string file = "" ]
[ string dateadded = "" ]
[ string plot = "" ]

JSON Schema Description

{
  "id": "Video.Details.Item", 
  "extends": "Video.Details.Media", 
  "properties": {
    "lastplayed": {
      "type": "string", 
      "default": ""
    }, 
    "file": {
      "type": "string", 
      "default": ""
    }, 
    "dateadded": {
      "type": "string", 
      "default": ""
    }, 
    "plot": {
      "type": "string", 
      "default": ""
    }
  }
}

Video.Details.Media

Extends:

Video.Details.Base

Properties:

[ string title = "" ]

JSON Schema Description
{ "id": "Video.Details.Media", "extends": "Video.Details.Base", "properties": { "title": { "type": "string", "default": "" } } }

Video.Details.Movie

Extends:

Video.Details.File

Properties:

[ string trailer = "" ]
[ integer year = 0 ]
[ integer top250 = 0 ]
[ Array.String country ]
[ Array.String genre ]
[ Array.String showlink ]
[ Array.String studio ]
[ Array.String tag ]
[ Video.Cast cast ]
[ string originaltitle = "" ]
[ string votes = "" ]
[ string sorttitle = "" ]
[ Array.String writer ]
[ string imdbnumber = "" ]
[ string mpaa = "" ]
[ string tagline = "" ]
Library.Id movieid
[ string set = "" ]
[ string plotoutline = "" ]
[ number rating = 0 ]
[ Library.Id setid = -1 ]

JSON Schema Description

{
  "id": "Video.Details.Movie", 
  "extends": "Video.Details.File", 
  "properties": {
    "trailer": {
      "type": "string", 
      "default": ""
    }, 
    "year": {
      "type": "integer", 
      "default": 0
    }, 
    "top250": {
      "type": "integer", 
      "default": 0
    }, 
    "country": {
      "$ref": "Array.String"
    }, 
    "genre": {
      "$ref": "Array.String"
    }, 
    "showlink": {
      "$ref": "Array.String"
    }, 
    "studio": {
      "$ref": "Array.String"
    }, 
    "tag": {
      "$ref": "Array.String"
    }, 
    "cast": {
      "$ref": "Video.Cast"
    }, 
    "originaltitle": {
      "type": "string", 
      "default": ""
    }, 
    "votes": {
      "type": "string", 
      "default": ""
    }, 
    "sorttitle": {
      "type": "string", 
      "default": ""
    }, 
    "writer": {
      "$ref": "Array.String"
    }, 
    "imdbnumber": {
      "type": "string", 
      "default": ""
    }, 
    "mpaa": {
      "type": "string", 
      "default": ""
    }, 
    "tagline": {
      "type": "string", 
      "default": ""
    }, 
    "movieid": {
      "$ref": "Library.Id", 
      "required": true
    }, 
    "set": {
      "type": "string", 
      "default": ""
    }, 
    "plotoutline": {
      "type": "string", 
      "default": ""
    }, 
    "rating": {
      "type": "number", 
      "default": 0
    }, 
    "setid": {
      "$ref": "Library.Id", 
      "default": -1
    }
  }
}

Video.Details.MovieSet

Extends:

Video.Details.Media

Properties:

Library.Id setid

JSON Schema Description
{ "id": "Video.Details.MovieSet", "extends": "Video.Details.Media", "properties": { "setid": { "$ref": "Library.Id", "required": true } } }

Video.Details.MovieSet.Extended

Extends:

Video.Details.MovieSet

Properties:

List.LimitsReturned limits
[ Video.Details.Movie[] movies ]

JSON Schema Description

{
  "id": "Video.Details.MovieSet.Extended", 
  "extends": "Video.Details.MovieSet", 
  "properties": {
    "limits": {
      "$ref": "List.LimitsReturned", 
      "required": true
    }, 
    "movies": {
      "type": "array", 
      "items": {
        "$ref": "Video.Details.Movie"
      }
    }
  }
}

Video.Details.MusicVideo

Extends:

Video.Details.File

Properties:

[ integer year = 0 ]
Library.Id musicvideoid
[ integer track = 0 ]
[ Array.String genre ]
[ Array.String artist ]
[ Array.String studio ]
[ Array.String tag ]
[ string album = "" ]

JSON Schema Description

{
  "id": "Video.Details.MusicVideo", 
  "extends": "Video.Details.File", 
  "properties": {
    "year": {
      "type": "integer", 
      "default": 0
    }, 
    "musicvideoid": {
      "$ref": "Library.Id", 
      "required": true
    }, 
    "track": {
      "type": "integer", 
      "default": 0
    }, 
    "genre": {
      "$ref": "Array.String"
    }, 
    "artist": {
      "$ref": "Array.String"
    }, 
    "studio": {
      "$ref": "Array.String"
    }, 
    "tag": {
      "$ref": "Array.String"
    }, 
    "album": {
      "type": "string", 
      "default": ""
    }
  }
}

Video.Details.Season

Extends:

Video.Details.Base

Properties:

[ string showtitle = "" ]
[ integer episode = 0 ]
[ integer watchedepisodes = 0 ]
[ Library.Id tvshowid = -1 ]
integer season

JSON Schema Description

{
  "id": "Video.Details.Season", 
  "extends": "Video.Details.Base", 
  "properties": {
    "showtitle": {
      "type": "string", 
      "default": ""
    }, 
    "episode": {
      "type": "integer", 
      "default": 0
    }, 
    "watchedepisodes": {
      "type": "integer", 
      "default": 0
    }, 
    "tvshowid": {
      "$ref": "Library.Id", 
      "default": -1
    }, 
    "season": {
      "type": "integer", 
      "required": true
    }
  }
}

Video.Details.TVShow

Extends:

Video.Details.Item

Properties:

[ string imdbnumber = "" ]
[ integer season = 0 ]
[ Array.String genre ]
[ string sorttitle = "" ]
[ Array.String studio ]
[ Array.String tag ]
[ Video.Cast cast ]
[ string originaltitle = "" ]
[ string votes = "" ]
[ string premiered = "" ]
[ integer watchedepisodes = 0 ]
[ number rating = 0 ]
[ string mpaa = "" ]
[ integer year = 0 ]
[ integer episode = 0 ]
Library.Id tvshowid
[ string episodeguide = "" ]

JSON Schema Description

{
  "id": "Video.Details.TVShow", 
  "extends": "Video.Details.Item", 
  "properties": {
    "imdbnumber": {
      "type": "string", 
      "default": ""
    }, 
    "season": {
      "type": "integer", 
      "default": 0
    }, 
    "genre": {
      "$ref": "Array.String"
    }, 
    "sorttitle": {
      "type": "string", 
      "default": ""
    }, 
    "studio": {
      "$ref": "Array.String"
    }, 
    "tag": {
      "$ref": "Array.String"
    }, 
    "cast": {
      "$ref": "Video.Cast"
    }, 
    "originaltitle": {
      "type": "string", 
      "default": ""
    }, 
    "votes": {
      "type": "string", 
      "default": ""
    }, 
    "premiered": {
      "type": "string", 
      "default": ""
    }, 
    "watchedepisodes": {
      "type": "integer", 
      "default": 0
    }, 
    "rating": {
      "type": "number", 
      "default": 0
    }, 
    "mpaa": {
      "type": "string", 
      "default": ""
    }, 
    "year": {
      "type": "integer", 
      "default": 0
    }, 
    "episode": {
      "type": "integer", 
      "default": 0
    }, 
    "tvshowid": {
      "$ref": "Library.Id", 
      "required": true
    }, 
    "episodeguide": {
      "type": "string", 
      "default": ""
    }
  }
}

Video.Fields.Episode

Extends:

Item.Fields.Base

JSON Schema Description

{
  "id": "Video.Fields.Episode", 
  "extends": "Item.Fields.Base", 
  "items": {
    "description": "Requesting the cast field will result in increased response times", 
    "type": "string", 
    "enums": [
      "title", 
      "plot", 
      "votes", 
      "rating", 
      "writer", 
      "firstaired", 
      "playcount", 
      "runtime", 
      "director", 
      "productioncode", 
      "season", 
      "episode", 
      "originaltitle", 
      "showtitle", 
      "cast", 
      "streamdetails", 
      "lastplayed", 
      "fanart", 
      "thumbnail", 
      "file", 
      "resume", 
      "tvshowid", 
      "dateadded", 
      "uniqueid", 
      "art"
    ]
  }
}

Video.Fields.Movie

Extends:

Item.Fields.Base

JSON Schema Description

{
  "id": "Video.Fields.Movie", 
  "extends": "Item.Fields.Base", 
  "items": {
    "description": "Requesting the cast, showlink and/or tag field will result in increased response times", 
    "type": "string", 
    "enums": [
      "title", 
      "genre", 
      "year", 
      "rating", 
      "director", 
      "trailer", 
      "tagline", 
      "plot", 
      "plotoutline", 
      "originaltitle", 
      "lastplayed", 
      "playcount", 
      "writer", 
      "studio", 
      "mpaa", 
      "cast", 
      "country", 
      "imdbnumber", 
      "runtime", 
      "set", 
      "showlink", 
      "streamdetails", 
      "top250", 
      "votes", 
      "fanart", 
      "thumbnail", 
      "file", 
      "sorttitle", 
      "resume", 
      "setid", 
      "dateadded", 
      "tag", 
      "art"
    ]
  }
}

Video.Fields.MovieSet

Extends:

Item.Fields.Base

JSON Schema Description
{ "id": "Video.Fields.MovieSet", "extends": "Item.Fields.Base", "items": { "type": "string", "enums": [ "title", "playcount", "fanart", "thumbnail", "art" ] } }

Video.Fields.MusicVideo

Extends:

Item.Fields.Base

JSON Schema Description

{
  "id": "Video.Fields.MusicVideo", 
  "extends": "Item.Fields.Base", 
  "items": {
    "type": "string", 
    "enums": [
      "title", 
      "playcount", 
      "runtime", 
      "director", 
      "studio", 
      "year", 
      "plot", 
      "album", 
      "artist", 
      "genre", 
      "track", 
      "streamdetails", 
      "lastplayed", 
      "fanart", 
      "thumbnail", 
      "file", 
      "resume", 
      "dateadded", 
      "tag", 
      "art"
    ]
  }
}

Video.Fields.Season

Extends:

Item.Fields.Base

JSON Schema Description

{
  "id": "Video.Fields.Season", 
  "extends": "Item.Fields.Base", 
  "items": {
    "type": "string", 
    "enums": [
      "season", 
      "showtitle", 
      "playcount", 
      "episode", 
      "fanart", 
      "thumbnail", 
      "tvshowid", 
      "watchedepisodes", 
      "art"
    ]
  }
}

Video.Fields.TVShow

Extends:

Item.Fields.Base

JSON Schema Description

{
  "id": "Video.Fields.TVShow", 
  "extends": "Item.Fields.Base", 
  "items": {
    "description": "Requesting the cast field will result in increased response times", 
    "type": "string", 
    "enums": [
      "title", 
      "genre", 
      "year", 
      "rating", 
      "plot", 
      "studio", 
      "mpaa", 
      "cast", 
      "playcount", 
      "episode", 
      "imdbnumber", 
      "premiered", 
      "votes", 
      "lastplayed", 
      "fanart", 
      "thumbnail", 
      "file", 
      "originaltitle", 
      "sorttitle", 
      "episodeguide", 
      "season", 
      "watchedepisodes", 
      "dateadded", 
      "tag", 
      "art"
    ]
  }
}

Video.Resume

Type: object
Properties:

[ number total = 0 ]
[ number position = 0 ]

JSON Schema Description

{
  "id": "Video.Resume", 
  "type": "object", 
  "properties": {
    "total": {
      "type": "number", 
      "minimum": 0, 
      "default": 0
    }, 
    "position": {
      "type": "number", 
      "minimum": 0, 
      "default": 0
    }
  }, 
  "additionalProperties": false
}

Video.Streams

Type: object
Properties:

[ array[1..X] video ]
[ array[1..X] subtitle ]
[ array[1..X] audio ]

JSON Schema Description

{
  "id": "Video.Streams", 
  "type": "object", 
  "properties": {
    "video": {
      "type": "array", 
      "items": {
        "properties": {
          "height": {
            "type": "integer", 
            "default": 0
          }, 
          "aspect": {
            "type": "number", 
            "default": 0
          }, 
          "codec": {
            "type": "string", 
            "default": ""
          }, 
          "width": {
            "type": "integer", 
            "default": 0
          }, 
          "duration": {
            "type": "integer", 
            "default": 0
          }
        }, 
        "type": "object", 
        "additionalProperties": false
      }, 
      "minItems": 1
    }, 
    "subtitle": {
      "type": "array", 
      "items": {
        "properties": {
          "language": {
            "type": "string", 
            "default": ""
          }
        }, 
        "type": "object", 
        "additionalProperties": false
      }, 
      "minItems": 1
    }, 
    "audio": {
      "type": "array", 
      "items": {
        "properties": {
          "language": {
            "type": "string", 
            "default": ""
          }, 
          "codec": {
            "type": "string", 
            "default": ""
          }, 
          "channels": {
            "type": "integer", 
            "default": 0
          }
        }, 
        "type": "object", 
        "additionalProperties": false
      }, 
      "minItems": 1
    }
  }, 
  "additionalProperties": false
}

Notifications

Application

Application.OnVolumeChanged

The volume of the application has changed.
Parameters:

string sender
object data

Properties:

integer volume
boolean muted

JSON Schema Description

{
  "description": "The volume of the application has changed.", 
  "params": [
    {
      "name": "sender", 
      "type": "string", 
      "required": true
    }, 
    {
      "name": "data", 
      "type": "object", 
      "required": true, 
      "properties": {
        "volume": {
          "required": true, 
          "maximum": 100, 
          "type": "integer", 
          "minimum": 0
        }, 
        "muted": {
          "type": "boolean", 
          "required": true
        }
      }
    }
  ]
}

AudioLibrary

AudioLibrary.OnCleanFinished

The audio library has been cleaned.
Parameters:

string sender
null data

JSON Schema Description
{ "description": "The audio library has been cleaned.", "params": [ { "name": "sender", "type": "string", "required": true }, { "name": "data", "type": "null", "required": true } ] }

AudioLibrary.OnCleanStarted

An audio library clean operation has started.
Parameters:

string sender
null data

JSON Schema Description
{ "description": "An audio library clean operation has started.", "params": [ { "name": "sender", "type": "string", "required": true }, { "name": "data", "type": "null", "required": true } ] }

AudioLibrary.OnRemove

An audio item has been removed.
Parameters:

string sender
object data

Properties:

Library.Id id
Notifications.Library.Audio.Type type

JSON Schema Description

{
  "description": "An audio item has been removed.", 
  "params": [
    {
      "name": "sender", 
      "type": "string", 
      "required": true
    }, 
    {
      "name": "data", 
      "type": "object", 
      "required": true, 
      "properties": {
        "id": {
          "$ref": "Library.Id", 
          "required": true
        }, 
        "type": {
          "$ref": "Notifications.Library.Audio.Type", 
          "required": true
        }
      }
    }
  ]
}

AudioLibrary.OnScanFinished

Scanning the audio library has been finished.
Parameters:

string sender
null data

JSON Schema Description
{ "description": "Scanning the audio library has been finished.", "params": [ { "name": "sender", "type": "string", "required": true }, { "name": "data", "type": "null", "required": true } ] }

AudioLibrary.OnScanStarted

An audio library scan has started.
Parameters:

string sender
null data

JSON Schema Description
{ "description": "An audio library scan has started.", "params": [ { "name": "sender", "type": "string", "required": true }, { "name": "data", "type": "null", "required": true } ] }

AudioLibrary.OnUpdate

An audio item has been updated.
Parameters:

string sender
object data

Properties:

Library.Id id
string type

JSON Schema Description

{
  "description": "An audio item has been updated.", 
  "params": [
    {
      "name": "sender", 
      "type": "string", 
      "required": true
    }, 
    {
      "name": "data", 
      "type": "object", 
      "required": true, 
      "properties": {
        "id": {
          "$ref": "Library.Id", 
          "required": true
        }, 
        "type": {
          "required": true, 
          "id": "Notifications.Library.Audio.Type", 
          "type": "string", 
          "enum": [
            "song"
          ]
        }
      }
    }
  ]
}

Input

Input.OnInputFinished

The user has provided the requested input.
Parameters:

string sender
null data

JSON Schema Description
{ "description": "The user has provided the requested input.", "params": [ { "name": "sender", "type": "string", "required": true }, { "name": "data", "type": "null", "required": true } ] }

Input.OnInputRequested

The user is requested to provide some information.
Parameters:

string sender
object data

Properties:

[ string title ]
string value
string type

JSON Schema Description

{
  "description": "The user is requested to provide some information.", 
  "params": [
    {
      "name": "sender", 
      "type": "string", 
      "required": true
    }, 
    {
      "name": "data", 
      "type": "object", 
      "required": true, 
      "properties": {
        "title": {
          "type": "string"
        }, 
        "value": {
          "type": "string", 
          "required": true
        }, 
        "type": {
          "required": true, 
          "type": "string", 
          "enum": [
            "keyboard", 
            "time", 
            "date", 
            "ip", 
            "password", 
            "numericpassword", 
            "number", 
            "seconds"
          ]
        }
      }
    }
  ]
}

Player

Player.OnPause

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

string sender
Player.Notifications.Data data

JSON Schema Description

{
  "description": "Playback of a media item has been paused. If there is no ID available extra information will be provided.", 
  "params": [
    {
      "name": "sender", 
      "type": "string", 
      "required": true
    }, 
    {
      "$ref": "Player.Notifications.Data", 
      "name": "data", 
      "required": true
    }
  ]
}

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:

string sender
Player.Notifications.Data data

JSON Schema Description

{
  "description": "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.", 
  "params": [
    {
      "name": "sender", 
      "type": "string", 
      "required": true
    }, 
    {
      "$ref": "Player.Notifications.Data", 
      "name": "data", 
      "required": true
    }
  ]
}

Player.OnPropertyChanged

A property of the playing items has changed.
Parameters:

string sender
object data

Properties:

[ Player.Property.Value property ]
Player.Notifications.Player player

JSON Schema Description

{
  "description": "A property of the playing items has changed.", 
  "params": [
    {
      "name": "sender", 
      "type": "string", 
      "required": true
    }, 
    {
      "name": "data", 
      "type": "object", 
      "required": true, 
      "properties": {
        "property": {
          "$ref": "Player.Property.Value"
        }, 
        "player": {
          "$ref": "Player.Notifications.Player", 
          "required": true
        }
      }
    }
  ]
}

Player.OnSeek

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

string sender
object data

Properties:

Player.Notifications.Player.Seek player
[ Notifications.Item item ]

JSON Schema Description

{
  "description": "The playback position has been changed. If there is no ID available extra information will be provided.", 
  "params": [
    {
      "name": "sender", 
      "type": "string", 
      "required": true
    }, 
    {
      "name": "data", 
      "type": "object", 
      "required": true, 
      "properties": {
        "player": {
          "$ref": "Player.Notifications.Player.Seek", 
          "required": true
        }, 
        "item": {
          "$ref": "Notifications.Item"
        }
      }
    }
  ]
}

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:

string sender
Player.Notifications.Data data

JSON Schema Description

{
  "description": "Speed of the playback of a media item has been changed. If there is no ID available extra information will be provided.", 
  "params": [
    {
      "name": "sender", 
      "type": "string", 
      "required": true
    }, 
    {
      "$ref": "Player.Notifications.Data", 
      "name": "data", 
      "required": true
    }
  ]
}

Player.OnStop

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

string sender
object data

Properties:

boolean end
[ Notifications.Item item ]

JSON Schema Description

{
  "description": "Playback of a media item has been stopped. If there is no ID available extra information will be provided.", 
  "params": [
    {
      "name": "sender", 
      "type": "string", 
      "required": true
    }, 
    {
      "name": "data", 
      "type": "object", 
      "required": true, 
      "properties": {
        "end": {
          "description": "Whether the player has reached the end of the playable item(s) or not", 
          "type": "boolean", 
          "required": true
        }, 
        "item": {
          "$ref": "Notifications.Item"
        }
      }
    }
  ]
}

Playlist

Playlist.OnAdd

A playlist item has been added.
Parameters:

string sender
object data

Properties:

Playlist.Id playlistid
[ Playlist.Position position ]
[ Notifications.Item item ]

JSON Schema Description

{
  "description": "A playlist item has been added.", 
  "params": [
    {
      "name": "sender", 
      "type": "string", 
      "required": true
    }, 
    {
      "name": "data", 
      "type": "object", 
      "required": true, 
      "properties": {
        "playlistid": {
          "$ref": "Playlist.Id", 
          "required": true
        }, 
        "position": {
          "$ref": "Playlist.Position"
        }, 
        "item": {
          "$ref": "Notifications.Item"
        }
      }
    }
  ]
}

Playlist.OnClear

A playlist item has been cleared.
Parameters:

string sender
object data

Properties:

Playlist.Id playlistid

JSON Schema Description

{
  "description": "A playlist item has been cleared.", 
  "params": [
    {
      "name": "sender", 
      "type": "string", 
      "required": true
    }, 
    {
      "name": "data", 
      "type": "object", 
      "required": true, 
      "properties": {
        "playlistid": {
          "$ref": "Playlist.Id", 
          "required": true
        }
      }
    }
  ]
}

Playlist.OnRemove

A playlist item has been removed.
Parameters:

string sender
object data

Properties:

Playlist.Id playlistid
[ Playlist.Position position ]

JSON Schema Description

{
  "description": "A playlist item has been removed.", 
  "params": [
    {
      "name": "sender", 
      "type": "string", 
      "required": true
    }, 
    {
      "name": "data", 
      "type": "object", 
      "required": true, 
      "properties": {
        "playlistid": {
          "$ref": "Playlist.Id", 
          "required": true
        }, 
        "position": {
          "$ref": "Playlist.Position"
        }
      }
    }
  ]
}

System

System.OnLowBattery

The system is on low battery.
Parameters:

string sender
null data

JSON Schema Description
{ "description": "The system is on low battery.", "params": [ { "name": "sender", "type": "string", "required": true }, { "name": "data", "type": "null", "required": true } ] }

System.OnQuit

XBMC will be closed.
Parameters:

string sender
null data

JSON Schema Description
{ "description": "XBMC will be closed.", "params": [ { "name": "sender", "type": "string", "required": true }, { "name": "data", "type": "null", "required": true } ] }

System.OnRestart

The system will be restarted.
Parameters:

string sender
null data

JSON Schema Description
{ "description": "The system will be restarted.", "params": [ { "name": "sender", "type": "string", "required": true }, { "name": "data", "type": "null", "required": true } ] }

System.OnSleep

The system will be suspended.
Parameters:

string sender
null data

JSON Schema Description
{ "description": "The system will be suspended.", "params": [ { "name": "sender", "type": "string", "required": true }, { "name": "data", "type": "null", "required": true } ] }

System.OnWake

The system woke up from suspension.
Parameters:

string sender
null data

JSON Schema Description
{ "description": "The system woke up from suspension.", "params": [ { "name": "sender", "type": "string", "required": true }, { "name": "data", "type": "null", "required": true } ] }

VideoLibrary

VideoLibrary.OnCleanFinished

The video library has been cleaned.
Parameters:

string sender
null data

JSON Schema Description
{ "description": "The video library has been cleaned.", "params": [ { "name": "sender", "type": "string", "required": true }, { "name": "data", "type": "null", "required": true } ] }

VideoLibrary.OnCleanStarted

A video library clean operation has started.
Parameters:

string sender
null data

JSON Schema Description
{ "description": "A video library clean operation has started.", "params": [ { "name": "sender", "type": "string", "required": true }, { "name": "data", "type": "null", "required": true } ] }

VideoLibrary.OnRemove

A video item has been removed.
Parameters:

string sender
object data

Properties:

Library.Id id
Notifications.Library.Video.Type type

JSON Schema Description

{
  "description": "A video item has been removed.", 
  "params": [
    {
      "name": "sender", 
      "type": "string", 
      "required": true
    }, 
    {
      "name": "data", 
      "type": "object", 
      "required": true, 
      "properties": {
        "id": {
          "$ref": "Library.Id", 
          "required": true
        }, 
        "type": {
          "$ref": "Notifications.Library.Video.Type", 
          "required": true
        }
      }
    }
  ]
}

VideoLibrary.OnScanFinished

Scanning the video library has been finished.
Parameters:

string sender
null data

JSON Schema Description
{ "description": "Scanning the video library has been finished.", "params": [ { "name": "sender", "type": "string", "required": true }, { "name": "data", "type": "null", "required": true } ] }

VideoLibrary.OnScanStarted

A video library scan has started.
Parameters:

string sender
null data

JSON Schema Description
{ "description": "A video library scan has started.", "params": [ { "name": "sender", "type": "string", "required": true }, { "name": "data", "type": "null", "required": true } ] }

VideoLibrary.OnUpdate

A video item has been updated.
Parameters:

string sender
object data

Properties:

Library.Id id
string type
[ integer playcount = -1 ]

JSON Schema Description

{
  "description": "A video item has been updated.", 
  "params": [
    {
      "name": "sender", 
      "type": "string", 
      "required": true
    }, 
    {
      "name": "data", 
      "type": "object", 
      "required": true, 
      "properties": {
        "id": {
          "$ref": "Library.Id", 
          "required": true
        }, 
        "type": {
          "required": true, 
          "id": "Notifications.Library.Video.Type", 
          "type": "string", 
          "enum": [
            "movie", 
            "tvshow", 
            "episode", 
            "musicvideo"
          ]
        }, 
        "playcount": {
          "type": "integer", 
          "minimum": 0, 
          "default": -1
        }
      }
    }
  ]
}

External links