diff --git a/sass/custom/_paulus.scss b/sass/custom/_paulus.scss index b9fb643b409..6dd4bce605f 100644 --- a/sass/custom/_paulus.scss +++ b/sass/custom/_paulus.scss @@ -386,3 +386,21 @@ p.note { } } } + +// Responsive YouTube embeds. +// https://css-tricks.com/NetMag/FluidWidthVideo/Article-FluidWidthVideo.php +.videoWrapper { + position: relative; + padding-bottom: 56.25%; /* 16:9 */ + height: 0; + margin-bottom: 25px; + background: #000; + + iframe { + position: absolute; + top: 0; + left: 0; + width: 100%; + height: 100%; + } +} diff --git a/source/_components/alexa.markdown b/source/_components/alexa.markdown index 8e4d95966b4..6725d322fcf 100644 --- a/source/_components/alexa.markdown +++ b/source/_components/alexa.markdown @@ -14,12 +14,11 @@ featured: false The Alexa component allows you to integrate Home Assistant into Alexa/Amazon Echo. This component will allow you to query information within Home Assistant by using your voice. There are no supported sentences out of the box as of now, you will have to define them all yourself. This component does not yet allow the control of devices connected to Home Assistant. -

+

-

+
- -### Requirements before using +### {% linkable_title Requirements before using %} Amazon requires the endpoint of a skill to be hosted via SSL. Self-signed certificates are ok because our skills will only run in development mode. Read more on [our blog][blog-lets-encrypt] about how to set up encryption for Home Assistant. If you are unable to get https up and running, consider using [this AWS Lambda proxy for Alexa skills](https://forums.developer.amazon.com/forums/thread.jspa?messageID=18604). [blog-lets-encrypt]: https://home-assistant.io/blog/2015/12/13/setup-encryption-using-lets-encrypt/ @@ -36,7 +35,7 @@ To get started with Alexa skills: - https - https://YOUR_HOST/api/alexa?api_password=YOUR_API_PASSWORD -### Configuring your Amazon Alexa skill +### {% linkable_title Configuring your Amazon Alexa skill %} Alexa works based on intents. Each intent has a name and variable slots. For example, a `LocateIntent` with a slot that contains a `User`. Example intent schema: @@ -75,7 +74,7 @@ This means that we can now ask Alexa things like: - Alexa, ask Home Assistant where Paul is - Alexa, ask Home Assistant where we are -### Configuring Home Assistant +### {% linkable_title Configuring Home Assistant %} Out of the box, the component will do nothing. You have to teach it about all intents you want it to answer to. The way it works is that the answer for each intent is based on [templates] that you define. Each template will have access to the existing states via the `states` variable but will also have access to all variables defined in the intent. diff --git a/source/_components/automation.markdown b/source/_components/automation.markdown index 3ad6286c825..78e4154b6ae 100644 --- a/source/_components/automation.markdown +++ b/source/_components/automation.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: home-assistant.png ha_category: Automation --- diff --git a/source/_components/browser.markdown b/source/_components/browser.markdown index 6bf017554fb..273c3ae7e40 100644 --- a/source/_components/browser.markdown +++ b/source/_components/browser.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: browser.png ha_category: Other --- diff --git a/source/_components/configurator.markdown b/source/_components/configurator.markdown index eaa14aae299..d564089bc2c 100644 --- a/source/_components/configurator.markdown +++ b/source/_components/configurator.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: home-assistant.png ha_category: Other --- diff --git a/source/_components/conversation.markdown b/source/_components/conversation.markdown index 7ca6eb0147a..7851621520d 100644 --- a/source/_components/conversation.markdown +++ b/source/_components/conversation.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: conversation.png ha_category: "Other" --- diff --git a/source/_components/device_sun_light_trigger.markdown b/source/_components/device_sun_light_trigger.markdown index 391b475c531..1b8cbc18655 100644 --- a/source/_components/device_sun_light_trigger.markdown +++ b/source/_components/device_sun_light_trigger.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: home-assistant.png ha_category: Automation --- diff --git a/source/_components/device_tracker.markdown b/source/_components/device_tracker.markdown index 11a4bef0fa5..bb36d19013d 100644 --- a/source/_components/device_tracker.markdown +++ b/source/_components/device_tracker.markdown @@ -36,4 +36,4 @@ device_tracker: Once tracked, a file will be created in your config dir called `known_devices.yaml`. Edit this file to adjust which devices to be tracked. Here you can also setup a URL for each device to be used as the entity picture and set whether the device will be show in the UI when in the away state. -Multiple device trackers can be used in parallel, such as [Owntracks](/components/device_tracker.owntracks/) and [Nmap](/components/device_tracker.nmap_scanner/). The state of the device will be determined by the source that reported last. +Multiple device trackers can be used in parallel, such as [Owntracks](/components/device_tracker.owntracks/) and [Nmap](/components/device_tracker.nmap_scanner/). The state of the device will be determined by the source that reported last. Device tracker will look for global settings (track_new_devices, consider_home and home_interval) under the configuration of the first platform. \ No newline at end of file diff --git a/source/_components/discovery.markdown b/source/_components/discovery.markdown index 45ff84806ca..9f316298063 100644 --- a/source/_components/discovery.markdown +++ b/source/_components/discovery.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: home-assistant.png ha_category: Other --- @@ -28,6 +29,11 @@ To load this component, add the following lines to your `configuration.yaml`: discovery: ``` +

