Merge pull request #1992 from home-assistant/next

0.38

_config.yml

@@ -131,10 +131,10 @@ social:
 
 # Home Assistant release details
 current_major_version: 0
-current_minor_version: 37
+current_minor_version: 38
-current_patch_version: 1
+current_patch_version: 0
-date_released: 2017-02-02
+date_released: 2017-02-11
 
 # Either # or the anchor link to latest release notes in the blog post.
 # Must be prefixed with a # and have double quotes around it.
-patch_version_notes: "#release-0371---february-2"
+patch_version_notes: "#"

source/_components/alert.markdown

@@ -0,0 +1,95 @@
+---
+layout: page
+title: "Alert"
+description: "Instructions how to setup automatic alerts within Home Assistant."
+date: 2017-01-15 20:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: home-assistant.png
+ha_category: Automation
+ha_release: 0.38
+---
+
+The `alert` component is designed to notify you when problematic issues arise. For example, if the garage door is left open, the `alert` component can be used remind you of this by sending you repeating notifications at customizable intervals. This is also useful for low battery sensors, water leak sensors, or any condition that may need your attention.
+
+Alerts will add an entity to the front end only when they are firing. This entity allows you to silence an alert until it is resolved.
+
+### {% linkable_title Basic Example %}
+
+The `alert` component makes use of any of the `notifications` components. To setup the `alert` component, first, you must setup a `notification` component. Then, add the following to your configuration file:
+
+```yaml
+# Example configuration.yaml entry
+alert:
+  garage_door:
+    name: Garage is open
+    entity_id: input_boolean.garage_door
+    state: 'on'
+    repeat: 30
+    can_acknowledge: True
+    skip_first: True
+    notifiers:
+      - ryans_phone
+      - kristens_phone
+```
+Configuration variables:
+
+- **name** (*Required*): The friendly name of the alert.
+- **entity_id** (*Required*): The ID of the entity to watch.
+- **state** (*Optional*): The problem condition for the entity. Defaults to `on`.
+- **repeat** (*Required*): Number of minutes before the notification should be repeated. Can be either a number or a list of numbers.
+- **can_acknowledge** (*Optional*): Allows the alert to be unacknowledgable. Defaults to `true`.
+- **skip_first** (*Optional*): Controls whether the notification should be sent immediately or after the first delay. Defaults to `false`.
+- **notifiers** (*Required*): List of `notification` components to use for alerts.
+
+In this example, the garage door status (`input_boolean.garage_door`) is watched and this alert will be triggered when its status is equal to `on`. This indicates that the door has been opened. Because the `skip_first` option was set to `True`, the first notification will not be delivered immediately. However, every 30 minutes, a notification will be delivered until either `input_boolean.garage_door` no longer has a state of `on` or until the alert is acknowledged using the Home Assistant frontend.
+
+### {% linkable_title Complex Alert Criteria %}
+
+By design, the `alert` component only handles very simple criteria for firing. That is, is only checks if a single entity's state is equal to a value. At some point, it may be desireable to have an alert with a more complex criteria. Possibly, when a battery percentage falls below a threshold. Maybe you want to disable the alert on certain days. Maybe the alert firing should depend on more than one input. For all of these situations, it is best to use the alert in conjunction with a `Template Binary Sensor`. The following example does that.
+
+```yaml
+binary_sensor:
+  - platform: template
+    sensors:
+      motion_battery_low:
+        value_template: {% raw %}'{{ states.sensor.motion.attributes.battery < 15 }}'{% endraw %}
+        friendly_name: 'Motion battery is low'
+
+alert:
+  motion_battery:
+    - name: Motion Battery is Low
+      entity_id: binary_sensor.motion_battery_low
+      repeat: 30
+      notifiers:
+        - ryans_phone
+        - kristens_phone
+```
+
+This example will begin firing as soon as the entity `sensor.motion`'s `battery` attribute falls below 15. It will continue to fire until the battery attribute raises above 15 or the alert is acknowledged on the frontend.
+
+### {% linkable_title Dynamic Notification Delay Times %}
+
+It may be desireable to have the delays between alert notifications dynamically change as the alert continues to fire. This can be done by setting the `repeat` configuration key to a list of numbers rather than a single number. Altering the first example would look like the following.
+
+```yaml
+# Example configuration.yaml entry
+alert:
+  garage_door:
+    name: Garage is open
+    entity_id: input_boolean.garage_door
+    state: 'on'   # Optional, 'on' is the default value
+    repeat:
+      - 15
+      - 30
+      - 60
+    can_acknowledge: True  # Optional, default is True
+    skip_first: True  # Optional, false is the default
+    notifiers:
+      - ryans_phone
+      - kristens_phone
+```
+
+Now, the first message will be sent after a 15 minute delay. The second will be sent after a 30 minute delay. A 60 minute delay will fall between every following notification.

source/_components/alexa.markdown

@@ -158,9 +158,11 @@ alexa:
           {%- for state in states.device_tracker -%}
             {%- if state.name.lower() == User.lower() -%}
               {{ state.name }} is at {{ state.state }}
+            {%- elif loop.last -%}
+              I am sorry, I do not know where {{ User }} is.
             {%- endif -%}
           {%- else -%}
-            I am sorry, I do not know where {{ User }} is.
+            Sorry, I don't have any trackers registered.
           {%- endfor -%}
       card:
         type: simple

source/_components/binary_sensor.ffmpeg_motion.markdown

@@ -1,7 +1,7 @@
 ---
 layout: page
-title: "FFmpeg Binary Sensor"
+title: "FFmpeg Motion Binary Sensor"
-description: "Instructions on how to integrate an FFmpeg-based binary sensor"
+description: "Instructions on how to integrate an FFmpeg-based motion binary sensor"
 date: 2016-08-25 08:00
 sidebar: true
 comments: false
@@ -10,45 +10,16 @@ footer: true
 logo: ffmpeg.png
 ha_category: Binary Sensor
 ha_release: 0.27
-ha_iot_class: "Local Polling"
+redirect_from: /components/binary_sensor.ffmpeg/
 ---
 
 
