diff --git a/source/components/configurator.markdown b/source/components/configurator.markdown new file mode 100644 index 00000000000..7e2ab437a2a --- /dev/null +++ b/source/components/configurator.markdown @@ -0,0 +1,20 @@ +--- +layout: page +title: "Configurator" +description: "Instructions how to integrate the configurator in your components." +date: 2015-03-15 00:51 +sidebar: false +comments: false +sharing: true +footer: true +--- + +

+This component is intended for developers. +

+ +The configurator component allows components to request information from the user. It is currently implemented as the minimum viable product: it supports showing a text, image and button to the user. It will trigger a callback when the button is pressed. + +The Hue component in [the demo](/demo) is implemented using the configurator. See [the source of the demo component](https://github.com/balloob/home-assistant/blob/master/homeassistant/components/demo.py#L72) for a simple example. + +See [the source](https://github.com/balloob/home-assistant/blob/master/homeassistant/components/configurator.py#L39) for more details on how to use the configurator component. diff --git a/source/components/conversation.markdown b/source/components/conversation.markdown new file mode 100644 index 00000000000..59dc54a6d02 --- /dev/null +++ b/source/components/conversation.markdown @@ -0,0 +1,22 @@ +--- +layout: page +title: "Conversation" +description: "Instructions how to have conversations with your Home Assistant." +date: 2015-03-15 00:39 +sidebar: false +comments: false +sharing: true +footer: true +--- + +The conversation component can process sentences into commands for Home Assistant. It is currently limited to parsing commands in the format `turn `. + +``` +conversation: +``` + +When this component is active and you are using a supported browser voice commands will be activated in the frontend. Browse to [the demo](/demo/) in Chrome to see it in action. + +

+ +

diff --git a/source/components/chromecast.markdown b/source/components/media_player.markdown similarity index 50% rename from source/components/chromecast.markdown rename to source/components/media_player.markdown index 69f7a6b7f3d..6ff1f045e9a 100644 --- a/source/components/chromecast.markdown +++ b/source/components/media_player.markdown @@ -1,7 +1,7 @@ --- layout: page -title: "Chromecast" -description: "Instructions how to setup your chromecasts with Home Assistant." +title: "Media Player" +description: "Instructions how to setup your media players with Home Assistant." date: 2015-01-24 14:39 sidebar: false comments: false @@ -9,16 +9,17 @@ sharing: true footer: true --- +Interacts with media players on your network. Currently only supports Chromecasts. These will be automatically discovered if you setup [the discovery component]({{site_root}}/components/discovery.html). Can also be forced to load by adding the following lines to your `configuration.yaml`: + +``` +media_player: + platform: chromecast +``` +

Chromecasts have recently received a new API which is not yet supported by Home Assistant. Therefore we currently can only detect them and do not know what they are up to.

-Interacts with Chromecasts on your network. Will be automatically discovered if you setup [the discovery component]({{site_root}}/components/discovery.html). Can also be forced to load by adding the following lines to your `configuration.yaml`: - -``` -chromecast: -``` - ## Services ### Media control services @@ -26,24 +27,24 @@ Available services: `turn_off`, `volume_up`, `volume_down`, `media_play_pause`, | Service data attribute | Optional | Description | | ---------------------- | -------- | ----------- | -| `entity_id` | yes | Target a specific chromecast. Defaults to all. +| `entity_id` | yes | Target a specific media player. Defaults to all. ### Media play services -There are three services to start playing YouTube video's on the ChromeCast. +There are three services to start playing YouTube video's on the media player. -#### Service `chromecast/play_youtube_video` -Service to start playing a YouTube vide on the Chromecast. +#### Service `media_player/play_youtube_video` +Service to start playing a YouTube vide on the media player. | Service data attribute | Optional | Description | | ---------------------- | -------- | ----------- | -| `entity_id` | yes | Target a specific chromecast. Defaults to all. +| `entity_id` | yes | Target a specific media player. Defaults to all. | `video` | no | YouTube video to be played, ie. `L0MK7qz13bU` -#### Service `chromecast/start_fireplace` and `chromecast/start_epic_sax` -Will either start a fireplace or Epic Sax Guy 10h on the Chromecast. +#### Service `media_player/start_fireplace` and `media_player/start_epic_sax` +Will either start a fireplace or Epic Sax Guy 10h on the media player. | Service data attribute | Optional | Description | | ---------------------- | -------- | ----------- | -| `entity_id` | yes | Target a specific chromecast. Defaults to all. +| `entity_id` | yes | Target a specific media player. Defaults to all. diff --git a/source/components/tellstick_sensor.markdown b/source/components/tellstick_sensor.markdown deleted file mode 100644 index d4ad1005c95..00000000000 --- a/source/components/tellstick_sensor.markdown +++ /dev/null @@ -1,22 +0,0 @@ ---- -layout: page -title: "Tellstick Sensors" -description: "Instructions how to setup tellstick sensors with Home Assistant." -date: 2015-01-24 14:39 -sidebar: false -comments: false -sharing: true -footer: true ---- - -Shows the values of that sensors that is connected to your Tellstick. - -To enable it, add the following lines to your `configuration.yaml`: - -``` -tellstick_sensor: -``` - -

-This component is going to be merged into the sensor component. -

diff --git a/source/images/screenshots/voice-commands.png b/source/images/screenshots/voice-commands.png new file mode 100644 index 00000000000..99a909466f4 Binary files /dev/null and b/source/images/screenshots/voice-commands.png differ