This file contains invisible Unicode characters that may be processed differently from what appears below. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to reveal hidden characters.
This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<!--<link rel="shortcut icon" href="https://www.openhab.org/favicon.png"></link>-->
<title>XBMC binding (for KODI) (1.x) - Bindings - openHAB 2 - Empowering the Smart Home</title>
<!-- CSS -->
<link type="text/css" rel="stylesheet" href="/v2.1/css/materialize.css" media="screen,projection" />
<link type="text/css" rel="stylesheet" href="/v2.1/css/pygments-jekyll-style.css" />
<link type="text/css" rel="stylesheet" href="/v2.1/css/styles.css" />
<link type="text/css" rel="stylesheet" href="/v2.1/css/openhab.css" />
<link type="text/css" rel="stylesheet" href="/v2.1/css/collapsible.css" />
<!-- Font -->
<link type="text/css" rel="stylesheet" href="https://fonts.googleapis.com/icon?family=Material+Icons" />
<link type="text/css" rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,400,700" />
<link rel="canonical" href="http://docs.openhab.org/addons/bindings/xbmc1/readme.html" />
<script type="text/javascript">var gaProperty = 'UA-47717934-3';var disableStr = 'ga-disable-' + gaProperty;if (document.cookie.indexOf(disableStr + '=true') > -1) {window[disableStr] = true;}</script>
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-47717934-3', 'auto');
ga('set', 'anonymizeIp', true);
ga('send', 'pageview');
</script>
</head>
<body class="documentation">
<div id="header" class="navbar-fixed">
<nav role="navigation">
<div class="container">
<div class="nav-wrapper">
<a href="/v2.1/index.html"><img id="logo" src="/images/logo.png" /></a>
<a href="#" data-activates="nav-mobile" class="button-collapse"><i class="material-icons">menu</i></a>
<ul class="right hide-on-med-and-down">
<li><a href="/tutorials/index.html">Tutorials</a></li>
<li><a href="/v2.1/introduction.html">User Manual</a></li>
<li><a href="/developers/index.html">Developer Guide</a></li>
<li><a target="_blank" href="https://community.openhab.org">Community Forum</a></li>
<li><a target="_blank" href="https://github.com/openhab">GitHub</a></li>
<li class="search"><i class="material-icons">search</i></li>
<li class="search">
<form method="GET" id="searchform" class="search-form" action="/search">
<input id="query" name="q" type="text" class="search-form-input" placeholder="search" />
</form>
</li>
</ul>
<ul id="nav-mobile" class="side-nav">
<li><a href="/v2.1/index.html">Home</a></li>
<li><a href="/tutorials/index.html">Tutorials</a></li>
<li><a href="/v2.1/introduction.html">User Manual</a></li>
<li><a href="/developers/index.html">Developer Guide</a></li>
<li><a target="_blank" href="https://community.openhab.org">Community Forum</a></li>
<li><a target="_blank" href="https://github.com/openhab">GitHub</a></li>
<li class="search">
<form method="GET" id="searchformmob" class="search-form" action="/search">
<input id="querymob" name="q" type="text" class="search-form-input" placeholder="search" />
</form>
</li>
</ul>
</div>
</div>
</nav>
</div>
<section id="documentation" class="text content-wrapper">
<div class="container">
<div class="side-nav-wrapper">
<ul class="nav">
<li><a href="/v2.1/introduction.html">Introduction</a></li>
<li><a href="/v2.1/concepts/index.html">Concepts</a>
<ul>
<li><a href="/v2.1/concepts/index.html">Overview</a></li>
<hr />
<li><a href="/v2.1/concepts/things.html">Things</a></li>
<li><a href="/v2.1/concepts/items.html">Items</a></li>
<li><a href="/v2.1/concepts/discovery.html">Inbox & Discovery</a></li>
<li><a href="/v2.1/concepts/audio.html">Audio & Voice</a></li>
</ul>
</li>
<li><a href="/v2.1/installation/index.html">Installation</a>
<ul>
<li><a href="/v2.1/installation/index.html">Overview</a></li>
<hr />
<li><a href="/v2.1/installation/linux.html">Linux</a></li>
<li><a href="/v2.1/installation/windows.html">Windows</a></li>
<li><a href="/v2.1/installation/macosx.html">Mac OS X</a></li>
<hr />
<li><a href="/v2.1/installation/openhabian.html">openHABian</a></li>
<li><a href="/v2.1/installation/docker.html">Docker</a></li>
<hr />
<li><a href="/v2.1/installation/rasppi.html">Raspberry Pi</a></li>
<li><a href="/v2.1/installation/pine.html">Pine A64</a></li>
<li><a href="/v2.1/installation/synology.html">Synology DiskStation</a></li>
<li><a href="/v2.1/installation/qnap.html">QNAP NAS</a></li>
<hr />
<li><a href="/v2.1/installation/designer.html">SmartHome Designer</a></li>
<li><a href="/v2.1/installation/security.html">Security & Remote Access</a></li>
<li><a href="http://www.myopenhab.org">myopenHAB</a></li>
</ul>
</li>
<li><a href="/v2.1/configuration/index.html">Configuration</a>
<ul>
<li><a href="/v2.1/configuration/index.html">Overview</a></li>
<hr />
<li><a href="/v2.1/configuration/things.html">Things</a></li>
<li><a href="/v2.1/configuration/items.html">Items</a></li>
<li><a href="/v2.1/configuration/sitemaps.html">Sitemaps</a></li>
<li><a href="/v2.1/configuration/transform.html">Transformations</a></li>
<li><a href="/v2.1/configuration/persistence.html">Persistence</a></li>
<li><a href="/v2.1/configuration/rules-dsl.html">Rules</a></li>
<li><a href="/v2.1/configuration/services.html">Services</a></li>
<hr />
<li><a href="/v2.1/configuration/packages.html">Initial Setup Packages</a></li>
<li><a href="/v2.1/configuration/paperui.html">Paper UI</a></li>
<li><a href="/v2.1/configuration/habmin.html">HABmin</a></li>
<li><a href="/v2.1/configuration/rules-ng.html">Rules (Experimental)</a></li>
<hr />
<li><a href="/v2.1/configuration/multimedia.html">Audio & Voice</a></li>
</ul>
</li>
<li><a href="/v2.1/addons/index.html">Add-ons</a>
<ul>
<li><a href="/v2.1/addons/index.html">Overview</a></li>
<hr />
<li><a href="/v2.1/addons/bindings.html">Bindings</a>
<ul>
<li><a href="/v2.1/addons/bindings.html">Overview</a></li>
<hr />
<li><a href="/v2.1/addons/bindings/airquality/readme.html">Air Quality</a></li>
<li><a href="/v2.1/addons/bindings/akm8681/readme.html">AKM868</a></li>
<li><a href="/v2.1/addons/bindings/alarmdecoder1/readme.html">Alarm Decoder</a></li>
<li><a href="/v2.1/addons/bindings/allplay/readme.html">AllPlay</a></li>
<li><a href="/v2.1/addons/bindings/amazondashbutton/readme.html">Amazon Dash Button</a></li>
<li><a href="/v2.1/addons/bindings/anel1/readme.html">Anel NET-PwrCtrl</a></li>
<li><a href="/v2.1/addons/bindings/asterisk1/readme.html">Asterisk</a></li>
<li><a href="/v2.1/addons/bindings/astro/readme.html">Astro</a></li>
<li><a href="/v2.1/addons/bindings/astro1/readme.html">Astro</a></li>
<li><a href="/v2.1/addons/bindings/atlona/readme.html">Atlona</a></li>
<li><a href="/v2.1/addons/bindings/autelis/readme.html">Autelis Pool Control</a></li>
<li><a href="/v2.1/addons/bindings/autelis1/readme.html">Autelis</a></li>
<li><a href="/v2.1/addons/bindings/avmfritz/readme.html">AVM FRITZ!</a></li>
<li><a href="/v2.1/addons/bindings/benqprojector1/readme.html">BenQ Projector</a></li>
<li><a href="/v2.1/addons/bindings/bigassfan/readme.html">BigAssFan</a></li>
<li><a href="/v2.1/addons/bindings/bluetooth1/readme.html">Bluetooth</a></li>
<li><a href="/v2.1/addons/bindings/boschindego/readme.html">Bosch Indego</a></li>
<li><a href="/v2.1/addons/bindings/bticino1/readme.html">Bticino</a></li>
<li><a href="/v2.1/addons/bindings/caldav-command1/readme.html">CalDAV Command</a></li>
<li><a href="/v2.1/addons/bindings/caldav-personal1/readme.html">CalDAV Personal</a></li>
<li><a href="/v2.1/addons/bindings/chromecast/readme.html">Chromecast</a></li>
<li><a href="/v2.1/addons/bindings/comfoair1/readme.html">ComfoAir</a></li>
<li><a href="/v2.1/addons/bindings/configadmin1/readme.html">ConfigAdmin</a></li>
<li><a href="/v2.1/addons/bindings/coolmasternet/readme.html">CoolMasterNet</a></li>
<li><a href="/v2.1/addons/bindings/cups1/readme.html">CUPS</a></li>
<li><a href="/v2.1/addons/bindings/daikin1/readme.html">Daikin</a></li>
<li><a href="/v2.1/addons/bindings/davis1/readme.html">Davis</a></li>
<li><a href="/v2.1/addons/bindings/ddwrt1/readme.html">DD-WRT</a></li>
<li><a href="/v2.1/addons/bindings/denon1/readme.html">Denon</a></li>
<li><a href="/v2.1/addons/bindings/digitalstrom/readme.html">digitalSTROM</a></li>
<li><a href="/v2.1/addons/bindings/digitalstrom1/readme.html">digitalSTROM</a></li>
<li><a href="/v2.1/addons/bindings/diyonxbee1/readme.html">DIYOnXBee</a></li>
<li><a href="/v2.1/addons/bindings/dlinksmarthome/readme.html">D-Link Smart Home</a></li>
<li><a href="/v2.1/addons/bindings/dmx1/readme.html">DMX</a></li>
<li><a href="/v2.1/addons/bindings/dscalarm/readme.html">DSC Alarm</a></li>
<li><a href="/v2.1/addons/bindings/dscalarm1/readme.html">DSC PowerSeries Alarm System</a></li>
<li><a href="/v2.1/addons/bindings/dsmr1/readme.html">DSMR</a></li>
<li><a href="/v2.1/addons/bindings/ebus1/readme.html">eBUS</a></li>
<li><a href="/v2.1/addons/bindings/ecobee1/readme.html">Ecobee</a></li>
<li><a href="/v2.1/addons/bindings/ecotouch1/readme.html">EcoTouch</a></li>
<li><a href="/v2.1/addons/bindings/ekey1/readme.html">ekey</a></li>
<li><a href="/v2.1/addons/bindings/energenie1/readme.html">Energenie</a></li>
<li><a href="/v2.1/addons/bindings/enocean1/readme.html">EnOcean</a></li>
<li><a href="/v2.1/addons/bindings/enphaseenergy1/readme.html">Enphase Energy</a></li>
<li><a href="/v2.1/addons/bindings/epsonprojector1/readme.html">Epson Projector</a></li>
<li><a href="/v2.1/addons/bindings/exec/readme.html">Exec</a></li>
<li><a href="/v2.1/addons/bindings/exec1/readme.html">Exec</a></li>
<li><a href="/v2.1/addons/bindings/expire1/readme.html">Expire</a></li>
<li><a href="/v2.1/addons/bindings/fatekplc1/readme.html">Fatek PLC</a></li>
<li><a href="/v2.1/addons/bindings/feed/readme.html">Feed</a></li>
<li><a href="/v2.1/addons/bindings/fht1/readme.html">FHT</a></li>
<li><a href="/v2.1/addons/bindings/folding/readme.html">Folding@home</a></li>
<li><a href="/v2.1/addons/bindings/freebox/readme.html">Freebox</a></li>
<li><a href="/v2.1/addons/bindings/freebox1/readme.html">Freebox</a></li>
<li><a href="/v2.1/addons/bindings/freeswitch1/readme.html">FreeSWITCH</a></li>
<li><a href="/v2.1/addons/bindings/fritzaha1/readme.html">Fritz AHA</a></li>
<li><a href="/v2.1/addons/bindings/fritzbox1/readme.html">Fritz!Box</a></li>
<li><a href="/v2.1/addons/bindings/fritzboxtr0641/readme.html">Fritzbox (using TR064 protocol)</a></li>
<li><a href="/v2.1/addons/bindings/frontiersiliconradio1/readme.html">Frontier Silicon Radio</a></li>
<li><a href="/v2.1/addons/bindings/fs201/readme.html">FS20</a></li>
<li><a href="/v2.1/addons/bindings/fsinternetradio/readme.html">FS Internet Radio</a></li>
<li><a href="/v2.1/addons/bindings/garadget1/readme.html">Garadget</a></li>
<li><a href="/v2.1/addons/bindings/gardena/readme.html">Gardena</a></li>
<li><a href="/v2.1/addons/bindings/gc100ir1/readme.html">Global Cache IR</a></li>
<li><a href="/v2.1/addons/bindings/globalcache/readme.html">GlobalCache</a></li>
<li><a href="/v2.1/addons/bindings/gpio1/readme.html">GPIO</a></li>
<li><a href="/v2.1/addons/bindings/harmonyhub/readme.html">Logitech Harmony Hub</a></li>
<li><a href="/v2.1/addons/bindings/harmonyhub1/readme.html">Harmony Hub</a></li>
<li><a href="/v2.1/addons/bindings/hdanywhere/readme.html">HDanywhere</a></li>
<li><a href="/v2.1/addons/bindings/hdanywhere1/readme.html">HDanywhere</a></li>
<li><a href="/v2.1/addons/bindings/hdpowerview/readme.html">Hunter Douglas PowerView</a></li>
<li><a href="/v2.1/addons/bindings/heatmiser1/readme.html">Heatmiser</a></li>
<li><a href="/v2.1/addons/bindings/hms1/readme.html">HMS</a></li>
<li><a href="/v2.1/addons/bindings/homematic/readme.html">Homematic</a></li>
<li><a href="/v2.1/addons/bindings/homematic1/readme.html">Homematic</a></li>
<li><a href="/v2.1/addons/bindings/horizon1/readme.html">Horizon mediabox</a></li>
<li><a href="/v2.1/addons/bindings/http1/readme.html">HTTP</a></li>
<li><a href="/v2.1/addons/bindings/hue/readme.html">Philips Hue</a></li>
<li><a href="/v2.1/addons/bindings/hue1/readme.html">Hue</a></li>
<li><a href="/v2.1/addons/bindings/iec6205621meter1/readme.html">IEC 62056-21 Meter</a></li>
<li><a href="/v2.1/addons/bindings/ihc1/readme.html">IHC / ELKO</a></li>
<li><a href="/v2.1/addons/bindings/insteonhub1/readme.html">Insteon Hub</a></li>
<li><a href="/v2.1/addons/bindings/insteonplm1/readme.html">Insteon PLM</a></li>
<li><a href="/v2.1/addons/bindings/intertechno1/readme.html">Intertechno</a></li>
<li><a href="/v2.1/addons/bindings/ipp/readme.html">IPP</a></li>
<li><a href="/v2.1/addons/bindings/ipx8001/readme.html">IPX800</a></li>
<li><a href="/v2.1/addons/bindings/irtrans1/readme.html">IRTrans</a></li>
<li><a href="/v2.1/addons/bindings/isy1/readme.html">Description</a></li>
<li><a href="/v2.1/addons/bindings/jointspace1/readme.html">jointSPACE</a></li>
<li><a href="/v2.1/addons/bindings/k80551/readme.html">Velleman k8055 USB IO Board</a></li>
<li><a href="/v2.1/addons/bindings/keba/readme.html">Keba</a></li>
<li><a href="/v2.1/addons/bindings/km2001/readme.html">KM200</a></li>
<li><a href="/v2.1/addons/bindings/knx1/readme.html">KNX</a></li>
<li><a href="/v2.1/addons/bindings/kodi/readme.html">Kodi</a></li>
<li><a href="/v2.1/addons/bindings/kostalinverter/readme.html">Kostal Inverter</a></li>
<li><a href="/v2.1/addons/bindings/koubachi1/readme.html">Koubachi</a></li>
<li><a href="/v2.1/addons/bindings/lcn1/readme.html">LCN</a></li>
<li><a href="/v2.1/addons/bindings/lgtv1/readme.html">LG TV</a></li>
<li><a href="/v2.1/addons/bindings/lgtvserial/readme.html">LG TV control using serial protocol</a></li>
<li><a href="/v2.1/addons/bindings/lifx/readme.html">LIFX</a></li>
<li><a href="/v2.1/addons/bindings/lightwaverf1/readme.html">LightwaveRF</a></li>
<li><a href="/v2.1/addons/bindings/lutron/readme.html">Lutron</a></li>
<li><a href="/v2.1/addons/bindings/mailcontrol1/readme.html">MailControl</a></li>
<li><a href="/v2.1/addons/bindings/max/readme.html">MAX!</a></li>
<li><a href="/v2.1/addons/bindings/maxcube1/readme.html">MAX!Cube</a></li>
<li><a href="/v2.1/addons/bindings/maxcul1/readme.html">MAX!CUL</a></li>
<li><a href="/v2.1/addons/bindings/mcp230171/readme.html">MCP23017</a></li>
<li><a href="/v2.1/addons/bindings/mcp34241/readme.html">MCP3424</a></li>
<li><a href="/v2.1/addons/bindings/meteostick/readme.html">Meteostick</a></li>
<li><a href="/v2.1/addons/bindings/miele/readme.html">Miele@home</a></li>
<li><a href="/v2.1/addons/bindings/mihome/readme.html">Xiaomi Mi Smart Home</a></li>
<li><a href="/v2.1/addons/bindings/milight/readme.html">Milight/Easybulb/Limitless</a></li>
<li><a href="/v2.1/addons/bindings/milight1/readme.html">Milight</a></li>
<li><a href="/v2.1/addons/bindings/minecraft/readme.html">Minecraft</a></li>
<li><a href="/v2.1/addons/bindings/mios1/readme.html">MiOS Bridge</a></li>
<li><a href="/v2.1/addons/bindings/mochadx101/readme.html">Mochad X10</a></li>
<li><a href="/v2.1/addons/bindings/modbus1/readme.html">Modbus</a></li>
<li><a href="/v2.1/addons/bindings/mpd1/readme.html">MPD</a></li>
<li><a href="/v2.1/addons/bindings/mqtt1/readme.html">MQTT</a></li>
<li><a href="/v2.1/addons/bindings/mqttitude1/readme.html">OwnTracks (formerly MQTTitude)</a></li>
<li><a href="/v2.1/addons/bindings/myq1/readme.html">Chamberlain MyQ</a></li>
<li><a href="/v2.1/addons/bindings/mystromecopower1/readme.html">Mystrom Eco Power</a></li>
<li><a href="/v2.1/addons/bindings/neohub1/readme.html">NeoHub</a></li>
<li><a href="/v2.1/addons/bindings/nest1/readme.html">Nest</a></li>
<li><a href="/v2.1/addons/bindings/netatmo/readme.html">Netatmo</a></li>
<li><a href="/v2.1/addons/bindings/netatmo1/readme.html">Netatmo</a></li>
<li><a href="/v2.1/addons/bindings/network/readme.html">Network</a></li>
<li><a href="/v2.1/addons/bindings/networkhealth1/readme.html">Network Health</a></li>
<li><a href="/v2.1/addons/bindings/networkupstools1/readme.html">Network UPS Tools</a></li>
<li><a href="/v2.1/addons/bindings/nibeheatpump1/readme.html">Nibe Heatpump</a></li>
<li><a href="/v2.1/addons/bindings/nikobus1/readme.html">Nikobus</a></li>
<li><a href="/v2.1/addons/bindings/nikohomecontrol/readme.html">Niko Home Control</a></li>
<li><a href="/v2.1/addons/bindings/novelanheatpump1/readme.html">Novelan/Luxtronic Heat Pump</a></li>
<li><a href="/v2.1/addons/bindings/ntp/readme.html">NTP</a></li>
<li><a href="/v2.1/addons/bindings/ntp1/readme.html">Network Time Protocol (NTP)</a></li>
<li><a href="/v2.1/addons/bindings/oceanic/readme.html">Oceanic</a></li>
<li><a href="/v2.1/addons/bindings/omnilink1/readme.html">HAI/Leviton Omni and Lumina</a></li>
<li><a href="/v2.1/addons/bindings/onebusaway/readme.html">OneBusAway</a></li>
<li><a href="/v2.1/addons/bindings/onewire1/readme.html">OneWire</a></li>
<li><a href="/v2.1/addons/bindings/onkyo/readme.html">Onkyo</a></li>
<li><a href="/v2.1/addons/bindings/onkyo1/readme.html">Onkyo AV Receiver</a></li>
<li><a href="/v2.1/addons/bindings/openenergymonitor1/readme.html">Open Energy Monitor</a></li>
<li><a href="/v2.1/addons/bindings/openpaths1/readme.html">OpenPaths</a></li>
<li><a href="/v2.1/addons/bindings/opensprinkler/readme.html">OpenSprinkler</a></li>
<li><a href="/v2.1/addons/bindings/opensprinkler1/readme.html">OpenSprinkler</a></li>
<li><a href="/v2.1/addons/bindings/orvibo/readme.html">Orvibo</a></li>
<li><a href="/v2.1/addons/bindings/owserver1/readme.html">OWServer</a></li>
<li><a href="/v2.1/addons/bindings/panasonictv1/readme.html">Panasonic TV</a></li>
<li><a href="/v2.1/addons/bindings/panstamp1/readme.html">panStamp</a></li>
<li><a href="/v2.1/addons/bindings/piface1/readme.html">Piface</a></li>
<li><a href="/v2.1/addons/bindings/pilight1/readme.html">pilight</a></li>
<li><a href="/v2.1/addons/bindings/pioneeravr/readme.html">PioneerAVR Configuration</a></li>
<li><a href="/v2.1/addons/bindings/pioneeravr1/readme.html">Pioneer AV Receiver (1.x)</a></li>
<li><a href="/v2.1/addons/bindings/plcbus1/readme.html">PLCBus</a></li>
<li><a href="/v2.1/addons/bindings/plclogo1/readme.html">PLCLogo</a></li>
<li><a href="/v2.1/addons/bindings/plex1/readme.html">Plex</a></li>
<li><a href="/v2.1/addons/bindings/plugwise1/readme.html">Plugwise</a></li>
<li><a href="/v2.1/addons/bindings/powerdoglocalapi1/readme.html">PowerDog Local API</a></li>
<li><a href="/v2.1/addons/bindings/powermax1/readme.html">Visonic Powermax</a></li>
<li><a href="/v2.1/addons/bindings/primare1/readme.html">Primare</a></li>
<li><a href="/v2.1/addons/bindings/pulseaudio/readme.html">Pulseaudio</a></li>
<li><a href="/v2.1/addons/bindings/pulseaudio1/readme.html">Pulseaudio</a></li>
<li><a href="/v2.1/addons/bindings/rfxcom/readme.html">RFXCOM</a></li>
<li><a href="/v2.1/addons/bindings/rfxcom1/readme.html">RFXCOM</a></li>
<li><a href="/v2.1/addons/bindings/rme/readme.html">RME</a></li>
<li><a href="/v2.1/addons/bindings/rpircswitch1/readme.html">Raspberry Pi RC Switch</a></li>
<li><a href="/v2.1/addons/bindings/russound/readme.html">Russound</a></li>
<li><a href="/v2.1/addons/bindings/rwesmarthome1/readme.html">RWE SmartHome</a></li>
<li><a href="/v2.1/addons/bindings/sagercaster1/readme.html">Sager Weathercaster</a></li>
<li><a href="/v2.1/addons/bindings/sallegra1/readme.html">Sallegra</a></li>
<li><a href="/v2.1/addons/bindings/samsungac1/readme.html">Samsung Air Conditioner</a></li>
<li><a href="/v2.1/addons/bindings/samsungtv/readme.html">Samsung TV</a></li>
<li><a href="/v2.1/addons/bindings/samsungtv1/readme.html">Samsung TV</a></li>
<li><a href="/v2.1/addons/bindings/sapp1/readme.html">Picnet Sapp</a></li>
<li><a href="/v2.1/addons/bindings/satel1/readme.html">Satel Integra Alarm System</a></li>
<li><a href="/v2.1/addons/bindings/sensebox/readme.html">senseBox</a></li>
<li><a href="/v2.1/addons/bindings/serial1/readme.html">Serial</a></li>
<li><a href="/v2.1/addons/bindings/silvercrestwifisocket/readme.html">Silvercrest Wifi Plug</a></li>
<li><a href="/v2.1/addons/bindings/sleepiq/readme.html">SleepIQ</a></li>
<li><a href="/v2.1/addons/bindings/smaenergymeter/readme.html">SMA Energy Meter</a></li>
<li><a href="/v2.1/addons/bindings/smarthomatic1/readme.html">Smarthomatic</a></li>
<li><a href="/v2.1/addons/bindings/snmp1/readme.html">SNMP</a></li>
<li><a href="/v2.1/addons/bindings/sonance1/readme.html">Sonance</a></li>
<li><a href="/v2.1/addons/bindings/sonos/readme.html">Sonos</a></li>
<li><a href="/v2.1/addons/bindings/sonos1/readme.html">Sonos</a></li>
<li><a href="/v2.1/addons/bindings/souliss1/readme.html">Souliss</a></li>
<li><a href="/v2.1/addons/bindings/squeezebox/readme.html">Logitech Squeezebox</a></li>
<li><a href="/v2.1/addons/bindings/squeezebox1/readme.html">Squeezebox</a></li>
<li><a href="/v2.1/addons/bindings/stiebelheatpump1/readme.html">Stiebel Eltron LWZ</a></li>
<li><a href="/v2.1/addons/bindings/swegonventilation1/readme.html">Swegon Ventilation</a></li>
<li><a href="/v2.1/addons/bindings/synopanalyzer/readme.html">Synop Analyzer</a></li>
<li><a href="/v2.1/addons/bindings/systeminfo/readme.html">Systeminfo</a></li>
<li><a href="/v2.1/addons/bindings/systeminfo1/readme.html">System Information</a></li>
<li><a href="/v2.1/addons/bindings/tacmi1/readme.html">TACmi</a></li>
<li><a href="/v2.1/addons/bindings/tankerkoenig/readme.html">Tankerkönig</a></li>
<li><a href="/v2.1/addons/bindings/tcp1/readme.html">TCP & UDP</a></li>
<li><a href="/v2.1/addons/bindings/tellstick/readme.html">Tellstick</a></li>
<li><a href="/v2.1/addons/bindings/tellstick1/readme.html">Tellstick</a></li>
<li><a href="/v2.1/addons/bindings/tesla/readme.html">Tesla</a></li>
<li><a href="/v2.1/addons/bindings/tinkerforge1/readme.html">TinkerForge</a></li>
<li><a href="/v2.1/addons/bindings/tivo1/readme.html">TiVo</a></li>
<li><a href="/v2.1/addons/bindings/toon/readme.html">Toon</a></li>
<li><a href="/v2.1/addons/bindings/tradfri/readme.html">Trådfri</a></li>
<li><a href="/v2.1/addons/bindings/ucprelayboard1/readme.html">UCProjects.eu Relay Board</a></li>
<li><a href="/v2.1/addons/bindings/upb1/readme.html">UPB</a></li>
<li><a href="/v2.1/addons/bindings/urtsi/readme.html">Somfy URTSI II</a></li>
<li><a href="/v2.1/addons/bindings/urtsi1/readme.html">Somfy URTSI II</a></li>
<li><a href="/v2.1/addons/bindings/vdr1/readme.html">Video Disk Recorder (VDR)</a></li>
<li><a href="/v2.1/addons/bindings/vitotronic/readme.html">Vitotronic</a></li>
<li><a href="/v2.1/addons/bindings/wago1/readme.html">WAGO</a></li>
<li><a href="/v2.1/addons/bindings/weather1/readme.html">Weather</a></li>
<li><a href="/v2.1/addons/bindings/wemo/readme.html">Belkin Wemo</a></li>
<li><a href="/v2.1/addons/bindings/wemo1/readme.html">Wemo</a></li>
<li><a href="/v2.1/addons/bindings/wifiled/readme.html">WiFi LED</a></li>
<li><a href="/v2.1/addons/bindings/windcentrale/readme.html">Windcentrale</a></li>
<li><a href="/v2.1/addons/bindings/withings1/readme.html">Withings</a></li>
<li><a href="/v2.1/addons/bindings/wol1/readme.html">Wake-on-LAN</a></li>
<li><a href="/v2.1/addons/bindings/wr32231/readme.html">WR3223 ventilation controller</a></li>
<li><a href="/v2.1/addons/bindings/xbmc1/readme.html">XBMC binding (for KODI) (1.x)</a></li>
<li><a href="/v2.1/addons/bindings/xpl1/readme.html">xPL</a></li>
<li><a href="/v2.1/addons/bindings/yahooweather/readme.html">YahooWeather</a></li>
<li><a href="/v2.1/addons/bindings/yamahareceiver/readme.html">Yamahareceiver</a></li>
<li><a href="/v2.1/addons/bindings/yamahareceiver1/readme.html">Yamaha Receiver (1.x)</a></li>
<li><a href="/v2.1/addons/bindings/zibase1/readme.html">Zibase</a></li>
<li><a href="/v2.1/addons/bindings/zigbee/readme.html">ZigBee</a></li>
<li><a href="/v2.1/addons/bindings/zoneminder/readme.html">Zoneminder</a></li>
<li><a href="/v2.1/addons/bindings/zwave/readme.html">ZWave</a></li>
<li><a href="/v2.1/addons/bindings/zwave1/readme.html">Z-Wave</a></li>
<li><a href="/v2.1/addons/bindings/zway/readme.html">Z-Way</a></li>
</ul>
</li>
<li><a href="/v2.1/addons/uis.html">User Interfaces</a>
<ul>
<li><a href="/v2.1/addons/uis.html">Overview</a></li>
<hr />
<li><a href="/v2.1/addons/uis/basic/readme.html">Basic UI</a></li>
<li><a href="/v2.1/addons/uis/classic/readme.html">Classic UI</a></li>
<li><a href="/v2.1/addons/uis/habmin/readme.html">HABmin</a></li>
<li><a href="/v2.1/addons/uis/habpanel/readme.html">HABPanel</a></li>
<li><a href="/v2.1/addons/uis/paper/readme.html">Paper UI</a></li>
<hr />
<li><a href="/v2.1/addons/uis/apps/android.html">Android openHAB App</a></li>
<li><a href="/v2.1/addons/uis/apps/ios.html">iOS openHAB App</a></li>
<li><a href="/v2.1/addons/uis/apps/windows.html">Windows 10 openHAB App</a></li>
<hr />
<li><a href="/v2.1/addons/iconsets/classic/readme.html">Iconset (classic)</a></li>
</ul>
</li>
<li><a href="/v2.1/addons/persistence.html">Persistence</a>
<ul>
<li><a href="/v2.1/addons/persistence.html">Overview</a></li>
<hr />
<li><a href="/v2.1/addons/persistence/caldav/readme.html">CalDAV</a></li>
<li><a href="/v2.1/addons/persistence/cosm/readme.html">Xively (formerly Cosm)</a></li>
<li><a href="/v2.1/addons/persistence/db4o/readme.html">db4o</a></li>
<li><a href="/v2.1/addons/persistence/dynamodb/readme.html">Amazon DynamoDB</a></li>
<li><a href="/v2.1/addons/persistence/exec/readme.html">Exec</a></li>
<li><a href="/v2.1/addons/persistence/influxdb/readme.html">InfluxDB (0.9 and newer)</a></li>
<li><a href="/v2.1/addons/persistence/influxdb08/readme.html">InfluxDB (up to 0.8.x)</a></li>
<li><a href="/v2.1/addons/persistence/jdbc/readme.html">JDBC</a></li>
<li><a href="/v2.1/addons/persistence/jpa/readme.html">Java Persistence API (JPA)</a></li>
<li><a href="/v2.1/addons/persistence/mapdb/readme.html">mapdb</a></li>
<li><a href="/v2.1/addons/persistence/mongodb/readme.html">MongoDB</a></li>
<li><a href="/v2.1/addons/persistence/mqtt/readme.html">MQTT</a></li>
<li><a href="/v2.1/addons/persistence/mysql/readme.html">MySQL</a></li>
<li><a href="/v2.1/addons/persistence/rrd4j/readme.html">rrd4j</a></li>
<li><a href="/v2.1/addons/persistence/sense/readme.html">Sen.Se</a></li>
<li><a href="/v2.1/addons/persistence/sitewhere/readme.html">SiteWhere</a></li>
</ul>
</li>
<li><a href="/v2.1/addons/actions.html">Actions</a>
<ul>
<li><a href="/v2.1/addons/actions.html">Overview</a></li>
<hr />
<li><a href="/v2.1/addons/actions/astro/readme.html">Astro</a></li>
<li><a href="/v2.1/addons/actions/ciscospark/readme.html">Cisco Spark</a></li>
<li><a href="/v2.1/addons/actions/dscalarm/readme.html">DSC Alarm</a></li>
<li><a href="/v2.1/addons/actions/ecobee/readme.html">Ecobee</a></li>
<li><a href="/v2.1/addons/actions/harmonyhub/readme.html">Logitech Harmony Hub</a></li>
<li><a href="/v2.1/addons/actions/homematic/readme.html">Homematic</a></li>
<li><a href="/v2.1/addons/actions/mail/readme.html">Mail</a></li>
<li><a href="/v2.1/addons/actions/mios/readme.html">MiOS</a></li>
<li><a href="/v2.1/addons/actions/mqtt/readme.html">MQTT</a></li>
<li><a href="/v2.1/addons/actions/nma/readme.html">NotifyMyAndroid</a></li>
<li><a href="/v2.1/addons/actions/openwebif/readme.html">OpenWebIf</a></li>
<li><a href="/v2.1/addons/actions/pebble/readme.html">Pebble</a></li>
<li><a href="/v2.1/addons/actions/prowl/readme.html">Prowl</a></li>
<li><a href="/v2.1/addons/actions/pushover/readme.html">Pushover</a></li>
<li><a href="/v2.1/addons/actions/pushsafer/readme.html">Pushsafer</a></li>
<li><a href="/v2.1/addons/actions/satel/readme.html">Satel</a></li>
<li><a href="/v2.1/addons/actions/squeezebox/readme.html">Squeezebox</a></li>
<li><a href="/v2.1/addons/actions/telegram/readme.html">Telegram</a></li>
<li><a href="/v2.1/addons/actions/tinkerforge/readme.html">TinkerForge</a></li>
<li><a href="/v2.1/addons/actions/twitter/readme.html">Twitter</a></li>
<li><a href="/v2.1/addons/actions/weather/readme.html">Weather</a></li>
<li><a href="/v2.1/addons/actions/xbmc/readme.html">XBMC</a></li>
<li><a href="/v2.1/addons/actions/xmpp/readme.html">XMPP</a></li>
<li><a href="/v2.1/addons/actions/xpl/readme.html">xPL</a></li>
</ul>
</li>
<li><a href="/v2.1/addons/transformations.html">Transformations</a>
<ul>
<li><a href="/v2.1/addons/transformations.html">Overview</a></li>
<hr />
<li><a href="/v2.1/addons/transformations/exec/readme.html">Exec</a></li>
<li><a href="/v2.1/addons/transformations/javascript/readme.html">JavaScript</a></li>
<li><a href="/v2.1/addons/transformations/jsonpath/readme.html">JsonPath</a></li>
<li><a href="/v2.1/addons/transformations/map/readme.html">Map</a></li>
<li><a href="/v2.1/addons/transformations/regex/readme.html">RegEx</a></li>
<li><a href="/v2.1/addons/transformations/scale/readme.html">Scale</a></li>
<li><a href="/v2.1/addons/transformations/xpath/readme.html">XPath</a></li>
<li><a href="/v2.1/addons/transformations/xslt/readme.html">XSLT</a></li>
</ul>
</li>
<li><a href="/v2.1/addons/voice.html">Voice Services</a>
<ul>
<li><a href="/v2.1/addons/voice.html">Overview</a></li>
<hr />
<li><a href="/v2.1/addons/voice/mactts/readme.html">MacOS Text-to-Speech</a></li>
<li><a href="/v2.1/addons/voice/marytts/readme.html">Mary Text-to-Speech</a></li>
<li><a href="/v2.1/addons/voice/voicerss/readme.html">VoiceRSS Text-to-Speech</a></li>
</ul>
</li>
<hr />
<li><a href="/v2.1/addons/io.html">3rd Party Integration</a>
<ul>
<li><a href="/v2.1/addons/io.html">Overview</a></li>
<hr />
<li><a href="/v2.1/addons/io/dropbox/readme.html">Dropbox Synchronization</a></li>
<li><a href="/v2.1/addons/io/gcal/readme.html">Google Calendar Scheduler</a></li>
<li><a href="/v2.1/addons/io/homekit/readme.html">HomeKit Add-on</a></li>
<li><a href="/v2.1/addons/io/hueemulation/readme.html">openHAB Hue Emulation</a></li>
<li><a href="/v2.1/addons/io/imperihome/readme.html">ImperiHome integration service</a></li>
<li><a href="/v2.1/addons/io/openhabcloud/readme.html">openHAB Cloud Connector</a></li>
<hr />
<li><a href="/v2.1/configuration/restdocs.html">REST API</a></li>
<li><a href="http://www.myopenhab.org/" target="_blank">IFTTT</a></li>
</ul>
</li>
</ul>
</li>
<li><a href="/v2.1/administration/index.html">Advanced Functionality</a>
<ul>
<li><a href="/v2.1/administration/index.html">Overview</a></li>
<hr />
<li><a href="/v2.1/administration/console.html">Console</a></li>
<li><a href="/v2.1/administration/runtime.html">Runtime Commands</a></li>
<li><a href="/v2.1/administration/bundles.html">Bundle Management</a></li>
<li><a href="/v2.1/administration/logging.html">Logging</a></li>
<hr />
<li><a href="/v2.1/administration/jsondb.html">JsonDB Storage</a></li>
</ul>
</li>
<li><a href="/v2.1/appendix/help.html">Community Guidance</a>
<ul>
<li><a href="/v2.1/appendix/help.html">Finding Help & FAQs</a></li>
<li><a href="/v2.1/appendix/contributing.html">Contributing</a></li>
</ul>
</li>
</ul>
</div>
<div id="versioning" class="row valign-wrapper">
<div class="col s12 right-align">
<ul id="dropdown-versioning" class="dropdown-content">
<li><a href="/v2.1/../addons/bindings/xbmc1/readme.html">latest version</a></li>
<li><a href="/v2.1/../v2.2/addons/bindings/xbmc1/readme.html">v2.2</a></li>
<li><a href="/v2.1/addons/bindings/xbmc1/readme.html">v2.1<i class="tiny material-icons right">lens</i></a></li>
</ul>
<a class="btn dropdown-button grey lighten-1" href="#!" data-activates="dropdown-versioning" title="Select which version of this openHAB documentation article you want to read.">
Switch Article Version<i class="material-icons right">arrow_drop_down</i>
</a>
</div>
</div>
<div class="content">
<!-- Attention authors: Do not edit directly. Please add your changes to the appropriate source repository -->
<h1 id="xbmc-binding-for-kodi-1x">XBMC binding (for KODI) (1.x)</h1>
<p>This binding allows openHAB items to receive realtime updates about information like player state and running media from one or more instances of KODI (formerly known as XBMC).</p>
<p><a href="http://www.youtube.com/watch?v=N7_5phTVbo0"><img src="http://img.youtube.com/vi/N7_5phTVbo0/0.jpg" alt="openhab binding for xbmc" /></a></p>
<p>There is also a binding specifically for openHAB 2 <a href="http://docs.openhab.org/addons/bindings/kodi/readme.html">here</a>.</p>
<!-- MarkdownTOC -->
<ul>
<li><a href="#prerequisites">Prerequisites</a></li>
<li><a href="#binding-configuration">Binding Configuration</a>
<ul>
<li><a href="#configuration-example">Configuration Example</a></li>
</ul>
</li>
<li><a href="#item-configuration">Item Configuration</a>
<ul>
<li><a href="#available-properties">Available properties</a></li>
</ul>
</li>
<li><a href="#examples">Examples</a>
<ul>
<li><a href="#basic-items">Basic Items</a></li>
<li><a href="#rule-example">Rule Example</a></li>
<li><a href="#xbmc-with-wake-on-lan-and-network-health-bindings">XBMC with Wake-On-LAN and Network Health Bindings</a></li>
<li><a href="#using-playeropen">Using Player.Open</a></li>
<li><a href="#using-applicationvolume-option">Using Application.Volume option</a></li>
<li><a href="#setting-the-volume-from-a-rule">Setting the Volume from a Rule</a></li>
<li><a href="#using-screensaverstate">Using Screensaver.State</a></li>
<li><a href="#using-pvropentv">Using PVR.OpenTV</a></li>
</ul>
</li>
</ul>
<!-- /MarkdownTOC -->
<h2 id="prerequisites">Prerequisites</h2>
<p>This binding has been developed and tested from XBMC Frodo (v12) to Kodi Jarvis (v16.1).</p>
<p>The binding uses XBMCs JSON-RPC API v6, both the HTTP and the websocket transports. These therefore need to be enabled and need to be reachable from your openHAB host (think firewall, routing etc.)</p>
<h2 id="binding-configuration">Binding Configuration</h2>
<p>This binding can be configured in the file <code class="highlighter-rouge">services/xbmc.cfg</code>.</p>
<table>
<thead>
<tr>
<th>Property</th>
<th>Default</th>
<th style="text-align: center">Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code class="highlighter-rouge"><instance></code>.host</td>
<td> </td>
<td style="text-align: center">Yes</td>
<td>Hostname / IP address of your XBMC host</td>
</tr>
<tr>
<td><code class="highlighter-rouge"><instance></code>.rsPort</td>
<td>8080</td>
<td style="text-align: center">No</td>
<td>Port number for the JSON RPC service</td>
</tr>
<tr>
<td><code class="highlighter-rouge"><instance></code>.wsPort</td>
<td>9090</td>
<td style="text-align: center">No</td>
<td>Port number for the websocket service</td>
</tr>
<tr>
<td><code class="highlighter-rouge"><instance></code>.username</td>
<td>xbmc</td>
<td style="text-align: center">No</td>
<td>Username to connect to XBMC</td>
</tr>
<tr>
<td><code class="highlighter-rouge"><instance></code>.password</td>
<td>xbmc</td>
<td style="text-align: center">No</td>
<td>Password to connect to XBMC</td>
</tr>
<tr>
<td>refreshInterval</td>
<td>60000</td>
<td style="text-align: center">No</td>
<td>Refresh interval, in milliseconds (60000 is one minute)</td>
</tr>
</tbody>
</table>
<p>where <code class="highlighter-rouge"><instance></code> is a name you choose for the instance of XBMC you want to control, <code class="highlighter-rouge">livingroom</code> for instance. When defining your items, you can use the <code class="highlighter-rouge"><instance></code> name to refer to your instances. In doing so, you can easily change the address by which you XBMC instance can be reached without having to reconfigure all of your items.</p>
<h3 id="configuration-example">Configuration Example</h3>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>livingRoom.host=192.168.1.6
livingRoom.rsPort=8080
livingRoom.wsPort=9090
livingRoom.username=xbmc
livingRoom.password=xbmc
refreshInterval=60000
</code></pre></div></div>
<p>Although you <em>can</em> configure one or more instances, it is not strictly necessary to do so. As long as you don’ t intend to use ports or login data different from the default, you could just as well use this by directly referring to hostnames or IP addresses in you item binding configuration.</p>
<h2 id="item-configuration">Item Configuration</h2>
<p>Items can be bound to the XBMC binding using this format:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>xbmc="<direction>[<host>|<property>]"
</code></pre></div></div>
<p>where:</p>
<ul>
<li><code class="highlighter-rouge"><direction></code> is <code class="highlighter-rouge"><</code> for incoming (player state, media title etc.), <code class="highlighter-rouge">></code> for outgoing (Send “Play/Pause” or “Stop” etc.) or <code class="highlighter-rouge">=</code> for bi-directional (send/receive volume)</li>
<li><code class="highlighter-rouge"><host></code> is a named <code class="highlighter-rouge"><instance></code> prefixed with <code class="highlighter-rouge">#</code>, or without the <code class="highlighter-rouge">#</code> prefix it’ s interpreted as a hostname or IP address.</li>
<li><code class="highlighter-rouge"><property></code> is the property to bind to (more on this below)</li>
</ul>
<h3 id="available-properties">Available properties</h3>
<p>The list of properties you can use in your binding configuration is:</p>
<table>
<thead>
<tr>
<th>Property</th>
<th style="text-align: center">Direction</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>Application.Volume</td>
<td style="text-align: center"><code class="highlighter-rouge">=</code></td>
<td>Show and adjust the volume in the XBMC application</td>
</tr>
<tr>
<td>GUI.ShowNotification</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Show a notification in the XBMC UI</td>
</tr>
<tr>
<td>Input.ExecuteAction.aspectratio</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Changes Aspect ratio</td>
</tr>
<tr>
<td>Input.ExecuteAction.back</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Moves cursor BACK</td>
</tr>
<tr>
<td>Input.ExecuteAction.codecinfo</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Shows codec information</td>
</tr>
<tr>
<td>Input.ExecuteAction.contextmenu</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Shows context menu</td>
</tr>
<tr>
<td>Input.ExecuteAction.down</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Moves cursor RIGHT</td>
</tr>
<tr>
<td>Input.ExecuteAction.info</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Shows INFO screen</td>
</tr>
<tr>
<td>Input.ExecuteAction.left</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Moves cursor LEFT</td>
</tr>
<tr>
<td>Input.ExecuteAction.osd</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Shows OSD</td>
</tr>
<tr>
<td>Input.ExecuteAction.right</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Moves cursor RIGHT</td>
</tr>
<tr>
<td>Input.ExecuteAction.select</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Moves cursor RIGHT</td>
</tr>
<tr>
<td>Input.ExecuteAction.togglefullscreen</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Toggles full screen / Windowed screen</td>
</tr>
<tr>
<td>Input.ExecuteAction.up</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Moves cursor UP</td>
</tr>
<tr>
<td>Input.ExecuteAction.????</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Any other command from <a href="http://kodi.wiki/view/JSON-RPC_API/v6#Input.Action">this list</a></td>
</tr>
<tr>
<td>Label.Player.Time</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Display media time</td>
</tr>
<tr>
<td>Label.System.Uptime</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Display system uptime</td>
</tr>
<tr>
<td>Label.VideoPlayer.VideoCodec</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Display video codec</td>
</tr>
<tr>
<td>Label.????.????</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Any other command from <a href="http://kodi.wiki/view/InfoLabels">this list</a></td>
</tr>
<tr>
<td>Player.Album</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Currently playing album (music only)</td>
</tr>
<tr>
<td>Player.Artist</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Currently playing artist (music only)</td>
</tr>
<tr>
<td>Player.Label</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Currently playing title (in case of radio streams)</td>
</tr>
<tr>
<td>Player.Open</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Open a URL for playback</td>
</tr>
<tr>
<td>Player.PlayPause</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Play/pause playback</td>
</tr>
<tr>
<td>Player.ShowTitle</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Currently playing show title: TV show name, empty for other types</td>
</tr>
<tr>
<td>Player.State</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Current player state: ‘ Play’ , ‘ Pause’ , ‘ End’ (Stopped due to end of content), ‘ Stop’ (Stopped by user). An ‘ End’ state is immediately followed by a ‘ Stop’ state.</td>
</tr>
<tr>
<td>Player.Stop</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Stop playback</td>
</tr>
<tr>
<td>Player.Title</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Currently playing title: movie name, TV episode name, music track name</td>
</tr>
<tr>
<td>Player.Type</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Currently playing type: ‘ movie’ , ‘ episode’ , ‘ channel’ , or ‘ unknown’ for a PVR recording</td>
</tr>
<tr>
<td>Player.<???></td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Any other player property supported by the XBMC JSON RPC API</td>
</tr>
<tr>
<td>Property.audiostreams</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Returns the list of all audiostreams of the media</td>
</tr>
<tr>
<td>Property.canchangespeed</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Returns “true” if the media speed can be changed</td>
</tr>
<tr>
<td>Property.canmove</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Returns “true” if the media can be moved</td>
</tr>
<tr>
<td>Property.canrepeat</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Returns “true” if the media can be repeated</td>
</tr>
<tr>
<td>Property.canrotate</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Returns “true” if the media can be rotated</td>
</tr>
<tr>
<td>Property.canseek</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Returns “true” if the media can be seeked</td>
</tr>
<tr>
<td>Property.canshuffle</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Returns “true” if the playlist can be shuffled</td>
</tr>
<tr>
<td>Property.canzoom</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Returns “true” if the media can be zoomed</td>
</tr>
<tr>
<td>Property.currentaudiostream</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Returns the current audio stream</td>
</tr>
<tr>
<td>Property.currentsubtitle</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Gets the current subtitle language of the playing media</td>
</tr>
<tr>
<td>Property.percentage</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Gets the elapsed percentage of the playing media</td>
</tr>
<tr>
<td>Property.position</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Returns the current position</td>
</tr>
<tr>
<td>Property.repeat</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Returns “true” if the media can be repeated</td>
</tr>
<tr>
<td>Property.shuffled</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Returns “true” if the playlist is shuffled</td>
</tr>
<tr>
<td>Property.speed</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Returns speed multiplier of the current playing media (1x, 2x, etc.)</td>
</tr>
<tr>
<td>Property.subtitleenabled</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Returns “true” if the subtitles are enabled</td>
</tr>
<tr>
<td>Property.subtitles</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Return the current subtitle</td>
</tr>
<tr>
<td>Property.time</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Gets the elapsed time of the playing media</td>
</tr>
<tr>
<td>Property.totalTime</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Gets the total time of the playing media</td>
</tr>
<tr>
<td>Property.type</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Gets the media type</td>
</tr>
<tr>
<td>Property.????</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Any other property from <a href="http://kodi.wiki/view/JSON-RPC_API/v6#Player.Property.Name">this list</a></td>
</tr>
<tr>
<td>PVR.OpenRadio</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Open a PVR Radio Channel for playback</td>
</tr>
<tr>
<td>PVR.OpenTV</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Open a PVR TV Channel by name for playback</td>
</tr>
<tr>
<td>Refresh</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Force refresh of incoming properties</td>
</tr>
<tr>
<td>Screensaver.State</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>Current screensaver state: (ON if screensaver active)</td>
</tr>
<tr>
<td>System.Hibernate</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Send OFF to put the system in Hibernate mode</td>
</tr>
<tr>
<td>System.Reboot</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Send OFF to reboot the system</td>
</tr>
<tr>
<td>System.Shutdown</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Send OFF to power down the system</td>
</tr>
<tr>
<td>System.State</td>
<td style="text-align: center"><code class="highlighter-rouge"><</code></td>
<td>State of the XBMC application (ON if connected, OFF is XBMC unavailable)</td>
</tr>
<tr>
<td>System.Suspend</td>
<td style="text-align: center"><code class="highlighter-rouge">></code></td>
<td>Send OFF to put the system in Suspend mode</td>
</tr>
</tbody>
</table>
<p>Incoming properties that are not part of any XBMC notification, will be refreshed with each refresh interval of the binding (default 60 seconds).</p>
<h2 id="examples">Examples</h2>
<h3 id="basic-items">Basic Items</h3>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>String XBMC_LR_PlayerState "XBMC String" {xbmc="<[#livingRoom|Player.State]"}
String XBMC_LR_PlayerTitle "XBMC String" {xbmc="<[#livingRoom|Player.Title]"}
String XBMC_BR_PlayerState "XBMC String" {xbmc="<[#bedroom|Player.State]"}
String XBMC_IP_PlayerState "XBMC String" {xbmc="<[192.168.1.6|Player.State]"}
String XBMC_DNS_PlayerState "XBMC String" {xbmc="<[xbmc.local|Player.Title]"}
Number XBMC_LR_Volume "XBMC Number" {xbmc="=[#livingRoom|Application.Volume]"}
</code></pre></div></div>
<h3 id="rule-example">Rule Example</h3>
<p>As can be seen in the introduction video, i have a dimmable lamp next to my tv. I use this to light up the room after sunset when i press pause and go back to the previous level on resume, unless the lamp state has been altered while on pause.</p>
<p>This is of course an example very specific to my preferences, but should give you an idea on what can be done.</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>import java.util.Date
var Number brightnessBeforePause
rule "Lights on when paused"
when
Item LivingRoom_XBMC changed from Play to Pause
then
var Date sunsetTime = (G_SUNSET_V.state as DateTimeType).calendar.time
var Date sunriseTime = (G_SUNRISE_V.state as DateTimeType).calendar.time
if( now.toDate().after(sunsetTime) || now.toDate().before(sunriseTime)){
brightnessBeforePause = LivingRoom_Lamp.state as DecimalType
if ( brightnessBeforePause < 50){
sendCommand( LivingRoom_Lamp, "50")
}
}
end
rule "Lights off when pause end"
when
Item LivingRoom_XBMC changed from Pause to Play
then
if (LivingRoom_Lamp.state == 50){
sendCommand( LivingRoom_Lamp, brightnessBeforePause)
}
end
</code></pre></div></div>
<h3 id="xbmc-with-wake-on-lan-and-network-health-bindings">XBMC with Wake-On-LAN and Network Health Bindings</h3>
<p>The following configuration can be used to power on your XBMC machine using the Wake-On-LAN Binding and power it off using the XBMC Binding. The Network Health binding updates the state after some time if XBMC was powered on or off without using openHAB. You have to insert your own IP and MAC address of course.</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Switch XBMC_Power "XBMC Power" {xbmc=">[#openelec|System.Shutdown]", wol="192.168.1.0#xx:xx:xx:xx:xx:xx", nh="openelec:80"}
</code></pre></div></div>
<h3 id="using-playeropen">Using Player.Open</h3>
<p>To use the Player.Open command, you would need to define a String item with this binding, then send an Update to this String item. This will cause Openhab to send the Player.Open command to the specified XBMC instance:</p>
<p>Items:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>String XBMC_OpenMedia "XBMC Player file [%s]" { xbmc=">[#woonkamer|Player.Open]" }
Switch XBMC_Radio "XBMC Start Radio"
</code></pre></div></div>
<p>Rule:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>rule "Start Radio"
when
Item XBMC_Radio changed to ON
then
postUpdate(XBMC_Radio, OFF)
sendCommand(XBMC_OpenMedia, "http://icecast.omroep.nl/3fm-bb-mp3")
end
</code></pre></div></div>
<p>This will introduce a Switch item with an associated rule that will send the <code class="highlighter-rouge">Player.Open</code> command when the switch is pressed.</p>
<h3 id="using-applicationvolume-option">Using Application.Volume option</h3>
<p>Item:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Dimmer XBMC_Volume "XBMC Volume [%.1f]" (XBMC) { xbmc="=[#woonkamer|Application.Volume]" }
</code></pre></div></div>
<p>Sitemap:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Slider item=XBMC_Volume step=10
</code></pre></div></div>
<h3 id="setting-the-volume-from-a-rule">Setting the Volume from a Rule</h3>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>XBMC_Volume.sendCommand(50)
</code></pre></div></div>
<h3 id="using-screensaverstate">Using Screensaver.State</h3>
<p>Item:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Switch LG_Screensaver "XBMC Screensaver Living Room" {xbmc="<[#woonkamer|Screensaver.State]"}
</code></pre></div></div>
<p>Rule:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>rule "turn tv on or off"
when
Item LG_Screensaver changed
then
if(LG_Screensaver.state == ON)
{
logInfo("screensaver", "turn tv OFF")
sendCommand(TV_Power,OFF)
} else {
logInfo("screensaver", "turn tv ON")
sendCommand(TV_Power,ON)
}
end
</code></pre></div></div>
<h3 id="using-pvropentv">Using PVR.OpenTV</h3>
<p>Item:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>String LG_OpenTVChannel "Open TV Channel [%s]" { xbmc=">[#woonkamer|PVR.OpenTV]" }
</code></pre></div></div>
<p>Rule:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>rule "Voice Command open tv channel"
when
Item VoiceCommand received command
then
sendCommand(LG_OpenTVChannel,VoiceCommand.state.toString)
end
</code></pre></div></div>
</div>
</div>
</section>
<footer>
<div class="container">
<div class="row">
<div class="col s12 m7">
Copyright © 2017 by the <a href="https://github.com/openhab">openHAB Community</a> and the <a href="http://www.openhabfoundation.org/">openHAB Foundation e.V.</a>
</div>
<div class="col s12 m5">
<ul class="list-inline right-align">
<li><a href="/imprint.html">Imprint</a></li>
<li><a href="/privacy.html">Privacy Policy</a></li>
<li><a href="http://www.openhab.org">openHAB Website</a></li>
</ul>
</div>
</div>
</div>
</footer>
<script src="/v2.1/js/jquery.min.js"></script>
<script src="/v2.1/js/jquery.scrollme.min.js"></script>
<script src="/v2.1/js/jquery.sticky.js"></script>
<script src="/v2.1/js/materialize.min.js"></script>
<script src="/v2.1/js/init.js"></script>
<script>
$(document).ready(function () {
$('#oh2-checkbox').change(function () {
if (this.checked) $('.since-2x').show('slow');
else $('.source-oh2').hide('slow');
});
$('#oh1-checkbox').change(function () {
if (this.checked) $('.since-1x').show('slow');
else $('.source-oh1').hide('slow');
});
$('#legacy-checkbox').change(function () {
if (this.checked) $('.install-legacy').show('slow');
else $('.install-legacy').hide('slow');
});
$('#manual-checkbox').change(function () {
if (this.checked) $('.install-manual').show('slow');
else $('.install-manual').hide('slow');
});
});
</script>
</body>
</html>