Heimdall - Let Homey watch over your home.
This app enables you to use your Homey as a surveillance system.
- App Store: https://apps.athom.com/app/com.uc.heimdall
- Github: https://github.com/daneedk/com.uc.heimdall
- issues: https://github.com/daneedk/com.uc.heimdall/issues
- FAQ: Heimdall - Let Homey watch over your home
- Change log: Heimdall - Let Homey watch over your home
Please leave a rating or review in the app store.
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 will be triggered.
- Select the devices to monitor on the settings page.
- Add a Surveillance Mode Switch.
- Add flows to activate and deactivate the desired Surveillance Mode.
- Add a flow with the desired actions when the alarm is triggered.
- Add a flow to deactivate the alarm.
- Add an Alarm Button.
After you’ve completed the instructions above and feel comfortable with Heimdall you’re ready for the Advanced Functions 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 Delayed Trigger on the desired sensor.
Add a Surveillance Mode Switch
Go to the devices page and when adding a device select the Mode device from the Heimdall app.
Select the Surveillance device and click next for the device to be added.
Add flows to activate and deactivate the desired 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 Homeykit app installed you can even use the Homekit app on your iPhone or iPad to set the Surveillance Mode.
To change the Surveillance Mode from a flow you will have to use the Set Surveillance Mode card from the Surveillance Mode Switch in the …then column.
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.
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.
Add an Alarm Button
Go to the devices page and when adding a device select the Alarm device from the Heimdall app.
Select the Alarm device and click next for the device to be added.
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 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.
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.
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 for more information.
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 delay is activated can be used to inform you the countdown has started. The card has two tags, Duration and Reason which you can use in for example a spoken or a push message. The trigger flow 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.
When the option Use delay when enabling Armed mode or Use delay when enabling Partially Armed mode is checked you will have enough time to leave your house after activating. 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.
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.
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:
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 checking the Perform Pre-Arming 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…”
and it will be logged to the history:
There is also the option to let Homey tell you when a sensor is active, see the possible speech options below.
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.
When a device with the Log option changes state the A logline was written flow card will be triggered.
Heimdall supports speech output for certain actions
All Flow Cards
If you have any questions and or remarks please post them here.