From aaafc0009a17823ddab6fe25dc54e86e07692ef9 Mon Sep 17 00:00:00 2001 From: Adam Mills Date: Wed, 19 Jul 2017 13:51:49 -0400 Subject: [PATCH] Revert #2951 kodi turn on (#3016) Revert "add new script syntax for turn_on/off_action in media player Kodi" --- source/_components/media_player.kodi.markdown | 167 +----------------- 1 file changed, 9 insertions(+), 158 deletions(-) diff --git a/source/_components/media_player.kodi.markdown b/source/_components/media_player.kodi.markdown index 463d6a88433..9087ca2a758 100644 --- a/source/_components/media_player.kodi.markdown +++ b/source/_components/media_player.kodi.markdown @@ -35,8 +35,7 @@ Configuration variables: - **proxy_ssl** (*Optional*): Connect to kodi with HTTPS and WSS. 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. -- **turn_on_action** (*Optional*): Home Assistant script sequence to call when turning on. -- **turn_off_action** (*Optional*): Home Assistant script sequence to call when turning off. +- **turn_off_action** (*Optional*): The desired turn off action. Options are `none`, `quit`, `hibernate`, `suspend`, `reboot`, or `shutdown`. Default `none`. - **enable_websocket** (*Optional*): Enable websocket connections to Kodi via the TCP port. Defaults to `true`. The websocket connection allows Kodi to push updates to Home Assistant and removes the need for Home Assistant to poll. If websockets don't work on your installation this can be set to `false`. - **timeout** (*Optional*): Set timeout for connections to Kodi. Defaults to 5 seconds. @@ -76,171 +75,23 @@ input: result: ``` -### {% linkable_title Kodi turn on/off samples %} - -With the `turn_on_action` and `turn_off_action` parameters you can run any combination of Home Assistant actions to turn on/off your Kodi instance. Here are a few examples of this usage, including the **migration instructions for the old `turn_off_action` list of options**. - -#### Turn on Kodi with Wake on LAN - -With this configuration, when calling `media_player/turn_on` on the Kodi device, a _magic packet_ will be sent to the specified MAC address. To use this service, first you need to config the [`wake_on_lan`](/components/wake_on_lan) component in Home Assistant, which is achieved simply by adding `wake_on_lan:` to your `configuration.yaml`. - -```yaml -media_player: - - platform: kodi - host: 192.168.0.123 - turn_on_action: - - service: wake_on_lan.send_magic_packet - data: - mac: aa:bb:cc:dd:ee:ff - broadcast_address: 192.168.255.255 -``` - -#### Turn off Kodi with API calls - -Here are the equivalent ways to configure each of the old options to turn off Kodi (`quit`, `hibernate`, `suspend`, `reboot`, or `shutdown`): - -- **Quit** method (before was `turn_off_action: quit`) - -```yaml -media_player: - - platform: kodi - host: 192.168.0.123 - turn_off_action: - service: media_player.kodi_call_method - data: - entity_id: media_player.kodi - method: Application.Quit -``` - -- **Hibernate** method (before was `turn_off_action: hibernate`) - -```yaml -media_player: - - platform: kodi - host: 192.168.0.123 - turn_off_action: - service: media_player.kodi_call_method - data: - entity_id: media_player.kodi - method: System.Hibernate -``` - -- **Suspend** method (before was `turn_off_action: suspend`) - -```yaml -media_player: - - platform: kodi - host: 192.168.0.123 - turn_off_action: - service: media_player.kodi_call_method - data: - entity_id: media_player.kodi - method: System.Suspend -``` - -- **Reboot** method (before was `turn_off_action: reboot`) - -```yaml -media_player: - - platform: kodi - host: 192.168.0.123 - turn_off_action: - service: media_player.kodi_call_method - data: - entity_id: media_player.kodi - method: System.Reboot -``` - -- **Shutdown** method (before was `turn_off_action: shutdown`) - -```yaml -media_player: - - platform: kodi - host: 192.168.0.123 - turn_off_action: - service: media_player.kodi_call_method - data: - entity_id: media_player.kodi - method: System.Shutdown -``` - -#### Turn on and off the TV with the Kodi JSON-CEC Addon - -For Kodi devices running 24/7 attached to a CEC capable TV (OSMC / OpenElec and systems alike running in Rasperry Pi's, for example), this configuration enables the optimal way to turn on/off the attached TV from Home Assistant while Kodi is always active and ready: - -```yaml -media_player: - - platform: kodi - host: 192.168.0.123 - turn_on_action: - service: media_player.kodi_call_method - data: - entity_id: media_player.kodi - method: Addons.ExecuteAddon - addonid: script.json-cec - params: - command: activate - turn_off_action: - - service: media_player.media_stop - data: - entity_id: media_player.kodi - - service: media_player.kodi_call_method - data: - entity_id: media_player.kodi - method: Addons.ExecuteAddon - addonid: script.json-cec - params: - command: standby -``` - - ### {% linkable_title Kodi services samples %} -#### Simple script to turn on the PVR in some channel as a time function +#### Simple script to turn on the TV with the Kodi JSON-CEC Addon ```yaml script: - play_kodi_pvr: - alias: Turn on the silly box + activate_tv: + alias: Turn on TV sequence: - alias: TV on - service: media_player.turn_on - data: - entity_id: media_player.kodi - - - alias: Play TV channel - service: media_player.play_media - data_template: - entity_id: media_player.kodi - media_content_type: "CHANNEL" - media_content_id: > - {% if (now().hour < 14) or ((now().hour == 14) and (now().minute < 50)) %} - 10 - {% elif (now().hour < 16) %} - 15 - {% elif (now().hour < 20) %} - 2 - {% elif (now().hour == 20) and (now().minute < 50) %} - 10 - {% elif (now().hour == 20) or ((now().hour == 21) and (now().minute < 15)) %} - 15 - {% else %} - 10 - {% endif %} -``` - -#### Trigger a Kodi video library update - -```yaml -script: - update_library: - alias: Update Kodi Library - sequence: - - alias: Call Kodi update service: media_player.kodi_call_method data: - entity_id: media_player.kodi - method: VideoLibrary.Scan + entity_id: media_player.kodi + method: Addons.ExecuteAddon + addonid: script.json-cec + params: + command: activate ``` For a more complex usage of the `kodi_call_method` service, with event triggering of Kodi API results, you can have a look at this [example](/cookbook/kodi_dynamic_input_select/)