Kodi/XBMC


Schemes	`kodi://`, `xbmc://`, `kodis://`, `xbmcs://`
Cargo feature	`service-kodi`
Service	http://kodi.tv/
Body formats	`text` (first is the default)
Attachments	no
Title length	250 characters
Body length	32,768 characters
Body lines	2 lines
Request throttle	none
Vendor URLs accepted	no

URL formats

{schema}://{host}
{schema}://{host}:{port}
{schema}://{user}:{password}@{host}
{schema}://{user}:{password}@{host}:{port}

{schema} is one of kodi://, xbmc://, kodis://, xbmcs://.

URL tokens

Token	Meaning	Type	Required	Notes
`{host}`	Hostname	string	yes
`{password}`	Password	string	no	secret
`{port}`	Port	int, 1 to 65535	no
`{user}`	Username	string	no

Query parameters

Parameter	Meaning	Type	Default	Notes
`duration`	Duration	int, min 1	`12`
`image`	Include Image	bool	`yes`

The common URL parameters (format, overflow, verify, redirect, cto, rto, retry, wait, store, tag, tz, user, password, port, optional, emojis) apply as well.

Examples

Accepted URLs (tokens are fake):

kodi://localhost
xbmc://localhost
xbmc://user@localhost
kodi://user:pass@localhost
kodis://localhost:8080/path/
xbmcs://user:pass@localhost:443
kodis://user:password@localhost:8080
kodi://localhost?image=no

Rejected URLs:

kodi://
kodis://
kodi://:@/
xbmc://

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'kodi://localhost'

Notes

Kodi / XBMC (kodi://, xbmc://, kodis://, xbmcs://): on-screen notifications through the Kodi JSON-RPC API.