Merge branch 'current' into next

source/_addons/git_pull.markdown

@@ -18,7 +18,17 @@ Load and update configuration files for Home Assistant from a GIT repository.
   "repeat": {
     "active": false,
     "interval": 300
-  }
+  },
+  "deployment_key": [
+"-----BEGIN RSA PRIVATE KEY-----",
+"MIIEowIBAAKCAQEAv3hUrCvqGZKpXQ5ofxTOuH6pYSOZDsCqPqmaGBdUzBFgauQM",
+"xDEcoODGHIsWd7t9meAFqUtKXndeiKjfP0MMKsttnDohL1kb9mRvHre4VUqMsT5F",
+"...",
+"i3RUtnIHxGi1NqknIY56Hwa3id2yk7cEzvQGAAko/t6PCbe20AfmSQczs7wDNtBD",
+"HgXRyIqIXHYk2+5w+N2eunURIBqCI9uWYK/r81TMR6V84R+XhtvM",
+"-----END RSA PRIVATE KEY-----"
+  ],
+  "deployment_key_protocol": "rsa"
 }
 ```
 
@@ -26,3 +36,12 @@ Load and update configuration files for Home Assistant from a GIT repository.
 - **auto_restart** (*Optional*): Make a restart of Home-Assistant if the config have change and is valid.
 - **repeat/active** (*Optional*): Pull periodic for GIT updates.
 - **repeat/interval** (*Optional*): Pull all x seconds and look for changes.
+- **deployment_key** (*Optional*): A private SSH key that will be used for communication during git operations. This key is mandatory for ssh-accessed repositories, which are the ones with the following pattern: `<user>@<host>:<repository path>`.
+- **deployment_key_protocol** (*Optional*): The key protocol. Default is "rsa". Valid protocols are:
+
+  * **dsa**
+  * **ecdsa**
+  * **ed25519**
+  * **rsa**
+  
+  The protocol is typically known by the suffix of the private key --e.g., a key file named `id_rsa` will be a private key using "rsa" protocol.

source/_components/apple_tv.markdown

@@ -11,7 +11,6 @@ logo: apple.png
 ha_category: Hub
 ha_iot_class: "Local Push"
 ha_release: 0.49
-featured: true
 ---
 
 The `apple_tv` platform allows you to control an Apple TV (3rd and 4th generation). See the [remote platform](/components/remote.apple_tv/) if you want to send remote control buttons, e.g. arrow keys.

source/_components/binary_sensor.bayesian.markdown

@@ -69,7 +69,7 @@ binary_sensor:
       prob_given_true: 0.5
       platform: 'state'
       to_state: 'on'
-    - entity_id: 'sensor.sun'
+    - entity_id: 'sun.sun'
       prob_given_true: 0.7
       platform: 'state'
       to_state: 'below_horizon'

source/_components/binary_sensor.knx.markdown

@@ -18,6 +18,7 @@ The `knx` sensor platform allows you to monitor [KNX](http://www.knx.org) binary
 The `knx` component must be configured correctly, see [KNX Component](/components/knx).
 
 ```yaml
+# Example configuration.yaml entry
 binary_sensor:
   - platform: knx
     name: "Entrance.Motion.Sensor"
@@ -26,14 +27,17 @@ binary_sensor:
     #significant_bit: 2
 ```
 
-* **name** (*Optional*): A name for this device used within Home Assistant.
+Configuration variables:
-* **address**: KNX group address of the binary sensor
+
-* **device_class**: (Optional) HASS device class e.g. "motion"
+- **name** (*Optional*): A name for this device used within Home Assistant.
-* **significant_bit**: (Optional) Specify which significant bit of the KNX value should be used. Default is 1.
+- **address**: KNX group address of the binary sensor.
+- **device_class** (Optional): HASS device class e.g. "motion".
+- **significant_bit** (Optional): Specify which significant bit of the KNX value should be used. Default is 1.
 
 You can also attach actions to binary sensors (e.g., to switch on a light when a switch was pressed). In this example, one light is switched on when the button was pressed once and two others when the button was pressed a second time.
 
 ```yaml
+# Example configuration.yaml entry
 binary_sensor:
   - platform: knx
     name: Livingroom.3Switch3
@@ -53,8 +57,10 @@ binary_sensor:
             service: homeassistant.turn_on
 ```
 
-- **name** (*Optional*): A name for this device used within Home Assistant.
+Configuration variables:
-- **counter**: (*Optional*) Set to 2 if your only want the action to be executed if the button was pressed twice. To 3 for three times button pressed. Defaults to 1.
+
-- **hook**: (Optional): Indicates if the automation should be executed on what state of the binary sensor. Values: "on" or "off". Defaults to "on".
+- **name** (*Optional*): A name for this device used within Home Assistant.
-- **action**: Specify a list of actions analog to the [HASS automation rules](https://home-assistant.io/docs/automation/action/).
+- **counter** (*Optional*): Set to 2 if your only want the action to be executed if the button was pressed twice. To 3 for three times button pressed. Defaults to 1.
+- **hook** (Optional): Indicates if the automation should be executed on what state of the binary sensor. Values: "on" or "off". Defaults to "on".
+- **action**: Specify a list of actions analog to the [automation rules](/docs/automation/action/).
 

source/_components/binary_sensor.markdown

@@ -9,9 +9,7 @@ sharing: true
 footer: true
 ---
 
-Binary sensors gather information about state of switches, contacts, pins, and alike. The return value of those sensors is usually digital (1/0). This means that those sensors knows only two states: **0/off/low/closed/false** and **1/on/high/open/true**.
+Binary sensors gather information about the state of devices which have a "digital" return value (either 1 or 0). These can be switches, contacts, pins, etc. These sensors only have two states: **0/off/low/closed/false** and **1/on/high/open/true**.  Knowing that there are only two states allows Home Assistant to represent these sensors in a better way in the frontend according to their functionality.
-
-Knowing that there are only two states allows Home Assistant to represent these sensors in a better way in the frontend according to their functionality.
 
 The way these sensors are displayed in the frontend can be modified in the [customize section](/getting-started/customizing-devices/). The following device classes are supported for binary sensors:
 

source/_components/climate.ephember.markdown

@@ -0,0 +1,33 @@
+---
+layout: page
+title: "EPH Controls Ember Thermostat"
+description: "Instructions on how to integrate EPH Controls Ember thermostats within Home Assistant."
+date: 2017-10-07 12:40
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: ephcontrolsember.png
+ha_category: Climate
+ha_release: "0.55"
+ha_iot_class: "Local Polling"
+---
+
+
+The `ephember` climate platform lets you control [EPH Controls](http://emberapp.ephcontrols.com/) thermostats. The module only works if you have a WiFi gateway to control your EPH system and an account on the ember app.
+
+To set it up, add the following information to your `configuration.yaml` file:
+
+```yaml
+climate:
+  - platform: ephember
+    username: YOUR_EMAIL
+    password: YOUR_PASSWORD
+```
+
+A single interface can handle up to 32 connected devices.
+
+Configuration variables:
+
+- **username** (*Required*): The email address you used to sign up to the ember app
+- **password** (*Required*): The password you used to sign up to the ember app

source/_components/climate.knx.markdown

@@ -21,6 +21,7 @@ The `knx` component must be configured correctly, see [KNX Component](/component
 To use your KNX thermostats in your installation, add the following lines to your `configuration.yaml` file:
 
 ```yaml
+# Example configuration.yaml entry
 climate:
    - platform: knx
      name: HASS-Kitchen.Temperature
@@ -33,6 +34,7 @@ climate:
 Alternatively, if your device has dedicated binary group addresses for frost/night/comfort mode:
 
 ```yaml
+# Example configuration.yaml entry
 climate:
   - platform: knx
     name: HASS-Kitchen.Temperature
@@ -44,20 +46,21 @@ climate:
     operation_mode_comfort_address: '5/1/5'
 ```
 
+Configuration variables:
 
-* **name** (*Optional*): A name for this device used within Home Assistant.
+- **name** (*Optional*): A name for this device used within Home Assistant.
-* **temperature_address**: KNX group address for reading current room temperature from KNX bus.
+- **temperature_address**: KNX group address for reading current room temperature from KNX bus.
-* **target_temperature_address**: KNX group address for reading current target temperature from KNX bus.
+- **target_temperature_address**: KNX group address for reading current target temperature from KNX bus.
-* **setpoint_address**: KNX group address for basis setpoint
+- **setpoint_address**: KNX group address for basis setpoint
 
-* **operation_mode_address** (*Optional*) KNX address for operation mode (Frost protection/night/comfort).
+- **operation_mode_address** (*Optional*): KNX address for operation mode (Frost protection/night/comfort).
-* **operation_mode_state_address** (*Optional*) Explicit KNX address for reading operation mode
+- **operation_mode_state_address** (*Optional*): Explicit KNX address for reading operation mode
-* **controller_status_address** (*Optional*) KNX address for HVAC controller status (in accordance with KNX AN 097/07 rev 3)
+- **controller_status_address** (*Optional*): KNX address for HVAC controller status (in accordance with KNX AN 097/07 rev 3)
-* **controller_status_state_address** (*Optional*) Explicit KNX address for reading HVAC controller status
+- **controller_status_state_address** (*Optional*): Explicit KNX address for reading HVAC controller status
 
-* **operation_mode_frost_protection_address** (*Optional*) KNX address for switching on/off frost/heat protection mode.
+- **operation_mode_frost_protection_address** (*Optional*): KNX address for switching on/off frost/heat protection mode.
-* **operation_mode_night_address** (*Optional*) KNX address for switching on/off night mode.
+- **operation_mode_night_address** (*Optional*): KNX address for switching on/off night mode.
-* **operation_mode_comfort_address** (*Optional*) KNX address for switching on/off comfort mode.
+- **operation_mode_comfort_address** (*Optional*): KNX address for switching on/off comfort mode.
 
 `operation_mode_frost_protection_address` / `operation_mode_night_address` / `operation_mode_comfort_address` are not necessary if `operation_mode_address` was specified.
 

source/_components/climate.mqtt.markdown

@@ -70,7 +70,6 @@ A full configuration example looks like the one below.
 climate:
   - platform: mqtt
     name: Study
-    target_sensor: sensor.study_temperature
     modes:
       - off
       - cool

source/_components/counter.markdown

@@ -32,11 +32,10 @@ Configuration variables:
   - **step** (*Optional*): Incremental/step value for the counter. Defaults to 1 (increments by 1).
   - **icon** (*Optional*): Icon for entry.
 
