- 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. +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.
diff --git a/source/_components/lutron_caseta.markdown b/source/_components/lutron_caseta.markdown index 2cd45e95077..bb2b3167e8f 100644 --- a/source/_components/lutron_caseta.markdown +++ b/source/_components/lutron_caseta.markdown @@ -13,17 +13,18 @@ featured: False ha_release: 0.41 --- -[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_caseta` component in Home Assistant is responsible for communicating with the Lutron SmartBridge for these systems. +[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_caseta` component in Home Assistant is responsible for communicating with the Lutron SmartBridge for these systems. -This component only supports the Caseta line of products. Current only supports Caseta dimmers as Home Assistant lights and caseta wall switches as Home Assistant switches. +This component only supports the Caseta line of products. Current only supports Caseta dimmers as Home Assistant lights and caseta wall switches as Home Assistant switches. When configured, the `lutron_caseta` component will automatically discover dimmers and switches as setup in the Lutron SmartBridge. -To use Lutron Caseta devices in your installation, add the following to your configuration.yaml file using the IP of your lutron Smartbridge: +To use Lutron Caseta devices in your installation, add the following to your `configuration.yaml` file using the IP of your lutron Smartbridge: -``` yaml +```yaml +# Example configuration.yaml entry lutron_caseta: - host:- It is recommended to assign a static IP address to your Lutron SmartBridge. This ensures that it won't change IP address, so you won't have to change the `host` if it reboots and comes up with a different IP address. +It is recommended to assign a static IP address to your Lutron SmartBridge. This ensures that it won't change IP address, so you won't have to change the `host` if it reboots and comes up with a different IP address.
diff --git a/source/_components/maxcube.markdown b/source/_components/maxcube.markdown index 3ec5eab2d0b..c26cbe114bc 100644 --- a/source/_components/maxcube.markdown +++ b/source/_components/maxcube.markdown @@ -8,7 +8,7 @@ comments: false sharing: true footer: true logo: maxcube.png -ha_category: DIY +ha_category: Climate ha_release: "0.40" ha_iot_class: "Local Polling" --- @@ -16,8 +16,8 @@ ha_iot_class: "Local Polling" [eQ-3 MAX!](http://www.eq-3.com/products/max.html) integration for Home Assistant allows you to connect eQ-3 MAX! components via the eQ-3 MAX! Cube. The components connects to the eQ-3 MAX! Cube via TCP and automatically makes all supported components available in Home Assistant. The name for each device is created by concatenating the MAX! room and device names. Limitations: -- Configuring weekly schedules is not possible -- Implementation is based on the reverse engineered [MAX! protocol](https://github.com/Bouni/max-cube-protocol) +- Configuring weekly schedules is not possible. +- Implementation is based on the reverse engineered [MAX! protocol](https://github.com/Bouni/max-cube-protocol). Supported Devices: - MAX! Radiator Thermostat (tested) @@ -32,6 +32,6 @@ A `maxcube` section must be present in the `configuration.yaml` file and contain maxcube: host: 192.168.0.20 ``` - +Configuration variables: - **host** (*Required*): The IP address of the eQ-3 MAX! Cube to use. - **port** (*Optional*): The UDP port number. Defaults to `62910`. diff --git a/source/_components/media_player.samsungtv.markdown b/source/_components/media_player.samsungtv.markdown index b22c42ff16c..9bcd55df23c 100644 --- a/source/_components/media_player.samsungtv.markdown +++ b/source/_components/media_player.samsungtv.markdown @@ -52,10 +52,12 @@ Currently known supported models: - U6000 (port must be set to 8001) - K6500AF (port must be set to 8001) - KS8005 (port must be set to 8001, and `pip3 install websocket-client` must be executed) +- K5600AK (partially supported, turn on works but state is not updated) Currently tested but not working models: - J5200 - Unable to see state and unable to control +- JU7500 - Unable to see state and unable to control If your model is not on the list then give it a test, if everything works correctly then add it to the list on [GitHub](https://github.com/home-assistant/home-assistant.github.io/tree/current/source/_components/media_player.samsungtv.markdown). The first letter (U, P, L, H & K) represent the screen type, e.g. LED or Plasma. The second letter represents the region, E is Europe, N is North America and A is Asia & Australia. The two numbers following that represent the screen size. @@ -63,4 +65,4 @@ If you add your model remember to remove these before adding them to the list. Currently the ability to select a source is not implemented. -There's currently a [known issue](https://github.com/home-assistant/home-assistant/issues/2098) with some TV's receiving a *Key press UP* that can interrupt certain applications. +There's currently a [known issue](https://github.com/home-assistant/home-assistant/issues/2098) with some TVs receiving a *Key press UP* that can interrupt certain applications. diff --git a/source/_components/media_player.spotify.markdown b/source/_components/media_player.spotify.markdown index 2964eb4102d..28c413954e1 100644 --- a/source/_components/media_player.spotify.markdown +++ b/source/_components/media_player.spotify.markdown @@ -25,7 +25,13 @@ To create the required Spotify Application, login to [Spotify Developer](https:/ `http://-**This platform has been deprecated in favor of the "[OpenALPR image processing](/components/image_processing.openalpr_local/)" platform and will be removed in the future. Please use the "OpenALPR image processing" platform.** -
- -[OpenALPR](http://www.openalpr.com/) integration for Home Assistant allows you to process licences plates recorded with a camera. You can use them to open a garage door or trigger any other [automation](https://home-assistant.io/components/automation/). - --If you want use a video stream. You need setup the [ffmpeg](/components/ffmpeg) component. See also there for troubleshooting local ffmpeg installation. -
- -### {% linkable_title Local installation %} - -If you want process all data locally, you need version 2.3.1 or higher of the `alpr` commandline tool. - -If you don't find binaries for your distribution you can compile from source. Documention of how to build OpenALPR is found [here](https://github.com/openalpr/openalpr/wiki). - -On a Debian system you can use this `cmake` command to build only the command line tool: - -```bash -$ cmake -DWITH_TEST=FALSE -DWITH_BINDING_JAVA=FALSE --DWITH_BINDING_PYTHON=FALSE --DWITH_BINDING_GO=FALSE -DWITH_DAEMON=FALSE -DCMAKE_INSTALL_PREFIX:PATH=/usr .. -``` - -Verify your `alpr` installation with: - -``` -$ wget -O- -q http://plates.openalpr.com/h786poj.jpg | alpr - -``` - -### {% linkable_title Configuration Home Assistant %} - -```yaml -# Example configuration.yaml entry -openalpr: - engine: local - region: eu - confidence: 80.0 - entities: - - name: Camera garage 1 - interval: 5 - render: ffmpeg - input: INPUT_STREAM - extra_arguments: SOME OTHER FFMPEG STUFF - - name: Camera garage 2 - interval: 5 - render: image - input: https://camera_ip/still_image.jpg - username: admin - password: bla -``` - -Configuration variables: - -- **engine** (*Required*): `local` or `cloud` for processing -- **region** (*Required*): Country or region. List of supported [values](https://github.com/openalpr/openalpr/tree/master/runtime_data/config). -- **confidence** (*Optional*): The minimum of confidence in percent to process with Home Assistant. Defaults to 80. -- **entities** (*Required*): A list of device to add in Home Assistant. -- **name** (*Optional*): This parameter allows you to override the name of your OpenALPR entity. -- **interval** (*Optional*): Time in seconds to poll a picture. If the interval is 0 It don't poll and it only process data with `openalpr.scan` service. Default is 2 seconds. -- **render** (*Optional*): How is Home Assistant to get a picture from. It support `ffmpeg` for video streams and `image` for a still image. Default is with `ffmpeg`. -- **input** (*Required*): The source from getting pictures. With `ffmpeg` it could by all supported input. Image only support an URL. -- **extra_arguments** (*Optional*): Only available with `ffmpeg`. -- **username** (*Optional*): Only available with image for HTTP authentification. -- **password** (*Optional*): Only available with image for HTTP authentification. - -### {% linkable_title Configuration Home Assistant local processing %} - -```yaml -# Example configuration.yaml entry -openalpr: - engine: local - region: eu - alpr_binary: /usr/bin/alpr - entities: -... -``` -Configuration variables: - -- **alpr_binary** (*Optional*): Default `alpr`. The command line tool `alpr` from OpenALPR software for local processing. - -### {% linkable_title Configuration Home Assistant cloud processing %} - -```yaml -# Example configuration.yaml entry -openalpr: - engine: cloud - region: eu - api_key: SK_AAABBBBCCCEEEE - entities: -... -``` - -Configuration variables: - -- **api_key** (*Required*): You need an API key from [OpenALPR Cloud](https://cloud.openalpr.com/). - -#### {% linkable_title Service %} - -- `openalpr.scan`: Scan immediately a picture from input. -- `openalpr.restart`: Restart a ffmpeg process - -#### {% linkable_title Events %} - -```yaml -# Example configuration.yaml automation entry -automation: -- alias: Open garage door - trigger: - platform: event - event_type: openalpr.found - event_data: - entity_id: openalpr.camera_garage_1 - plate: BE2183423 -... -``` - -This event is trigger after OpenALPR found a new licence plate. diff --git a/source/_components/remote.harmony.markdown b/source/_components/remote.harmony.markdown index b3aebee8744..18f3f838a75 100755 --- a/source/_components/remote.harmony.markdown +++ b/source/_components/remote.harmony.markdown @@ -36,9 +36,9 @@ remote: Configuration variables: -- **name** (*Required*): The hub's name to display in the front end. +- **name** (*Required*): The hub's name to display in the frontend. - **host** (*Required*): The Harmony device's IP address. -- **port** (*Optional*): The Harmony device's port. 5222 is default. +- **port** (*Optional*): The Harmony device's port. Defaults to 5222. - **activity** (*Optional*): Activity to use when turnon service is called without any data. - **scan_interval** (*Optional*): Amount in seconds in between polling for device's current activity. Defaults to 30 seconds. @@ -52,10 +52,10 @@ Upon startup one file will be written to your Home Assistant configuration direc Supported services: -- **Turn Off**: Turn off all devices that were switched on from the start of the current activity -- **Turn On**: Start an activity, will start the default activity from configuration.yaml if no activity is specified. The specified activity can either be the activity name or the activity ID from the configuration file written to your HASS config directory. The service will respond faster if the activity ID is passed instead of the name -- **Send Command**: Send a command to one device, device ID and available commands are written to the configuration file at startup -- **Sync**: Synchronizes the Harmony device with the Harmony web service if any changes are made from the web portal or app +- **Turn Off**: Turn off all devices that were switched on from the start of the current activity. +- **Turn On**: Start an activity, will start the default activity from configuration.yaml if no activity is specified. The specified activity can either be the activity name or the activity ID from the configuration file written to your [Home Assistant configuration directory](/docs/configuration/). The service will respond faster if the activity ID is passed instead of the name. +- **Send Command**: Send a command to one device, device ID and available commands are written to the configuration file at startup. +- **Sync**: Synchronizes the Harmony device with the Harmony web service if any changes are made from the web portal or app. ### {% linkable_title Examples %} @@ -91,7 +91,7 @@ sensor: ``` -The example below shows how to control an `input_boolean` switch using the Harmony remote's current activity. The switch will turn on when the remote's state changes and the Kodi activity is started and off when the remote's state changes and the current activity is PowerOff. +The example below shows how to control an `input_boolean` switch using the Harmony remote's current activity. The switch will turn on when the remote's state changes and the Kodi activity is started and off when the remote's state changes and the current activity is PowerOff. ```yaml automation: @@ -117,7 +117,8 @@ automation: entity_id: input_boolean.notify ```` -The automation example below shows how to send a command via the harmony remote using the `send_command` service to send the 'Pause' command to the hub, which is already defined as an IR code for each device to be used via the Harmony app. It is checking for the activity name as exposed through the sensor in the harmony remote component using Jinga if statements to set the device_id, sending the correct Pause command for the given activity. This requires checking your activity list and device_id from the `harmony_REMOTENAME.conf` file created when you start the component. In this example, the harmony hub is named bedroom. +The automation example below shows how to send a command via the harmony remote using the `send_command` service to send the 'Pause' command to the hub, which is already defined as an IR code for each device to be used via the Harmony app. It is checking for the activity name as exposed through the sensor in the harmony remote component using Jinja if statements to set the device_id, sending the correct Pause command for the given activity. This requires checking your activity list and device_id from the `harmony_REMOTENAME.conf` file created when you start the component. In this example, the harmony hub is named bedroom. + ```yaml automation: - alias: Harmony Pause contextual for activity diff --git a/source/_components/rflink.markdown b/source/_components/rflink.markdown index 6e14945c919..4efec4ab993 100644 --- a/source/_components/rflink.markdown +++ b/source/_components/rflink.markdown @@ -117,7 +117,7 @@ If you find a device is recognized differently, with different protocols or the ### {% 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. +- This component uses this callback to distribute 'rflink packet events' over Home Assistant's 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. @@ -135,7 +135,7 @@ logger: This will give you output looking like this: -``` +```bash 17-03-07 20:12:05 DEBUG (MainThread) [rflink.protocol] received data: 20;00;Nod 17-03-07 20:12:05 DEBUG (MainThread) [rflink.protocol] received data: o RadioFrequencyLink - R 17-03-07 20:12:05 DEBUG (MainThread) [rflink.protocol] received data: FLink Gateway V1.1 - R45 diff --git a/source/_components/sensor.darksky.markdown b/source/_components/sensor.darksky.markdown index 03c16aaab59..d891eb604c9 100644 --- a/source/_components/sensor.darksky.markdown +++ b/source/_components/sensor.darksky.markdown @@ -11,6 +11,7 @@ logo: dark_sky.png ha_category: Weather featured: true ha_release: 0.30 +redirect_from: /components/sensor.forecast/ --- The `darksky` platform uses the [Dark Sky](https://darksky.net/) web service as a source for meteorological data for your location. The location is based on the `longitude` and `latitude` coordinates configured in your `configuration.yaml` file. The coordinates are auto-detected but to take advantage of the hyper-local weather reported by Dark Sky, you can refine them down to your exact home address. GPS coordinates can be found by using [Google Maps](https://www.google.com/maps) and clicking on your home or [Openstreetmap](http://www.openstreetmap.org/). @@ -80,7 +81,7 @@ Configuration variables:-Note: While the platform is called "darksky" the sensors will show up in Home Assistant as "dark_sky" (eg: sensor.dark_sky_summary). +While the platform is called "darksky" the sensors will show up in Home Assistant as "dark_sky" (eg: sensor.dark_sky_summary).
Details about the API are available in the [Dark Sky documentation](https://darksky.net/dev/docs). diff --git a/source/_components/sensor.dnsip.markdown b/source/_components/sensor.dnsip.markdown index 6916b0713ca..30f1035d87b 100644 --- a/source/_components/sensor.dnsip.markdown +++ b/source/_components/sensor.dnsip.markdown @@ -15,7 +15,7 @@ ha_release: "0.40" The `dnsip` sensor will expose an IP address, fetched via DNS resolution, as its value. There are two operational modes: -1. When you enable the sensor with minimal configuration, it will query [OpenDNS](https://www.opendns.com/)' nameserver with the hostname `myip.opendns.com`, which will resolve to your external/public IP address. +1. When you enable the sensor with minimal configuration, it will query the [OpenDNS](https://www.opendns.com/) nameservers with the hostname `myip.opendns.com`, which will resolve to your external/public IP address. 2. If you specify a `hostname`, a regular DNS lookup will be performed, providing you the IP the hostname resolves to. You may also override the nameserver that is being used by setting the `resolver` parameter to any nameserver you like. @@ -32,7 +32,7 @@ Configuration variables: - **hostname** (*Optional*): The hostname for which to perform the DNS query. Default: `myip.opendns.com` (special hostname that resolves to your public IP) - **resolver** (*Optional*): The DNS server to target the query at. Default: `208.67.222.222` (OpenDNS) -- **ipv6** (*Optional*): Set this to `true` or `false` if IPv6 should be used. When resolving the public IP, this will be the IP of the machine HASS is running on. +- **ipv6** (*Optional*): Set this to `true` or `false` if IPv6 should be used. When resolving the public IP, this will be the IP of the machine where Home Assistant is running on. - **resolver_ipv6** (*Optional*): The IPv6 DNS server to target the query at. Default: `2620:0:ccc::2` (OpenDNS) - **scan_interval** (*Optional*): Defines number of seconds for polling interval. Default: `120` seconds. diff --git a/source/_components/sensor.forecast.markdown b/source/_components/sensor.forecast.markdown deleted file mode 100644 index 7f15e40c405..00000000000 --- a/source/_components/sensor.forecast.markdown +++ /dev/null @@ -1,104 +0,0 @@ ---- -layout: page -title: "Forecast.io" -description: "How to integrate Forecast.io within Home Assistant." -date: 2015-04-25 9:06 -sidebar: true -comments: false -sharing: true -footer: true -logo: forecast.png -ha_category: Deprecated -featured: False -ha_release: pre 0.7 ---- - --**This platform has been deprecated in favor of the "[darksky](/components/sensor.darksky/)" platform and will be removed in the future. Please use the "darksky" platform.** -
- -The `forecast` platform uses the [Forecast.io](https://forecast.io/) web service as a source of meteorological data for your location. The location is based on the `longitude` and `latitude` coordinates configured in your `configuration.yaml` file. The coordinates are auto-detected but to take advantage of the hyper-local weather reported by forecast.io, you can refine them down to your exact home address. GPS coordinates can be found by using [Google Maps](https://www.google.com/maps) and clicking on your home or [Openstreetmap](http://www.openstreetmap.org/). - -You need an API key which is free but requires [registration](https://developer.forecast.io/register). You can make up to 1000 calls per day for free which means that you could make one approximately every 86 seconds. - --[Forecast.io](https://forecast.io/) will charge you $0.0001 per API call if you enter your credit card details and create more than 1000 calls per day. -
- -To add Forecast.io to your installation, add the following to your `configuration.yaml` file: - -```yaml -# Example configuration.yaml entry -sensor: - - platform: forecast - api_key: YOUR_APP_KEY - monitored_conditions: - - summary - - icon - - nearest_storm_distance - - nearest_storm_bearing - - precip_type - - precip_intensity - - precip_probability - - temperature - - apparent_temperature - - dew_point - - wind_speed - - wind_bearing - - cloud_cover - - humidity - - pressure - - visibility - - ozone - - minutely_summary - - hourly_summary - - daily_summary - - temperature_max - - temperature_min - - apparent_temperature_max - - apparent_temperature_min - - precip_intensity_max -``` - -Configuration variables: - -- **api_key** (*Required*): Your API key for http://forecast.io/. -- **monitored_conditions** array (*Required*): Conditions to display in the frontend. - - **summary**: A human-readable text summary of the current conditions. - - **precip_type**: The type of precipitation occurring. - - **precip_intensity**: The average expected intensity of precipitation occurring. - - **precip_probability**: A value between 0 and 1 which is representing the probability of precipitation. - - **temperature**: The current temperature. - - **apparent_temperature**: A numerical value representing the apparent (or "feels like") temperature. - - **dew_point**: The dew point. - - **wind_speed**: The wind speed. - - **wind_bearing**: Where the wind is coming from in degrees, with true north at 0° and progressing clockwise. - - **cloud_cover**: The percentage of sky occluded by clouds. - - **humidity**: The relative humidity. - - **pressure**: The sea-level air pressure in millibars. - - **visibility**: The average visibility. - - **ozone**: The columnar density of total atmospheric ozone in Dobson. - - **minutely_summary**: A human-readable text summary for the next hour. - - **hourly_summary**: A human-readable text summary for the next 24 hours. - - **daily_summary**: A human-readable text summary for the next 7 days. - - **temperature_max**: Today's expected high temperature. - - **temperature_min**: Today's expected low temperature. - - **apparent_temperature_max**: Today's expected apparent high temperature. - - **apparent_temperature_min**: Today's expected apparent low temperature. - - **precip_intensity_max**: Today's expected maximum intensity of precipitation. -- **units** (*Optional*): Specify the unit system. Default to `si` or `us` based on the temperature preference in Home Assistant. Other options are `auto`, `us`, `si`, `ca`, and `uk2`. -`auto` will let forecast.io decide the unit system based on location. -- **update_inverval** (*Optional*): Minimum time interval between updates. Default is 2 minutes. Supported formats: - - `update_interval: 'HH:MM:SS'` - - `update_interval: 'HH:MM'` - - Time period dictionary, e.g.: -update_interval: - # At least one of these must be specified: - days: 0 - hours: 0 - minutes: 3 - seconds: 30 - milliseconds: 0 -- -Details about the API are available in the [Forecast.io documentation](https://developer.forecast.io/docs/v2). diff --git a/source/_components/sensor.glances.markdown b/source/_components/sensor.glances.markdown index 90ca9574419..f730b892e54 100644 --- a/source/_components/sensor.glances.markdown +++ b/source/_components/sensor.glances.markdown @@ -16,14 +16,17 @@ ha_release: 0.7.3 The `glances` sensor platform is consuming the system information provided by the [Glances](https://github.com/nicolargo/glances) API. This enables one to track remote host and display their stats in Home Assistant. -This sensors needs a running instance of `glances` on the host. The minimal supported version of `glances` is 2.3: +This sensors needs a running instance of `glances` on the host. The minimal supported version of `glances` is 2.3. +To start a Glances RESTful API server on its default port 61208, the a test the following command can be used: ```bash $ sudo glances -w Glances web server started on http://0.0.0.0:61208/ ``` -Check if you are able to access the API located at `http://IP_ADRRESS:61208/api/2`. The details about your memory usage is provided as a JSON response. If so, you are good to proceed. +Check if you are able to access the API located at `http://IP_ADRRESS:61208/api/2`. Don't use `-s` as this will start the XMLRPC server on port 61209. Home Assistant only supports the REST API of GLANCES. + +The details about your memory usage is provided as a JSON response. If so, you are good to proceed. ```bash $ curl -X GET http://IP_ADDRESS:61208/api/2/mem/free diff --git a/source/_components/sensor.iss.markdown b/source/_components/sensor.iss.markdown deleted file mode 100644 index ca2ee55b23e..00000000000 --- a/source/_components/sensor.iss.markdown +++ /dev/null @@ -1,28 +0,0 @@ ---- -layout: page -title: "International Space Station Sensor" -description: "Know if or when ISS will be above your home location" -date: 2016-12-18 10:00 -sidebar: true -comments: false -sharing: true -footer: true -logo: nasa.png -ha_category: Deprecated -ha_release: 0.36 ---- - -
-**This platform has been deprecated in favor of the "[ISS](/components/binary_sensor.iss/)" platform and will be removed in the future. Please use the "iss" binary sensor platform.** -
- -The `iss` platform uses the [Open Notify API](http://open-notify.org/Open-Notify-API/ISS-Location-Now/) to let you know if the station is above your home location. This means that ISS is 10° above the horizon of your home. -You can check in the attributes of the sensor how many minutes you have to wait until the next rise of the station and the number of people in space. - -To add ISS sensor to your installation, add the following to your `configuration.yaml` file: - -```yaml -# Example configuration.yaml entry -sensor: - - platform: iss -``` diff --git a/source/_components/sensor.miflora.markdown b/source/_components/sensor.miflora.markdown index 05a93c3f3c8..14738c656bb 100644 --- a/source/_components/sensor.miflora.markdown +++ b/source/_components/sensor.miflora.markdown @@ -13,7 +13,7 @@ ha_release: 0.29 ha_iot_class: "Local Polling" --- -The [Mi Flora plant sensor](https://www.open-homeautomation.com/2016/08/23/reverse-engineering-the-mi-plant-sensor/) is a small Bluetooth Low Energy device that monitors not only the moisture, but also light, temperature and conductivity. As only a single BLE device can be polled at the same time, the library implements locking to make sure this is the case. +The `miflora` sensor platform allows one to monitor to plants. The [Mi Flora plant sensor](https://www.aliexpress.com/item/Newest-Original-Xiaomi-Flora-Monitor-Digital-Plants-Flowers-Soil-Water-Light-Tester-Sensor-Monitor-for-Aquarium/32685750372.html) is a small Bluetooth Low Energy device that monitors not only the moisture, but also light, temperature and conductivity. As only a single BLE device can be polled at the same time, the library implements locking to make sure this is the case. To use your Mi Flora plant sensor in your installation, add the following to your `configuration.yaml` file: @@ -38,7 +38,7 @@ sensor: - **median** (*Optional*): Sometimes the sensor measurements show spikes. Using this parameter, the poller will report the median of the last 3 (you can also use larger values) measurements. This filters out single spikes. Median: 5 will also filter double spikes. If you never have problems with spikes, `median: 1` will work fine. - **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) +- **cache_value** (*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. @@ -62,6 +62,3 @@ sensor: - battery ``` - - - diff --git a/source/_components/sensor.modem_callerid.markdown b/source/_components/sensor.modem_callerid.markdown index e1232c8e950..3226f51990d 100644 --- a/source/_components/sensor.modem_callerid.markdown +++ b/source/_components/sensor.modem_callerid.markdown @@ -11,7 +11,7 @@ ha_category: Sensor ha_release: "0.40" --- -The `modem_callerid` sensor platform uses an available modem for collecting caller ID information. It requires a Hayes AT compatible modem that supports caller ID detection (via AT+VCID=1). +The `modem_callerid` sensor platform uses an available modem for collecting caller ID information. It requires a Hayes AT compatible modem that supports caller ID detection (via AT+VCID=1). To enable the sensor, add the following lines to your `configuration.yaml`: @@ -19,7 +19,6 @@ To enable the sensor, add the following lines to your `configuration.yaml`: # Example configuration.yaml entry sensor: - platform: modem_callerid - ``` Configuration variables: @@ -31,7 +30,7 @@ To find the path of your USB modem, run: `$ ls /dev/ttyACM*` -If `hass` runs with another user (e.g. *homeassistant* on Hassbian) give access to the stick with: +If Home Assistant (`hass`) runs with another user (e.g. `homeassistant` on Hassbian) give access to the stick with: `$ sudo usermod -a -G dialout homeassistant` @@ -46,7 +45,7 @@ Some example automations: trigger: platform: state entity_id: sensor.modem_callerid - state: "callerid" + state: "callerid" action: service: notify.notify data: diff --git a/source/_components/sensor.tado.markdown b/source/_components/sensor.tado.markdown new file mode 100644 index 00000000000..6f127869b5b --- /dev/null +++ b/source/_components/sensor.tado.markdown @@ -0,0 +1,19 @@ +--- +layout: page +title: "Tado Sensor" +description: "Instructions on how to integrate Tado thermostats with Home Assistant." +date: 2017-03-20 12:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: tado.png +ha_category: Sensor +ha_release: 0.41 +--- + +The `tado` sensor platform allow you to monitor your tado climate devices. + + +The requirement is that you have set up the [tado](/components/tado/) component. + diff --git a/source/_components/shell_command.markdown b/source/_components/shell_command.markdown index babb6d11a27..c7c55e557de 100644 --- a/source/_components/shell_command.markdown +++ b/source/_components/shell_command.markdown @@ -28,7 +28,7 @@ Configuration variables: - Alias for the command - Command itself. -The commands can be dynamic, using templates to insert values of other entities. When using templates you are limited to only template the arguments. You are also no longer allowed to use pipe symbols when using templates. +The commands can be dynamic, using templates to insert values for arguments. When using templates, shell_command runs in a more secure environment which doesn't allow any shell helpers like automatically expanding the home dir `~` or using pipe symbols to run multiple commands. Any service data passed into the service call to activate the shell command will be available as a variable within the template. diff --git a/source/_components/switch.lutron_caseta.markdown b/source/_components/switch.lutron_caseta.markdown new file mode 100644 index 00000000000..734c5a38482 --- /dev/null +++ b/source/_components/switch.lutron_caseta.markdown @@ -0,0 +1,14 @@ +--- +layout: page +title: "Lutron Caseta Switch" +description: "Instructions how to setup the Lutron Caseta switches within Home Assistant." +date: 2017-04-30 09:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: lutron.png +ha_category: Switch +--- + +To get your Lutron Caseta switches working with Home Assistant, follow the instructions for the general [Lutron Caseta component](/components/lutron_caseta/). diff --git a/source/_components/tado.markdown b/source/_components/tado.markdown new file mode 100644 index 00000000000..50f98e19098 --- /dev/null +++ b/source/_components/tado.markdown @@ -0,0 +1,34 @@ +--- +layout: page +title: "Tado" +description: "Instructions on how to integrate Tado devices with Home Assistant." +date: 2017-03-20 12:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: tado.png +ha_category: Hub +ha_release: 0.41 +--- + + +The `tado` component platform is used as an interface to the [my.tado.com](https://my.tado.com/webapp/#/account/sign-in) website. It adds climate devices for every tado zone and sensors for some additional information of the zones. + +To use your tado thermostats in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +tado: + username: YOUR_USERNAME + password: YOUR_PASSWORD +``` + +Configuration variables: + +- **username** (*Required*): Username for my.tado.com. +- **password** (*Required*): Password for my.tado.com. + +The tado thermostats are internet connected thermostats. There exists an unofficial API at [my.tado.com](https://my.tado.com/webapp/#/account/sign-in), which is used by their website and now by this component. + +It currently supports presenting the current temperature, the setting temperature and the current operation mode. Switching the mode is also supported. If no user is at home anymore, the devices are showing the away-state. Switching to away-mode is not supported. diff --git a/source/_components/telegram_bot.markdown b/source/_components/telegram_bot.markdown index 8d51d6d9112..1450a7ed5ef 100644 --- a/source/_components/telegram_bot.markdown +++ b/source/_components/telegram_bot.markdown @@ -16,7 +16,7 @@ Use Telegram on your mobile device to send messages or commands to your Home Ass A command looks like `/thecommand` -When received by hass it will fire a `telegram.command` event on the event bus with the following `event_data`: +When received by hass it will fire a `telegram_command` event on the event bus with the following `event_data`: ```yaml command: "/thecommand" @@ -36,7 +36,7 @@ alias: 'telegram bot that reply pong to ping' hide_entity: true trigger: platform: event - event_type: telegram.command + event_type: telegram_command event_data: command: '/ping' action: @@ -50,7 +50,7 @@ Example that show keyboard interaction with `notify.telegram` ```yaml trigger: platform: event - event_type: telegram.command + event_type: telegram_command event_data: command: '/start' action: @@ -68,7 +68,7 @@ and an automation to trigger a related command "/siren". ```yaml trigger: platform: event - event_type: telegram.command + event_type: telegram_command event_data: command: '/siren' action: diff --git a/source/_components/telegram_bot.webhooks.markdown b/source/_components/telegram_bot.webhooks.markdown index 7b2dfe387dc..7bb8c601914 100644 --- a/source/_components/telegram_bot.webhooks.markdown +++ b/source/_components/telegram_bot.webhooks.markdown @@ -12,9 +12,9 @@ ha_category: Telegram chatbot ha_release: 0.42 --- -Telegram chatbot webhooks implementation as described in [docs](https://core.telegram.org/bots/webhooks). +Telegram chatbot webhooks implementation as described in the Telegram [documentation](https://core.telegram.org/bots/webhooks). -One of two bot implementations supported by Telegram. Described by Telegram as the preferred implementation but requires your hass instance to be exposed to the internet. +This is one of two bot implementations supported by Telegram. Described by Telegram as the preferred implementation but requires your Home Assistant instance to be exposed to the internet. To integrate this into Home Assistant, add the following section to your `configuration.yaml` file: @@ -46,7 +46,8 @@ Full configuration sample: http: base_url:+If you see an "Unable to connect" message, restart the gateway and try again. +
+ +The gateway can also be manually configured by adding the following lines to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry @@ -41,4 +63,4 @@ tradfri: Configuration variables: - **host** (*Required*): The IP address or hostname of your Trådfri gateway. - - **api_key** (*Required*): Can be found on the back of the Trådfri gateway. + - **api_key** (*Required*): Can be found listed as Security Key on the back of the Trådfri gateway. diff --git a/source/_components/updater.markdown b/source/_components/updater.markdown index b3797d9f5b5..eda5bd95f41 100644 --- a/source/_components/updater.markdown +++ b/source/_components/updater.markdown @@ -13,7 +13,7 @@ ha_category: Other The `updater` component will check daily for new releases. It will show a badge in the frontend if a new version was found. -The updater component will also collect basic information about Home Assistant and its environment. The information includes the current Home Assistant version, the timezone, Python version and operating system information. No identifiable information (i.e. IP address, GPS coordinates, etc.) will ever be collected. If you are concerned about your privacy, you are welcome to scrutinize the Python [source code](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/components/updater.py#L91). +The updater component will also collect basic information about the running Home Assistant instance and its environment. The information includes the current Home Assistant version, the timezone, Python version and operating system information. No identifiable information (i.e. IP address, GPS coordinates, etc.) will ever be collected. If you are concerned about your privacy, you are welcome to scrutinize the Python [source code](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/components/updater.py#L91). For further information about the Updater's data please check the [detailed overview](/docs/backend/updater/). To integrate this into Home Assistant, add the following section to your `configuration.yaml` file: diff --git a/source/_cookbook/python_component_basic_service.markdown b/source/_cookbook/python_component_basic_service.markdown index 5c53ecc1c99..178750bec52 100644 --- a/source/_cookbook/python_component_basic_service.markdown +++ b/source/_cookbook/python_component_basic_service.markdown @@ -23,7 +23,7 @@ DEFAULT_NAME = 'World' def setup(hass, config): - """Setup is called when Home Assistant is loading our component.""" + """Set up is called when Home Assistant is loading our component.""" def handle_hello(call): name = call.data.get(ATTR_NAME, DEFAULT_NAME) diff --git a/source/_cookbook/python_component_basic_state.markdown b/source/_cookbook/python_component_basic_state.markdown index 623135363b0..8dbe1ae0b9d 100644 --- a/source/_cookbook/python_component_basic_state.markdown +++ b/source/_cookbook/python_component_basic_state.markdown @@ -82,7 +82,7 @@ CONF_TEXT = 'text' DEFAULT_TEXT = 'No text!' def setup(hass, config): - """Setup the Hello State component. """ + """Set up the Hello State component. """ # Get the text from the configuration. Use DEFAULT_TEXT if no name is provided. text = config[DOMAIN].get(CONF_TEXT, DEFAULT_TEXT) diff --git a/source/_cookbook/python_component_mqtt_basic.markdown b/source/_cookbook/python_component_mqtt_basic.markdown index a4f4603dd43..3deb82bd4b8 100644 --- a/source/_cookbook/python_component_mqtt_basic.markdown +++ b/source/_cookbook/python_component_mqtt_basic.markdown @@ -22,7 +22,7 @@ This example follows a topic on MQTT and updates the state of an entity to the l import homeassistant.loader as loader # The domain of your component. Should be equal to the name of your component. -DOMAIN = "hello_mqtt" +DOMAIN = 'hello_mqtt' # List of component names (string) your component depends upon. DEPENDENCIES = ['mqtt'] @@ -33,14 +33,14 @@ DEFAULT_TOPIC = 'home-assistant/hello_mqtt' def setup(hass, config): - """Setup the Hello MQTT component.""" + """Set up the Hello MQTT component.""" mqtt = loader.get_component('mqtt') topic = config[DOMAIN].get('topic', DEFAULT_TOPIC) entity_id = 'hello_mqtt.last_message' # Listener to be called when we receive a message. def message_received(topic, payload, qos): - """A new MQTT message has been received.""" + """Handle new MQTT messages.""" hass.states.set(entity_id, payload) # Subscribe our listener to a topic. diff --git a/source/_cookbook/python_component_simple_alarm.markdown b/source/_cookbook/python_component_simple_alarm.markdown index 2ac645b46c3..16e7d015daa 100644 --- a/source/_cookbook/python_component_simple_alarm.markdown +++ b/source/_cookbook/python_component_simple_alarm.markdown @@ -39,35 +39,35 @@ from homeassistant.components import device_tracker, light, notify from homeassistant.helpers.event import track_state_change from homeassistant.const import STATE_ON, STATE_OFF, STATE_HOME, STATE_NOT_HOME -DOMAIN = "simple_alarm" +_LOGGER = logging.getLogger(__name__) + +DOMAIN = 'simple_alarm"' DEPENDENCIES = ['group', 'device_tracker', 'light'] # Attribute to tell which light has to flash when a known person comes home # If omitted will flash all. -CONF_KNOWN_LIGHT = "known_light" +CONF_KNOWN_LIGHT = 'known_light' # Attribute to tell which light has to flash when an unknown person comes home # If omitted will flash all. -CONF_UNKNOWN_LIGHT = "unknown_light" +CONF_UNKNOWN_LIGHT = 'unknown_light' # Services to test the alarms -SERVICE_TEST_KNOWN_ALARM = "test_known" -SERVICE_TEST_UNKNOWN_ALARM = "test_unknown" +SERVICE_TEST_KNOWN_ALARM = 'test_known' +SERVICE_TEST_UNKNOWN_ALARM = 'test_unknown' def setup(hass, config): - """ Sets up the simple alarms. """ - logger = logging.getLogger(__name__) - + """Set up the simple alarms.""" light_ids = [] for conf_key in (CONF_KNOWN_LIGHT, CONF_UNKNOWN_LIGHT): light_id = config[DOMAIN].get(conf_key, light.ENTITY_ID_ALL_LIGHTS) if hass.states.get(light_id) is None: - logger.error( - 'Light id %s could not be found in state machine', light_id) + _LOGGER.error( + "Light id %s could not be found in state machine", light_id) return False @@ -77,7 +77,7 @@ def setup(hass, config): known_light_id, unknown_light_id = light_ids if hass.states.get(device_tracker.ENTITY_ID_ALL_DEVICES) is None: - logger.error('No devices are being tracked, cannot setup alarm') + _LOGGER.error("No devices are being tracked, cannot setup alarm") return False @@ -102,7 +102,7 @@ def setup(hass, config): DOMAIN, SERVICE_TEST_UNKNOWN_ALARM, lambda call: unknown_alarm()) def unknown_alarm_if_lights_on(entity_id, old_state, new_state): - """ Called when a light has been turned on. """ + """Called when a light has been turned on.""" if not device_tracker.is_on(hass): unknown_alarm() @@ -111,7 +111,7 @@ def setup(hass, config): unknown_alarm_if_lights_on, STATE_OFF, STATE_ON) def ring_known_alarm(entity_id, old_state, new_state): - """ Called when a known person comes home. """ + """Called when a known person comes home.""" if light.is_on(hass, known_light_id): known_alarm() diff --git a/source/_cookbook/turn_on_light_for_10_minutes_when_motion_detected.markdown b/source/_cookbook/turn_on_light_for_10_minutes_when_motion_detected.markdown index 4da386bbbc9..ed859cdaeed 100644 --- a/source/_cookbook/turn_on_light_for_10_minutes_when_motion_detected.markdown +++ b/source/_cookbook/turn_on_light_for_10_minutes_when_motion_detected.markdown @@ -20,7 +20,7 @@ automation: trigger: platform: state entity_id: sensor.motion_sensor - to: 'on' + state: 'on' action: service: homeassistant.turn_on entity_id: light.kitchen @@ -29,7 +29,7 @@ automation: trigger: platform: state entity_id: sensor.motion_sensor - to: 'off' + state: 'off' for: minutes: 10 action: diff --git a/source/_docs/configuration/group_visibility.markdown b/source/_docs/configuration/group_visibility.markdown index 13c5cf9d7be..c3e284a05e0 100644 --- a/source/_docs/configuration/group_visibility.markdown +++ b/source/_docs/configuration/group_visibility.markdown @@ -103,6 +103,10 @@ sensor: name: Occasion command: "python3 occasion.py" ``` ++If you are using docker to run home assistant then the occasion.py script will be placed under /config. Your command should instead be: command: "python3 /command/occasion.py" +
+ To simplify things, we create a Home Assistant script that changes the visibility of a group, but also verifies that an entity is in a specific state: @@ -124,8 +128,8 @@ automation: trigger: - platform: state entity_id: sensor.occasion - - platform: event - event_type: homeassistant_start + - platform: homeassistant + event: start action: service: script.group_visibility data: @@ -169,8 +173,8 @@ automation: trigger: - platform: state entity_id: sensor.occasion - - platform: event - event_type: homeassistant_start + - platform: homeassistant + event: start action: service: script.group_visibility data: diff --git a/source/_docs/configuration/templating.markdown b/source/_docs/configuration/templating.markdown index 8750a081f89..e7739999e0e 100644 --- a/source/_docs/configuration/templating.markdown +++ b/source/_docs/configuration/templating.markdown @@ -89,6 +89,11 @@ Home Assistant adds extensions to allow templates to access all of the current s [strp-format]: https://docs.python.org/3.4/library/datetime.html#strftime-and-strptime-behavior ++If your template uses an `entity_id` that begins with a number (example: `states.device_tracker.2008_gmc`) you must use a bracket syntax to avoid errors caused by rendering the `entity_id` improperly. In the example given, the correct syntax for the device tracker would be: `states.device_tracker['2008_gmc']` +
+ + ## {% linkable_title Examples %} ### {% linkable_title States %} diff --git a/source/_docs/ecosystem/backup/backup_dropbox.markdown b/source/_docs/ecosystem/backup/backup_dropbox.markdown new file mode 100644 index 00000000000..9c2472a8247 --- /dev/null +++ b/source/_docs/ecosystem/backup/backup_dropbox.markdown @@ -0,0 +1,53 @@ +--- +layout: page +title: "Configuration Backup to Dropbox" +description: "Instructions how backup your Home Assistant configuration to Dropbox" +date: 2017-04-24 18:00 +sidebar: true +comments: false +sharing: true +footer: true +redirect_from: /cookbook/dropboxbackup/ +--- + +Backing up and regularly syncing your Home Assistant configuration to [Dropbox](http://dropbox.com) similar to [Github Backup](https://home-assistant.io/docs/ecosystem/backup/backup_github/) + +### {% linkable_title Requirements %} + +You need 2 parts in order to get it working correctly. + +Become the user you run homeassistant from. + +- A seperate python script that syncs a specific folder. Which can be found [here](https://gist.github.com/riemers/31e3350041fd3e47e489cbc811209d6f) +- The excellent [dropbox uploader script](https://github.com/andreafabrizi/Dropbox-Uploader/blob/master/dropbox_uploader.sh) you can grab the .sh file only. + +Download those files to a folder of your liking, after that edit both files and change paths accordingly. +### {% linkable_title Step 1: Linking your dropbox account %} + +```bash +$ chmod +x dropbox_uploader.sh +$ ./dropbox_uploader.sh +``` +Follow the instructions you see on your screen. + +### {% linkable_title Step 2: Running the dropbox uploader %} + +Go to the folder you have placed dropbox.py. + +```bash +$ python dropbox.py +``` + +The first time can take a lot of time since it will upload all your files! +Do note, this will **backup your passwords to dropbox too** + +### {% linkable_title Automate the backup %} + +So you just made a full backup, next time you want it to be done automaticly. Since your database can change and so do other files over time. +Add it to your crontab, edit the **path/to** part. + +```bash +$ (crontab -l 2>/dev/null; echo "0 3 * * * python /path/to/dropbox.py") | crontab - +``` + +_The python script is very crude, there is room for improvement with regards to not backing up certain files like cache or files that will be installed by HA again after reinstall. But it gets the job done._ diff --git a/source/_docs/ecosystem/backup/backup_usb.markdown b/source/_docs/ecosystem/backup/backup_usb.markdown new file mode 100644 index 00000000000..047bc0c70b9 --- /dev/null +++ b/source/_docs/ecosystem/backup/backup_usb.markdown @@ -0,0 +1,116 @@ +--- +layout: page +title: "Configuration Backup to USB drive" +description: "Instructions how backup your Home Assistant configuration to USB drive" +date: 2017-04-29 08:00 +sidebar: true +comments: false +sharing: true +footer: true +--- + +Backing up your Home Assistant configuration to USB drive. A good plus side is that you don't need to mask all your passwords since the backup is locally at your home/residence. + +### {% linkable_title Requirements %} +First you need a USB drive. Once you have one you need to prepare it to be used on your device. +Once connected you want to format/work with the drive. To know what path it is in, you can check with `dmesg`. + +```bash +# dmesg | grep sd +[ 0.909712] sdhci: Secure Digital Host Controller Interface driver +[ 0.916414] sdhci: Copyright(c) Pierre Ossman +[ 0.923366] sdhost: log_buf @ bac07000 (fac07000) +[ 0.989001] mmc0: sdhost-bcm2835 loaded - DMA enabled (>1) +[ 1.049095] sdhci-pltfm: SDHCI platform and OF driver helper +[726257.743301] sd 0:0:0:0: Attached scsi generic sg0 type 0 +[726259.184810] sd 0:0:0:0: [sda] 124846080 512-byte logical blocks: (63.9 GB/59.5 GiB) +[726259.185603] sd 0:0:0:0: [sda] Write Protect is off +[726259.185613] sd 0:0:0:0: [sda] Mode Sense: 23 00 00 00 +[726259.186432] sd 0:0:0:0: [sda] No Caching mode page found +[726259.186445] sd 0:0:0:0: [sda] Assuming drive cache: write through +[726259.206085] sda: sda1 +[726259.209004] sd 0:0:0:0: [sda] Attached SCSI removable disk +``` + +Here we see we have a drive on `/dev/sda1`. We assume you created a partition on the drive to start with. This can be any type of partition. Preferred is a Linux filesystem type so you can set permissions! + +Mount the drive (as root) to `/media` + +```bash +# mount /dev/sda1 /media/ +``` + +### {% linkable_title Prepare USB Stick %} +Change into it and create a folder called `hassbackup` and change the ownership to the user that runs Home Assistant. In my case group and user are both `homeassistant`. + +```bash +# cd /media/ +/media# mkdir hassbackup +/media# chown homeassistant:homeassistant hassbackup/ +/media# ls -al +total 28 +drwxr-xr-x 4 root root 4096 Apr 29 10:36 . +drwxr-xr-x 22 root root 4096 Mar 22 18:37 .. +drwxr-xr-x 2 homeassistant homeassistant 4096 Apr 29 10:36 hassbackup +drwx------ 2 root root 16384 Apr 29 10:18 lost+found +``` +You can ignore 'lost+found'. + +### {% linkable_title Install Dependency %} + +In order to preserve space on your drive we use zip. Install that too. + +```bash +/media# apt-get install zip +Reading package lists... Done +Building dependency tree +[...] +Setting up zip (3.0-8) ... +``` + +### {% linkable_title Install and run script %} + +Become the `homeassistant` user and place the following [script](https://gist.github.com/riemers/041c6a386a2eab95c55ba3ccaa10e7b0) to a place of your liking. + +```bash +# wget https://gist.githubusercontent.com/riemers/041c6a386a2eab95c55ba3ccaa10e7b0/raw/86727d4e72e9757da4f68f1c9d784720e72d0e99/usb_backup.sh +``` + +Make the downloaded script executable. + +```bash +# chmod +x usb_backup.sh +``` + +Open up the file and change the paths you want to use, then simply run the `./usb_backup.sh`. + +```bash +$ .homeassistant/extraconfig/shell_code/usb_backup.sh +[i] Creating backup +[i] Backup complete: /media/hassbackup/hass-config_20170429_112728.zip +[i] Keeping all files no prunning set +``` + +### {% linkable_title Crontab %} +In order for this to automatically make a backup every night at 3 am, you can add a crontab for it as the `homeassistant` user. +Change below path to where you placed the `usb_backup.sh` and run the following line. + +```bash +(crontab -l 2>/dev/null; echo "0 3 * * * /home/homeassistant/.homeassistant/extraconfig/shell_code/usb_backup.sh") | crontab - +``` + +### {% linkable_title Auto mount %} + +This does not automaticly mount your USB drive at boot. You need to do that manually or add a line to your `/etc/fstab` file. + +If your drive is on `/dev/sda1`, you could add a entry to your `/etc/fstab` like so: + +```text +/dev/sda1 /media ext4 defaults,noatime 0 1 +``` + +Manual step to mount the USB drive: + +```bash +# mount /dev/sda1 /media +``` diff --git a/source/_docs/ecosystem/ios/location.markdown b/source/_docs/ecosystem/ios/location.markdown index beb6ca7019f..54d61da2e71 100644 --- a/source/_docs/ecosystem/ios/location.markdown +++ b/source/_docs/ecosystem/ios/location.markdown @@ -34,7 +34,21 @@ At launch, Home Assistant for iOS sets up geofences for all zones in your Home A ### Configuration -To disable location tracking add `track_ios: false` to each zones settings or under customize. +Add `track_ios: false` to your zone configurations to disable zone location tracking for all connected iOS apps. + +### iBeacons + +As of 1.0.3 the app has basic support for using iBeacons to trigger enter/exit updates. To configure them, add your iBeacon details to your zone like this: + +```yaml +zone.home: + beacon: + uuid: B9407F30-F5F8-466E-AFF9-25556B57FE6D + major: 60042 + minor: 43814 +``` + +Restart Home Assistant and then the iOS app. It will begin then begin using iBeacons _instead of your location_ for enter and exit triggers around your zones. To add an iBeacon to `zone.home` add the above under your `customize`. [apple-energy-guide]: https://developer.apple.com/library/content/documentation/Performance/Conceptual/EnergyGuide-iOS/LocationBestPractices.html#//apple_ref/doc/uid/TP40015243-CH24-SW4 [apple-location-programming-guide]: https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/LocationAwarenessPG/CoreLocation/CoreLocation.html#//apple_ref/doc/uid/TP40009497-CH2-SW9 diff --git a/source/_docs/ecosystem/ios/notifications/basic.markdown b/source/_docs/ecosystem/ios/notifications/basic.markdown index 188454e259a..5f8d7237450 100644 --- a/source/_docs/ecosystem/ios/notifications/basic.markdown +++ b/source/_docs/ecosystem/ios/notifications/basic.markdown @@ -57,3 +57,28 @@ automation data: subtitle: "Subtitle goes here" ``` + +### {% linkable_title Sending notifications to multiple phones %} +To send notifications to multiple phones, create a [notification group](https://home-assistant.io/components/notify.group/): +```yaml +notify: + - name: NOTIFIER_NAME + platform: group + services: + - service: ios_iphone_one + - service: ios_iphone_two +``` +Now, you can send notifications to everyone in the group using: +```yaml + automation: + - alias: Notify iOS app + trigger: + ... + action: + service: notify.NOTIFIER_NAME + data: + message: "Something happened at home!" + data: + push: + badge: 5 +``` diff --git a/source/_docs/ecosystem/ios/notifications/content_extensions.markdown b/source/_docs/ecosystem/ios/notifications/content_extensions.markdown index 5cf4d5018b8..8f70fcb8ef6 100644 --- a/source/_docs/ecosystem/ios/notifications/content_extensions.markdown +++ b/source/_docs/ecosystem/ios/notifications/content_extensions.markdown @@ -24,10 +24,28 @@ data: push: category: map action_data: - latitude: 40.785091 - longitude: -73.968285 + latitude: "40.785091" + longitude: "-73.968285" ``` +## Showing a second pin + +You can use the following properties under `action_data` to display a second pin. If used, the first pin will be red and the second green. + +- **second_latitude**: The latitude of the second pin. **Must be a string!** +- **second_longitude**: The longitude of the second pin. **Must be a string!** +- **shows_line_between_points**: A Boolean value indicating whether a line should be drawn between the first and second pin. + +## Extra configuration + +You can also pass the following properties under `action_data` to modify the map in various ways. All are expected to be boolean values unless otherwise noted: + +- **shows_compass**: A Boolean indicating whether the map displays a compass control. +- **shows_points_of_interest**: A Boolean indicating whether the map displays point-of-interest information. +- **shows_scale**: A Boolean indicating whether the map shows scale information. +- **shows_traffic**: A Boolean value indicating whether the map displays traffic information. +- **shows_user_location**: A Boolean value indicating whether the map should try to display the user’s location. +
- To avoid permission errors, the upgrade must be run as the same user as the installation was completed, again review the documentation specific to your install [HASSbian](/docs/hassbian/installation/), [Raspberry Pi All-In-One Installer](/docs/installation/raspberry-pi-all-in-one/), [Vagrant](/docs/installation/vagrant/), or [Virtualenv](/docs/installation/virtualenv).
+To avoid permission errors, the upgrade must be run as the same user as the installation was completed, again review the documentation specific to your install [HASSbian](/docs/hassbian/installation/), [Raspberry Pi All-In-One Installer](/docs/installation/raspberry-pi-all-in-one/), [Vagrant](/docs/installation/vagrant/), or [Virtualenv](/docs/installation/virtualenv).
Do not use root to build python-openzwave as it will surely fail.
+ Add-ons are extensions for your Home Assistant installation.
+ 
An example of the map dynamic content.
@@ -60,3 +78,7 @@ data:
# Combining with actionable notifications
As you can see the `category` key is used to tell the device what kind of content extension to use. You can use the same category identifiers in your own custom [actions](/ecosystem/ios/notifications/actions/) to add actions to the content extension.
+
+# Troubleshooting
+
+If you are having problems with receiving these special notifications try restarting your phone first. The extensions somewhat often fail to register properly until a restart.
diff --git a/source/_docs/ecosystem/nginx.markdown b/source/_docs/ecosystem/nginx.markdown
index b3305a9de34..05e71339d0f 100644
--- a/source/_docs/ecosystem/nginx.markdown
+++ b/source/_docs/ecosystem/nginx.markdown
@@ -89,8 +89,7 @@ http {
server_name example.com;
# These shouldn't need to be changed
- listen 80 default_server;
- listen [::]:80 default_server ipv6only=on;
+ listen [::]:80 default_server ipv6only=off;
return 301 https://$host$request_uri;
}
@@ -110,7 +109,7 @@ http {
# These shouldn't need to be changed
- listen 443 default_server;
+ listen [::]:443 default_server ipv6only=off; # if your nginx version is >= 1.9.5 you can also add the "http2" flag here
add_header Strict-Transport-Security "max-age=31536000; includeSubdomains";
ssl on;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
diff --git a/source/_docs/ecosystem/notebooks/graph.markdown b/source/_docs/ecosystem/notebooks/graph.markdown
index 4fda74e239a..ca17727cd6b 100644
--- a/source/_docs/ecosystem/notebooks/graph.markdown
+++ b/source/_docs/ecosystem/notebooks/graph.markdown
@@ -10,4 +10,4 @@ footer: true
redirect_from: /ecosystem/notebooks/graph/
---
-For graphing this [Jupyter notebook](ha_external_link: http://nbviewer.jupyter.org/github/home-assistant/home-assistant-notebooks/blob/master/graph-single-sensor.ipynb) should get you started.
+For graphing this [Jupyter notebook](http://nbviewer.jupyter.org/github/home-assistant/home-assistant-notebooks/blob/master/graph-single-sensor.ipynb) should get you started.
diff --git a/source/_docs/hassbian/customization.markdown b/source/_docs/hassbian/customization.markdown
index 86f7b28b4c4..7eeec8d4585 100644
--- a/source/_docs/hassbian/customization.markdown
+++ b/source/_docs/hassbian/customization.markdown
@@ -10,14 +10,17 @@ footer: true
redirect_from: /getting-started/hassbian-customization/
---
-To allow you to customize your installation further, we have included a set of Hassbian scripts.
+To allow you to customize your installation further, we have included a tool called `hassbian-config`. This tool comes with a set of packages that can easily be installed for easier customization of your Home Assistant installation.
- Install Samba. Allows anyone on your network to edit your configuration from any computer. This share is unsecured and it's usage is not recommended if you share your network with others.
- Install Libcec. Adds local [HDMI CEC support][cec].
- Install Mosquitto MQTT server. Installs the latest Mosquitto package and client tools from the Mosquitto projects offical repository. Now includes websocket support.
- Install Open Z-Wave. Installs Open Z-Wave and prepares for using a USB or GPIO ZWave controller.
+ - Install Hue. hue: Configures the Python executable to allow usage of low numbered ports for use with Emulated Hue component thats used with Amazon Echo, Google Home and Mycroft.ai.
+ - Install Tellstick. Installs the Tellstick package for controling and using a connected Tellstick.
-All of these scripts are available in the directory `/home/pi/hassbian-scripts/`. For more information about these scripts have a look at the [hassbian-scripts repository][hassbian-repo].
+The tool is available by running `hassbian-config`. To view the available packages run `hassbian-config show` and `sudo hassbian-config install PACKAGENAME`.
+For more information about this tool have a look at the [hassbian-scripts repository][hassbian-repo].
-[hassbian-repo]: https://github.com/home-assistant/hassbian-scripts#the-included-scripts
+[hassbian-repo]: https://github.com/home-assistant/hassbian-scripts
[cec]: /components/hdmi_cec/
diff --git a/source/_docs/hassbian/installation.markdown b/source/_docs/hassbian/installation.markdown
index 22b4ea2096f..5c31601e936 100644
--- a/source/_docs/hassbian/installation.markdown
+++ b/source/_docs/hassbian/installation.markdown
@@ -12,9 +12,9 @@ redirect_from: /getting-started/installation-raspberry-pi-image/
The easiest way to install Home Assistant on your Raspberry Pi is by using HASSbian: a Raspberry Pi image with Home Assistant built-in. The image will install the latest version of Home Assistant on initial boot (~10 minutes).
- 1. [Download the Hassbian 1.1 image][image-download] (359 MB)
+ 1. [Download the Hassbian image][image-download] (364 MB)
2. Use [Etcher][etcher] to flash the image to your SD card
- 3. Ensure your Raspberry Pi has access to the internet.
+ 3. Ensure your Raspberry Pi has wired access to the internet.
4. Insert SD card to Raspberry Pi and turn it on. Initial installation of Home Assistant will take about 5 minutes.
These instructions are also available as a [video](https://www.youtube.com/watch?v=iIz6XqDwHEk). Additional information is available in this [video](https://www.youtube.com/watch?v=tCGlQSsQ-Mc).
@@ -25,6 +25,8 @@ The following extras are included on the image:
- GPIO pins are ready to use.
- Bluetooth is ready to use (supported models only, no Bluetooth LE).
+ - SSH server is enabled.
+ - A tool called `hassbian_config`.
### {% linkable_title Technical Details %}
@@ -32,6 +34,6 @@ The following extras are included on the image:
- Home Assistant will be started as a service run by the user `homeassistant`
- The configuration is located at `/home/homeassistant/.homeassistant`
-[image-download]: https://github.com/home-assistant/pi-gen/releases/download/v1.1/image_2017-02-03-HASSbian.zip
+[image-download]: https://github.com/home-assistant/pi-gen/releases/latest
[etcher]: https://etcher.io/
[http://hassbian.local:8123]: http://hassbian.local:8123
diff --git a/source/_docs/hassbian/integrations.markdown b/source/_docs/hassbian/integrations.markdown
index 122ae0b54ee..53dfffa5015 100644
--- a/source/_docs/hassbian/integrations.markdown
+++ b/source/_docs/hassbian/integrations.markdown
@@ -16,11 +16,21 @@ Some components that are specific for the Raspberry Pi can require some further
The Bluetooth tracker will work on a Raspberry Pi 3 with the built-in Bluetooth module or with a USB Bluetooth device on any of the other Raspberry Pi's.
-Install the following external dependencies.
-```bash
-$ sudo apt-get install bluetooth libbluetooth-dev
-```
-After this follow the [Bluetooth Tracker component](/components/device_tracker.bluetooth_tracker/) and [Device Tracker page](/components/device_tracker/) pages.
+Software needed for the tracker is pre-installed so just follow the [Bluetooth Tracker component](/components/device_tracker.bluetooth_tracker/) and [Device Tracker page](/components/device_tracker/) pages.
+
+### {% linkable_title Raspberry Pi GPIO %}
+
+Each of the following devices are connected to the GPIO pins on the Raspberry Pi.
+For more details about the GPIO layout, visit the [documentation](https://www.raspberrypi.org/documentation/usage/gpio/) from the Raspberry Pi foundation.
+
+Permission have been given to the `homeassistant` user to use the GPIO pins and all of the following components should require no underlying changes to work.
+Just follow the component pages for each on how to add them to your Home Assistant installation.
+
+ - [DHT Sensor](/components/sensor.dht/).
+ - [Raspberry Pi Cover](/components/cover.rpi_gpio/).
+ - [Raspberry PI GPIO Binary Sensor](/components/binary_sensor.rpi_gpio/).
+ - [Raspberry PI GPIO Switch](/components/switch.rpi_gpio/).
+ - [Raspberry Pi RF Switch](/components/switch.rpi_rf/).
### {% linkable_title Raspberry Pi Camera %}
@@ -34,63 +44,8 @@ $ sudo raspi-config
Select `Enable camera` choose `
+
+ Topics
+
+
+ 
+
+{% for addon in addons %}
+
diff --git a/source/developers/credits.markdown b/source/developers/credits.markdown
index f2b6bcd56f2..a2df7252373 100644
--- a/source/developers/credits.markdown
+++ b/source/developers/credits.markdown
@@ -2,7 +2,7 @@
layout: page
title: "Credits"
description: "Credits for the developers who contributed to Home Assistant."
-date: 2017-04-18 21:17:50 +0000
+date: 2017-04-24 07:59:09 +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 "5150 total commits to the home-assistant organization, 3190 commits to home-assistant, 1039 commits to home-assistant.github.io, 497 commits to home-assistant-polymer, 244 commits to home-assistant-js, 103 commits to netdisco, 39 commits to home-assistant-js-websocket, 12 commits to home-assistant-assets, 8 commits to hass-release, 7 commits to micropython-home-assistant, 4 commits to example-custom-config, 2 commits to python-hassbian, 2 commits to lambda-home-assistant-github, 1 commit to issue-bot, 1 commit to home-assistant-notebooks, 1 commit to home-assistant-iOS")
+- [Paulus Schoutsen (@balloob)](https://github.com/balloob "5191 total commits to the home-assistant organization, 3215 commits to home-assistant, 1045 commits to home-assistant.github.io, 501 commits to home-assistant-polymer, 244 commits to home-assistant-js, 106 commits to netdisco, 39 commits to home-assistant-js-websocket, 12 commits to home-assistant-assets, 11 commits to hass-release, 7 commits to micropython-home-assistant, 4 commits to example-custom-config, 2 commits to lambda-home-assistant-github, 2 commits to python-hassbian, 1 commit to home-assistant-notebooks, 1 commit to issue-bot, 1 commit to home-assistant-iOS")
### {% linkable_title Contributors %}
@@ -28,7 +28,7 @@ This page contains a list of people who have contributed in one way or another t
- [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 "126 total commits to the home-assistant organization, 82 commits to home-assistant, 22 commits to home-assistant-polymer, 19 commits to home-assistant.github.io, 3 commits to home-assistant-js")
+- [Adam Mills (@armills)](https://github.com/armills "129 total commits to the home-assistant organization, 85 commits to home-assistant, 22 commits to home-assistant-polymer, 19 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")
@@ -39,7 +39,7 @@ This page contains a list of people who have contributed in one way or another t
- [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 "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")
-- [Alessandro Mogavero (@alexmogavero)](https://github.com/alexmogavero "2 total commits to the home-assistant organization, 2 commits to home-assistant")
+- [Alessandro Mogavero (@alexmogavero)](https://github.com/alexmogavero "3 total commits to the home-assistant organization, 3 commits to home-assistant")
- [Alex (@asbach)](https://github.com/asbach "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
- [Alex 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")
@@ -54,20 +54,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 "49 total commits to the home-assistant organization, 31 commits to home-assistant.github.io, 16 commits to home-assistant, 1 commit to pi-gen, 1 commit to hassbian-scripts")
+- [Alok Saboo (@arsaboo)](https://github.com/arsaboo "51 total commits to the home-assistant organization, 32 commits to home-assistant.github.io, 17 commits to home-assistant, 1 commit to pi-gen, 1 commit to hassbian-scripts")
- [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")
-- [Anders Melchiorsen (@amelchio)](https://github.com/amelchio "19 total commits to the home-assistant organization, 13 commits to home-assistant, 6 commits to home-assistant.github.io")
+- [Anders Melchiorsen (@amelchio)](https://github.com/amelchio "23 total commits to the home-assistant organization, 17 commits to home-assistant, 6 commits to home-assistant.github.io")
- [Andrea Falcone (@asfalcone)](https://github.com/asfalcone "5 total commits to the home-assistant organization, 5 commits to issue-bot")
- [Andreas Cambitsis (@acambitsis)](https://github.com/acambitsis "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [Andreas Jacobsen (@andreasjacobsen93)](https://github.com/andreasjacobsen93 "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 (@aneisch)](https://github.com/aneisch "4 total commits to the home-assistant organization, 4 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 "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
- [Andrew Cockburn (@acockburn)](https://github.com/acockburn "240 total commits to the home-assistant organization, 122 commits to appdaemon, 85 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")
@@ -77,7 +77,7 @@ 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 (@andrey-git)](https://github.com/andrey-git "101 total commits to the home-assistant organization, 53 commits to home-assistant, 26 commits to home-assistant-polymer, 22 commits to home-assistant.github.io")
+- [Andrey (@andrey-git)](https://github.com/andrey-git "103 total commits to the home-assistant organization, 54 commits to home-assistant, 27 commits to home-assistant-polymer, 22 commits to home-assistant.github.io")
- [Andrey Petrov (@anpetrov)](https://github.com/anpetrov "2 total commits to the home-assistant organization, 1 commit to home-assistant.github.io, 1 commit to home-assistant")
- [Andrzej (@andriej)](https://github.com/andriej "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
- [Andy Lindeman (@alindeman)](https://github.com/alindeman "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
@@ -101,7 +101,7 @@ This page contains a list of people who have contributed in one way or another t
- [Assaf Inbal (@shmuelzon)](https://github.com/shmuelzon "11 total commits to the home-assistant organization, 8 commits to homebridge-homeassistant, 3 commits to home-assistant")
- [atorralba (@atorralba)](https://github.com/atorralba "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
- [Audun Ytterdal (@auduny)](https://github.com/auduny "2 total commits to the home-assistant organization, 2 commits to home-assistant")
-- [aufano (@aufano)](https://github.com/aufano "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [aufano (@aufano)](https://github.com/aufano "2 total commits to the home-assistant organization, 2 commits to home-assistant")
- [Austin (@trainman419)](https://github.com/trainman419 "8 total commits to the home-assistant organization, 8 commits to home-assistant")
- [Avraham David Gelbfish (@adgelbfish)](https://github.com/adgelbfish "2 total commits to the home-assistant organization, 1 commit to hadashboard, 1 commit to pi-gen")
- [Barry Williams (@bazwilliams)](https://github.com/bazwilliams "5 total commits to the home-assistant organization, 2 commits to netdisco, 2 commits to home-assistant, 1 commit to home-assistant.github.io")
@@ -139,7 +139,7 @@ This page contains a list of people who have contributed in one way or another t
- [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")
- [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 "8 total commits to the home-assistant organization, 8 commits to home-assistant.github.io")
+- [Brian J King (@brianjking)](https://github.com/brianjking "9 total commits to the home-assistant organization, 9 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")
@@ -156,12 +156,12 @@ This page contains a list of people who have contributed in one way or another t
- [Cenk Gündoğan (@cgundogan)](https://github.com/cgundogan "1 total commits to the home-assistant organization, 1 commit to libcoap")
- [cgtobi (@cgtobi)](https://github.com/cgtobi "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
- [chanders (@chanders)](https://github.com/chanders "2 total commits to the home-assistant organization, 2 commits to hadashboard")
-- [Charles Blonde (@CharlesBlonde)](https://github.com/CharlesBlonde "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
+- [Charles Blonde (@CharlesBlonde)](https://github.com/CharlesBlonde "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
- [Charles Spirakis (@srcLurker)](https://github.com/srcLurker "8 total commits to the home-assistant organization, 5 commits to home-assistant, 3 commits to home-assistant.github.io")
- [Chayoung You (@yous)](https://github.com/yous "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
- [Check your git settings! (@invalid-email-address)](https://github.com/invalid-email-address "1 total commits to the home-assistant organization, 1 commit to libcoap")
- [Chema García (@sch3m4)](https://github.com/sch3m4 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [Chris (@AlucardZero)](https://github.com/AlucardZero "15 total commits to the home-assistant organization, 11 commits to home-assistant.github.io, 4 commits to home-assistant")
+- [Chris (@chennin)](https://github.com/chennin "15 total commits to the home-assistant organization, 11 commits to home-assistant.github.io, 4 commits 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")
@@ -182,7 +182,6 @@ This page contains a list of people who have contributed in one way or another t
- [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")
-- [citruz (@citruz)](https://github.com/citruz "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [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")
- [Claudiu Farcas (@farcasclaudiu)](https://github.com/farcasclaudiu "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
- [Claus F. Strasburger (@cfstras)](https://github.com/cfstras "1 total commits to the home-assistant organization, 1 commit to pi-gen")
@@ -194,14 +193,13 @@ This page contains a list of people who have contributed in one way or another t
- [Cooper Dale (@Cooper-Dale)](https://github.com/Cooper-Dale "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
- [Corban Mailloux (@corbanmailloux)](https://github.com/corbanmailloux "17 total commits to the home-assistant organization, 16 commits to home-assistant.github.io, 1 commit to home-assistant")
- [Craig J. Ward (@wardcraigj)](https://github.com/wardcraigj "11 total commits to the home-assistant organization, 7 commits to home-assistant, 4 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 "24 total commits to the home-assistant organization, 13 commits to home-assistant.github.io, 9 commits to home-assistant, 1 commit to homebridge-homeassistant, 1 commit to hassbot")
- [Dan (@danieljkemp)](https://github.com/danieljkemp "22 total commits to the home-assistant organization, 15 commits to home-assistant, 7 commits to home-assistant.github.io")
- [Dan Cinnamon (@Cinntax)](https://github.com/Cinntax "13 total commits to the home-assistant organization, 10 commits to home-assistant, 3 commits to home-assistant.github.io")
- [Dan Ford (@dpford)](https://github.com/dpford "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [Dan Lowe (@tangledhelix)](https://github.com/tangledhelix "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
- [Dan Olson (@danielolson13)](https://github.com/danielolson13 "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Dan Ports (@drkp)](https://github.com/drkp "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
+- [Dan Ports (@drkp)](https://github.com/drkp "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to home-assistant.github.io")
- [Dan Smith (@kk7ds)](https://github.com/kk7ds "84 total commits to the home-assistant organization, 68 commits to home-assistant, 14 commits to home-assistant.github.io, 2 commits to home-assistant-polymer")
- [Dan Sullivan (@dansullivan86)](https://github.com/dansullivan86 "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
- [Dan Van Brunt (@iDVB)](https://github.com/iDVB "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
@@ -210,7 +208,7 @@ This page contains a list of people who have contributed in one way or another t
- [Daniel Høyer Iversen (@Danielhiversen)](https://github.com/Danielhiversen "291 total commits to the home-assistant organization, 197 commits to home-assistant, 92 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 "47 total commits to the home-assistant organization, 32 commits to home-assistant.github.io, 15 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 Peukert (@dpeukert)](https://github.com/dpeukert "2 total commits to the home-assistant organization, 1 commit to home-assistant-polymer, 1 commit to home-assistant.github.io")
- [Daniel Watkins (@OddBloke)](https://github.com/OddBloke "4 total commits to the home-assistant organization, 4 commits to home-assistant-ansible")
- [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")
@@ -220,8 +218,8 @@ This page contains a list of people who have contributed in one way or another t
- [Dave (@d4v3d)](https://github.com/d4v3d "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
- [Dave Banks (@djbanks)](https://github.com/djbanks "3 total commits to the home-assistant organization, 2 commits to appdaemon, 1 commit to home-assistant")
- [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 "9 total commits to the home-assistant organization, 9 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 "9 total commits to the home-assistant organization, 9 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 "9 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 4 commits to home-assistant")
@@ -231,7 +229,7 @@ This page contains a list of people who have contributed in one way or another t
- [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 "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 Camera (@abcminiuser)](https://github.com/abcminiuser "4 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 2 commits to home-assistant")
- [Dean Galvin (@FreekingDean)](https://github.com/FreekingDean "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [deisi (@deisi)](https://github.com/deisi "9 total commits to the home-assistant organization, 9 commits to home-assistant")
- [Delper (@Delper)](https://github.com/Delper "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
@@ -242,7 +240,6 @@ This page contains a list of people who have contributed in one way or another t
- [devdelay (@devdelay)](https://github.com/devdelay "16 total commits to the home-assistant organization, 7 commits to home-assistant.github.io, 5 commits to home-assistant, 4 commits to homebridge-homeassistant")
- [Diogo Soares (@diogos88)](https://github.com/diogos88 "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit 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 "5 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to home-assistant")
- [Drew Wells (@drewwells)](https://github.com/drewwells "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
@@ -250,10 +247,8 @@ This page contains a list of people who have contributed in one way or another t
- [Duoxilian (@Duoxilian)](https://github.com/Duoxilian "11 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 5 commits to home-assistant")
- [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.github.io, 2 commits to home-assistant")
-- [eieste (@eieste)](https://github.com/eieste "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [Ellis Percival (@flyte)](https://github.com/flyte "31 total commits to the home-assistant organization, 25 commits to home-assistant, 6 commits to home-assistant.github.io")
- [Emanuele Palombo (@elbowz)](https://github.com/elbowz "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
- [Emil Horpen Hetty (@emilhetty)](https://github.com/emilhetty "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
@@ -264,9 +259,9 @@ 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 "89 total commits to the home-assistant organization, 81 commits to home-assistant, 5 commits to home-assistant.github.io, 3 commits to netdisco")
+- [Erik Eriksson (@molobrakos)](https://github.com/molobrakos "90 total commits to the home-assistant organization, 82 commits to home-assistant, 5 commits to home-assistant.github.io, 3 commits to netdisco")
- [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 "3520 total commits to the home-assistant organization, 2214 commits to home-assistant.github.io, 1152 commits to home-assistant, 59 commits to home-assistant-ansible, 23 commits to home-assistant-dev-helper, 21 commits to home-assistant-cli, 20 commits to home-assistant-notebooks, 12 commits to home-assistant-assets, 10 commits to home-assistant-polymer, 8 commits to netdisco, 1 commit to home-assistant-js-websocket")
+- [Fabian Affolter (@fabaff)](https://github.com/fabaff "3549 total commits to the home-assistant organization, 2225 commits to home-assistant.github.io, 1170 commits to home-assistant, 59 commits to home-assistant-ansible, 23 commits to home-assistant-dev-helper, 21 commits to home-assistant-cli, 20 commits to home-assistant-notebooks, 12 commits to home-assistant-assets, 10 commits to home-assistant-polymer, 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")
@@ -302,7 +297,7 @@ This page contains a list of people who have contributed in one way or another t
- [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")
- [Gert-Jan van de Streek (@keerts)](https://github.com/keerts "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [Gianluca Barbaro (@MrMep)](https://github.com/MrMep "20 total commits to the home-assistant organization, 14 commits to home-assistant, 6 commits to home-assistant.github.io")
+- [Gianluca Barbaro (@MrMep)](https://github.com/MrMep "24 total commits to the home-assistant organization, 16 commits to home-assistant, 8 commits to home-assistant.github.io")
- [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")
- [Gianpaolo Macario (@gmacario)](https://github.com/gmacario "2 total commits to the home-assistant organization, 2 commits 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.github.io, 2 commits to home-assistant")
@@ -314,7 +309,7 @@ This page contains a list of people who have contributed in one way or another t
- [Graeme Smith (@Instagraeme)](https://github.com/Instagraeme "2 total commits to the home-assistant organization, 2 commits 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 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [Greg Dowling (@pavoni)](https://github.com/pavoni "238 total commits to the home-assistant organization, 211 commits to home-assistant, 25 commits to home-assistant.github.io, 2 commits to netdisco")
+- [Greg Dowling (@pavoni)](https://github.com/pavoni "239 total commits to the home-assistant organization, 212 commits to home-assistant, 25 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")
@@ -324,12 +319,12 @@ 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 "83 total commits to the home-assistant organization, 65 commits to home-assistant, 17 commits to home-assistant.github.io, 1 commit to home-assistant-polymer")
+- [happyleavesaoc (@happyleavesaoc)](https://github.com/happyleavesaoc "88 total commits to the home-assistant organization, 68 commits to home-assistant, 19 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")
- [Harry Kantas (@harrykantas)](https://github.com/harrykantas "1 total commits to the home-assistant organization, 1 commit to home-assistant")
-- [hawk259 (@hawk259)](https://github.com/hawk259 "5 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [hawk259 (@hawk259)](https://github.com/hawk259 "6 total commits to the home-assistant organization, 3 commits to home-assistant, 3 commits to home-assistant.github.io")
- [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 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
- [Heath Paddock (@heathbar)](https://github.com/heathbar "6 total commits to the home-assistant organization, 6 commits to home-assistant")
@@ -337,6 +332,7 @@ This page contains a list of people who have contributed in one way or another t
- [Hellowlol (@Hellowlol)](https://github.com/Hellowlol "3 total commits to the home-assistant organization, 3 commits to netdisco")
- [Helmut Januschka (@hjanuschka)](https://github.com/hjanuschka "3 total commits to the home-assistant organization, 3 commits to issue-bot")
- [Henning Dickten (@hensing)](https://github.com/hensing "2 total commits to the home-assistant organization, 2 commits to home-assistant")
+- [Henrik Nicolaisen (@hmn)](https://github.com/hmn "2 total commits to the home-assistant organization, 2 commits to home-assistant")
- [Hermann Kraus (@herm)](https://github.com/herm "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
- [Hernán R (@hmronline)](https://github.com/hmronline "2 total commits to the home-assistant organization, 2 commits to home-assistant")
- [hexa- (@mweinelt)](https://github.com/mweinelt "17 total commits to the home-assistant organization, 10 commits to home-assistant, 7 commits to home-assistant.github.io")
@@ -378,14 +374,11 @@ This page contains a list of people who have contributed in one way or another t
- [Jared J. (@jjensn)](https://github.com/jjensn "2 total commits to the home-assistant organization, 1 commit to netdisco, 1 commit to home-assistant")
- [Jason Carter (@JasonCarter80)](https://github.com/JasonCarter80 "6 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 3 commits to home-assistant")
- [Jason Hite (@jasonmhite)](https://github.com/jasonmhite "6 total commits to the home-assistant organization, 6 commits to appdaemon")
-- [Jason Schollenberger (@jschollenberger)](https://github.com/jschollenberger "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Jason Woodward (@woodwardjd)](https://github.com/woodwardjd "1 total commits to the home-assistant organization, 1 commit to home-assistant.github.io")
-- [Javier González Calleja (@gonzalezcalleja)](https://github.com/gonzalezcalleja "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to home-assistant.github.io")
-- [Jay Love (@jslove)](https://github.com/jslove "2 total commits to the home-assistant organization, 1 commit to home-assistant, 1 commit to home-assistant.github.io")
+- [Javier González Calleja (@gonzalezcalleja)](https://github.com/gonzalezcalleja "2 total commits to the home-assistant organization, 2 commits to home-assistant")
+- [Jay Love (@jslove)](https://github.com/jslove "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [Jean Regisser (@jeanregisser)](https://github.com/jeanregisser "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [Jean-Michel Julien (@KurdyMalloy)](https://github.com/KurdyMalloy "1 total commits to the home-assistant organization, 1 commit to libcoap")
-- [Jean-Philippe Bouillot (@Jypy)](https://github.com/Jypy "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")
+- [Jean-Philippe Bouillot (@Jypy)](https://github.com/Jypy "2 total commits to the home-assistant organization, 2 commits to home-assistant")
- [Jeff Schroeder (@SEJeff)](https://github.com/SEJeff "17 total commits to the home-assistant organization, 17 commits to home-assistant")
- [Jeff Wilson (@jawilson)](https://github.com/jawilson "15 total commits to the home-assistant organization, 13 commits to home-assistant, 2 commits to home-assistant.github.io")
- [Jeffrey Lin (@linjef)](https://github.com/linjef "2 total commits to the home-assistant organization, 2 commits to home-assistant")
@@ -400,6 +393,7 @@ This page contains a list of people who have contributed in one way or another t
- [jgriff2 (@jgriff2)](https://github.com/jgriff2 "2 total commits to the home-assistant organization, 2 commits to home-assistant")
- [Jim Rollenhagen (@jimrollenhagen)](https://github.com/jimrollenhagen "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
- [jnimmo (@jnimmo)](https://github.com/jnimmo "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Joakim af Sandeberg (@jotunacorn)](https://github.com/jotunacorn "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [Joakim Nohlgård (@gebart)](https://github.com/gebart "2 total commits to the home-assistant organization, 2 commits to libcoap")
- [Job Vermeulen (@jmvermeulen)](https://github.com/jmvermeulen "2 total commits to the home-assistant organization, 2 commits to home-assistant")
- [Joe Lee (@xnoodle)](https://github.com/xnoodle "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
@@ -408,15 +402,16 @@ This page contains a list of people who have contributed in one way or another t
- [Joeboyc2 (@Joeboyc2)](https://github.com/Joeboyc2 "12 total commits to the home-assistant organization, 11 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")
- [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 "31 total commits to the home-assistant organization, 25 commits to home-assistant, 5 commits to home-assistant.github.io, 1 commit to netdisco")
+- [Johan Bloemberg (@aequitas)](https://github.com/aequitas "32 total commits to the home-assistant organization, 26 commits to home-assistant, 5 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")
- [Johann Kellerman (@kellerza)](https://github.com/kellerza "144 total commits to the home-assistant organization, 114 commits to home-assistant, 30 commits to home-assistant.github.io")
- [Johannes K. (@roadrash2108)](https://github.com/roadrash2108 "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
-- [John Arild Berentsen (@turbokongen)](https://github.com/turbokongen "164 total commits to the home-assistant organization, 132 commits to home-assistant, 26 commits to home-assistant.github.io, 6 commits to home-assistant-polymer")
+- [John Arild Berentsen (@turbokongen)](https://github.com/turbokongen "166 total commits to the home-assistant organization, 133 commits to home-assistant, 27 commits to home-assistant.github.io, 6 commits to home-assistant-polymer")
+- [John Coggeshall (@coogle)](https://github.com/coogle "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
- [John Lindley (@jwl17330536)](https://github.com/jwl17330536 "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 "28 total commits to the home-assistant organization, 18 commits to home-assistant, 9 commits to home-assistant.github.io, 1 commit to hadashboard")
+- [John Mihalic (@mezz64)](https://github.com/mezz64 "29 total commits to the home-assistant organization, 19 commits to home-assistant, 9 commits to home-assistant.github.io, 1 commit to hadashboard")
- [John Williams (@Jaidan)](https://github.com/Jaidan "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [johnappletree (@johnappletree)](https://github.com/johnappletree "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
- [Jon (@JonMurphy)](https://github.com/JonMurphy "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
@@ -424,7 +419,7 @@ This page contains a list of people who have contributed in one way or another t
- [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 "102 total commits to the home-assistant organization, 78 commits to home-assistant, 16 commits to homebridge-homeassistant, 8 commits to home-assistant.github.io")
- [Jonatan Castro (@jcastro)](https://github.com/jcastro "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
-- [Jonathan Baginski (@patchedsoul)](https://github.com/patchedsoul "113 total commits to the home-assistant organization, 86 commits to fabric-home-assistant, 27 commits to home-assistant.github.io")
+- [Jonathan Baginski (@patchedsoul)](https://github.com/patchedsoul "114 total commits to the home-assistant organization, 86 commits to fabric-home-assistant, 28 commits 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 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [Jose Juan Montes (@jjmontesl)](https://github.com/jjmontesl "7 total commits to the home-assistant organization, 5 commits to home-assistant, 2 commits to home-assistant.github.io")
@@ -462,7 +457,7 @@ This page contains a list of people who have contributed in one way or another t
- [Keyasha Brothern (@KMBrothern)](https://github.com/KMBrothern "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
- [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, 2 commits to home-assistant")
+- [Klaas Hoekema (@KlaasH)](https://github.com/KlaasH "5 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io")
- [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 "2 total commits to the home-assistant organization, 1 commit to netdisco, 1 commit to home-assistant")
- [Kyle Gordon (@kylegordon)](https://github.com/kylegordon "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
@@ -483,6 +478,7 @@ This page contains a list of people who have contributed in one way or another t
- [Lukas (@lukas-hetzenecker)](https://github.com/lukas-hetzenecker "14 total commits to the home-assistant organization, 10 commits to home-assistant, 4 commits to home-assistant.github.io")
- [Luke Armstrong (@lukearmstrong)](https://github.com/lukearmstrong "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
- [Lupin Demid (@lupin-de-mid)](https://github.com/lupin-de-mid "4 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 2 commits to home-assistant")
+- [LvivEchoes (@LvivEchoes)](https://github.com/LvivEchoes "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [m4tek (@m4tek)](https://github.com/m4tek "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
- [Maciej Wasilak (@mwasilak)](https://github.com/mwasilak "1 total commits to the home-assistant organization, 1 commit to libcoap")
- [Magas (@magas0)](https://github.com/magas0 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
@@ -498,7 +494,7 @@ This page contains a list of people who have contributed in one way or another t
- [Marc Pabst (@mxtra)](https://github.com/mxtra "2 total commits to the home-assistant organization, 1 commit to home-assistant-polymer, 1 commit to home-assistant")
- [Marc Plano-Lesay (@Kernald)](https://github.com/Kernald "9 total commits to the home-assistant organization, 9 commits 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 "92 total commits to the home-assistant organization, 49 commits to home-assistant, 43 commits to home-assistant.github.io")
+- [Marcelo Moreira de Mello (@tchellomello)](https://github.com/tchellomello "93 total commits to the home-assistant organization, 50 commits to home-assistant, 43 commits to home-assistant.github.io")
- [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")
@@ -510,18 +506,19 @@ This page contains a list of people who have contributed in one way or another t
- [Markus Peter (@bimbar)](https://github.com/bimbar "5 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io")
- [Markus Stenberg (@fingon)](https://github.com/fingon "6 total commits to the home-assistant organization, 6 commits to home-assistant")
- [Martin Bernstorff (@ryqiem)](https://github.com/ryqiem "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [Martin Hjelmare (@MartinHjelmare)](https://github.com/MartinHjelmare "115 total commits to the home-assistant organization, 90 commits to home-assistant, 25 commits to home-assistant.github.io")
+- [Martin Hjelmare (@MartinHjelmare)](https://github.com/MartinHjelmare "118 total commits to the home-assistant organization, 93 commits to home-assistant, 25 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 Nöhrer (@matrixx567)](https://github.com/matrixx567 "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 Vacula (@MatoKafkac)](https://github.com/MatoKafkac "2 total commits to the home-assistant organization, 2 commits to home-assistant")
- [martinfrancois (@martinfrancois)](https://github.com/martinfrancois "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Martokk (@martokk)](https://github.com/martokk "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
- [Mathew Peterson (@mathewpeterson)](https://github.com/mathewpeterson "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
- [Matt N. (@mnoorenberghe)](https://github.com/mnoorenberghe "22 total commits to the home-assistant organization, 15 commits to home-assistant.github.io, 6 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 "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io")
- [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")
-- [Matthew Garrett (@mjg59)](https://github.com/mjg59 "8 total commits to the home-assistant organization, 5 commits to home-assistant, 3 commits to home-assistant.github.io")
+- [Matthew Garrett (@mjg59)](https://github.com/mjg59 "9 total commits to the home-assistant organization, 6 commits to home-assistant, 3 commits to home-assistant.github.io")
- [Matthew Treinish (@mtreinish)](https://github.com/mtreinish "12 total commits to the home-assistant organization, 8 commits to home-assistant, 4 commits to home-assistant.github.io")
- [Matthias Grawinkel (@meatz)](https://github.com/meatz "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [Max Rumpf (@Maxr1998)](https://github.com/Maxr1998 "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
@@ -536,7 +533,7 @@ This page contains a list of people who have contributed in one way or another t
- [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")
-- [Michaël Arnauts (@michaelarnauts)](https://github.com/michaelarnauts "48 total commits to the home-assistant organization, 24 commits to home-assistant, 20 commits to home-assistant.github.io, 3 commits to home-assistant-polymer, 1 commit to netdisco")
+- [Michaël Arnauts (@michaelarnauts)](https://github.com/michaelarnauts "49 total commits to the home-assistant organization, 24 commits to home-assistant, 21 commits to home-assistant.github.io, 3 commits to home-assistant-polymer, 1 commit to netdisco")
- [Michel Settembrino (@MS-Informatique)](https://github.com/MS-Informatique "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
- [micw (@micw)](https://github.com/micw "6 total commits to the home-assistant organization, 4 commits to home-assistant, 2 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")
@@ -548,10 +545,10 @@ This page contains a list of people who have contributed in one way or another t
- [MinchinWeb (@MinchinWeb)](https://github.com/MinchinWeb "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
- [miniconfig (@miniconfig)](https://github.com/miniconfig "27 total commits to the home-assistant organization, 20 commits to home-assistant, 7 commits to home-assistant.github.io")
- [Minims (@Minims)](https://github.com/Minims "3 total commits to the home-assistant organization, 3 commits to homebridge-homeassistant")
-- [Mitesh Patel (@gurumitts)](https://github.com/gurumitts "2 total commits to the home-assistant organization, 2 commits to home-assistant")
-- [Mitko Masarliev (@masarliev)](https://github.com/masarliev "1 total commits to the home-assistant organization, 1 commit to home-assistant")
+- [Mitesh Patel (@gurumitts)](https://github.com/gurumitts "5 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io")
+- [Mitko Masarliev (@masarliev)](https://github.com/masarliev "2 total commits to the home-assistant organization, 2 commits to home-assistant")
- [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")
-- [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 "6 total commits to the home-assistant organization, 6 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")
@@ -572,7 +569,7 @@ This page contains a list of people who have contributed in one way or another t
- [Nicolas Graziano (@ngraziano)](https://github.com/ngraziano "3 total commits to the home-assistant organization, 3 commits to home-assistant")
- [Nicolas Martignoni (@martignoni)](https://github.com/martignoni "1 total commits to the home-assistant organization, 1 commit to pi-gen")
- [Niklas (@niklaswa)](https://github.com/niklaswa "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
-- [Nikolas Beutler (@biacz)](https://github.com/biacz "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [Nikolas Beutler (@biacz)](https://github.com/biacz "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
- [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 "8 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 2 commits to homebridge-homeassistant")
@@ -583,17 +580,17 @@ This page contains a list of people who have contributed in one way or another t
- [obgm (@obgm)](https://github.com/obgm "480 total commits to the home-assistant organization, 480 commits to libcoap")
- [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")
- [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 "4 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 2 commits to home-assistant")
+- [Oleksii Serdiuk (@leppa)](https://github.com/leppa "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io")
- [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.github.io, 3 commits to home-assistant, 1 commit to netdisco")
+- [Oliver (@scarface-4711)](https://github.com/scarface-4711 "8 total commits to the home-assistant organization, 4 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 "22 total commits to the home-assistant organization, 18 commits to home-assistant, 4 commits 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 "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 "9 total commits to the home-assistant organization, 9 commits to home-assistant")
-- [Pascal Vizeli (@pvizeli)](https://github.com/pvizeli "439 total commits to the home-assistant organization, 345 commits to home-assistant, 92 commits to home-assistant.github.io, 1 commit to netdisco, 1 commit to home-assistant-js-websocket")
+- [Pascal Vizeli (@pvizeli)](https://github.com/pvizeli "445 total commits to the home-assistant organization, 351 commits to home-assistant, 92 commits to home-assistant.github.io, 1 commit to netdisco, 1 commit to home-assistant-js-websocket")
- [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 White (@pw)](https://github.com/pw "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
@@ -616,7 +613,7 @@ This page contains a list of people who have contributed in one way or another t
- [Philip Hofstetter (@pilif)](https://github.com/pilif "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io")
- [Philip Lundrigan (@philipbl)](https://github.com/philipbl "65 total commits to the home-assistant organization, 56 commits to home-assistant, 9 commits to home-assistant.github.io")
- [Philipp Schmitt (@pschmitt)](https://github.com/pschmitt "18 total commits to the home-assistant organization, 11 commits to home-assistant, 7 commits to home-assistant.github.io")
-- [Pierre Ståhl (@postlund)](https://github.com/postlund "22 total commits to the home-assistant organization, 15 commits to home-assistant, 4 commits to home-assistant.github.io, 3 commits to netdisco")
+- [Pierre Ståhl (@postlund)](https://github.com/postlund "26 total commits to the home-assistant organization, 18 commits to home-assistant, 4 commits to netdisco, 4 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")
- [PuckStar (@PuckStar)](https://github.com/PuckStar "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io")
@@ -637,7 +634,7 @@ This page contains a list of people who have contributed in one way or another t
- [Rob Capellini (@capellini)](https://github.com/capellini "3 total commits to the home-assistant organization, 3 commits to home-assistant")
- [Rob Johnson (@robjohnson189)](https://github.com/robjohnson189 "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [Rob Slifka (@rslifka)](https://github.com/rslifka "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io")
-- [Robbie Trencheny (@robbiet480)](https://github.com/robbiet480 "1083 total commits to the home-assistant organization, 455 commits to home-assistant-iOS, 242 commits to home-assistant, 238 commits to home-assistant.github.io, 71 commits to homebridge-homeassistant, 15 commits to home-assistant-polymer, 9 commits to hubot-home-assistant, 8 commits to Analytics-Receiver, 6 commits to netdisco, 3 commits to organization, 3 commits to hassbot, 3 commits to scenegen, 3 commits to home-assistant-js-websocket, 3 commits to home-assistant-js, 3 commits to hadashboard, 3 commits to home-assistant-cli, 3 commits to appdaemon, 2 commits to home-assistant-ansible, 2 commits to home-assistant-dev-helper, 2 commits to micropython-home-assistant, 2 commits to home-assistant-assets, 2 commits to fabric-home-assistant, 2 commits to home-assistant-notebooks, 2 commits to lambda-home-assistant-github, 1 commit to LabelBot")
+- [Robbie Trencheny (@robbiet480)](https://github.com/robbiet480 "1161 total commits to the home-assistant organization, 530 commits to home-assistant-iOS, 243 commits to home-assistant, 240 commits to home-assistant.github.io, 71 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 home-assistant-js, 3 commits to appdaemon, 3 commits to home-assistant-js-websocket, 3 commits to hadashboard, 3 commits to organization, 3 commits to hassbot, 3 commits to scenegen, 3 commits to home-assistant-cli, 2 commits to home-assistant-assets, 2 commits to home-assistant-notebooks, 2 commits to home-assistant-dev-helper, 2 commits to fabric-home-assistant, 2 commits to home-assistant-ansible, 2 commits to lambda-home-assistant-github, 2 commits to micropython-home-assistant, 1 commit to LabelBot")
- [Robby Grossman (@freerobby)](https://github.com/freerobby "2 total commits to the home-assistant organization, 2 commits to home-assistant")
- [Robin Laurén (@llauren)](https://github.com/llauren "1 total commits to the home-assistant organization, 1 commit to appdaemon")
- [Roddie Hasan (@eiddor)](https://github.com/eiddor "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io")
@@ -672,9 +669,9 @@ This page contains a list of people who have contributed in one way or another t
- [Scott Bradshaw (@swbradshaw)](https://github.com/swbradshaw "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [Scott Henning (@shenning00)](https://github.com/shenning00 "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 "7 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 1 commit to home-assistant-polymer, 1 commit to home-assistant")
+- [Scott Reston (@ih8gates)](https://github.com/ih8gates "8 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 1 commit to home-assistant-polymer, 1 commit to home-assistant")
- [scottocs11 (@scottocs11)](https://github.com/scottocs11 "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io")
-- [Sean Dague (@sdague)](https://github.com/sdague "50 total commits to the home-assistant organization, 34 commits to home-assistant, 7 commits to home-assistant.github.io, 5 commits to home-assistant-polymer, 3 commits to netdisco, 1 commit to home-assistant-js")
+- [Sean Dague (@sdague)](https://github.com/sdague "51 total commits to the home-assistant organization, 35 commits to home-assistant, 7 commits to home-assistant.github.io, 5 commits to home-assistant-polymer, 3 commits to netdisco, 1 commit to home-assistant-js")
- [Sebastian (@sebk-666)](https://github.com/sebk-666 "4 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 1 commit to home-assistant")
- [Sebastian (@sgso)](https://github.com/sgso "3 total commits to the home-assistant organization, 3 commits to libcoap")
- [Sebastian Hartnick (@goir)](https://github.com/goir "1 total commits to the home-assistant organization, 1 commit to home-assistant")
@@ -699,13 +696,13 @@ This page contains a list of people who have contributed in one way or another t
- [Stuart Mumford (@Cadair)](https://github.com/Cadair "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [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")
- [System Tester (@systemtester)](https://github.com/systemtester "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
-- [Sytone (@sytone)](https://github.com/sytone "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 "7 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 3 commits to home-assistant")
+- [Sytone (@sytone)](https://github.com/sytone "10 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 2 commits to home-assistant-cli, 2 commits to home-assistant")
+- [Sören Oldag (@soldag)](https://github.com/soldag "9 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 4 commits to home-assistant")
- [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 "26 total commits to the home-assistant organization, 18 commits to home-assistant, 7 commits to home-assistant.github.io, 1 commit to netdisco")
+- [Teemu R. (@rytilahti)](https://github.com/rytilahti "28 total commits to the home-assistant organization, 20 commits to home-assistant, 7 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")
@@ -720,6 +717,7 @@ This page contains a list of people who have contributed in one way or another t
- [Thomas Friedel (@tfriedel)](https://github.com/tfriedel "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [Thomas Petazzoni (@tpetazzoni)](https://github.com/tpetazzoni "1 total commits to the home-assistant organization, 1 commit to libcoap")
- [Thomas Pötsch (@thp-comnets)](https://github.com/thp-comnets "7 total commits to the home-assistant organization, 7 commits to libcoap")
+- [thrawnarn (@thrawnarn)](https://github.com/thrawnarn "1 total commits to the home-assistant organization, 1 commit to netdisco")
- [ThUnD3r|Gr33n (@thundergreen)](https://github.com/thundergreen "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
- [tijuca (@tijuca)](https://github.com/tijuca "106 total commits to the home-assistant organization, 106 commits to libcoap")
- [Tim (@tinglis1)](https://github.com/tinglis1 "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io")
@@ -738,7 +736,7 @@ This page contains a list of people who have contributed in one way or another t
- [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 "5 total commits to the home-assistant organization, 5 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")
+- [Trevor (@tboyce021)](https://github.com/tboyce021 "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")
- [Tyler Crumpton (@tylercrumpton)](https://github.com/tylercrumpton "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant")
@@ -746,6 +744,7 @@ This page contains a list of people who have contributed in one way or another t
- [Tõnis Tobre (@tobre6)](https://github.com/tobre6 "1 total commits to the home-assistant organization, 1 commit to homebridge-homeassistant")
- [Valentin Alexeev (@valentinalexeev)](https://github.com/valentinalexeev "11 total commits to the home-assistant organization, 8 commits to home-assistant, 3 commits to home-assistant.github.io")
- [Valentin VĂLCIU (@axiac)](https://github.com/axiac "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
+- [viswa-swami (@viswa-swami)](https://github.com/viswa-swami "2 total commits to the home-assistant organization, 2 commits to home-assistant")
- [Vittorio Monaco (@vittoriom)](https://github.com/vittoriom "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [Vlad Korniev (@vkorn)](https://github.com/vkorn "1 total commits to the home-assistant organization, 1 commit to home-assistant")
- [vllungu (@vllungu)](https://github.com/vllungu "3 total commits to the home-assistant organization, 3 commits to libcoap")
@@ -764,7 +763,7 @@ This page contains a list of people who have contributed in one way or another t
- [Wolf-Bastian Pöttner (@BastianPoe)](https://github.com/BastianPoe "6 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 3 commits to home-assistant")
- [Wolfgang Malgadey (@wmalgadey)](https://github.com/wmalgadey "2 total commits to the home-assistant organization, 2 commits 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 "20 total commits to the home-assistant organization, 20 commits to home-assistant")
+- [Xorso (@Xorso)](https://github.com/Xorso "21 total commits to the home-assistant organization, 21 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 Soliman (@yasinS)](https://github.com/yasinS "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
@@ -773,8 +772,9 @@ This page contains a list of people who have contributed in one way or another t
- [Zeb Palmer (@zebpalmer)](https://github.com/zebpalmer "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
- [Zen Tormey (@xehn)](https://github.com/xehn "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
- [Zhao Lu (@zlu)](https://github.com/zlu "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io")
+- [Zippit (@Zippit)](https://github.com/Zippit "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io")
This page is irregularly updated using the [`credits_generator` tool](https://github.com/home-assistant/home-assistant.github.io/tree/next/credits_generator). If you think that you are missing, please let us know.
-This page was last updated Tuesday, April 18th 2017, 9:17:50 pm UTC.
+This page was last updated Monday, April 24th 2017, 7:59:09 am UTC.
diff --git a/source/developers/development_guidelines.markdown b/source/developers/development_guidelines.markdown
new file mode 100644
index 00000000000..d1374badfb3
--- /dev/null
+++ b/source/developers/development_guidelines.markdown
@@ -0,0 +1,81 @@
+---
+layout: page
+title: "Style guidelines"
+description: "Details about styling your code."
+date: 2017-04-28 20:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+---
+
+Home Assistant enforces strict [PEP8 style](https://www.python.org/dev/peps/pep-0008/) and [PEP 257 (Docstring Conventions)](https://www.python.org/dev/peps/pep-0257/) compliance on all code submitted. We automatically test every pull request as part of the linting process with [Coveralls](https://coveralls.io/github/home-assistant/home-assistant) and [Travis CI](https://travis-ci.org/home-assistant/home-assistant).
+
+Summary of the most relevant points:
+
+- Line length is limited to 79 characters (see below).
+- Use 4 spaces per indentation level. We don't use tabs.
+- Comments should be full sentences and end with a period.
+- [Imports](https://www.python.org/dev/peps/pep-0008/#imports) should be ordered.
+- Constants and the content of lists and directories should be in alphabetical order.
+- Avoid trailing whitespace but surround binary operators with a single space.
+- Line separator should be set to `LF`.
+
+The maximum line length comes directly from the [PEP8 style guide](https://www.python.org/dev/peps/pep-0008/#maximum-line-length), and is also used by the Python standard library. All code must pass these linting checks, and no exceptions will be made. There have already been numerous requests to increase the maximum line length, but after evaluating the options, the Home Assistant maintainers have decided to stay at 79 characters. This decision is final.
+
+Those points may require that you adjust your IDE or editor settings.
+
+## {% linkable_title Our recommandations %}
+
+For some cases [PEPs](https://www.python.org/dev/peps/) don't make a statement. This section covers our recommandations about the code style. Those points were collected from the exisiting code and based on what contributors and developers were using the most. This is basically a majority decision, thus you may not agree with it. But we would like to encourage you follow those recommandations to keep the code unified.
+
+### {% linkable_title Quotes %}
+
+Use single quotes `'` for single word and `"` for multiple words or sentences.
+
+```python
+ATTR_WATERLEVEL = 'level'
+CONF_ATTRIBUTION = "Data provided by the WUnderground weather service"
+SENSOR_TYPES = {
+ 'alerts': ['Alerts', None],
+}
+```
+
+### {% linkable_title File headers %}
+
+The docstring in the file header should contain a link to the documentation to make it easy to find further information, especially about the configuration or details which are not mentioned in the code.
+
+```python
+"""
+Support for MQTT lights.
+
+For more details about this platform, please refer to the documentation at
+https://home-assistant.io/components/light.mqtt/
+"""
+```
+
+### {% linkable_title Requirements %}
+
+Please place [Platform requirements](/developers/code_review_platform/#1-requirements) right after the imports.
+
+```python
+[...]
+from homeassistant.helpers.entity import Entity
+
+REQUIREMENTS = ['xmltodict==0.11.0']
+```
+
+### {% linkable_title Log messages %}
+
+There is no need to add the platform or component name to the log messages. This will be added automatically. Like `syslog` messages there shouldn't be no period at the end. Try to avoid brackets and additional quotes around the output to make it easier for users to parse the log. A widely style is shown below but you are free to compose the messages as you like.
+
+```python
+_LOGGER.error("No route to device: %s", self._resource)
+```
+
+```bash
+2017-05-01 14:28:07 ERROR [homeassistant.components.sensor.arest] No route to device: 192.168.0.18
+```
+
+Don't print out wrong API keys, tokens, usernames, or passwords.
+
diff --git a/source/developers/development_testing.markdown b/source/developers/development_testing.markdown
index 3c95d94e7cb..a6805c82d6f 100644
--- a/source/developers/development_testing.markdown
+++ b/source/developers/development_testing.markdown
@@ -9,11 +9,11 @@ sharing: true
footer: true
---
-Home Assistant enforces strict [PEP8 style](https://www.python.org/dev/peps/pep-0008/) compliance on all code submitted. We automatically test every pull request with [Coveralls](https://coveralls.io/github/home-assistant/home-assistant) and [Travis CI](https://travis-ci.org/home-assistant/home-assistant).
+As states in the [Style guidelines section](/developers/development_guidelines/) all code is checked as part of the linting process and unit test were run.
### {% linkable_title Local testing %}
-**Important:** Run tox before you create your pull request to avoid annoying fixes. Local testing requires installing tox.
+**Important:** Run `tox` before you create your pull request to avoid annoying fixes. Local testing requires installing `tox`.
```bash
$ pip3 install tox
@@ -63,6 +63,3 @@ The `flake8-docstrings` extension will check docstrings according to [PEP257](ht
If you can't avoid a PyLint warning, add a comment to disable the PyLint check for that line with `# pylint: disable=YOUR-ERROR-NAME`. An example of an unavoidable PyLint warning is not using the passed-in datetime if you're listening for a time change.
-### {% linkable_title Maximum Line Length %}
-
-As part of the linting process, all code is checked for a maximum line length of 79 characters. This comes directly from the [PEP8 style guide](https://www.python.org/dev/peps/pep-0008/#maximum-line-length), and is also used by the Python standard library. All code must pass these linting checks, and no exceptions will be made. There have already been numerous requests to increase the maximum line length, but after evaluating the options, the Home Assistant maintainers have decided to stay at 79 characters. This decision is final.
diff --git a/source/developers/platform_example_light.markdown b/source/developers/platform_example_light.markdown
index a5092db30ca..8a11eec73f5 100644
--- a/source/developers/platform_example_light.markdown
+++ b/source/developers/platform_example_light.markdown
@@ -63,13 +63,14 @@ def setup_platform(hass, config, add_devices, discovery_info=None):
# Verify that passed in configuration works
if not hub.is_valid_login():
- _LOGGER.error('Could not connect to AwesomeLight hub')
+ _LOGGER.error("Could not connect to AwesomeLight hub")
return False
# Add devices
add_devices(AwesomeLight(light) for light in hub.lights())
+
class AwesomeLight(Light):
"""Representation of an Awesome Light."""
@@ -87,7 +88,7 @@ class AwesomeLight(Light):
@property
def brightness(self):
- """Brightness of the light (an integer in the range 1-255).
+ """Return the brightness of the light.
This method is optional. Removing it indicates to Home Assistant
that brightness is not supported for this light.
diff --git a/source/developers/platform_example_sensor.markdown b/source/developers/platform_example_sensor.markdown
index 94b84f0d374..166b3071178 100644
--- a/source/developers/platform_example_sensor.markdown
+++ b/source/developers/platform_example_sensor.markdown
@@ -15,7 +15,7 @@ This is a minimum implementation of a platform for the sensor component.
Copy the code below and create it as a file in `
+ Architecture overview of Hass.io
+