From be5a6ff8d8a5f999334c83dce4b12ab96867942a Mon Sep 17 00:00:00 2001
From: Paulus Schoutsen
+Depending on your setup, you might need to set a base URL (`base_url`) inside the [http component](/components/http/).
+
-If you are running Home Assistant over SSL or from within a container, you will have to setup a base URL (`base_url`) inside the [http component](/components/http/).
-
-
-
+ The recently released Raspberry Pi 3 model B+ is not yet supported.
+
+ The recently released Raspberry Pi 3 model B+ is not yet supported.
+
- The recently released Raspberry Pi 3 model B+ is not yet supported.
+ Support for the Raspberry Pi 3 model B+ is available in the alternative installation method [Hassbian](/docs/hassbian/installation/).
+
+ The recently released Raspberry Pi 3 model B+ is not yet supported by Hass.io
Currently, you must have Home Sharing enabled for this to work. Support for pairing Home Assistant with your device will be supported in a later release.
@@ -92,7 +92,7 @@ then device authentication is required. Press the icon in the upper left corner
A word of caution: The Arduino boards are not storing states. This means that with every initialization the pins are set to off/low.
diff --git a/source/_components/asterisk_mbox.markdown b/source/_components/asterisk_mbox.markdown
index d0d7ba72fe2..bfc30400f61 100644
--- a/source/_components/asterisk_mbox.markdown
+++ b/source/_components/asterisk_mbox.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Asterisk Voicemail"
-description: "Instructions how to integrate your existing Asterisk voicemail within Home Assistant."
+description: "Instructions on how to integrate your existing Asterisk voicemail within Home Assistant."
date: 2017-06-30 18:30
sidebar: true
comments: false
diff --git a/source/_components/automation.markdown b/source/_components/automation.markdown
index 181d28ba123..658c0ebc63c 100644
--- a/source/_components/automation.markdown
+++ b/source/_components/automation.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Automation"
-description: "Instructions how to setup automation within Home Assistant."
+description: "Instructions on how to setup automation within Home Assistant."
date: 2015-01-20 22:36
sidebar: true
comments: false
@@ -19,7 +19,7 @@ Starting with 0.28 your automation rules can be controlled with the frontend.
diff --git a/source/_components/image_processing.dlib_face_detect.markdown b/source/_components/image_processing.dlib_face_detect.markdown
index 6673146847d..f4275902565 100644
--- a/source/_components/image_processing.dlib_face_detect.markdown
+++ b/source/_components/image_processing.dlib_face_detect.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Dlib Face Detect"
-description: "Instructions how to integrate Dlib Face Detect into Home Assistant."
+description: "Instructions on how to integrate Dlib Face Detect into Home Assistant."
date: 2017-05-05 00:00
sidebar: true
comments: false
diff --git a/source/_components/image_processing.dlib_face_identify.markdown b/source/_components/image_processing.dlib_face_identify.markdown
index 4f3d267f534..5cac74b560f 100644
--- a/source/_components/image_processing.dlib_face_identify.markdown
+++ b/source/_components/image_processing.dlib_face_identify.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Dlib Face Identify"
-description: "Instructions how to integrate Dlib Face Identify into Home Assistant."
+description: "Instructions on how to integrate Dlib Face Identify into Home Assistant."
date: 2017-01-25 00:00
sidebar: true
comments: false
diff --git a/source/_components/image_processing.markdown b/source/_components/image_processing.markdown
index 6f010ebad29..1f1507bf280 100644
--- a/source/_components/image_processing.markdown
+++ b/source/_components/image_processing.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Image Processing"
-description: "Instructions how to setup image processing with Home Assistant."
+description: "Instructions on how to setup image processing with Home Assistant."
date: 2017-01-09 00:00
sidebar: true
comments: false
diff --git a/source/_components/image_processing.microsoft_face_detect.markdown b/source/_components/image_processing.microsoft_face_detect.markdown
index 39aecb15340..06cca72d260 100644
--- a/source/_components/image_processing.microsoft_face_detect.markdown
+++ b/source/_components/image_processing.microsoft_face_detect.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Microsoft Face Detect"
-description: "Instructions how to integrate Microsoft Face Detect into Home Assistant."
+description: "Instructions on how to integrate Microsoft Face Detect into Home Assistant."
date: 2017-01-25 00:00
sidebar: true
comments: false
diff --git a/source/_components/image_processing.microsoft_face_identify.markdown b/source/_components/image_processing.microsoft_face_identify.markdown
index 76fb2ad1be0..eb6d0a110fd 100644
--- a/source/_components/image_processing.microsoft_face_identify.markdown
+++ b/source/_components/image_processing.microsoft_face_identify.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Microsoft Face Identify"
-description: "Instructions how to integrate Microsoft Face Identify into Home Assistant."
+description: "Instructions on how to integrate Microsoft Face Identify into Home Assistant."
date: 2017-01-25 00:00
sidebar: true
comments: false
diff --git a/source/_components/image_processing.openalpr_cloud.markdown b/source/_components/image_processing.openalpr_cloud.markdown
index 3a13097c872..8829782ebd5 100644
--- a/source/_components/image_processing.openalpr_cloud.markdown
+++ b/source/_components/image_processing.openalpr_cloud.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "OpenALPR Cloud"
-description: "Instructions how to integrate licences plates with OpenALPR cloud into Home Assistant."
+description: "Instructions on how to integrate licences plates with OpenALPR cloud into Home Assistant."
date: 2017-01-09 00:00
sidebar: true
comments: false
diff --git a/source/_components/image_processing.openalpr_local.markdown b/source/_components/image_processing.openalpr_local.markdown
index 593a9212614..c8fe13152cc 100644
--- a/source/_components/image_processing.openalpr_local.markdown
+++ b/source/_components/image_processing.openalpr_local.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "OpenALPR Local"
-description: "Instructions how to integrate licences plates with OpenALPR local into Home Assistant."
+description: "Instructions on how to integrate licences plates with OpenALPR local into Home Assistant."
date: 2017-01-09 00:00
sidebar: true
comments: false
diff --git a/source/_components/image_processing.opencv.markdown b/source/_components/image_processing.opencv.markdown
index db6bfd2d5cb..9e485ec6c30 100644
--- a/source/_components/image_processing.opencv.markdown
+++ b/source/_components/image_processing.opencv.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "OpenCV"
-description: "Instructions how to integrate OpenCV image processing into Home Assistant."
+description: "Instructions on how to integrate OpenCV image processing into Home Assistant."
date: 2017-01-25 00:00
sidebar: true
comments: false
diff --git a/source/_components/image_processing.seven_segments.markdown b/source/_components/image_processing.seven_segments.markdown
index 13249bc52b1..a5944d821b5 100644
--- a/source/_components/image_processing.seven_segments.markdown
+++ b/source/_components/image_processing.seven_segments.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Seven segments display"
-description: "Instructions how to use OCR for seven segments displays into Home Assistant."
+description: "Instructions on how to use OCR for seven segments displays into Home Assistant."
date: 2017-05-18 08:00
sidebar: true
comments: false
diff --git a/source/_components/influxdb.markdown b/source/_components/influxdb.markdown
index 3f606caf030..b33bd30d886 100644
--- a/source/_components/influxdb.markdown
+++ b/source/_components/influxdb.markdown
@@ -27,7 +27,7 @@ You will still need to create a database named `home_assistant` via InfluxDB's c
Configuration variables:
-- **host** (*Optional*): IP address of your database host, e.g. 192.168.1.10. Defaults to `localhost`.
+- **host** (*Optional*): IP address of your database host, e.g., 192.168.1.10. Defaults to `localhost`.
- **port** (*Optional*): Port to use. Defaults to 8086.
- **username** (*Optional*): The username of the database user. The user needs read/write privileges on the database.
- **password** (*Optional*): The password for the database user account.
diff --git a/source/_components/input_boolean.markdown b/source/_components/input_boolean.markdown
index ff2aa46ca85..b2b23aeeff0 100644
--- a/source/_components/input_boolean.markdown
+++ b/source/_components/input_boolean.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Input Boolean"
-description: "Instructions how to integrate the Input Boolean component into Home Assistant."
+description: "Instructions on how to integrate the Input Boolean component into Home Assistant."
date: 2016-01-17 16:58
sidebar: true
comments: false
diff --git a/source/_components/input_datetime.markdown b/source/_components/input_datetime.markdown
index 19898029df3..462b309e7e7 100644
--- a/source/_components/input_datetime.markdown
+++ b/source/_components/input_datetime.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Input Datetime"
-description: "Instructions how to integrate the Input Datetime component into Home Assistant."
+description: "Instructions on how to integrate the Input Datetime component into Home Assistant."
date: 2017-09-14 16:01
sidebar: true
comments: false
diff --git a/source/_components/input_number.markdown b/source/_components/input_number.markdown
index 7afaaa255e0..44d819c39c5 100644
--- a/source/_components/input_number.markdown
+++ b/source/_components/input_number.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Input Number"
-description: "Instructions how to integrate the Input Number component into Home Assistant."
+description: "Instructions on how to integrate the Input Number component into Home Assistant."
date: 2017-09-19 03:30
sidebar: true
comments: false
diff --git a/source/_components/input_select.markdown b/source/_components/input_select.markdown
index bf25b89d5f7..8e59002ccfb 100644
--- a/source/_components/input_select.markdown
+++ b/source/_components/input_select.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Input Select"
-description: "Instructions how to integrate the Input Select component into Home Assistant."
+description: "Instructions on how to integrate the Input Select component into Home Assistant."
date: 2016-02-02 17:00
sidebar: true
comments: false
diff --git a/source/_components/input_text.markdown b/source/_components/input_text.markdown
index d0afd0ff097..284ab5ea361 100644
--- a/source/_components/input_text.markdown
+++ b/source/_components/input_text.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Input Text"
-description: "Instructions how to integrate the Input Text component into Home Assistant."
+description: "Instructions on how to integrate the Input Text component into Home Assistant."
date: 2016-03-15 06:00
sidebar: true
comments: false
diff --git a/source/_components/insteon_hub.markdown b/source/_components/insteon_hub.markdown
index 03bf4b8a6ec..5c9813bc5ca 100644
--- a/source/_components/insteon_hub.markdown
+++ b/source/_components/insteon_hub.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Insteon Hub"
-description: "Instructions how to setup the Insteon Hub within Home Assistant."
+description: "Instructions on how to setup the Insteon Hub within Home Assistant."
date: 2016-01-27 08:00
sidebar: true
comments: false
@@ -32,6 +32,6 @@ insteon_hub:
Configuration variables:
-- **username** (*Required*): The username used to access the Insteon interface (e.g. the [connect.insteon.com](http://connect.insteon.com/) site).
+- **username** (*Required*): The username used to access the Insteon interface (e.g., the [connect.insteon.com](http://connect.insteon.com/) site).
- **password** (*Required*): The password used to access the Insteon interface.
- **api_key** (*Required*): The Insteon REST API key emailed to you once you are approved in the Insteon Developer program.
diff --git a/source/_components/insteon_local.markdown b/source/_components/insteon_local.markdown
index fba10871713..40ed93c1d56 100644
--- a/source/_components/insteon_local.markdown
+++ b/source/_components/insteon_local.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Insteon (local)"
-description: "Instructions how to setup the Insteon Hub locally within Home Assistant."
+description: "Instructions on how to setup the Insteon Hub locally within Home Assistant."
date: 2016-12-18 08:00
sidebar: true
comments: false
diff --git a/source/_components/insteon_plm.markdown b/source/_components/insteon_plm.markdown
index e3fb65bcc97..58a1bad12cc 100644
--- a/source/_components/insteon_plm.markdown
+++ b/source/_components/insteon_plm.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Insteon PLM"
-description: "Instructions how to setup an Insteon USB PLM locally within Home Assistant."
+description: "Instructions on how to setup an Insteon USB PLM locally within Home Assistant."
date: 2017-02-19 16:00
sidebar: true
comments: false
@@ -39,7 +39,7 @@ insteon_plm:
product_key: PRODUCT_KEY
```
Configuration variables:
-- **port** (*Required*): The port for your device, e.g. `/dev/ttyUSB0`
+- **port** (*Required*): The port for your device, e.g., `/dev/ttyUSB0`
- **device_override** (*Optional*): Override the default device definition
- *ADDRESS* is found on the device itself in the form 1A.2B.3C or 1a2b3c
- *CATEGORY* is found in the back of the device's User Guide in the form of
@@ -80,7 +80,7 @@ disclaimers carefully, they are important.
The only configuration item that is absolutely necessary is the port so that
Home Assistant can connect to the PLM. This will expose all the supported INSTEON
devices which exist in the modem's ALL-Link database. However, devices will
-only be shown by their INSTEON hex address (e.g. "1A.2B.3C") which can be a bit
+only be shown by their INSTEON hex address (e.g., "1A.2B.3C") which can be a bit
unwieldy. As you link and unlink devices using the 'Set' buttons, they'll be
added and removed from Home Assistant automatically.
diff --git a/source/_components/isy994.markdown b/source/_components/isy994.markdown
index 558765a764b..ecf27168259 100644
--- a/source/_components/isy994.markdown
+++ b/source/_components/isy994.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "ISY994 Controller"
-description: "Instructions how to setup the ISY994 controller within Home Assistant."
+description: "Instructions on how to setup the ISY994 controller within Home Assistant."
date: 2015-01-20 22:36
sidebar: true
comments: false
diff --git a/source/_components/juicenet.markdown b/source/_components/juicenet.markdown
index 5015022c550..5df8b274e67 100644
--- a/source/_components/juicenet.markdown
+++ b/source/_components/juicenet.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Juicenet"
-description: "Instructions how to setup WiFi-equipped Juicenet charging stations with Home Assistant."
+description: "Instructions on how to setup WiFi-equipped Juicenet charging stations with Home Assistant."
date: 2017-05-20 22:00
sidebar: true
comments: false
diff --git a/source/_components/keyboard.markdown b/source/_components/keyboard.markdown
index 07b3e2db260..00dad71931c 100644
--- a/source/_components/keyboard.markdown
+++ b/source/_components/keyboard.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Keyboard"
-description: "Instructions how to simulate key presses with Home Assistant."
+description: "Instructions on how to simulate key presses with Home Assistant."
date: 2015-01-24 14:39
sidebar: true
comments: false
diff --git a/source/_components/keyboard_remote.markdown b/source/_components/keyboard_remote.markdown
index f1d80bfa973..aeefd01e63a 100644
--- a/source/_components/keyboard_remote.markdown
+++ b/source/_components/keyboard_remote.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Keyboard Remote"
-description: "Instructions how to use a keyboard to remote control Home Assistant."
+description: "Instructions on how to use a keyboard to remote control Home Assistant."
date: 2016-09-28 14:39
sidebar: true
comments: false
diff --git a/source/_components/kira.markdown b/source/_components/kira.markdown
index d2c2594834a..b32ae95eac1 100644
--- a/source/_components/kira.markdown
+++ b/source/_components/kira.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Kira"
-description: "Instructions how to integrate Keene Electronics IR over IP modules (Kira) into Home Assistant."
+description: "Instructions on how to integrate Keene Electronics IR over IP modules (Kira) into Home Assistant."
date: 2017-05-07 00:00
sidebar: true
comments: false
@@ -76,7 +76,7 @@ Configuration variables:
- **type** (*Optional*): The type of this code. If this field is omitted, the type will be autodetected if possible.
- **repeat** (*Optional*): The number of times to repeat this code (on transmit). Default is 1.
-Some manufacturers (e.g. Samsung) require an IR code to be sent a number of times in a row in rapid succession (usually 3). This doesn't apply to the vast majority of devices, but it can be helpful if needed.
+Some manufacturers (e.g., Samsung) require an IR code to be sent a number of times in a row in rapid succession (usually 3). This doesn't apply to the vast majority of devices, but it can be helpful if needed.
### {% linkable_title Code Types %}
diff --git a/source/_components/knx.markdown b/source/_components/knx.markdown
index ee731d020de..f27048d4e75 100644
--- a/source/_components/knx.markdown
+++ b/source/_components/knx.markdown
@@ -115,7 +115,7 @@ knx:
address: '0/0/23'
```
-* **type**: Type of the exposed value. Either time or datetime or any supported type of [KNX Sensor](/components/sensor.knx/) (e.g. "temperature" or "humidity").
+* **type**: Type of the exposed value. Either time or datetime or any supported type of [KNX Sensor](/components/sensor.knx/) (e.g., "temperature" or "humidity").
* **entity_id**: Entity id of the HASS component to be exposed. Not necessarry for types time and datetime.
* **address**: KNX group address.
diff --git a/source/_components/light.abode.markdown b/source/_components/light.abode.markdown
index bb6d597deef..f362107791d 100644
--- a/source/_components/light.abode.markdown
+++ b/source/_components/light.abode.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Abode Light"
-description: "Instructions how to integrate Abode lights into Home Assistant."
+description: "Instructions on how to integrate Abode lights into Home Assistant."
date: 2017-08-26 13:28
sidebar: true
comments: false
diff --git a/source/_components/light.ads.markdown b/source/_components/light.ads.markdown
index b5188cf33e8..aaedc1c12f4 100644
--- a/source/_components/light.ads.markdown
+++ b/source/_components/light.ads.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "ADS Light"
-description: Instructions how to set up ADS lights within Home Assistant
+description: Instructions on how to set up ADS lights within Home Assistant
date: 2017-10-25 10:00
sidebar: true
comments: false
diff --git a/source/_components/light.blinksticklight.markdown b/source/_components/light.blinksticklight.markdown
index 9deab2be84a..c11da280aca 100644
--- a/source/_components/light.blinksticklight.markdown
+++ b/source/_components/light.blinksticklight.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Blinkstick"
-description: "Instructions how to setup Blinkstick lights within Home Assistant."
+description: "Instructions on how to setup Blinkstick lights within Home Assistant."
date: 2015-10-08 10:00
sidebar: true
comments: false
diff --git a/source/_components/light.blinkt.markdown b/source/_components/light.blinkt.markdown
index 617e81cac21..ad2d6200f87 100644
--- a/source/_components/light.blinkt.markdown
+++ b/source/_components/light.blinkt.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Blinkt!"
-description: "Instructions how to setup Blinkt! RGB LED lights within Home Assistant."
+description: "Instructions on how to setup Blinkt! RGB LED lights within Home Assistant."
date: 2017-04-30 9:00
sidebar: true
comments: false
diff --git a/source/_components/light.flux_led.markdown b/source/_components/light.flux_led.markdown
index e74e6942d96..871ba222e28 100644
--- a/source/_components/light.flux_led.markdown
+++ b/source/_components/light.flux_led.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Flux Led/MagicLight"
-description: "Instructions how to setup Flux led/MagicLight within Home Assistant."
+description: "Instructions on how to setup Flux led/MagicLight within Home Assistant."
date: 2015-07-17 20:09
sidebar: true
comments: false
diff --git a/source/_components/light.greenwave.markdown b/source/_components/light.greenwave.markdown
index a0cba942d4c..16f8e160993 100644
--- a/source/_components/light.greenwave.markdown
+++ b/source/_components/light.greenwave.markdown
@@ -27,7 +27,7 @@ light:
host: XXX.XXX.XXX.XXX
version: 3
```
-The version option is the major revision of your firmware, which should be 2 or 3. If you are running Version 2, there are no extra steps. If you are running Version 3, you must press the Sync button on the gateway prior to the first launch of Home Assistant, so a token can be grabbed. Once home assistant has started, you can either press the Sync button again or wait for it to time out manually.
+The version option is the major revision of your firmware, which should be 2 or 3. If you are running Version 2, there are no extra steps. If you are running Version 3, you must press the Sync button on the gateway prior to the first launch of Home Assistant, so a token can be grabbed. Once Home Assistant has started, you can either press the Sync button again or wait for it to time out manually.
{% configuration %}
host:
diff --git a/source/_components/light.homematic.markdown b/source/_components/light.homematic.markdown
index b2223ae9e4c..86249ce98e0 100644
--- a/source/_components/light.homematic.markdown
+++ b/source/_components/light.homematic.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Homematic Light"
-description: "Instructions how to integrate Homematic lights within Home Assistant."
+description: "Instructions on how to integrate Homematic lights within Home Assistant."
date: 2016-06-28 08:30
sidebar: true
comments: false
diff --git a/source/_components/light.hue.markdown b/source/_components/light.hue.markdown
index 8cd9aad47ea..59e8b8e970e 100644
--- a/source/_components/light.hue.markdown
+++ b/source/_components/light.hue.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Philips Hue Light"
-description: "Instructions how to integrate Philips Hue lights into Home Assistant."
+description: "Instructions on how to integrate Philips Hue lights into Home Assistant."
date: 2015-03-23 20:09
sidebar: true
comments: false
diff --git a/source/_components/light.hyperion.markdown b/source/_components/light.hyperion.markdown
index 7f3b23ad6c3..7cba5e18f41 100644
--- a/source/_components/light.hyperion.markdown
+++ b/source/_components/light.hyperion.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Hyperion"
-description: "Instructions how to integrate Hyperion into Home Assistant."
+description: "Instructions on how to integrate Hyperion into Home Assistant."
date: 2015-10-25 22:43
sidebar: true
comments: false
diff --git a/source/_components/light.ihc.markdown b/source/_components/light.ihc.markdown
index 741d2168cd9..214f19564be 100644
--- a/source/_components/light.ihc.markdown
+++ b/source/_components/light.ihc.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "IHC Light"
-description: "Instructions how to integrate IHC lights within Home Assistant."
+description: "Instructions on how to integrate IHC lights within Home Assistant."
date: 2017-11-27 13:35
sidebar: true
comments: false
diff --git a/source/_components/light.insteon_hub.markdown b/source/_components/light.insteon_hub.markdown
index 82c4df9aa54..f581706b92c 100644
--- a/source/_components/light.insteon_hub.markdown
+++ b/source/_components/light.insteon_hub.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Insteon Hub Light"
-description: "Instructions how to setup the Insteon Hub Lights within Home Assistant."
+description: "Instructions on how to setup the Insteon Hub Lights within Home Assistant."
date: 2016-09-10 08:00
sidebar: true
comments: false
diff --git a/source/_components/light.insteon_local.markdown b/source/_components/light.insteon_local.markdown
index 06af902dfd7..b9aacb3250f 100644
--- a/source/_components/light.insteon_local.markdown
+++ b/source/_components/light.insteon_local.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Insteon (Local) Light"
-description: "Instructions how to setup the Insteon Hub Lights locally within Home Assistant."
+description: "Instructions on how to setup the Insteon Hub Lights locally within Home Assistant."
date: 2016-12-18 08:00
sidebar: true
comments: false
diff --git a/source/_components/light.insteon_plm.markdown b/source/_components/light.insteon_plm.markdown
index 04ab92bdee6..65026cf5761 100644
--- a/source/_components/light.insteon_plm.markdown
+++ b/source/_components/light.insteon_plm.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Insteon PLM Light"
-description: "Instructions how to setup Insteon PLM lights locally within Home Assistant."
+description: "Instructions on how to setup Insteon PLM lights locally within Home Assistant."
date: 2017-02-19 17:00
sidebar: true
comments: false
diff --git a/source/_components/light.isy994.markdown b/source/_components/light.isy994.markdown
index 8ae450edfcd..6c03413c8b0 100644
--- a/source/_components/light.isy994.markdown
+++ b/source/_components/light.isy994.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "ISY994 Light"
-description: "Instructions how to integrate ISY994 lights into Home Assistant."
+description: "Instructions on how to integrate ISY994 lights into Home Assistant."
date: 2016-09-03 23:00
sidebar: true
comments: false
diff --git a/source/_components/light.lifx.markdown b/source/_components/light.lifx.markdown
index 805cb67e680..04f444540fe 100644
--- a/source/_components/light.lifx.markdown
+++ b/source/_components/light.lifx.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "LIFX"
-description: "Instructions how to integrate LIFX into Home Assistant."
+description: "Instructions on how to integrate LIFX into Home Assistant."
date: 2016-01-27 08:00
sidebar: true
comments: false
diff --git a/source/_components/light.litejet.markdown b/source/_components/light.litejet.markdown
index d51cfd70c75..fedc9fa2bec 100644
--- a/source/_components/light.litejet.markdown
+++ b/source/_components/light.litejet.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "LiteJet Light"
-description: "Instructions how to setup the LiteJet lights within Home Assistant."
+description: "Instructions on how to setup the LiteJet lights within Home Assistant."
date: 2016-10-26 13:00
sidebar: true
comments: false
diff --git a/source/_components/light.lutron.markdown b/source/_components/light.lutron.markdown
index 3872b5373b5..9e380e8d7ce 100644
--- a/source/_components/light.lutron.markdown
+++ b/source/_components/light.lutron.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Lutron Light"
-description: "Instructions how to setup the Lutron lights within Home Assistant."
+description: "Instructions on how to setup the Lutron lights within Home Assistant."
date: 2017-04-30 09:00
sidebar: true
comments: false
diff --git a/source/_components/light.lutron_caseta.markdown b/source/_components/light.lutron_caseta.markdown
index 02e15710d62..4c61accdc60 100644
--- a/source/_components/light.lutron_caseta.markdown
+++ b/source/_components/light.lutron_caseta.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Lutron Caseta Light"
-description: "Instructions how to setup the Lutron Caseta lights within Home Assistant."
+description: "Instructions on how to setup the Lutron Caseta lights within Home Assistant."
date: 2017-04-30 09:00
sidebar: true
comments: false
diff --git a/source/_components/light.markdown b/source/_components/light.markdown
index 43706748906..54cd5adbc42 100644
--- a/source/_components/light.markdown
+++ b/source/_components/light.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Lights"
-description: "Instructions how to setup your lights with Home Assistant."
+description: "Instructions on how to setup your lights with Home Assistant."
date: 2015-01-24 14:39
sidebar: true
comments: false
diff --git a/source/_components/light.mochad.markdown b/source/_components/light.mochad.markdown
index 2902cb71be0..fdd288113f5 100644
--- a/source/_components/light.mochad.markdown
+++ b/source/_components/light.mochad.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Mochad Light"
-description: "Instructions how to integrate X10 Mochad lights into Home Assistant."
+description: "Instructions on how to integrate X10 Mochad lights into Home Assistant."
date: 2017-07-14 11:29
sidebar: true
comments: false
diff --git a/source/_components/light.mqtt.markdown b/source/_components/light.mqtt.markdown
index ec582bfb0fc..902255eeb45 100644
--- a/source/_components/light.mqtt.markdown
+++ b/source/_components/light.mqtt.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "MQTT Light"
-description: "Instructions how to setup MQTT lights within Home Assistant."
+description: "Instructions on how to setup MQTT lights within Home Assistant."
date: 2015-11-13 08:30
sidebar: true
comments: false
diff --git a/source/_components/light.mqtt_template.markdown b/source/_components/light.mqtt_template.markdown
index 5a13ea9dfb6..18388350174 100644
--- a/source/_components/light.mqtt_template.markdown
+++ b/source/_components/light.mqtt_template.markdown
@@ -140,7 +140,7 @@ In this section you find some real life examples of how to use this light.
### {% linkable_title Simple string payload %}
-For a simple string payload with the format `state,brightness,r-g-b` (e.g. `on,255,255-255-255`), add the following to your `configuration.yaml` file:
+For a simple string payload with the format `state,brightness,r-g-b` (e.g., `on,255,255-255-255`), add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
diff --git a/source/_components/light.mysensors.markdown b/source/_components/light.mysensors.markdown
index 4bf9a9d28a8..5f91aa43fe1 100644
--- a/source/_components/light.mysensors.markdown
+++ b/source/_components/light.mysensors.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "MySensors Light"
-description: "Instructions how to integrate MySensors lights into Home Assistant."
+description: "Instructions on how to integrate MySensors lights into Home Assistant."
date: 2016-10-01 15:00 +0200
sidebar: true
comments: false
diff --git a/source/_components/light.mystrom.markdown b/source/_components/light.mystrom.markdown
index f9ceacdb226..9cc2555fb16 100644
--- a/source/_components/light.mystrom.markdown
+++ b/source/_components/light.mystrom.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "myStrom WiFi Bulb"
-description: "Instructions how to integrate myStrom WiFi Bulbs into Home Assistant."
+description: "Instructions on how to integrate myStrom WiFi Bulbs into Home Assistant."
date: 2017-04-18 06:00
sidebar: true
comments: false
diff --git a/source/_components/light.osramlightify.markdown b/source/_components/light.osramlightify.markdown
index 86fa342c9b3..df1abeece99 100644
--- a/source/_components/light.osramlightify.markdown
+++ b/source/_components/light.osramlightify.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Osram Lightify"
-description: "Instructions how to integrate Osram Lightify into Home Assistant."
+description: "Instructions on how to integrate Osram Lightify into Home Assistant."
date: 2016-05-29 08:00
sidebar: true
comments: false
diff --git a/source/_components/light.piglow.markdown b/source/_components/light.piglow.markdown
index d261a816487..c2664af84cf 100644
--- a/source/_components/light.piglow.markdown
+++ b/source/_components/light.piglow.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Piglow"
-description: "Instructions how to setup Piglow LED's within Home Assistant."
+description: "Instructions on how to setup Piglow LED's within Home Assistant."
date: 2017-01-13 18:00
sidebar: true
comments: false
diff --git a/source/_components/light.qwikswitch.markdown b/source/_components/light.qwikswitch.markdown
index e1f600c98f3..13f61413f64 100644
--- a/source/_components/light.qwikswitch.markdown
+++ b/source/_components/light.qwikswitch.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "QwikSwitch Light"
-description: "Instructions how to integrate Qwikswitch dimmers and relays as lights into Home Assistant."
+description: "Instructions on how to integrate Qwikswitch dimmers and relays as lights into Home Assistant."
date: 2016-05-04 00:00
sidebar: true
comments: false
diff --git a/source/_components/light.rflink.markdown b/source/_components/light.rflink.markdown
index ebba128f88a..cc56e6de3ee 100644
--- a/source/_components/light.rflink.markdown
+++ b/source/_components/light.rflink.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "RFLink Light"
-description: "Instructions how to integrate RFLink lights into Home Assistant."
+description: "Instructions on how to integrate RFLink lights into Home Assistant."
date: 2016-01-04
sidebar: true
comments: false
diff --git a/source/_components/light.rfxtrx.markdown b/source/_components/light.rfxtrx.markdown
index ee5c513fe81..b6a1b707cf5 100644
--- a/source/_components/light.rfxtrx.markdown
+++ b/source/_components/light.rfxtrx.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "RFXtrx Light"
-description: "Instructions how to integrate RFXtrx lights into Home Assistant."
+description: "Instructions on how to integrate RFXtrx lights into Home Assistant."
date: 2015-10-08 10:15
sidebar: true
comments: false
diff --git a/source/_components/light.scsgate.markdown b/source/_components/light.scsgate.markdown
index 5625b43cfb3..07df0ca0f7e 100644
--- a/source/_components/light.scsgate.markdown
+++ b/source/_components/light.scsgate.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "SCSGate Light"
-description: "Instructions how to integrate SCSGate lights into Home Assistant."
+description: "Instructions on how to integrate SCSGate lights into Home Assistant."
date: 2016-01-31 19:30
sidebar: true
comments: false
diff --git a/source/_components/light.sensehat.markdown b/source/_components/light.sensehat.markdown
index b2bb9dbce5a..55e09b12194 100644
--- a/source/_components/light.sensehat.markdown
+++ b/source/_components/light.sensehat.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Sense HAT Light"
-description: "Instructions how to setup Sense HAT LED lights within Home Assistant."
+description: "Instructions on how to setup Sense HAT LED lights within Home Assistant."
date: 2017-04-29 16:00
sidebar: true
comments: false
diff --git a/source/_components/light.tellstick.markdown b/source/_components/light.tellstick.markdown
index a81d2384646..b4b71bc4e1b 100644
--- a/source/_components/light.tellstick.markdown
+++ b/source/_components/light.tellstick.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "TellStick Light"
-description: "Instructions how to integrate TellStick lights into Home Assistant."
+description: "Instructions on how to integrate TellStick lights into Home Assistant."
date: 2015-08-06 19:00
sidebar: true
comments: false
diff --git a/source/_components/light.template.markdown b/source/_components/light.template.markdown
index a9f1b834e48..9d1315b3106 100755
--- a/source/_components/light.template.markdown
+++ b/source/_components/light.template.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Template Light"
-description: "Instructions how to integrate Template Lights into Home Assistant."
+description: "Instructions on how to integrate Template Lights into Home Assistant."
date: 2016-05-18 20:32
sidebar: true
comments: false
diff --git a/source/_components/light.tplink.markdown b/source/_components/light.tplink.markdown
index 71fc4e97171..158504bcae0 100644
--- a/source/_components/light.tplink.markdown
+++ b/source/_components/light.tplink.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "TP-Link Bulb"
-description: "Instructions how to integrate TP-Link bulbs into Home Assistant."
+description: "Instructions on how to integrate TP-Link bulbs into Home Assistant."
date: 2017-07-25 08:00
sidebar: true
comments: false
diff --git a/source/_components/light.vera.markdown b/source/_components/light.vera.markdown
index da0fc42fff5..dba42ffcaf0 100644
--- a/source/_components/light.vera.markdown
+++ b/source/_components/light.vera.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Vera Light"
-description: "Instructions how to integrate Vera lights into Home Assistant."
+description: "Instructions on how to integrate Vera lights into Home Assistant."
date: 2015-10-20 21:00
sidebar: true
comments: false
diff --git a/source/_components/light.wemo.markdown b/source/_components/light.wemo.markdown
index df44818d044..1ae147ef864 100644
--- a/source/_components/light.wemo.markdown
+++ b/source/_components/light.wemo.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Belkin WeMo Lights"
-description: "Instructions how to integrate Belkin WeMo LED lights and WeMo Dimmer Switch into Home Assistant."
+description: "Instructions on how to integrate Belkin WeMo LED lights and WeMo Dimmer Switch into Home Assistant."
date: 2016-02-20 00:45
sidebar: true
comments: false
diff --git a/source/_components/light.wink.markdown b/source/_components/light.wink.markdown
index 5e7b74771ed..e537c116018 100644
--- a/source/_components/light.wink.markdown
+++ b/source/_components/light.wink.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Wink Light"
-description: "Instructions how to setup the Wink lights within Home Assistant."
+description: "Instructions on how to setup the Wink lights within Home Assistant."
date: 2015-01-20 22:36
sidebar: true
comments: false
diff --git a/source/_components/light.x10.markdown b/source/_components/light.x10.markdown
index b79a8814413..45df065a499 100644
--- a/source/_components/light.x10.markdown
+++ b/source/_components/light.x10.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "X10"
-description: "Instructions how to setup X10 devices within Home Assistant."
+description: "Instructions on how to setup X10 devices within Home Assistant."
date: 2016-07-27
sidebar: true
comments: false
diff --git a/source/_components/light.xiaomi_aqara.markdown b/source/_components/light.xiaomi_aqara.markdown
index 25e01ba22c7..48bf4fb1358 100644
--- a/source/_components/light.xiaomi_aqara.markdown
+++ b/source/_components/light.xiaomi_aqara.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Xiaomi Light"
-description: "Instructions how to setup the Xiaomi light within Home Assistant."
+description: "Instructions on how to setup the Xiaomi light within Home Assistant."
date: 2017-07-21 16:34
sidebar: true
comments: false
diff --git a/source/_components/light.xiaomi_miio.markdown b/source/_components/light.xiaomi_miio.markdown
index 3af241a04e9..fab4ca54013 100644
--- a/source/_components/light.xiaomi_miio.markdown
+++ b/source/_components/light.xiaomi_miio.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Xiaomi Philips Light"
-description: "Instructions how to integrate your Xiaomi Philips Lights within Home Assistant."
+description: "Instructions on how to integrate your Xiaomi Philips Lights within Home Assistant."
date: 2017-08-26 08:45
sidebar: true
comments: false
diff --git a/source/_components/light.yeelight.markdown b/source/_components/light.yeelight.markdown
index b098d007d59..8cd203eb4c0 100644
--- a/source/_components/light.yeelight.markdown
+++ b/source/_components/light.yeelight.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Yeelight Wifi Bulb"
-description: "Instructions how to setup Yeelight Wifi devices within Home Assistant."
+description: "Instructions on how to setup Yeelight Wifi devices within Home Assistant."
date: 2016-10-29
sidebar: true
comments: false
diff --git a/source/_components/light.yeelightsunflower.markdown b/source/_components/light.yeelightsunflower.markdown
index 1b0e441970d..0583084626c 100644
--- a/source/_components/light.yeelightsunflower.markdown
+++ b/source/_components/light.yeelightsunflower.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Yeelight Sunflower Bulb"
-description: "Instructions how to setup Yeelight Sunflower hub and bulbs within Home Assistant."
+description: "Instructions on how to setup Yeelight Sunflower hub and bulbs within Home Assistant."
date: 2017-02-11
sidebar: true
comments: false
diff --git a/source/_components/light.zengge.markdown b/source/_components/light.zengge.markdown
index ed15a92752a..b2f46b065d4 100644
--- a/source/_components/light.zengge.markdown
+++ b/source/_components/light.zengge.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Zengge"
-description: "Instructions how to integrate Zengge Bluetooth bulbs into Home Assistant."
+description: "Instructions on how to integrate Zengge Bluetooth bulbs into Home Assistant."
date: 2017-01-14 08:00
sidebar: true
comments: false
diff --git a/source/_components/light.zha.markdown b/source/_components/light.zha.markdown
index c3b0cc2d8b7..904c1e59de8 100644
--- a/source/_components/light.zha.markdown
+++ b/source/_components/light.zha.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "ZigBee Home Automation Light"
-description: "Instructions how to setup ZigBee Home Automation lights within Home Assistant."
+description: "Instructions on how to setup ZigBee Home Automation lights within Home Assistant."
date: 2017-02-22 00:00
sidebar: true
comments: false
diff --git a/source/_components/light.zwave.markdown b/source/_components/light.zwave.markdown
index 4053e61f1d3..891f63e8867 100644
--- a/source/_components/light.zwave.markdown
+++ b/source/_components/light.zwave.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Z-Wave Light"
-description: "Instructions how to setup the Z-Wave lights within Home Assistant."
+description: "Instructions on how to setup the Z-Wave lights within Home Assistant."
date: 2015-11-11 13:00
sidebar: true
comments: false
diff --git a/source/_components/lirc.markdown b/source/_components/lirc.markdown
index 6d379e04ca3..68782e6c23d 100644
--- a/source/_components/lirc.markdown
+++ b/source/_components/lirc.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "LIRC"
-description: "Instructions how to integrate IR remotes with LIRC into Home Assistant."
+description: "Instructions on how to integrate IR remotes with LIRC into Home Assistant."
date: 2016-05-22 19:59
sidebar: true
comments: false
@@ -39,7 +39,7 @@ For more information have a look at `/usr/share/doc/lirc/README.Debian.gz` where
### {% linkable_title Configuring LIRC %}
-Now teach LIRC about your particular remote control by preparing a lircd configuration file (`/etc/lirc/lircd.conf`). Search the [LIRC remote database](http://lirc.sourceforge.net/remotes/) for your model. If you can't find it, then you can always use the `irrecord` program to learn your remote. This will create a valid configuration file. Add as many remotes as you want by pasting them into the file. If `irrecord` doesn't work (e.g. for some air conditioner remotes), then the `mode2` program is capable of reading the codes in raw mode, followed by `irrecord -a` to extract hex codes.
+Now teach LIRC about your particular remote control by preparing a lircd configuration file (`/etc/lirc/lircd.conf`). Search the [LIRC remote database](http://lirc.sourceforge.net/remotes/) for your model. If you can't find it, then you can always use the `irrecord` program to learn your remote. This will create a valid configuration file. Add as many remotes as you want by pasting them into the file. If `irrecord` doesn't work (e.g., for some air conditioner remotes), then the `mode2` program is capable of reading the codes in raw mode, followed by `irrecord -a` to extract hex codes.
Next, you have to make a `~/.lircrc` file that maps keypresses to system actions. [The configuration](http://www.lirc.org/html/configure.html) is a bit tedious but it must be done. Use the `prog = home-assistant` for all keys you want to be recognized by Home Assistant. The values you set for `button` must be the same as in the `lircd.conf` file and the values you put for `config` entry will be the sensor value in Home Assistant when you press the button. An example may look like this:
@@ -98,4 +98,4 @@ automation:
entity_id: group.a_lights
```
-The `button_name` data values (e.g. `KEY_0`) are set by you in the `.lircrc` file.
+The `button_name` data values (e.g., `KEY_0`) are set by you in the `.lircrc` file.
diff --git a/source/_components/litejet.markdown b/source/_components/litejet.markdown
index 3770bb024be..fb334089530 100644
--- a/source/_components/litejet.markdown
+++ b/source/_components/litejet.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "LiteJet"
-description: "Instructions how to setup the LiteJet hub within Home Assistant."
+description: "Instructions on how to setup the LiteJet hub within Home Assistant."
date: 2015-10-26 09:37
sidebar: true
comments: false
diff --git a/source/_components/lock.abode.markdown b/source/_components/lock.abode.markdown
index c1e28603708..9dcc3cff907 100644
--- a/source/_components/lock.abode.markdown
+++ b/source/_components/lock.abode.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Abode Lock"
-description: "Instructions how to integrate Abode locks into Home Assistant."
+description: "Instructions on how to integrate Abode locks into Home Assistant."
date: 2017-08-26 13:28
sidebar: true
comments: false
diff --git a/source/_components/lock.isy994.markdown b/source/_components/lock.isy994.markdown
index 04109b9cd6e..b019662a68c 100644
--- a/source/_components/lock.isy994.markdown
+++ b/source/_components/lock.isy994.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "ISY994 Lock"
-description: "Instructions how to integrate ISY994 locks into Home Assistant."
+description: "Instructions on how to integrate ISY994 locks into Home Assistant."
date: 2016-09-03 23:00
sidebar: true
comments: false
diff --git a/source/_components/lock.lockitron.markdown b/source/_components/lock.lockitron.markdown
index 418881c1693..6b320e71086 100644
--- a/source/_components/lock.lockitron.markdown
+++ b/source/_components/lock.lockitron.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Lockitron Lock"
-description: "Instructions how to integrate Lockitron locks into Home Assistant."
+description: "Instructions on how to integrate Lockitron locks into Home Assistant."
date: 2017-03-24 00:00
sidebar: true
comments: false
diff --git a/source/_components/lock.markdown b/source/_components/lock.markdown
index c2c3cc55301..67d5b6509a1 100644
--- a/source/_components/lock.markdown
+++ b/source/_components/lock.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Locks"
-description: "Instructions how to setup your locks with Home Assistant."
+description: "Instructions on how to setup your locks with Home Assistant."
date: 2015-11-21 08:10
sidebar: true
comments: false
diff --git a/source/_components/lock.mqtt.markdown b/source/_components/lock.mqtt.markdown
index 8ed47ccf4ab..b0669cfb7f2 100644
--- a/source/_components/lock.mqtt.markdown
+++ b/source/_components/lock.mqtt.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "MQTT Lock"
-description: "Instructions how to integrate MQTT locks into Home Assistant."
+description: "Instructions on how to integrate MQTT locks into Home Assistant."
date: 2016-02-28 15:00
sidebar: true
comments: false
diff --git a/source/_components/lock.vera.markdown b/source/_components/lock.vera.markdown
index 8baf864dfd3..a3050389878 100644
--- a/source/_components/lock.vera.markdown
+++ b/source/_components/lock.vera.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Vera Lock"
-description: "Instructions how to integrate Vera locks into Home Assistant."
+description: "Instructions on how to integrate Vera locks into Home Assistant."
date: 2016-06-29 15:00
sidebar: true
comments: false
diff --git a/source/_components/lock.verisure.markdown b/source/_components/lock.verisure.markdown
index 2e726771795..e3c2d31e850 100644
--- a/source/_components/lock.verisure.markdown
+++ b/source/_components/lock.verisure.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Verisure Lock"
-description: "Instructions how to setup the Verisure locks within Home Assistant."
+description: "Instructions on how to setup the Verisure locks within Home Assistant."
date: 2016-02-12 06:00
sidebar: true
comments: false
diff --git a/source/_components/lock.wink.markdown b/source/_components/lock.wink.markdown
index 1f51751b3f4..a792e130a8b 100644
--- a/source/_components/lock.wink.markdown
+++ b/source/_components/lock.wink.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Wink Lock"
-description: "Instructions how to setup the Wink locks within Home Assistant."
+description: "Instructions on how to setup the Wink locks within Home Assistant."
date: 2015-11-20 12:00
sidebar: true
comments: false
diff --git a/source/_components/lock.zwave.markdown b/source/_components/lock.zwave.markdown
index e1d6fd7b33d..ba25eacd6c0 100644
--- a/source/_components/lock.zwave.markdown
+++ b/source/_components/lock.zwave.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Z-Wave Lock"
-description: "Instructions how to setup the Z-Wave Locks within Home Assistant."
+description: "Instructions on how to setup the Z-Wave Locks within Home Assistant."
date: 2016-05-07 08:00
sidebar: true
comments: false
diff --git a/source/_components/logbook.markdown b/source/_components/logbook.markdown
index d1a76f39739..438e7474306 100644
--- a/source/_components/logbook.markdown
+++ b/source/_components/logbook.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Logbook"
-description: "Instructions how to enable the logbook component for Home Assistant."
+description: "Instructions on how to enable the logbook component for Home Assistant."
date: 2015-04-25 9:23
sidebar: true
comments: false
@@ -11,7 +11,7 @@ logo: logbook.png
ha_category: "History"
---
-
-Script names (e.g. `message_temperature` in the example above) are not allowed to contain dash (minus) characters, i.e. `-`.
+Script names (e.g., `message_temperature` in the example above) are not allowed to contain dash (minus) characters, i.e. `-`.
The preferred way to separate words for better readability is to use underscore (`_`) characters.
+
From the Hass.io main panel open the add-on store.
+
From the Hass.io main panel open the add-on store.
-Select `apple_tv` as domain, `apple_tv_authenticate` as service and enter `{"entity_id": "XXX"}` into "Service Data", but replace XXX with the entity id of your device (e.g. `media_player.apple_tv`). Press the button and hopefully you are presented with an input dialog asking for a pin code:
+Select `apple_tv` as domain, `apple_tv_authenticate` as service and enter `{"entity_id": "XXX"}` into "Service Data", but replace XXX with the entity id of your device (e.g., `media_player.apple_tv`). Press the button and hopefully you are presented with an input dialog asking for a pin code:
@@ -143,4 +143,3 @@ To play media on an Apple TV with device authentication enabled (e.g., ATV4 with
### {% linkable_title Service `apple_tv_scan` %}
Scans the local network for Apple TVs. All found devices are presented as a persistent notification.
-
diff --git a/source/_components/arduino.markdown b/source/_components/arduino.markdown
index 5105f19c4cc..ca16dd32b75 100644
--- a/source/_components/arduino.markdown
+++ b/source/_components/arduino.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Arduino"
-description: "Instructions how to setup an Arduino boards within Home Assistant."
+description: "Instructions on how to setup an Arduino boards within Home Assistant."
date: 2015-06-27 10:28
sidebar: true
comments: false
@@ -43,7 +43,7 @@ The exact number can be determined with the command shown below.
$ ls /dev/ttyACM*
```
-If that's not working, check your `dmesg` or `journalctl -f` output. Keep in mind that Arduino clones are often using a different name for the port (e.g. `/dev/ttyUSB*`).
+If that's not working, check your `dmesg` or `journalctl -f` output. Keep in mind that Arduino clones are often using a different name for the port (e.g., `/dev/ttyUSB*`).
The logbook component provides a different perspective on the history of your house by showing all the changes that happened to your house in reverse chronological order. [See the demo for a live example](/demo/). It depends on the `recorder` component for storing the data. This means that if the [`recorder`](/components/recorder/) component is set up to use e.g. MySQL or PostgreSQL as data store, the `logbook` component does not use the default SQLite database to store data.
+
The logbook component provides a different perspective on the history of your house by showing all the changes that happened to your house in reverse chronological order. [See the demo for a live example](/demo/). It depends on the `recorder` component for storing the data. This means that if the [`recorder`](/components/recorder/) component is set up to use e.g., MySQL or PostgreSQL as data store, the `logbook` component does not use the default SQLite database to store data.
To enable the logbook in your installation, add the following to your `configuration.yaml` file:
diff --git a/source/_components/logger.markdown b/source/_components/logger.markdown
index 70168cf440b..2f89e090967 100644
--- a/source/_components/logger.markdown
+++ b/source/_components/logger.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Logger"
-description: "Instructions how to enable the logger component for Home Assistant."
+description: "Instructions on how to enable the logger component for Home Assistant."
date: 2015-11-12 17:00
sidebar: true
comments: false
diff --git a/source/_components/lutron.markdown b/source/_components/lutron.markdown
index c946160db1e..67bdb19dd91 100644
--- a/source/_components/lutron.markdown
+++ b/source/_components/lutron.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Lutron"
-description: "Instructions how to use Lutron devices with Home Assistant."
+description: "Instructions on how to use Lutron devices with Home Assistant."
date: 2017-01-28 13:00
sidebar: true
comments: false
diff --git a/source/_components/lutron_caseta.markdown b/source/_components/lutron_caseta.markdown
index 912bd82dc41..9783766c89d 100644
--- a/source/_components/lutron_caseta.markdown
+++ b/source/_components/lutron_caseta.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Lutron Caseta"
-description: "Instructions how to use Lutron Caseta devices with Home Assistant."
+description: "Instructions on how to use Lutron Caseta devices with Home Assistant."
date: 2017-01-28 13:00
sidebar: true
comments: false
@@ -25,7 +25,7 @@ The currently supported Caseta devices are:
- Scenes as Home Assistant [scenes](/components/scene.lutron_caseta/)
- Lutron shades as Home Assistant [covers](/components/cover.lutron_caseta/)
-When configured, the `lutron_caseta` component will automatically discover the currently supported devices as setup in the Lutron Smart Bridge. The name assigned in the Lutron mobile app will be used to form the `entity_id` used in Home Assistant. e.g. a dimmer called 'Bedroom Lamp' becomes `light.bedroom_lamp` in Home Assistant.
+When configured, the `lutron_caseta` component will automatically discover the currently supported devices as setup in the Lutron Smart Bridge. The name assigned in the Lutron mobile app will be used to form the `entity_id` used in Home Assistant. e.g., a dimmer called 'Bedroom Lamp' becomes `light.bedroom_lamp` in Home Assistant.
To use Lutron Caseta devices in your installation, you must first log in to your Lutron account and generate a certificate that allows Home Assistant to connect to your bridge. This can be accomplished by downloading and executing [this script](/assets/get_lutron_cert.zip), which will generate three files: caseta.key, caseta.crt, caseta-bridge.crt when you run it. See the instructions at the top of the script for more information.
diff --git a/source/_components/mailbox.asterisk_mbox.markdown b/source/_components/mailbox.asterisk_mbox.markdown
index 25a0859aa92..bc25b5b10b5 100644
--- a/source/_components/mailbox.asterisk_mbox.markdown
+++ b/source/_components/mailbox.asterisk_mbox.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Asterisk Voicemail Mailbox"
-description: "Instructions how to integrate an Asterisk Voicemail within Home Assistant."
+description: "Instructions on how to integrate an Asterisk Voicemail within Home Assistant."
date: 2017-06-30 18:30
sidebar: true
comments: false
diff --git a/source/_components/mailbox.markdown b/source/_components/mailbox.markdown
index 28f4d77f436..16bfa603b8d 100644
--- a/source/_components/mailbox.markdown
+++ b/source/_components/mailbox.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Mailbox"
-description: "Instructions how to setup your mailboxes with Home Assistant."
+description: "Instructions on how to setup your mailboxes with Home Assistant."
date: 2017-06-30 18:30
sidebar: true
comments: false
diff --git a/source/_components/mailgun.markdown b/source/_components/mailgun.markdown
index 78764d7507e..2f13d2c0625 100644
--- a/source/_components/mailgun.markdown
+++ b/source/_components/mailgun.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Mailgun"
-description: "Instructions how to add Mailgun mail notifications to Home Assistant."
+description: "Instructions on how to add Mailgun mail notifications to Home Assistant."
date: 2017-02-06 16:52
sidebar: true
comments: false
diff --git a/source/_components/media_extractor.markdown b/source/_components/media_extractor.markdown
index 114d70f3fe7..8386b0390a3 100644
--- a/source/_components/media_extractor.markdown
+++ b/source/_components/media_extractor.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Media Extractor"
-description: "Instructions how to integrate the Media Extractor into Home Assistant."
+description: "Instructions on how to integrate the Media Extractor into Home Assistant."
date: 2017-07-12 07:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.anthemav.markdown b/source/_components/media_player.anthemav.markdown
index 945fdc0c648..8e59296db99 100644
--- a/source/_components/media_player.anthemav.markdown
+++ b/source/_components/media_player.anthemav.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Anthem A/V Receivers"
-description: "Instructions how to integrate Anthem A/V Receivers into Home Assistant."
+description: "Instructions on how to integrate Anthem A/V Receivers into Home Assistant."
date: 2016-12-31 23:11
sidebar: true
comments: false
diff --git a/source/_components/media_player.apple_tv.markdown b/source/_components/media_player.apple_tv.markdown
index 383afdae981..7b163077602 100644
--- a/source/_components/media_player.apple_tv.markdown
+++ b/source/_components/media_player.apple_tv.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Apple TV Media Player"
-description: "Instructions how to integrate Apple TV devices into Home Assistant."
+description: "Instructions on how to integrate Apple TV devices into Home Assistant."
date: 2017-02-08 07:11
sidebar: true
comments: false
diff --git a/source/_components/media_player.bluesound.markdown b/source/_components/media_player.bluesound.markdown
index 999d2cd9298..69372c8c332 100644
--- a/source/_components/media_player.bluesound.markdown
+++ b/source/_components/media_player.bluesound.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Bluesound"
-description: "Instructions how to integrate Bluesound devices into Home Assistant."
+description: "Instructions on how to integrate Bluesound devices into Home Assistant."
date: 2017-04-21 19:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.cast.markdown b/source/_components/media_player.cast.markdown
index c97f391dab8..13d18534ba4 100644
--- a/source/_components/media_player.cast.markdown
+++ b/source/_components/media_player.cast.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Google Cast"
-description: "Instructions how to integrate Google Cast into Home Assistant."
+description: "Instructions on how to integrate Google Cast into Home Assistant."
date: 2015-03-23 19:59
sidebar: true
comments: false
diff --git a/source/_components/media_player.clementine.markdown b/source/_components/media_player.clementine.markdown
index c730daf5d96..781ac147a56 100644
--- a/source/_components/media_player.clementine.markdown
+++ b/source/_components/media_player.clementine.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Clementine Music Player"
-description: "Instructions how to integrate Clementine Music Player within Home Assistant."
+description: "Instructions on how to integrate Clementine Music Player within Home Assistant."
date: 2017-02-11 17:15
sidebar: true
comments: false
diff --git a/source/_components/media_player.cmus.markdown b/source/_components/media_player.cmus.markdown
index e798889686c..6754b57c874 100644
--- a/source/_components/media_player.cmus.markdown
+++ b/source/_components/media_player.cmus.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "cmus"
-description: "Instructions how to integrate cmus Music Player into Home
+description: "Instructions on how to integrate cmus Music Player into Home
Assistant."
date: 2016-06-17 18:45
sidebar: true
diff --git a/source/_components/media_player.denon.markdown b/source/_components/media_player.denon.markdown
index b8c0e380133..ebfe0177bae 100644
--- a/source/_components/media_player.denon.markdown
+++ b/source/_components/media_player.denon.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Denon Network Receivers"
-description: "Instructions how to integrate Denon Network Receivers into Home Assistant."
+description: "Instructions on how to integrate Denon Network Receivers into Home Assistant."
date: 2015-09-08 09:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.denonavr.markdown b/source/_components/media_player.denonavr.markdown
index 31ad2b01604..ee1c434ff4b 100644
--- a/source/_components/media_player.denonavr.markdown
+++ b/source/_components/media_player.denonavr.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Denon AVR Network Receivers"
-description: "Instructions how to integrate Denon AVR Network Receivers into Home Assistant."
+description: "Instructions on how to integrate Denon AVR Network Receivers into Home Assistant."
date: 2015-09-08 09:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.directv.markdown b/source/_components/media_player.directv.markdown
index 2cd2c7f44dd..f7f6559619e 100644
--- a/source/_components/media_player.directv.markdown
+++ b/source/_components/media_player.directv.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "DirecTV"
-description: "Instructions how to integrate DirecTV receivers into Home Assistant."
+description: "Instructions on how to integrate DirecTV receivers into Home Assistant."
date: 2016-07-19 01:0+0000
sidebar: true
comments: false
diff --git a/source/_components/media_player.dunehd.markdown b/source/_components/media_player.dunehd.markdown
index 76c084bcf48..bbf646f0fb9 100644
--- a/source/_components/media_player.dunehd.markdown
+++ b/source/_components/media_player.dunehd.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "DuneHD media players"
-description: "Instructions how to integrate DuneHD media players into Home Assistant."
+description: "Instructions on how to integrate DuneHD media players into Home Assistant."
date: 2016-11-26 09:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.emby.markdown b/source/_components/media_player.emby.markdown
index ca77cbde1a3..2f12bc1d808 100644
--- a/source/_components/media_player.emby.markdown
+++ b/source/_components/media_player.emby.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Emby"
-description: "Instructions how to integrate Emby into Home Assistant."
+description: "Instructions on how to integrate Emby into Home Assistant."
date: 2016-10-13 22:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.firetv.markdown b/source/_components/media_player.firetv.markdown
index 855333def81..96d9c48c0e8 100644
--- a/source/_components/media_player.firetv.markdown
+++ b/source/_components/media_player.firetv.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "FireTV"
-description: "Instructions how to integrate Fire-TV into Home Assistant."
+description: "Instructions on how to integrate Fire-TV into Home Assistant."
date: 2015-10-23 18:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.frontier_silicon.markdown b/source/_components/media_player.frontier_silicon.markdown
index 0c6a5843fa9..c7887e9c8b7 100644
--- a/source/_components/media_player.frontier_silicon.markdown
+++ b/source/_components/media_player.frontier_silicon.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Frontier Silicon Internet Radios"
-description: "Instructions how to integrate Frontier Silicon Internet Radios into Home Assistant."
+description: "Instructions on how to integrate Frontier Silicon Internet Radios into Home Assistant."
date: 2017-02-04 00:01
sidebar: true
comments: false
diff --git a/source/_components/media_player.gpmdp.markdown b/source/_components/media_player.gpmdp.markdown
index 7207e0e0924..c65ed0dff0f 100644
--- a/source/_components/media_player.gpmdp.markdown
+++ b/source/_components/media_player.gpmdp.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Google Play Music Desktop Player"
-description: "Instructions how to integrate GPMDP into Home Assistant."
+description: "Instructions on how to integrate GPMDP into Home Assistant."
date: 2016-05-09 08:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.itunes.markdown b/source/_components/media_player.itunes.markdown
index fd357eb8ec7..6885a333855 100644
--- a/source/_components/media_player.itunes.markdown
+++ b/source/_components/media_player.itunes.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "iTunes"
-description: "Instructions how to integrate iTunes into Home Assistant."
+description: "Instructions on how to integrate iTunes into Home Assistant."
date: 2015-06-22 11:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.kodi.markdown b/source/_components/media_player.kodi.markdown
index 556812292c6..a59d19fe348 100644
--- a/source/_components/media_player.kodi.markdown
+++ b/source/_components/media_player.kodi.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Kodi"
-description: "Instructions how to integrate Kodi into Home Assistant."
+description: "Instructions on how to integrate Kodi into Home Assistant."
date: 2015-06-22 11:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.lg_netcast.markdown b/source/_components/media_player.lg_netcast.markdown
index 138eaec8bde..7a60e235781 100644
--- a/source/_components/media_player.lg_netcast.markdown
+++ b/source/_components/media_player.lg_netcast.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "LG Netcast TV"
-description: "Instructions how to integrate a LG TV (Netcast 3.0 & 4.0) within Home Assistant."
+description: "Instructions on how to integrate a LG TV (Netcast 3.0 & 4.0) within Home Assistant."
date: 2016-05-12 23:22
sidebar: true
comments: false
diff --git a/source/_components/media_player.markdown b/source/_components/media_player.markdown
index 90507d40e5d..dfbe48ccc99 100644
--- a/source/_components/media_player.markdown
+++ b/source/_components/media_player.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Media Player"
-description: "Instructions how to setup your media players with Home Assistant."
+description: "Instructions on how to setup your media players with Home Assistant."
date: 2015-01-24 14:39
sidebar: true
comments: false
diff --git a/source/_components/media_player.mediaroom.markdown b/source/_components/media_player.mediaroom.markdown
index a2eece639d9..47e79b74ba4 100644
--- a/source/_components/media_player.mediaroom.markdown
+++ b/source/_components/media_player.mediaroom.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Mediaroom"
-description: "Instructions how to integrate Mediaroom Set-Top Boxes into Home Assistant."
+description: "Instructions on how to integrate Mediaroom Set-Top Boxes into Home Assistant."
date: 2018-01-22 22:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.mpchc.markdown b/source/_components/media_player.mpchc.markdown
index 4e4c187d0f4..98f6846f3a1 100644
--- a/source/_components/media_player.mpchc.markdown
+++ b/source/_components/media_player.mpchc.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "MPC-HC"
-description: "Instructions how to integrate MPC-HC into Home Assistant."
+description: "Instructions on how to integrate MPC-HC into Home Assistant."
date: 2016-07-27 21:21
sidebar: true
comments: false
diff --git a/source/_components/media_player.mpd.markdown b/source/_components/media_player.mpd.markdown
index b561797aacb..51888be2b20 100644
--- a/source/_components/media_player.mpd.markdown
+++ b/source/_components/media_player.mpd.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Music Player Daemon (MPD)"
-description: "Instructions how to integrate Music Player Daemon into Home Assistant."
+description: "Instructions on how to integrate Music Player Daemon into Home Assistant."
date: 2016-09-30 23:06
sidebar: true
comments: false
diff --git a/source/_components/media_player.nad.markdown b/source/_components/media_player.nad.markdown
index b35a5ea99b1..41684f72129 100644
--- a/source/_components/media_player.nad.markdown
+++ b/source/_components/media_player.nad.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "NAD"
-description: "Instructions how to integrate NAD receivers into Home Assistant."
+description: "Instructions on how to integrate NAD receivers into Home Assistant."
date: 2016-01-05 20:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.nadtcp.markdown b/source/_components/media_player.nadtcp.markdown
index 98a160f76b9..e673e4472d8 100644
--- a/source/_components/media_player.nadtcp.markdown
+++ b/source/_components/media_player.nadtcp.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "NAD tcp"
-description: "Instructions how to integrate the NAD D 7050 or C338 digital amplifiers into Home Assistant."
+description: "Instructions on how to integrate the NAD D 7050 or C338 digital amplifiers into Home Assistant."
date: 2017-06-07 20:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.onkyo.markdown b/source/_components/media_player.onkyo.markdown
index e78075c01a5..ca277f77063 100644
--- a/source/_components/media_player.onkyo.markdown
+++ b/source/_components/media_player.onkyo.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Onkyo"
-description: "Instructions how to integrate Onkyo and some Pioneer receivers into Home Assistant."
+description: "Instructions on how to integrate Onkyo and some Pioneer receivers into Home Assistant."
date: 2016-03-30 08:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.openhome.markdown b/source/_components/media_player.openhome.markdown
index e1749688272..ae10d32d3c6 100644
--- a/source/_components/media_player.openhome.markdown
+++ b/source/_components/media_player.openhome.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Linn / Openhome"
-description: "Instructions how to integrate Linn Ds and Openhome renderers into Home Assistant."
+description: "Instructions on how to integrate Linn Ds and Openhome renderers into Home Assistant."
date: 2017-02-21 22:40
sidebar: true
comments: false
diff --git a/source/_components/media_player.panasonic_viera.markdown b/source/_components/media_player.panasonic_viera.markdown
index fbbe820c345..28778486017 100644
--- a/source/_components/media_player.panasonic_viera.markdown
+++ b/source/_components/media_player.panasonic_viera.markdown
@@ -44,9 +44,9 @@ media_player:
Configuration variables:
-- **host** (*Required*): The IP of the Panasonic Viera TV, e.g. `192.168.0.10`.
+- **host** (*Required*): The IP of the Panasonic Viera TV, e.g., `192.168.0.10`.
- **port** (*Optional*): The port number of your Panasonic Viera TV. Defaults to `55000`.
-- **mac** (*Optional*): The MAC address of your Panasonic Viera TV, e.g. `AA:BB:CC:DD:99:1A`.
+- **mac** (*Optional*): The MAC address of your Panasonic Viera TV, e.g., `AA:BB:CC:DD:99:1A`.
- **name** (*Optional*): The name you would like to give to the Panasonic Viera TV.
### {% linkable_title Example `play_media` script %}
diff --git a/source/_components/media_player.pandora.markdown b/source/_components/media_player.pandora.markdown
index 5f0098cff83..d9f7b999f42 100644
--- a/source/_components/media_player.pandora.markdown
+++ b/source/_components/media_player.pandora.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Pandora"
-description: "Instructions how to integrate Pandora radio into Home Assistant."
+description: "Instructions on how to integrate Pandora radio into Home Assistant."
date: 2016-06-10 19:59
sidebar: true
comments: false
diff --git a/source/_components/media_player.pioneer.markdown b/source/_components/media_player.pioneer.markdown
index 66086c5ded3..6bc6d1a5b00 100644
--- a/source/_components/media_player.pioneer.markdown
+++ b/source/_components/media_player.pioneer.markdown
@@ -29,7 +29,7 @@ Configuration variables:
- **host** (*Required*): The IP of the Pioneer device, eg. `192.168.0.10`
- **name** (*Optional*): The name you would like to give to the receiver.
-- **port** (*Optional*): The port on which the Pioneer device listens, e.g. `23` (default) or `8102`
+- **port** (*Optional*): The port on which the Pioneer device listens, e.g., `23` (default) or `8102`
- **timeout** (*Optional*): Number of seconds (float) to wait for blocking operations like connect, write, and read.
Notes:
diff --git a/source/_components/media_player.plex.markdown b/source/_components/media_player.plex.markdown
index ddaf3a611bf..45ad9698cb3 100644
--- a/source/_components/media_player.plex.markdown
+++ b/source/_components/media_player.plex.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Plex"
-description: "Instructions how to integrate Plex into Home Assistant."
+description: "Instructions on how to integrate Plex into Home Assistant."
date: 2015-10-05 21:21
sidebar: true
comments: false
diff --git a/source/_components/media_player.roku.markdown b/source/_components/media_player.roku.markdown
index 5c889727de3..c7771e0f406 100644
--- a/source/_components/media_player.roku.markdown
+++ b/source/_components/media_player.roku.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Roku"
-description: "Instructions how to integrate Roku into Home Assistant."
+description: "Instructions on how to integrate Roku into Home Assistant."
date: 2016-05-16 20:0+0000
sidebar: true
comments: false
diff --git a/source/_components/media_player.samsungtv.markdown b/source/_components/media_player.samsungtv.markdown
index 3cabb0f43d6..53954f66931 100644
--- a/source/_components/media_player.samsungtv.markdown
+++ b/source/_components/media_player.samsungtv.markdown
@@ -76,10 +76,10 @@ Currently tested but not working models:
- JS9500 - State is always "on" and unable to control (but port 8001 *is* open)
- MU6300 - Port set to 8001, `pip3 install websocket-client` must be executed, turning on works, status not working reliably, turning off is not permanent (it comes back on)
-None of the 2014 (H) and 2015 (J) model series (e.g. J5200) will work, since Samsung have used a different (encrypted) type of interface for these.
+None of the 2014 (H) and 2015 (J) model series (e.g., J5200) will work, since Samsung have used a different (encrypted) type of interface for these.
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.
+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.
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.
diff --git a/source/_components/media_player.songpal.markdown b/source/_components/media_player.songpal.markdown
index 65874f99b26..2e83636b9e7 100644
--- a/source/_components/media_player.songpal.markdown
+++ b/source/_components/media_player.songpal.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Sony SongPal compatible devices"
-description: "Instructions how to integrate Sony Songpal devices into Home Assistant."
+description: "Instructions on how to integrate Sony Songpal devices into Home Assistant."
date: 2018-02-03 09:00
sidebar: true
comments: false
@@ -23,7 +23,7 @@ A few notes:
- The quick start-up mode has to be enabled in order to turn the device on.
- Supports currently only one output terminal, i.e. the volume control works only on the first volume controller as reported by the backend library.
-- Some devices, e.g. HT-XT3, do not support decreasing the volume step-by-step correctly.
+- Some devices, e.g., HT-XT3, do not support decreasing the volume step-by-step correctly.
- Feel free to improve the available services!
## {% linkable_title Configuration %}
@@ -61,8 +61,8 @@ For a list of available settings and their values use [`songpal sound`](https://
| Service data attribute | Optional | Description |
|------------------------|----------|--------------------------------------------------|
| `entity_id` | yes | Target entity, leave unset for all devices |
-| `name` | no | Configuration variable, e.g. `nightmode` |
-| `value` | no | New configuration value, e.g. `on` |
+| `name` | no | Configuration variable, e.g., `nightmode` |
+| `value` | no | New configuration value, e.g., `on` |
diff --git a/source/_components/media_player.sonos.markdown b/source/_components/media_player.sonos.markdown
index 3afe420ff4d..862cd822f8c 100644
--- a/source/_components/media_player.sonos.markdown
+++ b/source/_components/media_player.sonos.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Sonos"
-description: "Instructions how to integrate Sonos devices into Home Assistant."
+description: "Instructions on how to integrate Sonos devices into Home Assistant."
date: 2015-09-12 13:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.soundtouch.markdown b/source/_components/media_player.soundtouch.markdown
index fa2a550b024..463914f2366 100644
--- a/source/_components/media_player.soundtouch.markdown
+++ b/source/_components/media_player.soundtouch.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Soundtouch"
-description: "Instructions how to integrate Bose Soundtouch devices into Home Assistant."
+description: "Instructions on how to integrate Bose Soundtouch devices into Home Assistant."
date: 2016-11-06 13:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.universal.markdown b/source/_components/media_player.universal.markdown
index 106f114f780..76cbc4a4ba6 100644
--- a/source/_components/media_player.universal.markdown
+++ b/source/_components/media_player.universal.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Universal"
-description: "Instructions how to create a universal media player in Home Assistant."
+description: "Instructions on how to create a universal media player in Home Assistant."
date: 2016-01-12 22:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.vizio.markdown b/source/_components/media_player.vizio.markdown
index 7c8cfa363ba..5b8d7eb35f3 100644
--- a/source/_components/media_player.vizio.markdown
+++ b/source/_components/media_player.vizio.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Vizio SmartCast TV"
-description: "Instructions how to integrate Vizio SmartCast TV into Home Assistant."
+description: "Instructions on how to integrate Vizio SmartCast TV into Home Assistant."
date: 2017-07-10 19:00
sidebar: true
comments: false
diff --git a/source/_components/media_player.webostv.markdown b/source/_components/media_player.webostv.markdown
index 3775ae8260c..707ef55a905 100644
--- a/source/_components/media_player.webostv.markdown
+++ b/source/_components/media_player.webostv.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "LG webOS Smart TV"
-description: "Instructions how to integrate a LG webOS Smart TV within Home Assistant."
+description: "Instructions on how to integrate a LG webOS Smart TV within Home Assistant."
date: 2016-04-18 23:24
sidebar: true
comments: false
@@ -36,7 +36,7 @@ media_player:
Configuration variables:
-- **host** (*Optional*): The IP of the LG webOS Smart TV, e.g. `192.168.0.10`.
+- **host** (*Optional*): The IP of the LG webOS Smart TV, e.g., `192.168.0.10`.
- **turn_on_action** (*Optional*): Defines an [action](/docs/automation/action/) to turn the TV on.
- **name** (*Optional*): The name you would like to give to the LG webOS Smart TV.
- **timeout** (*Optional*): The timeout for connections to the TV in seconds.
diff --git a/source/_components/media_player.yamaha.markdown b/source/_components/media_player.yamaha.markdown
index c306b1d5272..b996e642a47 100644
--- a/source/_components/media_player.yamaha.markdown
+++ b/source/_components/media_player.yamaha.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Yamaha Network Receivers"
-description: "Instructions how to integrate Yamaha Network Receivers into Home Assistant."
+description: "Instructions on how to integrate Yamaha Network Receivers into Home Assistant."
date: 2016-03-26 0:58 -0700
sidebar: true
comments: false
@@ -36,9 +36,9 @@ Configuration variables:
default name (often model number) that is returned by the device.
- **host** (*Optional*): IP address or hostname of the device
- **source_ignore** (*Optional*): List of sources to hide in the front-end
-- **source_names** (*Optional*): Mapping of internal AVR source names to custom ones, allowing one to rename e.g. `HDMI1` to `ChromeCast`
+- **source_names** (*Optional*): Mapping of internal AVR source names to custom ones, allowing one to rename e.g., `HDMI1` to `ChromeCast`
- **zone_ignore** (*Optional*): List of zones to hide in the front-end
-- **zone_names** (*Optional*): Mapping of zone names to custom ones, allowing one to rename e.g. `Main_Zone` to `Family Room`
+- **zone_names** (*Optional*): Mapping of zone names to custom ones, allowing one to rename e.g., `Main_Zone` to `Family Room`
### {% linkable_title Discovery notes %}
@@ -121,5 +121,5 @@ Enable or disable an output port (HDMI) on the receiver.
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | yes | String or list of strings that point at `entity_id`s of Yamaha receivers.
-| `port` | no | Port to enable or disable, e.g. `hdmi1`.
+| `port` | no | Port to enable or disable, e.g., `hdmi1`.
| `enabled` | no | To enable set true, otherwise set to false.
diff --git a/source/_components/media_player.ziggo_mediabox_xl.markdown b/source/_components/media_player.ziggo_mediabox_xl.markdown
index 5919b19b50b..0581b320a26 100644
--- a/source/_components/media_player.ziggo_mediabox_xl.markdown
+++ b/source/_components/media_player.ziggo_mediabox_xl.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Ziggo Mediabox XL"
-description: "Instructions how to integrate the Ziggo Mediabox XL into Home Assistant."
+description: "Instructions on how to integrate the Ziggo Mediabox XL into Home Assistant."
date: 2017-11-10 20:00
sidebar: true
comments: false
diff --git a/source/_components/melissa.markdown b/source/_components/melissa.markdown
index ffc6364fc99..ed696574cc4 100644
--- a/source/_components/melissa.markdown
+++ b/source/_components/melissa.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Melissa Climate"
-description: "Instructions how to integrate Melissa Climate into Home Assistant."
+description: "Instructions on how to integrate Melissa Climate into Home Assistant."
date: 2017-01-05 17:30
sidebar: true
comments: false
diff --git a/source/_components/mochad.markdown b/source/_components/mochad.markdown
index f27367f0da1..df42020a212 100644
--- a/source/_components/mochad.markdown
+++ b/source/_components/mochad.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Mochad"
-description: "Instructions how to integrate Mochad into Home Assistant."
+description: "Instructions on how to integrate Mochad into Home Assistant."
date: 2016-10-20 17:09
sidebar: true
comments: false
diff --git a/source/_components/modbus.markdown b/source/_components/modbus.markdown
index 9d560058290..30a2b62382a 100644
--- a/source/_components/modbus.markdown
+++ b/source/_components/modbus.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Modbus"
-description: "Instructions how to integrate Modbus within Home Assistant."
+description: "Instructions on how to integrate Modbus within Home Assistant."
date: 2015-04-25 9:16
sidebar: true
comments: false
diff --git a/source/_components/mqtt.markdown b/source/_components/mqtt.markdown
index 5514b98c362..c3f41493425 100644
--- a/source/_components/mqtt.markdown
+++ b/source/_components/mqtt.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "MQTT"
-description: "Instructions how to setup MQTT within Home Assistant."
+description: "Instructions on how to setup MQTT within Home Assistant."
date: 2015-08-07 18:00
sidebar: true
comments: false
diff --git a/source/_components/mqtt_eventstream.markdown b/source/_components/mqtt_eventstream.markdown
index da0f6fe3c3f..11644dc5b32 100644
--- a/source/_components/mqtt_eventstream.markdown
+++ b/source/_components/mqtt_eventstream.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "MQTT Eventstream"
-description: "Instructions how to setup MQTT eventstream within Home Assistant."
+description: "Instructions on how to setup MQTT eventstream within Home Assistant."
date: 2016-01-13 08:00
sidebar: true
comments: false
diff --git a/source/_components/mqtt_statestream.markdown b/source/_components/mqtt_statestream.markdown
index 5b7b832fe91..1a607624d3c 100644
--- a/source/_components/mqtt_statestream.markdown
+++ b/source/_components/mqtt_statestream.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "MQTT Statestream"
-description: "Instructions how to setup MQTT Statestream within Home Assistant."
+description: "Instructions on how to setup MQTT Statestream within Home Assistant."
date: 2017-10-01 20:00
sidebar: true
comments: false
diff --git a/source/_components/mycroft.markdown b/source/_components/mycroft.markdown
index 705800f6e34..9754096be00 100644
--- a/source/_components/mycroft.markdown
+++ b/source/_components/mycroft.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Mycroft"
-description: "Instructions how to setup Mycroft AI within Home Assistant."
+description: "Instructions on how to setup Mycroft AI within Home Assistant."
date: 2017-08-26 17:00
sidebar: true
comments: false
diff --git a/source/_components/mysensors.markdown b/source/_components/mysensors.markdown
index c91f5a123e6..f9e9388c679 100644
--- a/source/_components/mysensors.markdown
+++ b/source/_components/mysensors.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "MySensors"
-description: "Instructions how to integrate MySensors sensors into Home Assistant."
+description: "Instructions on how to integrate MySensors sensors into Home Assistant."
date: 2016-10-01 15:00 +0200
sidebar: true
comments: false
diff --git a/source/_components/neato.markdown b/source/_components/neato.markdown
index 8c5b205e98a..316769ff7ce 100644
--- a/source/_components/neato.markdown
+++ b/source/_components/neato.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Neato Robotics"
-description: "Instructions how to integrate your Neato within Home Assistant."
+description: "Instructions on how to integrate your Neato within Home Assistant."
date: 2016-10-09 20:15
sidebar: true
comments: false
diff --git a/source/_components/nest.markdown b/source/_components/nest.markdown
index 7aa5adfb9c9..718bddc2537 100644
--- a/source/_components/nest.markdown
+++ b/source/_components/nest.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Nest"
-description: "Instructions how to integrate Nest into Home Assistant."
+description: "Instructions on how to integrate Nest into Home Assistant."
date: 2016-01-29 21:57
sidebar: true
comments: false
diff --git a/source/_components/netatmo.markdown b/source/_components/netatmo.markdown
index ebb254a3109..0efe4ac968c 100644
--- a/source/_components/netatmo.markdown
+++ b/source/_components/netatmo.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Netatmo"
-description: "Instructions how to integrate Netatmo component into Home Assistant."
+description: "Instructions on how to integrate Netatmo component into Home Assistant."
date: 2016-06-02 08:10
sidebar: true
comments: false
diff --git a/source/_components/notify.apns.markdown b/source/_components/notify.apns.markdown
index 30737d617ec..dcad472dbb1 100644
--- a/source/_components/notify.apns.markdown
+++ b/source/_components/notify.apns.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "APNS"
-description: "Instructions how to add APNS notifications to Home Assistant."
+description: "Instructions on how to add APNS notifications to Home Assistant."
date: 2016-09-05 23:00
sidebar: true
comments: false
diff --git a/source/_components/notify.aws_lambda.markdown b/source/_components/notify.aws_lambda.markdown
index 21ef850da95..be5a5494caa 100644
--- a/source/_components/notify.aws_lambda.markdown
+++ b/source/_components/notify.aws_lambda.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "AWS Lambda"
-description: "Instructions how to invoke AWS Lambda functions from Home Assistant."
+description: "Instructions on how to invoke AWS Lambda functions from Home Assistant."
date: 2016-05-14 16:35
sidebar: true
comments: false
diff --git a/source/_components/notify.aws_sns.markdown b/source/_components/notify.aws_sns.markdown
index 21a6b48cc55..cfa69e00843 100644
--- a/source/_components/notify.aws_sns.markdown
+++ b/source/_components/notify.aws_sns.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "AWS SNS"
-description: "Instructions how to publish messages to AWS SNS from Home Assistant."
+description: "Instructions on how to publish messages to AWS SNS from Home Assistant."
date: 2016-05-14 16:35
sidebar: true
comments: false
diff --git a/source/_components/notify.aws_sqs.markdown b/source/_components/notify.aws_sqs.markdown
index e40e81050b1..a1e8a33f8bd 100644
--- a/source/_components/notify.aws_sqs.markdown
+++ b/source/_components/notify.aws_sqs.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "AWS SQS"
-description: "Instructions how to publish messages to AWS SQS from Home Assistant."
+description: "Instructions on how to publish messages to AWS SQS from Home Assistant."
date: 2016-05-14 16:35
sidebar: true
comments: false
diff --git a/source/_components/notify.ciscospark.markdown b/source/_components/notify.ciscospark.markdown
index cf2449fac42..fb55b90a6f9 100644
--- a/source/_components/notify.ciscospark.markdown
+++ b/source/_components/notify.ciscospark.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Cisco Spark"
-description: "Instructions how to add CiscoSpark notifications to Home Assistant."
+description: "Instructions on how to add CiscoSpark notifications to Home Assistant."
date: 2017-02-20 15:00
sidebar: true
comments: false
diff --git a/source/_components/notify.clickatell.markdown b/source/_components/notify.clickatell.markdown
index 783f3deb588..8a26160d4f6 100644
--- a/source/_components/notify.clickatell.markdown
+++ b/source/_components/notify.clickatell.markdown
@@ -40,7 +40,7 @@ Configuration variables:
* **name** (Optional): Setting the optional parameter name allows multiple notifiers to be created. The default value is `clickatell`. The notifier will bind to the service notify.NOTIFIER_NAME.
* **api_key** (Required): Your API key.
-* **recipient** (Required): Your phone number. This is where you want to send your notification SMS messages. e.g. `61444333444`.
+* **recipient** (Required): Your phone number. This is where you want to send your notification SMS messages. e.g., `61444333444`.
To use notifications, please see the [getting started with automation page](https://home-assistant.io/getting-started/automation/).
diff --git a/source/_components/notify.command_line.markdown b/source/_components/notify.command_line.markdown
index a5d3b6a5942..4f82febe402 100644
--- a/source/_components/notify.command_line.markdown
+++ b/source/_components/notify.command_line.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Command line Notify"
-description: "Instructions how to add command line notifications to Home Assistant."
+description: "Instructions on how to add command line notifications to Home Assistant."
date: 2016-02-22 20:00
sidebar: true
comments: false
diff --git a/source/_components/notify.discord.markdown b/source/_components/notify.discord.markdown
index 657b94e84e5..9f289602671 100644
--- a/source/_components/notify.discord.markdown
+++ b/source/_components/notify.discord.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Discord"
-description: "Instructions how to add Discord notifications to Home Assistant."
+description: "Instructions on how to add Discord notifications to Home Assistant."
date: 2016-01-14 15:15
sidebar: true
comments: false
diff --git a/source/_components/notify.ecobee.markdown b/source/_components/notify.ecobee.markdown
index 18ba15b94b2..53f97f69d12 100644
--- a/source/_components/notify.ecobee.markdown
+++ b/source/_components/notify.ecobee.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Ecobee Notify"
-description: "Instructions how to setup the Ecobee notification component within Home Assistant."
+description: "Instructions on how to setup the Ecobee notification component within Home Assistant."
date: 2016-05-12 09:00
sidebar: true
comments: false
diff --git a/source/_components/notify.facebook.markdown b/source/_components/notify.facebook.markdown
index 0bdb62c8a7b..beb539c559c 100644
--- a/source/_components/notify.facebook.markdown
+++ b/source/_components/notify.facebook.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Facebook Messenger"
-description: "Instructions how to add Facebook user notifications to Home Assistant."
+description: "Instructions on how to add Facebook user notifications to Home Assistant."
date: 2016-12-31 14:14
sidebar: true
comments: false
diff --git a/source/_components/notify.file.markdown b/source/_components/notify.file.markdown
index 0061b31f003..9a94b1177e4 100644
--- a/source/_components/notify.file.markdown
+++ b/source/_components/notify.file.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "File"
-description: "Instructions how to add file notifications to Home Assistant."
+description: "Instructions on how to add file notifications to Home Assistant."
date: 2015-06-22 10:00
sidebar: true
comments: false
diff --git a/source/_components/notify.free_mobile.markdown b/source/_components/notify.free_mobile.markdown
index 0123c7fec5d..f02c52ea304 100644
--- a/source/_components/notify.free_mobile.markdown
+++ b/source/_components/notify.free_mobile.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Free Mobile"
-description: "Instructions how to add user notifications to Home Assistant."
+description: "Instructions on how to add user notifications to Home Assistant."
date: 2016-01-12 08:36
sidebar: true
comments: false
diff --git a/source/_components/notify.group.markdown b/source/_components/notify.group.markdown
index e68b76112e5..928de178e78 100644
--- a/source/_components/notify.group.markdown
+++ b/source/_components/notify.group.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Notify Group"
-description: "Instructions how to setup the notify group platform."
+description: "Instructions on how to setup the notify group platform."
date: 2016-08-18 00:12
sidebar: true
comments: false
diff --git a/source/_components/notify.hipchat.markdown b/source/_components/notify.hipchat.markdown
index d36905f38ed..877bcd8cd82 100644
--- a/source/_components/notify.hipchat.markdown
+++ b/source/_components/notify.hipchat.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "HipChat"
-description: "Instructions how to add HipChat notifications to Home Assistant."
+description: "Instructions on how to add HipChat notifications to Home Assistant."
date: 2017-08-10 15:00
sidebar: true
comments: false
diff --git a/source/_components/notify.html5.markdown b/source/_components/notify.html5.markdown
index 2a5a95ef7b1..4520143f896 100644
--- a/source/_components/notify.html5.markdown
+++ b/source/_components/notify.html5.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Push Notifications"
-description: "Instructions how to use the HTML5 push notifications platform from Home Assistant."
+description: "Instructions on how to use the HTML5 push notifications platform from Home Assistant."
date: 2016-08-17 21:58
sidebar: true
comments: false
diff --git a/source/_components/notify.instapush.markdown b/source/_components/notify.instapush.markdown
index 427991e60dc..020f535c106 100644
--- a/source/_components/notify.instapush.markdown
+++ b/source/_components/notify.instapush.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Instapush"
-description: "Instructions how to add Instapush notifications to Home Assistant."
+description: "Instructions on how to add Instapush notifications to Home Assistant."
date: 2015-05-01 18:00
sidebar: true
comments: false
diff --git a/source/_components/notify.joaoapps_join.markdown b/source/_components/notify.joaoapps_join.markdown
index 3f64711ff72..2143480d0e3 100644
--- a/source/_components/notify.joaoapps_join.markdown
+++ b/source/_components/notify.joaoapps_join.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Join Notify"
-description: "Instructions how to setup the Join notification platform within Home Assistant."
+description: "Instructions on how to setup the Join notification platform within Home Assistant."
date: 2016-07-12 09:00
sidebar: true
comments: false
diff --git a/source/_components/notify.kodi.markdown b/source/_components/notify.kodi.markdown
index 6949a927227..7d350005a85 100644
--- a/source/_components/notify.kodi.markdown
+++ b/source/_components/notify.kodi.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Kodi"
-description: "Instructions how to add Kodi notifications to Home Assistant."
+description: "Instructions on how to add Kodi notifications to Home Assistant."
date: 2016-09-12 16:00
sidebar: true
comments: false
diff --git a/source/_components/notify.lannouncer.markdown b/source/_components/notify.lannouncer.markdown
index 2f411679c95..5aba4e41f9e 100644
--- a/source/_components/notify.lannouncer.markdown
+++ b/source/_components/notify.lannouncer.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Lannouncer"
-description: "Instructions how to add Lannouncer notifications to Home Assistant."
+description: "Instructions on how to add Lannouncer notifications to Home Assistant."
date: 2017-01-06 10:00
sidebar: true
comments: false
diff --git a/source/_components/notify.llamalab_automate.markdown b/source/_components/notify.llamalab_automate.markdown
index 3b5d5d2dd5a..40becc0eb52 100644
--- a/source/_components/notify.llamalab_automate.markdown
+++ b/source/_components/notify.llamalab_automate.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "LlamaLab Automate"
-description: "Instructions how to add user notifications to Home Assistant."
+description: "Instructions on how to add user notifications to Home Assistant."
date: 2016-08-21 13:00
sidebar: true
comments: false
diff --git a/source/_components/notify.mailgun.markdown b/source/_components/notify.mailgun.markdown
index be571eb2c14..9e98d180524 100644
--- a/source/_components/notify.mailgun.markdown
+++ b/source/_components/notify.mailgun.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Mailgun Notify"
-description: "Instructions how to add Mailgun mail notifications to Home Assistant."
+description: "Instructions on how to add Mailgun mail notifications to Home Assistant."
date: 2017-02-06 16:52
sidebar: true
comments: false
diff --git a/source/_components/notify.markdown b/source/_components/notify.markdown
index 6ef8c7c50db..5237224f46d 100644
--- a/source/_components/notify.markdown
+++ b/source/_components/notify.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Notifications"
-description: "Instructions how to add user notifications to Home Assistant."
+description: "Instructions on how to add user notifications to Home Assistant."
date: 2015-01-20 22:36
sidebar: true
comments: false
diff --git a/source/_components/notify.matrix.markdown b/source/_components/notify.matrix.markdown
index fe5d7fc3a40..c74b962e347 100644
--- a/source/_components/notify.matrix.markdown
+++ b/source/_components/notify.matrix.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Matrix"
-description: "Instructions how to add Matrix notifications to Home Assistant."
+description: "Instructions on how to add Matrix notifications to Home Assistant."
date: 2016-10-11 23:51
sidebar: true
comments: false
@@ -31,7 +31,7 @@ notify:
Configuration variables:
- **name** (*Optional*): Setting the optional parameter `name` allows multiple notifiers to be created. The default value is `notify`. The notifier will bind to the service `notify.NOTIFIER_NAME`.
-- **homeserver** (*Required*): The base URL of the homeserver, where the notifier account is registered (e.g. `https://matrix.org`).
+- **homeserver** (*Required*): The base URL of the homeserver, where the notifier account is registered (e.g., `https://matrix.org`).
- **username** (*Required*): The username of the notifying Matrix account.
- **password** (*Required*): The password for the given Matrix account.
- **default_room** (*Required*): The room all messages will be sent to, when no other target is given.
diff --git a/source/_components/notify.message_bird.markdown b/source/_components/notify.message_bird.markdown
index d8baf5fa0d7..2234a86310e 100644
--- a/source/_components/notify.message_bird.markdown
+++ b/source/_components/notify.message_bird.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "MessageBird"
-description: "Instructions how to add user notifications to Home Assistant."
+description: "Instructions on how to add user notifications to Home Assistant."
date: 2016-03-15 17:00
sidebar: true
comments: false
@@ -28,7 +28,7 @@ Configuration variables:
- **api_key** (*Required*): Enter the API key for MessageBird. Go to https://www.messagebird.com/ to retrieve your API key.
- **name** (*Optional*): Setting the optional parameter `name` allows multiple notifiers to be created. The default value is `notify`. The notifier will bind to the service `notify.NOTIFIER_NAME`.
-- **sender** (*Optional*): Setting the optional parameter `sender`. This will be the sender of the SMS. It may be either a telephone number (e.g. `+4915112345678`) or a text with a maximum length of 11 characters. Defaults to `HA`.
+- **sender** (*Optional*): Setting the optional parameter `sender`. This will be the sender of the SMS. It may be either a telephone number (e.g., `+4915112345678`) or a text with a maximum length of 11 characters. Defaults to `HA`.
### {% linkable_title Usage %}
diff --git a/source/_components/notify.mqtt.markdown b/source/_components/notify.mqtt.markdown
index 7aefb8743f0..3f2cb633a9e 100644
--- a/source/_components/notify.mqtt.markdown
+++ b/source/_components/notify.mqtt.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "MQTT Notifications"
-description: "Instructions how to add MQTT notifications to Home Assistant."
+description: "Instructions on how to add MQTT notifications to Home Assistant."
date: 2016-02-01 08:00
sidebar: true
comments: false
diff --git a/source/_components/notify.mycroft.markdown b/source/_components/notify.mycroft.markdown
index f2e76800989..81917884998 100644
--- a/source/_components/notify.mycroft.markdown
+++ b/source/_components/notify.mycroft.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Mycroft AI"
-description: "Instructions how to add Mycroft AI notifications to Home Assistant."
+description: "Instructions on how to add Mycroft AI notifications to Home Assistant."
date: 2017-08-26 17:00 UTC
sidebar: true
comments: false
diff --git a/source/_components/notify.mysensors.markdown b/source/_components/notify.mysensors.markdown
index e465afe63d3..3dab5bc10dd 100644
--- a/source/_components/notify.mysensors.markdown
+++ b/source/_components/notify.mysensors.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "MySensors Notify"
-description: "Instructions how to integrate MySensors notifications into Home Assistant."
+description: "Instructions on how to integrate MySensors notifications into Home Assistant."
date: 2017-01-07 15:00 +0100
sidebar: true
comments: false
diff --git a/source/_components/notify.nfandroidtv.markdown b/source/_components/notify.nfandroidtv.markdown
index cebd6447077..e1bf8659ba8 100644
--- a/source/_components/notify.nfandroidtv.markdown
+++ b/source/_components/notify.nfandroidtv.markdown
@@ -38,7 +38,7 @@ Configuration variables:
- **position** (*Optional*): Has to be one of: bottom-right (default), bottom-left, top-right, top-left, center
- **color** (*Optional*): Has to be one of: grey (default), black, indigo, green, red, cyan, teal, amber, pink
- **transparency** (*Optional*): Has to be one of: 0%, 25% (default), 50%, 75%, 100%
-- **interrupt** (*Optional*): If set to true, 1, on etc., the notification is interactive and can be dismissed or selected to display more details. Depending on the running app (e.g. Netflix), this may stop playback.
+- **interrupt** (*Optional*): If set to true, 1, on etc., the notification is interactive and can be dismissed or selected to display more details. Depending on the running app (e.g., Netflix), this may stop playback.
The configuration will be used to configure the default values for the notification for the host specified by the IP. However, you can override most of the settings by passing them with the data-attribute when calling the service.
This is a fully customized JSON you can use to test how the final notification will look like:
diff --git a/source/_components/notify.nma.markdown b/source/_components/notify.nma.markdown
index bbe4e871101..c6165bb8988 100644
--- a/source/_components/notify.nma.markdown
+++ b/source/_components/notify.nma.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Notify My Android"
-description: "Instructions how to add NMA notifications to Home Assistant."
+description: "Instructions on how to add NMA notifications to Home Assistant."
date: 2015-05-01 18:00
sidebar: true
comments: false
diff --git a/source/_components/notify.prowl.markdown b/source/_components/notify.prowl.markdown
index 2bfeb97fc45..4fbe377bb63 100644
--- a/source/_components/notify.prowl.markdown
+++ b/source/_components/notify.prowl.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Prowl"
-description: "Instructions how to add Prowl notifications to Home Assistant."
+description: "Instructions on how to add Prowl notifications to Home Assistant."
date: 2017-08-17 18:00
sidebar: true
comments: false
diff --git a/source/_components/notify.pushbullet.markdown b/source/_components/notify.pushbullet.markdown
index 0ba8c606f3f..cadfd99cf95 100644
--- a/source/_components/notify.pushbullet.markdown
+++ b/source/_components/notify.pushbullet.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Pushbullet"
-description: "Instructions how to add user notifications to Home Assistant."
+description: "Instructions on how to add user notifications to Home Assistant."
date: 2015-01-20 22:36
sidebar: true
comments: false
diff --git a/source/_components/notify.pushetta.markdown b/source/_components/notify.pushetta.markdown
index 6209d6bcd1b..bf31900c345 100644
--- a/source/_components/notify.pushetta.markdown
+++ b/source/_components/notify.pushetta.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Pushetta"
-description: "Instructions how to add Pushetta notifications to Home Assistant."
+description: "Instructions on how to add Pushetta notifications to Home Assistant."
date: 2015-11-10 18:00
sidebar: true
comments: false
diff --git a/source/_components/notify.pushover.markdown b/source/_components/notify.pushover.markdown
index 67e7db1098a..244c01b58d1 100644
--- a/source/_components/notify.pushover.markdown
+++ b/source/_components/notify.pushover.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Pushover"
-description: "Instructions how to add Pushover notifications to Home Assistant."
+description: "Instructions on how to add Pushover notifications to Home Assistant."
date: 2015-01-20 22:36
sidebar: true
comments: false
diff --git a/source/_components/notify.pushsafer.markdown b/source/_components/notify.pushsafer.markdown
index 61edbe9d8d7..dc7eb190579 100644
--- a/source/_components/notify.pushsafer.markdown
+++ b/source/_components/notify.pushsafer.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Pushsafer"
-description: "Instructions how to add Pushsafer notifications to Home Assistant."
+description: "Instructions on how to add Pushsafer notifications to Home Assistant."
date: 2018-01-05 11:15
sidebar: true
comments: false
diff --git a/source/_components/notify.rest.markdown b/source/_components/notify.rest.markdown
index 370f26be8c3..c20e4bc2f51 100644
--- a/source/_components/notify.rest.markdown
+++ b/source/_components/notify.rest.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "REST"
-description: "Instructions how to add RESTful notifications to Home Assistant."
+description: "Instructions on how to add RESTful notifications to Home Assistant."
date: 2016-02-12 07:00
sidebar: true
comments: false
diff --git a/source/_components/notify.sendgrid.markdown b/source/_components/notify.sendgrid.markdown
index 16bf7e992a1..2491bac32e4 100644
--- a/source/_components/notify.sendgrid.markdown
+++ b/source/_components/notify.sendgrid.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "SendGrid"
-description: "Instructions how to add email notifications via SendGrid to Home Assistant."
+description: "Instructions on how to add email notifications via SendGrid to Home Assistant."
date: 2016-02-27 18:00
sidebar: true
comments: false
diff --git a/source/_components/notify.simplepush.markdown b/source/_components/notify.simplepush.markdown
index 4747d9a5f48..2556c820373 100644
--- a/source/_components/notify.simplepush.markdown
+++ b/source/_components/notify.simplepush.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Simplepush"
-description: "Instructions how to add Simplepush notifications to Home Assistant."
+description: "Instructions on how to add Simplepush notifications to Home Assistant."
date: 2016-09-11 18:00
sidebar: true
comments: false
diff --git a/source/_components/notify.slack.markdown b/source/_components/notify.slack.markdown
index 75b5419f59a..3e384990109 100644
--- a/source/_components/notify.slack.markdown
+++ b/source/_components/notify.slack.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Slack"
-description: "Instructions how to add Slack notifications to Home Assistant."
+description: "Instructions on how to add Slack notifications to Home Assistant."
date: 2015-08-06 18:00
sidebar: true
comments: false
diff --git a/source/_components/notify.smtp.markdown b/source/_components/notify.smtp.markdown
index 533129e36cb..c0d51f21b83 100644
--- a/source/_components/notify.smtp.markdown
+++ b/source/_components/notify.smtp.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "SMTP"
-description: "Instructions how to add e-mail notifications to Home Assistant."
+description: "Instructions on how to add e-mail notifications to Home Assistant."
date: 2015-06-03 18:00
sidebar: true
comments: false
diff --git a/source/_components/notify.synology_chat.markdown b/source/_components/notify.synology_chat.markdown
index 2ea2dd577d5..5fbbae6a046 100644
--- a/source/_components/notify.synology_chat.markdown
+++ b/source/_components/notify.synology_chat.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Synology Chat"
-description: "Instructions how to add a Synology Chat Bot notifications to Home Assistant."
+description: "Instructions on how to add a Synology Chat Bot notifications to Home Assistant."
date: 2018-02-15 07:00
sidebar: true
comments: false
diff --git a/source/_components/notify.syslog.markdown b/source/_components/notify.syslog.markdown
index 5e905e73e55..13683e8a8a2 100644
--- a/source/_components/notify.syslog.markdown
+++ b/source/_components/notify.syslog.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Syslog"
-description: "Instructions how to add syslog notifications to Home Assistant."
+description: "Instructions on how to add syslog notifications to Home Assistant."
date: 2015-06-09 16:00
sidebar: true
comments: false
diff --git a/source/_components/notify.telegram.markdown b/source/_components/notify.telegram.markdown
index ac89f6f23c7..534924105de 100644
--- a/source/_components/notify.telegram.markdown
+++ b/source/_components/notify.telegram.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Telegram"
-description: "Instructions how to add Telegram notifications to Home Assistant."
+description: "Instructions on how to add Telegram notifications to Home Assistant."
date: 2015-10-09 18:00
sidebar: true
comments: false
diff --git a/source/_components/notify.twilio_call.markdown b/source/_components/notify.twilio_call.markdown
index 9caf251d046..7f0fa2a989e 100644
--- a/source/_components/notify.twilio_call.markdown
+++ b/source/_components/notify.twilio_call.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Twilio Call"
-description: "Instructions how to add user notifications to Home Assistant."
+description: "Instructions on how to add user notifications to Home Assistant."
date: 2017-01-27 00:09
sidebar: true
comments: false
diff --git a/source/_components/notify.twilio_sms.markdown b/source/_components/notify.twilio_sms.markdown
index ec5002258ce..7cec94cf339 100644
--- a/source/_components/notify.twilio_sms.markdown
+++ b/source/_components/notify.twilio_sms.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Twilio SMS"
-description: "Instructions how to add user notifications to Home Assistant."
+description: "Instructions on how to add user notifications to Home Assistant."
date: 2016-05-14 14:14
sidebar: true
comments: false
diff --git a/source/_components/notify.twitter.markdown b/source/_components/notify.twitter.markdown
index f63810e68eb..6bf8867709c 100644
--- a/source/_components/notify.twitter.markdown
+++ b/source/_components/notify.twitter.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Twitter"
-description: "Instructions how to add Twitter notifications to Home Assistant."
+description: "Instructions on how to add Twitter notifications to Home Assistant."
date: 2016-01-27 07:00
sidebar: true
comments: false
diff --git a/source/_components/notify.webostv.markdown b/source/_components/notify.webostv.markdown
index 8064c8fbf85..c3dbadfbe4a 100644
--- a/source/_components/notify.webostv.markdown
+++ b/source/_components/notify.webostv.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "LG WebOS TV notifications"
-description: "Instructions how to integrate a LG WebOS TV within Home Assistant."
+description: "Instructions on how to integrate a LG WebOS TV within Home Assistant."
date: 2016-04-18 23:24
sidebar: true
comments: false
@@ -30,7 +30,7 @@ notify:
Configuration variables:
-- **host** (*Required*): The IP of the LG WebOS Smart TV, e.g. 192.168.0.10
+- **host** (*Required*): The IP of the LG WebOS Smart TV, e.g., 192.168.0.10
- **name** (*Required*): The name you would like to give to the LG WebOS Smart TV.
- **filename** (*Optional*): The filename where the pairing key with the TV should be stored. This path is relative to Home Assistant's config directory. It defaults to `webostv.conf`.
- **icon** (*Optional*): The path to an image file to use as the icon in notifications.
diff --git a/source/_components/notify.xmpp.markdown b/source/_components/notify.xmpp.markdown
index db062932d04..930aa496ac6 100644
--- a/source/_components/notify.xmpp.markdown
+++ b/source/_components/notify.xmpp.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Jabber (XMPP)"
-description: "Instructions how to add Jabber (XMPP) notifications to Home Assistant."
+description: "Instructions on how to add Jabber (XMPP) notifications to Home Assistant."
date: 2015-05-08 18:00
sidebar: true
comments: false
diff --git a/source/_components/notify.yessssms.markdown b/source/_components/notify.yessssms.markdown
index e320de496a7..040acd518b8 100644
--- a/source/_components/notify.yessssms.markdown
+++ b/source/_components/notify.yessssms.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Yesss SMS"
-description: "Instructions how to add user notifications to Home Assistant."
+description: "Instructions on how to add user notifications to Home Assistant."
date: 2017-10-27 16:00
sidebar: true
comments: false
diff --git a/source/_components/nuheat.markdown b/source/_components/nuheat.markdown
index a261aececba..9169a5091e1 100644
--- a/source/_components/nuheat.markdown
+++ b/source/_components/nuheat.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "NuHeat"
-description: "Instructions how to integrate your NuHeat Signature thermostats within Home Assistant."
+description: "Instructions on how to integrate your NuHeat Signature thermostats within Home Assistant."
date: 2017-11-11 18:00
sidebar: true
comments: false
diff --git a/source/_components/nuimo_controller.markdown b/source/_components/nuimo_controller.markdown
index e2ed36fba8b..92b1bbd618f 100644
--- a/source/_components/nuimo_controller.markdown
+++ b/source/_components/nuimo_controller.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Nuimo controller"
-description: "Instructions how to setup and use a Nuimo device in Home Assistant."
+description: "Instructions on how to setup and use a Nuimo device in Home Assistant."
date: 2016-08-30 12:00
sidebar: true
comments: false
diff --git a/source/_components/octoprint.markdown b/source/_components/octoprint.markdown
index 192d5d9d9a3..03f0fae06d4 100644
--- a/source/_components/octoprint.markdown
+++ b/source/_components/octoprint.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "OctoPrint"
-description: "Instructions how to setup the OctoPrint in Home Assistant."
+description: "Instructions on how to setup the OctoPrint in Home Assistant."
date: 2015-01-20 22:36
sidebar: true
comments: false
diff --git a/source/_components/panel_custom.markdown b/source/_components/panel_custom.markdown
index 49775f28557..0415c561a7d 100644
--- a/source/_components/panel_custom.markdown
+++ b/source/_components/panel_custom.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Panel Custom"
-description: "Instructions how to add customized panels to the frontend of Home Assistant."
+description: "Instructions on how to add customized panels to the frontend of Home Assistant."
date: 2015-08-08 11:00
sidebar: true
comments: false
diff --git a/source/_components/panel_iframe.markdown b/source/_components/panel_iframe.markdown
index 71ba4b2aec1..8aa5514f0cb 100644
--- a/source/_components/panel_iframe.markdown
+++ b/source/_components/panel_iframe.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Panel iFrame"
-description: "Instructions how to add iFrames in the frontend of Home Assistant."
+description: "Instructions on how to add iFrames in the frontend of Home Assistant."
date: 2015-07-17 18:00
sidebar: true
comments: false
diff --git a/source/_components/pilight.markdown b/source/_components/pilight.markdown
index a08f4cd9351..ab841bbe834 100644
--- a/source/_components/pilight.markdown
+++ b/source/_components/pilight.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Pilight"
-description: "Instructions how to setup Pilight within Home Assistant."
+description: "Instructions on how to setup Pilight within Home Assistant."
date: 2015-08-07 18:00
sidebar: true
comments: false
@@ -17,7 +17,7 @@ ha_iot_class: "Local Push"
This pilight hub connects to the [pilight-daemon](https://manual.pilight.org/programs/daemon.html) via a socket connection to receive and send codes. Thus Home Assistant does not have to run on the computer in charge of the RF communication.
-The received and supported RF codes are put on the event bus of Home Assistant and are therefore directly usable by other components (e.g. automation). Additionally a send service is provided to send RF codes.
+The received and supported RF codes are put on the event bus of Home Assistant and are therefore directly usable by other components (e.g., automation). Additionally a send service is provided to send RF codes.
To integrate pilight into Home Assistant, add the following section to your `configuration.yaml` file:
@@ -30,10 +30,10 @@ pilight:
Configuration variables:
-- **host** (*Required*): The IP address of the computer running the pilight-daemon, e.g. 192.168.1.32.
+- **host** (*Required*): The IP address of the computer running the pilight-daemon, e.g., 192.168.1.32.
- **port** (*Required*): The network port to connect to. The usual port is [5000](https://manual.pilight.org/development/api.html).
- **send_delay** (*Optional*): You can define a send delay as a fraction of seconds if you experience transmission problems when you try to switch multiple switches at once. This can happen when you use a [pilight USB Nano](https://github.com/pilight/pilight-usb-nano) as hardware and switches a whole group of multiple switches on or off. Tested values are between 0.3 and 0.8 seconds depending on the hardware.
-- **whitelist** (*Optional*): You can define a whitelist to prevent that too many unwanted RF codes (e.g. the neighbors weather station) are put on your HA event bus. All defined subsections have to be matched. A subsection is matched if one of the items are true.
+- **whitelist** (*Optional*): You can define a whitelist to prevent that too many unwanted RF codes (e.g., the neighbors weather station) are put on your HA event bus. All defined subsections have to be matched. A subsection is matched if one of the items are true.
In this example only received RF codes using a daycom or Intertechno protocol are put on the event bus and only when the device id is 42. For more possible settings please look at the receiver section of the pilight [API](https://manual.pilight.org/development/api.html).
diff --git a/source/_components/proximity.markdown b/source/_components/proximity.markdown
index 3d8c45b736f..ba8882accd3 100644
--- a/source/_components/proximity.markdown
+++ b/source/_components/proximity.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Proximity"
-description: "Instructions how to setup Proximity monitoring within Home Assistant."
+description: "Instructions on how to setup Proximity monitoring within Home Assistant."
date: 2016-02-07 10:00
sidebar: true
comments: false
@@ -50,7 +50,7 @@ proximity:
Configuration variables:
- **zone** (*Optional*): The zone to which this component is measuring the distance to. Default is the home zone.
-- **ignored_zones** array (*Optional*): Where proximity is not calculated for a device (either the device being monitored or ones being compared (e.g. work or school).
+- **ignored_zones** array (*Optional*): Where proximity is not calculated for a device (either the device being monitored or ones being compared (e.g., work or school).
- **devices** array (*Optional*): A list of devices to compare location against to check closeness to the configured zone.
- **tolerance** (*Optional*): The tolerance used to calculate the direction of travel in meters (m) to filter out small GPS coordinate changes.
- **unit_of_measurement** (*Optional*): The unit of measurement for distance. Valid values are (km, m, mi, ft) [kilometers, meters, miles and feet respectively]. The default value is kilometers.
diff --git a/source/_components/python_script.markdown b/source/_components/python_script.markdown
index 5e03edc16c0..8d01f2b7c45 100644
--- a/source/_components/python_script.markdown
+++ b/source/_components/python_script.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Python Scripts"
-description: "Instructions how to setup Python scripts within Home Assistant."
+description: "Instructions on how to setup Python scripts within Home Assistant."
date: 2017-06-15 19:59
sidebar: true
comments: false
diff --git a/source/_components/qwikswitch.markdown b/source/_components/qwikswitch.markdown
index b7958abeda3..cb4d6f3695c 100644
--- a/source/_components/qwikswitch.markdown
+++ b/source/_components/qwikswitch.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "QwikSwitch QSUSB Hub"
-description: "Instructions how to integrate the QwikSwitch QSUSB Hub into Home Assistant."
+description: "Instructions on how to integrate the QwikSwitch QSUSB Hub into Home Assistant."
date: 2016-05-04 00:00
sidebar: true
comments: false
diff --git a/source/_components/raspihats.markdown b/source/_components/raspihats.markdown
index b20878e6482..fbe53d3d90f 100644
--- a/source/_components/raspihats.markdown
+++ b/source/_components/raspihats.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Raspihats"
-description: "Instructions how to integrate Raspihats add-on boards for Raspberry Pi into Home Assistant."
+description: "Instructions on how to integrate Raspihats add-on boards for Raspberry Pi into Home Assistant."
date: 2017-05-01 04:06
sidebar: true
comments: false
diff --git a/source/_components/recorder.markdown b/source/_components/recorder.markdown
index 6e51c653824..b7410f68ea5 100644
--- a/source/_components/recorder.markdown
+++ b/source/_components/recorder.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Recorder"
-description: "Instructions how to configure the data recorder for Home Assistant."
+description: "Instructions on how to configure the data recorder for Home Assistant."
date: 2017-09-24 09:00
sidebar: true
comments: false
@@ -119,7 +119,7 @@ recorder:
- sensor.date
```
-If you only want to hide events from e.g. your history, take a look at the [`history` component](/components/history/). Same goes for logbook. But if you have privacy concerns about certain events or neither want them in history or logbook, you should use the `exclude`/`include` options of the `recorder` component, that they aren't even in your database. That way you can save storage and keep the database small by excluding certain often-logged events (like `sensor.last_boot`).
+If you only want to hide events from e.g., your history, take a look at the [`history` component](/components/history/). Same goes for logbook. But if you have privacy concerns about certain events or neither want them in history or logbook, you should use the `exclude`/`include` options of the `recorder` component, that they aren't even in your database. That way you can save storage and keep the database small by excluding certain often-logged events (like `sensor.last_boot`).
### {% linkable_title Service `purge` %}
diff --git a/source/_components/remember_the_milk.markdown b/source/_components/remember_the_milk.markdown
index c7244b2f0b6..62d7deab2af 100644
--- a/source/_components/remember_the_milk.markdown
+++ b/source/_components/remember_the_milk.markdown
@@ -12,7 +12,7 @@ ha_category: Calendar
ha_release: 0.57
---
-The `Remember The Milk` (RTM) component allows you to create tasks in [remember_the_milk](https://www.rememberthemilk.com) from Home Assistant. You can use this if you want Home Assistant to send you a task that you should not forget, e.g. water the plants. The component allows you to have several RTM accounts in parallel.
+The `Remember The Milk` (RTM) component allows you to create tasks in [remember_the_milk](https://www.rememberthemilk.com) from Home Assistant. You can use this if you want Home Assistant to send you a task that you should not forget, e.g., water the plants. The component allows you to have several RTM accounts in parallel.
## {% linkable_title Setup %}
diff --git a/source/_components/remote.apple_tv.markdown b/source/_components/remote.apple_tv.markdown
index 692de767fcd..7fe3bc7f9af 100644
--- a/source/_components/remote.apple_tv.markdown
+++ b/source/_components/remote.apple_tv.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Apple TV Remote"
-description: "Instructions how to integrate Apple TV remote into Home Assistant."
+description: "Instructions on how to integrate Apple TV remote into Home Assistant."
date: 2017-06-26 20:50
sidebar: true
comments: false
diff --git a/source/_components/remote.harmony.markdown b/source/_components/remote.harmony.markdown
index cc2eba65ccd..c6178d048c9 100755
--- a/source/_components/remote.harmony.markdown
+++ b/source/_components/remote.harmony.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Harmony Hub Remote"
-description: "Instructions how to integrate Harmony Hub remotes into Home Assistant."
+description: "Instructions on how to integrate Harmony Hub remotes into Home Assistant."
date: 2016-11-05 17:00
sidebar: true
comments: false
@@ -35,7 +35,7 @@ remote:
host: 10.168.1.13
```
-You can override some default configuration values on a discovered hub (e.g. the `port` or `activity`) by adding a `configuration.yaml` setting. In this case leave the `host` setting empty so the platform will discover the host IP automatically, but set the `name` in the config to match exactly the name you have set for your Hub so the platform knows what Hub you are trying to configure.
+You can override some default configuration values on a discovered hub (e.g., the `port` or `activity`) by adding a `configuration.yaml` setting. In this case leave the `host` setting empty so the platform will discover the host IP automatically, but set the `name` in the config to match exactly the name you have set for your Hub so the platform knows what Hub you are trying to configure.
```yaml
# Example configuration.yaml entry with discovery
diff --git a/source/_components/remote.kira.markdown b/source/_components/remote.kira.markdown
index 7924da8fe7f..376d29837ae 100644
--- a/source/_components/remote.kira.markdown
+++ b/source/_components/remote.kira.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Kira Remote"
-description: "Instructions how to integrate Kira modules into Home Assistant."
+description: "Instructions on how to integrate Kira modules into Home Assistant."
date: 2017-05-07 17:00
sidebar: true
comments: false
diff --git a/source/_components/remote.markdown b/source/_components/remote.markdown
index fada23fde39..7359fae9d25 100755
--- a/source/_components/remote.markdown
+++ b/source/_components/remote.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Remotes"
-description: "Instructions how to setup your remotes with Home Assistant."
+description: "Instructions on how to setup your remotes with Home Assistant."
date: 2016-11-05 19:39
sidebar: true
comments: false
diff --git a/source/_components/rest_command.markdown b/source/_components/rest_command.markdown
index e42610fef55..44753967304 100644
--- a/source/_components/rest_command.markdown
+++ b/source/_components/rest_command.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "RESTful Command"
-description: "Instructions how to integrate REST commands into Home Assistant."
+description: "Instructions on how to integrate REST commands into Home Assistant."
date: 2018-02-24 00:00
sidebar: true
comments: false
diff --git a/source/_components/rflink.markdown b/source/_components/rflink.markdown
index 33e21132150..9940451bd4b 100644
--- a/source/_components/rflink.markdown
+++ b/source/_components/rflink.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "RFLink"
-description: "Instructions how to integrate RFLink gateway into Home Assistant."
+description: "Instructions on how to integrate RFLink gateway into Home Assistant."
date: 2016-01-04
sidebar: true
comments: false
diff --git a/source/_components/rfxtrx.markdown b/source/_components/rfxtrx.markdown
index 64c0e1dee45..046e27ac027 100644
--- a/source/_components/rfxtrx.markdown
+++ b/source/_components/rfxtrx.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "RFXtrx"
-description: "Instructions how to integrate RFXtrx into Home Assistant."
+description: "Instructions on how to integrate RFXtrx into Home Assistant."
date: 2015-10-08 10:15
sidebar: true
comments: false
@@ -24,7 +24,7 @@ rfxtrx:
Configuration variables:
-- **device** (*Required*): The path to your device, e.g. `/dev/serial/by-id/usb-RFXCOM_RFXtrx433_A1Y0NJGR-if00-port0`
+- **device** (*Required*): The path to your device, e.g., `/dev/serial/by-id/usb-RFXCOM_RFXtrx433_A1Y0NJGR-if00-port0`
- **debug** (*Optional*): If you want to receive debug output.
- **dummy** (*Optional*): Then you have need a connected drive to test your settings. Can be useful for debugging and testing.
diff --git a/source/_components/rpi_gpio.markdown b/source/_components/rpi_gpio.markdown
index 642804ffff0..31a1befde2e 100644
--- a/source/_components/rpi_gpio.markdown
+++ b/source/_components/rpi_gpio.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Raspberry Pi GPIO"
-description: "Instructions how to integrate the GPIO capability of a Raspberry Pi into Home Assistant."
+description: "Instructions on how to integrate the GPIO capability of a Raspberry Pi into Home Assistant."
date: 2016-08-30 19:00
sidebar: true
comments: false
diff --git a/source/_components/rpi_pfio.markdown b/source/_components/rpi_pfio.markdown
index 51feb22b704..1b3c4785e53 100644
--- a/source/_components/rpi_pfio.markdown
+++ b/source/_components/rpi_pfio.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "PiFace Digital I/O"
-description: "Instructions how to integrate the PiFace Digital I/O module into Home Assistant."
+description: "Instructions on how to integrate the PiFace Digital I/O module into Home Assistant."
date: 2016-05-08 15:00
sidebar: true
comments: false
diff --git a/source/_components/scene.hunterdouglas_powerview.markdown b/source/_components/scene.hunterdouglas_powerview.markdown
index 2f63ba62648..2ef810a113e 100644
--- a/source/_components/scene.hunterdouglas_powerview.markdown
+++ b/source/_components/scene.hunterdouglas_powerview.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "PowerView Scenes"
-description: "Instructions how to setup Hunter Douglas PowerView scenes within Home Assistant."
+description: "Instructions on how to setup Hunter Douglas PowerView scenes within Home Assistant."
date: 2016-03-11 16:00
sidebar: true
comments: false
diff --git a/source/_components/scene.litejet.markdown b/source/_components/scene.litejet.markdown
index fca7954e1b8..511c1cb6fa2 100644
--- a/source/_components/scene.litejet.markdown
+++ b/source/_components/scene.litejet.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "LiteJet Scenes"
-description: "Instructions how to setup LiteJet scenes within Home Assistant."
+description: "Instructions on how to setup LiteJet scenes within Home Assistant."
date: 2016-10-26 16:00
sidebar: true
comments: false
diff --git a/source/_components/scene.lutron_caseta.markdown b/source/_components/scene.lutron_caseta.markdown
index 2d10556edf5..7e07ed485e6 100644
--- a/source/_components/scene.lutron_caseta.markdown
+++ b/source/_components/scene.lutron_caseta.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Lutron Caseta Scene"
-description: "Instructions how to setup Lutron Caseta Scenes within Home Assistant."
+description: "Instructions on how to setup Lutron Caseta Scenes within Home Assistant."
date: 2017-07-28 16:00
sidebar: true
comments: false
diff --git a/source/_components/scene.markdown b/source/_components/scene.markdown
index 90c816cb1ca..4bf9f168f75 100644
--- a/source/_components/scene.markdown
+++ b/source/_components/scene.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Scenes"
-description: "Instructions how to setup scenes within Home Assistant."
+description: "Instructions on how to setup scenes within Home Assistant."
date: 2015-03-23 19:59
sidebar: true
comments: false
diff --git a/source/_components/scene.tahoma.markdown b/source/_components/scene.tahoma.markdown
index 1cb708486c3..b5cd1c42940 100644
--- a/source/_components/scene.tahoma.markdown
+++ b/source/_components/scene.tahoma.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Tahoma Scene"
-description: "Instructions how to integrate Tahoma scenes into Home Assistant."
+description: "Instructions on how to integrate Tahoma scenes into Home Assistant."
date: 2018-02-18 12:00
sidebar: true
comments: false
diff --git a/source/_components/scene.wink.markdown b/source/_components/scene.wink.markdown
index 50ef56848f4..cf8e79cf4cc 100644
--- a/source/_components/scene.wink.markdown
+++ b/source/_components/scene.wink.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Wink Scene"
-description: "Instructions how to setup the Wink scenes(shortcuts) within Home Assistant."
+description: "Instructions on how to setup the Wink scenes(shortcuts) within Home Assistant."
date: 2017-04-01 16:45
sidebar: true
comments: false
diff --git a/source/_components/script.markdown b/source/_components/script.markdown
index 52dd1110538..856b758aab8 100644
--- a/source/_components/script.markdown
+++ b/source/_components/script.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Scripts"
-description: "Instructions how to setup scripts within Home Assistant."
+description: "Instructions on how to setup scripts within Home Assistant."
date: 2015-03-23 19:59
sidebar: true
comments: false
@@ -26,7 +26,7 @@ script:
message: Current temperature is {% raw %}{{ states.sensor.temperature.state }}{% endraw %}
```
-It is vital that your system clock is correct both on your Home Assistant server and on your OTP generator device (e.g. your phone). If not, the generated codes will not match! Make sure NTP is running and syncing your time correctly before creating an issue. +It is vital that your system clock is correct both on your Home Assistant server and on your OTP generator device (e.g., your phone). If not, the generated codes will not match! Make sure NTP is running and syncing your time correctly before creating an issue.
diff --git a/source/_components/sensor.pi_hole.markdown b/source/_components/sensor.pi_hole.markdown index 809cee76ca1..f0b5dedbdb9 100644 --- a/source/_components/sensor.pi_hole.markdown +++ b/source/_components/sensor.pi_hole.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Pi-Hole Sensor" -description: "Instructions how to integrate REST sensors into Home Assistant." +description: "Instructions on how to integrate REST sensors into Home Assistant." date: 2016-09-03 16:30 sidebar: true comments: false diff --git a/source/_components/sensor.pilight.markdown b/source/_components/sensor.pilight.markdown index 276586c98c4..cae336b6d87 100644 --- a/source/_components/sensor.pilight.markdown +++ b/source/_components/sensor.pilight.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Pilight Sensor" -description: "Instructions how to integrate pilight sensors within Home Assistant." +description: "Instructions on how to integrate pilight sensors within Home Assistant." date: 2016-10-08 23:21 sidebar: true comments: false @@ -14,7 +14,7 @@ ha_iot_class: depends --- -This `pilight` sensor platform for 433 MHz devices uses a value in the message payload as the sensor value. Unique identifiers (e.g. _uuid_) can be set to distinguish between multiple pilight devices. To use a pilight sensor the pilight Home Assistant hub has to be set up. +This `pilight` sensor platform for 433 MHz devices uses a value in the message payload as the sensor value. Unique identifiers (e.g., _uuid_) can be set to distinguish between multiple pilight devices. To use a pilight sensor the pilight Home Assistant hub has to be set up. To use your sensor via pilight, make sure it is [supported](https://wiki.pilight.org/doku.php/protocols) and add the following to your `configuration.yaml` file: diff --git a/source/_components/sensor.pushbullet.markdown b/source/_components/sensor.pushbullet.markdown index df04990f68a..bd8ee0eda5a 100644 --- a/source/_components/sensor.pushbullet.markdown +++ b/source/_components/sensor.pushbullet.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Pushbullet Mirrors" -description: "Instructions how to read user pushes in Home Assistant" +description: "Instructions on how to read user pushes in Home Assistant" date: 2017-04-20 16:44 sidebar: true comments: false diff --git a/source/_components/sensor.pvoutput.markdown b/source/_components/sensor.pvoutput.markdown index b36ded0c286..a61f6614590 100644 --- a/source/_components/sensor.pvoutput.markdown +++ b/source/_components/sensor.pvoutput.markdown @@ -1,7 +1,7 @@ --- layout: page title: "PVOutput Sensor" -description: "Instructions how to use PVOutput within Home Assistant." +description: "Instructions on how to use PVOutput within Home Assistant." date: 2016-11-06 10:00 sidebar: true comments: false diff --git a/source/_components/sensor.pyload.markdown b/source/_components/sensor.pyload.markdown index c4d7611edb4..0c5886b6377 100644 --- a/source/_components/sensor.pyload.markdown +++ b/source/_components/sensor.pyload.markdown @@ -1,7 +1,7 @@ --- layout: page title: "pyLoad Sensor" -description: "Instructions how to integrate pyLoad download sensor within Home Assistant." +description: "Instructions on how to integrate pyLoad download sensor within Home Assistant." date: 2017-10-23 09:00 sidebar: true comments: false diff --git a/source/_components/sensor.qnap.markdown b/source/_components/sensor.qnap.markdown index 38dd16ca985..66dd99404be 100644 --- a/source/_components/sensor.qnap.markdown +++ b/source/_components/sensor.qnap.markdown @@ -1,7 +1,7 @@ --- layout: page title: "QNAP Sensor" -description: "Instructions how to integrate the QNAP sensor within Home Assistant." +description: "Instructions on how to integrate the QNAP sensor within Home Assistant." date: 2017-02-02 06:39 sidebar: true comments: false diff --git a/source/_components/sensor.radarr.markdown b/source/_components/sensor.radarr.markdown index 78ca33d041d..42294c86283 100644 --- a/source/_components/sensor.radarr.markdown +++ b/source/_components/sensor.radarr.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Radarr Sensor" -description: "Instructions how to integrate Radarr sensors with Home Assistant" +description: "Instructions on how to integrate Radarr sensors with Home Assistant" date: 2017-05-04 00:00 sidebar: true comments: false diff --git a/source/_components/sensor.random.markdown b/source/_components/sensor.random.markdown index c7f2bf07b13..35a52d34224 100644 --- a/source/_components/sensor.random.markdown +++ b/source/_components/sensor.random.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Random Sensor" -description: "Instructions how to integrate random number sensors into Home Assistant." +description: "Instructions on how to integrate random number sensors into Home Assistant." date: 2016-10-30 12:10 sidebar: true comments: false diff --git a/source/_components/sensor.rest.markdown b/source/_components/sensor.rest.markdown index 7d8c7513134..a41ec48ab96 100644 --- a/source/_components/sensor.rest.markdown +++ b/source/_components/sensor.rest.markdown @@ -1,7 +1,7 @@ --- layout: page title: "RESTful Sensor" -description: "Instructions how to integrate REST sensors into Home Assistant." +description: "Instructions on how to integrate REST sensors into Home Assistant." date: 2015-09-14 19:10 sidebar: true comments: false diff --git a/source/_components/sensor.rflink.markdown b/source/_components/sensor.rflink.markdown index 38b529af807..7efee12d68c 100644 --- a/source/_components/sensor.rflink.markdown +++ b/source/_components/sensor.rflink.markdown @@ -1,7 +1,7 @@ --- layout: page title: "RFLink Sensor" -description: "Instructions how to integrate RFLink sensors into Home Assistant." +description: "Instructions on how to integrate RFLink sensors into Home Assistant." date: 2016-01-04 sidebar: true comments: false diff --git a/source/_components/sensor.rfxtrx.markdown b/source/_components/sensor.rfxtrx.markdown index 9df49ee6847..91a2dd5cf13 100644 --- a/source/_components/sensor.rfxtrx.markdown +++ b/source/_components/sensor.rfxtrx.markdown @@ -1,7 +1,7 @@ --- layout: page title: "RFXtrx Sensor" -description: "Instructions how to integrate RFXtrx sensors into Home Assistant." +description: "Instructions on how to integrate RFXtrx sensors into Home Assistant." date: 2015-08-06 17:15 sidebar: true comments: false diff --git a/source/_components/sensor.ripple.markdown b/source/_components/sensor.ripple.markdown index ad960c30e53..2eda5415059 100644 --- a/source/_components/sensor.ripple.markdown +++ b/source/_components/sensor.ripple.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Ripple" -description: "Instructions how to integrate ripple.com data within Home Assistant." +description: "Instructions on how to integrate ripple.com data within Home Assistant." date: 2017-06-06 16:20 sidebar: true comments: false diff --git a/source/_components/sensor.sabnzbd.markdown b/source/_components/sensor.sabnzbd.markdown index 47680c4e1af..840eb5cd082 100644 --- a/source/_components/sensor.sabnzbd.markdown +++ b/source/_components/sensor.sabnzbd.markdown @@ -1,7 +1,7 @@ --- layout: page title: "SABnzbd" -description: "Instructions how to integrate SABnzbd within Home Assistant." +description: "Instructions on how to integrate SABnzbd within Home Assistant." date: 2015-03-23 19:59 sidebar: true comments: false diff --git a/source/_components/sensor.scrape.markdown b/source/_components/sensor.scrape.markdown index cbbaf5553e0..fc23677a883 100644 --- a/source/_components/sensor.scrape.markdown +++ b/source/_components/sensor.scrape.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Scrape Sensor" -description: "Instructions how to integrate Web scrape sensors into Home Assistant." +description: "Instructions on how to integrate Web scrape sensors into Home Assistant." date: 2016-10-12 09:10 sidebar: true comments: false diff --git a/source/_components/sensor.season.markdown b/source/_components/sensor.season.markdown index 6297420cd15..875636fb7ce 100644 --- a/source/_components/sensor.season.markdown +++ b/source/_components/sensor.season.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Season Sensor" -description: "Instructions how to add season sensors into Home Assistant." +description: "Instructions on how to add season sensors into Home Assistant." date: 2017-07-04 07:00:00 sidebar: true comments: false diff --git a/source/_components/sensor.sense.markdown b/source/_components/sensor.sense.markdown index cefa2adcbb9..e13e45dd937 100644 --- a/source/_components/sensor.sense.markdown +++ b/source/_components/sensor.sense.markdown @@ -1,7 +1,7 @@ --- layout: page title: Sense -description: "Instructions how to integrate Sense within Home Assistant." +description: "Instructions on how to integrate Sense within Home Assistant." date: 2018-01-11 13:50 sidebar: true comments: false diff --git a/source/_components/sensor.sensehat.markdown b/source/_components/sensor.sensehat.markdown index ae270f052fb..c441b4c1e6d 100644 --- a/source/_components/sensor.sensehat.markdown +++ b/source/_components/sensor.sensehat.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Sense HAT" -description: "Instructions how to integrate Sense HAT within Home Assistant." +description: "Instructions on how to integrate Sense HAT within Home Assistant." date: 2017-06-03 04:00 sidebar: true comments: false diff --git a/source/_components/sensor.serial.markdown b/source/_components/sensor.serial.markdown index ea1ad91a0b7..356ced350f5 100644 --- a/source/_components/sensor.serial.markdown +++ b/source/_components/sensor.serial.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Serial Sensor" -description: "Instructions how to integrate data from serial connected sensors into Home Assistant." +description: "Instructions on how to integrate data from serial connected sensors into Home Assistant." date: 2017-10-13 07:00 sidebar: true comments: false diff --git a/source/_components/sensor.shodan.markdown b/source/_components/sensor.shodan.markdown index e4ca7947a21..6a98ad30422 100644 --- a/source/_components/sensor.shodan.markdown +++ b/source/_components/sensor.shodan.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Shodan Sensor" -description: "Instructions how to integrate Shodan sensors into Home Assistant." +description: "Instructions on how to integrate Shodan sensors into Home Assistant." date: 2017-08-09 10:30 sidebar: true comments: false diff --git a/source/_components/sensor.smappee.markdown b/source/_components/sensor.smappee.markdown index 6a34cfb5c50..2886f2b4340 100644 --- a/source/_components/sensor.smappee.markdown +++ b/source/_components/sensor.smappee.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Smappee Sensor" -description: "Instructions how to integrate Smappee energy monitor into Home Assistant." +description: "Instructions on how to integrate Smappee energy monitor into Home Assistant." date: 2018-02-26 08:37 sidebar: true comments: false diff --git a/source/_components/sensor.snmp.markdown b/source/_components/sensor.snmp.markdown index 95429545db1..f492d5ef3a7 100644 --- a/source/_components/sensor.snmp.markdown +++ b/source/_components/sensor.snmp.markdown @@ -1,7 +1,7 @@ --- layout: page title: "SNMP" -description: "Instructions how to integrate SNMP sensors within Home Assistant." +description: "Instructions on how to integrate SNMP sensors within Home Assistant." date: 2016-06-05 20:00 sidebar: true comments: false diff --git a/source/_components/sensor.sochain.markdown b/source/_components/sensor.sochain.markdown index 77bf1c78364..26ff8d5fd1b 100644 --- a/source/_components/sensor.sochain.markdown +++ b/source/_components/sensor.sochain.markdown @@ -1,7 +1,7 @@ --- layout: page title: "SoChain" -description: "Instructions how to integrate chain.so data within Home Assistant." +description: "Instructions on how to integrate chain.so data within Home Assistant." date: 2017-06-01 16:20 sidebar: true comments: false diff --git a/source/_components/sensor.sonarr.markdown b/source/_components/sensor.sonarr.markdown index 5f4d437c02b..0257c70b55e 100644 --- a/source/_components/sensor.sonarr.markdown +++ b/source/_components/sensor.sonarr.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Sonarr Sensor" -description: "Instructions how to integrate Sonarr sensors with Home Assistant" +description: "Instructions on how to integrate Sonarr sensors with Home Assistant" date: 2016-11-19 13:35 sidebar: true comments: false diff --git a/source/_components/sensor.statistics.markdown b/source/_components/sensor.statistics.markdown index a5b126fac4a..9bfd40dd39c 100644 --- a/source/_components/sensor.statistics.markdown +++ b/source/_components/sensor.statistics.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Statistics Sensor" -description: "Instructions how to integrate statistical sensors into Home Assistant." +description: "Instructions on how to integrate statistical sensors into Home Assistant." date: 2016-09-28 12:10 sidebar: true comments: false diff --git a/source/_components/sensor.supervisord.markdown b/source/_components/sensor.supervisord.markdown index 93a191fc9cb..fc978f2f2de 100644 --- a/source/_components/sensor.supervisord.markdown +++ b/source/_components/sensor.supervisord.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Supervisord" -description: "Instructions how to integrate Supervisord within Home Assistant." +description: "Instructions on how to integrate Supervisord within Home Assistant." date: 2016-05-13 22:00 sidebar: true comments: false diff --git a/source/_components/sensor.swiss_hydrological_data.markdown b/source/_components/sensor.swiss_hydrological_data.markdown index 59f81644e2e..44f4d6100bd 100644 --- a/source/_components/sensor.swiss_hydrological_data.markdown +++ b/source/_components/sensor.swiss_hydrological_data.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Swiss Hydrological Data" -description: "Instructions how to integrate hydrological data of Swiss waters within Home Assistant." +description: "Instructions on how to integrate hydrological data of Swiss waters within Home Assistant." date: 2016-06-17 17:00 sidebar: true comments: false diff --git a/source/_components/sensor.swiss_public_transport.markdown b/source/_components/sensor.swiss_public_transport.markdown index 8b3ac28b09b..c1063e4d4a5 100644 --- a/source/_components/sensor.swiss_public_transport.markdown +++ b/source/_components/sensor.swiss_public_transport.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Swiss Public Transport" -description: "Instructions how to integrate timetable data for traveling in Switzerland within Home Assistant." +description: "Instructions on how to integrate timetable data for traveling in Switzerland within Home Assistant." date: 2015-06-02 21:45 sidebar: true comments: false diff --git a/source/_components/sensor.synologydsm.markdown b/source/_components/sensor.synologydsm.markdown index bf7a0af0d01..a15727f86df 100644 --- a/source/_components/sensor.synologydsm.markdown +++ b/source/_components/sensor.synologydsm.markdown @@ -1,7 +1,7 @@ --- layout: page title: "SynologyDSM Sensor" -description: "Instructions how to integrate the SynologyDSM sensor within Home Assistant." +description: "Instructions on how to integrate the SynologyDSM sensor within Home Assistant." date: 2016-10-30 23:21 sidebar: true comments: false diff --git a/source/_components/sensor.systemmonitor.markdown b/source/_components/sensor.systemmonitor.markdown index 9ae17d80ba0..855dca71c04 100644 --- a/source/_components/sensor.systemmonitor.markdown +++ b/source/_components/sensor.systemmonitor.markdown @@ -1,7 +1,7 @@ --- layout: page title: "System Monitor" -description: "Instructions how to monitor the Home Assistant host." +description: "Instructions on how to monitor the Home Assistant host." date: 2015-03-23 19:59 sidebar: true comments: false @@ -56,7 +56,7 @@ The table contains types and their argument to use in your `configuration.yaml` | ipv4_address | Interface, eg. `eth0` | | ipv6_address | Interface, eg. `eth0` | | processor_use | | -| process | Binary, e.g. `octave-cli` | +| process | Binary, e.g., `octave-cli` | | last_boot | | | since_last_boot | | diff --git a/source/_components/sensor.sytadin.markdown b/source/_components/sensor.sytadin.markdown index 9f23c8df3f8..1c44a9bdd3f 100644 --- a/source/_components/sensor.sytadin.markdown +++ b/source/_components/sensor.sytadin.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Sytadin Sensor" -description: "Instructions how to integrate Sytadin sensors into Home Assistant." +description: "Instructions on how to integrate Sytadin sensors into Home Assistant." date: 2017-10-05 14:00 sidebar: true comments: false diff --git a/source/_components/sensor.tahoma.markdown b/source/_components/sensor.tahoma.markdown index 7a2b960de86..d5dbf0530e7 100644 --- a/source/_components/sensor.tahoma.markdown +++ b/source/_components/sensor.tahoma.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Tahoma Sensor" -description: "Instructions how to integrate Tahoma sensors into Home Assistant." +description: "Instructions on how to integrate Tahoma sensors into Home Assistant." date: 2017-07-18 12:00 sidebar: true comments: false diff --git a/source/_components/sensor.tellduslive.markdown b/source/_components/sensor.tellduslive.markdown index 356ba316b58..4e136af4760 100644 --- a/source/_components/sensor.tellduslive.markdown +++ b/source/_components/sensor.tellduslive.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Telldus Live sensor" -description: "Instructions how to integrate Telldus Live sensors into Home Assistant." +description: "Instructions on how to integrate Telldus Live sensors into Home Assistant." date: 2016-01-17 15:49 sidebar: true comments: false diff --git a/source/_components/sensor.tellstick.markdown b/source/_components/sensor.tellstick.markdown index dc4cf5be793..789f43c37df 100644 --- a/source/_components/sensor.tellstick.markdown +++ b/source/_components/sensor.tellstick.markdown @@ -1,7 +1,7 @@ --- layout: page title: "TellStick Sensor" -description: "Instructions how to integrate TellStick sensors into Home Assistant." +description: "Instructions on how to integrate TellStick sensors into Home Assistant." date: 2015-08-06 19:00 sidebar: true comments: false diff --git a/source/_components/sensor.temper.markdown b/source/_components/sensor.temper.markdown index 227cc42f80a..09626f0984e 100644 --- a/source/_components/sensor.temper.markdown +++ b/source/_components/sensor.temper.markdown @@ -1,7 +1,7 @@ --- layout: page title: "TEMPer Sensor" -description: "Instructions how to integrate TEMPer sensors into Home Assistant." +description: "Instructions on how to integrate TEMPer sensors into Home Assistant." date: 2015-08-06 19:00 sidebar: true comments: false diff --git a/source/_components/sensor.template.markdown b/source/_components/sensor.template.markdown index 534fe54e9f7..9d1ec23a0c9 100644 --- a/source/_components/sensor.template.markdown +++ b/source/_components/sensor.template.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Template Sensor" -description: "Instructions how to integrate Template Sensors into Home Assistant." +description: "Instructions on how to integrate Template Sensors into Home Assistant." date: 2016-01-27 07:00 sidebar: true comments: false diff --git a/source/_components/sensor.thethingsnetwork.markdown b/source/_components/sensor.thethingsnetwork.markdown index 6dac17958f2..cce7aad5697 100644 --- a/source/_components/sensor.thethingsnetwork.markdown +++ b/source/_components/sensor.thethingsnetwork.markdown @@ -1,7 +1,7 @@ --- layout: page title: "The Things Network Sensor" -description: "Instructions how to integrate The Things Network sensors into Home Assistant." +description: "Instructions on how to integrate The Things Network sensors into Home Assistant." date: 2017-09-30 08:00 sidebar: true comments: false diff --git a/source/_components/sensor.thinkingcleaner.markdown b/source/_components/sensor.thinkingcleaner.markdown index d5c681ff736..af6979bed2a 100644 --- a/source/_components/sensor.thinkingcleaner.markdown +++ b/source/_components/sensor.thinkingcleaner.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Thinking Cleaner sensor" -description: "Instructions how to integrate a ThinkingCleaner sensor within Home Assistant." +description: "Instructions on how to integrate a ThinkingCleaner sensor within Home Assistant." date: 2016-04-10 17:24 sidebar: true comments: false diff --git a/source/_components/sensor.tibber.markdown b/source/_components/sensor.tibber.markdown index 6ebcc84bcf0..883c4c76696 100644 --- a/source/_components/sensor.tibber.markdown +++ b/source/_components/sensor.tibber.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Tibber" -description: "Instructions how to integrate Tibber within Home Assistant." +description: "Instructions on how to integrate Tibber within Home Assistant." date: 2017-10-03 17:00 sidebar: true comments: false diff --git a/source/_components/sensor.time_date.markdown b/source/_components/sensor.time_date.markdown index a37980565e5..ce9547358eb 100644 --- a/source/_components/sensor.time_date.markdown +++ b/source/_components/sensor.time_date.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Time & Date" -description: "Instructions how to integrate the time and the date within Home Assistant." +description: "Instructions on how to integrate the time and the date within Home Assistant." date: 2015-05-08 17:15 sidebar: true comments: false diff --git a/source/_components/sensor.toon.markdown b/source/_components/sensor.toon.markdown index fabf565aeb4..7a82ab95e9a 100644 --- a/source/_components/sensor.toon.markdown +++ b/source/_components/sensor.toon.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Toon Sensor" -description: "Instructions how to integrate Toon climate devices within Home Assistant." +description: "Instructions on how to integrate Toon climate devices within Home Assistant." date: 2017-10-22 12:00 sidebar: true comments: false diff --git a/source/_components/sensor.torque.markdown b/source/_components/sensor.torque.markdown index 87ff9e0eca2..38379ccd675 100644 --- a/source/_components/sensor.torque.markdown +++ b/source/_components/sensor.torque.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Torque (OBD2)" -description: "Instructions how to integrate Torque sensors into Home Assistant." +description: "Instructions on how to integrate Torque sensors into Home Assistant." date: 2015-12-20 18:00 sidebar: true comments: false diff --git a/source/_components/sensor.transmission.markdown b/source/_components/sensor.transmission.markdown index 4e540968339..e76da08026e 100644 --- a/source/_components/sensor.transmission.markdown +++ b/source/_components/sensor.transmission.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Transmission Sensor" -description: "Instructions how to integrate Transmission sensors within Home Assistant." +description: "Instructions on how to integrate Transmission sensors within Home Assistant." date: 2015-04-25 9:06 sidebar: true comments: false diff --git a/source/_components/sensor.twitch.markdown b/source/_components/sensor.twitch.markdown index ce0b0d051b9..6ed513ca902 100644 --- a/source/_components/sensor.twitch.markdown +++ b/source/_components/sensor.twitch.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Twitch" -description: "Instructions how to integrate Twitch sensors into Home Assistant." +description: "Instructions on how to integrate Twitch sensors into Home Assistant." date: 2015-12-19 09:00 sidebar: true comments: false diff --git a/source/_components/sensor.uk_transport.markdown b/source/_components/sensor.uk_transport.markdown index 759f37f982d..868bad19fd3 100644 --- a/source/_components/sensor.uk_transport.markdown +++ b/source/_components/sensor.uk_transport.markdown @@ -22,7 +22,7 @@ Additional sensors can be added but at the expense of a reduced refresh rate. 2 Queries are entered as a list, with the two transport modes available being `bus` and `train`. -Train departure sensors require three character long `origin` and `destination` station codes which are searchable on the [National Rail enquiries](http://www.nationalrail.co.uk/times_fares/ldb.aspx) website (e.g. `WAT` is London Waterloo). The validity of a route can be checked by performing a GET request to `/uk/train/station/{station_code}/live.json` in the [API reference webpage](https://developer.transportapi.com/docs?raml=https://transportapi.com/v3/raml/transportapi.raml##request_uk_train_station_station_code_live_json). +Train departure sensors require three character long `origin` and `destination` station codes which are searchable on the [National Rail enquiries](http://www.nationalrail.co.uk/times_fares/ldb.aspx) website (e.g., `WAT` is London Waterloo). The validity of a route can be checked by performing a GET request to `/uk/train/station/{station_code}/live.json` in the [API reference webpage](https://developer.transportapi.com/docs?raml=https://transportapi.com/v3/raml/transportapi.raml##request_uk_train_station_station_code_live_json). To add a single train departure sensor add the following to your `configuration.yaml` file: diff --git a/source/_components/sensor.uptime.markdown b/source/_components/sensor.uptime.markdown index b17f9857976..f67feb188e4 100644 --- a/source/_components/sensor.uptime.markdown +++ b/source/_components/sensor.uptime.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Uptime Sensor" -description: "Instructions how to integrate an uptime sensor into Home Assistant." +description: "Instructions on how to integrate an uptime sensor into Home Assistant." date: 2017-10-13 10:30 sidebar: true comments: false diff --git a/source/_components/sensor.vasttrafik.markdown b/source/_components/sensor.vasttrafik.markdown index a5aad007bda..0217a91c6ab 100644 --- a/source/_components/sensor.vasttrafik.markdown +++ b/source/_components/sensor.vasttrafik.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Västtrafik Public Transport" -description: "Instructions how to integrate timetable data for traveling in Sweden within Home Assistant." +description: "Instructions on how to integrate timetable data for traveling in Sweden within Home Assistant." date: 2016-10-05 08:45 sidebar: true comments: false diff --git a/source/_components/sensor.vera.markdown b/source/_components/sensor.vera.markdown index c1e7b16a374..0fbdf0ff316 100644 --- a/source/_components/sensor.vera.markdown +++ b/source/_components/sensor.vera.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Vera Sensor" -description: "Instructions how to integrate Vera sensors into Home Assistant." +description: "Instructions on how to integrate Vera sensors into Home Assistant." date: 2015-10-20 21:00 sidebar: true comments: false diff --git a/source/_components/sensor.verisure.markdown b/source/_components/sensor.verisure.markdown index 75a4676365c..8ee60938a92 100644 --- a/source/_components/sensor.verisure.markdown +++ b/source/_components/sensor.verisure.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Verisure Sensor" -description: "Instructions how to integrate Verisure sensors into Home Assistant." +description: "Instructions on how to integrate Verisure sensors into Home Assistant." date: 2016-02-23 21:31 +0100 sidebar: true comments: false diff --git a/source/_components/sensor.version.markdown b/source/_components/sensor.version.markdown index 3f8eaa196e4..a84c05f7a27 100644 --- a/source/_components/sensor.version.markdown +++ b/source/_components/sensor.version.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Version Sensor" -description: "Instructions how to integrate a version sensor into Home Assistant." +description: "Instructions on how to integrate a version sensor into Home Assistant." date: 2017-08-10 10:30 sidebar: true comments: false diff --git a/source/_components/sensor.waqi.markdown b/source/_components/sensor.waqi.markdown index ce920cfeff2..a3fd05aab8d 100644 --- a/source/_components/sensor.waqi.markdown +++ b/source/_components/sensor.waqi.markdown @@ -1,7 +1,7 @@ --- layout: page title: "World Air Quality Index" -description: "Instructions how to setup World Air Quality Index sensor in Home Assistant." +description: "Instructions on how to setup World Air Quality Index sensor in Home Assistant." date: 2016-11-17 06:00 sidebar: true comments: false diff --git a/source/_components/sensor.wink.markdown b/source/_components/sensor.wink.markdown index 5a54a704243..7300fd8d65c 100644 --- a/source/_components/sensor.wink.markdown +++ b/source/_components/sensor.wink.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Wink Sensor" -description: "Instructions how to setup the Wink sensors within Home Assistant." +description: "Instructions on how to setup the Wink sensors within Home Assistant." date: 2015-01-20 22:36 sidebar: true comments: false diff --git a/source/_components/sensor.worldclock.markdown b/source/_components/sensor.worldclock.markdown index e9f4ac8f9bf..c35d652f10c 100644 --- a/source/_components/sensor.worldclock.markdown +++ b/source/_components/sensor.worldclock.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Worldclock" -description: "Instructions how to integrate a Worldclock within Home Assistant." +description: "Instructions on how to integrate a Worldclock within Home Assistant." date: 2015-10-02 11:15 sidebar: true comments: false diff --git a/source/_components/sensor.worldtidesinfo.markdown b/source/_components/sensor.worldtidesinfo.markdown index 955f380d4a8..1b5dca31857 100644 --- a/source/_components/sensor.worldtidesinfo.markdown +++ b/source/_components/sensor.worldtidesinfo.markdown @@ -1,7 +1,7 @@ --- layout: page title: "World Tides" -description: "Instructions how to add Tides information to Home Assistant." +description: "Instructions on how to add Tides information to Home Assistant." date: 2017-08-23 08:00 sidebar: true comments: false diff --git a/source/_components/sensor.worxlandroid.markdown b/source/_components/sensor.worxlandroid.markdown index 5f52ac95d9d..5497ae70057 100644 --- a/source/_components/sensor.worxlandroid.markdown +++ b/source/_components/sensor.worxlandroid.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Worx Landroid" -description: "Instructions how to integrate Worx Landroid WG796E.1 or WG797E as sensors within Home Assistant." +description: "Instructions on how to integrate Worx Landroid WG796E.1 or WG797E as sensors within Home Assistant." date: 2017-09-12 13:23 sidebar: true comments: false diff --git a/source/_components/sensor.wunderground.markdown b/source/_components/sensor.wunderground.markdown index 4183dfa0b08..d86dd629355 100644 --- a/source/_components/sensor.wunderground.markdown +++ b/source/_components/sensor.wunderground.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Weather Underground (WUnderground)" -description: "Instructions how to integrate Weather Underground (WUnderground) Weather within Home Assistant." +description: "Instructions on how to integrate Weather Underground (WUnderground) Weather within Home Assistant." date: 2016-08-18 sidebar: true comments: false @@ -86,7 +86,7 @@ Configuration variables: - **weather**: A human-readable text summary with picture from Wunderground. - **weather_1d** [[12h]](#12h): A human-readable weather forecast using imperial units. - **weather_1d_metric** [[12h]](#12h): A human-readable weather forecast using metric units. - - **weather_1h** [[1h]](#1h): Weather conditions in 1 hour. (e.g. "Thunderstorm" etc.) + - **weather_1h** [[1h]](#1h): Weather conditions in 1 hour. (e.g., "Thunderstorm" etc.) - **wind_degrees**: Wind degrees - **wind_dir**: Wind direction - **wind_gust_kph**: Wind gusts speed in kph @@ -105,7 +105,7 @@ All the conditions listed above will be updated every 5 minutes. _12 hour forecasts_ -Monitored conditions marked above with [12h] are 12 hour forecasts. To get a forecast for different period/daytime replace the `_1d_` part of the sensor name. e.g. `weather_2n` will give you forecast for tomorrow night. Valid values for day are `1` to `4` and valid values for daytime are `d` or `n`. +Monitored conditions marked above with [12h] are 12 hour forecasts. To get a forecast for different period/daytime replace the `_1d_` part of the sensor name. e.g., `weather_2n` will give you forecast for tomorrow night. Valid values for day are `1` to `4` and valid values for daytime are `d` or `n`. _Daily forecasts_ @@ -115,7 +115,7 @@ in `_1d_` part of the sensor name. Valid values are from `1` to `4`. _Hourly forecasts_ Conditions marked with [1h] are hourly forecasts. To get forecast for different hour, replace the number -in the `_1h_` part of the sensor name with `1` to `36`. E.g. `weather_24h` will give you weather in 24 hours. +in the `_1h_` part of the sensor name with `1` to `36`. e.g., `weather_24h` will give you weather in 24 hours. ### {% linkable_title Additional examples %} diff --git a/source/_components/sensor.xiaomi_aqara.markdown b/source/_components/sensor.xiaomi_aqara.markdown index 247a9a94c9e..a69c4f685af 100644 --- a/source/_components/sensor.xiaomi_aqara.markdown +++ b/source/_components/sensor.xiaomi_aqara.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Xiaomi Sensor" -description: "Instructions how to setup the Xiaomi sensor within Home Assistant." +description: "Instructions on how to setup the Xiaomi sensor within Home Assistant." date: 2017-07-21 16:34 sidebar: true comments: false diff --git a/source/_components/sensor.yahoo_finance.markdown b/source/_components/sensor.yahoo_finance.markdown index 8a55a78dda7..0e8d12c0fbe 100644 --- a/source/_components/sensor.yahoo_finance.markdown +++ b/source/_components/sensor.yahoo_finance.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Yahoo Finance" -description: "Instructions how to setup Yahoo Finance within Home Assistant." +description: "Instructions on how to setup Yahoo Finance within Home Assistant." date: 2016-09-18 21:00 sidebar: true comments: false diff --git a/source/_components/sensor.yr.markdown b/source/_components/sensor.yr.markdown index 35813cb4598..772fa6560e1 100644 --- a/source/_components/sensor.yr.markdown +++ b/source/_components/sensor.yr.markdown @@ -1,7 +1,7 @@ --- layout: page title: "YR" -description: "Instructions how to integrate Yr.no within Home Assistant." +description: "Instructions on how to integrate Yr.no within Home Assistant." date: 2016-01-04 14:00 sidebar: true comments: false diff --git a/source/_components/sensor.yweather.markdown b/source/_components/sensor.yweather.markdown index 0f9bcd7a859..fdd5a38b808 100644 --- a/source/_components/sensor.yweather.markdown +++ b/source/_components/sensor.yweather.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Yahoo Weather Sensor" -description: "Instructions how to integrate Yahoo Weather within Home Assistant." +description: "Instructions on how to integrate Yahoo Weather within Home Assistant." date: 2016-07-06 9:06 sidebar: true comments: false diff --git a/source/_components/sensor.zabbix.markdown b/source/_components/sensor.zabbix.markdown index daf65e1a784..64e960ed61d 100644 --- a/source/_components/sensor.zabbix.markdown +++ b/source/_components/sensor.zabbix.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Zabbix Sensor" -description: "Instructions how to integrate Zabbix Triggers sensors within Home Assistant." +description: "Instructions on how to integrate Zabbix Triggers sensors within Home Assistant." date: 2016-12-13 22:57 sidebar: true comments: false diff --git a/source/_components/sensor.zamg.markdown b/source/_components/sensor.zamg.markdown index 9c6558a5693..014752a66ec 100644 --- a/source/_components/sensor.zamg.markdown +++ b/source/_components/sensor.zamg.markdown @@ -1,7 +1,7 @@ --- layout: page title: "ZAMG Sensor" -description: "Instructions how to integrate ZAMG sensors within Home Assistant." +description: "Instructions on how to integrate ZAMG sensors within Home Assistant." date: 2016-12-06 08:00 sidebar: true comments: false diff --git a/source/_components/sensor.zwave.markdown b/source/_components/sensor.zwave.markdown index 2b22c7cce9d..70fba841c58 100644 --- a/source/_components/sensor.zwave.markdown +++ b/source/_components/sensor.zwave.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Z-Wave Sensor" -description: "Instructions how to setup the Z-Wave sensors within Home Assistant." +description: "Instructions on how to setup the Z-Wave sensors within Home Assistant." date: 2015-11-15 13:00 sidebar: true comments: false diff --git a/source/_components/shell_command.markdown b/source/_components/shell_command.markdown index d9f64f8a072..8c03c7c7af2 100644 --- a/source/_components/shell_command.markdown +++ b/source/_components/shell_command.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Shell command" -description: "Instructions how to integrate Shell commands into Home Assistant." +description: "Instructions on how to integrate Shell commands into Home Assistant." date: 2015-10-13 19:10 sidebar: true comments: false diff --git a/source/_components/smappee.markdown b/source/_components/smappee.markdown index 4bd050ad224..5e35f4866fa 100644 --- a/source/_components/smappee.markdown +++ b/source/_components/smappee.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Smappee" -description: "Instructions how to setup Smappee within Home Assistant." +description: "Instructions on how to setup Smappee within Home Assistant." date: 2018-02-26 08:37 sidebar: true comments: false diff --git a/source/_components/snips.markdown b/source/_components/snips.markdown index 6f876effdd2..da7ed214172 100644 --- a/source/_components/snips.markdown +++ b/source/_components/snips.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Snips" -description: "Instructions how to integrate Snips within Home Assistant." +description: "Instructions on how to integrate Snips within Home Assistant." date: 2017-06-22 12:00 sidebar: true comments: false diff --git a/source/_components/spc.markdown b/source/_components/spc.markdown index 15731743299..0e8819fb854 100644 --- a/source/_components/spc.markdown +++ b/source/_components/spc.markdown @@ -1,7 +1,7 @@ --- layout: page title: "SPC" -description: "Instructions how to setup Vanderbilt SPC devices within Home Assistant." +description: "Instructions on how to setup Vanderbilt SPC devices within Home Assistant." date: 2017-05-18 08:00 sidebar: true comments: false @@ -27,8 +27,8 @@ spc: Configuration variables: -- **api_url** (*Required*): URL of the SPC Web Gateway command REST API, e.g. `http://
-If you are running a Mosquitto instance on the same server as Home Assistant then you must ensure that the Mosquitto service starts before Home Assistant. For a Linux instance running Systemd (Raspberry Pi, Debian, Ubuntu and others) then you should edit the file /etc/systemd/system/home-assistant@homeassistant.service as root (e.g. sudo nano /etc/systemd/system/home-assistant@homeassistant.service) and add the mosquitto service:
+If you are running a Mosquitto instance on the same server as Home Assistant then you must ensure that the Mosquitto service starts before Home Assistant. For a Linux instance running Systemd (Raspberry Pi, Debian, Ubuntu and others) then you should edit the file /etc/systemd/system/home-assistant@homeassistant.service as root (e.g., sudo nano /etc/systemd/system/home-assistant@homeassistant.service) and add the mosquitto service:
```
[Unit]
Description=Home Assistant
diff --git a/source/_docs/mqtt/certificate.markdown b/source/_docs/mqtt/certificate.markdown
index bf410b916af..252e0a5160a 100644
--- a/source/_docs/mqtt/certificate.markdown
+++ b/source/_docs/mqtt/certificate.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "MQTT Certificate"
-description: "Instructions how to setup MQTT with a certificate in Home Assistant."
+description: "Instructions on how to setup MQTT with a certificate in Home Assistant."
date: 2015-08-07 18:00
sidebar: true
comments: false
diff --git a/source/_docs/mqtt/discovery.markdown b/source/_docs/mqtt/discovery.markdown
index 3242a5f86d2..60974c428b0 100644
--- a/source/_docs/mqtt/discovery.markdown
+++ b/source/_docs/mqtt/discovery.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "MQTT Discovery"
-description: "Instructions how to setup MQTT Discovery within Home Assistant."
+description: "Instructions on how to setup MQTT Discovery within Home Assistant."
date: 2015-08-07 18:00
sidebar: true
comments: false
diff --git a/source/_docs/mqtt/logging.markdown b/source/_docs/mqtt/logging.markdown
index 999e24988f0..d4deaf4f48e 100644
--- a/source/_docs/mqtt/logging.markdown
+++ b/source/_docs/mqtt/logging.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "MQTT Logging"
-description: "Instructions how to setup MQTT Logging within Home Assistant."
+description: "Instructions on how to setup MQTT Logging within Home Assistant."
date: 2015-08-07 18:00
sidebar: true
comments: false
diff --git a/source/_docs/mqtt/processing_json.markdown b/source/_docs/mqtt/processing_json.markdown
index 552dd081676..8afb951f8e6 100644
--- a/source/_docs/mqtt/processing_json.markdown
+++ b/source/_docs/mqtt/processing_json.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Processing JSON"
-description: "Instructions how to process the MQTT payload."
+description: "Instructions on how to process the MQTT payload."
date: 2015-08-07 18:00
sidebar: true
comments: false
diff --git a/source/_docs/mqtt/service.markdown b/source/_docs/mqtt/service.markdown
index d751856fe4c..941d79e7b78 100644
--- a/source/_docs/mqtt/service.markdown
+++ b/source/_docs/mqtt/service.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "MQTT Publish service"
-description: "Instructions how to setup the MQTT Publish service within Home Assistant."
+description: "Instructions on how to setup the MQTT Publish service within Home Assistant."
date: 2015-08-07 18:00
sidebar: true
comments: false
diff --git a/source/_docs/mqtt/testing.markdown b/source/_docs/mqtt/testing.markdown
index f71ac52e2f1..e6c87bdbfcd 100644
--- a/source/_docs/mqtt/testing.markdown
+++ b/source/_docs/mqtt/testing.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "MQTT Testing"
-description: "Instructions how to test your MQTT setup."
+description: "Instructions on how to test your MQTT setup."
date: 2015-08-07 18:00
sidebar: true
comments: false
diff --git a/source/_docs/scripts.markdown b/source/_docs/scripts.markdown
index 5c39a604ab0..37d13d8507f 100644
--- a/source/_docs/scripts.markdown
+++ b/source/_docs/scripts.markdown
@@ -102,7 +102,7 @@ It is also possible to use dummy variables, e.g., in scripts, when using `wait_t
{% raw %}
```yaml
-# Service call, e.g. from an automation.
+# Service call, e.g., from an automation.
service: script.do_something
data_template:
dummy: "{{ input_boolean.switch }}"
diff --git a/source/_docs/scripts/service-calls.markdown b/source/_docs/scripts/service-calls.markdown
index b1b18333403..ab73aad5290 100644
--- a/source/_docs/scripts/service-calls.markdown
+++ b/source/_docs/scripts/service-calls.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Service Calls"
-description: "Instructions how to call services in Home Assistant."
+description: "Instructions on how to call services in Home Assistant."
date: 2016-03-12 12:00 -0800
sidebar: true
comments: false
diff --git a/source/_docs/z-wave/installation.markdown b/source/_docs/z-wave/installation.markdown
index 5974c16a201..da8848899ae 100644
--- a/source/_docs/z-wave/installation.markdown
+++ b/source/_docs/z-wave/installation.markdown
@@ -140,7 +140,7 @@ Or, if there is no result, try to find detailed USB connection info with:
$ dmesg | grep USB
```
-If Home Assistant (`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:
```bash
$ sudo usermod -a -G dialout homeassistant
diff --git a/source/_docs/z-wave/services.markdown b/source/_docs/z-wave/services.markdown
index 0a6499d2d4e..b6c420a91bc 100644
--- a/source/_docs/z-wave/services.markdown
+++ b/source/_docs/z-wave/services.markdown
@@ -29,7 +29,7 @@ The `zwave` component exposes multiple services to help maintain the network. Al
| remove_failed_node | Remove a failed node from the network. The Node should be on the controller's Failed Node List, otherwise this command will fail. |
| replace_failed_node | Replace a failed device with another. If the node is not in the controller's Failed Node List, or the node responds, this command will fail. |
| reset_node_meters | Reset a node's meter values. Only works if the node supports this. |
-| set_config_parameter | Lets the user set a config parameter to a node. NOTE: Use the parameter option's `label` string as the `value` for list parameters (e.g. `"value": "Off"`). For all other parameters use the relevant integer `value` (e.g. `"value": 1`). |
+| set_config_parameter | Lets the user set a config parameter to a node. NOTE: Use the parameter option's `label` string as the `value` for list parameters (e.g., `"value": "Off"`). For all other parameters use the relevant integer `value` (e.g., `"value": 1`). |
| soft_reset | Tells the controller to do a "soft reset." This is not supposed to lose any data, but different controllers can behave differently to a "soft reset" command. |
| start_network | Starts the Z-Wave network. |
| stop_network | Stops the Z-Wave network. |
diff --git a/source/_posts/2015-08-09-mqtt-raspberry-pi-squeezebox-asuswrt-support.markdown b/source/_posts/2015-08-09-mqtt-raspberry-pi-squeezebox-asuswrt-support.markdown
index 14d83f62020..2707b3e7f0f 100644
--- a/source/_posts/2015-08-09-mqtt-raspberry-pi-squeezebox-asuswrt-support.markdown
+++ b/source/_posts/2015-08-09-mqtt-raspberry-pi-squeezebox-asuswrt-support.markdown
@@ -104,7 +104,7 @@ sensor:
device: PATH_TO_DEVICE
```
-The path to your device, e.g. `/dev/serial/by-id/usb-RFXCOM_RFXtrx433_A1Y0NJGR-if00-port0`
+The path to your device, e.g., `/dev/serial/by-id/usb-RFXCOM_RFXtrx433_A1Y0NJGR-if00-port0`
__TEMPer temperature sensor support__
Support for Temper temperature sensors has been contributed by [@rkabadi](https://github.com/rkabadi).
diff --git a/source/_posts/2016-02-09-Smarter-Smart-Things-with-MQTT-and-Home-Assistant.markdown b/source/_posts/2016-02-09-Smarter-Smart-Things-with-MQTT-and-Home-Assistant.markdown
index 2420da03999..a9deb4a4d10 100644
--- a/source/_posts/2016-02-09-Smarter-Smart-Things-with-MQTT-and-Home-Assistant.markdown
+++ b/source/_posts/2016-02-09-Smarter-Smart-Things-with-MQTT-and-Home-Assistant.markdown
@@ -169,7 +169,7 @@ homeassistant:
- mqtt
```
-This will start home-assistant, MQTT, and the Bridge, in dependency order. All config can reference the name of the docker container instead of using IP addresses (e.g. mqtt for the broker host in Home Assistant).
+This will start home-assistant, MQTT, and the Bridge, in dependency order. All config can reference the name of the docker container instead of using IP addresses (e.g., mqtt for the broker host in Home Assistant).
### How it works
diff --git a/source/_posts/2016-04-30-ibeacons-part-1-making-presence-detection-work-better.markdown b/source/_posts/2016-04-30-ibeacons-part-1-making-presence-detection-work-better.markdown
index 465e5278a2b..ad68eb66fb0 100644
--- a/source/_posts/2016-04-30-ibeacons-part-1-making-presence-detection-work-better.markdown
+++ b/source/_posts/2016-04-30-ibeacons-part-1-making-presence-detection-work-better.markdown
@@ -26,7 +26,7 @@ Luckily, OwnTracks supports iBeacons so I could use them to make presence detect
### {% linkable_title Getting Started %}
-To do this you first need to set up [MQTT] and [OwnTracks] in Home assistant - and make sure that HA can track your phone.
+To do this you first need to set up [MQTT] and [OwnTracks] in Home Assistant - and make sure that HA can track your phone.
[MQTT]: /components/mqtt/#picking-a-broker
[OwnTracks]: /components/device_tracker.owntracks/
@@ -57,7 +57,7 @@ Once you’ve created the zone - you need to restart HA. The next step is:-
1. Go to the OwnTracks app on your phone
2. Touch the `Regions` menu at the bottom of the screen
3. Touch the `+` symbol at the top right of the screen
-4. Give the beacon a name e.g. `-drive` ’(start the name with a `-` see below for the reason)
+4. Give the beacon a name e.g., `-drive` ’(start the name with a `-` see below for the reason)
5. Turn Share to `On`
6. Skip the `Circular Region` section
7. Enter the `UUID` of your beacon - this may be written on your beacon - or you can copy it from the management app that came with your iBeacon device. It’s a long number – so it’s easier to copy if you can!
diff --git a/source/_posts/2016-08-16-we-have-apps-now.markdown b/source/_posts/2016-08-16-we-have-apps-now.markdown
index 6edf3f8f4b2..e970b9a17ea 100644
--- a/source/_posts/2016-08-16-we-have-apps-now.markdown
+++ b/source/_posts/2016-08-16-we-have-apps-now.markdown
@@ -32,7 +32,7 @@ So why `AppDaemon`? `AppDaemon` is not meant to replace Home Assistant Automatio
- New paradigm - some problems require a procedural and/or iterative approach, and `AppDaemon` Apps are a much more natural fit for this. Recent enhancements to Home Assistant scripts and templates have made huge strides, but for the most complex scenarios, Apps can do things that Automations can't
- Ease of use - `AppDaemon`'s API is full of helper functions that make programming as easy and natural as possible. The functions and their operation are as "Pythonic" as possible, experienced Python programmers should feel right at home.
-- Reuse - write a piece of code once and instantiate it as an app as many times as you need with different parameters e.g. a motion light program that you can use in 5 different places around your home. The code stays the same, you just dynamically add new instances of it in the config file
+- Reuse - write a piece of code once and instantiate it as an app as many times as you need with different parameters e.g., a motion light program that you can use in 5 different places around your home. The code stays the same, you just dynamically add new instances of it in the config file
- Dynamic - `AppDaemon` has been designed from the start to enable the user to make changes without requiring a restart of Home Assistant, thanks to its loose coupling. However, it is better than that - the user can make changes to code and `AppDaemon` will automatically reload the code, figure out which Apps were using it and restart them to use the new code without the need to restart `AppDaemon` itself. It is also possible to change parameters for an individual or multiple apps and have them picked up dynamically, and for a final trick, removing or adding apps is also picked up dynamically. Testing cycles become a lot more efficient as a result.
- Complex logic - Python's If/Else constructs are clearer and easier to code for arbitrarily complex nested logic
- Durable variables and state - variables can be kept between events to keep track of things like the number of times a motion sensor has been activated, or how long it has been since a door opened
diff --git a/source/_posts/2017-11-04-release-57.markdown b/source/_posts/2017-11-04-release-57.markdown
index dc054b035ce..f3609811356 100644
--- a/source/_posts/2017-11-04-release-57.markdown
+++ b/source/_posts/2017-11-04-release-57.markdown
@@ -120,7 +120,7 @@ Experiencing issues introduced by this release? Please report them in our [issue
This fixes errors when an entity has an attribute that is not "a string, bytearray, int, float or None" and mqtt_statestream is used. As of now, the attribute is just handed over to paho, and paho can only send the aforementioned types. This patch fixes the issue by just casting everything to string before handing it over to paho.
- There are a number of components / entities which have "other" attributes, e.g. light that have an RGB attribute which is a list. ([@tinloaf] - [#9872]) ([mqtt_statestream docs]) (breaking change)
+ There are a number of components / entities which have "other" attributes, e.g., light that have an RGB attribute which is a list. ([@tinloaf] - [#9872]) ([mqtt_statestream docs]) (breaking change)
- Generic thermostat: the configuration option `tolerance` has been removed and has been replaced by `cold_tolerance` and `hot_tolerance`. This allows on and off states to have different error bands. ([@biggms] - [#9843]) ([climate.generic_thermostat docs]) (breaking change)
- Developers only: frontend has been refactored. The method `register_panel` has been turned into a coroutine function called `async_register_panel`. The parameter `url_path` has been renamed to `frontend_url_path`. For frontend, development, you no longer pass `development: 1` to the http component but instead configure the frontend component to be in development mode by pointing it at a local checkout of the Polymer repo: ([@balloob] - [#9915]) (breaking change)
diff --git a/source/developers/code_review_platform.markdown b/source/developers/code_review_platform.markdown
index 96f78c60a0c..00ab599c1b3 100644
--- a/source/developers/code_review_platform.markdown
+++ b/source/developers/code_review_platform.markdown
@@ -28,7 +28,7 @@ Not all existing platforms follow the requirements in this checklist. This canno
### {% linkable_title 3. Configuration %}
1. Voluptuous schema present for config validation
- 2. Voluptuous schema extends schema from component
-The Android app for OwnTracks is no longer developed or supported, Zanzito is a drop in replacement for OwnTracks MQTT.
+The Android app for OwnTracks is no longer developed or supported, Zanzito is a drop in replacement for OwnTracks MQTT.
+See Instructions
Listing above and below together means the numeric_state has to be between the two values.
-In the example above, a numeric_state that is 17.1-24.9 would fire this trigger.
+In the example above, a numeric_state that goes to 17.1-24.9 (from 17 or below, or 25 or above)
+would fire this trigger.
-As of version 0.42 you have to set an initial state in your automations in order for Home Assistant to restore them upon restart.
+You have to set an initial state in your automations in order for Home Assistant to enable them upon restart.
```text
+automation:
- alias: Automation Name
initial_state: True
trigger:
...
```
-
-
-The Android app for OwnTracks is no longer developed or supported, Zanzito is a drop in replacement for OwnTracks MQTT.
-See Instructions
+
-If you are using Hass.io, do not use this guide. Instead, use the [DuckDNS add-on](/addons/duckdns/) to automatically maintain a subdomain including HTTPS certificates via Let's Encrypt.
+If you are using Hass.io or Hassbian, do not use this guide. Instead, use the [DuckDNS add-on](/addons/duckdns/) for Hass.io or the [DuckDNS suite](https://github.com/home-assistant/hassbian-scripts/blob/master/docs/duckdns.md) for Hassbian to automatically maintain a subdomain including HTTPS certificates via Let's Encrypt.
@@ -29,9 +29,9 @@ This guide was added by mf_social on 16/03/2017 and was valid at the time of wri
* If you are not using Home Assistant on a Debian/Raspian/Hassbian system you will be able to convert any of the terminology I use in to the correct syntax for your system.
* You understand that this is a 'guide' covering the general application of these things to the general masses and there are things outside of the scope of it, and it does not cover every eventuality (although I have made some notes where people may stumble). Also, I have used some turns of phrase to make it easier to understand for the novice reader which people of advanced knowledge may say is innacurate. My goal here is to get you through this guide with a satisfactory outcome and have a decent understanding of what you are doing and why, not to teach you advanced internet communication protocols.
* Each step presumes you have fully completed the previous step successfully, so if you did an earlier step following a different guide, please ensure that you have not missed anything out that may affect the step you have jumped to, and ensure that you adapt any commands to take in to account different file placements from other guides.
-
+
Steps we will take:
-
+
- 0 - Gain a basic level of understanding around IP addresses, port numbers and port forwarding
- 1 - Set your device to have a static IP address
- 2 - Set up port forwarding without TLS/SSL and test connection
@@ -42,48 +42,48 @@ Steps we will take:
- 7 - Set up a sensor to monitor the expiry date of the certificate
- 8 - Set up an automatic renewal of the TLS/SSL certificate
- 9 - Set up an alert to warn us if something went wrong
-
+
### {% linkable_title 0 - Gain a basic level of understanding around IP addresses, port numbers and port forwarding %}
-
+
An IP address is a bit like a phone number. When you access your Home Assistant instance you type something similar to 192.168.0.200:8123 in to your address bar of your browser. The bit before the colon is the IP address (in this case 192.168.0.200) and the bit after is the port number (in this case 8123). When you SSH in to the device running Home Assistant you will use the same IP address, and you will use port 22. You may not be aware that you are using port 22, but if you are using Putty look in the box next to where you type the IP address, you will see that it has already selected port 22 for you.
-
+
So, if an IP address is like a phone number, a port number is like an extension number. An analogy would be if you phone your local doctors on 192-1680-200 and the receptionist answers, you ask to speak to Dr. Smith and she will put you through to extension 8123, which is the phone Dr. Smith is sitting at. The doctors surgery is the device your Home Assistant is running on, Dr. Smith is your Home Assistant. Thusly, your Home Assistant instance is 'waiting for your call' on port 8123, at the device IP 192.168.0.200 .
-
+
Now, to speak to the outside world your connection goes through a router. Your router will have two IP addresses. One is the internal network number, most likely 192.168.0.1 in my example, and an external IP address that incoming traffic is sent to. In the example of calling the doctors, the external IP is your telephone number's area code.
-
+
So, when we want to connect to our Home Assistant instance from outside our network we will need to call the correct extension number, at the correct phone number, in the correct area code.
-
+
We will be looking for a system to run like this (in this example I will pretend our external IP is 12.12.12.12):
-
+
```text
Outside world -> 12.12.12.12:8123 -> your router -> 192.168.0.200:8123
```
Sounds simple? It really is except for two small, but easy to overcome, complications:
-
+
* IP addresses are often dynamically allocated, so they can change.
* Because of the way the internet works you cannot chain IP addresses together to get from where you are, to where you want to go.
-
+
To get around the issue of changing IP addresses we must remember that there are two IP addresses affected. Your external one (which we will 'call' to get on to your network from the internet) and your internal one (192.168.0.200 in the example I am currently using).
-
+
So, we can use a static IP to ensure that whenever our device running Home Assistant connects to our router it always uses the same address. This way our internal IP never changes. This is covered in step 1 below.
-
+
We then have no control over our external IP, as our Service Provider will give us a new one at random intervals. To fix this we will use a service called DuckDNS which will give us a name for our connection (something like examplehome.duckdns.org) and behind the scenes will continue to update your external IP. So no matter how many times the IP address changes, typing examplehome.duckdns.org in to our browser will convert to the correct, up-to-date, IP address. This is covered in step 3 below.
-
+
To get around the issue of not being able to chain the IP addresses together (I can't say I want to call 12:12:12:12 and be put through to 192.168.0.200, and then be put through to extension 8123) we use port forwarding. Port forwarding is the process of telling your router which device to allow the outside connection to speak to. In the doctors surgery example, port forwarding is the receptionist. This takes a call from outside, and forwards it to the correct extension number inside. It is important to note that port forwarding can forward an incoming request for one port to a different port on your internal network if you so choose, and we will be doing this later on. The end result being that when we have our TSL/SSL certificate our incoming call will be requesting port 443 (because that is the SSL port, like the SSH port is always 22), but our port forwarding rule will forward this to our HA instance on port 8123. When this guide is completed we will run something like this:
-
+
```text
Outside world -> https://examplehome.duckdns.org -> 12.12.12.12:443 -> your router -> 192.168.0.200:8123
```
So, let's make it happen...
### {% linkable_title 1 - Set your device to have a static IP address %}
-
+
Whenever a device is connected to a network it has an IP address. This IP address is often dynamically assigned to the device on connection. This means there are occasions where the IP address you use to access Home Assistant, or SSH in to the device running Home Assistant, may change. Setting a static IP address means that the device will always be on the same address.
-
+
SSH in to your system running Home Assistant and login.
-
+
Type the following command to list your network interfaces:
-
+
```bash
$ ifconfig
```
@@ -94,17 +94,17 @@ You will receive an output similar to the image below:
Please remember to ensure you're using an [appropriate power supply](https://www.raspberrypi.org/help/faqs/#powerReqs) with your Pi. Mobile chargers may not be suitable, since some are designed to only provide the full power with that manufacturer's handsets.
-You can also use `hassbian-config` to automate the process by running `sudo hassbian-config upgrade home-assistant`
+You can use `hassbian-config` to automate the process by running `sudo hassbian-config upgrade homeassistant`
(e.g. `light.hue.PLATFORM_SCHEMA` extends `light.PLATFORM_SCHEMA`)
+ 2. Voluptuous schema extends schema from component
(e.g., `light.hue.PLATFORM_SCHEMA` extends `light.PLATFORM_SCHEMA`)
3. Default parameters specified in voluptuous schema, not in `setup_platform(…)`
4. Your `PLATFORM_SCHEMA` should use as many generic config keys as possible from `homeassistant.const`
```python
@@ -58,7 +58,7 @@ Not all existing platforms follow the requirements in this checklist. This canno
### {% linkable_title 5. Entity %}
- 1. Extend entity from component, e.g. `class HueLight(Light)`
+ 1. Extend entity from component, e.g., `class HueLight(Light)`
2. Do not call `update()` in constructor, use `add_devices(devices, True)` instead.
3. Do not do any I/O inside properties. Cache values inside `update()` instead.
4. The state and/or attributes should not contain relative time since something happened. Instead it should store UTC timestamps.
diff --git a/source/developers/component_deps_and_reqs.markdown b/source/developers/component_deps_and_reqs.markdown
index 750f6b6c852..2a6ae27d0e1 100644
--- a/source/developers/component_deps_and_reqs.markdown
+++ b/source/developers/component_deps_and_reqs.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Requirements & Dependencies"
-description: "Instructions how to define requirements and dependencies."
+description: "Instructions on how to define requirements and dependencies."
date: 2016-04-16 13:32
sidebar: true
comments: false
diff --git a/source/developers/component_events.markdown b/source/developers/component_events.markdown
index 485bc2863c8..ee2e281b1f3 100644
--- a/source/developers/component_events.markdown
+++ b/source/developers/component_events.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Handling events"
-description: "Instructions how to handle events with your component."
+description: "Instructions on how to handle events with your component."
date: 2016-04-16 13:32
sidebar: true
comments: false
diff --git a/source/developers/component_loading.markdown b/source/developers/component_loading.markdown
index 342aa60b7ed..b817fadf382 100644
--- a/source/developers/component_loading.markdown
+++ b/source/developers/component_loading.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Loading your components"
-description: "Instructions how to get your component loaded by Home Assistant."
+description: "Instructions on how to get your component loaded by Home Assistant."
date: 2016-04-16 13:32
sidebar: true
comments: false
diff --git a/source/developers/component_states.markdown b/source/developers/component_states.markdown
index 5e3217de263..f89803699a9 100644
--- a/source/developers/component_states.markdown
+++ b/source/developers/component_states.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Handling states"
-description: "Instructions how to handle states with your component."
+description: "Instructions on how to handle states with your component."
date: 2016-07-01 20:00
sidebar: true
comments: false
diff --git a/source/developers/component_visibility.markdown b/source/developers/component_visibility.markdown
index 846d6b98b3b..333c627cf55 100644
--- a/source/developers/component_visibility.markdown
+++ b/source/developers/component_visibility.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Handling visibility"
-description: "Instructions how to handle visibility with your component."
+description: "Instructions on how to handle visibility with your component."
date: 2016-07-01 20:00
sidebar: true
comments: false
diff --git a/source/developers/documentation/standards.markdown b/source/developers/documentation/standards.markdown
index 47ae4eab73c..0a6d2fa7ad5 100644
--- a/source/developers/documentation/standards.markdown
+++ b/source/developers/documentation/standards.markdown
@@ -16,7 +16,7 @@ To ensure that the documentation for Home Assistant is consistent and easy to fo
* The language of the documentation should be American-English.
* Don't put two spaces after a period and avoid the "Oxford comma".
* Be objective and not gender favoring, polarizing, race related or religion inconsiderate.
-* The case of brand names, services, protocols, components, and platforms must match its respective counterpart. E.g. "Z-Wave" **not** "Zwave", "Z-wave", "Z Wave" or "ZWave". Also, "Input Select" **not** "input select" or "Input select".
+* The case of brand names, services, protocols, components, and platforms must match its respective counterpart. e.g., "Z-Wave" **not** "Zwave", "Z-wave", "Z Wave" or "ZWave". Also, "Input Select" **not** "input select" or "Input select".
* All headings should use the {% raw %}`{% linkable_title %}`{% endraw %} tag.
## {% linkable_title Component and Platform Pages %}
diff --git a/source/developers/hassio/addon_communication.markdown b/source/developers/hassio/addon_communication.markdown
index 775008162a9..be4f04dc08b 100644
--- a/source/developers/hassio/addon_communication.markdown
+++ b/source/developers/hassio/addon_communication.markdown
@@ -17,7 +17,7 @@ There are different ways for communication between add-ons inside Hass.io.
We use an internal network that allows to communicate with every add-on, even to/from Home Assistant, by using his name or alias. Only the add-ons which run on the host network are a bit limited. These can talk with all internal add-ons by their name but all other add-on can't address these add-on by name - using an alias works for both!
Name/alias are used for communication inside Hass.io.
-The name is generated using the following format: `{REPO}_{SLUG}`, e.g. `local_xy` or `3283fh_myaddon`. In this example, `{SLUG}` is defined in an add-ons `config.json`. If an add-on is installed locally, `{REPO}` will be `local`. If the add-on is installed from a Github repository, `{REPO}` is a hashed identifier generated from the GitHub repository's URL (ex: https://github.com/xy/my_hassio_addons). See [here](https://github.com/home-assistant/hassio/blob/587047f9d648b8491dc8eef17dc6777f81938bfd/hassio/addons/utils.py#L17) to understand how this identifier is generated. Note that this identifier is required in certain service calls that use the [Hass.io add-on API](hassio-addon-api). You can view the repository identifiers for all currently installed add-ons via a GET request to the hassio API `addons` endpoint.
+The name is generated using the following format: `{REPO}_{SLUG}`, e.g., `local_xy` or `3283fh_myaddon`. In this example, `{SLUG}` is defined in an add-ons `config.json`. If an add-on is installed locally, `{REPO}` will be `local`. If the add-on is installed from a Github repository, `{REPO}` is a hashed identifier generated from the GitHub repository's URL (ex: https://github.com/xy/my_hassio_addons). See [here](https://github.com/home-assistant/hassio/blob/587047f9d648b8491dc8eef17dc6777f81938bfd/hassio/addons/utils.py#L17) to understand how this identifier is generated. Note that this identifier is required in certain service calls that use the [Hass.io add-on API](hassio-addon-api). You can view the repository identifiers for all currently installed add-ons via a GET request to the hassio API `addons` endpoint.
Use `hassio` for communication with the internal API.
diff --git a/source/getting-started/presence-detection.markdown b/source/getting-started/presence-detection.markdown
index 6861f89e307..acdd5a30b8f 100644
--- a/source/getting-started/presence-detection.markdown
+++ b/source/getting-started/presence-detection.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Setting up presence detection"
-description: "Instructions how to setup presence detection within Home Assistant."
+description: "Instructions on how to setup presence detection within Home Assistant."
date: 2015-10-04 12:08
sidebar: true
comments: false
diff --git a/source/hassio/installing_third_party_addons.markdown b/source/hassio/installing_third_party_addons.markdown
index 828ed90e590..0840aa4a692 100644
--- a/source/hassio/installing_third_party_addons.markdown
+++ b/source/hassio/installing_third_party_addons.markdown
@@ -1,7 +1,7 @@
---
layout: page
title: "Installing third-party add-ons"
-description: "Instructions how to get started using third-party add-ons."
+description: "Instructions on how to get started using third-party add-ons."
date: 2017-05-14 13:28
sidebar: true
comments: false
From 9cb25206d969c07040407ca24d5d6f94acd52d6e Mon Sep 17 00:00:00 2001
From: lolouk44 Services developer tool. Services allow to change anything. For example turn on a light, run a script or enable a scene. Each service has a domain and a name. For example the service `light.turn_on` is capable of turning on any light in your system. Services can be passed parameters to for example tell which device to turn on or what color to use.
-
The Android app for OwnTracks is no longer developed or supported, Zanzito is a drop in replacement for OwnTracks MQTT.
+ See Instructions
+As of February 2018 it appears that development of the Android app for OwnTracks is being done again. It is currently in beta status and a direct play store link is https://play.google.com/apps/testing/org.owntracks.android
Screenshot
-You can also use `hassbian-config` to automate the process by running `sudo hassbian-config upgrade home-assistant`
+You can use `hassbian-config` to automate the process by running `sudo hassbian-config upgrade homeassistant`
-The upgrade process differs depending on the installation you have, so please review the documentation that is specific to your install [Hass.io](/hassio/), [HASSbian](/docs/hassbian/common-tasks/#update-home-assistant), [Vagrant](/docs/installation/vagrant/), or [Virtualenv](/docs/installation/virtualenv/#upgrading-home-assistant).
+The upgrade process differs depending on the installation you have, so please review the documentation that is specific to your install [Hass.io](/hassio/), [Hassbian](/docs/installation/hassbian/common-tasks/#update-home-assistant), [Vagrant](/docs/installation/vagrant/), or [Virtualenv](/docs/installation/virtualenv/#upgrading-home-assistant).
-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 [Hass.io](/hassio/), [HASSbian](/docs/hassbian/installation/), [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 [Hass.io](/hassio/), [Hassbian](/docs/hassbian/installation/), [Vagrant](/docs/installation/vagrant/), or [Virtualenv](/docs/installation/virtualenv).
The "dev" branch is likely to be unstable. Potential consequences include loss of data and instance corruption.
From b4c71a2f549cdd90212a42ac5bc269278f649445 Mon Sep 17 00:00:00 2001
From: Philip Rosenberg-Watt
@@ -39,18 +39,20 @@ As "Service Data" we want a simple text that is shown as part of the notificatio
}
```
-Don't forget to save your new automation rule. In order for your saved automation rule to come into effect you will need to go to the **Configuration** page and click on **Reload Automation**.
+Don't forget to save your new automation rule. For your saved automation rule to come into effect, you will need to go to the **Configuration** page and click on **Reload Automation**.
## {% linkable_title Updating your configuration to use the editor %}
-First check that you have activated the configuration editor.
+First, check that you have activated the configuration editor.
```yaml
# Activate the configuration editor
config:
```
-The automation editor reads and writes to the file `automations.yaml` in your [configuration](/docs/configuration/) folder. Make sure that you have set up the automation component to read from it:
+The automation editor reads and writes to the file `automations.yaml` in the root of your [configuration](/docs/configuration/) folder.
+Currently, both the name of this file and its location are fixed.
+Make sure that you have set up the automation component to read from it:
```yaml
# Configuration.yaml example
@@ -65,7 +67,7 @@ automation old:
platform: ...
```
-You can use the `automation:` and `automation old:` sections in the same time:
+You can use the `automation:` and `automation old:` sections at the same time:
- `automation old:` to keep your manual designed automations
- `automation:` to save the automation created by the online editor
@@ -77,7 +79,7 @@ automation old: !include_dir_merge_list automations
## {% linkable_title Migrating your automations to `automations.yaml` %}
-If you want to migrate your old automations to use the editor, you'll have to copy them to `automations.yaml`. Make sure that `automations.yaml` remains a list! For each automation that you copy over you'll have to add an `id`. This can be any string as long as it's unique.
+If you want to migrate your old automations to use the editor, you'll have to copy them to `automations.yaml`. Make sure that `automations.yaml` remains a list! For each automation that you copy over, you'll have to add an `id`. This can be any string as long as it's unique.
For example, the below automation will be triggered when the sun goes from below the horizon to above the horizon. Then, if the temperature is between 17 and 25 degrees, a light will be turned on.
From 77c282d62f1e6e1692f7373c41fd330d1f898f2f Mon Sep 17 00:00:00 2001
From: Erik Eriksson