-Pick an icon that you can find on [materialdesignicons.com](https://materialdesignicons.com/) to use for your input and prefix the name with `mdi:`. For example `mdi:car`, `mdi:ambulance`, or  `mdi:motorbike`.
+Pick an icon that you can find on [materialdesignicons.com](https://materialdesignicons.com/) to use for your input and prefix the name with `mdi:`. For example `mdi:car`, `mdi:ambulance` or `mdi:motorbike`.
 
 ## {% linkable_title Services %}
 
-### {% linkable_title Media control services %}
 Available services: `increment`, `decrement`, and `reset`.
 
 #### {% linkable_title Service `counter.increment` %}

source/_components/cover.knx.markdown

@@ -33,15 +33,17 @@ cover:
     travelling_time_up: 61
 ```
 
+Configuration variables:
+
 - **name** (*Optional*): A name for this device used within Home Assistant.
 - **move_long_address**: KNX group address for moving the cover full up or down.
-- **move_short_address**: (*Optional*) KNX group address for moving the cover short time up or down.
+- **move_short_address** (*Optional*): KNX group address for moving the cover short time up or down.
-- **position_address**: (*Optional*) KNX group address for moving the cover to the dedicated position.
+- **position_address** (*Optional*): KNX group address for moving the cover to the dedicated position.
-- **position_state_address**: (*Optional*) Separate KNX group address for requesting the current position of the cover.
+- **position_state_address** (*Optional*): Separate KNX group address for requesting the current position of the cover.
-- **angle_address**: (*Optional*) KNX group address for moving the cover to the dedicated angle.
+- **angle_address** (*Optional*): KNX group address for moving the cover to the dedicated angle.
-- **angle_state_address**: (*Optional*) Separate KNX group address for requesting the current angle of cover.
+- **angle_state_address** (*Optional*): Separate KNX group address for requesting the current angle of cover.
-- **travelling_time_down**: (*Optional*) Time cover needs to travel down in seconds. Needed to calculate the intermediate positions of cover while traveling. Defaults to 25.
+- **travelling_time_down** (*Optional*): Time cover needs to travel down in seconds. Needed to calculate the intermediate positions of cover while traveling. Defaults to 25.
-- **travelling_time_up**: (*Optional*) Time cover needs to travel up in seconds. Needed to calculate the intermediate positions of cover while traveling. Defaults to 25.
+- **travelling_time_up** (*Optional*): Time cover needs to travel up in seconds. Needed to calculate the intermediate positions of cover while traveling. Defaults to 25.
-- **invert_position**: (*Optional*) Set this to true if your actuator report fully closed as 100%
+- **invert_position** (*Optional*): Set this to true if your actuator report fully closed as 100%.
-- **invert_angle**: (*Optional*) Set this to true if your actuator reports tilt fully closed as 100%
+- **invert_angle** (*Optional*): Set this to true if your actuator reports tilt fully closed as 100%.
 

source/_components/device_tracker.locative.markdown

@@ -11,6 +11,10 @@ logo: locative.png
 ha_category: Presence Detection
 ---
 
+<p class='note'>
+Locative is no longer under active development. See https://blog.locative.io/bye-everyone-df01871fe949
+</p>
+
 This platform allows you to detect presence using [Locative](https://my.locative.io/). Locative is an open source app for [iOS](https://github.com/LocativeHQ/ios-app) and [Android](https://github.com/LocativeHQ/Locative-Android) that allows users to set up a `GET` or `POST` request when a geofence is entered or exited. This can be configured with Home Assistant to update your location.
 
 To integrate Locative in Home Assistant, add the following section to your `configuration.yaml` file:

source/_components/device_tracker.owntracks.markdown

@@ -30,7 +30,7 @@ Configuration variables:
 
 - **max_gps_accuracy** (*Optional*): Sometimes Owntracks can report GPS location with a very low accuracy (few kilometers). That can trigger false zoning in your Home Assistant installation. With the parameter, you can filter these GPS reports. The number has to be in meter. For example, if you put 200 only GPS report with an accuracy under 200 will be take in account.
 - **waypoints** (*Optional*): Owntracks users can define [waypoints](http://owntracks.org/booklet/features/waypoints/) (a.k.a regions) which are similar in spirit to Home Assistant zones. If this configuration variable is `True`, the Owntracks users who are in `waypoint_whitelist` can export waypoints from the device and Home Assistant will import them as zone definitions. Defaults to `True`.
-- **waypoint_whitelist** (*Optional*): A list of user names (as defined for [Owntracks](/components/device_tracker.owntracks/)) who can export their waypoints from Owntracks to Home Assistant. Defaults to all users who are connected to Home Assistant via Owntracks.
+- **waypoint_whitelist** (*Optional*): A list of user names (as defined for [Owntracks](/components/device_tracker.owntracks/)) who can export their waypoints from Owntracks to Home Assistant.  This would be the `username` portion of the Base Topic Name, (e.g. owntracks/**username**/iPhone). Defaults to all users who are connected to Home Assistant via Owntracks.
 - **secret** (*Optional*): [Payload encryption key](http://owntracks.org/booklet/features/encrypt/). This is usable when communicating with a third-party untrusted server or a public server (where anybody can subscribe to any topic). By default the payload is assumed to be unencrypted (although the communication between Home Assistant and the server might still be encrypted). This feature requires the `libsodium` library to be present.
 
 A full sample configuration for the `owntracks` platform is shown below:

source/_components/dialogflow.markdown

@@ -7,7 +7,7 @@ sidebar: true
 comments: false
 sharing: true
 footer: true
-logo: apiai.png
+logo: dialogflow.png
 ha_category: Voice
 featured: false
 ha_release: 0.56

source/_components/google_assistant.markdown

@@ -16,6 +16,10 @@ ha_release: 0.56
 # Google Assistant Docs
 The Google Assistant component requires a bit more setup than most due to the way Google requires Assistant Apps to be set up.
 
+<p class='note'>
+To use Google Assistant your Home Assistant configuration has to be externally accessible, with a hostname and SSL certificate. If you haven't already configured that you should do so before continuing.
+</p>
+
 ### {% linkable_title Configuration %}
 
 ```yaml

source/_components/group.markdown

@@ -89,3 +89,38 @@ Notice in the example below that in order to refer to the group "Living Room", y
       - group.living_room
       - group.bedroom
 ``` 
+
+## {% linkable_title Default groups %}
+
+Some components automatically create special groups containing component entities. These groups are named like `group.all_...`, for example:
+- `group.all_switches`
+- `group.all_lights`
+- `group.all_devices`
+- `group.all_scripts`
+- `group.all_automations`
+
+You can see list of these groups in  **State** <img src='/images/screenshots/developer-tool-states-icon.png' class='no-shadow' height='38' /> page of the **Developer Tools**.
+
+Default groups appear in the HOME tab, if not overridden by user views and groups. Default groups are hidden by default, so you must [customize](/docs/configuration/customizing-devices/) them to be visible in your custom groups and views.
+
+```yaml
+# Example configuration.yaml to include default groups in custom view
+
+customize:
+  group.all_automations:
+    hidden: false
+  group.all_scripts:
+    hidden: false
+
+group:
+  automation_view:
+    name: Automation
+    view: yes
+    entities:
+      - group.all_automations
+      - group.all_scripts
+```
+
+## {% linkable_title Group behaviour %}
+
+When any member of a group is `on` then the group will also be `on`. Similarly with a device tracker, when any member of the group is `home` then the group is `home`.

source/_components/knx.markdown

@@ -13,8 +13,6 @@ ha_release: 0.24
 ha_iot_class: "Local Polling"
 ---
 
-Overview
---------
 
 The [KNX](http://www.knx.org) integration for Home Assistant allows you to connect to a KNX/IP devices.
 
@@ -30,8 +28,7 @@ There is currently support for the following device types within Home Assistant:
 - [Thermostat](/components/climate.knx)
 - [Notify](/components/notify.knx)
 
-Configuration
+### {% linkable_title Configuration %}
---------------
 
 To use your KNX in your installation, add the following lines to your `configuration.yaml` file:
 
@@ -39,13 +36,14 @@ To use your KNX in your installation, add the following lines to your `configura
 knx:
 ```
 
-Optional, recommended for large KNX installations (>100 devices) and/or if you want to use the XKNX abstraction also for other scripted tools outside HASS:
+Optional, recommended for large KNX installations (>100 devices) and/or if you want to use the XKNX abstraction also for other scripted tools outside of Home Assistant:
 
 ```yaml
 knx:
   config_file: '/path/to/xknx.yaml'
 ```
-* **config_file**: (*Optional*) path for xknx configuration file.
+
+- **config_file** (*Optional*): The path for XKNX configuration file.
 
 If the auto detection of the KNX/IP device does not work you can specify ip/port of the tunneling device:
 
@@ -56,9 +54,10 @@ knx:
     port: 3671
     local_ip: '192.168.2.109'
 ```
-* **host**: Host of the KNX/IP tunneling device
+
-* **port**: Port of the KNX/IP tunneling device
+- **host**: Host of the KNX/IP tunneling device.
-* **local_ip**: IP of the local interface
+- **port**: Port of the KNX/IP tunneling device.
+- **local_ip**: IP of the local interface.
 
 Explicit connection to a KNX/IP routing device:
 
@@ -68,7 +67,8 @@ knx:
   routing:
      local_ip: '192.168.2.109'
 ```
-* **local_ip**: local ip of interface (which should be used for multicasting)
+
+- **local_ip**: The local IP address of interface (which should be used for multicasting).
 
 ```yaml
 knx:
@@ -76,13 +76,11 @@ knx:
     fire_event_filter: ["1/0/*", "6/2,3,4-6/*"]
 ```
 
-* **fire_event** (*Optional*): If set to True, platform will write all received KNX messages to event bus
+- **fire_event** (*Optional*): If set to True, platform will write all received KNX messages to event bus
-* **fire_event_filter** (*Optional*): If `fire_event` is set `fire_event_filter` has to be specified. `fire_event_filter` defines a list of patterns for filtering KNX addresses. Only telegrams which match this pattern are sent to the HASS event bus. 
+- **fire_event_filter** (*Optional*): If `fire_event` is set `fire_event_filter` has to be specified. `fire_event_filter` defines a list of patterns for filtering KNX addresses. Only telegrams which match this pattern are sent to the HOme Assistant event bus. 
+- **state_updater** (*Optional*): The component will collect the current state of each configured device from the KNX bus to display it correctly within Home-Assistant. Set this option to False to prevent this behaviour.
 
-* **state_updater** (*Optional*): The component will collect the current state of each configured device from the KNX bus to display it correctly within Home-Assistant. Set this option to False to prevent this behaviour.
+### {% linkable_title Services %}
-
-Service
--------
 
 In order to directly interact with the KNX bus, you can now use the following service:
 
@@ -96,12 +94,7 @@ Service Data: {"address": "1/0/15", "payload": 0}
 * **payload**: Payload, either an integer or an array of integers
 
 
+### {% linkable_title Known issues %}
 
-Known issues:
+Due to lame multicast support the routing abstraction and the gateway scanner only work with Python >=3.5.
--------------
-
-Due to lame multicast support the routing abstraction and the gateway scanner
-only work with python >=3.5.
-
-
 

source/_components/light.knx.markdown

@@ -21,23 +21,21 @@ The `knx` component must be configured correctly, see [KNX Component](/component
 To use your KNX light in your installation, add the following lines to your `configuration.yaml` file:
 
 ```yaml
+# Example configuration.yaml entry
 light:
   - platform: knx
     name: Kitchen-Light-1
     address: '1/0/9'
     brightness_address: '1/0/11'
-
-  - platform: knx
-    name: Kitchen-Light-2
-    address: '1/0/12'
-    brightness_address: '1/0/14'
 ```
 
-* **name** (*Optional*): A name for this device used within Home Assistant.
+Configuration variables:
-* **address**: KNX group address for switching the light on and off
+
-* **brightness_address**: (Optional) KNX group address for dimming light.
+- **name** (*Optional*): A name for this device used within Home Assistant.
-* **state_address**: (*Optional*) separate KNX group address for retrieving the switch state of the light.
+- **address**: KNX group address for switching the light on and off.
-* **brightness_state_address**: (*Optional*) separate KNX group address for retrieving the dimmed state of the light.
+- **brightness_address** (Optional): KNX group address for dimming light.
+- **state_address** (*Optional*): separate KNX group address for retrieving the switch state of the light.
+- **brightness_state_address** (*Optional*): separate KNX group address for retrieving the dimmed state of the light.
 
 Some KNX devices can change their state internally without any messages on the KNX bus, e.g., if you configure a timer on a channel. The optional `state_address` can be used to inform Home Assistant about these state changes. If a KNX message is seen on the bus addressed to the given state address, this will overwrite the state of the switch object.
 For switching/light actuators that are only controlled by a single group address and can't change their state internally, you don't have to configure the state address.

source/_components/map.markdown

@@ -17,3 +17,6 @@ This offers a map on the frontend to display the location of tracked devices. To
 # Example configuration.yaml entry
 map:
 ```
+<p class='note'>
+Devices that are currently at home won't show on the map.
+</p>

source/_components/media_player.apple_tv.markdown

@@ -1,6 +1,6 @@
 ---
 layout: page
-title: "Apple TV"
+title: "Apple TV Media Player"
 description: "Instructions how to integrate Apple TV devices into Home Assistant."
 date: 2017-02-08 07:11
 sidebar: true
@@ -13,4 +13,4 @@ ha_iot_class: "Local Push"
 ha_release: 0.38
 ---
 
-To setup the `apple_tv` platform, please follow the instructions on the [Apple TV Component page](/components/apple_tv/).
+To setup the `apple_tv` media player platform, please follow the instructions on the [Apple TV Component page](/components/apple_tv/).

source/_components/media_player.markdown

@@ -57,7 +57,8 @@ Available services: `turn_on`, `turn_off`, `toggle`, `volume_up`, `volume_down`,
 | `source`               |       no | Name of the source to switch to. Platform dependent. |
 
 #### {% linkable_title Service `media_player/shuffle_set` %}
-Currently only supports Spotify.
+
+Currently only supported on [Spotify](/components/media_player.spotify/), [MPD](/components/media_player.mpd/), [Kodi](/components/media_player.kodi/), and [Universal](/components/media_player.universal/).
 
 | Service data attribute | Optional | Description                                          |
 | ---------------------- | -------- | ---------------------------------------------------- |

source/_components/media_player.samsungtv.markdown

@@ -55,6 +55,7 @@ Currently known supported models:
 - U6300 (port must be set to 8001, and `pip3 install websocket-client` must be executed)
 - K6500AF (port must be set to 8001)
 - KS8005 (port must be set to 8001, and `pip3 install websocket-client` must be executed)
+- KS7502 (port must be set to 8001, and `pip3 install websocket-client` must be executed, turn on doesn't work, turn off works fine)
 - K5600AK (partially supported, turn on works but state is not updated)
 
 Currently tested but not working models:

source/_components/media_player.webostv.markdown

@@ -15,7 +15,16 @@ ha_release: 0.18
 
 The `webostv` platform allows you to control a [LG](http://www.lg.com/) webOS Smart TV.
 
-When the TV is first connected, you will need to accept Home Assistant on the TV to allow communication.
+### {% linkable_title Setup %}
+
+To begin with enable *LG Connect Apps* feature in *Network* settings of the TV [instructions](http://www.lg.com/uk/support/product-help/CT00008334-1437131798537-others).
+
+Once basic configuration is added to your `configuration.yaml` *Configuration* card should prompt on your HA's States. Follow the instructions and accept pairing request on your TV.
+
+Pairing information will be saved to the `filename:` provided in configuration; this process is IP sensitive, in case the IP address of your TV would change in future.
+
+
+### {% linkable_title Configuration %}
 
 To add a TV to your installation, add the following to your `configuration.yaml` file:
 
@@ -33,10 +42,9 @@ Configuration variables:
 - **timeout** (*Optional*): The timeout for connections to the TV in seconds.
 - **filename** (*Optional*): The filename where the pairing key with the TV should be stored. This path is relative to Home Assistant's config directory. It defaults to `webostv.conf`.
 - **customize** array (*Optional*): List of options to customize.
-  - ***sources** array (*Optional*): List of hardware inputs.
+  - ***sources** array (*Optional*): List of hardware and webOS App inputs.
 
-If you do not specify `host:`, all LG webOS Smart TVs within your network will be auto-discovered if they use the default name setting of `[LG] webOS TV`.
+If you do not specify `host:`, all LG webOS Smart TVs within your network will be auto-discovered.
-Home Assistant is able to turn on a LG webOS Smart TV if you specify an action, like HDMI-CEC or WakeOnLan.
 
 A full configuration example will look like the sample below:
 
@@ -59,3 +67,32 @@ media_player:
         - makotv
         - netflix
 ```
+** avoid using `[ ]` in the `name:` of your device.
+
+
+*Turn On Action*
+
+Home Assistant is able to turn on a LG webOS Smart TV if you specify an action, like HDMI-CEC or WakeOnLan.
+
+Common for webOS 3.0 and higher would be to use WakeOnLan feature. 
+To use this feature your TV should be connected to your network via Ethernet rather than Wireless and you should enable *LG Connect Apps* feature in *Network* settings of the TV [instructions](http://www.lg.com/uk/support/product-help/CT00008334-1437131798537-others) (or *Mobile App* in *General* settings for older models) (*may vary by version).
+
+```yaml
+# Example configuration.yaml entry
+wake_on_lan: # enables `wake_on_lan` domain
+
+media_player:
+  - platform: webostv
+    host: 192.168.0.10
+    #other settings
+    turn_on_action:
+      service: wake_on_lan.send_magic_packet
+      data:
+        mac: B4:E6:2A:1E:11:0F
+```
+Any other [actions](/docs/automation/action/) to power on the device can be configured. 
+
+
+*Sources*
+
+To obtain complete list of available sources currently configured on the TV, once the webOS TV is configured and linked, while its powered on head to the **Developer Tools** > **States**, find your `media_player.<name>` and use the sources listed in `source_list:` remembering to split them per line into your `sources:` configuration.

source/_components/mysensors.markdown

@@ -47,21 +47,75 @@ mysensors:
   version: '2.0'
 ```
 
-Configuration variables:
+{% configuration %}
-
+  gateways:
-- **device** (*Required*): The path to the serial gateway where it is connected to your Home Assistant host, or the address of the TCP Ethernet gateway, or `mqtt` to setup the MQTT gateway. Resolving DNS addresses is theoretically supported but not tested.
+    description: A list of gateways to set up.
-- **baud_rate** (*Optional*): Specifies the baud rate of the connected serial gateway. Default is 115200.
+    required: true
-- **tcp_port** (*Optional*): Specifies the port of the connected TCP Ethernet gateway. Default is 5003.
+    type: map
-- **topic_in_prefix** (*Optional*): Set the prefix of the MQTT topic for messages coming from the MySensors gateway in to Home Assistant. Default is an empty string.
+    keys:
-- **topic_out_prefix** (*Optional*): Set the prefix of the MQTT topic for messages going from Home Assistant out to the MySensors gateway. Default is an empty string.
+      device:
-- **debug** (*DEPRECATED*): This option has been deprecated. Please remove this from your config is you have it included. Use the logger component to filter log messages on log level.
+        description: The path to the serial gateway where it is connected to your Home Assistant host, or the address of the TCP Ethernet gateway, or `mqtt` to setup the MQTT gateway. Resolving DNS addresses is theoretically supported but not tested.
-- **persistence** (*Optional*): Enable or disable local persistence of sensor information. If this is disabled, then each sensor will need to send presentation messages after Home Assistant starts. Default is true.
+        required: true
-- **persistence_file** (*Optional*): The path to a file to save sensor information. The file extension determines the file type. Currently supported file types are 'pickle' and 'json'.
+        type: string
-- **version** (*Optional*): Specifies the MySensors protocol version to use. Supports 1.4, 1.5 and 2.0. Default is 1.4.
+      baud_rate:
-- **optimistic** (*Optional*): Enable or disable optimistic mode for actuators (switch/light). Default is false. Set this to true if no state feedback from actuators is possible. Home Assistant will assume that the command succeeded and change state.
+        description: Specifies the baud rate of the connected serial gateway.
-- **retain** (*Optional*): Enable or disable retain flag for published messages from Home Assistant when using the MQTT gateway. Default is true.
+        required: false
-- **nodes** (*Optional*): Nodes that need a custom name.
+        type: int
-  - **name** (*Optional*): The name the node will be renamed to. This nodename becomes part of the entity_id. Default the entity_id is [sketch_name]\_[node_id]\_[child_id] and when this name is set, the entity_id becomes [name]\_[child_id].
+        default: 115200
+      tcp_port:
+        description: Specifies the port of the connected TCP Ethernet gateway.
+        required: false
+        type: int
+        default: 5003
+      topic_in_prefix:
+        description: Set the prefix of the MQTT topic for messages coming from the MySensors gateway in to Home Assistant.
+        required: false
+        type: string
+        default: ''
+      topic_out_prefix:
+        description: Set the prefix of the MQTT topic for messages going from Home Assistant out to the MySensors gateway.
+        required: false
+        type: string
+        default: ''
+      nodes:
+        description: A mapping of node ids to node settings, eg custom name.
+        required: false
+        type: map
+        keys:
+          name:
+            description: The name the node will be renamed to. This nodename becomes part of the entity_id. Default entity_id is [sketch_name]\_[node_id]\_[child_id] and when this name is set, the entity_id becomes [name]\_[child_id].
+            required: true
+            type: string
+  debug:
+    description: This option has been deprecated. Please remove this from your config if you have it included. Use the [logger component](/components/logger/) to filter log messages on log level.
+    required: false
+    type: int
+  persistence:
+    description: Enable or disable local persistence of sensor information. If this is disabled, then each sensor will need to send presentation messages after Home Assistant starts.
+    required: false
+    type: int
+    default: true
+  persistence_file:
+    description: The path to a file to save sensor information. The file extension determines the file type. Currently supported file types are 'pickle' and 'json'.
+    required: false
+    type: string
+    default: path/to/config/directory/mysensors.pickle
+  version:
+    description: Specifies the MySensors protocol version to use. Supports 1.4, 1.5 and 2.0.
+    required: false
+    type: string
+    default: '1.4'
+  optimistic:
+    description: Enable or disable optimistic mode for actuators (switch/light). Set this to true if no state feedback from actuators is possible. Home Assistant will assume that the command succeeded and change state.
+    required: false
+    type: int
+    default: false
+  retain:
+    description: Enable or disable retain flag for published messages from Home Assistant when using the MQTT gateway.
+    required: false
+    type: int
+    default: true
+{% endconfiguration %}
 
 <p class='note'>
 Not all features of MySensors 2.0 are yet supported by Home Assistant. As more features are added, they will be described here in the documentation. Go to the MySensors platform pages under "related components" to see what message types are currently supported.

source/_components/notify.clickatell.markdown

@@ -1,6 +1,6 @@
 ---
 layout: page
-title: "Clikatell SMS"
+title: "Clickatell SMS"
 description: "Instructions on how to add Clickatell notifications to Home Assistant."
 date: 2017-10-09 00:00
 sidebar: true
@@ -18,17 +18,17 @@ The `clickatell` platform uses [Clickatell](https://clickatell.com) to deliver S
 ### Get your Clickatell API Credentials
 Go to your [Clickatell SMS Platform Portal](https://portal.clickatell.com/#/) section and create a new SMS integration. There are three screens of information required to creater an integration. Please ensure the following:
 
-1. Give the new Integration an identification name
+1. Give the new Integration an identification name.
-2. ensure it is set for 'production' use
+2. Ensure it is set for 'production' use.
-3. select 'HTTP' as your API type
+3. Select 'HTTP' as your API type.
-4. Ensure that the you select for the messaging type to be 'one way messaging'
+4. Ensure that the you select for the messaging type to be 'one way messaging'.
-5. Be aware of the international number format option as this impacts the structure of the phone numbers you provide  
+5. Be aware of the international number format option as this impacts the structure of the phone numbers you provide.
-6. Once you have completed entering your details an API key is generated. Copy the API key
+6. Once you have completed entering your details an API key is generated. Copy the API key.
 
-### Configuration
 To add Clickatell to your installation, add the following to your Home Assistant `configuration.yaml` file:
 
 ```yaml
+# Example configuration.yaml entry
 notify:
   - platform: clickatell
     name: USER_DEFINED_NAME
@@ -38,9 +38,9 @@ notify:
 
 Configuration variables:
 
-* **name** (Optional): Setting the optional parameter name allows multiple notifiers to be created. The default value is `Clickatell`. The notifier will bind to the service notify.NOTIFIER_NAME.
+* **name** (Optional): Setting the optional parameter name allows multiple notifiers to be created. The default value is `clickatell`. The notifier will bind to the service notify.NOTIFIER_NAME.
-* **api_key** (Required): Your `API Key`.
+* **api_key** (Required): Your API key.
-* **recipient** (Required): Your phone no. This is where you want to send your notification SMS messages. eg: `61444333444`
+* **recipient** (Required): Your phone number. This is where you want to send your notification SMS messages. e.g. `61444333444`.
 
 
 To use notifications, please see the [getting started with automation page](https://home-assistant.io/getting-started/automation/).

source/_components/notify.html5.markdown

@@ -129,7 +129,7 @@ By default, every notification sent has a randomly generated UUID (v4) set as it
 }
 ```
 
-Example of adding a tag to your configuration. This won't create new notification if there already exists one with the same tag.
+Example of adding a tag to your notification. This won't create new notification if there already exists one with the same tag.
 
 ```yaml
   - alias: Push/update notification of sensor state with tag

source/_components/remote.apple_tv.markdown

@@ -1,6 +1,6 @@
 ---
 layout: page
-title: "Apple TV"
+title: "Apple TV Remote"
 description: "Instructions how to integrate Apple TV remote into Home Assistant."
 date: 2017-06-26 20:50
 sidebar: true
@@ -38,7 +38,6 @@ data:
     - menu
     - select
   device: ''
-
 ```
 
 Please note that `device` must be specified (because of validation) but is not used by this platform. So you may specify any value.

source/_components/sensor.knx.markdown

@@ -26,26 +26,13 @@ sensor:
     name: Heating.Valve1
     address: '2/0/0'
     type: 'percent'
-
   - platform: knx
     name: Kitchen.Temperature
     address: '6/2/1'
     type: 'temperature'
-
-  - platform: knx
-    name: Wind speed
-    type: speed_ms
-    address: 1/0/0
-
-  - platform: knx
-    name: Lux
-    type: illuminance
-    address: 1/0/1
 ```
 
-* **name** (*Optional*): A name for this device used within Home Assistant.
+- **name** (*Optional*): A name for this device used within Home Assistant.
-* **address**: KNX group address of the sensor
+- **address**: KNX group address of the sensor.
-* **type**: (Optional) "percent", "temperature", "illuminance", "speed_ms", "current"
+- **type** (Optional): "percent", "temperature", "illuminance", "speed_ms", "current".
-
-
 

source/_components/sensor.sytadin.markdown

@@ -27,8 +27,15 @@ Configuration variables:
 
 - **name** (*Optional*): Additional name for the sensors. Default to platform name.
 - **monitored_conditions** array (*Optional*): Conditions to display in the frontend. Defaults to `traffic_jam`.
+<<<<<<< HEAD
   - **traffic_jam**: Amount of kilometers in traffic jam (km).  
   - **mean_velocity**: Mean velocity (km/h).
   - **congestion**: Index of congestion (n/a).
+=======
+  - **traffic_jam**: A human-readable text summary.
+  - **mean_velocity**: The current temperature.
+  - **congestion**: The wind speed.
+
+>>>>>>> current
 
 The data is coming from the [Direction des routes Île-de-France (DiRIF)](http://www.sytadin.fr).

source/_components/sensor.uptime.markdown

@@ -28,3 +28,11 @@ Configuration variables:
 
 - **name** (*Optional*): Name of the sensor. Defaults to `Uptime`.
 - **unit_of_measurement** (*Optional*): Units for uptime measurement in either `days`, `hours`, or `minutes`.  Defaults to `days`.
+
+```yaml
+# Example with configuration variables
+sensor:
+  - platform: uptime
+    name: Time Online
+    unit_of_measurement: hours
+````

source/_components/shell_command.markdown

@@ -12,6 +12,7 @@ logo: home-assistant.png
 ---
 
 This component can expose regular shell commands as services. Services can be called from a [script] or in [automation].
+Shell commands aren't allowed for a camel-case naming, please use lowercase naming only and separate the names with underscores.
 
 [script]: /components/script/
 [automation]: /getting-started/automation/

source/_components/vacuum.xiaomi_miio.markdown

@@ -159,29 +159,12 @@ $ source /srv/homeassistant/bin/activate
 To fetch the token follow these instructions depending on your mobile phone platform.
 
 1. Configure the robot with the Mi-Home app.
-2. Enable developer mode and USB debugging on the Android phone and plug it into the computer.
+2. Download and extract the [MiToolKit.zip](https://github.com/ultrara1n/MiToolkit/releases).
-3. Get and install the [ADB tool for Windows](https://developer.android.com/studio/releases/platform-tools.html).
+3. Enable developer mode and USB debugging on the Android phone and plug it into the computer.
-4. Create a backup of the application `com.xiaomi.smarthome`:
+4. Change the MiToolKit language to English if you need to.
-```bash
+5. Click "Extract Token"
-$ adb backup -noapk com.xiaomi.smarthome -f backup.ab
+6. On the phone, you must confirm the backup. DO NOT enter any password and press the button to make the backup.
-```
+8. Once you have confirmed the backup the token extraction will begin, it should appear in the MiToolKit shortly.
-5. If you have this message: "More than one device or emulator", use this command to list all devices:
-```bash
-$ adb devices
-```
-and execute this command:
-```bash
-$ adb -s DEVICEID backup -noapk com.xiaomi.smarthome -f backup.ab # (with DEVICEID the device id from the previous command)
-```
-6. On the phone, you must confirm the backup. DO NOT enter any password and press button to make the backup.
-7. Get and install [ADB Backup Extractor](https://sourceforge.net/projects/adbextractor/).
-8. Extract All files from the backup:
-```bash
-$ java.exe -jar ../android-backup-extractor/abe.jar unpack backup.ab backup.tar ""
-```
-9. Unzip the ".tar" file.
-10. Open the SQLite database `miio2.db` with a tool like SQLite Manager extension for FireFox.
-11. Get the token from "devicerecord" table.
 
 #### {% linkable_title Linux and Android (rooted!) %}
 
@@ -214,7 +197,7 @@ To fetch the token follow these instructions depending on your mobile phone plat
 
 1. Configure the robot with the Mi-Home app.
 2. Using iTunes, create an unencrypted backup of your iPhone.
-3. Install [iBackup Viewer](Get ADB f.e. `apt-get install android-tools-adb`), open it, and open your backup.
+3. Install [iBackup Viewer](http://www.imactools.com/iphonebackupviewer/), open it, and open your backup.
 4. Open the "Raw Data" module.
 5. Navigate to `com.xiaomi.mihome`.
 6. Search for a file that looks like this: `123456789_mihome.sqlite` – note that `_mihome.sqlite` is *not* the correct file.

source/_components/wink.markdown

@@ -20,18 +20,21 @@ ha_release: pre 0.7
   Wink offers one, quick and simple way to connect people with the products they rely on every day in their home.
 </blockquote>
 
-Home Assistant integrates with the Wink API and automatically sets up any switches, lights, locks, fans, climate devices, covers, sensors, and alarms.
+Home Assistant integrates with the Wink API and automatically sets up any switches, lights, locks, fans, climate devices (thermostats, air conditioners, and water heaters), covers, sensors, alarms, and sirens.
 
 Check the related components pages for actual devices that are supported.
 
-Home Assistant offers multiple ways to authenticate to the Wink API. Each authentication method is described below.
-
 ### Authenticate using [developer.wink.com](https://developer.wink.com)
 
+You need to setup a developer account with Wink. This process can take a few days to get approved.
 
-This method will require you to setup a developer account with Wink. This process can take a few days to get approved but is the recommended form of authentication. If you would like to use Wink in Home Assistant while you wait, you can use the email and password authentication below.
+Wink requests three pieces of information from the user when they sign up for a developer account.
 
-This form of authentication doesn't require any settings in the configuration.yaml other than `wink:` this is because you will be guided through setup via the configurator on the frontend.
+1. `Name:` This can be anything, for example "Home Assistant"
+2. `Website:` The external address of your Home Assistant instance. If not externally accessible you can use your email address.
+3. `Redirect URI:` This should be "http://192.168.1.5:8123/auth/wink/callback" replacing the IP with the internal IP of your Home Assistant box.
+
+No settings are required in the configuration.yaml other than `wink:` this is because you will be guided through setup via the configurator on the frontend.
 
 <p class='note'>
 When using the configurator make sure the initial setup is performed on the same local network as the Home Assistant server, if not from the same box Home Assistant is running on. This will allow for authentication redirects to happen correctly.
@@ -41,11 +44,10 @@ When using the configurator make sure the initial setup is performed on the same
 wink:
 ```
 
-
+~~### Authentication with your Wink email and password.~~
-### Authentication with your Wink email and password.
 
 
-This method pulls a new token on every startup of Home Assistant from this [URL](https://winkbearertoken.appspot.com)
+~~This method pulls a new token on every startup of Home Assistant from this [URL](https://winkbearertoken.appspot.com)~~
 
 ```yaml
 wink:
@@ -53,9 +55,11 @@ wink:
   password: YOUR_WINK_PASSWORD
 ```
 
+This is no longer working due to a recent change Wink made, and will be removed in the next release of Home Assistant. Please create a [developer.wink.com](https://developer.wink.com) account so you can keep using Wink!
+
 ### Full oauth authentication (legacy).
 
-This should be used for users that obtained their client_id and client_secret via email from Wink support.
+This should be used for users that obtained their client_id and client_secret via email from Wink support prior to [developer.wink.com's](https://developer.wink.com) existance.
 
 
 ```yaml
@@ -68,11 +72,11 @@ wink:
 
 Configuration variables:
 
-- **email** (*Required for email/password auth or legacy OAuth*): Your Wink login email.
+- **email** (*Required for legacy OAuth*): Your Wink login email.
-- **password** (*Required for email/password auth or legacy OAuth*): Your Wink login password.
+- **password** (*Required for legacy OAuth*): Your Wink login password.
 - **client_id** (*Required for legacy OAuth*): Your provided Wink client_id.
 - **client_secret** (*Required for legacy OAuth*): Your provided Wink client_secret.
-- **local_control** (*Optional*): If set to `True` state changes for lights, locks, and switches will be an issue to the local hub.
+- **local_control** (*Optional*): If set to `True` state changes for lights, locks, and switches will be issued to the local hub.
 
 Local control:
 - Wink's local control API isn't officially documented and therefore could be broken by a hub update. For these reasons `local_control` defaults to `False`.

source/_cookbook/dim_lights_when_playing_media.markdown

@@ -12,7 +12,7 @@ ha_category: Automation Examples
 
 Like it how the lights dim up/down at the movies? Do it at home as well!
 
-This example uses the [media player](https://home-assistant.io/components/media_player/), [Philips Hue](https://home-assistant.io/components/light.hue/) (transitions) and the [sun](https://home-assistant.io/components/sun/) component. We'll use actions to detect media player state changes and scenes to control multiple lights, color settings and transition between scenes.
+This example uses the [media player](https://home-assistant.io/components/media_player/), [lights](https://home-assistant.io/components/light/) (transitions) and the [sun](https://home-assistant.io/components/sun/) component. We'll use actions to detect media player state changes and [scenes](https://home-assistant.io/components/scene/) to control multiple lights and transition between scenes.
 
 #### {% linkable_title Scenes %}
 One scene for normal light, one for when movies are on. A 2 second transition gives a nice 'feel' to the switch.
@@ -24,25 +24,21 @@ scene:
         light.light1:
             state: on
             transition: 2
-            brightness: 150
+            brightness_pct: 60
-            xy_color: [ 0.4448, 0.4066 ]
         light.light2:
             state: on
             transition: 2
-            brightness: 215
+            brightness_pct: 85
-            xy_color: [ 0.4448, 0.4066 ]
   - name: Livingroom dim
     entities:
         light.light1:
             state: on
             transition: 2
-            brightness: 75
+            brightness_pct: 30
-            xy_color: [ 0.5926, 0.3814 ]
         light.light2:
             state: on
             transition: 2
-            brightness: 145
+            brightness_pct: 55
-            xy_color: [ 0.5529, 0.4107 ]
 ```
 
 

source/_cookbook/track_battery_level.markdown

@@ -12,21 +12,36 @@ ha_category: Automation Examples
 
 ### {% linkable_title iOS Devices %}
 
-If you have a device running iOS (iPhone, iPad, etc), The [iCloud](/components/device_tracker.icloud/) is gathering various details about your device including the battery level. To display it in the Frontend use a [template sensor](/components/sensor.template/).
+If you have a device running iOS (iPhone, iPad, etc), The [iCloud](/components/device_tracker.icloud/) is gathering various details about your device including the battery level. To display it in the Frontend use a [template sensor](/components/sensor.template/). You can also use the icon template option to create a dynamic icon that changes with the battery level.
 
+{% raw %}
 ```yaml
 sensor:
   - platform: template
     sensors:
       battery_iphone:
+        friendly_name: iPhone Battery
+        # "entity_id:" ensures that this sensor will only update when your device tracker does.
+        entity_id: device_tracker.iphone
         unit_of_measurement: '%'
         value_template: >-
-            {% raw %}{%- if states.device_tracker.iphone.attributes.battery %}
+            {%- if states.device_tracker.iphone.attributes.battery %}
                 {{ states.device_tracker.iphone.attributes.battery|round }}
             {% else %}
                 {{ states.sensor.battery_iphone.state }}
-            {%- endif %}{% endraw %}
+            {%- endif %}
+        icon_template: >
+            {% set battery_level = states.sensor.battery_iphone.state|default(0)|int %}
+            {% set battery_round = (battery_level / 10) |int * 10 %}
+            {% if battery_round >= 100 %}
+              mdi:battery
+            {% elif battery_round > 0 %}
+              mdi:battery-{{ battery_round }}
+            {% else %}
+              mdi:battery-alert
+            {% endif %}
 ```
+{% endraw %}
 
 The `else` part is used to have the sensor keep it's last state if the newest [iCloud](/components/device_tracker.icloud/) update doesn't have any battery state in it (which happens sometimes). Otherwise the sensor will be blank.
 
@@ -34,12 +49,13 @@ The `else` part is used to have the sensor keep it's last state if the newest [i
 
 While running the [Owntracks](/components/device_tracker.owntracks/) device tracker you can retrieve the battery level with a MQTT sensor. Replace username with your MQTT username (for the embedded MQTT it's simply homeassistant), and deviceid with the set Device ID in Owntracks.
 
+{% raw %}
 ```yaml
 sensor:
   - platform: mqtt
     state_topic: "owntracks/username/deviceid"
     name: "Battery Tablet"
     unit_of_measurement: "%"
-    value_template: {% raw %}'{{ value_json.batt }}'{% endraw %}
+    value_template: '{{ value_json.batt }}'
 ```
-
+{% endraw %}

source/_data/glossary.yml

@@ -14,8 +14,8 @@
   description: "An [entity](/docs/configuration/platform_options/) is the representation of a single device, unit or web service."
 - topic: Device
   description: "A device is usually a physical unit which can do or observe something."
-- topic: hass
+- topic: Hassbian
-  description: "HASS or [hass](/docs/tools/hass/) is often used as an abbreviation for Home Assistant as well the command line tool."
+  description: "[Hassbian](/docs/installation/hassbian/) is a customized operating system specifically tailored for Raspberry Pi users. It is one of the easiest way of installing and running Home Assistant on a Raspberry Pi."
 - topic: Discovery
   description: "[Discovery](/components/discovery/) is the automatic setup of zeroconf/mDNS and uPnP devices after they are discovered."
 - topic: Group

source/_docs/automation/editor.markdown

@@ -39,7 +39,7 @@ As "Service Data" we want a simple text that is shown as part of the notificatio
 }
 ```
 
-Don't forget to save your new automation rule.
+Don't forget to save your new automation rule. In order for your saved automation rule to come into effect you will need to go to the **Configuration** page and click on **Reload Automation**.
 
 ## {% linkable_title Updating your configuration to use the editor %}
 

source/_docs/autostart/systemd.markdown

@@ -10,7 +10,7 @@ footer: true
 redirect_from: /getting-started/autostart-systemd/
 ---
 
-Newer linux distributions are trending towards using `systemd` for managing daemons. Typically, systems based on Fedora, ArchLinux, or Debian (8 or later) use `systemd`. This includes Ubuntu releases including and after 15.04, CentOS, and Red Hat. If you are unsure if your system is using `systemd`, you may check with the following command:
+Newer Linux distributions are trending towards using `systemd` for managing daemons. Typically, systems based on Fedora, ArchLinux, or Debian (8 or later) use `systemd`. This includes Ubuntu releases including and after 15.04, CentOS, and Red Hat. If you are unsure if your system is using `systemd`, you may check with the following command:
 
 ```bash
 $ ps -p 1 -o comm=
@@ -21,7 +21,7 @@ If the preceding command returns the string `systemd`, continue with the instruc
 A service file is needed to control Home Assistant with `systemd`. The template below should be created using a text editor. Note, root permissions via `sudo` will likely be needed. The following should be noted to modify the template:
 
 - `ExecStart` contains the path to `hass` and this may vary. Check with `whereis hass` for the location.
-- For most systems, the file is `/etc/systemd/system/home-assistant@[your user].service` with [your user] replaced by the user account that Home Assistant will run as - normally `homeassistant`.  In particular, this is the case for Ubuntu 16.04. 
+- For most systems, the file is `/etc/systemd/system/home-assistant@[your user].service` with [your user] replaced by the user account that Home Assistant will run as (normally `homeassistant`).  In particular, this is the case for Ubuntu 16.04. 
 - If unfamiliar with command-line text editors, `sudo nano -w [filename]` can be used with `[filename]` replaced with the full path to the file.  Ex. `sudo nano -w /etc/systemd/system/home-assistant@[your user].service`.  After text entered, press CTRL-X then press Y to save and exit.
 - If you're running Home Assistant in a Python virtual environment or a Docker container, please skip to the appropriate template listed below.
 
@@ -127,3 +127,10 @@ Because the log can scroll quite quickly, you can select to view only the error
 ```bash
 $ sudo journalctl -f -u home-assistant@[your user] | grep -i 'error'
 ```
+
+When working on Home Assitant, you can easily restart the system and then watch the log output by combining the above commands using `&&`
+
+```bash
+$ sudo systemctl restart home-assistant@[your user] && sudo journalctl -f -u home-assistant@[your user]
+```
+

source/_docs/configuration/customizing-devices.markdown

@@ -13,7 +13,7 @@ redirect_from: /getting-started/customizing-devices/
 By default, all of your devices will be visible and have a default icon determined by their domain. You can customize the look and feel of your front page by altering some of these parameters. This can be done by overriding attributes of specific entities.
 
 <p class='note'>
-Be careful not to forget to place `customize`, `customize_domain`, and `customize_glob` inside `homeassistant:` or it will fail.
+If you implement `customize`, `customize_domain`, or `customize_glob` you must make sure it is done inside of `homeassistant:` or it will fail.
 </p>
 
 ```yaml

source/_docs/configuration/state_object.markdown

@@ -23,8 +23,8 @@ Field | Description
 `state.domain` | Domain of the entity. Example: `light`.
 `state.object_id` | Object ID of entity. Example: `kitchen`.
 `state.name` | Name of the entity. Based on `friendly_name` attribute with fall back to object ID. Example: `Kitchen Ceiling`.
-`state.last_updated` | Time the state was written to the state machine. Note that writing the exact same state including attributes will not result in this field being updated. Example: `14:10:03 13-03-2016`.
+`state.last_updated` | Time the state was written to the state machine. Note that writing the exact same state including attributes will not result in this field being updated. Example: `2017-10-28 08:13:36.715874+00:00`.
-`state.last_changed` | Time the state changed. This is not updated when there are only updated attributes. Example: `14:10:03 13-03-2016`.
+`state.last_changed` | Time the state changed. This is not updated when there are only updated attributes. Example: `2017-10-28 08:13:36.715874+00:00`.
 `state.attributes` | A dictionary with extra attributes related to the current state.
 
 The attributes of an entity are optional. There are a few attributes that are used by Home Assistant for representing the entity in a specific way. Each component will also have it's own attributes to represent extra state data about the entity. For example, the light component has attributes for the current brightness and color of the light. When an attribute is not available, Home Assistant will not write it to the state.

source/_docs/ecosystem/appdaemon.markdown

@@ -40,8 +40,8 @@ import appdaemon.appapi as appapi
 class OutsideLights(appapi.AppDaemon):
 
   def initialize(self):
-    self.run_at_sunrise(self.sunrise_cb, 0)
+    self.run_at_sunrise(self.sunrise_cb)
-    self.run_at_sunset(self.sunset_cb, 0)
+    self.run_at_sunset(self.sunset_cb)
     
   def sunrise_cb(self, kwargs):
     self.turn_on(self.args["off_scene"])

source/_docs/ecosystem/ios/notifications/actions.markdown

@@ -44,16 +44,16 @@ When sending a notification:
 </p>
 
 ## {% linkable_title Definitions %}
-- Category - A category represents a type of notification that the app might receive. Think of it as a unique group of actions. A categories parameters include:
+- Category - A category represents a type of notification that the app might receive. Think of it as a unique group of actions.
-- Action - An action consists of a button title and the information that iOS needs to notify the app when the action is selected. You create separate action objects for distinct action your app supports. An actions parameters include:
+- Actions - An action consists of a button title and the information that iOS needs to notify the app when the action is selected. You create separate action objects for distinct action your app supports.
 
 ## {% linkable_title Category parameters %}
 
 - **name** (*Required*): A friendly name for this category.
 - **identifier** (*Required*): A unique identifier for the category. Must be lowercase and have no special characters or spaces.
-- **action** (*Required*): A list of actions.
+- **actions** (*Required*): A list of actions.
 
-## {% linkable_title Action parameters %}
+## {% linkable_title Actions parameters %}
 
 - **identifier** (*Required*): A unique identifier for this action. Must be uppercase and have no special characters or spaces. Only needs to be unique to the category, not unique globally.
 - **title** (*Required*): The text to display on the button. Keep it short.

source/_docs/frontend/browsers.markdown

@@ -10,7 +10,7 @@ footer: true
 redirect_from: /getting-started/browsers/
 ---
 
-Home Assistant requires a web browser to show the frontend and supports all major modern browsers. We don't test the web interface against all available browsers but this page tracks different browsers on various operating systems and should help you to pick a browser which works.
+Home Assistant requires a web browser to show the frontend and supports all major modern browsers. We don't test the web interface against all available browsers but this page tracks different browsers on various operating systems and should help you to pick a browser which works. The "Release" column contains the release number which were tested. This doen't mean that older or newer releases not work.
 
 If a browser is listed as working but you are still having problems, it is possible that some add-on or extension may be the problem. Some add-ons or extenstion are known to cause issue with the frontend, but it's not possible to test them all. If you are having issues with the frontend displaying correctly, you should disable all your add-ons or extensions and enable them one at a time.
 
@@ -37,10 +37,11 @@ We would appreciate if you help to keep this page up-to-date and add feedback.
 
 | Browser               | Release        | State      | Comments                 |
 | :-------------------- |:---------------|:-----------|:-------------------------|
-| [Firefox]             | 55.0           | works      |                          |
+| [Firefox]             | 57.0           | works      |                          |
 | [Midori]              | 0.5.11         | works      |                          |
-| [Chromium]            | 60.0.3112.90   | works      |                          |
+| [Chromium]            | 61.0.3163.100  | works      |                          |
 | [Conkeror]            | 1.0.2          | works      |                          |
+| [Tor Browser]         | 7.0.8          | works      |                          |
 | [Konqueror]           |                | unknown    |                          |
 | [Uzbl]                | 0.9.0          | works      |                          |
 | [Opera]               | 42.0.2393.351  | works      |                          |
@@ -67,20 +68,22 @@ We would appreciate if you help to keep this page up-to-date and add feedback.
 
 There are reports that devices running with iOS prior to iOS 10, especially old iPads, are having trouble.
 
-[Firefox]: https://www.mozilla.org/en-US/firefox/
-[Midori]: http://midori-browser.org/
 [Chrome]: https://www.google.com/chrome/
-[Iridium]: https://iridiumbrowser.de/
-[Opera]: http://www.opera.com/
-[Edge]: https://www.microsoft.com/en-us/windows/microsoft-edge
-[IE]: http://windows.microsoft.com/en-us/internet-explorer/download-ie
-[Safari]: http://www.apple.com/safari/
 [Chromium]: https://www.chromium.org/
 [Conkeror]: http://conkeror.org/
-[Konqueror]: https://konqueror.org/
+[Edge]: https://www.microsoft.com/en-us/windows/microsoft-edge
-[Uzbl]: http://www.uzbl.org/
-[Lynx]: http://lynx.browser.org/
 [elinks]: http://elinks.or.cz/ 
-[w3m]: http://w3m.sourceforge.net/
 [Epiphany]: https://wiki.gnome.org/Apps/Web
+[Firefox]: https://www.mozilla.org/en-US/firefox/
+[IE]: http://windows.microsoft.com/en-us/internet-explorer/download-ie
+[Iridium]: https://iridiumbrowser.de/
+[Konqueror]: https://konqueror.org/
+[Lynx]: http://lynx.browser.org/
+[Midori]: http://midori-browser.org/
+[Opera]: http://www.opera.com/
+[Safari]: http://www.apple.com/safari/
 [surf]: http://surf.suckless.org/
+[Tor Browser]: https://www.torproject.org/
+[Uzbl]: http://www.uzbl.org/
+[w3m]: http://w3m.sourceforge.net/
+

source/_docs/installation/hassbian/installation.markdown

@@ -17,6 +17,10 @@ The easiest way to install Home Assistant on your Raspberry Pi is by using HASSb
  3. Ensure your Raspberry Pi has wired access to the internet for the entire process or configure your wireless network settings **before proceeding to step 4**.
  4. Insert SD card to Raspberry Pi and turn it on. Initial installation of Home Assistant will take about 5 minutes.
 
+<p class='note'>
+Please remember to ensure you're using an [appropriate power supply](https://www.raspberrypi.org/help/faqs/#powerReqs) with your Pi. Mobile chargers may not be suitable, since some are designed to only provide the full power with that manufacturer's handsets.
+</p>
+
 These instructions are also available as a [video](https://www.youtube.com/watch?v=iIz6XqDwHEk).  Additional information is available in this [video](https://www.youtube.com/watch?v=tCGlQSsQ-Mc).
 
 After initial boot an installer will run in the background and takes around 15 minutes to complete, after it has finished, you will be prompted to login: `hassbian login:`. Installation is complete at this point. The default username is `pi` and the password is `raspberry`.

source/_docs/installation/raspberry-pi-all-in-one.markdown

@@ -10,7 +10,11 @@ redirect_from: /getting-started/installation-raspberry-pi-all-in-one/
 
 The [Raspberry Pi All-In-One Installer](https://github.com/home-assistant/fabric-home-assistant) deploys a complete Home Assistant server including support for MQTT with websockets, Z-Wave, and the OpenZWave Control Panel.
 
-The only requirement is that you have a Raspberry Pi with a fresh installation of [Raspbian](https://www.raspberrypi.org/downloads/raspbian/) connected to your network.
+<p class='note'>
+Please remember to ensure you're using an [appropriate power supply](https://www.raspberrypi.org/help/faqs/#powerReqs) with your Pi. Mobile chargers may not be suitable, since some are designed to only provide the full power with that manufacturer's handsets.
+</p>
+
+The only requirement is that you have a Raspberry Pi with a fresh installation of [Raspbian](https://www.raspberrypi.org/downloads/raspbian/) Jessie (Stretch is not supported at this time) connected to your network.
 
 <p class='note'>
 Note that as of 2016-11-30 SSH is disabled by default in the official Raspbian images. Adding an empty file called `ssh` to `/boot/` on the FAT32 partition will enable it. More information is on the Raspberry Pi Foundation [Blog](https://www.raspberrypi.org/blog/page/2/?fish#a-security-update-for-raspbian-pixel).

source/_docs/installation/virtualenv.markdown

@@ -42,7 +42,7 @@ $ sudo usermod -G dialout -a homeassistant
 
 ### {% linkable_title Step 2: Create a directory for Home Assistant %}
 
-This can be anywhere you want. As example we put it in `/srv`. You also need to change the ownership of the directory to the user you created above (if you created one).
+This can be anywhere you want.  We chose to put it in `/srv`. You also need to change the ownership of the directory to the user you created above (if you created one).
 
 ```bash
 $ sudo mkdir /srv/homeassistant

source/_docs/z-wave/adding.markdown

@@ -9,24 +9,31 @@ sharing: true
 footer: true
 ---
 
-To add (include) a Z-Wave [device](/docs/z-wave/devices/) to your system, go to the [Z-Wave control panel](/docs/z-wave/control-panel/) in the Home Assistant frontend and click the **Add Node** button in the *Z-Wave Network Management* card. This will place the controller in inclusion mode, after which you should activate your device to be included by following the instructions provided with the device.
+## {% linkable_title Adding Non-Secure Devices %}
 
-<p class='warning'>
+To add (include) a non-secure Z-Wave [device](/docs/z-wave/devices/) to your system, go to the [Z-Wave control panel](/docs/z-wave/control-panel/) in the Home Assistant frontend and click the **Add Node** button in the *Z-Wave Network Management* card. This will place the controller in inclusion mode, after which you should activate your device to be included by following the instructions provided with the device. Don't use this for secure devices, since this is likely to limit the features the device supports.
+
+<p class='note warning'>
 Don't use the OpenZWave control panel (OZWCP), or the physical button on a controller, to add or remove devices. Many devices will only send the information about their capabilities at the time you include them. If you use the OpenZWave control panel, or the button on a device, then Home Assistant won't have that information. Using the physical button on a controller will also result in a non-security inclusion being performed, which may limit the features the device supports.
 </p>
 
 When you add a device, it may initially appear without a specific entity ID (eg `zwave.__`) and without other identifying information. Running a *Heal* should help speed this process up, and you'll need to run a *Heal* anyway so that all the devices in your Z-Wave network learn about the new device. You *might* need to restart Home Assistant (not reboot the system) to have the entity ID fully visible.
 
-## {% linkable_title Adding Security Devices %}
+## {% linkable_title Adding Secure Devices %}
 
-Security Z-Wave devices require a network key before being added to the network using the Add Secure Node button in the Z-Wave Network Management card. You must set the *network_key* configuration variable to use a network key before adding these devices. Some devices only expose their full capabilities when included this way, you should always read the manual for your device to find out the recommended inclusion method.
+Security Z-Wave devices require a network key before being added to the network using the **Add Secure Node** button in the Z-Wave Network Management card. You must set the *network_key* configuration variable to use a network key before adding these devices. Some devices only expose their full capabilities when included this way, you should always read the manual for your device to find out the recommended inclusion method.
 
 An easy script to generate a random key:
 ```bash
 cat /dev/urandom | tr -dc '0-9A-F' | fold -w 32 | head -n 1 | sed -e 's/\(..\)/0x\1, /g' -e 's/, $//'
 ```
 
-<p class='warning'>
+On macOS, this script will generate a random key:
+```bash
+cat /dev/urandom | LC_CTYPE=C tr -dc '0-9A-F' | fold -w 32 | head -n 1 | sed -e 's/\(..\)/0x\1, /g' -e 's/, $//'
+```
+
+<p class='note warning'>
 Ensure you keep a backup of this key. If you have to rebuild your system and don't have a backup of this key, you won't be able to reconnect to any security devices. This may mean you have to do a factory reset on those devices, and your controller, before rebuilding your Z-Wave network.
 </p>
 

source/_docs/z-wave/controllers.markdown

@@ -26,6 +26,10 @@ You need to have a [supported Z-Wave USB stick or module](https://github.com/Ope
 | Vision USB Stick        |                |                  |              |
 | ZWave.me UZB1           |   ✓     |                  |              |
 
+<p class='note'>
+  If you're using Hass.io, it's recommended to use a USB stick, not a module. Passing a module through Docker is more complicated than passing a USB stick through.
+</p>
+
 ## {% linkable_title Stick Alternatives %}
 
 The alternative to a stick is a hub that supports Z-Wave. Home Assistant supports the following hubs with Z-Wave support:

source/_docs/z-wave/device-specific.markdown

@@ -155,3 +155,4 @@ Double tap off|2|3
 Triple tap on|1|4
 Triple tap off|2|4
 Tap and hold on|1|2
+Tap and hold off|2|2

source/_docs/z-wave/entities.markdown

@@ -25,7 +25,7 @@ This is for a single purpose sensor, multi sensors are explained under Multi Sen
 
 Devices (usually sensors) that support the Alarm command class will create entities starting with `sensor`, and with some generic suffixes, and a suffix that relates to the supported alarm class. For example, the smoke detector `lounge` will have an entity `sensor.lounge_smoke`, and possibly also `sensor.lounge_alarm_type` and `sensor.lounge_alarm_level`. If the device creates a `binary_sensor` entity, it is recommended to use that rather then the `sensor` entity.
 
-### {% linkable_title Alarm Type %}
+### {% linkable_title Alarm Type Entity %}
 
 - **alarm_type**: Reports the type of the sensor
   - **0**: General purpose
@@ -36,7 +36,7 @@ Devices (usually sensors) that support the Alarm command class will create entit
   - **5**: Water leak sensor
   - **6**: Access control
 
-### {% linkable_title Alarm Level %}
+### {% linkable_title Alarm Level Entity %}
 
 The meaning of the `alarm_level` entity depends on the nature of the alarm sensor
 
@@ -111,7 +111,7 @@ The meaning of the `alarm_level` entity depends on the nature of the alarm senso
   - **1**: Wake up
   - **254**: Unknown event
 
-### {% linkable_title Access Control %}
+### {% linkable_title Access Control Entity %}
 
 - **access_control**: These *may* vary between brands
   - **22**: Open
@@ -135,7 +135,7 @@ binary_sensor:
           {%- endif -%}{% endraw %}
 ```
 
-### {% linkable_title Burglar %}
+### {% linkable_title Burglar Entity %}
 
 - **burglar**: These *may* vary between brands
    - **0**: Not active
@@ -163,7 +163,7 @@ binary_sensor:
           {%- endif -%}{% endraw %}
 ```
 
-### {% linkable_title Source Node ID %}
+### {% linkable_title Source Node ID Entity %}
 
 - **sourcenodeid**: Reports the sensor that generated the alarm - this is only valid for Zensor Net based devices
 

source/_docs/z-wave/installation.markdown

@@ -16,6 +16,8 @@ On Linux platforms (other than Hass.io) there is one dependency you will need to
 $ sudo apt-get install libudev-dev
 ```
 
+On Python 3.6 you may also have to install libpython3.6-dev, and possibly python3.6-dev.
+
 When installing on macOS you may have to also run the command below ahead of time, replace "x.x" with the version of Python (`$ python3 --version`) you have installed. 
 
 ```bash
@@ -104,7 +106,7 @@ device_config:
 
 ### {% linkable_title Finding the controller path on Linux %}
 
-<p class='note'
+<p class='note'>
 If you're using Hass.io please follow [these setup instructions](/hassio/zwave/) for finding the controller path.
 </p>
 

source/_includes/asides/docs_navigation.html

@@ -97,8 +97,10 @@
           <li>{% active_link /docs/z-wave/adding/ Adding devices %}</li>
           <li>{% active_link /docs/z-wave/control-panel/ The Z-Wave control panel %}</li>
           <li>{% active_link /docs/z-wave/controllers/ Controllers %}</li>
-          <li>{% active_link /docs/z-wave/devices/ Devices %}</li>
+          <li>{% active_link /docs/z-wave/devices/ Devices %} and {% active_link /docs/z-wave/entities/ Entities %}</li>
-          <li>{% active_link /docs/z-wave/device-specific/ Device Specific %}</li>
+          <li>{% active_link /docs/z-wave/query-stage/ Query Stages %} for devices</li>
+          <li>{% active_link /docs/z-wave/device-specific/ Device Specific %} configuration</li>
+          <li>{% active_link /docs/z-wave/events/ Events %} and {% active_link /docs/z-wave/services/ Services %}</li>
         </ul>
       </li>
       <li>

source/_posts/2017-10-28-demo.markdown

@@ -0,0 +1,106 @@
+---
+layout: post
+title: "Home Assistant Demo"
+description: "Showing a demo of Home Assistant to an audience."
+date: 2017-10-28 10:00:00 +0200
+date_formatted: "October 28, 2017"
+author: Fabian Affolter
+author_twitter: fabaff
+comments: true
+categories: How-To
+og_image: /images/blog/2017-10-interactive-demo/demo-random.png
+---
+
+If you are planning to host a Home Assistant meetup or doing a talk, then you probably want to show Home Assistant to an audience. You could use a Wireless router, bulbs, switches, and a single board computer to do a realistic demo. For a workshop, this is what I usually do because I think that working with physical hardware is more fun for the participants. The issue is that you need time to set up, power and space. For a talk or in a location, where you only have a beamer and a table or a lectern, the physical hardware approach is not very convenient.
+
+The simplest way to show Home Assistant to others is the online demo at [https://home-assistant.io/demo/](https://home-assistant.io/demo/)
+
+<p class='img'>
+  <img src='/images/blog/2017-10-interactive-demo/online-demo.png' />
+  Home Assistant's online demo
+</p>
+
+<!--more-->
+
+## {% linkable_title `--demo-mode` and Demo platform %}
+To be safe for your talk, you don't want to depend on an internet connection. The demo mode [`--demo-mode`](/docs/tools/hass/) allows you to run a demo locally including the latest features. Make sure that you have a backup of your configuration.
+
+```bash
+$ hass --demo-mode
+```
+
+If you already have a `configuration.yaml` file in place then you will get a combination of your setup with all available  [`demo`](/components/demo/) platforms. This can be overwhelming for the audience. The suggestion is that you tailor the demo to your needs by only showing a few selected platforms. For example:
+
+```yaml
+sensor:
+  - platform: demo
+binary_sensor:
+  - platform: demo
+switch:
+  - platform: demo
+```
+
+<p class='img'>
+  <img src='/images/blog/2017-10-interactive-demo/demo-platforms.png' />
+  Home Assistant's demo platforms
+</p>
+
+## {% linkable_title `random` platforms %}
+Till now the frontend is static. Nothing is changing over time. Starting with 0.57 we ship a [`random` binary sensor](https://github.com/home-assistant/home-assistant.github.io/blob/next/source/_components/binary_sensor.random.markdown) platform in addition to the already available [`random` sensor](/components/sensor.random/).
+
+By adding those platform to your `configuration.yaml` file, your demo will become more interactive.
+
+```yaml
+sensor:
+  - platform: demo
+    name: Temperature
+    unit_of_measurement: "°C"
+binary_sensor:
+  - platform: random
+    name: Front Door
+  - platform: random
+    name: Back Door
+    scan_interval: 5
+```
+
+<p class='img'>
+  <img src='/images/blog/2017-10-interactive-demo/demo-random.png' />
+  Demo with `random` platforms
+</p>
+
+The `random` and the `demo` platforms can, of course, be used together. With a little work and some of the [`template`](/components/#search/template) platforms or the [`input_*`](/components/#search/input) components it would even be possible to simulate a complete apartment or a house. For a hint check the sample below:
+
+{% raw %}
+```yaml
+input_boolean:
+  on_off:
+    name: On or off
+binary_sensor:
+  - platform: template
+    sensors:
+      on_tester:
+        value_template: "{{ states.input_boolean.on_off.state == 'on' }}"
+        friendly_name: 'Movement'
+        device_class: motion
+```
+{% endraw %}
+
+## {% linkable_title MQTT Discovery %}
+This is a section for advanced users as it will require to run a separate script. Instead of adding `demo` platforms to the configuration this setup make use of [MQTT discovery](/docs/mqtt/discovery/) and the [embedded MQTT broker](/docs/mqtt/broker/#embedded-broker). Simply add MQTT to your `configuration.yaml` file with `discovery:`
+
+```yaml
+mqtt:
+  discovery: true
+```
+
+Download the [sample script](https://github.com/home-assistant/home-assistant-dev-helper/blob/master/ha-mqtt-demo.py). It depends on [paho-mqtt](https://pypi.python.org/pypi/paho-mqtt). If you run the script inside your [Home Assistant's virtual environment](/docs/installation/virtualenv/) then you are good to go as the dependency should be present if you have used MQTT before. Otherwise, install it with `$ pip3 install paho-mqtt`. The same applies to the embedded broker.
+
+```bash
+(ha)[ha-demo]$ python3 ha-mqtt-demo.py
+Demo is running... -> CTRL + C to shutdown
+```
+
+It will create sensors, a light, and a switch and update the states as long the script is running. It possible to stop and restart script without losing the entities.
+
+Some users share their slides and other documents in [our assets repository](https://github.com/home-assistant/home-assistant-assets). Also, take a look at that repository if you need a logo for your slides.
+

source/_posts/2017-11-02-secure-shell-tunnel.markdown

@@ -0,0 +1,69 @@
+---
+layout: post
+title: "Home Assistant and SSH"
+description: "Accessing Home Assistant through a secure shell tunnel."
+date: 2017-11-02 10:00:00 +0200
+date_formatted: "November 02, 2017"
+author: Fabian Affolter
+author_twitter: fabaff
+comments: true
+categories: How-To
+og_image: /images/blog/2017-11-ssh/social.png
+---
+
+Most system engineers are very familiar with [SSH (Secure shell)](https://en.wikipedia.org/wiki/Secure_Shell). This tool which contains a server part and a client part is used to access a remote system in a secure way. It can also help you if your are running Home Assistant but don't want to expose it to the public. On a Linux system SSH is often available by default. If you are using a Windows installation additional steps are required which are not covered here.
+
+In this blog post we are going to use the tunneling option of SSH to create a secure connection and forward the Home Assistant frontend to a local system. 
+
+<!--more-->
+
+The involved parties are:
+
+- **Remote system**: Where Home Assistant is running, usually in your home network.
+- **Local system**: Where you want to see the frontend.
+
+The prerequirements are that you need to allow the forwarding of port 22 from your router to the system where Home Assistant is running in your network. It might also be needed that you enable the SSH daemon by `$ sudo systemctl start sshd` on the remote system and to adjust the host firewall. If you are running [Hass.io](https://home-assistant.io/hassio/) then enable the [SSH Server add-on](https://home-assistant.io/addons/ssh/). You must also have a public IP address or hostname which can be provided by dynamic DNS (e.g., [NO-IP](https://www.noip.com/) or [DuckDNS](https://www.duckdns.org/)).
+On your local system you need only a SSH client and you need to be in a network where SSH is allowed.
+
+First let's have a look at the command we are going to use. Use `man ssh` to get more information.
+
+```bash
+$ ssh -L 8000:localhost:8123 user@[IP_ADDRESS_REMOTE]
+      |  |    |         |    |    |
+      |  |    |         |    |    |_ IP address or hostname of your router.
+      |  |    |         |    |_ Username on the remote system.
+      |  |    |         |_ Port where the application is running.
+      |  |    |_ We want the frontend on this system.
+      |  |_ The port on our local system to use (above 1024).
+      |_ We want to do local port forwarding.
+```
+
+A possible example could look like the command below. 
+
+```bash
+$ ssh -L 8000:localhost:8123 ha@192.168.0.11
+```
+
+The first time you establish the connection you need to accept the fingerprint.
+
+```bash
+The authenticity of host '192.168.0.11 (192.168.0.11)' can't be established.
+ECDSA key fingerprint is SHA256:asdf2faasd4gk45454fadr78wfadfasdfeg4vvvsae33.
+ECDSA key fingerprint is MD5:44:d4:f7:44:d4:aa:b8:de:ef:09:3e:0d:4e:12:11:09.
+Are you sure you want to continue connecting (yes/no)? 
+Warning: Permanently added '192.168.0.162' (ECDSA) to the list of known hosts.
+ha@192.168.0.11's password: 
+Last login: Fri Oct 27 17:50:09 2017
+[ha@home-assistant ~]$ 
+```
+
+Now you are able to use your frontend on your local system: [http://localhost:8000](http://localhost:8000)
+
+Things to keep in mind:
+
+- You need a public IP address or hostname (Dynamic DNS will work) if you want to use it from the internet.
+- You need to setup port forwarding on your router.
+- Don't allow `root` to use SSH. Set `PermitRootLogin no` on the remote system.
+- Your local port must be above 1024. Only `root` is allowed to forward privileged ports which are below 1024.
+- Use [SSH keys for authentication](https://docs-old.fedoraproject.org/en-US/Fedora/14/html/Deployment_Guide/s2-ssh-configuration-keypairs.html) instead of passwords to avoid bruteforce attacks.
+

source/developers/credits.markdown

@@ -2,7 +2,7 @@
 layout: page
 title: "Credits"
 description: "Credits for the developers who contributed to Home Assistant."
-date: 2017-10-21 20:19:43 +0000
+date: 2017-10-31 19:14:47 +0000
 sidebar: true
 comments: false
 sharing: true
@@ -13,24 +13,25 @@ This page contains a list of people who have contributed in one way or another t
 
 ### {% linkable_title Author %}
 
-- [Paulus Schoutsen (@balloob)](https://github.com/balloob "5857 total commits to the home-assistant organization, 3502 commits to home-assistant, 1270 commits to home-assistant.github.io, 607 commits to home-assistant-polymer, 244 commits to home-assistant-js, 116 commits to netdisco, 44 commits to home-assistant-js-websocket, 24 commits to hass-release, 12 commits to home-assistant-assets, 8 commits to example-custom-config, 7 commits to micropython-home-assistant, 5 commits to LabelBot, 4 commits to hassio, 3 commits to hassio-addons, 2 commits to python-hassbian, 2 commits to issue-bot, 2 commits to lambda-home-assistant-github, 2 commits to hassio-addons-example, 1 commit to hassio-build, 1 commit to home-assistant-notebooks, 1 commit to home-assistant-iOS")
+- [Paulus Schoutsen (@balloob)](https://github.com/balloob "5895 total commits to the home-assistant organization, 3516 commits to home-assistant, 1279 commits to home-assistant.github.io, 619 commits to home-assistant-polymer, 244 commits to home-assistant-js, 117 commits to netdisco, 44 commits to home-assistant-js-websocket, 24 commits to hass-release, 14 commits to home-assistant-assets, 8 commits to example-custom-config, 7 commits to micropython-home-assistant, 5 commits to LabelBot, 4 commits to hassio, 3 commits to hassio-addons, 2 commits to issue-bot, 2 commits to hassio-addons-example, 2 commits to python-hassbian, 2 commits to lambda-home-assistant-github, 1 commit to hassio-build, 1 commit to home-assistant-notebooks, 1 commit to home-assistant-iOS")
 
 ### {% linkable_title Contributors %}
 
 (in alphabetical order)
 
-- [Aaron Bach (@bachya)](https://github.com/bachya "25 total commits to the home-assistant organization, 17 commits to home-assistant, 8 commits to home-assistant.github.io")
+- [7even (@hwikene)](https://github.com/hwikene "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
+- [Aaron Bach (@bachya)](https://github.com/bachya "28 total commits to the home-assistant organization, 18 commits to home-assistant, 10 commits to home-assistant.github.io")
 - [Aaron Linville (@linville)](https://github.com/linville "2 total commits to the home-assistant organization, 2 commits to appdaemon")
 - [Aaron Morris (@Morrisai)](https://github.com/Morrisai "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Aaron Polley (@xarnze)](https://github.com/xarnze "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Abhishek Anand (@aa755)](https://github.com/aa755 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [Abílio Costa (@abmantis)](https://github.com/abmantis "17 total commits to the home-assistant organization, 10 commits to home-assistant, 4 commits to home-assistant.github.io, 1 commit to home-assistant-js-websocket, 1 commit to netdisco, 1 commit to home-assistant-polymer")
+- [Abílio Costa (@abmantis)](https://github.com/abmantis "18 total commits to the home-assistant organization, 11 commits to home-assistant, 4 commits to home-assistant.github.io, 1 commit to home-assistant-js-websocket, 1 commit to home-assistant-polymer, 1 commit to netdisco")
-- [Adam (@SilvrrGIT)](https://github.com/SilvrrGIT "8 total commits to the home-assistant organization, 8 commits to home-assistant.github.io")
+- [Adam (@SilvrrGIT)](https://github.com/SilvrrGIT "9 total commits to the home-assistant organization, 8 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Adam Baxter (@voltagex)](https://github.com/voltagex "2 total commits to the home-assistant organization, 1 commit to home-assistant-polymer, 1 commit to home-assistant")
-- [Adam Cooper (@GenericStudent)](https://github.com/GenericStudent "3 total commits to the home-assistant organization, 3 commits to home-assistant")
+- [Adam Cooper (@GenericStudent)](https://github.com/GenericStudent "6 total commits to the home-assistant organization, 6 commits to home-assistant")
 - [Adam Dullage (@Dullage)](https://github.com/Dullage "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Adam Garcia (@pancho-villa)](https://github.com/pancho-villa "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [Adam Mills (@armills)](https://github.com/armills "216 total commits to the home-assistant organization, 136 commits to home-assistant, 39 commits to home-assistant.github.io, 37 commits to home-assistant-polymer, 3 commits to home-assistant-js, 1 commit to homebridge-homeassistant")
+- [Adam Mills (@armills)](https://github.com/armills "228 total commits to the home-assistant organization, 141 commits to home-assistant, 42 commits to home-assistant.github.io, 41 commits to home-assistant-polymer, 3 commits to home-assistant-js, 1 commit to homebridge-homeassistant")
 - [Adam Stone (@astone123)](https://github.com/astone123 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Adrian Popa (@mad-ady)](https://github.com/mad-ady "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [Adrien Ball (@adrienball)](https://github.com/adrienball "2 total commits to the home-assistant organization, 2 commits to home-assistant")
@@ -39,14 +40,16 @@ This page contains a list of people who have contributed in one way or another t
 - [aetolus (@aetolus)](https://github.com/aetolus "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [AHS (@ahofelt)](https://github.com/ahofelt "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [Alan Bowman (@alanbowman)](https://github.com/alanbowman "4 total commits to the home-assistant organization, 4 commits to home-assistant")
-- [Alan Fischer (@alanfischer)](https://github.com/alanfischer "17 total commits to the home-assistant organization, 14 commits to home-assistant, 3 commits to home-assistant.github.io")
+- [Alan Fischer (@alanfischer)](https://github.com/alanfischer "18 total commits to the home-assistant organization, 15 commits to home-assistant, 3 commits to home-assistant.github.io")
 - [Alasdair Nicol (@alasdairnicol)](https://github.com/alasdairnicol "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Albatross (@DyingAlbatross)](https://github.com/DyingAlbatross "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Albert Lee (@trisk)](https://github.com/trisk "13 total commits to the home-assistant organization, 8 commits to home-assistant, 5 commits to home-assistant.github.io")
 - [Alberto Arias Maestro (@albertoarias)](https://github.com/albertoarias "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Alessandro Mogavero (@alexmogavero)](https://github.com/alexmogavero "3 total commits to the home-assistant organization, 3 commits to home-assistant")
-- [Alex (@asbach)](https://github.com/asbach "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Alex (@alexrockt)](https://github.com/alexrockt "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Alex (@MungoRae)](https://github.com/MungoRae "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Alex (@asbach)](https://github.com/asbach "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
+- [Alex Barcelo (@alexbarcelo)](https://github.com/alexbarcelo "2 total commits to the home-assistant organization, 2 commits to hassio-addons")
 - [Alex Harvey (@infamy)](https://github.com/infamy "25 total commits to the home-assistant organization, 14 commits to home-assistant, 11 commits to home-assistant.github.io")
 - [Alex Mekkering (@AlexMekkering)](https://github.com/AlexMekkering "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Alex MF (@adsmf)](https://github.com/adsmf "1 total commits to the home-assistant organization, 1 commit to hassio-addons")
@@ -54,13 +57,15 @@ This page contains a list of people who have contributed in one way or another t
 - [Alexander Kratzer (@hexxter)](https://github.com/hexxter "8 total commits to the home-assistant organization, 8 commits to home-assistant")
 - [Alexander Rust (@binarybucks)](https://github.com/binarybucks "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Alexandre Perrin (@kAworu)](https://github.com/kAworu "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
+- [Alexis Iglauer (@ax42)](https://github.com/ax42 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Alfie Day (@Azelphur)](https://github.com/Azelphur "12 total commits to the home-assistant organization, 12 commits to home-assistant")
 - [Aliaksandr (@minchik)](https://github.com/minchik "7 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to appdaemon, 2 commits to home-assistant")
 - [Allan Glen (@allanglen)](https://github.com/allanglen "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [Alok Saboo (@arsaboo)](https://github.com/arsaboo "97 total commits to the home-assistant organization, 58 commits to home-assistant.github.io, 37 commits to home-assistant, 1 commit to hassio-addons, 1 commit to pi-gen")
+- [Alok Saboo (@arsaboo)](https://github.com/arsaboo "102 total commits to the home-assistant organization, 59 commits to home-assistant.github.io, 41 commits to home-assistant, 1 commit to hassio-addons, 1 commit to pi-gen")
 - [amigian74 (@amigian74)](https://github.com/amigian74 "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [amorsillo (@AndrewMorsillo)](https://github.com/AndrewMorsillo "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
-- [Anders Melchiorsen (@amelchio)](https://github.com/amelchio "102 total commits to the home-assistant organization, 74 commits to home-assistant, 26 commits to home-assistant.github.io, 2 commits to home-assistant-polymer")
+- [Anders Fogh Eriksen (@Fogh)](https://github.com/Fogh "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Anders Melchiorsen (@amelchio)](https://github.com/amelchio "107 total commits to the home-assistant organization, 78 commits to home-assistant, 27 commits to home-assistant.github.io, 2 commits to home-assistant-polymer")
 - [Andrea Falcone (@asfalcone)](https://github.com/asfalcone "5 total commits to the home-assistant organization, 5 commits to issue-bot")
 - [Andreas Cambitsis (@acambitsis)](https://github.com/acambitsis "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Andreas Jacobsen (@andreasjacobsen93)](https://github.com/andreasjacobsen93 "9 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 2 commits to hassio-addons, 1 commit to home-assistant")
@@ -70,14 +75,14 @@ This page contains a list of people who have contributed in one way or another t
 - [Andrej Friesen (@ajfriesen)](https://github.com/ajfriesen "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Andrew (@aoakeson)](https://github.com/aoakeson "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Andrew (@aneisch)](https://github.com/aneisch "5 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 1 commit to home-assistant")
-- [Andrew Cockburn (@acockburn)](https://github.com/acockburn "606 total commits to the home-assistant organization, 475 commits to appdaemon, 88 commits to hadashboard, 25 commits to scenegen, 18 commits to home-assistant.github.io")
+- [Andrew Cockburn (@acockburn)](https://github.com/acockburn "625 total commits to the home-assistant organization, 494 commits to appdaemon, 88 commits to hadashboard, 25 commits to scenegen, 18 commits to home-assistant.github.io")
 - [Andrew LeCody (@aceat64)](https://github.com/aceat64 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Andrew Smith (@andrewmichaelsmith)](https://github.com/andrewmichaelsmith "2 total commits to the home-assistant organization, 2 commits to pi-gen")
 - [Andrew Stock (@watchforstock)](https://github.com/watchforstock "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Andrew Thigpen (@andythigpen)](https://github.com/andythigpen "33 total commits to the home-assistant organization, 32 commits to home-assistant, 1 commit to home-assistant-js")
 - [Andrew Williams (@nikdoof)](https://github.com/nikdoof "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [andrew-curtis (@andrew-curtis)](https://github.com/andrew-curtis "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io")
-- [Andrey (@andrey-git)](https://github.com/andrey-git "182 total commits to the home-assistant organization, 89 commits to home-assistant, 63 commits to home-assistant-polymer, 30 commits to home-assistant.github.io")
+- [Andrey (@andrey-git)](https://github.com/andrey-git "195 total commits to the home-assistant organization, 91 commits to home-assistant, 73 commits to home-assistant-polymer, 31 commits to home-assistant.github.io")
 - [Andrey Kupreychik (@foxel)](https://github.com/foxel "4 total commits to the home-assistant organization, 4 commits to home-assistant")
 - [Andrzej (@andriej)](https://github.com/andriej "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Andréas Lundgren (@adevade)](https://github.com/adevade "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
@@ -92,27 +97,28 @@ This page contains a list of people who have contributed in one way or another t
 - [Antonio Párraga Navarro (@aparraga)](https://github.com/aparraga "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Antony Messerli (@antonym)](https://github.com/antonym "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Anubhaw Arya (@aarya123)](https://github.com/aarya123 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [apo-mak (@apo-mak)](https://github.com/apo-mak "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [Ardetus (@Ardetus)](https://github.com/Ardetus "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Ardi Mehist (@omgapuppy)](https://github.com/omgapuppy "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [arjenfvellinga (@arjenfvellinga)](https://github.com/arjenfvellinga "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Arno (@aetjansen)](https://github.com/aetjansen "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
-- [ArrayLabs (@arraylabs)](https://github.com/arraylabs "7 total commits to the home-assistant organization, 5 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [ArrayLabs (@arraylabs)](https://github.com/arraylabs "5 total commits to the home-assistant organization, 5 commits to home-assistant")
 - [arretx (@arretx)](https://github.com/arretx "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Arthur Leonard Andersen (@leoc)](https://github.com/leoc "9 total commits to the home-assistant organization, 9 commits to home-assistant")
 - [Arttu mahlakaarto (@amahlaka)](https://github.com/amahlaka "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io")
-- [ashev (@ashev)](https://github.com/ashev "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Ashton Campbell (@AshtonCampbell)](https://github.com/AshtonCampbell "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
 - [Assaf Inbal (@shmuelzon)](https://github.com/shmuelzon "12 total commits to the home-assistant organization, 9 commits to homebridge-homeassistant, 3 commits to home-assistant")
-- [Audric Schiltknecht (@chemicalstorm)](https://github.com/chemicalstorm "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Audric Schiltknecht (@chemicalstorm)](https://github.com/chemicalstorm "4 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Audun Ytterdal (@auduny)](https://github.com/auduny "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [aufano (@aufano)](https://github.com/aufano "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Austin (@trainman419)](https://github.com/trainman419 "8 total commits to the home-assistant organization, 8 commits to home-assistant")
 - [Avraham David Gelbfish (@adgelbfish)](https://github.com/adgelbfish "2 total commits to the home-assistant organization, 1 commit to hadashboard, 1 commit to pi-gen")
 - [azeroth12 (@azeroth12)](https://github.com/azeroth12 "1 total commits to the home-assistant organization, 1 commit to appdaemon")
-- [Bahnburner (@Bahnburner)](https://github.com/Bahnburner "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Baran Kaynak (@barankaynak)](https://github.com/barankaynak "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [Barry Williams (@bazwilliams)](https://github.com/bazwilliams "10 total commits to the home-assistant organization, 6 commits to home-assistant, 2 commits to netdisco, 2 commits to home-assistant.github.io")
 - [Bart274 (@Bart274)](https://github.com/Bart274 "26 total commits to the home-assistant organization, 17 commits to home-assistant, 8 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
 - [Bas Schipper (@basschipper)](https://github.com/basschipper "5 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [bastshoes (@bastshoes)](https://github.com/bastshoes "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [Beat (@bdurrer)](https://github.com/bdurrer "12 total commits to the home-assistant organization, 10 commits to home-assistant.github.io, 1 commit to home-assistant-polymer, 1 commit to home-assistant")
 - [Ben (@unixben)](https://github.com/unixben "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Ben Bangert (@bbangert)](https://github.com/bbangert "4 total commits to the home-assistant organization, 4 commits to home-assistant")
@@ -124,14 +130,14 @@ This page contains a list of people who have contributed in one way or another t
 - [Benjamin Affolter (@bliemli)](https://github.com/bliemli "31 total commits to the home-assistant organization, 31 commits to home-assistant-ansible")
 - [Benjamin Parzella (@bparzella)](https://github.com/bparzella "1 total commits to the home-assistant organization, 1 commit to pi-gen")
 - [Benoit BESSET (@bbesset)](https://github.com/bbesset "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [bestlibre (@bestlibre)](https://github.com/bestlibre "15 total commits to the home-assistant organization, 8 commits to home-assistant, 5 commits to home-assistant.github.io, 1 commit to hassio-build, 1 commit to hassio")
+- [bestlibre (@bestlibre)](https://github.com/bestlibre "16 total commits to the home-assistant organization, 8 commits to home-assistant, 5 commits to home-assistant.github.io, 1 commit to hassio, 1 commit to hassio-build, 1 commit to home-assistant-polymer")
 - [BigMoby (@bigmoby)](https://github.com/bigmoby "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Bill Nelson (@xhostplus)](https://github.com/xhostplus "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [BioSehnsucht (@BioSehnsucht)](https://github.com/BioSehnsucht "12 total commits to the home-assistant organization, 7 commits to home-assistant.github.io, 3 commits to home-assistant, 2 commits to home-assistant-polymer")
 - [Bjarni Ivarsson (@bjarniivarsson)](https://github.com/bjarniivarsson "8 total commits to the home-assistant organization, 5 commits to home-assistant, 3 commits to home-assistant-polymer")
 - [Blanyal D'Souza (@blanyal)](https://github.com/blanyal "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Blender3D (@Blender3D)](https://github.com/Blender3D "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [Boced66 (@boced66)](https://github.com/boced66 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Boced66 (@boced66)](https://github.com/boced66 "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [boojew (@boojew)](https://github.com/boojew "8 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 2 commits to home-assistant")
 - [Boris K (@bokub)](https://github.com/bokub "11 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 5 commits to home-assistant")
 - [Boyi C (@fanthos)](https://github.com/fanthos "9 total commits to the home-assistant organization, 4 commits to home-assistant-polymer, 3 commits to home-assistant, 2 commits to home-assistant.github.io")
@@ -144,8 +150,10 @@ This page contains a list of people who have contributed in one way or another t
 - [brburns (@brburns)](https://github.com/brburns "2 total commits to the home-assistant organization, 2 commits to netdisco")
 - [Brendon Baumgartner (@bbrendon)](https://github.com/bbrendon "10 total commits to the home-assistant organization, 10 commits to home-assistant.github.io")
 - [Brent Hughes (@bah2830)](https://github.com/bah2830 "26 total commits to the home-assistant organization, 17 commits to home-assistant, 8 commits to home-assistant.github.io, 1 commit to netdisco")
+- [Brent Kerlin (@bkerlin)](https://github.com/bkerlin "1 total commits to the home-assistant organization, 1 commit to hassio-build")
 - [Brent Saltzman (@brent20)](https://github.com/brent20 "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
 - [Brenton Zillins (@bzillins)](https://github.com/bzillins "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Brian Cribbs (@cribbstechnologies)](https://github.com/cribbstechnologies "44 total commits to the home-assistant organization, 27 commits to home-assistant, 15 commits to home-assistant.github.io, 2 commits to home-assistant-polymer")
 - [Brian Fitzgerald (@Brianfit)](https://github.com/Brianfit "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Brian Gehrich (@bgehrich)](https://github.com/bgehrich "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Brian Hopkins (@btotharye)](https://github.com/btotharye "6 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 2 commits to home-assistant")
@@ -161,16 +169,17 @@ This page contains a list of people who have contributed in one way or another t
 - [Caius Cioran (@caiuspb)](https://github.com/caiuspb "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Caleb (@finish06)](https://github.com/finish06 "7 total commits to the home-assistant organization, 7 commits to home-assistant")
 - [Cameron Bulock (@cbulock)](https://github.com/cbulock "4 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to netdisco, 1 commit to home-assistant")
-- [Carlo Costanzo (@CCOSTAN)](https://github.com/CCOSTAN "88 total commits to the home-assistant organization, 80 commits to home-assistant.github.io, 5 commits to home-assistant, 1 commit to fabric-home-assistant, 1 commit to hassbian-scripts, 1 commit to homebridge-homeassistant")
+- [Carlo Costanzo (@CCOSTAN)](https://github.com/CCOSTAN "89 total commits to the home-assistant organization, 81 commits to home-assistant.github.io, 5 commits to home-assistant, 1 commit to fabric-home-assistant, 1 commit to homebridge-homeassistant, 1 commit to hassbian-scripts")
 - [carlosmgr (@carlosmgr)](https://github.com/carlosmgr "6 total commits to the home-assistant organization, 6 commits to home-assistant")
 - [Carter (@BluGeni)](https://github.com/BluGeni "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
-- [cdce8p (@cdce8p)](https://github.com/cdce8p "8 total commits to the home-assistant organization, 7 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
+- [Casper Weiss Bang (@C0DK)](https://github.com/C0DK "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [cdce8p (@cdce8p)](https://github.com/cdce8p "12 total commits to the home-assistant organization, 8 commits to home-assistant.github.io, 2 commits to home-assistant-polymer, 2 commits to home-assistant")
 - [Cecron (@Cecron)](https://github.com/Cecron "1 total commits to the home-assistant organization, 1 commit to appdaemon")
 - [Cenk Gündoğan (@cgundogan)](https://github.com/cgundogan "1 total commits to the home-assistant organization, 1 commit to libcoap")
-- [cgtobi (@cgtobi)](https://github.com/cgtobi "10 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 5 commits to home-assistant")
+- [cgtobi (@cgtobi)](https://github.com/cgtobi "11 total commits to the home-assistant organization, 6 commits to home-assistant, 5 commits to home-assistant.github.io")
 - [chanders (@chanders)](https://github.com/chanders "2 total commits to the home-assistant organization, 2 commits to hadashboard")
 - [Charles Blonde (@CharlesBlonde)](https://github.com/CharlesBlonde "19 total commits to the home-assistant organization, 12 commits to home-assistant, 7 commits to home-assistant.github.io")
-- [Charles Garwood (@cgarwood)](https://github.com/cgarwood "14 total commits to the home-assistant organization, 10 commits to home-assistant.github.io, 4 commits to home-assistant")
+- [Charles Garwood (@cgarwood)](https://github.com/cgarwood "15 total commits to the home-assistant organization, 11 commits to home-assistant.github.io, 4 commits to home-assistant")
 - [Charles Spirakis (@srcLurker)](https://github.com/srcLurker "8 total commits to the home-assistant organization, 5 commits to home-assistant, 3 commits to home-assistant.github.io")
 - [Chayoung You (@yous)](https://github.com/yous "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Check your git settings! (@invalid-email-address)](https://github.com/invalid-email-address "1 total commits to the home-assistant organization, 1 commit to libcoap")
@@ -181,10 +190,12 @@ This page contains a list of people who have contributed in one way or another t
 - [Chris Aloi (@ctaloi)](https://github.com/ctaloi "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Chris Baumgartner (@mchrisb03)](https://github.com/mchrisb03 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Chris Huegle (@chuegle)](https://github.com/chuegle "1 total commits to the home-assistant organization, 1 commit to netdisco")
+- [Chris Kacerguis (@chriskacerguis)](https://github.com/chriskacerguis "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Chris Monteiro (@cmonteiro128)](https://github.com/cmonteiro128 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Chris Mulder (@chrisvis)](https://github.com/chrisvis "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Chris Smolen (@smolz)](https://github.com/smolz "10 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 4 commits to appdaemon")
 - [Chris Thorn (@chris-thorn)](https://github.com/chris-thorn "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io")
+- [ChrisS85 (@ChrisS85)](https://github.com/ChrisS85 "1 total commits to the home-assistant organization, 1 commit to hassio-build")
 - [Christiaan Blom (@Deinara)](https://github.com/Deinara "7 total commits to the home-assistant organization, 7 commits to home-assistant")
 - [Christian Brædstrup (@LinuxChristian)](https://github.com/LinuxChristian "8 total commits to the home-assistant organization, 8 commits to home-assistant")
 - [Christian Lasarczyk (@ChrisLasar)](https://github.com/ChrisLasar "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
@@ -204,84 +215,79 @@ This page contains a list of people who have contributed in one way or another t
 - [Constantine Grantcharov (@conz27)](https://github.com/conz27 "1 total commits to the home-assistant organization, 1 commit to libcoap")
 - [Constantine Poltyrev (@shprota)](https://github.com/shprota "1 total commits to the home-assistant organization, 1 commit to appdaemon")
 - [Corban Mailloux (@corbanmailloux)](https://github.com/corbanmailloux "19 total commits to the home-assistant organization, 18 commits to home-assistant.github.io, 1 commit to home-assistant")
-- [Corey Pauley (@devspacenine)](https://github.com/devspacenine "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [corneyl (@corneyl)](https://github.com/corneyl "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Craig J. Ward (@wardcraigj)](https://github.com/wardcraigj "14 total commits to the home-assistant organization, 9 commits to home-assistant, 5 commits to home-assistant.github.io")
-- [cribbstechnologies (@cribbstechnologies)](https://github.com/cribbstechnologies "43 total commits to the home-assistant organization, 27 commits to home-assistant, 14 commits to home-assistant.github.io, 2 commits to home-assistant-polymer")
 - [CTLS (@CTLS)](https://github.com/CTLS "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [cxlwill (@cxlwill)](https://github.com/cxlwill "2 total commits to the home-assistant organization, 2 commits to home-assistant-polymer")
 - [Dale Higgs (@dale3h)](https://github.com/dale3h "33 total commits to the home-assistant organization, 21 commits to home-assistant.github.io, 10 commits to home-assistant, 1 commit to hassbot, 1 commit to homebridge-homeassistant")
 - [Dan (@danieljkemp)](https://github.com/danieljkemp "23 total commits to the home-assistant organization, 16 commits to home-assistant, 7 commits to home-assistant.github.io")
-- [Dan Chen (@djchen)](https://github.com/djchen "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Dan Cinnamon (@Cinntax)](https://github.com/Cinntax "14 total commits to the home-assistant organization, 12 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Dan Faulknor (@danielfaulknor)](https://github.com/danielfaulknor "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [Dan Ford (@dpford)](https://github.com/dpford "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Dan Ports (@drkp)](https://github.com/drkp "4 total commits to the home-assistant organization, 4 commits to home-assistant")
 - [Dan Sarginson (@dansarginson)](https://github.com/dansarginson "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Dan Smith (@kk7ds)](https://github.com/kk7ds "84 total commits to the home-assistant organization, 68 commits to home-assistant, 14 commits to home-assistant.github.io, 2 commits to home-assistant-polymer")
-- [Dan Sullivan (@dansullivan86)](https://github.com/dansullivan86 "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
+- [Dan Sullivan (@dansullivan86)](https://github.com/dansullivan86 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Dani (@danichispa)](https://github.com/danichispa "9 total commits to the home-assistant organization, 9 commits to home-assistant.github.io")
 - [Daniel Escoz (@Darkhogg)](https://github.com/Darkhogg "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
-- [Daniel Høyer Iversen (@Danielhiversen)](https://github.com/Danielhiversen "352 total commits to the home-assistant organization, 237 commits to home-assistant, 113 commits to home-assistant.github.io, 2 commits to home-assistant-polymer")
+- [Daniel Høyer Iversen (@Danielhiversen)](https://github.com/Danielhiversen "362 total commits to the home-assistant organization, 241 commits to home-assistant, 119 commits to home-assistant.github.io, 2 commits to home-assistant-polymer")
-- [Daniel Matuschek (@usul27)](https://github.com/usul27 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Daniel Perna (@danielperna84)](https://github.com/danielperna84 "65 total commits to the home-assistant organization, 34 commits to home-assistant.github.io, 29 commits to home-assistant, 2 commits to hassio-addons")
-- [Daniel Perna (@danielperna84)](https://github.com/danielperna84 "64 total commits to the home-assistant organization, 34 commits to home-assistant.github.io, 28 commits to home-assistant, 2 commits to hassio-addons")
 - [Daniel Peukert (@dpeukert)](https://github.com/dpeukert "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
 - [Daniel Schaal (@schaal)](https://github.com/schaal "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Daniel Stone (@daniel-stoneuk)](https://github.com/daniel-stoneuk "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Daniel Trnka (@trnila)](https://github.com/trnila "2 total commits to the home-assistant organization, 2 commits to appdaemon")
 - [Daniel Watkins (@OddBloke)](https://github.com/OddBloke "4 total commits to the home-assistant organization, 4 commits to home-assistant-ansible")
-- [Daniel Welch (@danielwelch)](https://github.com/danielwelch "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Daniel Welch (@danielwelch)](https://github.com/danielwelch "2 total commits to the home-assistant organization, 2 commits to homebridge-homeassistant")
-- [Danijel Stojnic (@danijelst)](https://github.com/danijelst "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [DanielXYZ2000 (@DanielXYZ2000)](https://github.com/DanielXYZ2000 "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to hassio-addons")
-- [Daniyar Yeralin (@yeralin)](https://github.com/yeralin "2 total commits to the home-assistant organization, 1 commit to homebridge-homeassistant, 1 commit to home-assistant")
+- [Daniyar Yeralin (@yeralin)](https://github.com/yeralin "1 total commits to the home-assistant organization, 1 commit to homebridge-homeassistant")
 - [dasos (@dasos)](https://github.com/dasos "10 total commits to the home-assistant organization, 6 commits to home-assistant, 3 commits to home-assistant.github.io, 1 commit to netdisco")
 - [datafx (@datafx)](https://github.com/datafx "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Dave (@d4v3d)](https://github.com/d4v3d "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [Dave Banks (@djbanks)](https://github.com/djbanks "3 total commits to the home-assistant organization, 2 commits to appdaemon, 1 commit to home-assistant")
+- [Dave Banks (@djbanks)](https://github.com/djbanks "2 total commits to the home-assistant organization, 2 commits to appdaemon")
 - [Dave J (@kxtcd950)](https://github.com/kxtcd950 "3 total commits to the home-assistant organization, 3 commits to hassbian-scripts")
 - [DaveSergeant (@dethpickle)](https://github.com/dethpickle "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [David (@fanaticDavid)](https://github.com/fanaticDavid "12 total commits to the home-assistant organization, 10 commits to home-assistant.github.io, 2 commits to home-assistant")
-- [David Baumann (@daBONDi)](https://github.com/daBONDi "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [David Byrne (@David-Byrne)](https://github.com/David-Byrne "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [David De Sloovere (@DavidDeSloovere)](https://github.com/DavidDeSloovere "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
+- [David Grant (@davegravy)](https://github.com/davegravy "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [David Jackson (@David-Jackson)](https://github.com/David-Jackson "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [David McNett (@nugget)](https://github.com/nugget "10 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 5 commits to home-assistant")
+- [David McNett (@nugget)](https://github.com/nugget "10 total commits to the home-assistant organization, 5 commits to home-assistant, 5 commits to home-assistant.github.io")
 - [David Ohayon (@ohayon)](https://github.com/ohayon "3 total commits to the home-assistant organization, 3 commits to issue-bot")
 - [David Straub (@DavidMStraub)](https://github.com/DavidMStraub "9 total commits to the home-assistant organization, 5 commits to home-assistant, 4 commits to home-assistant.github.io")
 - [David Wang (@dcwangmit01)](https://github.com/dcwangmit01 "2 total commits to the home-assistant organization, 2 commits to pi-gen")
 - [David-Leon Pohl (@DavidLP)](https://github.com/DavidLP "15 total commits to the home-assistant organization, 13 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [davidedmundson (@davidedmundson)](https://github.com/davidedmundson "7 total commits to the home-assistant organization, 4 commits to home-assistant, 3 commits to home-assistant.github.io")
-- [Dawid Wróbel (@wrobelda)](https://github.com/wrobelda "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
+- [Dawid Wróbel (@wrobelda)](https://github.com/wrobelda "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
 - [Dean Camera (@abcminiuser)](https://github.com/abcminiuser "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
-- [Dean Galvin (@FreekingDean)](https://github.com/FreekingDean "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [deisi (@deisi)](https://github.com/deisi "10 total commits to the home-assistant organization, 10 commits to home-assistant")
 - [Denix (@denics)](https://github.com/denics "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Dennis de Greef (@dennisdegreef)](https://github.com/dennisdegreef "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Dennis Karpienski (@TheRealLink)](https://github.com/TheRealLink "24 total commits to the home-assistant organization, 15 commits to home-assistant-polymer, 6 commits to home-assistant, 2 commits to home-assistant.github.io, 1 commit to netdisco")
 - [Dennis Sutch (@sutch)](https://github.com/sutch "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [Derek (@itchaboy)](https://github.com/itchaboy "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Derek (@itchaboy)](https://github.com/itchaboy "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [dersger (@dersger)](https://github.com/dersger "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to home-assistant-polymer")
 - [devdelay (@devdelay)](https://github.com/devdelay "16 total commits to the home-assistant organization, 7 commits to home-assistant.github.io, 5 commits to home-assistant, 4 commits to homebridge-homeassistant")
 - [Diogo Gomes (@dgomes)](https://github.com/dgomes "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
-- [Diogo Soares (@diogos88)](https://github.com/diogos88 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Domantas (@Dohxis)](https://github.com/Dohxis "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [Dougal Matthews (@d0ugal)](https://github.com/d0ugal "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [dramamoose (@dramamoose)](https://github.com/dramamoose "5 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to home-assistant")
-- [DrewSK (@dzsquared)](https://github.com/dzsquared "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io")
+- [DrewSK (@dzsquared)](https://github.com/dzsquared "8 total commits to the home-assistant organization, 8 commits to home-assistant.github.io")
-- [DubhAd (@DubhAd)](https://github.com/DubhAd "15 total commits to the home-assistant organization, 15 commits to home-assistant.github.io")
+- [DubhAd (@DubhAd)](https://github.com/DubhAd "47 total commits to the home-assistant organization, 47 commits to home-assistant.github.io")
 - [Duoxilian (@Duoxilian)](https://github.com/Duoxilian "11 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 5 commits to home-assistant")
 - [Edwin Smulders (@Dutchy-)](https://github.com/Dutchy- "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
-- [Egor Tsinko (@etsinko)](https://github.com/etsinko "5 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Egor Tsinko (@etsinko)](https://github.com/etsinko "7 total commits to the home-assistant organization, 5 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Eleftherios Chamakiotis (@lexam79)](https://github.com/lexam79 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Ellis Percival (@flyte)](https://github.com/flyte "31 total commits to the home-assistant organization, 25 commits to home-assistant, 6 commits to home-assistant.github.io")
 - [Emil Horpen Hetty (@emilhetty)](https://github.com/emilhetty "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [emlt (@emlt)](https://github.com/emlt "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [engrbm87 (@engrbm87)](https://github.com/engrbm87 "3 total commits to the home-assistant organization, 3 commits to appdaemon")
-- [Eric Hagan (@ehagan)](https://github.com/ehagan "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
+- [Eric Hagan (@ehagan)](https://github.com/ehagan "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to home-assistant-polymer")
-- [Eric Oosting (@eoosting)](https://github.com/eoosting "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Eric Oosting (@eoosting)](https://github.com/eoosting "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Eric Rolf (@xrolfex)](https://github.com/xrolfex "13 total commits to the home-assistant organization, 13 commits to home-assistant")
 - [Eric Thompson (@er0ck)](https://github.com/er0ck "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Erik Eriksson (@molobrakos)](https://github.com/molobrakos "98 total commits to the home-assistant organization, 90 commits to home-assistant, 5 commits to home-assistant.github.io, 3 commits to netdisco")
-- [Erik-jan Riemers (@riemers)](https://github.com/riemers "11 total commits to the home-assistant organization, 11 commits to home-assistant.github.io")
+- [Erik-jan Riemers (@riemers)](https://github.com/riemers "13 total commits to the home-assistant organization, 13 commits to home-assistant.github.io")
 - [ettisan (@ettisan)](https://github.com/ettisan "8 total commits to the home-assistant organization, 8 commits to home-assistant")
 - [Eugenio Panadero (@azogue)](https://github.com/azogue "73 total commits to the home-assistant organization, 44 commits to home-assistant, 23 commits to home-assistant.github.io, 3 commits to homebridge-homeassistant, 3 commits to home-assistant-polymer")
-- [Fabian Affolter (@fabaff)](https://github.com/fabaff "4227 total commits to the home-assistant organization, 2647 commits to home-assistant.github.io, 1382 commits to home-assistant, 61 commits to home-assistant-ansible, 29 commits to home-assistant-notebooks, 24 commits to home-assistant-assets, 24 commits to home-assistant-cli, 23 commits to home-assistant-dev-helper, 11 commits to hassio-build, 10 commits to home-assistant-polymer, 8 commits to netdisco, 5 commits to hassio-addons, 2 commits to hassio, 1 commit to home-assistant-js-websocket")
+- [Fabian Affolter (@fabaff)](https://github.com/fabaff "4325 total commits to the home-assistant organization, 2710 commits to home-assistant.github.io, 1411 commits to home-assistant, 61 commits to home-assistant-ansible, 29 commits to home-assistant-dev-helper, 29 commits to home-assistant-notebooks, 24 commits to home-assistant-assets, 24 commits to home-assistant-cli, 11 commits to hassio-build, 10 commits to home-assistant-polymer, 8 commits to netdisco, 5 commits to hassio-addons, 2 commits to hassio, 1 commit to home-assistant-js-websocket")
 - [Fabian Heredia Montiel (@fabianhjr)](https://github.com/fabianhjr "4 total commits to the home-assistant organization, 4 commits to home-assistant")
 - [fakezeta (@fakezeta)](https://github.com/fakezeta "7 total commits to the home-assistant organization, 7 commits to home-assistant")
 - [Fares Rihani (@anchepiece)](https://github.com/anchepiece "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
@@ -290,7 +296,7 @@ This page contains a list of people who have contributed in one way or another t
 - [Ferry van Zeelst (@StaticCube)](https://github.com/StaticCube "6 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 2 commits to home-assistant")
 - [Finbarr Brady (@fbradyirl)](https://github.com/fbradyirl "8 total commits to the home-assistant organization, 8 commits to home-assistant")
 - [Florian Holzapfel (@florianholzapfel)](https://github.com/florianholzapfel "11 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 4 commits to home-assistant, 3 commits to netdisco")
-- [Florian Klien (@flowolf)](https://github.com/flowolf "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io")
+- [Florian Klien (@flowolf)](https://github.com/flowolf "11 total commits to the home-assistant organization, 8 commits to home-assistant.github.io, 3 commits to home-assistant")
 - [florincosta (@florincosta)](https://github.com/florincosta "6 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 3 commits to home-assistant")
 - [Fonta (@f0nt4)](https://github.com/f0nt4 "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [Franck Nijhof (@frenck)](https://github.com/frenck "13 total commits to the home-assistant organization, 12 commits to home-assistant.github.io, 1 commit to hassio")
@@ -298,17 +304,19 @@ This page contains a list of people who have contributed in one way or another t
 - [Frantz (@rofrantz)](https://github.com/rofrantz "2 total commits to the home-assistant organization, 2 commits to netdisco")
 - [François Martin (@martinfrancois)](https://github.com/martinfrancois "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Frederic Hemberger (@fhemberger)](https://github.com/fhemberger "93 total commits to the home-assistant organization, 93 commits to home-assistant.github.io")
-- [Fredrik Lindqvist (@Landrash)](https://github.com/Landrash "172 total commits to the home-assistant organization, 71 commits to hassbian-scripts, 69 commits to home-assistant.github.io, 27 commits to pi-gen, 4 commits to home-assistant, 1 commit to home-assistant-polymer")
+- [Fredrik Fjeld (@fredrikfjeld)](https://github.com/fredrikfjeld "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Fredrik Lindqvist (@Landrash)](https://github.com/Landrash "175 total commits to the home-assistant organization, 74 commits to hassbian-scripts, 69 commits to home-assistant.github.io, 27 commits to pi-gen, 4 commits to home-assistant, 1 commit to home-assistant-polymer")
 - [freol35241 (@freol35241)](https://github.com/freol35241 "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [froz (@froz)](https://github.com/froz "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [fuga2136 (@fuga2136)](https://github.com/fuga2136 "13 total commits to the home-assistant organization, 13 commits to home-assistant.github.io")
+- [Gabor Gulyas (@gaborgulyas)](https://github.com/gaborgulyas "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [Gabor SZOLLOSI (@szogi)](https://github.com/szogi "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to appdaemon")
 - [GadgetReactor (@GadgetReactor)](https://github.com/GadgetReactor "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Gavin Mogan (@halkeye)](https://github.com/halkeye "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Geoff Norton (@kangaroo)](https://github.com/kangaroo "14 total commits to the home-assistant organization, 14 commits to home-assistant")
 - [George.M (@nodinosaur)](https://github.com/nodinosaur "8 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 2 commits to home-assistant")
-- [Georgi Kirichkov (@kirichkov)](https://github.com/kirichkov "12 total commits to the home-assistant organization, 8 commits to home-assistant.github.io, 4 commits to home-assistant")
+- [Georgi Kirichkov (@kirichkov)](https://github.com/kirichkov "16 total commits to the home-assistant organization, 10 commits to home-assistant.github.io, 5 commits to home-assistant, 1 commit to appdaemon")
-- [Georgi Yanev (@jumpalottahigh)](https://github.com/jumpalottahigh "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Georgi Yanev (@jumpalottahigh)](https://github.com/jumpalottahigh "4 total commits to the home-assistant organization, 2 commits to home-assistant-polymer, 2 commits to home-assistant.github.io")
 - [Georgii Staroselskii (@staroselskii)](https://github.com/staroselskii "1 total commits to the home-assistant organization, 1 commit to pi-gen")
 - [Gergely Imreh (@imrehg)](https://github.com/imrehg "16 total commits to the home-assistant organization, 11 commits to home-assistant, 5 commits to home-assistant.github.io")
 - [Gianluca Barbaro (@MrMep)](https://github.com/MrMep "24 total commits to the home-assistant organization, 16 commits to home-assistant, 8 commits to home-assistant.github.io")
@@ -320,11 +328,12 @@ This page contains a list of people who have contributed in one way or another t
 - [Gopal Kildoliya (@gopalkildoliya)](https://github.com/gopalkildoliya "6 total commits to the home-assistant organization, 4 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Graeme Smith (@Instagraeme)](https://github.com/Instagraeme "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [GreenTurtwig (@GreenTurtwig)](https://github.com/GreenTurtwig "80 total commits to the home-assistant organization, 73 commits to home-assistant.github.io, 7 commits to home-assistant")
-- [Greg (@theCMack)](https://github.com/theCMack "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Greg Dowling (@pavoni)](https://github.com/pavoni "250 total commits to the home-assistant organization, 223 commits to home-assistant, 25 commits to home-assistant.github.io, 2 commits to netdisco")
-- [Greg Dowling (@pavoni)](https://github.com/pavoni "249 total commits to the home-assistant organization, 222 commits to home-assistant, 25 commits to home-assistant.github.io, 2 commits to netdisco")
 - [Greg Laabs (@OverloadUT)](https://github.com/OverloadUT "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Greg MacLellan (@gregmac)](https://github.com/gregmac "1 total commits to the home-assistant organization, 1 commit to pi-gen")
+- [Greg Stengel (@theCMack)](https://github.com/theCMack "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Greg Stevenson (@gstevenson)](https://github.com/gstevenson "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
+- [Greg. A. (@gautric)](https://github.com/gautric "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [groth-its (@groth-its)](https://github.com/groth-its "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [GTH (@gunnarhelgason)](https://github.com/gunnarhelgason "2 total commits to the home-assistant organization, 2 commits to appdaemon")
 - [Gustav Ahlberg (@Gyran)](https://github.com/Gyran "20 total commits to the home-assistant organization, 20 commits to home-assistant")
@@ -345,14 +354,15 @@ This page contains a list of people who have contributed in one way or another t
 - [Henrik Aronsson (@heennkkee)](https://github.com/heennkkee "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Henrik Nicolaisen (@hmn)](https://github.com/hmn "6 total commits to the home-assistant organization, 6 commits to home-assistant")
 - [Hernán Rossetto (@hmronline)](https://github.com/hmronline "2 total commits to the home-assistant organization, 2 commits to home-assistant")
-- [hexa- (@mweinelt)](https://github.com/mweinelt "16 total commits to the home-assistant organization, 9 commits to home-assistant, 7 commits to home-assistant.github.io")
+- [hexa- (@mweinelt)](https://github.com/mweinelt "17 total commits to the home-assistant organization, 9 commits to home-assistant, 7 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
 - [heytcass (@heytcass)](https://github.com/heytcass "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
 - [Hillary Fraley (@hillaryfraley)](https://github.com/hillaryfraley "12 total commits to the home-assistant organization, 12 commits to home-assistant.github.io")
-- [Hugo Dupras (@jabesq)](https://github.com/jabesq "26 total commits to the home-assistant organization, 19 commits to home-assistant, 7 commits to home-assistant.github.io")
+- [honcheng (@honcheng)](https://github.com/honcheng "1 total commits to the home-assistant organization, 1 commit to homebridge-homeassistant")
-- [Hugo Gresse (@HugoGresse)](https://github.com/HugoGresse "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
+- [Hugo Dupras (@jabesq)](https://github.com/jabesq "27 total commits to the home-assistant organization, 19 commits to home-assistant, 8 commits to home-assistant.github.io")
+- [Hugo Gresse (@HugoGresse)](https://github.com/HugoGresse "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io")
 - [Hung Le (@hungle)](https://github.com/hungle "1 total commits to the home-assistant organization, 1 commit to libcoap")
 - [Huw Davies (@beardedgeek)](https://github.com/beardedgeek "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [Hydreliox (@HydrelioxGitHub)](https://github.com/HydrelioxGitHub "40 total commits to the home-assistant organization, 31 commits to home-assistant, 9 commits to home-assistant.github.io")
+- [Hydreliox (@HydrelioxGitHub)](https://github.com/HydrelioxGitHub "45 total commits to the home-assistant organization, 34 commits to home-assistant, 11 commits to home-assistant.github.io")
 - [Iain Matchett (@matchett808)](https://github.com/matchett808 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Ian Copp (@icopp)](https://github.com/icopp "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [ianj001 (@ianj001)](https://github.com/ianj001 "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io")
@@ -371,21 +381,23 @@ This page contains a list of people who have contributed in one way or another t
 - [Jacob Siverskog (@jsiverskog)](https://github.com/jsiverskog "1 total commits to the home-assistant organization, 1 commit to pi-gen")
 - [Jacob Tomlinson (@jacobtomlinson)](https://github.com/jacobtomlinson "8 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 2 commits to home-assistant")
 - [Jake McCrary (@jakemcc)](https://github.com/jakemcc "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Jakub Bittner (@rexcze)](https://github.com/rexcze "2 total commits to the home-assistant organization, 2 commits to home-assistant-polymer")
 - [James Cole (@jamespcole)](https://github.com/jamespcole "94 total commits to the home-assistant organization, 93 commits to home-assistant, 1 commit to home-assistant-js")
 - [Jamie van Dyke (@fearoffish)](https://github.com/fearoffish "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant-iOS")
 - [JammyDodger231 (@JammyDodger231)](https://github.com/JammyDodger231 "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
-- [Jan Almeroth (@jalmeroth)](https://github.com/jalmeroth "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to home-assistant-polymer")
+- [Jan Almeroth (@jalmeroth)](https://github.com/jalmeroth "6 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
 - [Jan Harkes (@jaharkes)](https://github.com/jaharkes "110 total commits to the home-assistant organization, 100 commits to home-assistant, 10 commits to netdisco")
 - [Jan Losinski (@janLo)](https://github.com/janLo "18 total commits to the home-assistant organization, 14 commits to home-assistant, 4 commits to home-assistant.github.io")
 - [Jan Pobořil (@iBobik)](https://github.com/iBobik "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Jan Wh (@janwh)](https://github.com/janwh "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Janne Grunau (@jannau)](https://github.com/jannau "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [Jared Beckham (@jtbeckha)](https://github.com/jtbeckha "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Jared Beckham (@jtbeckha)](https://github.com/jtbeckha "4 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 2 commits to home-assistant")
 - [Jared J. (@jjensn)](https://github.com/jjensn "1 total commits to the home-assistant organization, 1 commit to netdisco")
 - [Jason Carter (@JasonCarter80)](https://github.com/JasonCarter80 "7 total commits to the home-assistant organization, 4 commits to home-assistant, 3 commits to home-assistant.github.io")
 - [Jason Hite (@jasonmhite)](https://github.com/jasonmhite "6 total commits to the home-assistant organization, 6 commits to appdaemon")
 - [Javier González Calleja (@gonzalezcalleja)](https://github.com/gonzalezcalleja "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Jay Stevens (@Jay2645)](https://github.com/Jay2645 "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
+- [jbarrancos (@jbarrancos)](https://github.com/jbarrancos "39 total commits to the home-assistant organization, 39 commits to home-assistant")
 - [Jean Regisser (@jeanregisser)](https://github.com/jeanregisser "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Jean-Michel Julien (@KurdyMalloy)](https://github.com/KurdyMalloy "1 total commits to the home-assistant organization, 1 commit to libcoap")
 - [Jean-Philippe Bouillot (@Jypy)](https://github.com/Jypy "2 total commits to the home-assistant organization, 2 commits to home-assistant")
@@ -397,7 +409,8 @@ This page contains a list of people who have contributed in one way or another t
 - [Jeremiah Wuenschel (@jer)](https://github.com/jer "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Jeremy (@Wutname1)](https://github.com/Wutname1 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Jeremy Williams (@jwillaz)](https://github.com/jwillaz "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
-- [Jeroen ter Heerdt (@jeroenterheerdt)](https://github.com/jeroenterheerdt "17 total commits to the home-assistant organization, 11 commits to home-assistant, 6 commits to home-assistant.github.io")
+- [jeremysv (@jeremysv)](https://github.com/jeremysv "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
+- [Jeroen ter Heerdt (@jeroenterheerdt)](https://github.com/jeroenterheerdt "19 total commits to the home-assistant organization, 12 commits to home-assistant, 7 commits to home-assistant.github.io")
 - [Jerold Albertson (@jeroldalbertson-wf)](https://github.com/jeroldalbertson-wf "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
 - [Jesse Hills (@jesserockz)](https://github.com/jesserockz "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Jesse Newland (@jnewland)](https://github.com/jnewland "14 total commits to the home-assistant organization, 11 commits to home-assistant, 3 commits to hubot-home-assistant")
@@ -406,27 +419,30 @@ This page contains a list of people who have contributed in one way or another t
 - [jgriff2 (@jgriff2)](https://github.com/jgriff2 "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Jim Rollenhagen (@jimrollenhagen)](https://github.com/jimrollenhagen "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Joakim Nohlgård (@gebart)](https://github.com/gebart "2 total commits to the home-assistant organization, 2 commits to libcoap")
-- [Joakim Sørensen (@ludeeus)](https://github.com/ludeeus "25 total commits to the home-assistant organization, 13 commits to home-assistant.github.io, 12 commits to hassbian-scripts")
+- [Joakim Sørensen (@ludeeus)](https://github.com/ludeeus "27 total commits to the home-assistant organization, 14 commits to hassbian-scripts, 13 commits to home-assistant.github.io")
 - [Job (@jmvermeulen)](https://github.com/jmvermeulen "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Joe Lee (@xnoodle)](https://github.com/xnoodle "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [Joe Lu (@snjoetw)](https://github.com/snjoetw "9 total commits to the home-assistant organization, 7 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Joe Lu (@snjoetw)](https://github.com/snjoetw "10 total commits to the home-assistant organization, 8 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [joe248 (@joe248)](https://github.com/joe248 "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Joeboyc2 (@Joeboyc2)](https://github.com/Joeboyc2 "15 total commits to the home-assistant organization, 15 commits to home-assistant.github.io")
 - [joemcmonagle (@joemcmonagle)](https://github.com/joemcmonagle "8 total commits to the home-assistant organization, 8 commits to home-assistant.github.io")
 - [Johan Bloemberg (@aequitas)](https://github.com/aequitas "43 total commits to the home-assistant organization, 35 commits to home-assistant, 7 commits to home-assistant.github.io, 1 commit to netdisco")
 - [Johan Haals (@jhaals)](https://github.com/jhaals "1 total commits to the home-assistant organization, 1 commit to appdaemon")
 - [Johan Klintberg (@moogblob)](https://github.com/moogblob "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Johan van der Kuijl (@Rubyan)](https://github.com/Rubyan "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to appdaemon")
 - [Johann Kellerman (@kellerza)](https://github.com/kellerza "144 total commits to the home-assistant organization, 114 commits to home-assistant, 30 commits to home-assistant.github.io")
 - [Johannes K. (@roadrash2108)](https://github.com/roadrash2108 "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [John (@J-C-B)](https://github.com/J-C-B "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
 - [John Arild Berentsen (@turbokongen)](https://github.com/turbokongen "185 total commits to the home-assistant organization, 143 commits to home-assistant, 33 commits to home-assistant.github.io, 9 commits to home-assistant-polymer")
 - [John Coggeshall (@coogle)](https://github.com/coogle "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [John Lindley (@jwl17330536)](https://github.com/jwl17330536 "1 total commits to the home-assistant organization, 1 commit to appdaemon")
 - [John McLaughlin (@loghound)](https://github.com/loghound "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [John Mihalic (@mezz64)](https://github.com/mezz64 "45 total commits to the home-assistant organization, 31 commits to home-assistant, 12 commits to home-assistant.github.io, 1 commit to hadashboard, 1 commit to home-assistant-polymer")
-- [Johnny Chadda (@joch)](https://github.com/joch "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Johnny Chadda (@joch)](https://github.com/joch "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
 - [Jon (@JonMurphy)](https://github.com/JonMurphy "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Jon Caruana (@joncar)](https://github.com/joncar "5 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Jon Maddox (@maddox)](https://github.com/maddox "102 total commits to the home-assistant organization, 78 commits to home-assistant, 16 commits to homebridge-homeassistant, 8 commits to home-assistant.github.io")
+- [Jonas Pedersen (@JonasPed)](https://github.com/JonasPed "1 total commits to the home-assistant organization, 1 commit to appdaemon")
 - [Jonatan Castro (@jcastro)](https://github.com/jcastro "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io")
 - [Jonathan Baginski (@patchedsoul)](https://github.com/patchedsoul "115 total commits to the home-assistant organization, 87 commits to fabric-home-assistant, 28 commits to home-assistant.github.io")
 - [joopert (@joopert)](https://github.com/joopert "6 total commits to the home-assistant organization, 6 commits to home-assistant")
@@ -439,7 +455,7 @@ This page contains a list of people who have contributed in one way or another t
 - [Josh Nichols (@technicalpickles)](https://github.com/technicalpickles "24 total commits to the home-assistant organization, 15 commits to home-assistant, 9 commits to home-assistant.github.io")
 - [Josh Wright (@JshWright)](https://github.com/JshWright "28 total commits to the home-assistant organization, 20 commits to home-assistant, 8 commits to home-assistant.github.io")
 - [jpcomtois (@jpcomtois)](https://github.com/jpcomtois "1 total commits to the home-assistant organization, 1 commit to libcoap")
-- [JudgeDredd (@kentcalero)](https://github.com/kentcalero "10 total commits to the home-assistant organization, 10 commits to home-assistant.github.io")
+- [JudgeDredd (@JudgeDreddKLC)](https://github.com/JudgeDreddKLC "10 total commits to the home-assistant organization, 10 commits to home-assistant.github.io")
 - [Juggels (@Juggels)](https://github.com/Juggels "8 total commits to the home-assistant organization, 5 commits to home-assistant, 3 commits to home-assistant.github.io")
 - [Julian Kahnert (@JulianKahnert)](https://github.com/JulianKahnert "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Julius Mittenzwei (@Julius2342)](https://github.com/Julius2342 "11 total commits to the home-assistant organization, 8 commits to home-assistant, 3 commits to home-assistant.github.io")
@@ -448,18 +464,19 @@ This page contains a list of people who have contributed in one way or another t
 - [Justin Hayes (@GussyH)](https://github.com/GussyH "7 total commits to the home-assistant organization, 7 commits to hadashboard")
 - [Justin Weberg (@justweb1)](https://github.com/justweb1 "28 total commits to the home-assistant organization, 13 commits to home-assistant-polymer, 7 commits to hassbot, 4 commits to home-assistant, 2 commits to home-assistant.github.io, 1 commit to home-assistant-js, 1 commit to hassio")
 - [Justyn Shull (@justyns)](https://github.com/justyns "5 total commits to the home-assistant organization, 5 commits to home-assistant")
+- [Jürgen W (@jurgenweber)](https://github.com/jurgenweber "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Kai (@luxus)](https://github.com/luxus "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [Kane610 (@Kane610)](https://github.com/Kane610 "11 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 5 commits to home-assistant, 1 commit to netdisco")
+- [Kane610 (@Kane610)](https://github.com/Kane610 "13 total commits to the home-assistant organization, 6 commits to home-assistant, 6 commits to home-assistant.github.io, 1 commit to netdisco")
 - [Karen Goode (@kfgoode)](https://github.com/kfgoode "4 total commits to the home-assistant organization, 4 commits to home-assistant")
 - [karlkar (@karlkar)](https://github.com/karlkar "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Keaton Taylor (@keatontaylor)](https://github.com/keatontaylor "7 total commits to the home-assistant organization, 4 commits to home-assistant, 3 commits to home-assistant.github.io")
 - [Keith (@seedzero)](https://github.com/seedzero "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Keith Lamprecht (@Nixon506E)](https://github.com/Nixon506E "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Ken Bannister (@kb2ma)](https://github.com/kb2ma "1 total commits to the home-assistant organization, 1 commit to libcoap")
-- [Ken Davidson (@kwdavidson)](https://github.com/kwdavidson "11 total commits to the home-assistant organization, 9 commits to home-assistant.github.io, 2 commits to appdaemon")
+- [Ken Davidson (@kwdavidson)](https://github.com/kwdavidson "13 total commits to the home-assistant organization, 11 commits to home-assistant.github.io, 2 commits to appdaemon")
 - [Kevin (@Mister-Espria)](https://github.com/Mister-Espria "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Kevin Christensen (@nivekmai)](https://github.com/nivekmai "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [Kevin Fronczak (@fronzbot)](https://github.com/fronzbot "16 total commits to the home-assistant organization, 10 commits to home-assistant, 6 commits to home-assistant.github.io")
+- [Kevin Fronczak (@fronzbot)](https://github.com/fronzbot "18 total commits to the home-assistant organization, 11 commits to home-assistant, 7 commits to home-assistant.github.io")
 - [Kevin Gisi (@gisikw)](https://github.com/gisikw "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
 - [Kevin Gottsman (@gottsman)](https://github.com/gottsman "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io")
 - [Kevin Panaro (@kevinpanaro)](https://github.com/kevinpanaro "2 total commits to the home-assistant organization, 2 commits to home-assistant")
@@ -467,7 +484,7 @@ This page contains a list of people who have contributed in one way or another t
 - [Keyasha Brothern (@KMBrothern)](https://github.com/KMBrothern "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [kfcook (@kfcook)](https://github.com/kfcook "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [kireyeu (@kireyeu)](https://github.com/kireyeu "4 total commits to the home-assistant organization, 4 commits to home-assistant-notebooks")
-- [Klaas Hoekema (@KlaasH)](https://github.com/KlaasH "7 total commits to the home-assistant organization, 4 commits to home-assistant, 3 commits to home-assistant.github.io")
+- [Klaas Hoekema (@KlaasH)](https://github.com/KlaasH "9 total commits to the home-assistant organization, 5 commits to home-assistant, 4 commits to home-assistant.github.io")
 - [Klaus (@k-laus)](https://github.com/k-laus "1 total commits to the home-assistant organization, 1 commit to appdaemon")
 - [Krasimir Chariyski (@Chariyski)](https://github.com/Chariyski "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [Krasimir Zhelev (@zhelev)](https://github.com/zhelev "1 total commits to the home-assistant organization, 1 commit to netdisco")
@@ -477,28 +494,31 @@ This page contains a list of people who have contributed in one way or another t
 - [Kyle R (@qcryptic)](https://github.com/qcryptic "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [lamiskin (@lamiskin)](https://github.com/lamiskin "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [lee-js (@lee-js)](https://github.com/lee-js "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
-- [Leon99 (@Leon99)](https://github.com/Leon99 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Leon99 (@Leon99)](https://github.com/Leon99 "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to appdaemon")
 - [Leonardo Saraiva (@vyper)](https://github.com/vyper "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Lev Aronsky (@aronsky)](https://github.com/aronsky "11 total commits to the home-assistant organization, 8 commits to home-assistant, 3 commits to home-assistant.github.io")
-- [Lewis Juggins (@lwis)](https://github.com/lwis "57 total commits to the home-assistant organization, 45 commits to home-assistant, 11 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
+- [Lewis Juggins (@lwis)](https://github.com/lwis "61 total commits to the home-assistant organization, 48 commits to home-assistant, 12 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
 - [Lindsay Ward (@lindsaymarkward)](https://github.com/lindsaymarkward "17 total commits to the home-assistant organization, 13 commits to home-assistant.github.io, 4 commits to home-assistant")
 - [linuxlurak (@linuxlurak)](https://github.com/linuxlurak "5 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to hadashboard")
 - [lrmate (@lrmate)](https://github.com/lrmate "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Luar Roji (@cyberplant)](https://github.com/cyberplant "6 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 2 commits to home-assistant")
+- [luca-angemi (@luca-angemi)](https://github.com/luca-angemi "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [LucaSoldi (@LucaSoldi)](https://github.com/LucaSoldi "6 total commits to the home-assistant organization, 6 commits to home-assistant")
 - [Lucien Guimier (@guimier)](https://github.com/guimier "1 total commits to the home-assistant organization, 1 commit to libcoap")
+- [Ludovic (@ldvc)](https://github.com/ldvc "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [Lukas (@lukas-hetzenecker)](https://github.com/lukas-hetzenecker "14 total commits to the home-assistant organization, 10 commits to home-assistant, 4 commits to home-assistant.github.io")
-- [Lukas Barth (@tinloaf)](https://github.com/tinloaf "11 total commits to the home-assistant organization, 6 commits to home-assistant, 5 commits to home-assistant.github.io")
+- [Lukas Barth (@tinloaf)](https://github.com/tinloaf "15 total commits to the home-assistant organization, 7 commits to home-assistant, 7 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
 - [Luke Armstrong (@lukearmstrong)](https://github.com/lukearmstrong "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Lupin Demid (@lupin-de-mid)](https://github.com/lupin-de-mid "5 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to home-assistant")
 - [Luuk (@Maharball1)](https://github.com/Maharball1 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [LvivEchoes (@LvivEchoes)](https://github.com/LvivEchoes "7 total commits to the home-assistant organization, 4 commits to home-assistant, 3 commits to home-assistant.github.io")
-- [Maciej Sokołowski (@matemaciek)](https://github.com/matemaciek "1 total commits to the home-assistant organization, 1 commit to hassio-build")
+- [Maciej Bieniek (@bieniu)](https://github.com/bieniu "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to home-assistant-polymer")
+- [Maciej Sokołowski (@matemaciek)](https://github.com/matemaciek "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to hassio-build")
 - [Maciej Wasilak (@mwasilak)](https://github.com/mwasilak "1 total commits to the home-assistant organization, 1 commit to libcoap")
 - [Magnus Ihse Bursie (@magicus)](https://github.com/magicus "16 total commits to the home-assistant organization, 9 commits to home-assistant, 4 commits to netdisco, 3 commits to home-assistant.github.io")
 - [Magnus Lyckå (@magnus-lycka)](https://github.com/magnus-lycka "1 total commits to the home-assistant organization, 1 commit to netdisco")
 - [MagnusKnutas (@MagnusKnutas)](https://github.com/MagnusKnutas "29 total commits to the home-assistant organization, 29 commits to home-assistant")
-- [Mahasri Kalavala (@skalavala)](https://github.com/skalavala "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io")
+- [Mahasri Kalavala (@skalavala)](https://github.com/skalavala "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io")
 - [Maikel Wever (@maikelwever)](https://github.com/maikelwever "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Malte Franken (@exxamalte)](https://github.com/exxamalte "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Manu (@matrixagent)](https://github.com/matrixagent "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
@@ -507,9 +527,10 @@ This page contains a list of people who have contributed in one way or another t
 - [Marc Pabst (@mxtra)](https://github.com/mxtra "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [Marc Plano-Lesay (@Kernald)](https://github.com/Kernald "12 total commits to the home-assistant organization, 10 commits to home-assistant.github.io, 2 commits to home-assistant")
 - [Marcel030nl (@Marcel030nl)](https://github.com/Marcel030nl "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
-- [Marcelo Moreira de Mello (@tchellomello)](https://github.com/tchellomello "126 total commits to the home-assistant organization, 70 commits to home-assistant, 56 commits to home-assistant.github.io")
+- [Marcelo Moreira de Mello (@tchellomello)](https://github.com/tchellomello "132 total commits to the home-assistant organization, 72 commits to home-assistant, 58 commits to home-assistant.github.io, 1 commit to home-assistant-assets, 1 commit to home-assistant-polymer")
 - [Marcin Jaworski (@yawor)](https://github.com/yawor "12 total commits to the home-assistant organization, 12 commits to appdaemon")
 - [Marijn Giesen (@marijngiesen)](https://github.com/marijngiesen "7 total commits to the home-assistant organization, 5 commits to hadashboard, 2 commits to home-assistant.github.io")
+- [Mark Grosen (@mgsb)](https://github.com/mgsb "1 total commits to the home-assistant organization, 1 commit to netdisco")
 - [Mark Huson (@mehuman)](https://github.com/mehuman "11 total commits to the home-assistant organization, 11 commits to home-assistant.github.io")
 - [Mark Oude Veldhuis (@markoudev)](https://github.com/markoudev "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Markus Becker (@markushx)](https://github.com/markushx "6 total commits to the home-assistant organization, 6 commits to libcoap")
@@ -525,9 +546,9 @@ This page contains a list of people who have contributed in one way or another t
 - [Martin Vacula (@MatoKafkac)](https://github.com/MatoKafkac "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Martokk (@martokk)](https://github.com/martokk "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Mathew Peterson (@mathewpeterson)](https://github.com/mathewpeterson "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to homebridge-homeassistant")
-- [Matt N. (@mnoorenberghe)](https://github.com/mnoorenberghe "23 total commits to the home-assistant organization, 15 commits to home-assistant.github.io, 7 commits to home-assistant, 1 commit to home-assistant-polymer")
+- [Matt N. (@mnoorenberghe)](https://github.com/mnoorenberghe "47 total commits to the home-assistant organization, 23 commits to home-assistant-iOS, 16 commits to home-assistant.github.io, 7 commits to home-assistant, 1 commit to home-assistant-polymer")
 - [Matt Rogers (@rogersmj)](https://github.com/rogersmj "20 total commits to the home-assistant organization, 20 commits to hadashboard")
-- [Matt Schmitt (@schmittx)](https://github.com/schmittx "22 total commits to the home-assistant organization, 15 commits to homebridge-homeassistant, 5 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Matt Schmitt (@schmittx)](https://github.com/schmittx "26 total commits to the home-assistant organization, 19 commits to homebridge-homeassistant, 5 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Matt White (@mw-white)](https://github.com/mw-white "6 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 3 commits to home-assistant")
 - [matt2005 (@matt2005)](https://github.com/matt2005 "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Matteo Lampugnani (@t30)](https://github.com/t30 "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io")
@@ -537,6 +558,7 @@ This page contains a list of people who have contributed in one way or another t
 - [Matthew Treinish (@mtreinish)](https://github.com/mtreinish "16 total commits to the home-assistant organization, 10 commits to home-assistant, 6 commits to home-assistant.github.io")
 - [mattie47 (@mattie47)](https://github.com/mattie47 "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [mauriciobonani (@mauriciobonani)](https://github.com/mauriciobonani "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io")
+- [Max Rumpf (@Maxr1998)](https://github.com/Maxr1998 "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [mboeru (@mboeru)](https://github.com/mboeru "1 total commits to the home-assistant organization, 1 commit to home-assistant-iOS")
 - [mertenats (@mertenats)](https://github.com/mertenats "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [Micha LaQua (@milaq)](https://github.com/milaq "3 total commits to the home-assistant organization, 3 commits to home-assistant")
@@ -564,11 +586,12 @@ This page contains a list of people who have contributed in one way or another t
 - [Mike Roberts (@m-roberts)](https://github.com/m-roberts "1 total commits to the home-assistant organization, 1 commit to pi-gen")
 - [mikey (@pfista)](https://github.com/pfista "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Mikkel Høgh (@mikl)](https://github.com/mikl "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
-- [milanvo (@milanvo)](https://github.com/milanvo "8 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 3 commits to home-assistant, 1 commit to home-assistant-polymer")
+- [Milan V. (@milanvo)](https://github.com/milanvo "11 total commits to the home-assistant organization, 5 commits to home-assistant, 5 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
 - [MinchinWeb (@MinchinWeb)](https://github.com/MinchinWeb "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [miniconfig (@miniconfig)](https://github.com/miniconfig "27 total commits to the home-assistant organization, 20 commits to home-assistant, 7 commits to home-assistant.github.io")
 - [Minims (@Minims)](https://github.com/Minims "3 total commits to the home-assistant organization, 3 commits to homebridge-homeassistant")
 - [Mister Wil (@MisterWil)](https://github.com/MisterWil "16 total commits to the home-assistant organization, 10 commits to home-assistant, 6 commits to home-assistant.github.io")
+- [Mitchell Cash (@mitchellcash)](https://github.com/mitchellcash "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Mitesh Patel (@gurumitts)](https://github.com/gurumitts "9 total commits to the home-assistant organization, 5 commits to home-assistant, 4 commits to home-assistant.github.io")
 - [Mitko Masarliev (@masarliev)](https://github.com/masarliev "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [mje-nz (@mje-nz)](https://github.com/mje-nz "2 total commits to the home-assistant organization, 2 commits to home-assistant")
@@ -576,8 +599,7 @@ This page contains a list of people who have contributed in one way or another t
 - [Molodax (@Molodax)](https://github.com/Molodax "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io")
 - [Moon Shot (@moonshot)](https://github.com/moonshot "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [moose51789 (@moose51789)](https://github.com/moose51789 "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
-- [morberg (@morberg)](https://github.com/morberg "2 total commits to the home-assistant organization, 2 commits to home-assistant")
+- [moskovskiy82 (@moskovskiy82)](https://github.com/moskovskiy82 "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
-- [moskovskiy82 (@moskovskiy82)](https://github.com/moskovskiy82 "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [motir (@motir)](https://github.com/motir "1 total commits to the home-assistant organization, 1 commit to appdaemon")
 - [mtl010957 (@mtl010957)](https://github.com/mtl010957 "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Mārtiņš Grunskis (@grunskis)](https://github.com/grunskis "1 total commits to the home-assistant organization, 1 commit to netdisco")
@@ -590,7 +612,8 @@ This page contains a list of people who have contributed in one way or another t
 - [NeLLyMerC (@NeLLyMerC)](https://github.com/NeLLyMerC "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Nemanja Stefanovic (@nemik)](https://github.com/nemik "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [neonbunny (@neonbunny)](https://github.com/neonbunny "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
-- [Ness (@Xx-Ness-xX)](https://github.com/Xx-Ness-xX "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
+- [Nicholas Amadori (@namadori)](https://github.com/namadori "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Nicholas Griffin (@nicholasgriffintn)](https://github.com/nicholasgriffintn "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io")
 - [Nicholas Sielicki (@sielicki)](https://github.com/sielicki "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Nick (@quadportnick)](https://github.com/quadportnick "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Nick Vella (@nvella)](https://github.com/nvella "5 total commits to the home-assistant organization, 4 commits to home-assistant, 1 commit to homebridge-homeassistant")
@@ -598,12 +621,14 @@ This page contains a list of people who have contributed in one way or another t
 - [Nicolas Graziano (@ngraziano)](https://github.com/ngraziano "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Nicolas Martignoni (@martignoni)](https://github.com/martignoni "1 total commits to the home-assistant organization, 1 commit to pi-gen")
 - [Niklas (@niklaswa)](https://github.com/niklaswa "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
+- [Niklas Morberg (@morberg)](https://github.com/morberg "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Nikolas Beutler (@biacz)](https://github.com/biacz "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Nils Uliczka (@darookee)](https://github.com/darookee "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [NMA (@nma83)](https://github.com/nma83 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [nodomain (@nodomain)](https://github.com/nodomain "9 total commits to the home-assistant organization, 7 commits to home-assistant.github.io, 2 commits to homebridge-homeassistant")
 - [Nolan Gilley (@nkgilley)](https://github.com/nkgilley "116 total commits to the home-assistant organization, 91 commits to home-assistant, 25 commits to home-assistant.github.io")
 - [NotoriousBDG (@notoriousbdg)](https://github.com/notoriousbdg "3 total commits to the home-assistant organization, 3 commits to hassio-addons")
+- [ntalekt (@ntalekt)](https://github.com/ntalekt "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
 - [Nuno Sousa (@nunofgs)](https://github.com/nunofgs "7 total commits to the home-assistant organization, 4 commits to home-assistant, 2 commits to home-assistant.github.io, 1 commit to homebridge-homeassistant")
 - [obgm (@obgm)](https://github.com/obgm "480 total commits to the home-assistant organization, 480 commits to libcoap")
 - [Olav Alexander Mjelde (@olavxxx)](https://github.com/olavxxx "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
@@ -611,21 +636,21 @@ This page contains a list of people who have contributed in one way or another t
 - [Ole-Kenneth (@olekenneth)](https://github.com/olekenneth "1 total commits to the home-assistant organization, 1 commit to homebridge-homeassistant")
 - [Oleksii Serdiuk (@leppa)](https://github.com/leppa "5 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Oliv3rDog (@Oliv3rDog)](https://github.com/Oliv3rDog "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
-- [Oliver (@scarface-4711)](https://github.com/scarface-4711 "22 total commits to the home-assistant organization, 13 commits to home-assistant, 8 commits to home-assistant.github.io, 1 commit to netdisco")
+- [Oliver (@scarface-4711)](https://github.com/scarface-4711 "23 total commits to the home-assistant organization, 13 commits to home-assistant, 9 commits to home-assistant.github.io, 1 commit to netdisco")
 - [Oliver van Porten (@mcdeck)](https://github.com/mcdeck "10 total commits to the home-assistant organization, 10 commits to home-assistant")
-- [olskar (@olskar)](https://github.com/olskar "1 total commits to the home-assistant organization, 1 commit to hassbian-scripts")
+- [olskar (@olskar)](https://github.com/olskar "5 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 1 commit to hassbian-scripts")
 - [Omar Usman (@omarusman)](https://github.com/omarusman "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Open Home Automation (@open-homeautomation)](https://github.com/open-homeautomation "41 total commits to the home-assistant organization, 29 commits to home-assistant, 12 commits to home-assistant.github.io")
 - [oznu (@oznu)](https://github.com/oznu "1 total commits to the home-assistant organization, 1 commit to homebridge-homeassistant")
 - [Parker Moore (@parkr)](https://github.com/parkr "62 total commits to the home-assistant organization, 62 commits to home-assistant.github.io")
-- [pascal (@passie)](https://github.com/passie "2 total commits to the home-assistant organization, 2 commits to home-assistant")
+- [pascal (@passie)](https://github.com/passie "4 total commits to the home-assistant organization, 3 commits to home-assistant, 1 commit to home-assistant-polymer")
 - [Pascal Bach (@bachp)](https://github.com/bachp "10 total commits to the home-assistant organization, 9 commits to home-assistant, 1 commit to netdisco")
-- [Pascal Vizeli (@pvizeli)](https://github.com/pvizeli "2110 total commits to the home-assistant organization, 827 commits to hassio, 397 commits to home-assistant, 300 commits to hassio-addons, 294 commits to hassio-build, 274 commits to home-assistant.github.io, 16 commits to hassio-addons-example, 1 commit to home-assistant-js-websocket, 1 commit to netdisco")
+- [Pascal Vizeli (@pvizeli)](https://github.com/pvizeli "2154 total commits to the home-assistant organization, 840 commits to hassio, 411 commits to home-assistant, 300 commits to hassio-addons, 298 commits to hassio-build, 287 commits to home-assistant.github.io, 16 commits to hassio-addons-example, 1 commit to home-assistant-js-websocket, 1 commit to netdisco")
 - [patkap (@patkap)](https://github.com/patkap "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Patrick Aikens (@duckpuppy)](https://github.com/duckpuppy "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Patrick Easters (@patrickeasters)](https://github.com/patrickeasters "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
 - [Patrick White (@pw)](https://github.com/pw "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [Patrik (@ggravlingen)](https://github.com/ggravlingen "2 total commits to the home-assistant organization, 2 commits to home-assistant")
+- [Patrik (@ggravlingen)](https://github.com/ggravlingen "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Paul Jimenez (@pjz)](https://github.com/pjz "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Paul Sokolovsky (@pfalcon)](https://github.com/pfalcon "6 total commits to the home-assistant organization, 3 commits to netdisco, 3 commits to home-assistant")
 - [Pavel Ponomarev (@awsum)](https://github.com/awsum "2 total commits to the home-assistant organization, 2 commits to home-assistant-polymer")
@@ -636,44 +661,47 @@ This page contains a list of people who have contributed in one way or another t
 - [Per Sandström (@persandstrom)](https://github.com/persandstrom "124 total commits to the home-assistant organization, 98 commits to home-assistant, 14 commits to home-assistant.github.io, 12 commits to home-assistant-polymer")
 - [Pete Peterson (@petey)](https://github.com/petey "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [PetePriority (@PetePriority)](https://github.com/PetePriority "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Peter Epley (@epleypa)](https://github.com/epleypa "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [Petr Vraník (@konikvranik)](https://github.com/konikvranik "11 total commits to the home-assistant organization, 6 commits to home-assistant, 5 commits to home-assistant.github.io")
-- [pezinek (@pezinek)](https://github.com/pezinek "7 total commits to the home-assistant organization, 7 commits to home-assistant")
+- [pezinek (@pezinek)](https://github.com/pezinek "8 total commits to the home-assistant organization, 8 commits to home-assistant")
 - [Phil (@godloth)](https://github.com/godloth "10 total commits to the home-assistant organization, 10 commits to home-assistant.github.io")
 - [Phil Cole (@filcole)](https://github.com/filcole "8 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 3 commits to home-assistant")
 - [Phil Haack (@Haacked)](https://github.com/Haacked "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
-- [Phil Hawthorne (@philhawthorne)](https://github.com/philhawthorne "17 total commits to the home-assistant organization, 11 commits to home-assistant.github.io, 6 commits to home-assistant")
+- [Phil Hawthorne (@philhawthorne)](https://github.com/philhawthorne "23 total commits to the home-assistant organization, 17 commits to home-assistant.github.io, 6 commits to home-assistant")
 - [Phil Kates (@philk)](https://github.com/philk "5 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Phileep (@Phileep)](https://github.com/Phileep "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Philip Hofstetter (@pilif)](https://github.com/pilif "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io")
 - [Philip Lundrigan (@philipbl)](https://github.com/philipbl "65 total commits to the home-assistant organization, 56 commits to home-assistant, 9 commits to home-assistant.github.io")
-- [Philipp Schmitt (@pschmitt)](https://github.com/pschmitt "33 total commits to the home-assistant organization, 21 commits to home-assistant, 11 commits to home-assistant.github.io, 1 commit to hassio-build")
+- [Philipp Schmitt (@pschmitt)](https://github.com/pschmitt "36 total commits to the home-assistant organization, 23 commits to home-assistant, 11 commits to home-assistant.github.io, 1 commit to appdaemon, 1 commit to hassio-build")
-- [Phill Price (@phillprice)](https://github.com/phillprice "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
+- [Phill Price (@phillprice)](https://github.com/phillprice "10 total commits to the home-assistant organization, 10 commits to home-assistant.github.io")
-- [PhracturedBlue (@PhracturedBlue)](https://github.com/PhracturedBlue "15 total commits to the home-assistant organization, 7 commits to home-assistant.github.io, 7 commits to home-assistant, 1 commit to home-assistant-polymer")
+- [PhracturedBlue (@PhracturedBlue)](https://github.com/PhracturedBlue "15 total commits to the home-assistant organization, 7 commits to home-assistant, 7 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
 - [Pierre Ståhl (@postlund)](https://github.com/postlund "37 total commits to the home-assistant organization, 25 commits to home-assistant, 8 commits to home-assistant.github.io, 4 commits to netdisco")
 - [Piratonym (@Piratonym)](https://github.com/Piratonym "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [PuckStar (@PuckStar)](https://github.com/PuckStar "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io")
 - [R Huish (@Genestealer)](https://github.com/Genestealer "19 total commits to the home-assistant organization, 19 commits to home-assistant.github.io")
-- [R1chardTM (@R1chardTM)](https://github.com/R1chardTM "10 total commits to the home-assistant organization, 5 commits to home-assistant, 4 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
 - [rbflurry (@rbflurry)](https://github.com/rbflurry "14 total commits to the home-assistant organization, 11 commits to home-assistant.github.io, 3 commits to home-assistant")
 - [RBHR (@rbhr)](https://github.com/rbhr "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Reed Riley (@reedriley)](https://github.com/reedriley "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Rene Tode (@ReneTode)](https://github.com/ReneTode "25 total commits to the home-assistant organization, 25 commits to appdaemon")
 - [René Kliment (@renekliment)](https://github.com/renekliment "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Rev Michael Greb (@mikegrb)](https://github.com/mikegrb "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Reza Moallemi (@moallemi)](https://github.com/moallemi "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [rhooper (@rhooper)](https://github.com/rhooper "30 total commits to the home-assistant organization, 25 commits to home-assistant, 3 commits to home-assistant.github.io, 2 commits to hadashboard")
 - [Riccardo Canta (@commento)](https://github.com/commento "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Richard Arends (@Mosibi)](https://github.com/Mosibi "8 total commits to the home-assistant organization, 8 commits to home-assistant")
 - [Richard Cox (@Khabi)](https://github.com/Khabi "15 total commits to the home-assistant organization, 9 commits to home-assistant, 6 commits to home-assistant.github.io")
 - [Richard Cunningham (@rythie)](https://github.com/rythie "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Richard Leurs (@R1chardTM)](https://github.com/R1chardTM "13 total commits to the home-assistant organization, 7 commits to home-assistant, 5 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
 - [rkabadi (@rkabadi)](https://github.com/rkabadi "17 total commits to the home-assistant organization, 17 commits to home-assistant")
 - [Rob Capellini (@capellini)](https://github.com/capellini "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Rob Slifka (@rslifka)](https://github.com/rslifka "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
-- [Robbie Trencheny (@robbiet480)](https://github.com/robbiet480 "1198 total commits to the home-assistant organization, 531 commits to home-assistant-iOS, 255 commits to home-assistant, 247 commits to home-assistant.github.io, 87 commits to homebridge-homeassistant, 15 commits to home-assistant-polymer, 9 commits to hubot-home-assistant, 8 commits to Analytics-Receiver, 6 commits to netdisco, 3 commits to organization, 3 commits to home-assistant-js-websocket, 3 commits to appdaemon, 3 commits to scenegen, 3 commits to home-assistant-js, 3 commits to hassbot, 3 commits to home-assistant-cli, 3 commits to hadashboard, 2 commits to home-assistant-ansible, 2 commits to LabelBot, 2 commits to lambda-home-assistant-github, 2 commits to home-assistant-notebooks, 2 commits to home-assistant-dev-helper, 2 commits to micropython-home-assistant, 2 commits to fabric-home-assistant, 2 commits to home-assistant-assets")
+- [Robbie Trencheny (@robbiet480)](https://github.com/robbiet480 "1223 total commits to the home-assistant organization, 553 commits to home-assistant-iOS, 255 commits to home-assistant, 247 commits to home-assistant.github.io, 90 commits to homebridge-homeassistant, 15 commits to home-assistant-polymer, 9 commits to hubot-home-assistant, 8 commits to Analytics-Receiver, 6 commits to netdisco, 3 commits to hadashboard, 3 commits to hassbot, 3 commits to scenegen, 3 commits to home-assistant-cli, 3 commits to home-assistant-js, 3 commits to appdaemon, 3 commits to home-assistant-js-websocket, 3 commits to organization, 2 commits to home-assistant-ansible, 2 commits to home-assistant-dev-helper, 2 commits to home-assistant-notebooks, 2 commits to lambda-home-assistant-github, 2 commits to fabric-home-assistant, 2 commits to home-assistant-assets, 2 commits to micropython-home-assistant, 2 commits to LabelBot")
 - [Robby Grossman (@freerobby)](https://github.com/freerobby "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Robin (@robmarkcole)](https://github.com/robmarkcole "13 total commits to the home-assistant organization, 8 commits to home-assistant.github.io, 5 commits to home-assistant")
 - [Robin Laurén (@llauren)](https://github.com/llauren "1 total commits to the home-assistant organization, 1 commit to appdaemon")
 - [Roddie Hasan (@eiddor)](https://github.com/eiddor "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io")
 - [Roi Dayan (@roidayan)](https://github.com/roidayan "6 total commits to the home-assistant organization, 6 commits to home-assistant")
+- [roiff (@roiff)](https://github.com/roiff "1 total commits to the home-assistant organization, 1 commit to homebridge-homeassistant")
 - [Ron Klinkien (@cyberjunky)](https://github.com/cyberjunky "5 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to home-assistant")
 - [Ronald Dehuysser (@rdehuyss)](https://github.com/rdehuyss "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [roqeer (@roqeer)](https://github.com/roqeer "3 total commits to the home-assistant organization, 3 commits to home-assistant")
@@ -685,35 +713,39 @@ This page contains a list of people who have contributed in one way or another t
 - [RunOnGitHub (@RunOnGitHub)](https://github.com/RunOnGitHub "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Ruslan Kiianchuk (@zoresvit)](https://github.com/zoresvit "1 total commits to the home-assistant organization, 1 commit to pi-gen")
 - [Russell Cloran (@rcloran)](https://github.com/rcloran "21 total commits to the home-assistant organization, 15 commits to home-assistant, 4 commits to homebridge-homeassistant, 2 commits to home-assistant.github.io")
+- [Ryan Bahm (@rdbahm)](https://github.com/rdbahm "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Ryan Borstelmann (@SlothCroissant)](https://github.com/SlothCroissant "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Ryan Bray (@rbray89)](https://github.com/rbray89 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Ryan Daigle (@rwdaigle)](https://github.com/rwdaigle "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Ryan Kraus (@rmkraus)](https://github.com/rmkraus "195 total commits to the home-assistant organization, 163 commits to home-assistant, 17 commits to home-assistant.github.io, 14 commits to home-assistant-polymer, 1 commit to home-assistant-notebooks")
+- [Ryan McLean (@ryanm101)](https://github.com/ryanm101 "5 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Ryan Parrish (@stickystyle)](https://github.com/stickystyle "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Ryan Turner (@turnrye)](https://github.com/turnrye "6 total commits to the home-assistant organization, 6 commits to home-assistant")
 - [Sabesto (@Sabesto)](https://github.com/Sabesto "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Sacha Telgenhof (@stelgenhof)](https://github.com/stelgenhof "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Sam Birch (@hotplot)](https://github.com/hotplot "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Sam Holmes (@sam3d)](https://github.com/sam3d "4 total commits to the home-assistant organization, 4 commits to pi-gen")
 - [Sam Jongenelen (@SamJongenelen)](https://github.com/SamJongenelen "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Sam Whited (@SamWhited)](https://github.com/SamWhited "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [sam-io (@sam-io)](https://github.com/sam-io "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Samuel Bétrisey (@betrisey)](https://github.com/betrisey "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [sander76 (@sander76)](https://github.com/sander76 "39 total commits to the home-assistant organization, 35 commits to home-assistant, 4 commits to home-assistant.github.io")
+- [sander76 (@sander76)](https://github.com/sander76 "40 total commits to the home-assistant organization, 36 commits to home-assistant, 4 commits to home-assistant.github.io")
+- [Schmackos (@Schmackos)](https://github.com/Schmackos "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [schneefux (@schneefux)](https://github.com/schneefux "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Scott Bradshaw (@swbradshaw)](https://github.com/swbradshaw "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Scott Griffin (@scottocs11)](https://github.com/scottocs11 "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io")
 - [Scott O'Neil (@americanwookie)](https://github.com/americanwookie "7 total commits to the home-assistant organization, 4 commits to home-assistant, 3 commits to home-assistant.github.io")
 - [Scott Reston (@ih8gates)](https://github.com/ih8gates "9 total commits to the home-assistant organization, 8 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
-- [Sean Dague (@sdague)](https://github.com/sdague "62 total commits to the home-assistant organization, 43 commits to home-assistant, 10 commits to home-assistant.github.io, 5 commits to home-assistant-polymer, 3 commits to netdisco, 1 commit to home-assistant-js")
+- [Sean Dague (@sdague)](https://github.com/sdague "64 total commits to the home-assistant organization, 44 commits to home-assistant, 11 commits to home-assistant.github.io, 5 commits to home-assistant-polymer, 3 commits to netdisco, 1 commit to home-assistant-js")
 - [Sean Gollschewsky (@gollo)](https://github.com/gollo "17 total commits to the home-assistant organization, 10 commits to home-assistant, 4 commits to home-assistant.github.io, 3 commits to hassio-build")
 - [Sebastian (@sebk-666)](https://github.com/sebk-666 "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Sebastian  (@sgso)](https://github.com/sgso "3 total commits to the home-assistant organization, 3 commits to libcoap")
-- [Sebastian Muszynski (@syssi)](https://github.com/syssi "21 total commits to the home-assistant organization, 10 commits to home-assistant, 9 commits to home-assistant.github.io, 2 commits to home-assistant-polymer")
+- [Sebastian Muszynski (@syssi)](https://github.com/syssi "32 total commits to the home-assistant organization, 16 commits to home-assistant, 14 commits to home-assistant.github.io, 2 commits to home-assistant-polymer")
 - [Sebastian von Minckwitz (@teodoc)](https://github.com/teodoc "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
-- [Semir Patel (@analogue)](https://github.com/analogue "1 total commits to the home-assistant organization, 1 commit to appdaemon")
+- [Semir Patel (@analogue)](https://github.com/analogue "2 total commits to the home-assistant organization, 2 commits to appdaemon")
-- [Sergey Isachenko (@zabuldon)](https://github.com/zabuldon "7 total commits to the home-assistant organization, 5 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Sergey Isachenko (@zabuldon)](https://github.com/zabuldon "8 total commits to the home-assistant organization, 6 commits to home-assistant, 2 commits to home-assistant.github.io")
-- [sfam (@sfam)](https://github.com/sfam "65 total commits to the home-assistant organization, 58 commits to home-assistant, 5 commits to home-assistant.github.io, 1 commit to netdisco, 1 commit to home-assistant-polymer")
+- [sfam (@sfam)](https://github.com/sfam "65 total commits to the home-assistant organization, 58 commits to home-assistant, 5 commits to home-assistant.github.io, 1 commit to home-assistant-polymer, 1 commit to netdisco")
-- [sharukins (@sharukins)](https://github.com/sharukins "1 total commits to the home-assistant organization, 1 commit to hassio-build")
+- [sharukins (@sharukins)](https://github.com/sharukins "2 total commits to the home-assistant organization, 2 commits to hassio-build")
 - [Shawna O'Neal (@cherrykoda)](https://github.com/cherrykoda "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Shiny (@Br3nda)](https://github.com/Br3nda "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [siebert (@siebert)](https://github.com/siebert "3 total commits to the home-assistant organization, 3 commits to home-assistant")
@@ -726,105 +758,98 @@ This page contains a list of people who have contributed in one way or another t
 - [Stefano Scipioni (@scipioni)](https://github.com/scipioni "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Stephen Edgar (@ntwb)](https://github.com/ntwb "1 total commits to the home-assistant organization, 1 commit to fabric-home-assistant")
 - [Stephen Hoekstra (@shoekstra)](https://github.com/shoekstra "2 total commits to the home-assistant organization, 2 commits to home-assistant")
-- [Steve Rhoades (@steverhoades)](https://github.com/steverhoades "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Steven Looman (@StevenLooman)](https://github.com/StevenLooman "2 total commits to the home-assistant organization, 2 commits to home-assistant")
-- [Steven Webb (@cy1701)](https://github.com/cy1701 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Stu Gott (@stu-gott)](https://github.com/stu-gott "9 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 4 commits to home-assistant")
 - [Stuart Mumford (@Cadair)](https://github.com/Cadair "2 total commits to the home-assistant organization, 2 commits to home-assistant")
-- [Stéphane Bidoul (ACSONE) (@sbidoul)](https://github.com/sbidoul "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [swanwila (@swanwila)](https://github.com/swanwila "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [System Tester (@systemtester)](https://github.com/systemtester "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Sytone (@sytone)](https://github.com/sytone "11 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 2 commits to home-assistant-cli, 2 commits to home-assistant, 1 commit to hassio-build")
 - [Sébastien RAMAGE (@doudz)](https://github.com/doudz "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Sören Oldag (@soldag)](https://github.com/soldag "15 total commits to the home-assistant organization, 8 commits to home-assistant.github.io, 7 commits to home-assistant")
+- [Taylor Peet (@RePeet13)](https://github.com/RePeet13 "8 total commits to the home-assistant organization, 8 commits to home-assistant.github.io")
 - [Teagan Glenn (@Teagan42)](https://github.com/Teagan42 "59 total commits to the home-assistant organization, 49 commits to home-assistant, 9 commits to home-assistant.github.io, 1 commit to home-assistant-js")
 - [Ted Drain (@TD22057)](https://github.com/TD22057 "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [tedstriker (@tedstriker)](https://github.com/tedstriker "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
-- [Teemu Mikkonen (@T3m3z)](https://github.com/T3m3z "5 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Teemu Mikkonen (@T3m3z)](https://github.com/T3m3z "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Teemu Patja (@tpatja)](https://github.com/tpatja "2 total commits to the home-assistant organization, 2 commits to home-assistant")
-- [Teemu R. (@rytilahti)](https://github.com/rytilahti "41 total commits to the home-assistant organization, 32 commits to home-assistant, 7 commits to home-assistant.github.io, 2 commits to netdisco")
+- [Teemu R. (@rytilahti)](https://github.com/rytilahti "42 total commits to the home-assistant organization, 33 commits to home-assistant, 7 commits to home-assistant.github.io, 2 commits to netdisco")
 - [Teguh Sobirin (@tjstyle)](https://github.com/tjstyle "2 total commits to the home-assistant organization, 2 commits to pi-gen")
 - [Tentoe (@Tentoe)](https://github.com/Tentoe "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
-- [Terry Carlin (@terrycarlin)](https://github.com/terrycarlin "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Theb-1 (@Theb-1)](https://github.com/Theb-1 "5 total commits to the home-assistant organization, 5 commits to home-assistant")
 - [thecynic (@thecynic)](https://github.com/thecynic "4 total commits to the home-assistant organization, 4 commits to home-assistant")
 - [Theodor Lindquist (@theolind)](https://github.com/theolind "25 total commits to the home-assistant organization, 25 commits to home-assistant")
-- [Thiago Oliveira (@chilicheech)](https://github.com/chilicheech "5 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Thiago Oliveira (@chilicheech)](https://github.com/chilicheech "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Thibault Cohen (@titilambert)](https://github.com/titilambert "36 total commits to the home-assistant organization, 23 commits to home-assistant, 13 commits to home-assistant.github.io")
-- [Thibault Maekelbergh (@thibmaek)](https://github.com/thibmaek "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to hassio-addons")
+- [Thibault Maekelbergh (@thibmaek)](https://github.com/thibmaek "1 total commits to the home-assistant organization, 1 commit to hassio-addons")
 - [ThinkPadNL (@ThinkPadNL)](https://github.com/ThinkPadNL "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
-- [Thomas (@ktpx)](https://github.com/ktpx "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Thom Troy (@ttroy50)](https://github.com/ttroy50 "6 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 3 commits to home-assistant")
 - [Thomas Friedel (@tfriedel)](https://github.com/tfriedel "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Thomas Petazzoni (@tpetazzoni)](https://github.com/tpetazzoni "1 total commits to the home-assistant organization, 1 commit to libcoap")
 - [Thomas Phillips (@thomas-teknique)](https://github.com/thomas-teknique "2 total commits to the home-assistant organization, 2 commits to pi-gen")
 - [Thomas Purchas (@thomaspurchas)](https://github.com/thomaspurchas "1 total commits to the home-assistant organization, 1 commit to homebridge-homeassistant")
 - [Thomas Pötsch (@thp-comnets)](https://github.com/thp-comnets "7 total commits to the home-assistant organization, 7 commits to libcoap")
-- [Thomas Redmer (@Skorfulose)](https://github.com/Skorfulose "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [thrawnarn (@thrawnarn)](https://github.com/thrawnarn "1 total commits to the home-assistant organization, 1 commit to netdisco")
 - [ThUnD3r|Gr33n (@thundergreen)](https://github.com/thundergreen "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [tijuca (@tijuca)](https://github.com/tijuca "106 total commits to the home-assistant organization, 106 commits to libcoap")
-- [Tim (@tinglis1)](https://github.com/tinglis1 "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
-- [Tim Gray (@tgray)](https://github.com/tgray "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Tim Lyakhovetskiy (@tlyakhov)](https://github.com/tlyakhov "2 total commits to the home-assistant organization, 2 commits to home-assistant")
-- [Tim Wilbrink (@TWilb)](https://github.com/TWilb "14 total commits to the home-assistant organization, 14 commits to home-assistant-iOS")
+- [Tim Wilbrink (@TWilb)](https://github.com/TWilb "15 total commits to the home-assistant organization, 15 commits to home-assistant-iOS")
 - [timstanley1985 (@timstanley1985)](https://github.com/timstanley1985 "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
+- [tleegaard (@tleegaard)](https://github.com/tleegaard "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [Tobie Booth (@tobiebooth)](https://github.com/tobiebooth "4 total commits to the home-assistant organization, 3 commits to home-assistant, 1 commit to home-assistant-polymer")
 - [Toby Gray (@tobygray)](https://github.com/tobygray "3 total commits to the home-assistant organization, 3 commits to home-assistant")
-- [Todd McNeal (@tmcneal)](https://github.com/tmcneal "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [toddeye (@toddeye)](https://github.com/toddeye "20 total commits to the home-assistant organization, 20 commits to home-assistant")
 - [Tom Dickman (@tdickman)](https://github.com/tdickman "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Tom Duijf (@tomduijf)](https://github.com/tomduijf "70 total commits to the home-assistant organization, 53 commits to home-assistant, 9 commits to home-assistant.github.io, 6 commits to home-assistant-polymer, 2 commits to netdisco")
 - [Tom Hoover (@tomhoover)](https://github.com/tomhoover "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
-- [Tom J Nowell (@tomjn)](https://github.com/tomjn "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Tom Matheussen (@Tommatheussen)](https://github.com/Tommatheussen "13 total commits to the home-assistant organization, 6 commits to home-assistant, 4 commits to home-assistant-polymer, 3 commits to home-assistant.github.io")
 - [Tom Usher (@tomusher)](https://github.com/tomusher "1 total commits to the home-assistant organization, 1 commit to netdisco")
+- [Tomi Salmi (@tomppasalmi)](https://github.com/tomppasalmi "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [Tomi Tuhkanen (@ttu)](https://github.com/ttu "3 total commits to the home-assistant organization, 3 commits to home-assistant")
-- [TopdRob (@TopdRob)](https://github.com/TopdRob "3 total commits to the home-assistant organization, 3 commits to home-assistant")
+- [TopdRob (@TopdRob)](https://github.com/TopdRob "4 total commits to the home-assistant organization, 4 commits to home-assistant")
 - [Torkild Retvedt (@torkildr)](https://github.com/torkildr "2 total commits to the home-assistant organization, 2 commits to appdaemon")
 - [Toshik (@Toshik)](https://github.com/Toshik "1 total commits to the home-assistant organization, 1 commit to homebridge-homeassistant")
 - [tradiuz (@tradiuz)](https://github.com/tradiuz "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
 - [trbs (@trbs)](https://github.com/trbs "1 total commits to the home-assistant organization, 1 commit to netdisco")
-- [Trevor (@tboyce021)](https://github.com/tboyce021 "11 total commits to the home-assistant organization, 8 commits to home-assistant, 3 commits to home-assistant.github.io")
+- [Trevor (@tboyce021)](https://github.com/tboyce021 "14 total commits to the home-assistant organization, 10 commits to home-assistant, 4 commits to home-assistant.github.io")
 - [Trey Hunner (@treyhunner)](https://github.com/treyhunner "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
+- [Tristan Caulfield (@Bahnburner)](https://github.com/Bahnburner "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [trollkarlen (@trollkarlen)](https://github.com/trollkarlen "5 total commits to the home-assistant organization, 5 commits to home-assistant")
-- [Tsvi Mostovicz (@tsvi)](https://github.com/tsvi "8 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 4 commits to home-assistant")
+- [Tsvi Mostovicz (@tsvi)](https://github.com/tsvi "9 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 4 commits to home-assistant")
-- [Tyler Crumpton (@tylercrumpton)](https://github.com/tylercrumpton "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Tyler Page (@iamtpage)](https://github.com/iamtpage "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Tõnis Tobre (@tobre6)](https://github.com/tobre6 "1 total commits to the home-assistant organization, 1 commit to homebridge-homeassistant")
+- [Uli (@uehler)](https://github.com/uehler "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [upsert (@upsert)](https://github.com/upsert "1 total commits to the home-assistant organization, 1 commit to netdisco")
+- [User5981 (@User5981)](https://github.com/User5981 "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [Valentin Alexeev (@valentinalexeev)](https://github.com/valentinalexeev "11 total commits to the home-assistant organization, 8 commits to home-assistant, 3 commits to home-assistant.github.io")
-- [Valentin VĂLCIU (@axiac)](https://github.com/axiac "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Viet Dzung (@dzungpv)](https://github.com/dzungpv "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
-- [Vignesh Venkat (@vickyg3)](https://github.com/vickyg3 "6 total commits to the home-assistant organization, 4 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Vignesh Venkat (@vickyg3)](https://github.com/vickyg3 "4 total commits to the home-assistant organization, 4 commits to home-assistant")
 - [viswa-swami (@viswa-swami)](https://github.com/viswa-swami "9 total commits to the home-assistant organization, 9 commits to home-assistant")
-- [Vlad Korniev (@vkorn)](https://github.com/vkorn "5 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io, 1 commit to hassio-build")
+- [Vlad Korniev (@vkorn)](https://github.com/vkorn "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to hassio-build")
 - [vllungu (@vllungu)](https://github.com/vllungu "3 total commits to the home-assistant organization, 3 commits to libcoap")
 - [vrs01 (@vrs01)](https://github.com/vrs01 "20 total commits to the home-assistant organization, 14 commits to home-assistant.github.io, 6 commits to appdaemon")
 - [Wagner Sartori Junior (@trunet)](https://github.com/trunet "1 total commits to the home-assistant organization, 1 commit to netdisco")
 - [Wilco Land (@Wilco89)](https://github.com/Wilco89 "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Will Heid (@bassclarinetl2)](https://github.com/bassclarinetl2 "20 total commits to the home-assistant organization, 19 commits to home-assistant.github.io, 1 commit to fabric-home-assistant")
-- [Will Hughes (@insertjokehere)](https://github.com/insertjokehere "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Will W. (@tiktok7)](https://github.com/tiktok7 "4 total commits to the home-assistant organization, 4 commits to home-assistant")
-- [Will W. (@tiktok7)](https://github.com/tiktok7 "6 total commits to the home-assistant organization, 4 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Willems Davy (@joyrider3774)](https://github.com/joyrider3774 "7 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 3 commits to home-assistant")
 - [William Johansson (@radhus)](https://github.com/radhus "1 total commits to the home-assistant organization, 1 commit to hassio")
-- [William Scanlon (@w1ll1am23)](https://github.com/w1ll1am23 "91 total commits to the home-assistant organization, 62 commits to home-assistant, 27 commits to home-assistant.github.io, 2 commits to netdisco")
+- [William Scanlon (@w1ll1am23)](https://github.com/w1ll1am23 "92 total commits to the home-assistant organization, 63 commits to home-assistant, 27 commits to home-assistant.github.io, 2 commits to netdisco")
+- [williamlehman (@williamlehman)](https://github.com/williamlehman "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [wind-rider (@wind-rider)](https://github.com/wind-rider "5 total commits to the home-assistant organization, 5 commits to home-assistant")
-- [Wojciech Bederski (@wuub)](https://github.com/wuub "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [wokar (@wokar)](https://github.com/wokar "12 total commits to the home-assistant organization, 8 commits to home-assistant, 4 commits to home-assistant.github.io")
 - [Wolf-Bastian Pöttner (@BastianPoe)](https://github.com/BastianPoe "6 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 3 commits to home-assistant")
 - [Wolfgang Malgadey (@wmalgadey)](https://github.com/wmalgadey "4 total commits to the home-assistant organization, 4 commits to home-assistant")
 - [XECDesign (@XECDesign)](https://github.com/XECDesign "97 total commits to the home-assistant organization, 97 commits to pi-gen")
 - [Xorso (@Xorso)](https://github.com/Xorso "22 total commits to the home-assistant organization, 21 commits to home-assistant, 1 commit to hassio-addons")
-- [Yannick POLLART (@ypollart)](https://github.com/ypollart "5 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Yannick POLLART (@ypollart)](https://github.com/ypollart "7 total commits to the home-assistant organization, 4 commits to home-assistant, 3 commits to home-assistant.github.io")
-- [Yannick Simard (@TheRaven)](https://github.com/TheRaven "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Yasin Soliman (@yasinS)](https://github.com/yasinS "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [Yum (@goofz)](https://github.com/goofz "2 total commits to the home-assistant organization, 2 commits to home-assistant")
-- [Zac Hatfield Dodds (@Zac-HD)](https://github.com/Zac-HD "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Zac Hatfield Dodds (@Zac-HD)](https://github.com/Zac-HD "2 total commits to the home-assistant organization, 2 commits to home-assistant")
-- [Zeb Palmer (@zebpalmer)](https://github.com/zebpalmer "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Zen Tormey (@xehn)](https://github.com/xehn "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [Zhao Lu (@zlu)](https://github.com/zlu "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [ziotibia81 (@ziotibia81)](https://github.com/ziotibia81 "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
-- [Zippit (@Zippit)](https://github.com/Zippit "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 
 
 This page is irregularly updated using the [`credits_generator` tool](https://github.com/home-assistant/home-assistant.github.io/tree/next/credits_generator). If you think that you are missing, please let us know.
 
-<i>This page was last updated Saturday, October 21st 2017, 8:19:43 pm UTC.</i>
+<i>This page was last updated Tuesday, October 31st 2017, 7:14:47 pm UTC.</i>

source/developers/documentation/create_page.markdown

@@ -60,11 +60,14 @@ The **Configuration Variables** section must use the {% raw %}`{% configuration
   name:
     description: Name to use in the frontend.
     required: false
+    default: The default name to use in the frontend.
     type: string
 {% endconfiguration %}
 {% endraw %}
 ```
 
+Available keys:
+
 - **`description:`**: That the variable is about.
 - **`required:`**: If the variable is required.
 ```text
@@ -75,6 +78,7 @@ required: exclusive       #=> Exclusive
 required: any string here #=> Any string here
 ```
 - **`type:`**: The type of the variable. Allowed entries: `string`, `int` or `map`. For multiple possibilities use `[string, int]`. If you use `map` then you need to define `keys:` (see the [`template` sensor](/components/sensor.template/) for an example).
+- **`default:`**: The default value for the variable.
 
 ### {% linkable_title Embedding Code %}
 

source/developers/frontend.markdown

@@ -9,7 +9,7 @@ sharing: true
 footer: true
 ---
 
-Home Assistant is built on top of the [Polymer](https://www.polymer-project.org/) webcomponents framework. Polymer allows building encapsulated custom HTML elements. [Home-Assistant-Polymer source code on GitHub.](https://github.com/home-assistant/home-assistant-polymer)
+Home Assistant is built on top of the [Polymer](https://www.polymer-project.org/) webcomponents framework. Polymer allows building encapsulated custom HTML elements. [Home-Assistant-Polymer source code on GitHub.][hass-polymer]
 
 <p class='note warning'>
 Do not use development mode in production. Home Assistant uses aggressive caching to improve the mobile experience. This is disabled during development so that you do not have to restart the server in between changes.
@@ -17,70 +17,81 @@ Do not use development mode in production. Home Assistant uses aggressive cachin
 
 ## {% linkable_title Setting up the environment %}
 
-Home Assistant will by default serve the compiled version of the frontend. As everything is compiled into the file `frontend.html` you do not want to work with the compiled version but with the separate files during development. To enable development mode for Home Assistant, update your `configuration.yaml` to have these lines:
+<p class='note'>
+All commands below need to be run from inside the home-assistant-polymer repository.
+</p>
+
+Home Assistant will by default serve the compiled version of the frontend from the hass_frontend Python package. For development you want to work with the unbundled source files which are in the home-assistant-polymer repository.
+
+First step is to configure Home Assistant to use the development mode for the frontend. Do this by updating the frontend config in your `configuration.yaml` and set the path to the polymer repo:
 
 ```yaml
-http:
+frontend:
-  development: 1
+  development_repo: ../home-assistant-polymer
 ```
 
-Node.js is required to setup the frontend development environment. The preferred method of installing node.js is [nvm](https://github.com/creationix/nvm). Install nvm using the instructions in the [README](https://github.com/creationix/nvm#install-script), and install the correct node.js by running the following command from the `home-assistant` directory:
+Next step is to git clone the [home-assistant-polymer repository][hass-polymer]. You can place the repository anywhere on your system but to keep these instructions simple we're cloning the home-assistant-polymer repository as a sibling to the Home Assistant repo.
 
 ```bash
-$ git submodule update --init
+$ git clone https://github.com/home-assistant/home-assistant-polymer.git
-$ nvm install $(<homeassistant/components/frontend/www_static/home-assistant-polymer/.nvmrc)
+$ cd home-assistant-polymer
+```
+
+After cloning, your folder structure should look like this:
+
+```text
+/home-assistant
+/home-assistant-polymer
+```
+
+Node.js is required to build the frontend. The preferred method of installing node.js is with [nvm](https://github.com/creationix/nvm). Install nvm using the instructions in the [README](https://github.com/creationix/nvm#install-script), and install the correct node.js by running the following command:
+
+```bash
+$ nvm install
 ```
 
 [Yarn](https://yarnpkg.com/en/) is used as the package manager for node modules. [Install yarn using the instructions here.](https://yarnpkg.com/en/docs/install)
 
-Next, development dependencies need to be installed to bootstrap the frontend development environment by running from the `home-assistant` directory:
+Next, development dependencies need to be installed to bootstrap the frontend development environment. First activate the right Node version and then download all the needed modules and do a first build:
 
 ```bash
-$ script/bootstrap_frontend
+$ nvm use
+$ script/bootstrap
 ```
 
-This script will use yarn and bower to install all the necessary dependencies necessary for development in
+This script will use yarn and bower to install all the necessary dependencies necessary for development and do an initial build.
 
-`home-assistant/homeassistant/components/frontend/www_static/home-assistant-polymer`. 
+### {% linkable_title Creating pull requests %}
 
-If you're planning on issuing a PR back to the Home Assistant codebase you need to fork the polymer project and add your fork as a remote.
+If you're planning on issuing a PR back to the Home Assistant codebase you need to fork the polymer project and add your fork as a remote to the Home Assistant Polymer repo.
 
 ```bash
-$ cd homeassistant/components/frontend/www_static/home-assistant-polymer
 $ git remote add <remote name> <github URL to your fork>
 ```
 
 When you've made your changes and are ready to push them change to the working directory for the polymer project and then push your changes
 
 ``` bash
-$ cd homeassistant/components/frontend/www_static/home-assistant-polymer
+$ git add -A
+$ git commit -m "Added new feature X"
 $ git push -u <remote name> HEAD
 ```
 
 ## {% linkable_title Development %}
 
-While you are developing, you need to have Rollup running to have changes you make to the JavaScript app-core made available.
+While you are developing, you need to have gulp running to watch the source files for changes and build when necessary.
 
 ```bash
-$ cd homeassistant/components/frontend/www_static/home-assistant-polymer
+$ yarn run dev-watch
-$ yarn run dev
 ```
 
 The source code for the frontend can be found in two different directories:
 
- - UI: `homeassistant/components/frontend/www_static/home-assistant-polymer/src/`
+ - UI: `/home-assistant-polymer/src/`
- - Panels: `homeassistant/components/frontend/www_static/home-assistant-polymer/panels/`
+ - Panels: `/home-assistant-polymer/panels/`
 
 # {% linkable_title Building the Polymer frontend %}
 
-Building a new version of the frontend is as simple as running `script/build_frontend`. This fires off the following commands:
+Building a new version of the frontend is as simple as running `script/build_frontend`. 
 
- * **home-assistant-polymer**: Install NPM dependencies.
+[hass-polymer]: https://github.com/home-assistant/home-assistant-polymer
- * **home-assistant-polymer**: start frontend build.
-   * Compile all used JavaScript.
-   * Install Bower dependencies.
-   * Vulcanize and minify the core and panel sources to build dir.
- * Copy the webcomponents polyfill `webcomponents-lite.min.js` from **home-assistant-polymer** to `components/frontend/www_static/webcomponents-lite.min.js`.
- * Copy the final frontend build `frontend.html` and panel sources from **home-assistant-polymer** to `components/frontend/www_static/frontend/`.
- * Generate MD5 hashes of core and panel sources.
- * Create gzip versions of all the sources.

source/developers/hassio/addon_communication.markdown

@@ -1,7 +1,7 @@
 ---
 layout: page
 title: "Add-On Communication"
-description: "Describe internal communication Hass.io."
+description: "Description of the internal communication of Hass.io."
 date: 2017-04-30 13:28
 sidebar: true
 comments: false
@@ -10,25 +10,25 @@ footer: true
 redirect_from: /hassio/addon_config/
 ---
 
-It exists diferent ways to communication between add-ons or home-assistant inside Home-Assistant.
+There are different ways to communication between add-ons inside Home Assistant.
 
 ## {% linkable_title Network %}
 
-We use a internal network. That allow to speak with every add-on or from Home-Assistant to add-on by name or alias. Only the a add-on they run on Host network are a bit limited. They can speak with all internal add-ons over there name but all other add-on can't speak with the add-on name to this add-on, but alias work wheel. So use the name/alias to communicate inside Hass.io. The name have format `{REPO}-{SLUG}` i.e. `local-xy` or `3283fh-myaddon`.
+We use a internal network. That allow to speak with every add-on or from Home Assistant to add-on by name or alias. Only the add-ons which runs on the host network are a bit limited. They can speak with all internal add-ons over their name but all other add-on can't address the add-on in question with its name. But using an alias work well. Thus the name/alias is used to communicate inside Hass.io. The name have the following format `{REPO}-{SLUG}`, e.g. `local-xy` or `3283fh-myaddon`.
 
-i.e. use `hassio` to speak with internal API.
+Use `hassio` to speak with the internal API.
 
-## {% linkable_title Home-Assistant %}
+## {% linkable_title Home Assistant %}
 
-A Add-on can speak to [Home-Assistant API][hass-api] with our internal proxy. That make it very easy to speak to this API without you need know the password, port or any other information for the Home-Assistant instance. Use this url: `http://hassio/homeassistant/api` and they will internal redirected to the right place. As next add `homeassistant_api: true` to `config.json`.
+An add-on can speak to the [Home Assistant API][hass-api] with our internal proxy. That makes it very easy to communicate with the API without knowing the password, port or any other information of the Home Assistant instance. Use this URL: `http://hassio/homeassistant/api` and internal communication is redirected to the right place. The next stept is to add `homeassistant_api: true` to `config.json`.
 
-It is also possible to speak direct to Home-Assistant instance with name `homeassistant` over our internal Network. But you need know the running config.
+It is also possible to speak direct to the Home Assistant instance which is named `homeassistant` over our internal network. But you need to know the configuration that is used by the running instance.
 
-We have severals services for Hass.io inside Home-Assistant to execute some task. So you can also use `hassio.addon_stdin` to send data over STDIN to a add-on.
+We have severals services for Hass.io inside Home Assistant to execute tasks. To send data over STDIN to an add-on.l simply use `hassio.addon_stdin`.
 
 ## {% linkable_title Hass.io API %}
 
-To call to our [Hass.io API][hassio-api] add `hassio_api: true` to `config.json`. Now you can use the API over this url: `http://hassio/`.
+To enables calls to the [Hass.io API][hassio-api], add `hassio_api: true` to `config.json`. Now you can use the API over the URL: `http://hassio/`.
 
 [hass-api]: https://home-assistant.io/developers/rest_api/
 [hassio-api]: https://github.com/home-assistant/hassio/blob/master/API.md

source/developers/hassio/addon_publishing.markdown

@@ -30,11 +30,11 @@ All add-ons are simple docker containers. Inside your add-on `config.json` you s
 
 ```json
 {
-  …
+  ...
 
   "image": "myhub/image-{arch}-addon-name",
 
-  …
+  ...
 }
 ```
 
@@ -49,13 +49,13 @@ You need a Docker Hub account to make your own add-ons. You can build your docke
 For a git repository:
 
 ```bash
-docker run --rm --privileged -v ~/.docker:/root/.docker homeassistant/amd64-builder --all -t addon-folder -r https://github.com/xy/addons -b branchname
+$ docker run --rm --privileged -v ~/.docker:/root/.docker homeassistant/amd64-builder --all -t addon-folder -r https://github.com/xy/addons -b branchname
 ```
 
 For a local repository:
 
 ```bash
-docker run --rm --privileged -v ~/.docker:/root/.docker -v /my_addon:/data homeassistant/amd64-builder --all -t /data
+$ docker run --rm --privileged -v ~/.docker:/root/.docker -v /my_addon:/data homeassistant/amd64-builder --all -t /data
 ```
 
 [builder]: https://github.com/home-assistant/hassio-build/tree/master/builder

source/developers/hassio/addon_repository.markdown

@@ -10,17 +10,17 @@ footer: true
 redirect_from: /hassio/addon_repository/
 ---
 
-Add-ons repository can contain one or more add-ons. Each add-on is stored in it's own unique folder. For it to be indentified as a repository, a repository contains a configuration file.
+An Add-on repository can contain one or more add-ons. Each add-on is stored in it's own unique folder. To be indentified as a repository, the repository must contain a configuration file.
 
-[Example add-on repository](https://github.com/home-assistant/hassio-addons-example).
+Check the [Example add-on repository](https://github.com/home-assistant/hassio-addons-example) for further details.
 
-## Installing a repository
+## {% linkable_title Installing a repository %}
 
-A user can add a repository by going to the Hass.io panel in Home Assistant, clicking on the store icon in the top right, copy/paste the URL of your repostory into the repository textarea and click on "Save".
+A user can add a repository by going to the Hass.io panel in Home Assistant, clicking on the store icon in the top right, copy/paste the URL of your repostory into the repository textarea and click on **Save**.
 
-## Repository configuration
+## {% linkable_title Repository configuration %}
 
-Each repository is required to contain `repository.json` at the root of the Git repository.
+Each repository is required to contain `repository.json` at the root in the git repository.
 
 ```json
 {

source/developers/python_api.markdown

@@ -40,7 +40,7 @@ print(remote.get_config(api))
 
 ### {% linkable_title Get details about services, events, and entitites %}
 
-The output from this is similar to the output you'd find via the frontend, using the DevTools console.
+The output from this is similar to the output you'd find via the frontend, using the [Developer Tools](/docs/tools/dev-tools/).
 
 ```python
 import homeassistant.remote as remote
@@ -71,12 +71,11 @@ To get the details of a single entity, use `get_state`:
 import homeassistant.remote as remote
 
 api = remote.API('127.0.0.1', 'YOUR_PASSWORD')
-office_temperature = remote.get_state(api, 'sensor.office_temperature')
+office_temp = remote.get_state(api, 'sensor.office_temperature')
-print('{} is {} {}.'.format(office_temperature.name,
+print('{} is {} {}.'.format(
-                            office_temperature.state,
+    office_temp.name, office_temp.state,
-                            office_temperature.attributes['unit_of_measurement']
+    office_temp.attributes['unit_of_measurement'])
-                            )
+)
-      )
 ```
 
 This outputs the details which are stored for this entity, ie:
@@ -92,10 +91,9 @@ import homeassistant.remote as remote
 
 api = remote.API('127.0.0.1', 'YOUR_PASSWORD')
 switch_livingroom = remote.get_state(api, 'switch.livingroom_pin_2')
-print('{} is {}.'.format(switch_livingroom.name,
+print('{} is {}.'.format(
-                         switch_livingroom.state
+    switch_livingroom.name, switch_livingroom.state)
-                         )
+)
-      )
 ```
 
 ### {% linkable_title Set the state of an entity %}
@@ -184,3 +182,55 @@ data = {"title":"Test", "message":"A simple test message from HA."}
 
 remote.call_service(api, domain, 'jabber', data)
 ```
+
+## {% linkable_title Examples %}
+
+This section contains a couple of sample scripts.
+
+### {% linkable_title List all sensors and their value %}
+
+If you want to see, export or list all sensor states then an easy way to do it, is to get all entities and filter for the one you are looking for. 
+
+```python
+import homeassistant.remote as remote
+
+api = remote.API('127.0.0.1', 'YOUR_PASSWORD')
+entities = remote.get_states(api)
+for entity in entities:
+    if entity.entity_id.startswith('sensor'):
+        data = remote.get_state(api, entity.entity_id)
+        print('{}: {}'.format(data.attributes['friendly_name'], data.state))
+```
+
+### {% linkable_title Show difference between `last_changed` and `last_updated` %}
+
+The documentation about the [State Objects](/docs/configuration/state_object/) describes the 
+`last_changed` and `last_updated` fields. This example shows how it works in practice. 
+
+```python
+import time
+
+from prettytable import PrettyTable
+import homeassistant.remote as remote
+
+api = remote.API('127.0.0.1', 'YOUR_PASSWORD')
+
+ACTIONS = {
+    'Create sensor': [21, 'Test'],
+    'No new sensor value': [21, 'Test'],
+    'New sensor value': [22, 'Test'],
+    'Update attribute': [22, 'Test1'],
+}
+
+output = PrettyTable(['Action', 'Last changed', 'Last updated'])
+
+for key, value in ACTIONS.items():
+    remote.set_state(api, 'sensor.test', new_state=value[0],
+                     attributes={'friendly_name': value[1]})
+    data = remote.get_state(api, 'sensor.test')
+    output.add_row([key, data.last_changed, data.last_updated])
+    time.sleep(2)
+
+print(output)
+```
+

source/developers/rest_api.markdown

@@ -39,7 +39,7 @@ print(response.text)
 ```
 
 <p class='note'>
-You can append `?api_password=YOUR_PASSWORD` to any url to log in automatically.
+You can append `?api_password=YOUR_PASSWORD` to any URL to log in automatically.
 </p>
 
 Successful calls will return status code 200 or 201. Other status codes that can return are:
@@ -74,32 +74,42 @@ Returns the current configuration as JSON.
 
 ```json
 {  
-    "components": [
+   "components":[  
-        "recorder",
+      "sensor.cpuspeed",
-        "http",
-        "weather.openweathermap",
-        "api",
-        "websocket_api",
       "frontend",
-        "sensor.time_date",
+      "config.core",
+      "http",
+      "map",
+      "api",
       "sun",
-        "device_tracker",
+      "config",
+      "discovery",
+      "conversation",
+      "recorder",
       "group",
-        "automation"
+      "sensor",
+      "websocket_api",
+      "automation",
+      "config.automation",
+      "config.customize"
    ],
-    "config_dir": "/home/ha/.homeassistant",
+   "config_dir":"/home/ha/.homeassistant",
-    "elevation": 590,
+   "elevation":510,
-    "latitude": 45.92,
+   "latitude":45.8781529,
-    "location_name": "Home",
+   "location_name":"Home",
-    "longitude": 6.52,
+   "longitude":8.458853651,
-    "time_zone": "Europe/Zurich",
+   "time_zone":"Europe/Zurich",
-    "unit_system": {
+   "unit_system":{  
-        "length": "km",
+      "length":"km",
-        "mass": "g",
+      "mass":"g",
-        "temperature": "\\u00b0C",
+      "temperature":"\u00b0C",
-        "volume": "L"
+      "volume":"L"
    },
-    "version": "0.37.0.dev0"
+   "version":"0.56.2",
+   "whitelist_external_dirs":[  
+      "/home/ha/.homeassistant/www",
+      "/home/ha/.homeassistant/"
+   ]
 }
 ```
 
@@ -115,10 +125,10 @@ Returns basic information about the Home Assistant instance as JSON.
 
 ```json
 {
-    "base_url": "http://127.0.0.1:8123",
+    "base_url": "http://192.168.0.2:8123",
     "location_name": "Home",
     "requires_api_password": true,
-    "version": "0.20.0.dev0"
+    "version": "0.56.2"
 }
 ```
 

source/hassio/installation.markdown

@@ -20,6 +20,10 @@ Hass.io images are available for all available Raspberry Pi and Intel NUC platfo
 - Optional - Setup the WiFi or static IP: On the SD-card, edit the `system-connections/resin-sample` file and follow the [ResinOS howto][resinos-network].
 - Insert SD card to Raspberry Pi and turn it on. On first boot, it downloads the latest version of Home Assistant which takes ~20 minutes (slower/faster depending on the platform).
 
+<p class='note'>
+Please remember to ensure you're using an [appropriate power supply](https://www.raspberrypi.org/help/faqs/#powerReqs) with your Pi. Mobile chargers may not be suitable, since some are designed to only provide the full power with that manufacturer's handsets.
+</p>
+
 <img src='/images/hassio/screenshots/first-start.png' style='clear: right; border:none; box-shadow: none; float: right; margin-bottom: 12px;' width='150' />
 
 - You will be able to reach your installation at [http://hassio.local:8123][local].

source/hassio/zwave.markdown

@@ -1,7 +1,7 @@
 ---
 layout: page
 title: "Z-Wave"
-description: "Instructions on how-to use Z-Wave with Hass.io."
+description: "Instructions on how-to enable Z-Wave with Hass.io."
 date: 2017-04-30 13:28
 sidebar: true
 comments: false
@@ -40,3 +40,7 @@ zha:
   usb_path: /dev/ttyUSB1
   database_path: /config/zigbee.db
 ```
+
+## {% linkable_title Further reading %}
+
+For more information on using Z-Wave, see the [main documentation](/docs/z-wave/).

source/help/index.markdown

@@ -29,6 +29,7 @@ Have you found an issue in your Home Assistant installation? Please report it. R
 
 ### {% linkable_title Videos, talks, workshops and alike %}
 
+- [Home Assistant](https://github.com/home-assistant/home-assistant-assets/tree/master/english/2017-qecampX) at QECampX 2017 - October 2017
 - [Open Source Heimautomation mit Home Assistant](https://github.com/home-assistant/home-assistant-assets/tree/master/german/2017-maker-faire-zurich) at [Mini Maker Faire Zurich 2017](https://www.makerfairezurich.ch/en/) - September 2017
 - [Why we can't have the Internet of Nice Things: A home automation primer](https://www.openwest.org/custom/description.php?id=92) at [OpenWest 2017](https://www.openwest.org) - July 2017
 - [Home Automation with Home Assistant](https://github.com/jjmontesl/talk-hass-pydaygalicia2017) at [PyDay Galicia 2017](https://pyday2017.python-vigo.es/gl/) - June 2017
@@ -47,6 +48,7 @@ Looking for [talking points](/help/talking-points/) or [trivia](/help/trivia)?
 
 Don't miss the regular [Home Assistant podcasts](https://hasspodcast.io/).
 
+- [Using Home Assistant the ARTIK Cloud](https://developer.artik.io/documentation/developer-guide/wireless-iot/hass.html) - September 2017
 - [Control home automation hardware with Home Assistant](http://www.linux-magazine.com/Issues/2017/203/Home-Assistant) - August 2017
 - [Smart Home Home Assistant KNX Alexa Sprachsteuerung](http://onesmarthome.de/smart-home-home-assistant-knx-alexa-sprachsteuerung/) - August 2017
 - [Episode #122: Home Assistant: Pythonic Home Automation](https://talkpython.fm/episodes/show/122/home-assistant-pythonic-home-automation) - July 2017
@@ -55,6 +57,7 @@ Don't miss the regular [Home Assistant podcasts](https://hasspodcast.io/).
 - [Smart Home Home Assistant Raspberry Pi Installation Hassbian](http://onesmarthome.de/smart-home-home-assistant-raspberry-pi-installation-hassbian/) - July 2017
 - [Integrating Snips with Home Assistant](https://medium.com/snips-ai/integrating-snips-with-home-assistant-314723645c77) - June 2017
 - [Jupiter Broadcasting - No Privacy Compromise Home Automation](http://www.jupiterbroadcasting.com/115566/no-privacy-compromise-home-automation/) - June 2017
+- [Monitor IoT devices with Home Assistant and Datadog](https://www.datadoghq.com/blog/monitor-home-assistant/) - June 2017
 - [Castálio Podcast - Episódio 102: Marcelo Mello - Red Hat e Automação Residencial com Home Assistant](https://youtu.be/hZq8ucpzjCs) - May 2017
 - [Paulus Schoutsen and Home Assistant - Episode 8](http://codepop.com/open-sourcecraft/episodes/paulus-schoutsen/) - March 2017
 - [Zammad, Home Assistant und Freifunk - are the winner of the Thomas-Krenn-Awards 2017](https://www.thomas-krenn.com/de/tkmag/allgemein/zammad-home-assistant-und-freifunk-das-sind-die-gewinner-des-thomas-krenn-awards-2017/) - March 2017