XBMC / Kodi

Feature	Support
Sending
Receiving
Config

Supported Brands

None

Sender Arguments

None

Config

{
  "devices": {
    "xbmc": {
      "protocol": [ "xbmc" ],
      "id": [{
        "server": "127.0.0.1",
        "port": 9090
      }],
      "action": "shutdown",
      "media": "none"
    }
  },
  "gui": {
    "xbmc": {
      "name": "XBMC",
      "group": [ "Programs" ],
      "media": [ "all" ]
    }
  }
}

Option	Value
server	valid ip
port	1 - 65535
action	shutdown home play pause active inactive
media	none episode movie movies song screensaver

Note

• The shutdown and home actions are only allowed for the none media.
• The play, home, and pause actions are only allowed for the episode, movie, movies, or song media.
• The active and inactive actions are only allowed for the screensaver media.

Optional Settings

GUI Settings

Setting	Default	Format	Description
show-media	1	1 or 0	Don’t display the media icon
show-action	1	1 or 0	Don’t display the action icon

Comment

The XBMC protocol will try to connect to a XBMC instance. However, make sure the JSON-RPC API is enabled in XBMC. You don’t need to do anything more. Whenever a connection to XBMC is lost, the protocol will automatically try to reconnect. The XBMC protocol sends several messages depending on the actions in XBMC.

Media	Action
movie	play, pause
song	play, pause
episode	play, pause
none	shutdown, home

The stop event isn’t recording, but pilight will interpret as the home action of the none media. So when XBMC is started or when nothing plays, the action will be home. When pilight can’t connect to XBMC or when the connection is lost the shutdown action of the none media will be sent.

Important

pilight uses JSON-RPC via TCP-Port 9090. Don’t mix it up with JSON-RPC via HTTP which is available over port 8080 by default (http://Kodi:8080/jsonrpc). This setting is hidden in Kodi/XBMC.