diff --git a/components/arduino/index.html b/components/arduino/index.html
index 85dcedcdb3..a2a82340a6 100644
--- a/components/arduino/index.html
+++ b/components/arduino/index.html
@@ -187,7 +187,7 @@ A word of caution: The Arduino boards are not storing states. This means that wi
DHT sensor
Raspberry PI GPIO switch
diff --git a/components/automation/index.html b/components/automation/index.html
index 727a256639..e8d5c1e2f6 100644
--- a/components/automation/index.html
+++ b/components/automation/index.html
@@ -367,6 +367,21 @@
+
Sun condition
+
+
The sun condition can test if the sun has already set or risen when a trigger occurs. The before and after keys can only be set to sunset or sunrise. They have a corresponding optional offset value (before_offset, after_offset) that can be added, similar to the sun trigger.
+
+
+
automation:
+ condition:
+ platform: sun
+ after: sunset
+ # Optional offset value
+ after_offset: "-1:00:00"
+
+
+
+
Template condition
The template condition will test if given template renders a value equal to true. This is achieved by having the template result in a true boolean expression or by having the template render ‘true’.
# Example configuration.yaml entry
-sensor:
+binary_sensor:
platform: arestresource: http://IP_ADDRESSname: Office Switch
@@ -176,6 +176,9 @@ This sensor is not suitable for fast state changes because there is a high possi
diff --git a/components/binary_sensor.rest/index.html b/components/binary_sensor.rest/index.html
index 22c82d84c4..1af7aa3d87 100644
--- a/components/binary_sensor.rest/index.html
+++ b/components/binary_sensor.rest/index.html
@@ -184,6 +184,9 @@ Make sure that the URL matches exactly your endpoint or resource.
diff --git a/components/device_tracker.actiontec/index.html b/components/device_tracker.actiontec/index.html
index 1f11e35335..ea7d4253f2 100644
--- a/components/device_tracker.actiontec/index.html
+++ b/components/device_tracker.actiontec/index.html
@@ -180,7 +180,7 @@ This device tracker needs telnet to be enabled on the router.
FRITZ!Box
MQTT device tracker
diff --git a/components/device_tracker.aruba/index.html b/components/device_tracker.aruba/index.html
index a077fee491..e6cbf2224b 100644
--- a/components/device_tracker.aruba/index.html
+++ b/components/device_tracker.aruba/index.html
@@ -180,7 +180,7 @@ This device tracker needs telnet to be enabled on the router.
FRITZ!Box
MQTT device tracker
diff --git a/components/device_tracker.asuswrt/index.html b/components/device_tracker.asuswrt/index.html
index 6e8809fbf1..176b4fea86 100644
--- a/components/device_tracker.asuswrt/index.html
+++ b/components/device_tracker.asuswrt/index.html
@@ -173,7 +173,7 @@ This device tracker needs telnet to be enabled on the router.
FRITZ!Box
MQTT device tracker
diff --git a/components/device_tracker.fritz/index.html b/components/device_tracker.fritz/index.html
index c3aace9e1a..8541235ed1 100644
--- a/components/device_tracker.fritz/index.html
+++ b/components/device_tracker.fritz/index.html
@@ -178,7 +178,7 @@ It seems that it is not necessary to use it in current generation Fritz!Box rout
FRITZ!Box
MQTT device tracker
diff --git a/components/device_tracker.geofancy.html b/components/device_tracker.geofancy.html
deleted file mode 100644
index 5ed570461b..0000000000
--- a/components/device_tracker.geofancy.html
+++ /dev/null
@@ -1 +0,0 @@
-
\ No newline at end of file
diff --git a/components/device_tracker.icloud/index.html b/components/device_tracker.icloud/index.html
index 0f8d114e69..028bb0a6f4 100644
--- a/components/device_tracker.icloud/index.html
+++ b/components/device_tracker.icloud/index.html
@@ -176,7 +176,7 @@ You may receive an email from Apple stating that someone has logged into your ac
FRITZ!Box
MQTT device tracker
diff --git a/components/device_tracker.locative.html b/components/device_tracker.locative.html
new file mode 100644
index 0000000000..95b8fb6784
--- /dev/null
+++ b/components/device_tracker.locative.html
@@ -0,0 +1 @@
+
diff --git a/components/device_tracker.geofancy/index.html b/components/device_tracker.locative/index.html
similarity index 78%
rename from components/device_tracker.geofancy/index.html
rename to components/device_tracker.locative/index.html
index e94a317ff0..31c00abd84 100644
--- a/components/device_tracker.geofancy/index.html
+++ b/components/device_tracker.locative/index.html
@@ -7,26 +7,26 @@
- Geofancy - Home Assistant
+ Locative - Home Assistant
-
+
-
+
-
+
-
+
-
+
-
-
+
+
@@ -102,23 +102,33 @@
- Geofancy
+ Locative
-
This platform allows you to detect presence using Geofancy. Geofancy allows users to track their location on iOS devices.
+
This platform allows you to detect presence using Locative. Locative is an open source app for iOS that allows users to set up a GET or POST request when a geofence is entered or exited. This can be configured with Home Assistant to update your location.
-
To integrate Geofancy in Home Assistant, add the following section to your configuration.yaml file:
+
To integrate Locative in Home Assistant, add the following section to your configuration.yaml file:
# Example configuration.yaml entrydevice_tracker:
- platform: geofancy
+ platform: locative
+
To configure Locative, you must set up the app to send a GET request to your Home Assistant server at http://<ha_server>/api/locative. Make sure to include the API password if you have configured a password in Home Assistant (add ?api_password=<password> to the end of the URL). When you enter or exit a geofence, Locative will send a GET request to that URL, updating Home Assistant.
+
+
+
+
+
+
When you enter a geofence, your location name in Home Assistant will be set to the name of the geofence in Locative. When you exit a geofence, your location name in Home Assistant will be set to “not home”.
+
+
To use Locative in combination with another device tracker, such as nmap or Netgear, fill in the mac field to the Locative entry in known_devices.yaml with the MAC address of the device you want to track. The state of the device will be determined by the source that reported last.
+
@@ -131,7 +141,7 @@
-
+
This is a platform for
@@ -156,7 +166,7 @@
FRITZ!Box
- Geofancy
+ Locative
MQTT device tracker
diff --git a/components/device_tracker.luci/index.html b/components/device_tracker.luci/index.html
index 9d297979ea..9e1c169c59 100644
--- a/components/device_tracker.luci/index.html
+++ b/components/device_tracker.luci/index.html
@@ -184,7 +184,7 @@ Some installations have a s
FRITZ!Box
MQTT device tracker
diff --git a/components/device_tracker.snmp/index.html b/components/device_tracker.snmp/index.html
index 30b7e3fe80..23f42efb97 100644
--- a/components/device_tracker.snmp/index.html
+++ b/components/device_tracker.snmp/index.html
@@ -179,7 +179,7 @@ This device tracker needs SNMP to be enabled on the router.
FRITZ!Box
diff --git a/components/media_player.firetv/index.html b/components/media_player.firetv/index.html
index b13bcb19fb..a56bea4f75 100644
--- a/components/media_player.firetv/index.html
+++ b/components/media_player.firetv/index.html
@@ -203,6 +203,9 @@ Note that python-firetv has support for multiple Amazon Fire TV devices. If you
diff --git a/components/media_player.squeezebox/index.html b/components/media_player.squeezebox/index.html
index c959ab9640..cb1009622f 100644
--- a/components/media_player.squeezebox/index.html
+++ b/components/media_player.squeezebox/index.html
@@ -178,6 +178,9 @@ This lets you control Squeezebox hardware like the Classic, Transporter, Duet, B
Universal Media Players combine multiple existing entities in Home Assistant into one media player entity. This is used for creating a single entity that controls an entire media center.
+
+
Multiple Media Player entities can be controlled from a Universal Media Player. Additionally, the Universal Media Player allows volume and power commands to be re-routed to other entities in Home Assistant. This allows the power and volume to control external devices like a television or audio receiver.
+
+
A Universal Media Player is created in configuration.yaml as follows.
children: Ordered list of child media players this entity will control
+
commandsOptional: Commands to be overwritten. Possible entries are turn_on, turn_off, volume_up, volume_down, and volume_mute.
+
attributesOptional: Attributes that can be overwritten. Possible entries are is_volume_muted and state. The values should be an entity id and state attribute separated by a bar (|). If the entity id’s state should be used, then only the entity id should be provided.
+
+
+
The universal media player will primarily imitate one of its children. The first child in the list that is active (not idle/off) will be controlled the universal media player. The universal media player will also inherit its state from the first active child. Entities in the children list must be media players.
+
+
It is recommended that the command turn_on, the command turn_off, and the attribute state all be provided together. The state attribute indicates if the Media Player is on or off. If state indicates the media player is off, this status will take precedent over the states of the children. If all the children are idle/off and state is on, the universal media player’s state will be on.
+
+
It is also recomended that the command volume_up, the command volume_down, the command volume_mute, and the attribute is_volume_muted all be provided together. The attribute is_volume_muted should return either True or the on state when the volume is muted. The volume_mute service should toggle the mute setting.
In this example, a switch is available to control the power of the television. Switches are also available to turn the volume up, turn the volume down, and mute the audio. These could be command line switches or any other entity in Home Assistant. The turn_on and turn_off commands will be redirected to the television and the volume commands will be redirected to an audio receiver.
+
+
The children are a Chromecast and a Kodi player. If the Chromecast is playing, the Universal Media Player will reflect its status. If the Chromecast is idle and Kodi is playing, the Universal Media player will change to reflect its status.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/components/media_player/index.html b/components/media_player/index.html
index 3666288920..e92e1e76a3 100644
--- a/components/media_player/index.html
+++ b/components/media_player/index.html
@@ -221,6 +221,9 @@
The free_mobile platform is using the French mobile operator Free Mobile to send SMS to your own cell phone.
+
+
Before doing anything, you have to activate the SMS API option in your Free Mobile account (In “Gérer mon compte -> Mes Options”). Activating this option will automatically generate a token which is required in your configuration.
+
+
+
+
+
+
This API only send classic SMS and only on the cell phone of the account owner. So you only have to provide a text message in your payload.
+
+
+If you disable and re-enable the SMS API option, please be sure to update your token in your configuration.
+
+
+
To enable SMS notifications in your installation, add the following to your configuration.yaml file:
diff --git a/components/notify.smtp/index.html b/components/notify.smtp/index.html
index 640f65d5c7..61dcee5c9c 100644
--- a/components/notify.smtp/index.html
+++ b/components/notify.smtp/index.html
@@ -175,6 +175,9 @@ which need special attention. By default, the usage by external applications, es
diff --git a/components/sensor.dht/index.html b/components/sensor.dht/index.html
index 3e5500dd23..cce76cf782 100644
--- a/components/sensor.dht/index.html
+++ b/components/sensor.dht/index.html
@@ -175,7 +175,7 @@ As this requires access to the GPIO, you will need to run Home Assistant as root
DHT sensor
diff --git a/components/sensor.efergy/index.html b/components/sensor.efergy/index.html
index dfb271121d..48af3f7cce 100644
--- a/components/sensor.efergy/index.html
+++ b/components/sensor.efergy/index.html
@@ -191,6 +191,12 @@ negative number of minutes your timezone is ahead/behind UTC time.
diff --git a/components/sensor.glances/index.html b/components/sensor.glances/index.html
index ef467fed1d..03aa316117 100644
--- a/components/sensor.glances/index.html
+++ b/components/sensor.glances/index.html
@@ -232,6 +232,12 @@ Glances web server started on http://0.0.0.0:61208/
diff --git a/components/sensor.modbus/index.html b/components/sensor.modbus/index.html
index c4eb8bdb95..71b8e8533d 100644
--- a/components/sensor.modbus/index.html
+++ b/components/sensor.modbus/index.html
@@ -228,6 +228,12 @@ Each named register will create an integer sensor and each named bit will create
The nest thermostat platform let you control a thermostat from Nest. It also includes the ability to monitor things like the state of our HVAC system and the current humidity and temperature.
+
+
To set it up, add the following information to your configuration.yaml file:
diff --git a/components/sensor.rest/index.html b/components/sensor.rest/index.html
index ae564b3a75..ec279ca40d 100644
--- a/components/sensor.rest/index.html
+++ b/components/sensor.rest/index.html
@@ -262,6 +262,12 @@ Make sure that the URL matches exactly your endpoint or resource.
The yr platform uses YR.no as an source for current meteorological data for your location. The
+weather forecast is delivered by the Norwegian Meteorological Institute and the NRK.
+
+
To add YR to your installation, add the following to your configuration.yaml file:
+
+
+
# Will show a symbol for the current weather as default:
+sensor:
+ platform: yr
+
+# Will show temperatue and wind direction:
+sensor:
+ platform: yr
+ monitored_conditions:
+ - temperature
+ - windDirection
+
+# Will show all available sensors:
+sensor:
+ platform: yr
+ monitored_conditions:
+ - temperature
+ - symbol
+ - precipitation
+ - windSpeed
+ - pressure
+ - windDirection
+ - humidity
+ - fog
+ - cloudiness
+ - lowClouds
+ - mediumClouds
+ - highClouds
+ - dewpointTemperature
+
+
+
+
+
Configuration variables:
+
+
+
monitored_conditions array (Optional): Conditions to display in the frontend.
+
+
symbol: A symbol for the current weather.
+
temperature: The current temperature.
+
humidity: The relative humidity.
+
fog: Fog.
+
pressure: The sea-level air pressure in millibars.
+
precipitation: The precipitation.
+
dewpointTemperature: The dew point temperature.
+
windSpeed: The wind speed.
+
windDirection: Where the wind is coming from in degrees, with true north at 0° and progressing clockwise.
+
cloudiness: The cloudiness.
+
lowClouds: Low cloud level.
+
mediumClouds: Medium cloud level.
+
highClouds: High cloud level.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/components/sensor.zwave/index.html b/components/sensor.zwave/index.html
index 49711977d7..7ef73bc56b 100644
--- a/components/sensor.zwave/index.html
+++ b/components/sensor.zwave/index.html
@@ -173,6 +173,12 @@
Raspberry PI GPIO switch
diff --git a/components/switch.command_switch/index.html b/components/switch.command_switch/index.html
index 0e97ed2786..75c3aa9fba 100644
--- a/components/switch.command_switch/index.html
+++ b/components/switch.command_switch/index.html
@@ -177,6 +177,21 @@ This switch will shutdown your host immediately, there will be no confirmation.
+
Control your VLC player
+
+
This switch will control a local VLC media player (Source).
host (Required): Adress of your thermostat, eg. 192.168.1.32
+
username (Required): Username for the thermostat.
+
password (Required): Password for the thermostat.
+
+
+
The Proliphix NT Thermostat series are ethernet connected
+thermostats. They have a local HTTP interface that is based on get/set
+of OID values. A complete collection of the API is available in this
+API documentation.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/components/thermostat.radiotherm/index.html b/components/thermostat.radiotherm/index.html
index 2726a54f62..935792a275 100644
--- a/components/thermostat.radiotherm/index.html
+++ b/components/thermostat.radiotherm/index.html
@@ -177,6 +177,9 @@
Z-Wave integration for Home Assistant allows you to observe and control connected Z-Wave devices. Z-Wave support requires a Z-Wave USB stick to be plugged into the host.
+
Z-Wave integration for Home Assistant allows you to observe and control connected Z-Wave devices. Z-Wave support requires a supported Z-Wave USB stick to be plugged into the host.
There is currently support for switches, lights and sensors. All will be picked up automatically after configuring this platform.
diff --git a/getting-started/presence-detection/index.html b/getting-started/presence-detection/index.html
index 4e3c0b4ef7..043d885cd6 100644
--- a/getting-started/presence-detection/index.html
+++ b/getting-started/presence-detection/index.html
@@ -132,7 +132,7 @@ Screenshot of Home Assistant showing a school, work and home zone and two people
Scanning for connected devices is easy to setup. See the instructions for our supported routers or scan the network using nmap. This approach does have its limitations. It will only be able to detect if a device is home. It also struggles with iPhones because they disconnect from the WiFi if idle, marking them as not home while they are not.
-
Home Assistant currently supports two third party services for presence detection: OwnTracks and [Geofancy][ha-geofancy]. OwnTracks is an app that you install on your iPhone or Android phone that allows you to push the location of your device to Home Assistant using an MQTT broker. An MQTT broker is an Internet of Things communication platform that you can freely host yourself or get a private instance for free in the cloud.
+
Home Assistant currently supports two third party services for presence detection: OwnTracks and Locative. OwnTracks is an app that you install on your iPhone or Android phone that allows you to push the location of your device to Home Assistant using an MQTT broker. An MQTT broker is an Internet of Things communication platform that you can freely host yourself or get a private instance for free in the cloud.
OwnTracks communicates directly with your MQTT broker, no data will pass through their servers.
diff --git a/help/trivia/index.html b/help/trivia/index.html
index 04862e85d8..43fe2f8d5e 100644
--- a/help/trivia/index.html
+++ b/help/trivia/index.html
@@ -128,6 +128,49 @@
Home Assistant is open source software and available under the MIT license.
+
Numbers
+
+
This sections just contains some random numbers of the Home Assistant eco-system.
+ 
+
+
+ 
+
+ 
+
+ 
+
+ 
+
+ 
+
+ 
+
+ 
+
+