Kodi

The Kodi platform allows you to send messages to your Kodi multimedia system from Home Assistant.

To add Kodi to your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
notify:
  - platform: kodi
    name: NOTIFIER_NAME
    host: 192.168.0.123

name (Optional): Name displayed in the frontend. The notifier will bind to the service notify.NOTIFIER_NAME.
host (Required): The host name or address of the device that is running Kodi.
port (Optional): The HTTP port number. Defaults to 8080.
proxy_ssl (Optional): Connect to kodi with HTTPS. Defaults to false. Useful if Kodi is behind an SSL proxy.
username (Optional): The XBMC/Kodi HTTP username.
password (Optional): The XBMC/Kodi HTTP password.

script.yaml example

kodi_notification:
  sequence:
  - service: notify.NOTIFIER_NAME
    data:
      title: "Home Assistant"
      message: "Message to KODI from Home Assistant!"
      data:
        displaytime: 20000
        icon: "warning"

Message variables

title (Optional): Title that is displayed on the message.
message (Required): Message to be displayed.
data (Optional)
- icon (Optional): Kodi comes with 3 default icons: info, warning and error, an URL to an image is also valid. Defaults to info
- displaytime (Optional): Length in milliseconds the message stays on screen. Defaults to 10000 ms

To use notifications, please see the getting started with automation page.

Services

Media control services

Available services: kodi_add_to_playlist, kodi_set_shuffle

Service data attribute	Optional	Description
`entity_id`	yes	Target a specific media player. Defaults to all.

Service `media_player/kodi_set_shuffle`

Service data attribute	Optional	Description
`entity_id`	yes	Target a specific media player. It must be of type kodi.
`shuffle_on`	no	True/false for shuffle on/off

Service `media_player/kodi_add_to_playlist`

Add a song or an entire album to the default playlist (i.e. playlist id 0).

Service data attribute	Optional	Description
`entity_id`	yes	Target a specific media player. It must be of type kodi.
`media_type`	no	either SONG or ALBUM
media_id	yes	id of the media as defined in kodi
media_name	yes	name of the media, HA will search for the media with name closer to this. If ALL add all albums, if artist_name is provided adds all albums of that artist.
artist_name	yes	name of the artist, HA will search for the artist with name closer to this.