From 1064e0e23c27c6a80df987aa244bc8f7d1e7c455 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Wed, 12 Jul 2017 10:38:20 +0200 Subject: [PATCH] Initial media_extractor docs (#2963) --- source/_components/media_extractor.markdown | 37 +++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 source/_components/media_extractor.markdown diff --git a/source/_components/media_extractor.markdown b/source/_components/media_extractor.markdown new file mode 100644 index 00000000000..f89d02a4808 --- /dev/null +++ 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. + +