From 9015bf25d34eda7819e684ee9a63e4123b7cd93b Mon Sep 17 00:00:00 2001
From: Scott <52136729+SonicMagna@users.noreply.github.com>
Date: Wed, 10 Jul 2019 06:28:14 -0400
Subject: [PATCH] Added info on how to launch specific Roku channel via
 automation. (#9804)

* Added info on how to launch specific Roku channel via automation. Hass.io Documentation - Roku

* Typo correction

* :pencil2: Tweak
---
 source/_components/roku.markdown | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/source/_components/roku.markdown b/source/_components/roku.markdown
index c4b4e7e3d46..10c606b9dcf 100644
--- a/source/_components/roku.markdown
+++ b/source/_components/roku.markdown
@@ -94,3 +94,26 @@ data:
     - left
     - select
 ```
+
+## Media Player
+
+When the Home Assistant Roku integration is enabled and has found a Roku device, in the Home Assistant GUI the Roku media player will show a listing of the installed channels, or apps, under “source”. Select one and it will attempt to launch the channel on your Roku device. This action can also be automated, but it requires you to acquire an extra piece of information; the ```appID``` for the channel specific to your Roku. Although this information is gathered by the Roku integration, at the moment it is not exposed to the end user. This item might be added in a future release. For now though, you can easily get the information yourself. All you need to do is a simple GET API call on the same network as your device.
+
+The api calls are like this:
+
+```
+GET http:// ROKU_IP:8060/query/apps
+POST http://ROKU_IP:8060/launch/APP_ID
+```
+
+More details can be found on the [Roku dev pages](https://developer.roku.com/docs/developer-program/discovery/external-control-api.md)
+
+To use this in Home Assistant, for instance in an automation, the format is as follows. Note that ```source: ``` is the appID you discovered in the API call:
+
+```
+  action:
+  - data:
+      entity_id: media_player.roku
+      source: 20197
+    service: media_player.select_source
+```