+The home-assistant server must be on the same network as the devices for uPnP discovery to work. +If running home-assistant in a docker container use switch `--net=host` to put it on the host's network. +

+ If you are developing a new platform, please read [how to make your platform discoverable]({{site_root}}/developers/add_new_platform/#discovery).

diff --git a/source/_components/downloader.markdown b/source/_components/downloader.markdown index a818996d030..928d1b0da98 100644 --- a/source/_components/downloader.markdown +++ b/source/_components/downloader.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: downloader.png ha_category: Other --- diff --git a/source/_components/group.markdown b/source/_components/group.markdown index 6fc90a36e50..57105769f34 100644 --- a/source/_components/group.markdown +++ b/source/_components/group.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: home-assistant.png ha_category: Organization --- diff --git a/source/_components/history.markdown b/source/_components/history.markdown index 2ec3792e469..d2cd12b6f1b 100644 --- a/source/_components/history.markdown +++ b/source/_components/history.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: home-assistant.png ha_category: "History" --- diff --git a/source/_components/http.markdown b/source/_components/http.markdown index cff1e1b3605..a098ebe8112 100644 --- a/source/_components/http.markdown +++ b/source/_components/http.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: http.png ha_category: "Other" --- diff --git a/source/_components/influxdb.markdown b/source/_components/influxdb.markdown index 204811d9a69..7f1973087ec 100644 --- a/source/_components/influxdb.markdown +++ b/source/_components/influxdb.markdown @@ -11,7 +11,7 @@ logo: influxdb.png ha_category: "History" --- -The `influxdb` component makes it possible to transfer all state changes to an external [InfluxDB](https://influxdb.com/) database. +The `influxdb` component makes it possible to transfer all state changes to an external [InfluxDB](https://influxdb.com/) database. For more details, [see the blog post on InfluxDB](/blog/2015/12/07/influxdb-and-grafana/). To use the `influxdb` component in your installation, add the following to your `configuration.yaml` file: @@ -29,7 +29,7 @@ Configuration variables: - **host** (*Required*): IP address of your database host, eg. http://192.168.1.10. - **port** (*Optional*): Port to use. Defaults to 8086. -- **database** (*Optional*): Name of the database to use. Defaults to `home_assistant` +- **database** (*Optional*): Name of the database to use. Defaults to `home_assistant`. The database must already exist. - **username** (*Optional*): The username of the database user. - **password** (*Optional*): The password for the database user account. diff --git a/source/_components/introduction.markdown b/source/_components/introduction.markdown index fb5fb93e878..dabfd1b4557 100644 --- a/source/_components/introduction.markdown +++ b/source/_components/introduction.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: home-assistant.png ha_category: Other --- diff --git a/source/_components/logbook.markdown b/source/_components/logbook.markdown index 6ac779cd1e4..7e3581788c3 100644 --- a/source/_components/logbook.markdown +++ b/source/_components/logbook.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: logbook.png ha_category: "History" --- diff --git a/source/_components/logger.markdown b/source/_components/logger.markdown index 36e3d1058cf..e7a9935c9bd 100644 --- a/source/_components/logger.markdown +++ b/source/_components/logger.markdown @@ -7,10 +7,11 @@ sidebar: true comments: false sharing: true footer: true +logo: home-assistant.png ha_category: "Other" --- -The logger component let one define the level of logging activities in Home Assistant. +The logger component lets one define the level of logging activities in Home Assistant. To enable the logger in your installation, add the following to your `configuration.yaml` file: diff --git a/source/_components/scene.markdown b/source/_components/scene.markdown index a887ecc06a0..083bd0c0a34 100644 --- a/source/_components/scene.markdown +++ b/source/_components/scene.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: home-assistant.png ha_category: Organization --- diff --git a/source/_components/script.markdown b/source/_components/script.markdown index 7031ae1b495..033c51e70de 100644 --- a/source/_components/script.markdown +++ b/source/_components/script.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: home-assistant.png ha_category: Automation --- @@ -19,7 +20,7 @@ script: wakeup: alias: Wake Up sequence: - - event: logbook_entry + - event: LOGBOOK_ENTRY event_data: name: Paulus message: is waking up diff --git a/source/_components/sensor.torque.markdown b/source/_components/sensor.torque.markdown index 146b6c3c9aa..f7287899d91 100644 --- a/source/_components/sensor.torque.markdown +++ b/source/_components/sensor.torque.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: torque.png ha_category: Sensor --- diff --git a/source/_components/sensor.twitch.markdown b/source/_components/sensor.twitch.markdown index 18f449e00ed..56c5dff9331 100644 --- a/source/_components/sensor.twitch.markdown +++ b/source/_components/sensor.twitch.markdown @@ -21,8 +21,8 @@ To use Twitch with your installation, add the following to your `configuration.y sensor: platform: twitch channels: - - channel1 - - channel2 + - channel1 + - channel2 ``` Configuration variables: diff --git a/source/_components/simple_alarm.markdown b/source/_components/simple_alarm.markdown index 726d3edea2e..f158203cec4 100644 --- a/source/_components/simple_alarm.markdown +++ b/source/_components/simple_alarm.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: home-assistant.png ha_category: Alarm --- diff --git a/source/_components/sun.markdown b/source/_components/sun.markdown index b4e66dc1e93..3d5c3268b97 100644 --- a/source/_components/sun.markdown +++ b/source/_components/sun.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: sun.png ha_category: Weather --- diff --git a/source/_components/switch.command_switch.markdown b/source/_components/switch.command_switch.markdown index 79f8244fd4c..9e0c38b8129 100644 --- a/source/_components/switch.command_switch.markdown +++ b/source/_components/switch.command_switch.markdown @@ -11,7 +11,7 @@ ha_category: Switch --- -A switch platform that issues specific commands when it is turned on and off. This might very well become our most platform as it allows anyone to integrate any type of switch into Home Assistant that can be controlled from the command line, including calling other scripts! +A switch platform that issues specific commands when it is turned on and off. This might very well become our most powerful platform as it allows anyone to integrate any type of switch into Home Assistant that can be controlled from the command line, including calling other scripts! To enable it, add the following lines to your `configuration.yaml`: diff --git a/source/_components/switch.vera.markdown b/source/_components/switch.vera.markdown index b8ec1307db7..868d6301587 100644 --- a/source/_components/switch.vera.markdown +++ b/source/_components/switch.vera.markdown @@ -18,7 +18,7 @@ To use your Vera switches in your installation, add the following to your `confi ```yaml # Example configuration.yaml entry -light: +switch: platform: vera vera_controller_url: http://YOUR_VERA_IP:3480/ device_data: diff --git a/source/_components/thermostat.heat_control.markdown b/source/_components/thermostat.heat_control.markdown index a2a98b1001f..d27bb3993bb 100644 --- a/source/_components/thermostat.heat_control.markdown +++ b/source/_components/thermostat.heat_control.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: heat-control.png ha_category: Thermostat --- diff --git a/source/_components/updater.markdown b/source/_components/updater.markdown index ca4fe72dcc9..44d270b7b1e 100644 --- a/source/_components/updater.markdown +++ b/source/_components/updater.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: updater.png ha_category: Other --- diff --git a/source/_components/zone.markdown b/source/_components/zone.markdown index 272b45b8235..ceada253041 100644 --- a/source/_components/zone.markdown +++ b/source/_components/zone.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: home-assistant.png ha_category: Organization --- diff --git a/source/_posts/2015-12-06-community-highlights.markdown b/source/_posts/2015-12-06-community-highlights.markdown index 02431853f1d..bce943466ae 100644 --- a/source/_posts/2015-12-06-community-highlights.markdown +++ b/source/_posts/2015-12-06-community-highlights.markdown @@ -17,7 +17,7 @@ First is the public beta of [Let's Encrypt](https://letsencrypt.org/). Let's Enc The next thing is a show-off of some of the cool stuff people do with Home Assistant. This is miniconfig talking to Home Assistant using the Amazon Echo! -

+
diff --git a/source/_posts/2015-12-07-influxdb-and-grafana.markdown b/source/_posts/2015-12-07-influxdb-and-grafana.markdown index f53f93d1c78..d7a53295700 100644 --- a/source/_posts/2015-12-07-influxdb-and-grafana.markdown +++ b/source/_posts/2015-12-07-influxdb-and-grafana.markdown @@ -30,7 +30,7 @@ Launch the InfluxDB service. $ sudo systemctl start influxdb ``` -If everything went well, then the web interface of the ddatabase should be accessible at [http://localhost:8083/](http://localhost:8083/). Create a database `home_assistant` to use with Home Assistant either with the web interface or the commandline tool `influx`. +If everything went well, then the web interface of the database should be accessible at [http://localhost:8083/](http://localhost:8083/). Create a database `home_assistant` to use with Home Assistant either with the web interface or the commandline tool `influx`.

diff --git a/source/_posts/2015-12-20-amazon-echo-icloud-and-templates.markdown b/source/_posts/2015-12-20-amazon-echo-icloud-and-templates.markdown index c6b8c2729fd..46720e849fb 100644 --- a/source/_posts/2015-12-20-amazon-echo-icloud-and-templates.markdown +++ b/source/_posts/2015-12-20-amazon-echo-icloud-and-templates.markdown @@ -8,12 +8,14 @@ author: Paulus Schoutsen author_twitter: balloob comments: true categories: Release-Notes -# og_image: +og_image: /images/blog/2015-12-release-10/alexa-fb.png --- Alrighty, it's time for Home Assistant 0.10. A lot amazing things have changed and sadly we also had to introduce a bunch of backwards incompatible changes. I would like to give a big shoutout to Philip Lundrigan ([@philipbl]) who put a lot in effort in helping the migration to move towards using templates for a wide variety of platforms. -

+
+ +
diff --git a/source/cookbook/index.markdown b/source/cookbook/index.markdown index 5c978b8d790..458f8cac657 100644 --- a/source/cookbook/index.markdown +++ b/source/cookbook/index.markdown @@ -21,3 +21,4 @@ This is a community currated list of `configuration.yaml` examples. New recipes Some users keep a public scrubbed copy of their `configuration.yaml` to learn from. - [Configuration.yaml by Carlo Costanzo](https://gist.github.com/CCOSTAN/9934de973a293b809868) +- [Configuration.yaml by happyleavesaoc](https://github.com/happyleavesaoc/my-home-automation/tree/master/homeassistant) diff --git a/source/getting-started/automation.markdown b/source/getting-started/automation.markdown index dd252b41bae..1538529f1c5 100644 --- a/source/getting-started/automation.markdown +++ b/source/getting-started/automation.markdown @@ -138,6 +138,7 @@ We went over the basics of creating a home automation rule. From here no longer - Learn about [scripts](/components/script/) to help you trigger multiple actions and delays - Learn about [scenes](/components/scene/) to help you set many entities at once to your liking - Setup a [notification platform](/components/#notifications) to sent yourself messages + - For more advanced automation using Python, write your own [custom component](/developers/creating_components/).

Whenever you write the value on or off, surround it with quotes to avoid diff --git a/source/getting-started/index.markdown b/source/getting-started/index.markdown index 92b2b71f6ae..3e3951ef5ce 100644 --- a/source/getting-started/index.markdown +++ b/source/getting-started/index.markdown @@ -57,8 +57,8 @@ Home Assistant requires the Raspberry Pi to run [Raspbian Jessie](https://www.ra Execute the following code in a console: ```bash -$ pip3 install homeassistant -$ hass --open-ui +$ sudo pip3 install homeassistant +$ hass ``` Running these commands will: diff --git a/source/images/blog/2015-12-release-10/alexa-fb.png b/source/images/blog/2015-12-release-10/alexa-fb.png new file mode 100644 index 00000000000..627b7adfd09 Binary files /dev/null and b/source/images/blog/2015-12-release-10/alexa-fb.png differ diff --git a/source/images/supported_brands/browser.png b/source/images/supported_brands/browser.png new file mode 100644 index 00000000000..18c4902bf45 Binary files /dev/null and b/source/images/supported_brands/browser.png differ diff --git a/source/images/supported_brands/conversation.png b/source/images/supported_brands/conversation.png new file mode 100644 index 00000000000..02b3879f9e1 Binary files /dev/null and b/source/images/supported_brands/conversation.png differ diff --git a/source/images/supported_brands/downloader.png b/source/images/supported_brands/downloader.png new file mode 100644 index 00000000000..8c83bffa7e4 Binary files /dev/null and b/source/images/supported_brands/downloader.png differ diff --git a/source/images/supported_brands/heat-control.png b/source/images/supported_brands/heat-control.png new file mode 100644 index 00000000000..53c028a9b6f Binary files /dev/null and b/source/images/supported_brands/heat-control.png differ diff --git a/source/images/supported_brands/home-assistant.png b/source/images/supported_brands/home-assistant.png new file mode 100644 index 00000000000..8d097db2f85 Binary files /dev/null and b/source/images/supported_brands/home-assistant.png differ diff --git a/source/images/supported_brands/http.png b/source/images/supported_brands/http.png new file mode 100644 index 00000000000..984d013a78c Binary files /dev/null and b/source/images/supported_brands/http.png differ diff --git a/source/images/supported_brands/logbook.png b/source/images/supported_brands/logbook.png new file mode 100644 index 00000000000..d177bfef5ca Binary files /dev/null and b/source/images/supported_brands/logbook.png differ diff --git a/source/images/supported_brands/sun.png b/source/images/supported_brands/sun.png new file mode 100644 index 00000000000..df5443e639d Binary files /dev/null and b/source/images/supported_brands/sun.png differ diff --git a/source/images/supported_brands/torque.png b/source/images/supported_brands/torque.png new file mode 100644 index 00000000000..3a343849378 Binary files /dev/null and b/source/images/supported_brands/torque.png differ diff --git a/source/images/supported_brands/updater.png b/source/images/supported_brands/updater.png new file mode 100644 index 00000000000..94dfb6c3be1 Binary files /dev/null and b/source/images/supported_brands/updater.png differ