Skip to content
Full version of Kodi Python Plugin for Domoticz home automation
Branch: master
Clone or download
dnpwwo Added support for Kodi Player.OnResume call.
Later versions use this instead of resending Player.OnPlay
Latest commit 831a66c Feb 12, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Kodi Icons.zip Initial upload Dec 9, 2017
KodiBlack Icons.zip Initial upload Dec 9, 2017
KodiRound Icons.zip Initial upload Dec 9, 2017
LICENSE Create LICENSE Jan 22, 2018
README.md Added support for Kodi Player.OnResume call. Feb 12, 2019
plugin.py Added support for Kodi Player.OnResume call. Feb 12, 2019
xmbcclient3.py Initial upload Dec 9, 2017

README.md

Domoticz-Kodi-Plugin

Full version of Kodi Python Plugin for Domoticz home automation

Controls a single Kodi on your network. If you have more than one you can create multiple instances of the plugin via the Hardware page, one per Kodi.

Key Features

  • Creates four Domoticz devices per Kodi
    1. Basic status indicator, On/Off. Also has icon for Kodi Remote popup.
    2. Selector switch for content source: Video, Music, TV Shows, Live TV.
    3. Volume level. Icon mutes/unmutes, slider shows/sets volume.
    4. Playing indicator: Icon Pauses/Resumes, slider shows/sets percentage through media.
  • Ships with 3 different, user selectable, icons sets: Default, Black and Round.
  • Will send onscreen notifications to the Kodi if a Notifier name is specified.
  • When network connectivity is lost the Domoticz UI will optionally show the device(s) with Red banner

Installation

Python version 3.4 or higher required & Domoticz version 3.87xx or greater.

To install:

  • Go in your Domoticz directory using a command line and open the plugins directory.
  • Run: git clone https://github.com/dnpwwo/Domoticz-Kodi-Plugin.git
  • Restart Domoticz.

In the web UI, navigate to the Hardware page. In the hardware dropdown there will be an entry called "Kodi Players".

Updating

To update:

  • Go in your Domoticz directory using a command line and open the plugins directory then the Domoticz-Kodi-Plugin directory.
  • Run: git pull
  • Restart Domoticz.

Configuration

Kodi

The Kodi itself must be set to allow it to be controlled by external programs. Google will tell you how to do that.

Domoticz

Field Information
IP Address Will handle DNS names and IP V4 addresses (e.g 192.168.xxx.xxx)
Port The port that the Kodi is listening on. Default 9090, will work unless you specifically changed it on your Kodi. Do not set this to 80 or 8080. The plugin does not use a web interface on the Kodi
Icon Dropdown to allow icon set selection
Notifications If true it will send notifications to the Kodi that will popup on the screen
Notifier Name Only used if 'Notifications' is true. This name will appear in the list of notification targets when you use the 'Notifications' Button. Notifications you send to this target will appear on screen
Time Out Lost Devices When true, the devices in Domoitcz will have a red banner when network connectivity is lost to the Kodi
Debug When true the logging level will be much higher to aid with troubleshooting

Supported Commands

Command Information
On For 'Volume' Device - Turns mute off,
For 'Playing' Device - Resume playback
Set Volume <vol>
Set Level <level>
For 'Volume' Device - Sets volume percentage to <vol>,
For 'Playing' Device - Sets position in media to <level> percent
For Source device - Sets current Window
Play
Playing
Resumes playing current media
Pause
Paused
Pauses playing current media
Rewind Sets position in current media back to the start
Stop
Stopped
Stops playing current media
Trigger Playlist <name> <position> Start playing playlist <name> optionally at the supplied <position>
Trigger Favorites <position> Start playing favorites optionally at the supplied <position>
Run <params> Execute add on <params>
Off For 'Volume' Device - Turns mute on,
For 'Playing' Device - Pause playback
Video Show Kodi 'Videos' window
Audio Show Kodi 'Music' window
Photo Show Kodi 'Pictures' window

Change log

Version Information
1.9.0 Initial upload version
2.0.6 Add support for GUI.Screensaver events
2.1.6 Add option to activate Screensaver on 'Shutdown' or 'Off'
2.2.1 "Sleep" option changed to use UDP ActivateScreensaver call
2.2.3 Bug fix: Source selector selecting wrong source. Added 'Weather' source.
2.3.11 Added Blockly support, uplift error response handling and added 'Rewind' command
2.4.2 Bug fix: Changed handling for Play and Pause commands from scripts.
2.4.3 Added exception handling to onHeartbeat.
2.5.4 Upgraded error logging options. This requires you to go to the Hardware page and re-configure the Debug parameter otherwise you will see an 'onStart' error in the Domoticz log
2.5.6 onHeartbeat fix for when Device 2 does not exist.
2.6.4 Handles Domoticz returning structured JSON messages
2.6.5 Added support for Kodi Player.OnResume call. Later versions use this instead of resending Player.OnPlay
You can’t perform that action at this time.