Initial media_extractor docs (home-assistant#2963)

fabaff · web-flow · commit 1064e0e23c27 · 2017-07-12T10:38:20.000+02:00
diff --git a/source/_components/media_extractor.markdown b/source/_components/media_extractor.markdown
@@ -0,0 +1,37 @@
+---
+layout: page
+title: "Media Extractor"
+description: "Instructions how to integrate the Media Extrator into Home Assistant."
+date: 2017-07-12 07:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: home-assistant.png
+ha_category: Media Player
+ha_release: 0.49
+---
+
+
+The `media_extractor` component gets an stream URL and send it to a media player entity.
+
+To use the media extrator service in your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+media_extractor:
+```
+
+### {% linkable_title Use the service %}
+
+Go the the "Developer Tools", then to "Call Service", and choose `media_extractor/play_media` from the list of available services. Fill the "Service Data" field as shown in the example below and hit "CALL SERVICE".
+
+This will download the file from the given URL.
+
+| Service data attribute | Optional | Description |
+| ---------------------- | -------- | ----------- |
+| `entity_id`            |       no | Name(s) of entities to seek media on, eg. `media_player.living_room_chromecast`
+| `media_content_id`     |       no | The ID of the content to play. Platform dependent.
+| `media_content_type`   |       no | The type of the content to play. Must be one of MUSIC, TVSHOW, VIDEO, EPISODE, CHANNEL or PLAYLIST MUSIC.
+
+