-The `ffmpeg` platform allows you to use any video or audio feed with [FFmpeg](http://www.ffmpeg.org/) for various sensors in Home Assistant. Available are: **noise**, **motion**. 
+The `ffmpeg` platform allows you to use any video feed with [FFmpeg](http://www.ffmpeg.org/) for motion sensors in Home Assistant.
 
 <p class='note'>
-If the `ffmpeg` process is broken, the sensor will be unavailable. To controll the ffmpeg process of sensor, use the service *binary_sensor.ffmpeg_start*, *binary_sensor.ffmpeg_stop*, *binary_sensor.ffmpeg_restart*.
+If the `ffmpeg` process is broken, the sensor will be unavailable. To controll the ffmpeg process of sensor, use the service *ffmpeg.start*, *ffmpeg.stop*, *ffmpeg.restart*.
 </p>
 
-### {% linkable_title Noise %}
-
-To add FFmpeg with noise detection to your installation, add the following to your `configuration.yaml` file:
-
-```yaml
-# Example configuration.yaml entry
-binary_sensor:
-  - platform: ffmpeg
-    tool: noise
-```
-
-Configuration variables:
-
-- **input** (*Required*): An FFmpeg-compatible input file, stream, or feed.
-- **tool** (*Required*): `noise`.
-- **name** (*Optional*): Override the name of your camera.
-- **initial_state** (*Optional*): Default true. Start ffmpeg with home-assistant.
-- **peak** (*Optional*): Default -30. The threshold of detecting noise, in dB. 0 is very loud and -100 is low.
-- **duration** (*Optional*): Default 1 second. How long the noise needs to be over the peak to trigger the state.
-- **reset** (*Optional*): Default 20 seconds. The time to reset the state after no new noise is over the peak.
-- **extra_arguments** (*Optional*): Extra options to pass to `ffmpeg`, like audio frequency filtering.
-- **output** (*Optional*): Allows you to send the audio output of this sensor to an Icecast server or other FFmpeg-supported output, e.g. to stream with Sonos after a state is triggered.
-
-To experiment with values:
-
-```bash
-$ ffmpeg -i YOUR_INPUT -vn -filter:a silencedetect=n=-30dB:d=1 -f null -
-```
-
 ### {% linkable_title Motion %}
 
 FFmpeg doesn't have a motion detection filter, but can use a scene filter to detect a new scene/motion. You can set how much needs to change in order to detect motion with the option 'changes', the percent value of change between frames. If you want a really small value for 'changes', you can also add a denoise filter.
@@ -59,14 +30,12 @@ To add FFmpeg with motion detection to your installation, add the following to y
 # Example configuration.yaml entry
 binary_sensor:
   - platform: ffmpeg
-    tool: motion
     input: FFMPEG_SUPPORTED_INPUT
 ```
 
 Configuration variables:
 
 - **input** (*Required*): An FFmpeg-compatible input file, stream, or feed.
-- **tool** (*Required*): `motion`.
 - **name** (*Optional*): Override the name of your camera for the frontend.
 - **initial_state** (*Optional*): Start `ffmpeg` with Home Assistant. Defaults to `true`.
 - **changes** (*Optional*): How much needs to change between two frames to detect it as motion (a lower value is more sensitive). Defaults to 10%.

source/_components/binary_sensor.ffmpeg_noise.markdown

@@ -0,0 +1,48 @@
+---
+layout: page
+title: "FFmpeg Noise Binary Sensor"
+description: "Instructions on how to integrate an FFmpeg-based noise binary sensor"
+date: 2016-08-25 08:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: ffmpeg.png
+ha_category: Binary Sensor
+ha_release: 0.27
+---
+
+
+The `ffmpeg` platform allows you to use any video or audio feed with [FFmpeg](http://www.ffmpeg.org/) for various sensors in Home Assistant.
+
+<p class='note'>
+If the `ffmpeg` process is broken, the sensor will be unavailable. To controll the ffmpeg process of sensor, use the service *ffmpeg.start*, *ffmpeg.stop*, *ffmpeg.restart*.
+</p>
+
+### {% linkable_title Noise %}
+
+To add FFmpeg with noise detection to your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+binary_sensor:
+  - platform: ffmpeg
+    input: FFMPEG_SUPPORTED_INPUT
+```
+
+Configuration variables:
+
+- **input** (*Required*): An FFmpeg-compatible input file, stream, or feed.
+- **name** (*Optional*): Override the name of your camera.
+- **initial_state** (*Optional*): Default true. Start ffmpeg with home-assistant.
+- **peak** (*Optional*): Default -30. The threshold of detecting noise, in dB. 0 is very loud and -100 is low.
+- **duration** (*Optional*): Default 1 second. How long the noise needs to be over the peak to trigger the state.
+- **reset** (*Optional*): Default 20 seconds. The time to reset the state after no new noise is over the peak.
+- **extra_arguments** (*Optional*): Extra options to pass to `ffmpeg`, like audio frequency filtering.
+- **output** (*Optional*): Allows you to send the audio output of this sensor to an Icecast server or other FFmpeg-supported output, e.g. to stream with Sonos after a state is triggered.
+
+To experiment with values:
+
+```bash
+$ ffmpeg -i YOUR_INPUT -vn -filter:a silencedetect=n=-30dB:d=1 -f null -
+```

source/_components/binary_sensor.mysensors.markdown

@@ -86,4 +86,4 @@ void loop()
 ```
 
 [main component]: /components/mysensors/
-[serial api]: https://www.mysensors.org/download/serial_api_15
+[serial api]: http://www.mysensors.org/download

source/_components/climate.ecobee.markdown

@@ -21,23 +21,45 @@ To get your Ecobee thermostats working with Home Assistant, follow the instructi
 
 The Ecobee Thermostat supports the following key concepts.
 
-The _target temperature_ is the temperature that the device attempts to achieve. The target temperature is either determined by the
+The _target temperature_ is the temperature that the device attempts
-currently active climate or it may be overridden by a hold. When the thermostat is not in auto mode, there is a single target temperature. When the thermostat is in auto operation mode, there is a pair of target temperatures: the lower target temperature determines the lowest desired temperature, while the higher target temperature determines the highest desired temperature (the thermostat will switch between heating and cooling to keep the temperature within these limits).
+to achieve. The target temperature is either determined by the
+currently active climate or it may be overridden by a hold. When the
+thermostat is not in auto mode, there is a single target
+temperature. When the thermostat is in auto operation mode, there is a
+pair of target temperatures: the lower target temperature determines
+the lowest desired temperature, while the higher target temperature
+determines the highest desired temperature (the thermostat will switch
+between heating and cooling to keep the temperature within these
+limits).
 
-A _climate_ is a predefined or user-defined set of states that the thermostat aims to achieve. The ecobee thermostat provides three predefined climates: home, away, and sleep. The user can define additional climates.
+A _climate_ is a predefined or user-defined set of states that the
+thermostat aims to achieve. The ecobee thermostat provides three predefined
+climates: home, away, and sleep. The user can define additional climates.
 
-A _hold_ is an override of the target temperature defined in the currently active climate. The temperature targeted in the hold mode may be explicitly set (temperature hold) or it may be derived from a reference climate (home or away hold). All holds are temporary. Temperature and climate holds expire when the thermostat transitions to the next climate defined in its program.
+A _hold_ is an override of the target temperature defined in the
+currently active climate. The temperature targeted in the hold mode may be
+explicitly set (temperature hold) or it may be derived from a reference
+climate (home or away hold). All holds are temporary. Temperature and
+climate holds expire when the thermostat transitions to the next climate
+defined in its program.
 
-When in _away mode_, the target temperature is permanently overridden by the target temperature defined for the away climate. The away mode is a simple way to emulate a vacation mode.
+When in _away mode_, the target temperature is permanently overridden by
+the target temperature defined for the away climate. The away mode is a
+simple way to emulate a vacation mode.
 
-The _operation mode_ of the device is the currently active operational modes that the Ecobee thermostat provides: heat, auxHeatOnly, cool, auto, and off.
+The _operation mode_ of the device is the currently active operational
+modes that the Ecobee thermostat provides: heat, auxHeatOnly, cool,
+auto, and off.
 
  
 ## {% linkable_title Attributes %}
 
 The following attributes are provided by the Ecobee Thermostat:
-`name`, `temperature_unit`, `current_temperature`, `target_temperature`, `target_temperature_low`, `target_temperature_high`, `desired_fan_mode`, `fan`, `current_hold_mode`, `current_operation`, `operation_list`,`operation_mode`, `mode`, `fan_min_on_time`, `device_state_attributes`, `is_away_mode_on`.
+`name`, `temperature_unit`, `current_temperature`, `target_temperature`, 
-
+`target_temperature_low`, `target_temperature_high`, `desired_fan_mode`, 
+`fan`, `current_hold_mode`, `current_operation`, `operation_list`,
+`operation_mode`, `mode`, `fan_min_on_time`, `device_state_attributes`, 
+`is_away_mode_on`.
 The attributes `min_temp` and `max_temp` are meaningless constant values.
 
 
@@ -47,7 +69,7 @@ Returns the name of the Ecobee Thermostat.
 
 | Attribute type | Description |
 | ---------------| ----------- |
-| String | Name of the Ecobee Thermostat |
+| String | Name of the Ecobee Thermostat
 
 ### {% linkable_title Attribute `temperature_unit` %}
 
@@ -55,7 +77,7 @@ Returns the unit of measurement used for temperature by the thermostat.
 
 | Attribute type | Description |
 | ---------------| ----------- |
-| String | Name of the temperature unit |
+| String | Name of the temperature unit
 
 ### {% linkable_title Attribute `current_temperature` %}
 
@@ -63,7 +85,7 @@ Returns the current temperature measured by the thermostat.
 
 | Attribute type | Description |
 | ---------------| ----------- |
-| Integer | Currenly measured temperature |
+| Integer | Currenly measured temperature
 
 ### {% linkable_title Attribute `target_temperature` %}
 
@@ -72,7 +94,7 @@ not in auto operation mode.
 
 | Attribute type | Description |
 | ---------------| ----------- |
-| Integer | Target temperature |
+| Integer | Target temperature
 
 ### {% linkable_title Attribute `target_temperature_low` %}
 
@@ -81,7 +103,7 @@ auto operation mode.
 
 | Attribute type | Description |
 | ---------------| ----------- |
-| Integer | Target temperature |
+| Integer | Target temperature
 
 ### {% linkable_title Attribute `target_temperature_high` %}
 
@@ -90,7 +112,7 @@ auto operation mode.
 
 | Attribute type | Description |
 | ---------------| ----------- |
-| Integer | Target temperature |
+| Integer | Target temperature
 
 ### {% linkable_title Attribute `desired_fan_mode` %}
 
@@ -98,7 +120,7 @@ Returns the desired fan mode of the current operation.
 
 | Attribute type | Description |
 | ---------------| ----------- |
-| String         | 'on', 'off' |
+| String | 'on', 'off'
 
 ### {% linkable_title Attribute `fan` %}
 
@@ -106,7 +128,7 @@ Returns the current fan state.
 
 | Attribute type | Description |
 | ---------------| ----------- |
-| String         | 'on', 'off' |
+| String | 'on', 'off'
 
 ### {% linkable_title Attribute `current_hold_mode` %}
 
@@ -114,7 +136,7 @@ Returns the current temperature hold, if any.
 
 | Attribute type | Description |
 | ---------------| ----------- |
-| String | 'home', 'away', 'temp', None |
+| String | 'home', 'away', 'temp', None
 
 ### {% linkable_title Attribute `current_operation` %}
 
@@ -122,7 +144,7 @@ Returns the current operation of the thermostat.
 
 | Attribute type | Description |
 | ---------------| ----------- |
-| String | 'auto', 'cool', 'heat', 'off' |
+| String | 'auto', 'cool', 'heat', 'off'
 
 ### {% linkable_title Attribute `operation_list` %}
 
@@ -130,7 +152,7 @@ Returns the list of available operation modes.
 
 | Attribute type | Description |
 | ---------------| ----------- |
-| List of String | Available operation modes |
+| List of String | Available operation modes
 
 ### {% linkable_title Attribute `operation_mode` %}
 
@@ -138,7 +160,7 @@ Returns the current operation mode of the thermostat.
 
 | Attribute type | Description |
 | ---------------| ----------- |
-| String | Currently active operation mode |
+| String | Currently active operation mode
 
 ### {% linkable_title Attribute `mode` %}
 
@@ -150,11 +172,12 @@ Returns the current fan mimimum on time.
 
 | Attribute type | Description |
 | ---------------| ----------- |
-| Integer | Current fan minimum on time in minutes |
+| Integer | Current fan minimum on time in minutes
 
 ### {% linkable_title Attribute `is_away_mode_on` %}
 
-Returns whether the thermostat is in away mode (see the corresponding service for more detail).
+Returns whether the thermostat is in away mode (see the corresponding
+service for more detail).
 
 ### {% linkable_title Attribute `actual humidity` %}
 
@@ -162,15 +185,17 @@ Returns the humidity as measured by the thermostat.
 
 | Attribute type | Description |
 | ---------------| ----------- |
-| Integer | Current humidity |
+| Integer | Current humidity
 
 
 ## {% linkable_title Services %}
 
 The following services are provided by the Ecobee Thermostat:
-`set_away_mode`, `set_hold_mode`, `set_temperature`, `set_operation_mode`, `fan_min_on_time`, `resume_program`.
+`set_away_mode`, `set_hold_mode`, `set_temperature`, `set_operation_mode`, 
-
+`fan_min_on_time`, `resume_program`.
-The services `set_aux_heat`, `set_humidity`, `set_fan_mode`, and `set_swing_mode` offered by the [Climate component](/components/climate/) are not implemented for this thermostat.
+The services `set_aux_heat`, `set_humidity`, `set_fan_mode`, and
+`set_swing_mode` offered by the [Climate component](/components/climate/)
+are not implemented for this thermostat.
 
 
 
@@ -180,18 +205,21 @@ Turns the away mode on or off for the thermostat.
 
 | Service data attribute | Optional | Description |
 | ---------------------- | -------- | ----------- |
-| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all. |
+| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all.
-| `away_mode` | no | 'on' or 'off' |
+| `away_mode` | no | 'on' or 'off'
 
 
 ### {% linkable_title Service `set_hold_mode` %}
 
-Puts the thermostat into the given hold mode. For 'home' and 'away', the target temperature is taken from the home or away, climate, respectively. For 'temp', the current temperature is taken as the target temperature. When None is provided as parameter, the hold_mode is turned off.
+Puts the thermostat into the given hold mode. For 'home' and 'away', the
+target temperature is taken from the home or away, climate, respectively.
+For 'temp', the current temperature is taken as the target temperature.
+When None is provided as parameter, the hold_mode is turned off.
 
 | Service data attribute | Optional | Description |
 | ---------------------- | -------- | ----------- |
-| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all. |
+| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all.
-| `hold_mode` | no | 'home', 'away', 'temp', None |
+| `hold_mode` | no | 'home', 'away', 'temp', None
 
 ### {% linkable_title Service `set_temperature` %}
 
@@ -200,11 +228,12 @@ Puts the thermostat into a temporary hold at the given temperature.
 | Service data attribute | Optional | Description |
 | ---------------------- | -------- | ----------- |
 | `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all.
-| `target_temp_low` | no | Desired heating target temperature (when in auto mode) |
+| `target_temp_low` | no | Desired heating target temperature (when in auto mode)
-| `target_temp_high` | no | Desired cooling target temperature (when in auto mode) |
+| `target_temp_high` | no | Desired cooling target temperature (when in auto mode)
-| `temperature` | no | Desired target temperature (when not in auto mode) |
+| `temperature` | no | Desired target temperature (when not in auto mode)
 
-Only the target temperatures relevant for the current operation mode need to be provided.
+Only the target temperatures relevant for the current operation mode need to
+be provided.
 
 ### {% linkable_title Service `set_operation_mode` %}
 
@@ -212,8 +241,8 @@ Sets the current operation mode of the thermostat.
 
 | Service data attribute | Optional | Description |
 | ---------------------- | -------- | ----------- |
-| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all. |
+| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all.
-| `operation_mode` | no | 'auto', 'auxHeatOnly', 'cool', 'heat', 'off' |
+| `operation_mode` | no | 'auto', 'auxHeatOnly', 'cool', 'heat', 'off'
 
 ### {% linkable_title Service `fan_min_on_time` %}
 
@@ -221,8 +250,8 @@ Sets the fan minimum on time.
 
 | Service data attribute | Optional | Description |
 | ---------------------- | -------- | ----------- |
-| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all. |
+| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all.
-| `fan_min_on_time` | no | Desired fan minimum on time |
+| `fan_min_on_time` | no | Desired fan minimum on time
 
 ### {% linkable_title Service `resume_program` %}
 
@@ -230,5 +259,5 @@ Resumes the currently active schedule.
 
 | Service data attribute | Optional | Description |
 | ---------------------- | -------- | ----------- |
-| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all. |
+| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all.
-| `resume_all` | no | true or false |
+| `resume_all` | no | true or false

source/_components/climate.markdown

@@ -23,7 +23,7 @@ climate:
 ## {% linkable_title Services %}
 
 ### {% linkable_title Climate control services %}
-Available services: `climate.set_aux_heat`, `climate.set_away_mode`, `climate.set_temperature`, `climate.set_humidity`, `climate.set_fan_mode`, `climate.set_operation_mode`, `climate.set_swing_mode`
+Available services: `climate.set_aux_heat`, `climate.set_away_mode`, `climate.set_temperature`, `climate.set_humidity`, `climate.set_fan_mode`, `climate.set_operation_mode`, `climate.set_swing_mode`, `climate.set_hold_mode`
 
 <p class='note'>
 Not all climate services may be available for your platform. Be sure to check the available services Home Assistant has enabled by checking <img src='/images/screenshots/developer-tool-services-icon.png' alt='service developer tool icon' class="no-shadow" height="38" /> **Services**.
@@ -54,12 +54,36 @@ automation:
 
 ### {% linkable_title Service `climate.set_away_mode` %}
 
-This service has been deprecated. Use `climate.set_hold_mode` instead.
+Set away mode for climate device. The away mode changes the target temperature permanently to a temperature 
+reflecting a situation where the climate device is set to save energy. This may be used to emulate a
+"vacation mode", for example.
+
+| Service data attribute | Optional | Description |
+| ---------------------- | -------- | ----------- |
+| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all.
+| `away_mode` | no | New value of away mode.
+
+#### {% linkable_title Automation example  %}
+
+```yaml
+automation:
+  trigger:
+    platform: time
+    after: "07:15:00"
+  action:
+    - service: climate.set_away_mode
+      data:
+        entity_id: climate.kitchen
+        away_mode: 'on'
+```
 
 
 ### {% linkable_title Service `climate.set_hold_mode` %}
 
-Set hold mode for climate device
+Set hold mode for climate device. The hold mode changes the target temperature of the client device temporarily to
+a different temperature. Typical hold modes provided by a climate device are "away" or "home", where the hold temperature
+is chosen depending on a predefined climate, or "temperature" hold, where a particular temperature is selected as the
+temporary target temperature. The particular modes available depend on the climate device.
 
 | Service data attribute | Optional | Description |
 | ---------------------- | -------- | ----------- |

source/_components/climate.mysensors.markdown

@@ -116,4 +116,4 @@ void incomingMessage(const MyMessage &message) {
 ```
 
 [main component]: /components/mysensors/
-[serial api]: https://www.mysensors.org/download/serial_api_15
+[serial api]: http://www.mysensors.org/download

source/_components/device_tracker.mysensors.markdown

@@ -0,0 +1,105 @@
+---
+layout: page
+title: "MySensors Device Tracker"
+description: "Instructions how to use MySensors to track devices in Home Assistant."
+date: 2017-02-06 15:00 +0100
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: mysensors.png
+ha_category: Presence Detection
+featured: false
+ha_release: "0.38"
+ha_iot_class: "Local Push"
+---
+
+Integrates MySensors device trackers into Home Assistant. See the [main component] for configuration instructions.
+
+The following sensor types are supported:
+
+##### MySensors version 2.0 and higher
+
+S_TYPE             | V_TYPE
+-------------------|---------------------------------------
+S_GPS             | V_POSITION
+
+For more information, visit the [serial api] of MySensors.
+
+### {% linkable_title MySensors 2.x example sketch %}
+
+```cpp
+/**
+ * Documentation: http://www.mysensors.org
+ * Support Forum: http://forum.mysensors.org
+ *
+ * http://www.mysensors.org/build/gps
+ */
+
+// Enable debug prints to serial monitor
+#define MY_DEBUG
+// Enable and select radio type attached
+#define MY_RADIO_NRF24
+//#define MY_RADIO_RFM69
+
+#include <MySensors.h>
+
+#define SN "GPS Sensor"
+#define SV "1.0"
+
+// GPS position send interval (in millisectonds)
+#define GPS_SEND_INTERVAL 30000
+// The child id used for the gps sensor
+#define CHILD_ID_GPS 1
+
+MyMessage msg(CHILD_ID_GPS, V_POSITION);
+
+// Last time GPS position was sent to controller
+unsigned long lastGPSSent = -31000;
+
+// Some buffers
+char latBuf[11];
+char lngBuf[11];
+char altBuf[6];
+char payload[30];
+
+// Dummy values. Implementation of real GPS device is not done.
+float gpsLocationLat = 40.741895;
+float gpsLocationLng = -73.989308;
+float gpsAltitudeMeters = 12.0;
+
+void setup() {
+
+}
+
+void presentation() {
+  sendSketchInfo(SN, SV);
+  present(CHILD_ID_GPS, S_GPS);
+}
+
+void loop()
+{
+  unsigned long currentTime = millis();
+
+  // Evaluate if it is time to send a new position
+  bool timeToSend = currentTime - lastGPSSent > GPS_SEND_INTERVAL;
+
+  if (timeToSend) {
+    // Send current gps location
+    // Build position and altitude string to send
+    dtostrf(gpsLocationLat, 1, 6, latBuf);
+    dtostrf(gpsLocationLng, 1, 6, lngBuf);
+    dtostrf(gpsAltitudeMeters, 1, 0, altBuf);
+    sprintf(payload, "%s,%s,%s", latBuf, lngBuf, altBuf);
+
+    Serial.print(F("Position: "));
+    Serial.println(payload);
+
+    send(msg.set(payload));
+    lastGPSSent = currentTime;
+  }
+}
+```
+
+[main component]: /components/mysensors/
+[serial api]: http://www.mysensors.org/download

source/_components/device_tracker.snmp.markdown

@@ -29,6 +29,7 @@ OID examples:
 - pfSense: `1.3.6.1.2.1.4.22.1.2` (tested on 2.2.4-RELEASE, need to enable SNMP service)
 - TPLink: `1.3.6.1.2.1.3.1.1.2.19.1` (Archer VR2600v, need to enable SNMP service)
 - EdgeRouter `1.3.6.1.2.1.4.22.1.2` (EdgeRouter Lite v1.9.0, need to enable SNMP service)
+- Ruckus: `1.3.6.1.4.1.25053.1.2.2.1.1.3.1.1.1.6` (Ruckus ZoneDirector, tested on 9.13.3)
 
 To use the SNMP version 1 platform in your installation, add the following to your `configuration.yaml` file:
 

source/_components/ha.markdown

@@ -1,6 +1,6 @@
 ---
 layout: page
-title: "Home Assistant 0.37"
+title: "Home Assistant 0.38"
 description: ""
 date: 2016-12-16 17:00
 sidebar: true
@@ -9,7 +9,7 @@ sharing: true
 footer: true
 logo: home-assistant.png
 ha_category: Other
-ha_release: 0.37
+ha_release: 0.38
 ---
 
 Details about the latest release can always be found at:

source/_components/hdmi_cec.markdown

@@ -46,6 +46,13 @@ For the default virtual environment of a [Raspberry Pi All-In-One installation](
 $ ln -s /usr/local/lib/python3.4/site-packages/cec /srv/homeassistant/homeassistant_venv/lib/python3.4/site-packages
 ```
 
+For the default virtual environment of a [Manual installation](/getting-started/installation-raspberry-pi/) the command would be as follows.
+
+```bash
+$ ln -s /usr/local/lib/python3.4/site-packages/cec /srv/hass/hass_venv/lib/python3.4/site-packages
+```
+
+
 <p class='note'>If after symlinking and adding `hdmi_cec:` to your configuration you are getting the following error in your logs, 
 `* failed to open vchiq instance` you will also need to add the user account Home Assistant runs under, to the `video` group. To add the Home Assistant user account to the `video` group, run the following command. `$ usermod -a -G video <hass_user_account>`
 </p>

source/_components/homematic.markdown

@@ -47,7 +47,7 @@ Configuration variables (host):
 - **username** (*Optional*): When fetching names via JSON-RPC, you need to specify a user with guest-access to the CCU.
 - **password** (*Optional*): When fetching names via JSON-RPC, you need to specify the password of the user you have configured above.
 - **primary** (*Optional*): Set to `true` when using multiple hosts and this host should provide the services and variables.
-- **variables** (*Optional*): Set to `true` if you want to use CCU2/Homegear variables. Should only be enabled for the primary host.
+- **variables** (*Optional*): Set to `true` if you want to use CCU2/Homegear variables. Should only be enabled for the primary host. When using a CCU credentials are required.
 
 #### Example configuration with multiple protocols and some other options set:
 
@@ -73,7 +73,7 @@ homematic:
       port: 2010
 ```
 
-### The `resolvenames` option
+### {% linkable_title The `resolvenames` option %}
 
 We use three approaches to fetch the names of devices. Each assumes you have properly named your devices in your existing Homematic setup. As a general advice: Use ASCII for your devices names. Home Assistant won't include non-ASCII characters in entity-names.
 
@@ -83,26 +83,40 @@ We use three approaches to fetch the names of devices. Each assumes you have pro
 
 Resolving names can take some time. So when you start Home Assistant you won't see you devices at first. For a setup with 20+ devices it can take up to a minute until all devices show up in the UI.
 
-### Multiple hosts
+### {% linkable_title Multiple hosts %}
 
 In order to allow communication with multiple hosts or different protocols in parallel (wireless, wired and ip), multiple connections will be established, each to the configured destination. The name you choose for the host has to be unique and limited to ASCII letters.  
 Using multiple hosts has the drawback, that the services (explained below) may not work as expected. Only one connection can be used for services, which limits the devices/variables a service can use to the scope/protocol of the host.  
 This does *not* affect the entites in Home Assistant. They all use their own connection and work as expected.
 
-### Variables
+### {% linkable_title Reading attributes of entities %}
 
-It is possible to read and set values of system variables you have setup on the CCU/Homegear. An example of how that is done can be found below. The supported types for setting values are float- and bool-variables.  
+Most devices have, besides their state, additional attributes like their battery state or valve position. These can be accessed using templates in automations, or even as their own entities using the [template sensor](https://home-assistant.io/components/sensor.template/) component. Here's an example of a template sensor that exposes the valve state of a thermostat.
-Each variable will be available as it's own entity in the form of `homematic.name`. The predefined `homematic.homematic` variable has the number of service messages as it's value. You can use these variable-entities like any other entity in Home Assistant to trigger automations.  
+
+```yaml
+sensor:
+- platform: template
+  sensors:
+    bedroom_valve:
+      value_template: '{% raw %}{{ states.climate.leq123456.attributes.Valve }}{% endraw %}'
+      entity_id: climate.leq123456
+      friendly_name: 'Bedroom valve'
+```
+
+### {% linkable_title Variables %}
+
+It is possible to read and set values of system variables you have setup on the CCU/Homegear. The supported types for setting values are float- and bool-variables.   
+The states of the variables are available through the attributes of your hub entity (e.g. `homematic.rf`). Use templates (as mentioned above) to make your variables available to automations or as entities.
 The values of variables are polled from the CCU/Homegear in an interval of 30 seconds. Setting the value of a variable happens instantly and is directly pushed.
 
-### Events
+### {% linkable_title Events %}
 
 When HomeMatic devices change their state or some other internal value, the CCU/Homegear sends event messages to Home Assistant. These events are automatically parsed and the entities in Home Assistant are updated. However, you can also manually use these events to trigger automations. Two event-types are available:
 
 * **homematic.keypress**: For devices with buttons, see information below
 * **homematic.impulse**: For impulse sensors
 
-#### Devices with buttons
+#### {% linkable_title Devices with buttons %}
 
 Devices with buttons (e.g. HM-Sen-MDIR-WM55, remote controls) may not be fully visible in the UI. This is intended, as buttons don't serve any value here and all they do is trigger events.
 As an example:
@@ -127,14 +141,14 @@ automation:
 The channel parameter is equal to the channel of the button you are configuring the automation for. You can view the available channels in the UI you use to pair your devices.
 The name depends on if you chose to resolve names or not. If not, it will be the device ID (e.g. LEQ1234657). If you chose to resolve names (and that is successful), it will be the name you have set in your CCU or in the metadata (e.g. "Kitchen Switch").
 
-### Services
+### {% linkable_title Services %}
 
 * *homematic.virtualkey*: Simulate a keypress (or other valid action) on CCU/Homegear with device or virtual keys.
 * *homematic.reconnect*: Reconnect to CCU/Homegear without restarting Home Assistant (useful when CCU has been restarted)
 * *homematic.set_var_value*: Set the value of a system variable.
 * *homematic.set_dev_value*: Control a device manually (even devices without support). Equivalent to setValue-method from XML-RPC.
 
-#### Examples
+#### {% linkable_title Examples %}
 Simulate a button being pressed
 ```yaml
 ...
@@ -157,18 +171,19 @@ action:
     param: OPEN
 ```
 
-Set variable
+Set boolean variable to true
 ```yaml
 ...
 action:
   service: homematic.set_var_value
   data:
-    entity_id: homematic.varname_bool
+    entity_id: homematic.rf
+    name: Variablename
     value: true
 ```
 
 
-#### Advanced examples
+#### {% linkable_title Advanced examples %}
 
 If you are familiar with the internals of HomeMatic devices, you can manually set values on the devices. This can serve as a workaround if support for a device is currently not available, or only limited functionality has been implemented.  
 Using this service provides you direct access to the setValue-method of the primary connection. If you have multiple hosts, you may select the one hosting a specific device by providing the proxy-parameter with a value equivalent to the name you have chosen. In the example configuration from above `rf`, `wired` and `ip` would be valid values.

source/_components/image_processing.markdown

@@ -30,20 +30,20 @@ automation:
 - alias: Open garage door
   trigger:
     platform: event
-    event_type: found_plate
+    event_type: image_processing.found_plate
     event_data:
       entity_id: openalpr.camera_garage_1
       plate: BE2183423
 ...
 ```
 
-The following event attributes will be present: `entity_id`, `plate`, `confidence`
+The following event attributes will be present (platform-dependent): `entity_id`, `plate`, `confidence`
 
-## {% linkable_title Face identify %}
+## {% linkable_title Face %}
 
-Face entities attribute have a face counter `total_faces` and all validated person as `known_faces`.
+Face entities attribute have a face counter `total_faces` and all face data as `faces`.
 
-This event is trigger after Microsoft Face identify found a known faces.
+This event is trigger after Microsoft Face found a faces.
 
 ```yaml
 # Example configuration.yaml automation entry
@@ -51,11 +51,11 @@ automation:
 - alias: Known person in front of my door
   trigger:
     platform: event
-    event_type: identify_face
+    event_type: image_processing.detect_face
     event_data:
       entity_id: image_processing.door
       name: 'Hans Maier'
 ...
 ```
 
-The following event attributes will be present: `entity_id`, `name`, `confidence`
+The following event attributes will be present (platform-dependent): `entity_id`, `name`, `confidence`, `age`, `gender`, `motion`, `glasses`

source/_components/image_processing.microsoft_face_detect.markdown

@@ -0,0 +1,39 @@
+---
+layout: page
+title: "Microsoft Face Detect"
+description: "Instructions how to integrate Microsoft Face Detect into Home Assistant."
+date: 2017-01-25 00:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: microsoft.png
+ha_category: Image Processing
+featured: false
+ha_release: 0.38
+---
+
+The `microsoft_face_detect` image processing platform allows you to use the [Microsoft Face Identify](https://www.microsoft.com/cognitive-services/en-us/) API through Home Assistant. This platform enables you do detect face on camera and fire a event with attributes.
+
+Please refer to the [component](/components/microsoft_face/) configuration on how to setup the API key.
+
+For using the result inside an automation rule, take a look at the [component](/components/image_processing/) page.
+
+### {% linkable_title Configuration Home Assistant %}
+
+```yaml
+# Example configuration.yaml entry
+image_processing:
+  - platform: microsoft_face_detect
+    source:
+      - entity_id: camera.door
+```
+
+Configuration variables:
+
+- **group** (*Required*): Microsoft Face group used to detect the person.
+- **confidence** (*Optional*): The minimum of confidence in percent to process with Home Assistant. Defaults to 80.
+- **source** array (*Required*): List of image sources.
+  - **entity_id** (*Required*): A camera entity id to get picture from.
+  - **name** (*Optional*): This parameter allows you to override the name of your `image_processing` entity.
+- **attributes** array (*Optional*): The image search attributes. Supported: `age`, `gender`, `glasses`. Default `age`, `gender`.

source/_components/image_processing.microsoft_face_identify.markdown

@@ -1,7 +1,7 @@
 ---
 layout: page
-title: "Microsoft Face identify"
+title: "Microsoft Face Identify"
-description: "Instructions how to integrate microsoft face identify into Home Assistant."
+description: "Instructions how to integrate Microsoft Face Identify into Home Assistant."
 date: 2017-01-25 00:00
 sidebar: true
 comments: false
@@ -13,7 +13,7 @@ featured: false
 ha_release: 0.37
 ---
 
-The `microsoft_face_identify` image processing platform lets you use [Microsoft Face identify](https://www.microsoft.com/cognitive-services/en-us/) API through Home Assistant.
+The `microsoft_face_identify` image processing platform lets you use [Microsoft Face identify](https://www.microsoft.com/cognitive-services/en-us/) API through Home Assistant. This platform allow you do identify persons on camera and fire a event with identify persons.
 
 Please refer to the [component](/components/microsoft_face/) configuration on how to setup the API key.
 
@@ -29,6 +29,7 @@ image_processing:
    source:
     - entity_id: camera.door
 ```
+
 Configuration variables:
 
 - **group** (*Required*): Micrsoft face group to detect person from it.

source/_components/light.hue.markdown

@@ -32,9 +32,10 @@ light:
 Configuration variables:
 
 - **host** (*Optional*): IP address of the device, eg. 192.168.1.10. Required if not using the `discovery` component to discover Hue bridges.
-- **allow_unreachable** (*Optional*): (true/false)  This will allow unreachable bulbs to report their state correctly. By default *name* from the device is used.
+
+- **allow_unreachable** (*Optional*): (true/false)  This will allow unreachable bulbs to report their state correctly.
 - **filename** (*Optional*): Make this unique if specifying multiple Hue hubs.
-- **allow_in_emulated_hue** (*Optional*): (true/false) Enable this to block all Hue entities from being added to the `emulated_hue` component.
+- **allow_in_emulated_hue** (*Optional*): )true/false) Enable this to block all Hue entities from being added to the `emulated_hue` component.
 - **allow_hue_groups** (*Optional*): (true/false) Enable this to stop Home Assistant from importing the groups defined on the Hue bridge.
 
 ### {% linkable_title Using Hue Groups in Home Assistant %}

source/_components/light.mysensors.markdown

@@ -29,8 +29,11 @@ S_TYPE      | V_TYPE
 ------------|-------------
 S_DIMMER    | [V_DIMMER\* or V_PERCENTAGE\*], [V_LIGHT\* or V_STATUS\*]
 S_RGB_LIGHT | V_RGB*, [V_LIGHT\* or V_STATUS\*], [V_DIMMER or V_PERCENTAGE]
+S_RGBW_LIGHT | V_RGBW*, [V_LIGHT\* or V_STATUS\*], [V_DIMMER or V_PERCENTAGE]
 
-V_TYPES with a star (\*) denote V_TYPES that should be sent at sketch startup. For an S_DIMMER, send both a V_DIMMER/V_PERCENTAGE and a V_LIGHT/V_STATUS message.  For an S_RGB_LIGHT, send both a V_RGB and a V_LIGHT/V_STATUS message with a V_DIMMER/V_PERCENTAGE message being optional.  Sketch should acknowledge a command sent from controller with the same type.  If command invokes a change to off state (including a V_PERCENTAGE or V_RGB message of zero), only a V_STATUS of zero message should be sent.  See sketches below for examples.  
+V_TYPES with a star (\*) denote V_TYPES that should be sent at sketch startup. For an S_DIMMER, send both a V_DIMMER/V_PERCENTAGE and a V_LIGHT/V_STATUS message.  For an S_RGB_LIGHT, send both a V_RGB and a V_LIGHT/V_STATUS message with a V_DIMMER/V_PERCENTAGE message being optional. Same principal applies for S_RGBW_LIGHT and V_RGBW.
+
+Sketch should acknowledge a command sent from controller with the same type.  If command invokes a change to off state (including a V_PERCENTAGE, V_RGB, or V_RGBW message of zero), only a V_STATUS of zero message should be sent.  See sketches below for examples.  
 
 For more information, visit the [serial api] of MySensors.
 
@@ -108,6 +111,7 @@ void incomingMessage(const MyMessage &message) {
     }
 }
 ```
+
 ### {% linkable_title MySensors 2.x example sketch %}
 
 ```cpp
@@ -241,5 +245,6 @@ void send_status_message()
   }
 }
 ```
+
 [main component]: /components/mysensors/
 [serial api]: http://www.mysensors.org/download

source/_components/light.rflink.markdown

@@ -0,0 +1,104 @@
+---
+layout: page
+title: "Rflink Light"
+description: "Instructions how to integrate Rflink lights into Home Assistant."
+date: 2016-01-04
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: rflink.png
+ha_category: Light
+ha_release: 0.38
+---
+
+The `rflink` component support devices that use [Rflink gateway firmware](http://www.nemcon.nl/blog2/), for example the [Nodo Rflink Gateway](https://www.nodo-shop.nl/nl/21-rflink-gateway). Rflink gateway is an Arduino firmware that allows communication with 433Mhz devices using cheap hardware (Arduino + 433Mhz tranceiver).
+
+First you have to set up your [rflink hub](/components/rflink/).
+
+After configuring the Rflink hub lights will be automatically discovered and added.
+
+New/unknown lights can be assigned to a default group automatically by specifying the `new_devices_group` option with a group name. If the group doesn't exist it will be created.
+
+For example:
+
+```yaml
+# Example configuration.yaml entry
+sensor:
+  platform: rflink
+  new_devices_group: "New Rflink Lights"
+```
+
+Rflink switch/light ID's are composed of: protocol, id, switch. For example: `newkaku_0000c6c2_1`.
+
+Once the ID of a light is known it can be used to configure the light in HA, for example to add it to a different group, hide it or configure a nice name.
+
+Configuring a device as light with a nice name:
+
+```yaml
+# Example configuration.yaml entry
+light:
+  platform: rflink
+  devices:
+    newkaku_0000c6c2_1:
+      name: Living room
+```
+
+Configuration variables:
+
+- **devices**  (*Optional*): A list of devices with their name to use in the frontend.
+- **new_devices_group** (*Optional*): Create group to add new/unknown devices to.
+- **device_defaults**: (*Optional*)
+  - **fire_event_** (*Optional*): Set default `fire_event` for Rflink switch devices (see below).
+  - **signal_repetitions** (*Optional*): Set default `signal_repetitions` for Rflink switch devices (see below).
+
+Device configuration variables:
+
+- **name** (*Optional*): Name for the device, defaults to Rflink ID.
+- **type** (*Optional*): Override automatically detected type of the light device, can be: switchable, dimmable or hybrid. See 'Light Types' below.
+- **aliasses** (*Optional*): Alternative Rflink ID's this device is known by.
+- **fire_event_** (*Optional*): Fire an `button_pressed` event if this device is turned on or off (default: False).
+- **signal_repetitions** (*Optional*): Repeat every Rflink command this number of times (default: 1)
+
+### {% linkable_title Light state %}
+
+Initially the state of a light is unknown. When the light is turned on or off (via frontend or 433Mhz remote) the state is known and will be shown in the frontend.
+
+Sometimes a light is controlled by multiple 433Mhz remotes, each remote has its own code programmed in the light. To allow tracking of the state when switched via other remotes add the corresponding remote codes as aliasses:
+
+```yaml
+# Example configuration.yaml entry
+light:
+  platform: rflink
+  devices:
+    newkaku_0000c6c2_1:
+      name: Living room
+      aliasses:
+        - newkaku_000000001_2
+        - kaku_000001_a
+```
+
+Any on/off command from any allias ID updates the current state of the light. However when sending a command through the frontend only the primary ID is used.
+
+### {% linkable_title Light types %}
+
+Light devices can come in different forms. Some only switch on and off, other support dimming. Dimmable devices might not always respond nicely to repeated `on` command as they turn into a pulsating state until `on` is pressed again (for example KlikAanKlikUit). The Rflink component support three types of lights to make things work in every situation:
+
+- *Hybrid*: This type sends a `dim` followed by an a `on` command; and `off` commands. This will make dimmable devices turn on at the requested dim level and on/off devices on. One caveat is this type is not compatible with signal repetition as multiple `on` signals will cause dimmers to go into disco mode.
+- *Switchable*: Device type that sends only `on` and `off` commands. It work for both on/off and dimmable type switches. However dimmables might have issues with signal repetition (see above).
+- *Dimmable*: Sends only `dim` and `off` commands. This does not work on on/off type devices as they don't understand the `dim` command. For dimmers this does not cause issues with signal repetitions.
+
+By default new lights are assigned the `switchable` type. Protocol supporting dimming are assigned the `hybrid` type. Currently only `newkaku` protocol is detected as dimmable. Please refer to Device Support to get your dimmers supported.
+
+### {% linkable_title Hiding/ignoring lights %}
+
+Lights are added automatically when the Rflink gateway intercepts a 433Mhz command in the ether. To prevent cluttering the frontend use any of these methods:
+
+- Configure a `new_devices_group` for lights and optionally add it to a different `view`.
+- Hide unwanted devices using [customizations](/getting-started/customizing-devices/)
+- [Ignore devices on a platform level](/components/rflink/#ignoring-devices)
+
+### {% linkable_title Device support %}
+
+See [device support](/components/rflink/#device-support)
+

source/_components/lock.nuki.markdown

@@ -0,0 +1,47 @@
+---
+layout: page
+title: "Nuki Smart Lock"
+description: "Instructions on how to integrate a Nuki Smart Lock devices."
+date: 2017-02-02 09:35
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: nuki.png
+ha_category: Lock
+featured: false
+ha_release: 0.38
+ha_iot_class: "Local Polling"
+---
+
+The `nuki` platform allows you to control [Nuki Smart Locks](nuki.io) via either a [sofware](https://play.google.com/store/apps/details?id=io.nuki.bridge&hl=fr) or a [physical bridge](https://nuki.io/en/bridge/).
+
+To add a Nuki bridge to your installation, you need to enable developper mode on your bridge and define a port and an access token. This can be achieved using the Android app. Please note that there seems to be a maximum length for the API token, even though the app allows you to set a longer one.
+Then add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+lock:
+  - platform: nuki
+    host: 192.168.1.120
+    token: fe2345ef
+```
+
+Configuration variables:
+
+- **host** (*Required*): The IP or hostname of the Nuki bridge.
+- **port** (*Optional*): The port on which the Nuki bridge is listening on. Defaults to `8080`.
+- **token** (*Optional*): The token that was defined when setting up the bridge.
+
+## {% linkable_title Full configuration %}
+
+Here's a full configuration example for a Nuki bridge:
+
+```yaml
+# Example configuration.yaml entry
+lock:
+  - platform: nuki
+    host: 192.168.1.120
+    port: 8080
+    token: fe2345ef
+```

source/_components/lutron.markdown

@@ -13,5 +13,27 @@ featured: False
 ha_release: 0.37
 ---
 
-The `lutron` component is the base for all [Lutron](http://www.lutron.com/) in Home Assistant. The preferred way to setup the `lutron` component is by enabling the [the discovery component](/components/discovery/). 
+[Lutron](http://www.lutron.com/) is an American lighting control company. They have several lines of home automation devices that manage light switches/dimmers, occupancy sensors, HVAC controls, etc. The `lutron` component in Home Assistant is responsible for communicating with the main hub for these systems.
 
+Presently, there's only support for communicating with the [RadioRA 2](http://www.lutron.com/en-US/Products/Pages/WholeHomeSystems/RadioRA2/Overview.aspx) Main Repeater and only handle light switches and dimmers.
+
+When configured, the `lutron` component will automatically discover the rooms and their associated switches/dimmers as configured by the RadioRA 2 software from Lutron. Each room will be treated as a separate group.
+
+To use Lutron RadioRA 2 devices in your installation, add the following to your configuration.yaml file using the IP of your RadioRA 2 Main Repeater:
+
+``` yaml
+lutron:
+  lutron_host: <ip>
+  lutron_user: lutron
+  lutron_password: integration
+```
+
+Configuration variables:
+
+- **lutron_ip** (*Required*): The IP address of the Main Repeater.
+- **lutron_user** (*Required*): The login name of the user. The user `lutron` always exists, but other users can be added via RadioRA 2 software.
+- **lutron_password** (*Required*): The password for the user specified above. `integration` is the password for the always-present `lutron` user.
+
+<p class='note'>
+  It is recommended to assign a static IP address to your Main Repeater. This ensures that it won't change IP addresses, so you won't have to change the `lutron_ip` if it reboots and comes up with a different IP address.
+</p>

source/_components/media_player.apple_tv.markdown

@@ -0,0 +1,51 @@
+---
+layout: page
+title: "Apple TV"
+description: "Instructions how to integrate Apple TV devices into Home Assistant."
+date: 2017-02-08 07:11
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: apple.png
+ha_category: Media Player
+ha_iot_class: "Local Polling"
+ha_release: 0.38
+featured: true
+---
+
+The `apple_tv` platform allows you to control an Apple TV (3rd and 4th generation).
+
+<p class='note'>
+Currently you must have Home Sharing enabled for this to work. Support for pairing Home Assistant with your device will be supported in a later release.
+</p>
+
+If you want to automatically discover new devices, just make sure you have `discovery:` in your `configuration.yaml` file. To manually add an Apple TV to your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+media_player:
+  - platform: apple_tv
+    host: IP_ADDRESS
+    login_id: LOGIN_ID
+```
+
+Configuration variables:
+
+- **host** (*Required*): The IP-address of the device
+- **login_id** (*Required*): An identifier used to login to the device, see below
+- **name** (*Optional*): The name of the device used in the frontend
+
+In order to connect to the device you need a *login id*. The easiest way to obtain this identifier is to use the application ``atvremote``. It should be available in the same environment as you installed Home-Assistant. Just run it like this to scan for all devices (try again if a device is missing):
+
+```bash
+$ atvremote scan
+Found Apple TVs:
+ - Apple TV at 10.0.10.22 (login id: 00000000-1234-5678-9012-345678901234)
+```
+
+Just copy and paste the login id from the device you want to add. For more details about `atvremote`, see: [this page](https://github.com/postlund/pyatv/blob/master/docs/atvremote.rst).
+
+## {% linkable_title Notes and Limitations %}
+
+- Pairing is currently not supported

source/_components/media_player.liveboxplaytv.markdown

@@ -0,0 +1,45 @@
+---
+layout: page
+title: "Orange Livebox Play TV"
+description: "Instructions on how to integrate a Livebox Play TV appliance into Home Assistant."
+date: 2017-01-25 07:27
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: orange.png
+ha_category: Media Player
+featured: false
+ha_release: 0.38
+ha_iot_class: "Local Polling"
+---
+
+The `liveboxplaytv` platform allows you to control [Orange Livebox Play TV appliances](https://boutique.orange.fr/internet/decodeur-tv-livebox).
+
+To add an Orange Livebox Play TV to your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+media_player:
+  - platform: liveboxplaytv
+    host: 192.168.1.3
+```
+
+Configuration variables:
+
+- **host** (*Required*): The IP or hostname of the Orange Livebox Play TV appliance.
+- **name** (*Optional*): The name to use in the frontend. Defaults to `Livebox Play TV`.
+- **port** (*Optional*): The port on which the Livebox is listening on. Defaults to 8080.
+
+## {% linkable_title Full configuration %}
+
+A full configuration example for an Orange TV appliance can look like this:
+
+```yaml
+# Example configuration.yaml entry
+media_player:
+  - platform: liveboxplaytv
+    host: 192.168.1.3
+    port: 8080
+    name: Orange Livebox Play TV
+```

source/_components/media_player.webostv.markdown

@@ -30,6 +30,7 @@ Configuration variables:
 - **host** (*Optional*): The IP of the LG webOS Smart TV, e.g. `192.168.0.10`.
 - **mac** (*Optional*): The MAC address of the TV, e.g. `C8:08:E9:99:99:1A`.
 - **name** (*Optional*): The name you would like to give to the LG webOS Smart TV.
+- **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.
 
@@ -45,6 +46,7 @@ media_player:
     host: 192.168.0.10
     mac: C8:08:E9:99:99:1A
     name: Living Room TV
+    filename: webostv.conf
     customize:
       sources:
         - livetv

source/_components/mqtt.markdown

@@ -29,6 +29,7 @@ mqtt:
   password: PASSWORD
   certificate: /home/paulus/dev/addtrustexternalcaroot.crt
   protocol: 3.1
+  discovery: "discovery/#"
   birth_message:
     topic: 'hass/status'
     payload: 'online'
@@ -53,6 +54,7 @@ Configuration variables:
 - **client_key** (*Optional*): Client key (example: `/home/user/owntracks/cookie.key`)
 - **client_cert** (*Optional*): Client certificate (example: `/home/user/owntracks/cookie.crt`)
 - **protocol** (*Optional*): Protocol to use: 3.1 or 3.1.1. By default it connects with 3.1.1 and falls back to 3.1 if server does not support 3.1.
+- **discovery** (*Optional*): The MQTT topic subscribed to use for discovery of MQTT devices.
 - **birth_message** (*Optional*):
   - **topic** (*Required*): The MQTT topic to publish the message.
   - **payload** (*Required*): The message content.
@@ -183,7 +185,7 @@ Home Assistant will automatically load the correct certificate if you connect to
 
  - Integrating it into own component. See the [MQTT example component](/cookbook/python_component_mqtt_basic/) how to do this.
 
-### {% linkable_title Publish service %}
+## {% linkable_title Publish service %}
 
 The MQTT component will register the service `publish` which allows publishing messages to MQTT topics. There are two ways of specifying your payload. You can either use `payload` to hard-code a payload or use `payload_template` to specify a [template](/topics/templating/) that will be rendered to generate the payload.
 
@@ -201,7 +203,23 @@ The MQTT component will register the service `publish` which allows publishing m
 }
 ```
 
-### {% linkable_title Logging %}
+## {% linkable_title Discovery %}
+
+The discovery of MQTT devices will enable one to use MQTT devices with only minimal configuration effort on the side of Home Assistant. The configuration is done on the device itself and the topic used by the device. Similar to the [HTTP binary sensor](/components/binary_sensor.http/) and the [HTTP sensor](/components/sensor.http/). Only support for binary sensor is available at the moment.
+
+To enable MQTT discovery, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+mqtt:
+  discovery: true
+  # Optional
+  discovery_prefix: homeassistant
+```
+
+A motion detection device for your garden would sent its configuration as JSON payload `{"name": "garden", "sensor_class": "motion"}` to the topic `homeassistant/binary_sensor/garden/config`. After the first message to `config`, then the MQTT messages sent to `state`, eg. `homeassistant/binary_sensor/garden/state`, will update the state in Home Assistant.
+
+## {% linkable_title Logging %}
 
 The [logger](/components/logger/) component allow the logging of received MQTT messages.
 

source/_components/neato.markdown

@@ -10,7 +10,6 @@ footer: true
 logo: neato.png
 ha_category: Hub
 ha_release: 0.33
-featured: true
 ---
 
 The `neato` component allows you to control your [Neato Botvac Connected](https://www.neatorobotics.com/robot-vacuum/botvac-connected-series/botvac-connected/).

source/_components/notify.facebook.markdown

@@ -49,3 +49,26 @@ automation:
           - +919413017584
           - +919784516314
 ```
+
+### {% linkable_title Rich messages %}
+You could also send rich messing (cards, buttons, images, videos, etc). [Info](https://developers.facebook.com/docs/messenger-platform/send-api-reference) to which types or messages and how to build them.
+
+```yaml
+# Example script with a notification entry with rich message
+
+script:
+  test_fb_notification:
+    sequence:
+      - service: notify.facebook
+        data:
+          message: Some text before the quick replies
+          target: 0034643123212
+          data:
+            quick_replies:
+              - content_type: text
+                title: Red
+                payload: DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED
+              - content_type: text
+                title: Blue
+                payload: DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_BLUE
+```

source/_components/notify.html5.markdown

@@ -236,3 +236,27 @@ You will receive an event named `html5_notification.closed` when the notificatio
     platform: event
     event_type: html5_notification.closed
 ```
+
+### {% linkable_title Making notifications work with NGINX proxy %}
+
+If you use [NGINX](/ecosystem/nginx/) as an proxy with authentication in front of HASS, you may have trouble with receiving events back to HASS. It's because of authentication token that cannot be passed through the proxy.
+
+To solve the issue put additional location into your nginx site's configuration:
+
+```bash
+location /api/notify.html5/callback {
+    if ($http_authorization = "") { return 403; }
+    allow all;
+    proxy_pass http://localhost:8123;
+    proxy_set_header Host $host;
+    proxy_redirect http:// https://;
+}
+```
+
+This rule check if request have `Authorization` HTTP header and bypass the htpasswd (if you use one).
+
+If you still have the problem, even with mentioned rule, try to add this code:
+```bash
+    proxy_set_header Authorization $http_authorization;
+    proxy_pass_header Authorization;
+```

source/_components/notify.mailgun.markdown

@@ -0,0 +1,71 @@
+---
+layout: page
+title: "Mailgun"
+description: "Instructions how to add Mailgun mail notifications to Home Assistant."
+date: 2017-02-06 16:52
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: mailgun.png
+ha_category: Notifications
+ha_release: 0.38
+---
+
+The Mailgun notification service allows you to send emails via Mailgun's REST API.
+
+## {% linkable_title Sample configuration %}
+
+```yaml
+# Example configuration.yaml entry
+notify:
+  - name: NOTIFIER_NAME
+    platform: mailgun
+    domain: YOUR_MAILGUN_DOMAIN
+    token: TOKEN
+    recipient: RECIPIENT_EMAIL
+```
+
+Configuration variables:
+
+- **domain** (*Optional*): This is the domain name to be used when sending out mail. Defaults to the first custom domain you have set up.
+- **sandbox** (*Optional*): Whether to use the sandboxed domain for outgoing mail. The `domain` item takes precedence over this. Defaults to `False`.
+- **token** (*Required*): This is the API token that has been generated in your Mailgun account.
+- **recipient** (*Required*): The email address of the recipient.
+- **sender** (*Optional*): The sender's email address. Defaults to `hass@DOMAIN`, where `DOMAIN` is outgoint mail domain, as defined by the `domain` and `sanbox` configuration entries.
+
+## {% linkable_title Full configuration %}
+
+A full configuration example for the Mailgun notifier system can look like this:
+
+```yaml
+# Example configuration.yaml entry
+notify:
+  - name: mailgun
+    platform: mailgun
+    domain: mg.example.com
+    sanbox: False
+    token: 'token-XXXXXXXXX'
+    recipient: me@example.com
+```
+
+## {% linkable_title Example automation %}
+
+The following automation reacts to an event by sending out an email with two attachments.
+
+```yaml
+# Example automation using Mailgun notifications
+automation:
+  trigger:
+    platform: event
+    event_type: SPECIAL_EVENT
+  action:
+    service: notify.mailgun
+    data:
+      title: "Something special has happened"
+      message: "This a test message from Home Assistant"
+      data:
+        images:
+          - /home/pi/pic_test1.png
+          - /home/pi/pic_test2.png
+```

source/_components/notify.twilio_call.markdown

@@ -0,0 +1,61 @@
+yout: page
+title: "Twilio Call"
+description: "Instructions how to add user notifications to Home Assistant."
+date: 2017-01-27 00:09
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: twilio.png
+ha_category: Notifications
+ha_release: "0.37"
+---
+
+The `twilio` notification platform enables sending notifications via Voice, powered by [Twilio](https://twilio.com).
+Passed message will be read by Text-To-Speech service.
+
+This component is just an adaptation from the Twilio SMS notification platform and won't exist without it.
+
+Free trial account is available at [Twilio](https://twilio.com) website providing free calls to verified phone numbers.
+Calls are limited to 10 minutes and will play a short trial message before your message runs.
+
+Upgraded accounts have no limitation.
+
+To use this notification platform in your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+notify:
+  - name: NOTIFIER_NAME
+    platform: twilio_call
+    account_sid: ACCOUNT_SID_FROM_TWILIO
+    auth_token: AUTH_TOKEN_FROM_TWILIO
+    from_number: E164_PHONE_NUMBER
+```
+
+Configuration variables:
+
+- **account_sid** (*Required*): Your Twilio Account SID which can be found in your [console](https://www.twilio.com/console). It starts with the letters `AC`.
+- **auth_token** (*Required*): Your Twilio Account SID which can be found in your [console](https://www.twilio.com/console). It should be directly under where you found the `account_sid`.
+- **from_number** (*Required*): An [E.164](https://en.wikipedia.org/wiki/E.164) formatted phone number, like +14151234567. See [Twilio's guide to formatting phone numbers](https://www.twilio.com/help/faq/phone-numbers/how-do-i-format-phone-numbers-to-work-internationally) for more information.
+- **name** (*Optional*): Setting the optional parameter `name` allows multiple notifiers to be created. The default value is `notify`. The notifier will bind to the service `notify.NOTIFIER_NAME`.
+
+### {% linkable_title Usage %}
+
+Twilio is a notify platform and thus can be controlled by calling the notify service [as described here](/components/notify/). It will send a notification to all E.164 phone numbers in the notification **target**. See the notes above regarding the `from_number` configuration variable for information about formatting phone numbers.
+
+```yaml
+# Example automation notification entry
+automation:
+  - alias: The sun has set
+    trigger:
+      platform: sun
+      event: sunset
+    action:
+      service: notify.twilio_sms
+      data:
+        message: 'The sun has set'
+        target:
+          - +14151234567
+          - +15105555555
+```

source/_components/notify.webostv.markdown

@@ -25,12 +25,14 @@ notify:
   - platform: webostv
     host: 192.168.0.112
     name: livingroom_tv
+    filename: webostv.conf
 ```
 
 Configuration variables:
 
 - **host** (*Required*): The IP of the LG WebOS Smart TV, e.g. 192.168.0.10
 - **name** (*Required*): The name you would like to give to the LG WebOS Smart TV.
+- **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`.
 
 A possible automation could be:
 

source/_components/rflink.markdown

@@ -0,0 +1,104 @@
+---
+layout: page
+title: "Rflink"
+description: "Instructions how to integrate Rflink gateway into Home Assistant."
+date: 2016-01-04
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: rflink.png
+ha_category: Hub
+ha_release: 0.38
+---
+
+The `rflink` component support devices that use [Rflink gateway firmware](http://www.nemcon.nl/blog2/), for example the [Nodo Rflink Gateway](https://www.nodo-shop.nl/nl/21-rflink-gateway). Rflink gateway is an Arduino firmware that allows communication with 433 Mhz devices using cheap hardware (Arduino + 433 Mhz tranceiver).
+
+The 433 Mhz spectrum is used by many manufacturers mostly using their own protocol/standard and includes devices like: light switches, blinds, weather stations, alarms and various other sensors.
+
+A complete list of devices supported by Rflink can be found [here](http://www.nemcon.nl/blog2/devlist)
+
+This component is tested with the following hardware/software:
+
+- Nodo Rflink Gateway V1.4/Rflink R44
+
+To enable Rflink in your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+rflink:
+  port: /dev/serial/by-id/usb-id01234
+```
+
+Configuration variables:
+
+- **port** (*Required*): The path to Rflink usb/serial device or TCP port in TCP mode.
+- **host** (*Optional*): Switches to TCP mode, connects to host instead of to USB/serial.
+- **wait_for_ack** (*Optional*): Wait for Rflink to ackowledge commands sent before sending new command (slower but more reliable). Defaults to `True`
+- **ignore_devices** (*Optional*): List of devices id's to ignore. Supports wildcards (*) at the end.
+- **reconnect_interval** (*Optional*): Time in seconds between reconnect attempts.
+
+Complete example:
+
+```yaml
+# Example configuration.yaml entry
+rflink:
+  port: /dev/serial/by-id/usb-id01234
+  wait_for_ack: False
+  ignore_devices:
+    - newkaku_000001_01
+    - digitech_*
+```
+
+### {% linkable_title TCP mode %}
+
+TCP mode allows connect to a Rflink device over TCP/IP network. This is for example useful if placing the Rflink device next to the HA server is not optimal or desired (eg: bad reception).
+
+To expose the usb/serial interface over TCP on a different host (Linux) the following command can be used:
+
+```bash
+$ socat /dev/ttyACM0,b57600 TCP-LISTEN:1234,reuseaddr
+```
+
+Other methods of exposing the serial interface over TCP are possible (eg: ESP8266 or using Arduino Wifi shield). Basically the serial stream should be directly mapped to the TCP stream.
+
+```yaml
+# Example configuration.yaml entry
+rflink:
+  host: 192.168.0.10
+  port: 1234
+```
+
+### {% linkable_title Ignoring devices %}
+
+Rflink platform can be configured to completely ignore a device on a platform level. This is useful when you have neighbors which also use 433 Mhz technology.
+
+For example:
+
+```yaml
+# Example configuration.yaml entry
+rflink:
+  port: /dev/serial/by-id/usb-id01234
+  wait_for_ack: False
+  ignore_devices:
+    - newkaku_000001_01
+    - digitech_*
+    - kaku_1_*
+```
+
+This configuration will ignore the button `1` of the `newkaku` device with ID `000001`, all devices of the `digitech` protocol and all switches of the `kaku` protocol device with codewheel ID `1`.
+
+Wildcards only work at the end of the ID, not in the middle of front!
+
+### {% linkable_title Device support %}
+
+Even though a lot of devices are supported by Rflink, not all have been tested/implemented. If you have a device supported by Rflink but not by this component please consider testing and adding support yourself or [create an issue](https://github.com/home-assistant/home-assistant/issues/new) and mention `@aequitas` in the description.
+
+
+### {% linkable_title Technical overview %}
+
+- The`rflink` Python module a asyncio transport/protocol is setup that fires an callback for every (valid/supported) packet received by the Rflink gateway.
+- This component uses this callback to distribute 'rflink packet events' over the HASS bus which can be subscribed to by entities/platform implementations.
+- The platform implementions take care of creating new devices (if enabled) for unsees incoming packet id's.
+- Device entities take care of matching to the packet ID, interpreting and performing actions based on the packet contents. Common entitiy logic is maintained in this main component.
+

source/_components/sensor.http.markdown

@@ -28,7 +28,7 @@ You should choose a unique device name (DEVICE_NAME) to avoid clashes with other
 {"state": "20", "attributes": {"unit_of_measurement": "°C", "friendly_name": "Bathroom Temperature"}}
 ```
 
-For a quick test `curl` can be useful to "simulate" a device.
+For a quick test, `curl` can be useful to "simulate" a device.
 
 ```bash
 $ curl -X POST -H "x-ha-access: YOUR_PASSWORD" \
@@ -37,7 +37,7 @@ $ curl -X POST -H "x-ha-access: YOUR_PASSWORD" \
        http://localhost:8123/api/states/sensor.bathroom_temperature
 ```
 
-Use again `curl` to retrieve the [current state](/developers/rest_api/#get-apistatesltentity_id) to check if the sensor is working.
+You can then use `curl` again to retrieve the [current sensor state](/developers/rest_api/#get-apistatesltentity_id) and verify the sensor is working.
 
 ```bash
 $ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \

source/_components/sensor.miflora.markdown

@@ -39,6 +39,7 @@ sensor:
 - **timeout** (*Optional*): Define the timeout value in seconds when polling (defaults to 10 if not defined)
 - **retries** (*Optional*): Define the number of retries when polling (defaults to 2 if not defined)
 - **cache** (*Optional*): Define cache expiration value in seconds (defaults to 1200 if not defined)
+- **adapter** (*Optional*): Define the bluetooth adapter to use (defaults to hci0). Run `hciconfig` to get a list of available adapters.
 
 Note that by default the sensor is only polled once every 15 minutes. This means with the `median: 3` setting will take as least 30 minutes before the sensor will report a value after a Home Assistant restart. As the values usually change very slowly, this isn't a big problem. 
 Reducing polling intervals will have a negative effect on the battery life.

source/_components/sensor.moon.markdown

@@ -0,0 +1,26 @@
+---
+layout: page
+title: "Moon Sensor"
+description: "Instructions how to integrate the moon sensor into Home Assistant."
+date: 2017-02-03 07:10
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: home-assistant.png
+ha_category: Weather
+ha_iot_class: "Local Polling"
+ha_release: 0.38
+---
+
+
+The `moon` sensor platform is tracking the moon phases.
+
+To enable the moon sensor, add the following lines to your `configuration.yaml`:
+
+```yaml
+# Example configuration.yaml entry
+sensor:
+  - platform: moon
+```
+

source/_components/sensor.mysensors.markdown

@@ -24,7 +24,7 @@ S_TYPE             | V_TYPE
 S_TEMP             | V_TEMP
 S_HUM              | V_HUM
 S_BARO             | V_PRESSURE, V_FORECAST
-S_WIND             | V_WIND, V_GUST
+S_WIND             | V_WIND, V_GUST, V_DIRECTION
 S_RAIN             | V_RAIN, V_RAINRATE
 S_UV               | V_UV
 S_WEIGHT           | V_WEIGHT, V_IMPEDANCE
@@ -68,7 +68,7 @@ By using V_UNIT_PREFIX, it's possible to set a custom unit for any sensor. The s
 
 For more information, visit the [serial api] of MySensors.
 
-### {% linkable_title Example sketch %}
+### {% linkable_title MySensors 1.5 example sketch %}
 
 ```cpp
 /**
@@ -116,5 +116,69 @@ void loop()
 }
 ```
 
+### {% linkable_title MySensors 2.x example sketch %}
+
+```cpp
+/**
+ * Documentation: http://www.mysensors.org
+ * Support Forum: http://forum.mysensors.org
+ *
+ * http://www.mysensors.org/build/light
+ */
+
+#define MY_DEBUG
+#define MY_RADIO_NRF24
+
+#include <BH1750.h>
+#include <Wire.h>
+#include <MySensors.h>
+
+#define SN "LightLuxSensor"
+#define SV "1.0"
+#define CHILD_ID 1
+unsigned long SLEEP_TIME = 30000; // Sleep time between reads (in milliseconds)
+
+BH1750 lightSensor;
+MyMessage msg(CHILD_ID, V_LEVEL);
+MyMessage msgPrefix(CHILD_ID, V_UNIT_PREFIX);  // Custom unit message.
+uint16_t lastlux = 0;
+bool initialValueSent = false;
+
+void setup()
+{
+  sendSketchInfo(SN, SV);
+  present(CHILD_ID, S_LIGHT_LEVEL);
+  lightSensor.begin();
+}
+
+void loop()
+{
+  if (!initialValueSent) {
+    Serial.println("Sending initial value");
+    send(msgPrefix.set("custom_lux"));  // Set custom unit.
+    send(msg.set(lastlux));
+    Serial.println("Requesting initial value from controller");
+    request(CHILD_ID, V_LEVEL);
+    wait(2000, C_SET, V_LEVEL);
+  }
+  uint16_t lux = lightSensor.readLightLevel();  // Get Lux value
+  if (lux != lastlux) {
+      send(msg.set(lux));
+      lastlux = lux;
+  }
+
+  sleep(SLEEP_TIME);
+}
+
+void receive(const MyMessage &message) {
+  if (message.type == V_LEVEL) {
+    if (!initialValueSent) {
+      Serial.println("Receiving initial value from controller");
+      initialValueSent = true;
+    }
+  }
+}
+```
+
 [main component]: /components/mysensors/
-[serial api]: https://www.mysensors.org/download/serial_api_15
+[serial api]: http://www.mysensors.org/download

source/_components/sensor.openevse.markdown

@@ -0,0 +1,40 @@
+---
+layout: page
+title: "OpenEVSE Sensor"
+description: "Instructions how to integrate a WiFi-equipped OpenEVSE Charging station with Home Assistant"
+date: 2017-02-02 22:09
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: openevse.png
+ha_category: Sensor
+ha_release: "0.38"
+---
+
+
+This `openevse` sensor platform pulls data from an [OpenEVSE](https://www.openevse.com/) Charging station equipped with an ESP8266-based wifi connection.
+
+To enable this sensor in your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yml entry
+sensor:
+  - platform: openevse
+    host: IP_ADDRESS
+    monitored_variables:
+      - status
+```
+
+Configuration variables:
+
+- **api_key** (*Required*): Your Sonarr API key, found in Settings > General in the Sonarr Web UI.
+- **host** (*Required*): The IP address or hostname of your charger
+- **monitored_variables** array (*Required*): Conditions to display on the frontend.
+  - **status**: The status of the charger (i.e., "Connected", "Charging", etc.)
+  - **charge_time**: The number of minutes the charging has been charging, or 0 if it is not charging.
+  - **rtc_temp**: The temperature reported by the real time clock sensor, or 0 if the sensor is not installed.
+  - **ir_temp**: The temperature reported by the IR remote sensor, or 0 if the sensor is not installed.
+  - **ambient_temp**: The temperature reported by the ambient sensor, or 0 if the sensor is not installed.
+  - **usage_session**: The energy usage for the current charging session.
+  - **usage_total**: The total energy usage for the device.

source/_components/sensor.openweathermap.markdown

@@ -37,6 +37,7 @@ Configuration variables:
   - **weather**: A human-readable text summary.
   - **temperature**: The current temperature.
   - **wind_speed**: The wind speed.
+  - **wind_bearing**: The wind bearing.
   - **humidity**: The relative humidity.
   - **pressure**: The sea-level air pressure in millibars.
   - **clouds**: Description about cloud coverage.

source/_components/sensor.qnap.markdown

@@ -0,0 +1,65 @@
+---
+layout: page
+title: "QNAP Sensor"
+description: "Instructions how to integrate the QNAP sensor within Home Assistant."
+date: 2017-02-02 06:39
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: qnap.png
+ha_category: Sensor
+ha_release: 0.38
+ha_iot_class: "Local Polling"
+---
+
+
+This `qnap` sensor allows getting various statistics from your [QNAP NAS](https://www.qnap.com/en-us/).
+
+To use the `qnap` sensor in your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yml entry
+sensor:
+  - platform: qnap
+    host: IP_ADDRESS_OF_QNAP_NAS
+    username: USERNAME
+    password: PASSWORD
+    monitored_conditions:
+      - status
+      - cpu_usage
+      - memory_percent_used
+      - network_tx
+      - volume_percentage_used
+```
+
+Configuration variables:
+
+- **host** (*Required*): The IP address of the QNAP NAS to monitor
+- **port** (*Optional*): The port number on which the QNAP NAS web interface is reachable. Defaults to `8080`.
+- **ssl** (*Optional*): Whether to connect via `https`. Defaults to `false`.
+- **username** (*Required*): An user to connect to the QNAP NAS.
+- **password** (*Required*): The password of the user to connect to the QNAP NAS.
+- **drives** (*Optional*): Array of drives to monitor (ex: `0:1`). Defaults to all drives.
+- **volumes** (*Optional*): Array of volumes to monitor (ex: `DataVol1`). Defaults to all volumes.
+- **nics** (*Optional*): Array of network interfaces to monitor (ex: `eth0`). Defaults to all NICs.
+- **monitored_conditions** (*Required*): Defines the stats to monitor as sensors.
+  - **status**: Displays overall system health.
+  - **cpu_temp**: Displays the CPU's temperature.
+  - **cpu_usage**: Displays the CPU's utilization as a percentage.
+  - **memory_free**: Displays the size of available RAM in GB.
+  - **memory_used**: Displays the size of used RAM in GB.
+  - **memory_percent_used**: Displays the size of used RAM as a percentage of total RAM.
+  - **network_link_status**: Displays whether the network interfaces is up (creates a new entry for each interface).
+  - **network_tx**: Displays the upload speed of a network interface in MB/s (creates a new entry for each interface).
+  - **network_rx**: Displays the download speed of a network interface in MB/s (creates a new entry for each interface).
+  - **drive_smart_status**: Displays the S.M.A.R.T. status of the drive (creates a new entry for each drive).
+  - **drive_temp**: Displays the temperature of the drive (creates a new entry for each drive).
+  - **volume_size_free**: Displays the available space of the volume in GB (creates a new entry for each volume).
+  - **volume_size_used**: Displays the used space of the volume in GB (creates a new entry for each volume).
+  - **volume_percentage_used**: Displays the used space of the volume as a percentage (creates a new entry for each volume).
+
+QNAP device support:
+
+This component has been tested on a TS-451 running QTS 4.2.2.  Other QNAP NAS devices using similar firmware should work fine.
+For more information about supported devices, or to report issues with your device, please visit the [qnapstats project](https://github.com/colinodell/python-qnapstats#device-support).

source/_components/sensor.rflink.markdown

@@ -0,0 +1,71 @@
+---
+layout: page
+title: "Rflink Sensor"
+description: "Instructions how to integrate Rflink sensors into Home Assistant."
+date: 2016-01-04
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: rflink.png
+ha_category: Sensor
+ha_release: 0.38
+---
+
+The `rflink` component support devices that use [Rflink gateway firmware](http://www.nemcon.nl/blog2/), for example the [Nodo Rflink Gateway](https://www.nodo-shop.nl/nl/21-rflink-gateway). Rflink gateway is an Arduino firmware that allows communication with 433Mhz devices using cheap hardware (Arduino + 433Mhz tranceiver).
+
+First you have to set up your [rflink hub](/components/rflink/).
+
+After configuring the Rflink hub sensors will be automatically discovered and added.
+
+New/unknown sensors can be assigned to a default group automatically by specifying the `new_devices_group` option with a group name. If the group doesn't exist it will be created.
+
+For example:
+
+```yaml
+# Example configuration.yaml entry
+sensor:
+  platform: rflink
+  new_devices_group: "New Rflink Sensors"
+```
+
+Rflink sensor ID's are composed of: protocol, id and type (optional). For example: `alectov1_0334_temp`. Some sensors emit multiple types of data. Each will be created as its own
+
+Once the ID of a sensor is known it can be used to configure the sensor in HA, for example to add it to a different group, hide it or configure a nice name.
+
+Assigning name to a sensor:
+
+```yaml
+# Example configuration.yaml entry
+sensor:
+  platform: rflink
+  devices:
+    # assign name to a sensor
+    alectov1_0334_temp:
+      name: Temperature Outside
+```
+
+Configuration variables:
+
+- **devices**  (*Optional*): A list of devices with their name to use in the frontend.
+- **new_devices_group** (*Optional*): Create group to add new/unknown devices to.
+
+Device configuration variables:
+
+- **name** (*Optional*): Name for the device, defaults to Rflink ID.
+- **sensor_type_** (*Optional*): Override automatically detected type of sensor.
+- **unit_of_measurement** (*Optional*): Override automatically detected unit of sensor.
+- **aliasses** (*Optional*): Alternative Rflink ID's this device is known by.
+
+### {% linkable_title Hiding/ignoring sensors %}
+
+Sensors are added automatically when the Rflink gateway intercepts a 433Mhz command in the ether. To prevent cluttering the frontend use any of these methods:
+
+- Configure a `new_devices_group` for sensors and optionally add it to a different `view`.
+- Hide unwanted devices using [customizations](/getting-started/customizing-devices/)
+- [Ignore devices on a platform level](/components/rflink/#ignoring-devices)
+
+### {% linkable_title Device support %}
+
+See [device support](/components/rflink/#device-support)
+

source/_components/sensor.systemmonitor.markdown

@@ -25,7 +25,6 @@ sensor:
       - type: disk_use_percent
         arg: /home
       - type: memory_free
-      - type: processor_use
 ```
 
 Configuration variables:
@@ -47,6 +46,9 @@ The table contains types and their argument to use in your `configuration.yaml`
 | swap_use_percent    |                          |
 | swap_use            |                          |
 | swap_free           |                          |
+| load_1m             |                          |
+| load_5m             |                          |
+| load_15m            |                          |
 | network_in          | Interface, eg. `eth0`    |
 | network_out         | Interface, eg. `eth0`    |
 | packets_in          | Interface, eg. `eth0`    |

source/_components/sensor.template.markdown

@@ -36,6 +36,7 @@ Configuration variables:
   - **friendly_name** (*Optional*): Name to use in the Frontend.
   - **unit_of_measurement** (*Optional*): Defines the units of measurement of the sensor, if any.
   - **value_template** (*Required*): Defines a [template](/topics/templating/) to extract a value from the event bus.
+  - **icon_template** (*Optional*): Defines a [template](/topics/templating/) for the icon of the sensor.
   - **entity_id** (*Optional*): Add a list of entity IDs so the sensor only reacts to state changes of these entities. This will reduce the number of times the sensor will try to update it's state.
 
 
@@ -136,3 +137,18 @@ sensor:
         unit_of_measurement: 'kB/s'
 ```
 
+### {% linkable_title Change the icon %}
+
+This example shows how to change the icon based on the day/night cycle.
+
+```yaml
+sensor:
+  - platform: template
+    sensors:
+      day_night:
+        friendly_name: 'Day/Night'
+        value_template: {% raw %}'{% if is_state("sun.sun", "above_horizon") %}Day{% else %}Night{% endif %}'{% endraw %}
+        icon_template: {% raw %}'{% if is_state("sun.sun", "above_horizon") %}mdi:weather-sunny{% else %}mdi:weather-night{% endif %}'{% endraw %}
+        
+```
+

source/_components/switch.broadlink.markdown

@@ -100,7 +100,6 @@ switch 2:
 
 ``` 
  
-
  Example config for sp1, sp2, honeywell_sp2, sp3, spmini2 and spminiplus devices:
 
 ```yaml
@@ -121,6 +120,28 @@ switch 2:
 ``` 
 
 
+### {% linkable_title Service `send_packet` %}
+
+You can use the service broadlink/send_packet to directly send IR packets without the need to assign a switch entity for each command. 
+
+| Service data attribute | Optional | Description |
+| ---------------------- | -------- | ----------- |
+| `packet` | no | String or list of strings that contain the packet data.
+
+Example:
+
+```yaml
+script:
+  tv_select_source:
+    sequence:
+      - service: broadlink.send_packet_192_168_0_107
+        data:
+          packet: 
+            - "JgCMAJSSFDYUNhQ2FBEUERQRFBEUERQ2FDYUNhQRFBEUERQRFBEUERQRFDYUERQRFBEUERQRFDYUNhQRFDYUNhQ2FDYUNhQABfWUkhQ2FDYUNhQRFBEUERQRFBEUNhQ2FDYUERQRFBEUERQRFBEUERQ2FBEUERQRFBEUERQ2FDYUERQ2FDYUNhQ2FDYUAA0FAAAAAAAAAAAAAAAA"
+            - "JgBGAJSTFDUUNhM2ExITEhMSExITEhM2EzYTNhQRFBEUERQRFBEUNRQ2ExITNhMSExITNhMSExITEhM2ExITNhQ1FBEUNhMADQUAAA=="
+``` 
+
+
 ### {% linkable_title Using E-Control Remotes %}
 
 If you already have your remotes learned on E-Control app you can use this method to "copy" trem to HA.

source/_components/switch.fritzdect.markdown

@@ -0,0 +1,42 @@
+---
+layout: page
+title: "AVM FRITZ!DECT Switch"
+description: "Instructions how to integrate your AVM FRITZ!DECT switches into Home Assistant."
+date: 2017-01-24 21:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: avm.png
+ha_category: Switch
+ha_iot_class: "Local Polling"
+ha_release: 0.38
+---
+
+
+The `fritzdect` switch platform allows you to control the state of your [AVM FRITZ!DECT DECT-based wireless switches](https://en.avm.de/products/fritzdect/). The AVM FRITZ!DECT switches need to be paired to your Fritz!Box and then can be monitored and controlled via Home Assistant.
+
+Supported devices (tested):
+
+- FRITZ!DECT 200
+
+Supported Firmwares (tested):
+
+- FRITZ!OS: 06.80 / FRITZ!DECT: 03.83
+- FRITZ!OS: 06.60 / FRITZ!DECT: 03.83
+
+To use your AVM FRITZ!DECT switch(es) in your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+switch:
+  - platform: fritzdect
+    username: YOUR_USERNAME
+    password: YOUR_PASSWORD
+```
+
+Configuration variables:
+
+- **username** (*Required*): The username for your Fritz!Box.
+- **password** (*Required*): The password for your Fritz!Box.
+- **host** (*Optional*): The IP address/hostname of your Fritz!Box. Defaults to `fritz.box`.

source/_components/switch.mysensors.markdown

@@ -203,4 +203,4 @@ void incomingMessage(const MyMessage &message) {
 ```
 
 [main component]: /components/mysensors/
-[serial api]: https://www.mysensors.org/download/serial_api_15
+[serial api]: http://www.mysensors.org/download

source/_components/switch.rflink.markdown

@@ -0,0 +1,82 @@
+---
+layout: page
+title: "Rflink Switch"
+description: "Instructions how to integrate Rflink switches into Home Assistant."
+date: 2016-01-04
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: rflink.png
+ha_category: Switch
+ha_release: 0.38
+---
+
+The `rflink` component support devices that use [Rflink gateway firmware](http://www.nemcon.nl/blog2/), for example the [Nodo Rflink Gateway](https://www.nodo-shop.nl/nl/21-rflink-gateway). Rflink gateway is an Arduino firmware that allows communication with 433Mhz devices using cheap hardware (Arduino + 433Mhz tranceiver).
+
+First you have to set up your [rflink hub](/components/rflink/).
+
+The Rflink component does not know the difference between a `switch` and a `light`. Therefore all switchable devices are automatically added as `light` by default.
+
+Rflink switch/light ID's are composed of: protocol, id, switch. For example: `newkaku_0000c6c2_1`.
+
+Once the ID of a switch is known it can be used to configure it as a switch type in HA, for example to add it to a different group, hide it or configure a nice name.
+
+Configuring a device as switch with a nice name:
+
+```yaml
+# Example configuration.yaml entry
+switch:
+  platform: rflink
+  device_defaults:
+    fire_event: true
+    signal_repetitions: 2
+  devices:
+    newkaku_0000c6c2_1:
+      name: Ceiling fan
+      icon: mdi:fan
+    conrad_00785c_0a:
+      name: Motion sensor kitchen
+      icon: mdi:run
+
+```
+
+Configuration variables:
+
+- **devices** (*Optional*): A list of devices with their name to use in the frontend.
+- **device_defaults**: (*Optional*)
+  - **fire_event_** (*Optional*): Set default `fire_event` for Rflink switch devices (see below).
+  - **signal_repetitions** (*Optional*): Set default `signal_repetitions` for Rflink switch devices (see below).
+
+Device configuration variables:
+
+- **name** (*Optional*): Name for the device, defaults to Rflink ID.
+- **aliasses** (*Optional*): Alternative Rflink ID's this device is known by.
+- **fire_event_** (*Optional*): Fire an `button_pressed` event if this device is turned on or off (default: False).
+- **signal_repetitions** (*Optional*): Repeat every Rflink command this number of times (default: 1)
+
+### {% linkable_title Switch state %}
+
+Initially the state of a switch is unknown. When the switch is turned on or off (via frontend or 433Mhz remote) the state is known and will be shown in the frontend.
+
+Sometimes a switch is controlled by multiple 433Mhz remotes, each remote has its own code programmed in the switch. To allow tracking of the state when switched via other remotes add the corresponding remote codes as aliasses:
+
+```yaml
+# Example configuration.yaml entry
+switch:
+  platform: rflink
+  devices:
+    newkaku_0000c6c2_1:
+      name: Ceiling fan
+      icon: mdi:fan
+      aliasses:
+        - newkaku_000000001_2
+        - kaku_000001_a
+```
+
+Any on/off command from any alias ID updates the current state of the switch. However when sending a command through the frontend only the primary ID is used.
+
+### {% linkable_title Device support %}
+
+See [device support](/components/rflink/#device-support)
+

source/_cookbook/automation_flashing_lights.markdown

@@ -12,7 +12,7 @@ ha_category: Automation Examples
 
 #### {% linkable_title Flashing lights triggered by an alarm %}
 
-For flashing regular lights in case the the triggering of an alarm.
+For flashing regular lights in case an alarm is triggered.
 
 ```yaml
 # AlmAct1 - switch to activate the alarm in Room1

source/_cookbook/custom_ui_by_andrey-git.markdown

@@ -0,0 +1,12 @@
+---
+layout: page
+title: "Custom UI light state-card by andrey-git"
+description: ""
+date: 2017-02-04 10:45
+sidebar: true
+comments: false
+sharing: true
+footer: true
+ha_category: User Interface
+ha_external_link: https://github.com/andrey-git/home-assistant-custom-ui
+---

source/_ecosystem/ios.markdown

@@ -33,7 +33,7 @@ Currently, the app is only available via a closed beta. It will be on the App St
 
 The `ios` component is the companion component for the Home Assistant iOS app. While not required, adding the `ios` component to your setup will greatly enhance the iOS app with new notification, location and sensor functions not possible with a standalone app.
 
-Loading the `ios` component will also load the [`device_tracker`][device-tracker] and [`zeroconf`][zeroconf] components. It also provides functionality required for the iOS notify platform but will not automatically load the `notify` component or platform as of 0.31.1. You must manually load it. See the [iOS notify platform][ios-notify] for more information.
+Loading the `ios` component will also load the [`device_tracker`][device-tracker], [`zeroconf`][zeroconf] and [`notify`][notify] platforms.
 
 ## {% linkable_title Setup %}
 

source/_ecosystem/ios/notifications.markdown

@@ -11,14 +11,4 @@ footer: true
 
 The `ios` notify platform enables sending push notifications to the Home Assistant iOS app.
 
-## {% linkable_title Setup %}
+The 'ios' component will automatically load the notify serivce. No extra configuration is needed or supported.
-
-```yaml
-# Example configuration.yaml entry
-notify:
-  - platform: ios
-```
-
-Configuration variables:
-
-- **name** (*Optional*): The name of the service.

source/_includes/asides/developers_navigation.html

@@ -58,6 +58,7 @@
           <li>{% active_link /developers/frontend_add_card/ Add State Card %}</li>
           <li>{% active_link /developers/frontend_add_more_info/ Add More Info Dialog %}</li>
           <li>{% active_link /developers/frontend_creating_custom_panels/ Add Custom Panels %}</li>
+          <li>{% active_link /developers/frontend_creating_custom_ui/ Add Custom UI %}</li>
         </ul>
       </li>
       <li>

source/_posts/2017-02-11-alert-appletv-mqtt-yeelight.markdown

@@ -0,0 +1,199 @@
+---
+layout: post
+title: "0.38: Alert, AppleTV, MQTT discovery, and Yeelight"
+description: "Faster and more configurable frontend, "
+date: 2017-02-11 08:04:05 +0000
+date_formatted: "February 11, 2017"
+author: Robbie Trencheny, Fabian Affolter
+author_twitter: robbie
+comments: true
+categories: Release-Notes
+og_image: /images/blog/2017-02-0.38/social.png
+---
+
+Another Saturday, another release!
+
+### {% linkable_title Core updates %}
+- Thanks to [@pvizeli], all the core components are now written asynchronously. All entity components are now migrated from synchronously to asynchronously code!
+
+- Now when you restart Home Assistant using the `homeassistant.restart` service, your configuration is checked. If it appears to be invalid the restart will fail.
+
+### {% linkable_title Rewritten frontend %}
+The frontend has been completely been rewritten, optimizing for speed and lost connection recovery. Even on the slowest phones it should fly now. The frontend also now uses the new [WebSockets API][websocket-api] instead of the [EventStream API][event-stream-api].
+
+### {% linkable_title Custom state card UI %}
+A nice new feature is the possibility to create [custom state cards][custom-ui] in the frondend. Go ahead and write your own state card for [lights][light], sensors, locks, etc.
+
+### {% linkable_title MQTT discovery %}
+MQTT now has [discovery][mqtt-discovery] support which is different than our [`discovery`][discovery] component. Similar to the HTTP sensor and HTTP binary sensor, MQTT discovery removes the need for configuration by allowing devices to make their presence known to Home Assistant.
+
+### {% linkable_title Alert component %}
+If you left your front door open, then the new [`alert`][alert] component can be used to remind you of this by sending you repeating notifications at a given interval.
+
+### {% linkable_title Yeelight %}
+The [`yeelight`][yeelight] component has been ported to use a more stable and feature-complete [python-yeelight][python-yeelight] backend, and supports now both white and RGB bulbs. The component also supports transitions and can be configured to save the settings to the bulb on changes. The users currently using custom components for Yeelight are encouraged to move back to use the included version and report any problems with it to our [issue tracker][issue].
+
+### {% linkable_title Apple TV %}
+[Apple TV][apple-tv] is now a supported [`media_player`][media-player]! It has support for just about every media player function, including a realtime display of playback status and artwork.
+
+### {% linkable_title All changes %}
+#### {% linkable_title New platforms/components %}
+
+- Sensor: Support for monitoring [OpenEVSE][openevse] chargers ([@miniconfig])
+- Voice command [API.AI][apiai] ([@adrianlzt])
+- [Alert][alert] Component ([@rmkraus])
+- [Rflink][rflink] 433Mhz gateway platform and components ([@aequitas])
+- Lock: Support for [Nuki.io][nuki] smart locks ([@pschmitt])
+- Sensor: [QNAP][qnap] Sensor ([@colinodell])
+- Switch: Add support for [FRITZ!DECT][fritz] wireless switches based on fritzhome ([@BastianPoe])
+- Sensor: Add [moon][moon] sensor ([@fabaff])
+- Media player: Support for the [Orange Livebox Play TV][orange] appliance ([@pschmitt])
+- Media player: [Apple TV][apple-tv] support ([@postlund])
+- MQTT: [MQTT discovery][mqtt-discovery] support ([@balloob], [@fabaff])
+- Notify: [Mailgun][mailgun] notify service ([@pschmitt])
+- Image Processing: Support [Microsoft Face detection][face-detect] ([@pvizeli])
+
+#### {% linkable_title Improvements %}
+
+- Switch - Pilight: Validation no longer rejects alphanumeric IDs ([@DavidLP])
+- Device tracker - ASUSWrt: Fixes `ip neigh` regex to handle the possible IPv6 "router" flag ([@kylehendricks])
+- Light - MySensors: Fix mysensors RGB and W light turn on ([@MartinHjelmare])
+- Light - Yeelight: new yeelight backend lib, new features ([@rytilahti])
+- Climate - Eq3btsmart: Cleanup modes & available, bump version requirement ([@rytilahti])
+- Sensor - SMA: Handle units correctly ([@kellerza])
+- MQTT eventstream: Prevent infinite loop in cross configured MQTT event streams ([@aequitas])
+- Light - [Hue][hue]: Fix lightgroups not syncing state ([@tboyce1])
+- Dvice tracker - Owntracks: Fix OwnTracks state names ([@tboyce1])
+- Wink: Wink AC and additional sensor support ([@w1ll1am23])
+- Modbus: Modbus write_register accept list ([@benvm])
+- Device tracker - Ping: Add devices detected by ping as SOURCE_TYPE_ROUTER instead of GPS ([@michaelarnauts])
+- Climate - Ecobee: Cleanup climate and ecobee ([@Duoxilian])
+- Sensor - Miflora: Allow specification of bluetooth adapter ([@Danielhiversen])
+- Sensor - [Systemmonitor][systemmonitor]: Add average load to systemmonitor ([@eagleamon])
+- Sensor - [Openweathermap][owm]: Add wind bearing ([@fabaff])
+- Notify - Facebook: Allow to use data for enhanced messages ([@adrianlzt])
+- Light - Hyperion: Change CONF_DEFAULT_COLOR CV type ([@Joeboyc2])
+- Mysensors: Fix validation of serial port on windows ([@MartinHjelmare])
+- Notify - Webostv: Store the key file in the configuration directory ([@pschmitt])
+- TTS: TTS ID3 support ([@robbiet480])
+- Switch - Broadlink: Add send packet service ([@Yannic-HAW])
+- Wink: Add support for position on Wink cover ([@albertoarias])
+- Light - Flux: Make brightness display work for RGB devices. ([@aequitas])
+- Media player - Roku: Fix attribute error for media_player/roku ([@tchellomello])
+- Light - MQTT template: Fix brightness slider for MQTT template lights ([@ray0711])
+- Template: Add `min` and `max` Jinja2 [filters][filters] ([@sbidoul])
+- Device tracker - Skyhub: Improve Sky Hub error handling ([@alexmogavero])
+- Notify - SMTP: Add error checking to the MIMEImage encoding ([@stratosmacker])
+- Light - MQTT: Check for command topics when determining the capabilities of an MQTT light ([@herm])
+- Core: Check config before restarting ([@andrey-git])
+- Light - [Hue][hue]: Fix groups with same names ([@tboyce1])
+- Template: Add icon_template to template sensor ([@tboyce1])
+- Recorder: Refactoring, scoping, and better handling of SQLAlchemy Sessions ([@kellerza])
+- Light - Flux: Add support for fluxled discovery. ([@aequitas])
+- Media player - AppleTV: Add discovery support to Apple TV ([@postlund])
+- Sensor - Template: Improve warning message in template rendering ([@Danielhiversen])
+- Light - Demo: Add available property and typing hints ([@rytilahti])
+- Sensor - ARWN: Enhancements to [ARWN][arwn] platform ([@sdague])
+- Fan - ISY994: Change medium state for filtering ([@Teagan42])
+- Climate - Ecobee: Support away_mode as permanent hold and hold_mode as temporary hold. ([@Duoxilian])
+- Tellduslive: Don't throw exception if connection to server is lost ([@molobrakos])
+- Zoneminder: Refactoring and JSON decode error handling ([@pschmitt])
+- Image processing: Cleanup Base face class add support for microsoft face detect ([@pvizeli])
+
+Bugfixes: [@balloob], [@fabaff], [@pvizeli], [@mnoorenberghe] [@Danielhiversen], [@armills], [@tchellomello], [@aequitas], [@mathewpeterson], [@molobrakos], [@michaelarnauts], [@jabesq], [@turbokongen], [@JshWright], [@andriej], [@jawilson], [@andrey-git], [@nodinosaur], [@konikvranik], and you if you are missing here.
+
+### {% linkable_title Breaking changes %}
+- The support for [LG webOS Smart TVs][webostv] was improved. This requires you to move `$HOME/.pylgtv` to `$HASS_CONFIG_DIR/webostv.conf` or Home Assistant will need to be paired with the TV again.
+- Image processing events have been renamed: `identify_face` has become `image_processing.detect_face`, `found_plate` has become `image_processing.found_plate`
+- The [FFmpeg binary sensor][ffmpeg-bin] change the platform name from `ffmpeg` to `ffmpeg_noise` and `ffmpeg_motion`. Also all FFmpeg-related services are moved from a platform implementation to a the [FFmpeg components][ffmpeg] and were rename from `binary_sensor.ffmpeg_xy` to `ffmpeg.xy`.
+
+### {% linkable_title If you need help... %}
+...don't hesitate to use our very active [forums][forum] or join us for a little [chat][gitter]. The release notes have comments enabled but it's preferred if you use the former communication channels. Thanks.
+
+### {% linkable_title Reporting Issues %}
+Experiencing issues introduced by this release? Please report them in our [issue tracker][issue]. Make sure to fill in all fields of the issue template.
+
+[@acambitsis]: https://github.com/acambitsis
+[@adrianlzt]: https://github.com/adrianlzt
+[@aequitas]: https://github.com/aequitas
+[@albertoarias]: https://github.com/albertoarias
+[@alexmogavero]: https://github.com/alexmogavero
+[@andrey-git]: https://github.com/andrey-git
+[@andriej]: https://github.com/andriej
+[@armills]: https://github.com/armills
+[@balloob]: https://github.com/balloob
+[@BastianPoe]: https://github.com/BastianPoe
+[@benvm]: https://github.com/benvm
+[@colinodell]: https://github.com/colinodell
+[@Danielhiversen]: https://github.com/Danielhiversen
+[@DavidLP]: https://github.com/DavidLP
+[@Duoxilian]: https://github.com/Duoxilian
+[@eagleamon]: https://github.com/eagleamon
+[@fabaff]: https://github.com/fabaff
+[@herm]: https://github.com/herm
+[@jabesq]: https://github.com/jabesq
+[@jawilson]: https://github.com/jawilson
+[@Joeboyc2]: https://github.com/Joeboyc2
+[@JshWright]: https://github.com/JshWright
+[@kellerza]: https://github.com/kellerza
+[@konikvranik]: https://github.com/konikvranik
+[@kylehendricks]: https://github.com/kylehendricks
+[@LinuxChristian]: https://github.com/LinuxChristian
+[@MartinHjelmare]: https://github.com/MartinHjelmare
+[@mathewpeterson]: https://github.com/mathewpeterson
+[@michaelarnauts]: https://github.com/michaelarnauts
+[@miniconfig]: https://github.com/miniconfig
+[@mnoorenberghe]: https://github.com/mnoorenberghe
+[@molobrakos]: https://github.com/molobrakos
+[@nodinosaur]: https://github.com/nodinosaur
+[@postlund]: https://github.com/postlund
+[@pschmitt]: https://github.com/pschmitt
+[@pvizeli]: https://github.com/pvizeli
+[@ray0711]: https://github.com/ray0711
+[@rmkraus]: https://github.com/rmkraus
+[@robbiet480]: https://github.com/robbiet480
+[@rytilahti]: https://github.com/rytilahti
+[@sbidoul]: https://github.com/sbidoul
+[@sdague]: https://github.com/sdague
+[@stratosmacker]: https://github.com/stratosmacker
+[@tboyce1]: https://github.com/tboyce1
+[@tchellomello]: https://github.com/tchellomello
+[@Teagan42]: https://github.com/Teagan42
+[@turbokongen]: https://github.com/turbokongen
+[@valentinalexeev]: https://github.com/valentinalexeev
+[@w1ll1am23]: https://github.com/w1ll1am23
+[@Yannic-HAW]: https://github.com/Yannic-HAW
+
+[alert]: https://home-assistant.io/components/alert/
+[apiai]: https://home-assistant.io/components/apiai/
+[apple-tv]: https://home-assistant.io/components/media_player.apple_tv/
+[arwn]: https://home-assistant.io/components/sensor.arwn/
+[custom-ui]: https://home-assistant.io/developers/frontend_creating_custom_ui/
+[discovery]: https://home-assistant.io/components/discovery/
+[face-detect]: https://home-assistant.io/components/image_processing.microsoft_face_detect/
+[ffmpeg-bin]: https://home-assistant.io/components/binary_sensor.ffmpeg/
+[ffmpeg]: https://home-assistant.io/components/ffmpeg/
+[filters]: https://home-assistant.io/topics/templating/#home-assistant-template-extensions
+[fritz]: https://home-assistant.io/components/switch.fritzdect/
+[hue]: https://home-assistant.io/components/light.hue/
+[light]: https://home-assistant.io/cookbook/custom_ui_by_andrey-git
+[mailgun]: https://home-assistant.io/components/notify.mailgun/
+[media-player]: https://home-assistant.io/components/media_player/
+[moon]: https://home-assistant.io/components/sensor.moon/
+[mqtt-discovery]: https://home-assistant.io/components/mqtt/#discovery
+[nuki]: https://home-assistant.io/components/lock.nuki/
+[openevse]: https://home-assistant.io/components/sensor.openevse/
+[orange]: https://home-assistant.io/components/media_player.liveboxplaytv/
+[owm]: https://home-assistant.io/components/sensor.openweathermap/
+[python-yeelight]: https://gitlab.com/stavros/python-yeelight
+[qnap]: https://home-assistant.io/components/sensor.qnap/
+[rflink]: https://home-assistant.io/components/rflink/
+[systemmonitor]: https://home-assistant.io/components/sensor.systemmonitor/
+[webostv]: https://home-assistant.io/components/media_player.webostv/
+[yeelight]: https://home-assistant.io/components/light.yeelight/
+
+[event-stream-api]: https://home-assistant.io/developers/server_sent_events/
+[forum]: https://community.home-assistant.io/
+[gitter]: https://gitter.im/home-assistant/home-assistant
+[issue]: https://github.com/home-assistant/home-assistant/issues
+[websocket-api]: https://home-assistant.io/developers/websocket_api/

source/_topics/templating.markdown

@@ -83,6 +83,8 @@ Home Assistant adds extensions to allow templates to access all of the current s
 - Filter `timestamp_local`  will convert an UNIX timestamp to local time/data.
 - Filter `timestamp_utc` will convert an UNIX timestamp to UTC time/data.
 - Filter `timestamp_custom(format_string, local_boolean)` will convert an UNIX timestamp to a custom format, the use of a local timestamp is default, supporting [Python format options](https://docs.python.org/3/library/time.html#time.strftime).
+- Filter `max` will obtain the larget item in a sequence.
+- Filter `min` will obtain the smallest item in a sequence.
 
 [strp-format]: https://docs.python.org/3.4/library/datetime.html#strftime-and-strptime-behavior
 

source/developers/credits.markdown

@@ -2,7 +2,7 @@
 layout: page
 title: "Credits"
 description: "Credits for the developers who contributed to Home Assistant."
-date: 2017-01-22 03:58:53 +0000
+date: 2017-02-11 21:38:58 +0000
 sidebar: true
 comments: false
 sharing: true
@@ -13,7 +13,7 @@ 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 "4759 total commits to the home-assistant organization, 3008 commits to home-assistant, 941 commits to home-assistant.github.io, 449 commits to home-assistant-polymer, 243 commits to home-assistant-js, 79 commits to netdisco, 21 commits to home-assistant-js-websocket, 8 commits to home-assistant-assets, 7 commits to micropython-home-assistant, 2 commits to lambda-home-assistant-github, 1 commit to home-assistant-notebooks")
+- [Paulus Schoutsen (@balloob)](https://github.com/balloob "4870 total commits to the home-assistant organization, 3051 commits to home-assistant, 970 commits to home-assistant.github.io, 474 commits to home-assistant-polymer, 244 commits to home-assistant-js, 79 commits to netdisco, 33 commits to home-assistant-js-websocket, 8 commits to home-assistant-assets, 7 commits to micropython-home-assistant, 2 commits to lambda-home-assistant-github, 1 commit to home-assistant-iOS, 1 commit to home-assistant-notebooks")
 
 ### {% linkable_title Contributors %}
 
@@ -22,19 +22,22 @@ This page contains a list of people who have contributed in one way or another t
 - [Aaron Linville (@linville)](https://github.com/linville "1 total commits to the home-assistant organization, 1 commit to appdaemon")
 - [Aaron Malone (@aaroncm)](https://github.com/aaroncm "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [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 "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
 - [Abhishek Anand (@aa755)](https://github.com/aa755 "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
 - [abmantis (@abmantis)](https://github.com/abmantis "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [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 "52 total commits to the home-assistant organization, 32 commits to home-assistant, 14 commits to home-assistant-polymer, 3 commits to home-assistant-js, 3 commits to home-assistant.github.io")
+- [Adam Mills (@armills)](https://github.com/armills "70 total commits to the home-assistant organization, 41 commits to home-assistant, 16 commits to home-assistant-polymer, 10 commits to home-assistant.github.io, 3 commits to home-assistant-js")
 - [ADeeds (@ADeeds)](https://github.com/ADeeds "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [AdithyanI (@AdithyanI)](https://github.com/AdithyanI "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Aditya Shevade (@adibis)](https://github.com/adibis "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Adrien Brault (@adrienbrault)](https://github.com/adrienbrault "2 total commits to the home-assistant organization, 2 commits to home-assistant")
+- [Adrián López (@adrianlzt)](https://github.com/adrianlzt "5 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to home-assistant")
 - [Alan Bowman (@alanbowman)](https://github.com/alanbowman "5 total commits to the home-assistant organization, 4 commits to home-assistant, 1 commit to home-assistant.github.io")
 - [Albert Lee (@trisk)](https://github.com/trisk "10 total commits to the home-assistant organization, 6 commits to home-assistant, 4 commits to home-assistant.github.io")
-- [Alberto Arias Maestro (@albertoarias)](https://github.com/albertoarias "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Alberto Arias Maestro (@albertoarias)](https://github.com/albertoarias "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Aleksey Gureiev (@alg)](https://github.com/alg "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Alex (@asbach)](https://github.com/asbach "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Alessandro Mogavero (@alexmogavero)](https://github.com/alexmogavero "2 total commits to the home-assistant organization, 2 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 Harvey (@infamy)](https://github.com/infamy "21 total commits to the home-assistant organization, 11 commits to home-assistant, 10 commits to home-assistant.github.io")
 - [Alex Mekkering (@AlexMekkering)](https://github.com/AlexMekkering "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Alex Popov (@AlexVPopov)](https://github.com/AlexVPopov "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
@@ -46,19 +49,20 @@ This page contains a list of people who have contributed in one way or another t
 - [Alexandre Perrin (@kAworu)](https://github.com/kAworu "4 total commits to the home-assistant organization, 4 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")
 - [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 "37 total commits to the home-assistant organization, 21 commits to home-assistant.github.io, 16 commits to home-assistant")
+- [Alok Saboo (@arsaboo)](https://github.com/arsaboo "45 total commits to the home-assistant organization, 29 commits to home-assistant.github.io, 16 commits to home-assistant")
 - [AlucardZero (@AlucardZero)](https://github.com/AlucardZero "13 total commits to the home-assistant organization, 9 commits to home-assistant.github.io, 4 commits to home-assistant")
 - [amahlaka (@amahlaka)](https://github.com/amahlaka "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io")
 - [amorsillo (@fignuts)](https://github.com/fignuts "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [Anastasia A. (@Sacret)](https://github.com/Sacret "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Anders Gjendem (@agjendem)](https://github.com/agjendem "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [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 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Andreas Rammhold (@andir)](https://github.com/andir "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [Andreas Renberg (@IQAndreas)](https://github.com/IQAndreas "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Andreea-Daniela Ene (@AndreeaEne)](https://github.com/AndreeaEne "3 total commits to the home-assistant organization, 3 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 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [Andrew Cockburn (@acockburn)](https://github.com/acockburn "222 total commits to the home-assistant organization, 107 commits to appdaemon, 82 commits to hadashboard, 25 commits to scenegen, 8 commits to home-assistant.github.io")
+- [Andrew Cockburn (@acockburn)](https://github.com/acockburn "237 total commits to the home-assistant organization, 122 commits to appdaemon, 82 commits to hadashboard, 25 commits to scenegen, 8 commits to home-assistant.github.io")
 - [Andrew LeCody (@aceat64)](https://github.com/aceat64 "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
 - [Andrew McClure (@nzfarmer1)](https://github.com/nzfarmer1 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Andrew Patton (@acusti)](https://github.com/acusti "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
@@ -67,8 +71,8 @@ This page contains a list of people who have contributed in one way or another t
 - [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 "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
-- [andrey-git (@andrey-git)](https://github.com/andrey-git "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")
+- [Andrey (@andrey-git)](https://github.com/andrey-git "37 total commits to the home-assistant organization, 17 commits to home-assistant, 12 commits to home-assistant.github.io, 8 commits to home-assistant-polymer")
-- [Andrzej (@andriej)](https://github.com/andriej "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [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")
 - [Andy Lindeman (@alindeman)](https://github.com/alindeman "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Andy Loughran (@andylockran)](https://github.com/andylockran "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [andyat (@andyat)](https://github.com/andyat "2 total commits to the home-assistant organization, 2 commits to home-assistant")
@@ -79,6 +83,7 @@ This page contains a list of people who have contributed in one way or another t
 - [Anurag El Dorado (@aedorado)](https://github.com/aedorado "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [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")
 - [Arnaud Bétrémieux (@arnoo)](https://github.com/arnoo "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [Arno (@aetjansen)](https://github.com/aetjansen "1 total commits to the home-assistant organization, 1 commit 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")
@@ -92,12 +97,15 @@ This page contains a list of people who have contributed in one way or another t
 - [Bart274 (@Bart274)](https://github.com/Bart274 "25 total commits to the home-assistant organization, 17 commits to home-assistant, 7 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
 - [Bartek Celary (@bcelary)](https://github.com/bcelary "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Bas Stottelaar (@basilfx)](https://github.com/basilfx "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [bbrendon (@bbrendon)](https://github.com/bbrendon "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Beau Simensen (@simensen)](https://github.com/simensen "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Ben Bangert (@bbangert)](https://github.com/bbangert "5 total commits to the home-assistant organization, 4 commits to home-assistant, 1 commit to home-assistant.github.io")
 - [Ben Doerr (@bendoerr)](https://github.com/bendoerr "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Ben Miller (@beepmill)](https://github.com/beepmill "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Ben Origas (@borigas)](https://github.com/borigas "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
 - [Ben Thomas (@wazoo)](https://github.com/wazoo "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
+- [Ben Van Mechelen (@benvm)](https://github.com/benvm "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Benjamin Affolter (@bliemli)](https://github.com/bliemli "30 total commits to the home-assistant organization, 30 commits to home-assistant-ansible")
 - [Benjamin Bryan (@ahnooie)](https://github.com/ahnooie "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [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 "9 total commits to the home-assistant organization, 6 commits to home-assistant, 3 commits to home-assistant.github.io")
@@ -106,6 +114,7 @@ This page contains a list of people who have contributed in one way or another t
 - [blackdog70 (@blackdog70)](https://github.com/blackdog70 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Blanyal D'Souza (@blanyal)](https://github.com/blanyal "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Boced66 (@boced66)](https://github.com/boced66 "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [Boris K (@bokub)](https://github.com/bokub "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Brad Buran (@bburan)](https://github.com/bburan "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Brad Johnson (@bradsk88)](https://github.com/bradsk88 "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [BradleyDHobbs (@BradleyDHobbs)](https://github.com/BradleyDHobbs "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
@@ -114,18 +123,19 @@ This page contains a list of people who have contributed in one way or another t
 - [Brandon Weeks (@brandonweeks)](https://github.com/brandonweeks "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Brendan Berg (@captainnapalm)](https://github.com/captainnapalm "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Brent Hughes (@bah2830)](https://github.com/bah2830 "25 total commits to the home-assistant organization, 16 commits to home-assistant, 8 commits to home-assistant.github.io, 1 commit to netdisco")
-- [Brian J King (@brianjking)](https://github.com/brianjking "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
+- [Brent Saltzman (@brent20)](https://github.com/brent20 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Brian J King (@brianjking)](https://github.com/brianjking "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
 - [Brian Karani Ndwiga (@rayrayndwiga)](https://github.com/rayrayndwiga "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Brian Torres-Gil (@btorresgil)](https://github.com/btorresgil "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Brigham Brown (@brigham)](https://github.com/brigham "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Britton Clapp (@britton-clapp)](https://github.com/britton-clapp "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Bruno Adele (@badele)](https://github.com/badele "22 total commits to the home-assistant organization, 22 commits to home-assistant")
-- [Bryce Edwards (@hoopty)](https://github.com/hoopty "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Bryce Edwards (@hoopty)](https://github.com/hoopty "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Buut (@buut-vrij)](https://github.com/buut-vrij "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [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 "1 total commits to the home-assistant organization, 1 commit 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 "74 total commits to the home-assistant organization, 68 commits to home-assistant.github.io, 5 commits to home-assistant, 1 commit to fabric-home-assistant")
+- [Carlo Costanzo (@CCOSTAN)](https://github.com/CCOSTAN "78 total commits to the home-assistant organization, 71 commits to home-assistant.github.io, 5 commits to home-assistant, 1 commit to fabric-home-assistant, 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")
 - [chanders (@chanders)](https://github.com/chanders "2 total commits to the home-assistant organization, 2 commits to hadashboard")
@@ -133,27 +143,32 @@ This page contains a list of people who have contributed in one way or another t
 - [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")
 - [Chema García (@sch3m4)](https://github.com/sch3m4 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [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 LaRose (@cjlarose)](https://github.com/cjlarose "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Chris Monteiro (@funstuff234)](https://github.com/funstuff234 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [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 R. Miller (@mysteriouspants)](https://github.com/mysteriouspants "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Chris Sims (@jcsims)](https://github.com/jcsims "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [chris-thorn (@chris-thorn)](https://github.com/chris-thorn "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
 - [Christiaan Blom (@Deinara)](https://github.com/Deinara "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
-- [Christian Brædstrup (@LinuxChristian)](https://github.com/LinuxChristian "6 total commits to the home-assistant organization, 5 commits to home-assistant, 1 commit to home-assistant.github.io")
+- [Christian Brædstrup (@LinuxChristian)](https://github.com/LinuxChristian "7 total commits to the home-assistant organization, 6 commits to home-assistant, 1 commit to home-assistant.github.io")
+- [Christian Studer (@cstuder)](https://github.com/cstuder "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Christoph Wagner (@Christoph-Wagner)](https://github.com/Christoph-Wagner "5 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Christopher Viel (@Chris-V)](https://github.com/Chris-V "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [chrom3 (@chrom3)](https://github.com/chrom3 "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Chun-wei Kuo (@Domon)](https://github.com/Domon "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [chz^3 (@chzchzchz)](https://github.com/chzchzchz "1 total commits to the home-assistant organization, 1 commit to pi-gen")
 - [Ciquattro (@CiquattroFPV)](https://github.com/CiquattroFPV "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [clach04 (@clach04)](https://github.com/clach04 "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [clach04 (@clach04)](https://github.com/clach04 "5 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to home-assistant")
 - [Clemens Wolff (@c-w)](https://github.com/c-w "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Cláudio Ribeiro (@DailyMatters)](https://github.com/DailyMatters "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [codeavenger07 (@codeavenger07)](https://github.com/codeavenger07 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [Colin O'Dell (@colinodell)](https://github.com/colinodell "6 total commits to the home-assistant organization, 4 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Colin O'Dell (@colinodell)](https://github.com/colinodell "9 total commits to the home-assistant organization, 5 commits to home-assistant, 4 commits to home-assistant.github.io")
-- [Corban Mailloux (@corbanmailloux)](https://github.com/corbanmailloux "7 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 1 commit to home-assistant")
+- [Cooper Dale (@Cooper-Dale)](https://github.com/Cooper-Dale "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Craig J. Ward (@wardcraigj)](https://github.com/wardcraigj "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to home-assistant.github.io")
+- [Corban Mailloux (@corbanmailloux)](https://github.com/corbanmailloux "13 total commits to the home-assistant organization, 12 commits to home-assistant.github.io, 1 commit to home-assistant")
+- [Craig J. Ward (@wardcraigj)](https://github.com/wardcraigj "6 total commits to the home-assistant organization, 3 commits to home-assistant, 3 commits to home-assistant.github.io")
 - [dainok (@dainok)](https://github.com/dainok "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Dale Higgs (@dale3h)](https://github.com/dale3h "21 total commits to the home-assistant organization, 13 commits to home-assistant.github.io, 7 commits to home-assistant, 1 commit to hassbot")
 - [Dan (@danieljkemp)](https://github.com/danieljkemp "20 total commits to the home-assistant organization, 13 commits to home-assistant, 7 commits to home-assistant.github.io")
@@ -165,24 +180,25 @@ This page contains a list of people who have contributed in one way or another t
 - [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")
 - [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 "248 total commits to the home-assistant organization, 175 commits to home-assistant, 71 commits to home-assistant.github.io, 2 commits to home-assistant-polymer")
+- [Daniel Høyer Iversen (@Danielhiversen)](https://github.com/Danielhiversen "277 total commits to the home-assistant organization, 188 commits to home-assistant, 87 commits to home-assistant.github.io, 2 commits to home-assistant-polymer")
 - [Daniel Matuschek (@usul27)](https://github.com/usul27 "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
-- [Daniel Perna (@danielperna84)](https://github.com/danielperna84 "33 total commits to the home-assistant organization, 22 commits to home-assistant.github.io, 11 commits to home-assistant")
+- [Daniel Perna (@danielperna84)](https://github.com/danielperna84 "41 total commits to the home-assistant organization, 28 commits to home-assistant.github.io, 13 commits to home-assistant")
 - [Daniel Peukert (@dpeukert)](https://github.com/dpeukert "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
+- [Daniel Wiberg (@dannew)](https://github.com/dannew "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Danijel Stojnic (@danijelst)](https://github.com/danijelst "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Daphne L (@daphotron)](https://github.com/daphotron "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [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")
 - [Dave Banks (@djbanks)](https://github.com/djbanks "3 total commits to the home-assistant organization, 2 commits to appdaemon, 1 commit to home-assistant")
 - [DaveSergeant (@dethpickle)](https://github.com/dethpickle "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to home-assistant.github.io")
+- [David (@fanaticDavid)](https://github.com/fanaticDavid "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io")
 - [David (@dschoorisse)](https://github.com/dschoorisse "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [David (@fanaticDavid)](https://github.com/fanaticDavid "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
 - [David Baumann (@daBONDi)](https://github.com/daBONDi "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
 - [David De Sloovere (@DavidDeSloovere)](https://github.com/DavidDeSloovere "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [David McNett (@nugget)](https://github.com/nugget "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
+- [David McNett (@nugget)](https://github.com/nugget "5 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to home-assistant")
 - [David Straub (@DavidMStraub)](https://github.com/DavidMStraub "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [David Tchepak (@dtchepak)](https://github.com/dtchepak "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [David Thomas (@synth3tk)](https://github.com/synth3tk "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [David-Leon Pohl (@DavidLP)](https://github.com/DavidLP "12 total commits to the home-assistant organization, 10 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [David-Leon Pohl (@DavidLP)](https://github.com/DavidLP "14 total commits to the home-assistant organization, 12 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")
 - [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")
@@ -191,14 +207,17 @@ This page contains a list of people who have contributed in one way or another t
 - [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")
 - [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")
+- [diplix (@diplix)](https://github.com/diplix "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Dmytro Kytsmen (@Kietzmann)](https://github.com/Kietzmann "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [doudz (@doudz)](https://github.com/doudz "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [dpressle (@dpressle)](https://github.com/dpressle "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [dramamoose (@dramamoose)](https://github.com/dramamoose "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Drew Wells (@drewwells)](https://github.com/drewwells "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [DrewSK (@dzsquared)](https://github.com/dzsquared "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
-- [Duoxilian (@Duoxilian)](https://github.com/Duoxilian "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Duoxilian (@Duoxilian)](https://github.com/Duoxilian "9 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 4 commits to home-assistant")
 - [Dustin S (@texnofobix)](https://github.com/texnofobix "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Dylan Barlett (@dbarlett)](https://github.com/dbarlett "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [ecksun (@ecksun)](https://github.com/ecksun "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Edward Romano (@oudeismetis)](https://github.com/oudeismetis "1 total commits to the home-assistant organization, 1 commit 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")
 - [eieste (@eieste)](https://github.com/eieste "1 total commits to the home-assistant organization, 1 commit to home-assistant")
@@ -211,14 +230,16 @@ This page contains a list of people who have contributed in one way or another t
 - [Eric Jansen (@ej81)](https://github.com/ej81 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [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 "55 total commits to the home-assistant organization, 51 commits to home-assistant, 2 commits to netdisco, 2 commits to home-assistant.github.io")
+- [Erik Eriksson (@molobrakos)](https://github.com/molobrakos "59 total commits to the home-assistant organization, 55 commits to home-assistant, 2 commits to netdisco, 2 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")
-- [Fabian Affolter (@fabaff)](https://github.com/fabaff "3157 total commits to the home-assistant organization, 1963 commits to home-assistant.github.io, 1060 commits to home-assistant, 49 commits to home-assistant-ansible, 20 commits to home-assistant-notebooks, 19 commits to home-assistant-cli, 18 commits to home-assistant-dev-helper, 10 commits to home-assistant-polymer, 9 commits to home-assistant-assets, 8 commits to netdisco, 1 commit to home-assistant-js-websocket")
+- [Fabian Affolter (@fabaff)](https://github.com/fabaff "3300 total commits to the home-assistant organization, 2066 commits to home-assistant.github.io, 1085 commits to home-assistant, 57 commits to home-assistant-ansible, 23 commits to home-assistant-dev-helper, 21 commits to home-assistant-cli, 20 commits to home-assistant-notebooks, 10 commits to home-assistant-polymer, 9 commits to home-assistant-assets, 8 commits to netdisco, 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")
 - [Farzad Noorian (@fnoorian)](https://github.com/fnoorian "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Felipe Cypriano (@fcy)](https://github.com/fcy "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Felix (@xifle)](https://github.com/xifle "2 total commits to the home-assistant organization, 2 commits to home-assistant")
+- [Felix Fischer (@felixfischer)](https://github.com/felixfischer "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [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, 7 commits to home-assistant, 1 commit to home-assistant.github.io")
 - [Flavio Castelli (@flavio)](https://github.com/flavio "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to home-assistant.github.io")
@@ -228,7 +249,8 @@ This page contains a list of people who have contributed in one way or another t
 - [Frantz (@rofrantz)](https://github.com/rofrantz "3 total commits to the home-assistant organization, 2 commits to netdisco, 1 commit 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 Haglund (@PetitCircuitLab)](https://github.com/PetitCircuitLab "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [Fredrik Lindqvist (@Landrash)](https://github.com/Landrash "46 total commits to the home-assistant organization, 37 commits to home-assistant.github.io, 5 commits to pi-gen, 4 commits to home-assistant")
+- [Fredrik Lindqvist (@Landrash)](https://github.com/Landrash "79 total commits to the home-assistant organization, 44 commits to home-assistant.github.io, 27 commits to hassbian-scripts, 4 commits to home-assistant, 3 commits to pi-gen, 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")
 - [GadgetReactor (@GadgetReactor)](https://github.com/GadgetReactor "2 total commits to the home-assistant organization, 2 commits to home-assistant")
@@ -236,23 +258,24 @@ This page contains a list of people who have contributed in one way or another t
 - [garrettbeachy (@garrettbeachy)](https://github.com/garrettbeachy "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Gaurav Kulkarni (@gauravkulkarni96)](https://github.com/gauravkulkarni96 "1 total commits to the home-assistant organization, 1 commit 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 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [George.M (@nodinosaur)](https://github.com/nodinosaur "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Georgi Kirichkov (@kirichkov)](https://github.com/kirichkov "7 total commits to the home-assistant organization, 4 commits to home-assistant, 3 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 "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Gert (@Gerto)](https://github.com/Gerto "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
-- [Gianluca Barbaro (@MrMep)](https://github.com/MrMep "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 "18 total commits to the home-assistant organization, 12 commits to home-assistant, 6 commits to home-assistant.github.io")
 - [Giannie (@Giannie)](https://github.com/Giannie "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
 - [Giel Janssens (@gieljnssns)](https://github.com/gieljnssns "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Gilles Margerie (@Gilles95)](https://github.com/Gilles95 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Glyn Hudson  (@glynhudson)](https://github.com/glynhudson "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [GMFalka (@GMFalka)](https://github.com/GMFalka "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [godloth (@godloth)](https://github.com/godloth "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io")
+- [godloth (@godloth)](https://github.com/godloth "9 total commits to the home-assistant organization, 9 commits to home-assistant.github.io")
-- [Gopal Kildoliya (@gopalkildoliya)](https://github.com/gopalkildoliya "4 total commits to the home-assistant organization, 4 commits to home-assistant")
+- [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 "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Graham Christensen (@grahamc)](https://github.com/grahamc "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Greg (@theCMack)](https://github.com/theCMack "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Greg Dowling (@pavoni)](https://github.com/pavoni "218 total commits to the home-assistant organization, 193 commits to home-assistant, 23 commits to home-assistant.github.io, 2 commits to netdisco")
+- [Greg MacLellan (@gregmac)](https://github.com/gregmac "1 total commits to the home-assistant organization, 1 commit to pi-gen")
 - [Greg Stevenson (@gstevenson)](https://github.com/gstevenson "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [Gregor Gruener (@ggruner)](https://github.com/ggruner "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
 - [gross1989 (@gross1989)](https://github.com/gross1989 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
@@ -262,7 +285,7 @@ This page contains a list of people who have contributed in one way or another t
 - [gwendalg (@gwendalg)](https://github.com/gwendalg "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Hajime Morrita (@omo)](https://github.com/omo "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Hao Hu (@howiehu)](https://github.com/howiehu "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [happyleavesaoc (@happyleavesaoc)](https://github.com/happyleavesaoc "60 total commits to the home-assistant organization, 49 commits to home-assistant, 10 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
+- [happyleavesaoc (@happyleavesaoc)](https://github.com/happyleavesaoc "62 total commits to the home-assistant organization, 50 commits to home-assistant, 11 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
 - [Harald Nagel (@haraldnagel)](https://github.com/haraldnagel "8 total commits to the home-assistant organization, 6 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Hari Menon (@floydpink)](https://github.com/floydpink "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Harris Borawski (@hborawski)](https://github.com/hborawski "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to home-assistant.github.io")
@@ -270,19 +293,19 @@ This page contains a list of people who have contributed in one way or another t
 - [HBDK (@HBDK)](https://github.com/HBDK "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
 - [hcooper (@hcooper)](https://github.com/hcooper "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Heath Paddock (@heathbar)](https://github.com/heathbar "6 total commits to the home-assistant organization, 6 commits to home-assistant")
-- [Heiko Rothe (@mKeRix)](https://github.com/mKeRix "19 total commits to the home-assistant organization, 14 commits to home-assistant, 5 commits to home-assistant.github.io")
+- [Heiko Rothe (@mKeRix)](https://github.com/mKeRix "20 total commits to the home-assistant organization, 15 commits to home-assistant, 5 commits to home-assistant.github.io")
 - [Hellowlol (@Hellowlol)](https://github.com/Hellowlol "3 total commits to the home-assistant organization, 3 commits to netdisco")
 - [Henning Dickten (@hensing)](https://github.com/hensing "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Henryk Plötz (@henryk)](https://github.com/henryk "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Hermann Kraus (@herm)](https://github.com/herm "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Hernán R (@hmronline)](https://github.com/hmronline "2 total commits to the home-assistant organization, 2 commits to home-assistant")
-- [HerrHofrat (@HerrHofrat)](https://github.com/HerrHofrat "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
 - [hexa- (@mweinelt)](https://github.com/mweinelt "18 total commits to the home-assistant organization, 10 commits to home-assistant, 8 commits to home-assistant.github.io")
 - [hexxter (@hexxter)](https://github.com/hexxter "8 total commits to the home-assistant organization, 8 commits to home-assistant")
 - [heytcass (@heytcass)](https://github.com/heytcass "6 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Hillary Fraley (@hillaryfraley)](https://github.com/hillaryfraley "12 total commits to the home-assistant organization, 12 commits to home-assistant.github.io")
 - [hokagegano (@hokagegano)](https://github.com/hokagegano "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Horea Christian (@TheChymera)](https://github.com/TheChymera "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Hugo Dupras (@jabesq)](https://github.com/jabesq "21 total commits to the home-assistant organization, 15 commits to home-assistant, 6 commits to home-assistant.github.io")
+- [Hugo Dupras (@jabesq)](https://github.com/jabesq "24 total commits to the home-assistant organization, 18 commits to home-assistant, 6 commits to home-assistant.github.io")
 - [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")
 - [Ian Copp (@icopp)](https://github.com/icopp "3 total commits to the home-assistant organization, 3 commits to home-assistant")
@@ -294,6 +317,7 @@ This page contains a list of people who have contributed in one way or another t
 - [irvingwa (@irvingwa)](https://github.com/irvingwa "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Issac Kelly (@issackelly)](https://github.com/issackelly "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Ivo Wever (@Confusion)](https://github.com/Confusion "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [J-CMartin (@J-CMartin)](https://github.com/J-CMartin "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [J. B. Rainsberger (@jbrains)](https://github.com/jbrains "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [jack (@jackmakesthings)](https://github.com/jackmakesthings "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Jack Chapple (@jchapple)](https://github.com/jchapple "2 total commits to the home-assistant organization, 2 commits to home-assistant")
@@ -302,10 +326,13 @@ This page contains a list of people who have contributed in one way or another t
 - [Jake McCrary (@jakemcc)](https://github.com/jakemcc "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [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")
-- [Jan Harkes (@jaharkes)](https://github.com/jaharkes "110 total commits to the home-assistant organization, 99 commits to home-assistant, 10 commits to netdisco, 1 commit to home-assistant.github.io")
+- [JammyDodger231 (@JammyDodger231)](https://github.com/JammyDodger231 "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
-- [Jan Losinski (@janLo)](https://github.com/janLo "10 total commits to the home-assistant organization, 8 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Jan Harkes (@jaharkes)](https://github.com/jaharkes "111 total commits to the home-assistant organization, 100 commits to home-assistant, 10 commits to netdisco, 1 commit to home-assistant.github.io")
-- [Jan Pobořil (@iBobik)](https://github.com/iBobik "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Jan Losinski (@janLo)](https://github.com/janLo "11 total commits to the home-assistant organization, 9 commits to home-assistant, 2 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 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Jan-Preben Mossin (@jpmossin)](https://github.com/jpmossin "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Janne Grunau (@jannau)](https://github.com/jannau "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Janos Racz (@rczjns)](https://github.com/rczjns "1 total commits to the home-assistant organization, 1 commit 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 J. (@jjensn)](https://github.com/jjensn "2 total commits to the home-assistant organization, 1 commit to netdisco, 1 commit to home-assistant")
@@ -318,14 +345,17 @@ This page contains a list of people who have contributed in one way or another t
 - [Jean Regisser (@jeanregisser)](https://github.com/jeanregisser "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Jean-Philippe Bouillot (@Jypy)](https://github.com/Jypy "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to home-assistant.github.io")
 - [Jed Lippold (@jlippold)](https://github.com/jlippold "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Jeff Schroeder (@SEJeff)](https://github.com/SEJeff "17 total commits to the home-assistant organization, 17 commits to home-assistant")
+- [Jeff Schroeder (@SEJeff)](https://github.com/SEJeff "18 total commits to the home-assistant organization, 17 commits to home-assistant, 1 commit to home-assistant.github.io")
-- [Jeff Wilson (@jawilson)](https://github.com/jawilson "10 total commits to the home-assistant organization, 8 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Jeff Wilson (@jawilson)](https://github.com/jawilson "11 total commits to the home-assistant organization, 9 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Jeffrey Lin (@linjef)](https://github.com/linjef "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to home-assistant.github.io")
 - [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")
+- [jeremydk (@jeremydk)](https://github.com/jeremydk "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Jerod Santo (@jerodsanto)](https://github.com/jerodsanto "1 total commits to the home-assistant organization, 1 commit 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")
+- [Jerry Workman (@JerryWorkman)](https://github.com/JerryWorkman "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Jesse Newland (@jnewland)](https://github.com/jnewland "13 total commits to the home-assistant organization, 9 commits to home-assistant, 3 commits to hubot-home-assistant, 1 commit to home-assistant.github.io")
+- [Jesse Osiecki (@stratosmacker)](https://github.com/stratosmacker "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Jesse Zoldak (@jzoldak)](https://github.com/jzoldak "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [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")
@@ -335,35 +365,38 @@ This page contains a list of people who have contributed in one way or another t
 - [Job Vermeulen (@jmvermeulen)](https://github.com/jmvermeulen "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
 - [Joe Lee (@xnoodle)](https://github.com/xnoodle "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Joe Rocklin (@joerocklin)](https://github.com/joerocklin "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
-- [Joeboyc2 (@Joeboyc2)](https://github.com/Joeboyc2 "10 total commits to the home-assistant organization, 10 commits to home-assistant.github.io")
+- [Joeboyc2 (@Joeboyc2)](https://github.com/Joeboyc2 "11 total commits to the home-assistant organization, 10 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Joel Asher Friedman (@joelash)](https://github.com/joelash "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Joel Clermont (@joelclermont)](https://github.com/joelclermont "1 total commits to the home-assistant organization, 1 commit 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 "10 total commits to the home-assistant organization, 9 commits to home-assistant, 1 commit to home-assistant.github.io")
+- [Johan Bloemberg (@aequitas)](https://github.com/aequitas "21 total commits to the home-assistant organization, 18 commits to home-assistant, 2 commits to home-assistant.github.io, 1 commit to netdisco")
 - [Johan Carlquist (@theseal)](https://github.com/theseal "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Johan Klintberg (@moogblob)](https://github.com/moogblob "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Johan Svensson (@jsvensson)](https://github.com/jsvensson "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Johann Kellerman (@kellerza)](https://github.com/kellerza "112 total commits to the home-assistant organization, 84 commits to home-assistant, 28 commits to home-assistant.github.io")
+- [Johann Kellerman (@kellerza)](https://github.com/kellerza "128 total commits to the home-assistant organization, 98 commits to home-assistant, 30 commits to home-assistant.github.io")
-- [John Arild Berentsen (@turbokongen)](https://github.com/turbokongen "144 total commits to the home-assistant organization, 115 commits to home-assistant, 24 commits to home-assistant.github.io, 5 commits to home-assistant-polymer")
+- [John Arild Berentsen (@turbokongen)](https://github.com/turbokongen "150 total commits to the home-assistant organization, 120 commits to home-assistant, 25 commits to home-assistant.github.io, 5 commits to home-assistant-polymer")
 - [John Lindley (@jwl17330536)](https://github.com/jwl17330536 "18 total commits to the home-assistant organization, 11 commits to hadashboard, 6 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [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 "15 total commits to the home-assistant organization, 9 commits to home-assistant, 5 commits to home-assistant.github.io, 1 commit to hadashboard")
+- [John Mihalic (@mezz64)](https://github.com/mezz64 "17 total commits to the home-assistant organization, 11 commits to home-assistant, 5 commits to home-assistant.github.io, 1 commit to hadashboard")
 - [John W. Long (@jlong)](https://github.com/jlong "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [John Williams (@Jaidan)](https://github.com/Jaidan "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Jon (@JonMurphy)](https://github.com/JonMurphy "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Jon Caruana (@joncar)](https://github.com/joncar "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Jon Evans (@craftyjon)](https://github.com/craftyjon "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Jon Maddox (@maddox)](https://github.com/maddox "101 total commits to the home-assistant organization, 78 commits to home-assistant, 15 commits to homebridge-homeassistant, 8 commits to home-assistant.github.io")
 - [Jonatan Castro (@jcastro)](https://github.com/jcastro "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
-- [Jonathan Baginski (@jbags81)](https://github.com/jbags81 "101 total commits to the home-assistant organization, 75 commits to fabric-home-assistant, 25 commits to home-assistant.github.io, 1 commit to home-assistant")
+- [Jonathan Baginski (@jbags81)](https://github.com/jbags81 "110 total commits to the home-assistant organization, 82 commits to fabric-home-assistant, 27 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Jonathan Martens (@jmartens)](https://github.com/jmartens "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [joopert (@joopert)](https://github.com/joopert "4 total commits to the home-assistant organization, 4 commits to home-assistant")
 - [Jordan Keith (@zeddD1abl0)](https://github.com/zeddD1abl0 "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
+- [Jose Juan Montes (@jjmontesl)](https://github.com/jjmontesl "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Josep del Rio (@joseprio)](https://github.com/joseprio "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Joseph Carter (@iKarith)](https://github.com/iKarith "6 total commits to the home-assistant organization, 6 commits to pi-gen")
+- [Joseph Carter (@iKarith)](https://github.com/iKarith "8 total commits to the home-assistant organization, 8 commits to pi-gen")
 - [Joseph Hassell (@poster983)](https://github.com/poster983 "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Joseph Piron (@eagleamon)](https://github.com/eagleamon "2 total commits to the home-assistant organization, 2 commits to home-assistant")
+- [Joseph Piron (@eagleamon)](https://github.com/eagleamon "3 total commits to the home-assistant organization, 3 commits to home-assistant")
+- [Josh Anderson (@andersonshatch)](https://github.com/andersonshatch "1 total commits to the home-assistant organization, 1 commit to homebridge-homeassistant")
 - [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 "22 total commits to the home-assistant organization, 17 commits to home-assistant, 5 commits to home-assistant.github.io")
+- [Josh Wright (@JshWright)](https://github.com/JshWright "24 total commits to the home-assistant organization, 18 commits to home-assistant, 6 commits to home-assistant.github.io")
 - [JSprengard (@JSprengard)](https://github.com/JSprengard "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [JTimNolan (@JTimNolan)](https://github.com/JTimNolan "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [jtscott (@jtscott)](https://github.com/jtscott "1 total commits to the home-assistant organization, 1 commit to home-assistant")
@@ -371,10 +404,11 @@ This page contains a list of people who have contributed in one way or another t
 - [juggie (@juggie)](https://github.com/juggie "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Julien Danjou (@jd)](https://github.com/jd "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [jumpkick (@jumpkick)](https://github.com/jumpkick "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Justin Dray (@justin8)](https://github.com/justin8 "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [Justin Good (@justingood)](https://github.com/justingood "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Justin Hayes (@GussyH)](https://github.com/GussyH "7 total commits to the home-assistant organization, 7 commits to hadashboard")
 - [Justin Moy (@justincmoy)](https://github.com/justincmoy "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
-- [Justin Weberg (@justweb1)](https://github.com/justweb1 "26 total commits to the home-assistant organization, 13 commits to home-assistant-polymer, 6 commits to hassbot, 4 commits to home-assistant, 2 commits to home-assistant.github.io, 1 commit to home-assistant-js")
+- [Justin Weberg (@justweb1)](https://github.com/justweb1 "27 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")
 - [Justyn Shull (@justyns)](https://github.com/justyns "7 total commits to the home-assistant organization, 6 commits to home-assistant, 1 commit to home-assistant.github.io")
 - [Kai (@luxus)](https://github.com/luxus "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [KAMAL AWASTHI (@KamalAwasthi)](https://github.com/KamalAwasthi "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
@@ -390,17 +424,20 @@ This page contains a list of people who have contributed in one way or another t
 - [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 "7 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Kevin Panaro (@kevinpanaro)](https://github.com/kevinpanaro "2 total commits to the home-assistant organization, 2 commits to home-assistant")
+- [Kevin Tawaststjerna (@ktawaststjerna)](https://github.com/ktawaststjerna "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Keyasha Brothern (@KMBrothern)](https://github.com/KMBrothern "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [kireyeu (@kireyeu)](https://github.com/kireyeu "4 total commits to the home-assistant organization, 4 commits to home-assistant-notebooks")
 - [KiXaM 刻む (@kixam)](https://github.com/kixam "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Klaas Hoekema (@KlaasH)](https://github.com/KlaasH "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
-- [KmanOz (@KmanOz)](https://github.com/KmanOz "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [koen01 (@koen01)](https://github.com/koen01 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [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")
 - [Kumar Gaurav Pandey (@gaurav1911)](https://github.com/gaurav1911 "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Kyle Gordon (@kylegordon)](https://github.com/kylegordon "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [Kyle Hendricks (@kylehendricks)](https://github.com/kylehendricks "5 total commits to the home-assistant organization, 4 commits to home-assistant, 1 commit to home-assistant.github.io")
+- [Kyle Hendricks (@kylehendricks)](https://github.com/kylehendricks "6 total commits to the home-assistant organization, 5 commits to home-assistant, 1 commit to home-assistant.github.io")
+- [lamiskin (@lamiskin)](https://github.com/lamiskin "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Lars Alexander Blumberg (@larsblumberg)](https://github.com/larsblumberg "1 total commits to the home-assistant organization, 1 commit 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")
 - [Leon (@leonsim)](https://github.com/leonsim "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Leonardo Saraiva (@vyper)](https://github.com/vyper "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Lewis Juggins (@lwis)](https://github.com/lwis "45 total commits to the home-assistant organization, 37 commits to home-assistant, 8 commits to home-assistant.github.io")
@@ -409,10 +446,10 @@ This page contains a list of people who have contributed in one way or another t
 - [Lindsay Ward (@lindsaymarkward)](https://github.com/lindsaymarkward "12 total commits to the home-assistant organization, 12 commits to home-assistant.github.io")
 - [linuxlurak (@linuxlurak)](https://github.com/linuxlurak "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [LucaSoldi (@LucaSoldi)](https://github.com/LucaSoldi "7 total commits to the home-assistant organization, 6 commits to home-assistant, 1 commit to home-assistant.github.io")
-- [Lukas (@lukas-hetzenecker)](https://github.com/lukas-hetzenecker "12 total commits to the home-assistant organization, 9 commits to home-assistant, 3 commits to home-assistant.github.io")
+- [Lukas (@lukas-hetzenecker)](https://github.com/lukas-hetzenecker "15 total commits to the home-assistant organization, 10 commits to home-assistant, 5 commits to home-assistant.github.io")
 - [Luke Armstrong (@lukearmstrong)](https://github.com/lukearmstrong "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Luke Karrys (@lukekarrys)](https://github.com/lukekarrys "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Lupin Demid (@lupin-de-mid)](https://github.com/lupin-de-mid "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to home-assistant.github.io")
+- [Lupin Demid (@lupin-de-mid)](https://github.com/lupin-de-mid "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Madhan Sundaram (@madhan5000)](https://github.com/madhan5000 "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Magas (@magas0)](https://github.com/magas0 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Maggi Trymbill (@trymbill)](https://github.com/trymbill "1 total commits to the home-assistant organization, 1 commit to home-assistant")
@@ -430,31 +467,35 @@ This page contains a list of people who have contributed in one way or another t
 - [Marc Plano-Lesay (@Kernald)](https://github.com/Kernald "9 total commits to the home-assistant organization, 9 commits to home-assistant.github.io")
 - [Marcel (@MTRNord)](https://github.com/MTRNord "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Marcel030nl (@Marcel030nl)](https://github.com/Marcel030nl "6 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 1 commit to home-assistant")
-- [Marcelo Moreira de Mello (@tchellomello)](https://github.com/tchellomello "71 total commits to the home-assistant organization, 38 commits to home-assistant.github.io, 33 commits to home-assistant")
+- [Marcelo Moreira de Mello (@tchellomello)](https://github.com/tchellomello "78 total commits to the home-assistant organization, 39 commits to home-assistant.github.io, 39 commits to home-assistant")
+- [Marcin Jaworski (@yawor)](https://github.com/yawor "10 total commits to the home-assistant organization, 10 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 (@scmmmh)](https://github.com/scmmmh "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Mark Huson (@mehuman)](https://github.com/mehuman "8 total commits to the home-assistant organization, 8 commits to home-assistant.github.io")
 - [Mark King (@vemek)](https://github.com/vemek "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Mark Nichols (@zanshin)](https://github.com/zanshin "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [Mark Oude Veldhuis (@markoudev)](https://github.com/markoudev "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [markcarline (@markcarline)](https://github.com/markcarline "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [markferry (@markferry)](https://github.com/markferry "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Markus Peter (@bimbar)](https://github.com/bimbar "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [Markus Stenberg (@fingon)](https://github.com/fingon "6 total commits to the home-assistant organization, 6 commits to home-assistant")
 - [Markus Thiel (@mackelito)](https://github.com/mackelito "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Martin Bernstorff (@ryqiem)](https://github.com/ryqiem "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Martin Elwin (@melwin)](https://github.com/melwin "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Martin Hjelmare (@MartinHjelmare)](https://github.com/MartinHjelmare "94 total commits to the home-assistant organization, 75 commits to home-assistant, 19 commits to home-assistant.github.io")
+- [Martin Hjelmare (@MartinHjelmare)](https://github.com/MartinHjelmare "104 total commits to the home-assistant organization, 80 commits to home-assistant, 24 commits to home-assistant.github.io")
 - [Martin J. Laubach (@mjl)](https://github.com/mjl "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [Martin Rowan (@shortbloke)](https://github.com/shortbloke "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Martin Rowan (@shortbloke)](https://github.com/shortbloke "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
 - [Martin Vacula (@MatoKafkac)](https://github.com/MatoKafkac "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to home-assistant.github.io")
 - [martst (@martst)](https://github.com/martst "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Masahiro Kamata (@kamatari)](https://github.com/kamatari "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Mason Stewart (@masondesu)](https://github.com/masondesu "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Mathew Peterson (@mathewpeterson)](https://github.com/mathewpeterson "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [Mathew Peterson (@mathewpeterson)](https://github.com/mathewpeterson "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
 - [Mathieu Maret (@mmaret-geny)](https://github.com/mmaret-geny "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Mathieu Maret (@mmaret)](https://github.com/mmaret "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [Matt Cahill (@matt-cahill)](https://github.com/matt-cahill "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Matt Enright (@wickedshimmy)](https://github.com/wickedshimmy "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Matt Hall (@Neko22)](https://github.com/Neko22 "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Matt N. (@mnoorenberghe)](https://github.com/mnoorenberghe "10 total commits to the home-assistant organization, 7 commits to home-assistant.github.io, 3 commits to home-assistant")
+- [Matt N. (@mnoorenberghe)](https://github.com/mnoorenberghe "16 total commits to the home-assistant organization, 11 commits to home-assistant.github.io, 4 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")
 - [Matteo Lampugnani (@t30)](https://github.com/t30 "8 total commits to the home-assistant organization, 7 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Matthew Bowen (@mgbowen)](https://github.com/mgbowen "4 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 1 commit to home-assistant")
@@ -464,6 +505,7 @@ This page contains a list of people who have contributed in one way or another t
 - [Matthias Urlichs (@smurfix)](https://github.com/smurfix "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Max Rumpf (@Maxr1998)](https://github.com/Maxr1998 "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [Mel Riffe (@melriffe)](https://github.com/melriffe "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [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, 2 commits to home-assistant, 1 commit to home-assistant.github.io")
 - [Michael (@hartmms)](https://github.com/hartmms "6 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 2 commits to home-assistant")
 - [Michael Auchter (@auchter)](https://github.com/auchter "12 total commits to the home-assistant organization, 12 commits to home-assistant")
@@ -471,95 +513,85 @@ This page contains a list of people who have contributed in one way or another t
 - [Michael G. Schwern (@schwern)](https://github.com/schwern "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Michael Gilbert (@Zyell)](https://github.com/Zyell "8 total commits to the home-assistant organization, 8 commits to home-assistant")
 - [Michael Kutý (@michaelkuty)](https://github.com/michaelkuty "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [Michael Liu (@icefalcn)](https://github.com/icefalcn "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [Michael Luggen (@l00mi)](https://github.com/l00mi "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Michael Requeny (@requenym)](https://github.com/requenym "14 total commits to the home-assistant organization, 14 commits to home-assistant.github.io")
 - [Michael Shim (@shimeez)](https://github.com/shimeez "1 total commits to the home-assistant organization, 1 commit to fabric-home-assistant")
-- [MichaelSprague (@MichaelSprague)](https://github.com/MichaelSprague "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [Michaël Arnauts (@michaelarnauts)](https://github.com/michaelarnauts "46 total commits to the home-assistant organization, 23 commits to home-assistant, 20 commits to home-assistant.github.io, 3 commits to home-assistant-polymer")
-- [Michaël Arnauts (@michaelarnauts)](https://github.com/michaelarnauts "39 total commits to the home-assistant organization, 21 commits to home-assistant, 15 commits to home-assistant.github.io, 3 commits to home-assistant-polymer")
 - [Michel Settembrino (@MS-Informatique)](https://github.com/MS-Informatique "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Mikayla Hutchinson (@mhutch)](https://github.com/mhutch "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [Mike Ballou (@ballou88)](https://github.com/ballou88 "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Mike Hennessy (@henworth)](https://github.com/henworth "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [Mike Nicholson (@themikenicholson)](https://github.com/themikenicholson "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [mikebarris (@mikebarris)](https://github.com/mikebarris "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [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")
 - [Milas Bowman (@milas)](https://github.com/milas "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [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 "19 total commits to the home-assistant organization, 16 commits to home-assistant, 3 commits to home-assistant.github.io")
+- [miniconfig (@miniconfig)](https://github.com/miniconfig "25 total commits to the home-assistant organization, 19 commits to home-assistant, 6 commits to home-assistant.github.io")
 - [mnestor (@mnestor)](https://github.com/mnestor "6 total commits to the home-assistant organization, 5 commits to home-assistant, 1 commit to home-assistant-polymer")
-- [Mokilok (@Mokilok)](https://github.com/Mokilok "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [Molodax (@Molodax)](https://github.com/Molodax "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
-- [Molodax (@Molodax)](https://github.com/Molodax "3 total commits to the home-assistant organization, 3 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")
 - [moskovskiy82 (@moskovskiy82)](https://github.com/moskovskiy82 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [mtl010957 (@mtl010957)](https://github.com/mtl010957 "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [myoung34 (@myoung34)](https://github.com/myoung34 "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Naren Salem (@naren8642)](https://github.com/naren8642 "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [Nathan Henrie (@n8henrie)](https://github.com/n8henrie "13 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 5 commits to home-assistant, 2 commits to homebridge-homeassistant")
-- [Nathan Broadbent (@ndbroadbent)](https://github.com/ndbroadbent "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Nathan Freitas (@n8fr8)](https://github.com/n8fr8 "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Nathan Henrie (@n8henrie)](https://github.com/n8henrie "14 total commits to the home-assistant organization, 7 commits to home-assistant.github.io, 5 commits to home-assistant, 2 commits to homebridge-homeassistant")
-- [Nathan Long (@nathanl)](https://github.com/nathanl "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Neil Lathwood (@laf)](https://github.com/laf "5 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to home-assistant")
-- [NeLLyMerC (@NeLLyMerC)](https://github.com/NeLLyMerC "1 total commits to the home-assistant organization, 1 commit 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 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Ness (@Xx-Ness-xX)](https://github.com/Xx-Ness-xX "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Nicholas Sideras (@nsideras)](https://github.com/nsideras "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [Nick Hammond (@nickhammond)](https://github.com/nickhammond "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [Nick Sabinske (@quadportnick)](https://github.com/quadportnick "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [Nick Sabinske (@quadportnick)](https://github.com/quadportnick "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
+- [Nick Touran (@partofthething)](https://github.com/partofthething "37 total commits to the home-assistant organization, 25 commits to home-assistant, 12 commits to home-assistant.github.io")
-- [Nick Touran (@partofthething)](https://github.com/partofthething "35 total commits to the home-assistant organization, 24 commits to home-assistant, 11 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")
-- [Nick Vella (@nvella)](https://github.com/nvella "6 total commits to the home-assistant organization, 4 commits to home-assistant, 1 commit to homebridge-homeassistant, 1 commit to home-assistant.github.io")
+- [Nick Waring (@nickwaring)](https://github.com/nickwaring "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
-- [Nick Waring (@nickwaring)](https://github.com/nickwaring "5 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to home-assistant")
 - [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")
 - [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 "1 total commits to the home-assistant organization, 1 commit to homebridge-homeassistant")
+- [nodomain (@nodomain)](https://github.com/nodomain "6 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 2 commits to homebridge-homeassistant")
 - [Nolan Gilley (@nkgilley)](https://github.com/nkgilley "103 total commits to the home-assistant organization, 81 commits to home-assistant, 22 commits to home-assistant.github.io")
-- [nordlead2005 (@nordlead2005)](https://github.com/nordlead2005 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [nordlead2005 (@nordlead2005)](https://github.com/nordlead2005 "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Nuno Sousa (@nunofgs)](https://github.com/nunofgs "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to homebridge-homeassistant")
-- [OGINO Masanori (@omasanori)](https://github.com/omasanori "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [nunojusto (@nunojusto)](https://github.com/nunojusto "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [OLD PROFILE! Go to /dennisreimann (@dbloete)](https://github.com/dbloete "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
-- [Olimpiu Rob (@olimpiurob)](https://github.com/olimpiurob "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
+- [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 "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
+- [Olimpiu Rob (@olimpiurob)](https://github.com/olimpiurob "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [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 "7 total commits to the home-assistant organization, 3 commits to home-assistant, 3 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")
 - [Open Home Automation (@open-homeautomation)](https://github.com/open-homeautomation "20 total commits to the home-assistant organization, 16 commits to home-assistant, 4 commits to home-assistant.github.io")
-- [OpenDave15 (@OpenDave15)](https://github.com/OpenDave15 "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
+- [OpenDave15 (@OpenDave15)](https://github.com/OpenDave15 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [Otto Winter (@OttoWinter)](https://github.com/OttoWinter "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
+- [Otto Winter (@OttoWinter)](https://github.com/OttoWinter "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Parker Moore (@parkr)](https://github.com/parkr "62 total commits to the home-assistant organization, 62 commits to home-assistant.github.io")
 - [Pascal Bach (@bachp)](https://github.com/bachp "7 total commits to the home-assistant organization, 7 commits to home-assistant")
-- [Pascal Vizeli (@pvizeli)](https://github.com/pvizeli "282 total commits to the home-assistant organization, 223 commits to home-assistant, 59 commits to home-assistant.github.io")
+- [Pascal Vizeli (@pvizeli)](https://github.com/pvizeli "346 total commits to the home-assistant organization, 262 commits to home-assistant, 84 commits to home-assistant.github.io")
 - [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 Hobusch (@pathob)](https://github.com/pathob "1 total commits to the home-assistant organization, 1 commit 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")
-- [Paul (@PollieKrismis)](https://github.com/PollieKrismis "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Paul Philippov (@themactep)](https://github.com/themactep "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Pavel Ponomarev (@awsum)](https://github.com/awsum "2 total commits to the home-assistant organization, 2 commits to home-assistant-polymer")
-- [Pavel Pravosud (@rwz)](https://github.com/rwz "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [Pedro Navarro (@pedronavf)](https://github.com/pedronavf "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
-- [Pedro Navarro (@pedronavf)](https://github.com/pedronavf "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Pedro Pombeiro (@PombeirP)](https://github.com/PombeirP "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [Per Sandström (@persandstrom)](https://github.com/persandstrom "117 total commits to the home-assistant organization, 94 commits to home-assistant, 12 commits to home-assistant-polymer, 11 commits to home-assistant.github.io")
-- [Petar Petrov (@MindFreeze)](https://github.com/MindFreeze "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Pete Peterson (@petey)](https://github.com/petey "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
-- [Petr Vraník (@konikvranik)](https://github.com/konikvranik "8 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 3 commits to home-assistant")
+- [Petr Vraník (@konikvranik)](https://github.com/konikvranik "10 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 5 commits to home-assistant")
 - [phardy (@phardy)](https://github.com/phardy "1 total commits to the home-assistant organization, 1 commit 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 Hansen (@Hansen8601)](https://github.com/Hansen8601 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [Phil Hawthorne (@philhawthorne)](https://github.com/philhawthorne "9 total commits to the home-assistant organization, 8 commits to home-assistant.github.io, 1 commit to home-assistant")
+- [Phil Hawthorne (@philhawthorne)](https://github.com/philhawthorne "8 total commits to the home-assistant organization, 7 commits to home-assistant.github.io, 1 commit to home-assistant")
-- [Phil Kates (@philk)](https://github.com/philk "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
+- [Phil Kates (@philk)](https://github.com/philk "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [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")
-- [Pierre Ståhl (@postlund)](https://github.com/postlund "4 total commits to the home-assistant organization, 3 commits to home-assistant, 1 commit to home-assistant.github.io")
+- [Philipp Schmitt (@pschmitt)](https://github.com/pschmitt "9 total commits to the home-assistant organization, 5 commits to home-assistant, 4 commits to home-assistant.github.io")
+- [Pierre Ståhl (@postlund)](https://github.com/postlund "12 total commits to the home-assistant organization, 7 commits to home-assistant, 3 commits to netdisco, 2 commits to home-assistant.github.io")
 - [pinksocks (@pinksocks)](https://github.com/pinksocks "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Piratonym (@Piratonym)](https://github.com/Piratonym "2 total commits to the home-assistant organization, 2 commits to home-assistant")
-- [Pratyush Mohapatra (@Ativerc)](https://github.com/Ativerc "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [PuckStar (@PuckStar)](https://github.com/PuckStar "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io")
-- [Qwertee (@Qwertee)](https://github.com/Qwertee "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [r-jordan (@r-jordan)](https://github.com/r-jordan "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [R1chardTM (@R1chardTM)](https://github.com/R1chardTM "9 total commits to the home-assistant organization, 5 commits to home-assistant, 4 commits to home-assistant.github.io")
-- [Randall Mason (@ClashTheBunny)](https://github.com/ClashTheBunny "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [ray0711 (@ray0711)](https://github.com/ray0711 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [Rashmi Yadav (@raysrashmi)](https://github.com/raysrashmi "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [rbflurry (@rbflurry)](https://github.com/rbflurry "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
-- [René (@rretsiem)](https://github.com/rretsiem "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [RBHR (@rbhr)](https://github.com/rbhr "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [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")
 - [rhooper (@rhooper)](https://github.com/rhooper "28 total commits to the home-assistant organization, 25 commits to home-assistant, 3 commits to home-assistant.github.io")
@@ -567,48 +599,43 @@ This page contains a list of people who have contributed in one way or another t
 - [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 "12 total commits to the home-assistant organization, 8 commits to home-assistant, 4 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 Huish (@Genestealer)](https://github.com/Genestealer "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [rkabadi (@rkabadi)](https://github.com/rkabadi "17 total commits to the home-assistant organization, 17 commits to home-assistant")
-- [rmevans9 (@rmevans9)](https://github.com/rmevans9 "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Rob Capellini (@capellini)](https://github.com/capellini "3 total commits to the home-assistant organization, 3 commits to home-assistant")
-- [Rob Cranfill (@RobCranfill)](https://github.com/RobCranfill "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [Rob Johnson (@robjohnson189)](https://github.com/robjohnson189 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [Rob Johnson (@robjohnson189)](https://github.com/robjohnson189 "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
 - [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 "848 total commits to the home-assistant organization, 400 commits to home-assistant-iOS, 187 commits to home-assistant, 185 commits to home-assistant.github.io, 50 commits to homebridge-homeassistant, 12 commits to home-assistant-polymer, 6 commits to hubot-home-assistant, 6 commits to Analytics-Receiver, 1 commit to netdisco, 1 commit to organization")
+- [Robbie Trencheny (@robbiet480)](https://github.com/robbiet480 "971 total commits to the home-assistant organization, 410 commits to home-assistant-iOS, 216 commits to home-assistant.github.io, 210 commits to home-assistant, 59 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 organization, 3 commits to home-assistant-cli, 3 commits to scenegen, 3 commits to home-assistant-js-websocket, 3 commits to appdaemon, 3 commits to home-assistant-js, 2 commits to home-assistant-notebooks, 2 commits to lambda-home-assistant-github, 2 commits to home-assistant-ansible, 2 commits to micropython-home-assistant, 2 commits to home-assistant-assets, 2 commits to home-assistant-dev-helper, 2 commits to fabric-home-assistant")
-- [Robby Grossman (@freerobby)](https://github.com/freerobby "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to home-assistant.github.io")
+- [Robby Grossman (@freerobby)](https://github.com/freerobby "2 total commits to the home-assistant organization, 2 commits to home-assistant")
-- [Robert Kowalski (@robertkowalski)](https://github.com/robertkowalski "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [Robin Laurén (@llauren)](https://github.com/llauren "1 total commits to the home-assistant organization, 1 commit to appdaemon")
-- [Robin Laurén (@llauren)](https://github.com/llauren "2 total commits to the home-assistant organization, 1 commit to appdaemon, 1 commit to home-assistant.github.io")
+- [Roddie Hasan (@eiddor)](https://github.com/eiddor "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io")
-- [Roddie Hasan (@eiddor)](https://github.com/eiddor "4 total commits to the home-assistant organization, 4 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")
-- [Roi Dayan (@roidayan)](https://github.com/roidayan "7 total commits to the home-assistant organization, 6 commits to home-assistant, 1 commit to home-assistant.github.io")
+- [Roman (@HerrHofrat)](https://github.com/HerrHofrat "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
-- [Ron Klinkien (@cyberjunky)](https://github.com/cyberjunky "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
+- [Ron Klinkien (@cyberjunky)](https://github.com/cyberjunky "1 total commits to the home-assistant organization, 1 commit 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")
 - [Rowan (@GreenTurtwig)](https://github.com/GreenTurtwig "69 total commits to the home-assistant organization, 63 commits to home-assistant.github.io, 6 commits to home-assistant")
 - [rpr69 (@rpr69)](https://github.com/rpr69 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [RubenKelevra (@RubenKelevra)](https://github.com/RubenKelevra "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [rubund (@rubund)](https://github.com/rubund "6 total commits to the home-assistant organization, 4 commits to home-assistant, 2 commits to home-assistant.github.io")
-- [Russ Nelson (@RussNelson)](https://github.com/RussNelson "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Russell Cloran (@rcloran)](https://github.com/rcloran "6 total commits to the home-assistant organization, 4 commits to homebridge-homeassistant, 2 commits to home-assistant")
 - [Ryan Borstelmann (@ryanborstelmann)](https://github.com/ryanborstelmann "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 Gibbons (@rtgibbons)](https://github.com/rtgibbons "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
+- [Ryan Kraus (@rmkraus)](https://github.com/rmkraus "193 total commits to the home-assistant organization, 161 commits to home-assistant, 17 commits to home-assistant.github.io, 14 commits to home-assistant-polymer, 1 commit to home-assistant-notebooks")
-- [Ryan Kraus (@rmkraus)](https://github.com/rmkraus "191 total commits to the home-assistant organization, 160 commits to home-assistant, 16 commits to home-assistant.github.io, 14 commits to home-assistant-polymer, 1 commit to home-assistant-notebooks")
+- [Ryan Parrish (@stickystyle)](https://github.com/stickystyle "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [Ryan Spicer (@alterscape)](https://github.com/alterscape "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
 - [Ryan Turner (@ryanturner)](https://github.com/ryanturner "6 total commits to the home-assistant organization, 6 commits to home-assistant")
 - [s1gnalrunner (@s1gnalrunner)](https://github.com/s1gnalrunner "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Sam Holmes (@sam3d)](https://github.com/sam3d "3 total commits to the home-assistant organization, 3 commits to pi-gen")
 - [Sam Riley (@samriley)](https://github.com/samriley "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [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 "5 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Samuel Bétrisey (@betrisey)](https://github.com/betrisey "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
-- [Samuel Mertenat (@mertenats)](https://github.com/mertenats "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [Sander de Leeuw (@sdeleeuw)](https://github.com/sdeleeuw "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [sander76 (@sander76)](https://github.com/sander76 "35 total commits to the home-assistant organization, 32 commits to home-assistant, 3 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 Bartuska (@bing281)](https://github.com/bing281 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [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 "2 total commits to the home-assistant organization, 1 commit to home-assistant-polymer, 1 commit to home-assistant")
-- [Sean Dague (@sdague)](https://github.com/sdague "46 total commits to the home-assistant organization, 33 commits to home-assistant, 7 commits to home-assistant.github.io, 3 commits to netdisco, 2 commits to home-assistant-polymer, 1 commit to home-assistant-js")
+- [Sean Dague (@sdague)](https://github.com/sdague "47 total commits to the home-assistant organization, 34 commits to home-assistant, 7 commits to home-assistant.github.io, 3 commits to netdisco, 2 commits to home-assistant-polymer, 1 commit to home-assistant-js")
 - [Sebastian Hartnick (@goir)](https://github.com/goir "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Sebastian von Minckwitz (@teodoc)](https://github.com/teodoc "2 total commits to the home-assistant organization, 1 commit to home-assistant-polymer, 1 commit to home-assistant")
 - [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")
@@ -617,29 +644,34 @@ This page contains a list of people who have contributed in one way or another t
 - [Simon Elsbrock (@else)](https://github.com/else "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Simon Szustkowski (@simonszu)](https://github.com/simonszu "7 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 3 commits to home-assistant")
 - [Sjors Spoorendonk (@sjorsjes)](https://github.com/sjorsjes "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
-- [smolz (@smolz)](https://github.com/smolz "8 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 2 commits to appdaemon")
+- [smolz (@smolz)](https://github.com/smolz "10 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 4 commits to appdaemon")
+- [snagytx (@snagytx)](https://github.com/snagytx "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [snizzleorg (@snizzleorg)](https://github.com/snizzleorg "5 total commits to the home-assistant organization, 5 commits to hadashboard")
 - [srirams (@srirams)](https://github.com/srirams "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [St. John Johnson (@stjohnjohnson)](https://github.com/stjohnjohnson "9 total commits to the home-assistant organization, 5 commits to home-assistant, 4 commits to home-assistant.github.io")
 - [Stefan Jonasson (@stefan-jonasson)](https://github.com/stefan-jonasson "10 total commits to the home-assistant organization, 6 commits to home-assistant, 4 commits to home-assistant.github.io")
+- [Stefano Scipioni (@scipioni)](https://github.com/scipioni "1 total commits to the home-assistant organization, 1 commit 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")
 - [Stephen Spalding (@fotoetienne)](https://github.com/fotoetienne "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Steven Barnes (@salt-lick)](https://github.com/salt-lick "1 total commits to the home-assistant organization, 1 commit 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 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Stu Gott (@stu-gott)](https://github.com/stu-gott "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Stéphane Bidoul (ACSONE) (@sbidoul)](https://github.com/sbidoul "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [sustah (@sustah)](https://github.com/sustah "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [System Tester (@systemtester)](https://github.com/systemtester "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Sytone (@sytone)](https://github.com/sytone "9 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 2 commits to home-assistant-cli, 1 commit to home-assistant")
 - [Sören Oldag (@soldag)](https://github.com/soldag "5 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to home-assistant")
-- [Teagan Glenn (@Teagan42)](https://github.com/Teagan42 "48 total commits to the home-assistant organization, 44 commits to home-assistant, 3 commits to home-assistant.github.io, 1 commit to home-assistant-js")
+- [Teagan Glenn (@Teagan42)](https://github.com/Teagan42 "49 total commits to the home-assistant organization, 45 commits to home-assistant, 3 commits to home-assistant.github.io, 1 commit to home-assistant-js")
 - [techtrails (@techtrails)](https://github.com/techtrails "2 total commits to the home-assistant organization, 2 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 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 "5 total commits to the home-assistant organization, 4 commits to home-assistant, 1 commit to netdisco")
+- [Teemu R. (@rytilahti)](https://github.com/rytilahti "18 total commits to the home-assistant organization, 11 commits to home-assistant, 6 commits to home-assistant.github.io, 1 commit to netdisco")
 - [Teguh Sobirin (@tjstyle)](https://github.com/tjstyle "2 total commits to the home-assistant organization, 2 commits to pi-gen")
 - [Terry Carlin (@terrycarlin)](https://github.com/terrycarlin "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [The Gitter Badger (@gitter-badger)](https://github.com/gitter-badger "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [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 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [thejacko12354 (@thejacko12354)](https://github.com/thejacko12354 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Theodor Lindquist (@theolind)](https://github.com/theolind "27 total commits to the home-assistant organization, 25 commits to home-assistant, 2 commits to home-assistant.github.io")
 - [Thiago Oliveira (@chilicheech)](https://github.com/chilicheech "1 total commits to the home-assistant organization, 1 commit to home-assistant")
@@ -648,6 +680,7 @@ This page contains a list of people who have contributed in one way or another t
 - [Thom Troy (@ttroy50)](https://github.com/ttroy50 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
 - [Thomas (@ktpx)](https://github.com/ktpx "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Thomas Friedel (@tfriedel)](https://github.com/tfriedel "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [ThUnD3r|Gr33n (@thundergreen)](https://github.com/thundergreen "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
 - [Tim (@tinglis1)](https://github.com/tinglis1 "4 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [Tim Gray (@tgray)](https://github.com/tgray "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [Tim Harton (@timharton)](https://github.com/timharton "1 total commits to the home-assistant organization, 1 commit to home-assistant")
@@ -657,13 +690,14 @@ This page contains a list of people who have contributed in one way or another t
 - [Tom Dickman (@tdickman)](https://github.com/tdickman "2 total commits to the home-assistant organization, 2 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 Matheussen (@Tommatheussen)](https://github.com/Tommatheussen "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer")
+- [Tom Matheussen (@Tommatheussen)](https://github.com/Tommatheussen "2 total commits to the home-assistant organization, 2 commits to home-assistant-polymer")
 - [Tomi Tuhkanen (@ttu)](https://github.com/ttu "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Touliloup (@RiRomain)](https://github.com/RiRomain "2 total commits to the home-assistant organization, 2 commits to home-assistant")
 - [tradiuz (@tradiuz)](https://github.com/tradiuz "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Trevor (@tboyce1)](https://github.com/tboyce1 "5 total commits to the home-assistant organization, 5 commits to home-assistant")
 - [Trey Hunner (@treyhunner)](https://github.com/treyhunner "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
 - [trollkarlen (@trollkarlen)](https://github.com/trollkarlen "5 total commits to the home-assistant organization, 5 commits to home-assistant")
-- [Valentin Alexeev (@valentinalexeev)](https://github.com/valentinalexeev "7 total commits to the home-assistant organization, 5 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Valentin Alexeev (@valentinalexeev)](https://github.com/valentinalexeev "8 total commits to the home-assistant organization, 6 commits to home-assistant, 2 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")
 - [Vitor Espindola (@vitorespindola)](https://github.com/vitorespindola "3 total commits to the home-assistant organization, 3 commits to home-assistant")
 - [Vittorio Monaco (@vittoriom)](https://github.com/vittoriom "1 total commits to the home-assistant organization, 1 commit to home-assistant")
@@ -679,11 +713,14 @@ This page contains a list of people who have contributed in one way or another t
 - [Will Heid (@bassclarinetl2)](https://github.com/bassclarinetl2 "11 total commits to the home-assistant organization, 11 commits to home-assistant.github.io")
 - [Will Hughes (@insertjokehere)](https://github.com/insertjokehere "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
 - [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 Scanlon (@w1ll1am23)](https://github.com/w1ll1am23 "37 total commits to the home-assistant organization, 27 commits to home-assistant, 10 commits to home-assistant.github.io")
+- [William Scanlon (@w1ll1am23)](https://github.com/w1ll1am23 "43 total commits to the home-assistant organization, 31 commits to home-assistant, 12 commits to home-assistant.github.io")
 - [wind-rider (@wind-rider)](https://github.com/wind-rider "5 total commits to the home-assistant organization, 5 commits to home-assistant")
 - [wokar (@wokar)](https://github.com/wokar "11 total commits to the home-assistant organization, 7 commits to home-assistant, 4 commits to home-assistant.github.io")
-- [XECDesign (@XECDesign)](https://github.com/XECDesign "22 total commits to the home-assistant organization, 22 commits to pi-gen")
+- [Wolf-Bastian Pöttner (@BastianPoe)](https://github.com/BastianPoe "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [XECDesign (@XECDesign)](https://github.com/XECDesign "56 total commits to the home-assistant organization, 56 commits to pi-gen")
 - [Xorso (@Xorso)](https://github.com/Xorso "18 total commits to the home-assistant organization, 18 commits to home-assistant")
+- [Yannic-HAW (@Yannic-HAW)](https://github.com/Yannic-HAW "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Yannick Simard (@TheRaven)](https://github.com/TheRaven "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
 - [yasin (@yasinS)](https://github.com/yasinS "4 total commits to the home-assistant organization, 4 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")
 - [Zac Mrowicki (@zmrow)](https://github.com/zmrow "1 total commits to the home-assistant organization, 1 commit to home-assistant")
@@ -695,4 +732,4 @@ This page contains a list of people who have contributed in one way or another t
 
 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 Sunday, January 22nd 2017, 3:58:53 am UTC.</i>
+<i>This page was last updated Saturday, February 11th 2017, 9:38:58 pm UTC.</i>

source/developers/frontend_creating_custom_ui.markdown

@@ -0,0 +1,35 @@
+---
+layout: page
+title: "Creating custom UI"
+description: "Introduction to create custom ui for Home Assistant."
+date: 2017-02-04 13:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+ha_release: 0.38
+---
+If you would like to use your own [State card](/developers/frontend_add_card/) without merging your code into [home-assistant-polymer](https://github.com/home-assistant/home-assistant-polymer/) you can create your own implementation.
+
+- Put the element source file and its dependencies in `www/custom_ui/` directory under you homeassistant config.
+
+For example if creating a state card for the `light` domain named `my_custom_light_card` put `state-card-my_custom_light_card.html` in `www/custom_ui/`.
+
+That file should implement `<state-card-my_custom_light_card>` tag with Polymer.
+
+In `state-card-my_custom_light_card.html` you should use `<link rel="import">` to import all the dependencies **not** used by Homeassistant UI.
+Do not import any dependencies used by Homeassistant UI.
+Importing those will work in `development: 1` mode, but will fail in production mode.
+
+- In the `customize:` section of `configuration.yaml` put `custom_ui_state_card: <element-name>`.
+
+For example:
+```yaml
+homeassistant:
+  customize:
+    - entity_id: light
+      custom_ui_state_card: my_custom_light_card
+```
+
+
+For more possibilities, see the [Custom UI section](/cookbook/#user-interface) on our Examples page.