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 d0d7ba72fe..bfc30400f6 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 181d28ba12..658c0ebc63 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 6673146847..f427590256 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 4f3d267f53..5cac74b560 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 6f010ebad2..1f1507bf28 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 39aecb1534..06cca72d26 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 76fb2ad1be..eb6d0a110f 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 3a13097c87..8829782ebd 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 593a921261..c8fe13152c 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 db6bfd2d5c..9e485ec6c3 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 13249bc52b..a5944d821b 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 3f606caf03..b33bd30d88 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 ff2aa46ca8..b2b23aeeff 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 19898029df..462b309e7e 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 7afaaa255e..44d819c39c 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 bf25b89d5f..8e59002ccf 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 d0afd0ff09..284ab5ea36 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 03bf4b8a6e..5c9813bc5c 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 fba1087171..40ed93c1d5 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 e3fb65bcc9..58a1bad12c 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 558765a764..ecf2716825 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 5015022c55..5df8b274e6 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 07b3e2db26..00dad71931 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 f1d80bfa97..aeefd01e63 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 d2c2594834..b32ae95eac 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 ee731d020d..f27048d4e7 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 bb6d597dee..f362107791 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 b5188cf33e..aaedc1c12f 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 9deab2be84..c11da280ac 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 617e81cac2..ad2d6200f8 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 e74e6942d9..871ba222e2 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 a0cba942d4..16f8e16099 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 b2223ae9e4..86249ce98e 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 8cd9aad47e..59e8b8e970 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 7f3b23ad6c..7cba5e18f4 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 741d2168cd..214f19564b 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 82c4df9aa5..f581706b92 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 06af902dfd..b9aacb3250 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 04ab92bdee..65026cf576 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 8ae450edfc..6c03413c8b 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 805cb67e68..04f444540f 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 d51cfd70c7..fedc9fa2be 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 3872b5373b..9e380e8d7c 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 02e15710d6..4c61accdc6 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 4370674890..54cd5adbc4 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 2902cb71be..fdd288113f 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 ec582bfb0f..902255eeb4 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 5a13ea9dfb..1838835017 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 4bf9a9d28a..5f91aa43fe 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 f9ceacdb22..9cc2555fb1 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 86fa342c9b..df1abeece9 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 d261a81648..c2664af84c 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 e1f600c98f..13f61413f6 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 ebba128f88..cc56e6de3e 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 ee5c513fe8..b6a1b707cf 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 5625b43cfb..07df0ca0f7 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 b2bb9dbce5..55e09b1219 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 a81d238464..b4b71bc4e1 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 a9f1b834e4..9d1315b310 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 71fc4e9717..158504bcae 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 da0fc42fff..dba42ffcaf 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 df44818d04..1ae147ef86 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 5e7b74771e..e537c11601 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 b79a881441..45df065a49 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 25e01ba22c..48bf4fb135 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 3af241a04e..fab4ca5401 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 b098d007d5..8cd203eb4c 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 1b0e441970..0583084626 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 ed15a92752..b2f46b065d 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 c3b0cc2d8b..904c1e59de 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 4053e61f1d..891f63e886 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 6d379e04ca..68782e6c23 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 3770bb024b..fb33408953 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 c1e2860370..9dcc3cff90 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 04109b9cd6..b019662a68 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 418881c169..6b320e7108 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 c2c3cc5530..67d5b6509a 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 8ed47ccf4a..b0669cfb7f 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 8baf864dfd..a305038987 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 2e72677179..e3c2d31e85 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 1f51751b3f..a792e130a8 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 e1d6fd7b33..ba25eacd6c 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 d1a76f3973..438e747430 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 5105f19c4c..ca16dd32b7 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 70168cf440..2f89e09096 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 c946160db1..67bdb19dd9 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 912bd82dc4..9783766c89 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 25a0859aa9..bc25b5b10b 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 28f4d77f43..16bfa603b8 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 78764d7507..2f13d2c062 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 114d70f3fe..8386b0390a 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 945fdc0c64..8e59296db9 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 383afdae98..7b16307760 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 999d2cd929..69372c8c33 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 c97f391dab..13d18534ba 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 c730daf5d9..781ac147a5 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 e798889686..6754b57c87 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 b8c0e38013..ebfe0177ba 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 31ad2b0160..ee1c434ff4 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 2cd2c7f44d..f7f6559619 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 76c084bcf4..bbf646f0fb 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 ca77cbde1a..2f12bc1d80 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 855333def8..96d9c48c0e 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 0c6a5843fa..c7887e9c8b 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 7207e0e092..c65ed0dff0 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 fd357eb8ec..6885a33385 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 556812292c..a59d19fe34 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 138eaec8bd..7a60e23578 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 90507d40e5..dfbe48ccc9 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 a2eece639d..47e79b74ba 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 4e4c187d0f..98f6846f3a 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 b561797aac..51888be2b2 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 b35a5ea99b..41684f7212 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 98a160f76b..e673e4472d 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 e78075c01a..ca277f7706 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 e174968827..ae10d32d3c 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 fbbe820c34..2877848601 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 5f0098cff8..d9f7b999f4 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 66086c5ded..6bc6d1a5b0 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 ddaf3a611b..45ad9698cb 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 5c889727de..c7771e0f40 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 3cabb0f43d..53954f6693 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 65874f99b2..2e83636b9e 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 3afe420ff4..862cd822f8 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 fa2a550b02..463914f236 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 106f114f78..76cbc4a4ba 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 7c8cfa363b..5b8d7eb35f 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 3775ae8260..707ef55a90 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 c306b1d527..b996e642a4 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 5919b19b50..0581b320a2 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 ffc6364fc9..ed696574cc 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 f27367f0da..df42020a21 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 9d56005829..30a2b62382 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 5514b98c36..c3f4149342 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 da0f6fe3c3..11644dc5b3 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 5b7b832fe9..1a607624d3 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 705800f6e3..9754096be0 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 c91f5a123e..f9e9388c67 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 8c5b205e98..316769ff7c 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 7aa5adfb9c..718bddc253 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 ebb254a310..0efe4ac968 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 30737d617e..dcad472dbb 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 21ef850da9..be5a5494ca 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 21a6b48cc5..cfa69e0084 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 e40e81050b..a1e8a33f8b 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 cf2449fac4..fb55b90a6f 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 783f3deb58..8a26160d4f 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 a5d3b6a594..4f82febe40 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 657b94e84e..9f28960267 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 18ba15b94b..53f97f69d1 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 0bdb62c8a7..beb539c559 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 0061b31f00..9a94b1177e 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 0123c7fec5..f02c52ea30 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 e68b76112e..928de178e7 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 d36905f38e..877bcd8cd8 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 2a5a95ef7b..4520143f89 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 427991e60d..020f535c10 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 3f64711ff7..2143480d0e 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 6949a92722..7d350005a8 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 2f411679c9..5aba4e41f9 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 3b5d5d2dd5..40becc0eb5 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 be571eb2c1..9e98d18052 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 6ef8c7c50d..5237224f46 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 fe5d7fc3a4..c74b962e34 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 d8baf5fa0d..2234a86310 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 7aefb8743f..3f2cb633a9 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 f2e7680098..8191788499 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 e465afe63d..3dab5bc10d 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 cebd644707..e1bf8659ba 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 bbe4e87110..c6165bb898 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 2bfeb97fc4..4fbe377bb6 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 0ba8c606f3..cadfd99cf9 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 6209d6bcd1..bf31900c34 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 67e7db1098..244c01b58d 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 61edbe9d8d..dc7eb19057 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 370f26be8c..c20e4bc2f5 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 16bf7e992a..2491bac32e 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 4747d9a5f4..2556c82037 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 75b5419f59..3e38499010 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 533129e36c..c0d51f21b8 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 2ea2dd577d..5fbbae6a04 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 5e905e73e5..13683e8a8a 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 ac89f6f23c..534924105d 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 9caf251d04..7f0fa2a989 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 ec5002258c..7cec94cf33 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 f63810e68e..6bf8867709 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 8064c8fbf8..c3dbadfbe4 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 db062932d0..930aa496ac 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 e320de496a..040acd518b 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 a261aececb..9169a5091e 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 e2ed36fba8..92b1bbd618 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 192d5d9d9a..03f0fae06d 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 49775f2855..0415c561a7 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 71ba4b2aec..8aa5514f0c 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 a08f4cd935..ab841bbe83 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 3d8c45b736..ba8882accd 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 5e03edc16c..8d01f2b7c4 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 b7958abeda..cb4d6f3695 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 b20878e648..fbe53d3d90 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 6e51c65382..b7410f68ea 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 c7244b2f0b..62d7deab2a 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 692de767fc..7fe3bc7f9a 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 cc2eba65cc..c6178d048c 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 7924da8fe7..376d29837a 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 fada23fde3..7359fae9d2 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 e42610fef5..4475396730 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 33e2113215..9940451bd4 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 64c0e1dee4..046e27ac02 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 642804ffff..31a1befde2 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 51feb22b70..1b3c4785e5 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 2f63ba6264..2ef810a113 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 fca7954e1b..511c1cb6fa 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 2d10556edf..7e07ed485e 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 90c816cb1c..4bf9f168f7 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 1cb708486c..b5cd1c4294 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 50ef56848f..cf8e79cf4c 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 52dd111053..856b758aab 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 809cee76ca..f0b5dedbdb 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 276586c98c..cae336b6d8 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 df04990f68..bd8ee0eda5 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 b36ded0c28..a61f661459 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 c4d7611edb..0c5886b637 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 38dd16ca98..66dd99404b 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 78ca33d041..42294c8628 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 c7f2bf07b1..35a52d3422 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 7d8c751313..a41ec48ab9 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 38b529af80..7efee12d68 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 9df49ee684..91a2dd5cf1 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 ad960c30e5..2eda541505 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 47680c4e1a..840eb5cd08 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 cbbaf5553e..fc23677a88 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 6297420cd1..875636fb7c 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 cefa2adcbb..e13e45dd93 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 ae270f052f..c441b4c1e6 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 ea1ad91a0b..356ced350f 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 e4ca7947a2..6a98ad3042 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 6a34cfb5c5..2886f2b434 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 95429545db..f492d5ef3a 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 77bf1c7836..26ff8d5fd1 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 5f4d437c02..0257c70b55 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 a5b126fac4..9bfd40dd39 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 93a191fc9c..fc978f2f2d 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 59f81644e2..44f4d6100b 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 8b3ac28b09..c1063e4d4a 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 bf7a0af0d0..a15727f86d 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 9ae17d80ba..855dca71c0 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 9f23c8df3f..1c44a9bdd3 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 7a2b960de8..d5dbf0530e 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 356ba316b5..4e136af476 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 dc4cf5be79..789f43c37d 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 227cc42f80..09626f0984 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 534fe54e9f..9d1ec23a0c 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 6dac17958f..cce7aad569 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 d5c681ff73..af6979bed2 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 6ebcc84bcf..883c4c7669 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 a37980565e..ce9547358e 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 fabf565aeb..7a82ab95e9 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 87ff9e0eca..38379ccd67 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 4e54096833..e76da08026 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 ce0b0d051b..6ed513ca90 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 759f37f982..868bad19fd 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 b17f985797..f67feb188e 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 a5aad007bd..0217a91c6a 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 c1e7b16a37..0fbdf0ff31 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 75a4676365..8ee60938a9 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 3f8eaa196e..a84c05f7a2 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 ce920cfeff..a3fd05aab8 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 5a54a70424..7300fd8d65 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 e9f4ac8f9b..c35d652f10 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 955f380d4a..1b5dca3185 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 5f52ac95d9..5497ae7005 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 4183dfa0b0..d86dd62935 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 247a9a94c9..a69c4f685a 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 8a55a78dda..0e8d12c0fb 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 35813cb459..772fa6560e 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 0f9bcd7a85..fdd5a38b80 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 daf65e1a78..64e960ed61 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 9c6558a569..014752a66e 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 2b22c7cce9..70fba841c5 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 d9f64f8a07..8c03c7c7af 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 4bd050ad22..5e35f4866f 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 6f876effdd..da7ed21417 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 1573174329..0e8819fb85 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 bf410b916a..252e0a5160 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 3242a5f86d..60974c428b 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 999e24988f..d4deaf4f48 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 552dd08167..8afb951f8e 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 d751856fe4..941d79e7b7 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 f71ac52e2f..e6c87bdbfc 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 5c39a604ab..37d13d8507 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 b1b1833340..ab73aad529 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 5974c16a20..da8848899a 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 0a6499d2d4..b6c420a91b 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 14d83f6202..2707b3e7f0 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 2420da0399..a9deb4a4d1 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 465e5278a2..ad68eb66fb 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 6edf3f8f4b..e970b9a17e 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 dc054b035c..f360981135 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 96f78c60a0..00ab599c1b 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 750f6b6c85..2a6ae27d0e 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 485bc2863c..ee2e281b1f 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 342aa60b7e..b817fadf38 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 5e3217de26..f89803699a 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 846d6b98b3..333c627cf5 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 47ae4eab73..0a6d2fa7ad 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 775008162a..be4f04dc08 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 6861f89e30..acdd5a30b8 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 828ed90e59..0840aa4a69 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