# Heimdall - Let Homey watch over your home **URL:** \ **Category:** Apps\ **Tags:** app, official, security, homey-pro:mini:shs, heimdall\ **Created:** [August 22, 2018, 1:41pm UTC](https://community.homey.app/t/heimdall-let-homey-watch-over-your-home/134 "2018-08-22T13:41:20Z")\ **Posts on this page:** 1\ **Showing post:** 1
**Author:** ![DaneedeKruyff](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/daneedekruyff/32/964_2.png) [@DaneedeKruyff](https://community.homey.app/u/DaneedeKruyff)\ **Post date:** [August 22, 2018, 1:41pm UTC](https://community.homey.app/t/heimdall-let-homey-watch-over-your-home/134/1 "2018-08-22T13:41:20Z")
## This app enables you to use your Homey as a surveillance system. ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/1X/e2516f41621998daa5430f9b4086fdb5709c86d0.jpeg) ## Supported languages 🇳🇱 Dutch 🇬🇧 English 🇩🇪 German 🇫🇷 French 🇮🇹 Italian 🇸🇪 Swedish 🇳🇴 Norwegian 🇪🇸 Spanish 🇩🇰 Danish ## Links - App Store: [https://apps.athom.com/app/com.uc.heimdall](https://apps.athom.com/app/com.uc.heimdall) - Github: [GitHub - daneedk/com.uc.heimdall: Heimdall for Homey · GitHub](https://github.com/daneedk/com.uc.heimdall) - issues: [Issues · daneedk/com.uc.heimdall · GitHub](https://github.com/daneedk/com.uc.heimdall/issues) - FAQ: [Heimdall - Let Homey watch over your home - #2 by DaneedeKruyff](https://community.homey.app/t/134/2) - Change log: [Heimdall - Let Homey watch over your home - #3 by DaneedeKruyff](https://community.homey.app/t/134/3) - Roadmap: [Heimdall - Let Homey watch over your home - #4 by DaneedeKruyff](https://community.homey.app/t/134/4) * * * If you want to support this app, please consider a donation [![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/3/f/3f15ee3521c6f17180b495add325bfb7e15dd7f6.png)](https://www.paypal.me/daneedekruyff) [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/L3L31BY2KS) Donations are very welcome, though they come with no guarantees, warranties, or preferential treatment (just think of it that you’re donating for the work _already done_, not the work _to be done_). * * * ## How does it work? All detected motion and opened/closed doors/windows on the sensors you select will be seen by _ **Heimdall** _. All these events will be logged and when _ **Heimdall** _ is in a **Surveillance Mode** the **Alarm State** will be activated. ## Instructions - [Select the devices to monitor on the settings page.](#heading--step1) - [Add a Surveillance Mode Switch.](#heading--step2) - [Add methods to control the Surveillance Mode.](#heading--step3) - [Add a flow with the desired actions when the alarm is triggered.](#heading--step4) - [Add a flow to cancel your alarm actions](#heading--step5) - [Add a flow to deactivate the alarm.](#heading--step6) - [Add an Alarm Button.](#heading--step7) After you’ve completed the instructions above and feel comfortable with _ **Heimdall** _ you’re ready for the [Advanced Functions](#heading--advanced) in _ **Heimdall** _ ## Select the devices to monitor on the settings page There are three possible **Surveillance Modes** these are: **Disarmed** , **Armed** and **Partially Armed**. Per sensor you can decide if it will be monitored while **Armed** , **Partially Armed** or in both modes. To give you the opportunity to leave the house after setting an **Armed** or **Partially Armed** mode or to **Disarm** when entering your house you can enable a **Delay** on the desired sensor. ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/1/1d006165a9cc8c8b2036d4e85547958c39d122de.png) [⬆ Instructions overview](#heading--instructions) ## Add a Surveillance Mode Switch Go to the devices and click the _plus_ icon to add a device and select _ **Heimdall** _ from the presented brands. ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/9/e/9e8764d464607678e8d7b7d24f9e88ea44911060.png) Choose the **Mode** device in the devices overview screen… ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/0/8/080844402f74e3ca0d102b78cfaa060d8043d087.jpeg) and click _Install_ followed by clicking _Next_ to finish the installation. [⬆ Instructions overview](#heading--instructions) ## Add methods to control the Surveillance Mode There are several methods to change the **Surveillance Mode** , either by a flow and/or by using the **Surveillance Mode Switch** in the Homey app on your phone. If you have the [Homekitty app](https://homey.app/nl-nl/app/name.klep.homekitty/HomeKitty/) installed you can even use the Homekit app on your iPhone or iPad to set the **Surveillance Mode**. If you want to use a keypad to set the **Surveilance Mode** you can, check out the [Ring Security App](https://community.homey.app/t/47287). To change the **Surveillance Mode** from a flow you will have to use the **Set Surveillance Mode** card from the **Surveillance Mode Switch** as an action. ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/b/3/b3cfe26d30393d5275e8c792bcd31b249c8d0297.png) [⬆ Instructions overview](#heading--instructions) ## Add a flow with the desired actions when the alarm is triggered To set the action Homey should take when the **Alarm State** is activated you need to make a flow with the **The alarm is activated** flow card as the trigger. That flow card has the **Zone** and **Reason** token which will show what sensor was the tripped and which zone it belongs in. ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/8/0/80cae28108be678ccb85c7877de6e5ba1ca2b53a.png) [⬆ Instructions overview](#heading--instructions) ## Add a flow to cancel your alarm actions To cancel the actions Homey takes when the **Alarm State** is activated, so when you deactivate the **Alarm State** , you need to make a flow with the **The alarm is deactivated** flow card as trigger. So, if you enabled a siren in the previous flow, disable it in this flow. ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/a/3/a3997b61843f076e4f979b38cf3ff0d833096c97.png) [⬆ Instructions overview](#heading--instructions) ## Add a flow to deactivate the alarm Deactivating the alarm can be done in either of two ways. The first is by using the **Deactivate Alarm** flow action card, the second by using the **Alarm Button** you can add from the app. ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/f/6/f6baec33e0aa889dbb4c770dcd303e2d5e8719ba.png) [⬆ Instructions overview](#heading--instructions) ## Add an Alarm Off Button Go to the devices and click the _plus_ icon to add a device and select _ **Heimdall** _ from the presented brands. ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/9/e/9e8764d464607678e8d7b7d24f9e88ea44911060.png) Choose the **Alarm** device in the devices overview screen… ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/8/5/85cf7ad7c3aa7a9823815db625c74ec0e2b07da9.jpeg) and click _Install_ followed by clicking _Next_ to finish the installation. [⬆ Instructions overview](#heading--instructions) ## Advanced functions - [Settings](#heading--settings) - [Delays](#heading--delays) - [Last Door functionality](#heading--lastdoor) - [Pre Arming check](#heading--prearming) - [Silent Code](#heading--silentcode) - [Log](#heading--log) - [All Flow Cards](#heading--flowcards) ## Settings ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/5/5e772b33c1a7fe209c0bff066256cb1b705acaba.png) The **Arming Delay** can be used for delaying the changing of the **Surveillance Mode** to give you time to leave the house when using for example an Alarm panel. You can select the delay when arming for each of the armed **Surveillance Modes** , see [Delays](#heading--delays) for more information. The **Alarm Delay** can be used to give you time to set the **Surveillance Mode** to disarmed when entering the house. Both delays can be set to any value in the 0-300 seconds range. ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/6/66cf29e9add36ca824fca3c7b022168e235b515b.png) For logging you can choose to always log any event from a sensor or only when a **Surveillance Mode** is active and you can decide to only log activating of sensors. The setting to also **Listen to tampering reports from sensors** will enable this for all sensors supporting this capability. ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/9/954ececa2e97e1ca4426a95125d7c228aa29661e.png) When the **Surveillance Mode** is set a **Pre Arming Check** is preformed, you can select what type of sensors should be checked during the **Pre Arming Check**. If you use an **Arming Delay** you can also decide to perform the **Pre Arming Check** when the **Arming Delay** starts instead of when the **Surveillance Mode** is actually set. See [Pre Arming Check](#heading--prearming) for more information. ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/9/9e0ab80dd3c017945f690aa232edfdee53ca1845.png) _ **Heimdall** _ can write important events to your Timeline, you can select which events should be written to it. ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/1/106ed621e02b3b4f55ab6663b714d714a3795015.png) And it supports speech output for certain actions. [⬆ Advanced functions overview](#heading--advanced) ## Delays The **Alarm Delay** can be used to give you enough time to set the **Surveillance Mode** to **Disarm** after entering the house through a door that has a door sensor. When a sensor is tripped and the **Surveillance Mode** is in any of the Armed states the **Alarm State** will be set to activated immediately when no **Delayed Trigger** is configured on the triggered device. If the **Delayed Trigger** is configured on the triggered device a countdown will start for the duration of the **Alarm Delay** setting. If the **Surveillance Mode** is not set to **Disarmed** during the countdown on the end of it the **Alarm State** will be activated. When the countdown starts the trigger flow card **The alarm delay is activated** can be used to inform you the countdown has started. The card has three tags, **Zone** , **Reason** and **Duration** which you can use in for example a spoken or a push message. The trigger card **The time until alarm changed** is called every second during the countdown and the tag **Seconds** holds the number off seconds until the **Alarm State** is activated. ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/1/7/17350c5490363f618b4f3aa454868d7040a9354b.png) ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/8/1/81d3bdcf91a9552d850510a0d0cef4344d54dc22.png) When the option **Use delay when enabling Armed mode** or **Use delay when enabling Partially Armed mode** is checked the **The arming delay is activated** card will is activated. The card has one tag; **Duration**. During the countdown the **The time until armed changed** trigger flow card is called every second holding a tag **Seconds** which is again the seconds until the **Surveillance Mode** is activated. ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/f/9/f9a738f013882c01ace0c6c383213283749fe3a2.png) ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/1/5/1538758b7799474762898acd5c379fcaf7c0e9f6.png) [⬆ Advanced functions overview](#heading--advanced) ## Last Door Functionality The **Last Door Functionality** can be used to shorten the **Arming Delay** to 10 seconds after leaving the house. This function is automatically enabled on a Door Sensor that has the **Delayed Trigger** set to _yes_. To use it, just make sure the door is closed when the **Surveillance Mode** is set. When the **Surveillance Mode** is set the normal **Arming Delay** will start, after opening and closing a door which has the **Delayed Trigger** set the **Arming Delay** will be lowered to 10 seconds. [⬆ Advanced functions overview](#heading--advanced) ## Pre Arming check When setting the **Surveillance Mode** to either **Armed** or **Partially Armed** Heimdall can do a **Pre Arming check** , you can choose what sensor types to include: ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/4/438c1efccc0864028afcb6fc61608c560e933d8e.png) When using an **Arming Delay** the **Pre-Arming check** will be done when the actual **Surveillance Mode** is set, so when the delay countdown ends, you can let the **Pre Arming check** be performed before the **Arming Delay** by enabling the **Perform check before Arming Delay** setting. When a sensor is not in the desired state during the **Pre Arming check** the flowcard **Sensor active at arming** will be triggered with the token **Warning** containing the text “Warning, sensor active…” ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/0/b/0bdccddafd1db80d9d3dab527f696f6f910f0467.png) and it will be logged to the history: ![ewafnpxzlzhb](https://us1.discourse-cdn.com/flex025/uploads/athom/original/1X/1308c501af0ed14ab73198b8a9c22893282fdd69.png) There is also the option to let Homey tell you when a sensor is active, see the possible [speech options](#heading--speech) below. [⬆ Advanced functions overview](#heading--advanced) ## Silent Code When using a 3rd party Keypad you can enter an extra digit after your PIN when disarming to be used in a flow. Use the **A Silent Code was received** flow card and a Homey Logic condition card to create a flow to start your desired action. ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/8/9/899bbf8378a7e42e71004bb5d349217c404d1881.png) [⬆ Advanced functions overview](#heading--advanced) ## Log If you do not want a device to activate an **Alarm State** but do want to log if for example motion is detected you can select the **Log** option for that device. ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/b/b487e40fb4a257bb7fe7130c95034032bb2473fe.png) When a device with the **Log** option changes state the **A logline was written** flow card will be triggered. This card has the tags **Zone** , **Device** and **State**. ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/e/f/ef41f89622183d0fdb62ca2a7241f7e5da468d91.png) [⬆ Advanced functions overview](#heading--advanced) ## All Flow Cards **Triggers:** _when…_ ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/0/0/00ee63b17dea91de761a809d89cc7106fc83d9a5.png) ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/2/5/2585f06ebfa10b6d745f3d10f708a1e01d4c267a.png) ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/d/0/d0835bc94c69018f5f96be41f9711f6dfebf4c6c.png) ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/e/8/e8f4d2c4250fc212426659f87d0d42efe9c7042e.png) **Conditions:** _…and…_ ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/7/d/7d9e97a043aef466cf9a0d8b447be0cf24d58158.png) ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/7/7/7761f9e4dcb4c4bc68abe2c2f976886d78c90463.png) ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/3/0/3036fd5ab176d93bc12fcd46c185e22d57fa66eb.png) **Actions:** _..then_ ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/c/f/cfe6a1310f1838e53190fa8c9e6866d7ca23df6e.png) ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/1/1/1165fd1c5e296aeb8313634a3513809e5856f05f.png) ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/d/9/d96792f1c8837f233e664caa1ec532275dde5f9b.png) ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/2/a/2af24100e6f0d32549f4366fa65a45cccc6c6dd4.png) ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/f/9/f9b8f873d1fef1d59897e5cf8429e1cb7bbb6f80.png) ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/6/5/6545c0346b7aaa841c5cae5aa783406807e61200.png) [⬆ Advanced functions overview](#heading--advanced) If you have any questions and or remarks please post them here. --- _[View the full topic](https://community.homey.app/t/heimdall-let-homey-watch-over-your-home/134)._