# \[APP\]\[Pro&Cloud\] DoorBird

**URL:** <https://community.homey.app/t/app-pro-cloud-doorbird/115>\
**Category:** Apps\
**Tags:** app, homey-pro, homey-service\
**Created:** [August 22, 2018, 11:00am UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115 "2018-08-22T11:00:53Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![TedTolboom](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/tedtolboom/32/12081_2.png) [@TedTolboom](https://community.homey.app/u/TedTolboom)\
**Post date:** [August 22, 2018, 11:00am UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/1 "2018-08-22T11:00:53Z")

</div>

![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/b/5/b5f4dd7a0442f0a042bc9230d3fda71f806a0621.png)

# DoorBird for Homey

**App Store Page:** [DoorBird | Homey](https://homey.app/a/com.doorbird)

## Description

Use Homey together with a [DoorBird IP Video Door Station](https://www.doorbird.com/). Let the DoorBird notify Homey when the doorbell is rang or when motion is detected, use Homey to control the DoorBird relay, trigger the IR light or send a snapshot through email.

## Instructions

### Adding the DoorBird as device

After installation of the Homey app you need to add your DoorBird(s) as device in Homey. This requires you to enter the credentials of a valid user account. For pairing with Homey Cloud this needs to be the admin user. For pairing with Homey Pro you need a user with the correct permissions. This user can be created through the DoorBird smartphone app. Best is to use a separate account for this and make sure this user is granted API-operator permissions as this is needed for communication with Homey Pro.

### Notifications from DoorBird to Homey

> **View the instructions**
>
> For the doorbell alarm, motion alarm, doorbell rang, motion detected and door open trigger flow cards to work in Homey the DoorBird needs to be configured to send HTTP notifications for these events to Homey. During pairing you will be given the option to configure a notification schedule. If you are using the HTTP notifications from the DoorBird for other purposes you can opt-out, otherwise leave this option enabled to ensure your DoorBird is able to communicate with Homey. You can always remove are re-add the notification schedule at a later time as well through the maintenance actions of your DoorBird.

### Setting up email

> **View the instructions**
>
> To be able to send snapshots through email you will need to configure an email account which sends out the email. In the general settings of the DoorBird app there is a section to configure your email account. Please pay attention to the extra information when adding a Gmail account, this requires you to use a specific app password which needs to be setup within your Google account.

### Playing Sound Files

> **View the instructions**
>
> On Homey Pro the DoorBird app for Homey will allow you to play audio files through flows. This can for instance be used to play a standard message over the intercom when somebody rings the bell and you are not at home telling the visitor to wait until you speak to them. DoorBird is however very picky as to what audio it will play and you cant just use any mp3 file. The audio file also needs some silence at the start as DoorBird does not play the file send from Homey from the start (this needs further investigation). Below are the basic steps to get this to work.
> 
> 1. Create the audio file you want to play, for instance by using online text-to-speech services. Keep your messages short as there is a limit of 900Kb for each file.
> 2. Install an audio editing program which allows you to edit the audio but also export it as decoded raw audio. These steps use Audacity as reference. A free and multi-platform audio editor.
> 3. Open the audio file in the audio editor and add about 1 second of silence at the front of the file. How this is done depends on the audio editor you are using but usually you can just copy a silent part and paste it until you have the one second silence.
> 4. Export the file with the following configuration.
> 
> - **Format** : uncompressed audio
> - **Channels** : Mono
> - **Sample rate** : 8000 Hz
> - **Header** : RAW (header-less)
> - **Encoding** : U-Law
> 
> 1. Save it with the .raw extension.
> 2. Upload the file on the DoorBird app settings page in Homey and use it with the _Play Sound_ action flow card available under the device.

### Known issues

- When paired with Homey Cloud it can happen that the images are not available. The workaround is to reinstall the app from the app store to force an app reboot. This should eventually result in the images being displayed.

---

<div class="post-metadata">

**Author:** ![Phuturist](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/phuturist/32/49_2.png) [@Phuturist](https://community.homey.app/u/Phuturist)\
**Post date:** [August 22, 2018, 11:41am UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/2 "2018-08-22T11:41:07Z")

</div>

# Changelog

> ## v3.1.2 - 2021-12-03
> 
> - Added support for Homey Cloud

> ## v3.0.8 - 2021-07-08
> 
> - Switched to manual discovery strategy as Homey firmware 7.x marks devices as offline when mDNS is not working on the users network and the device has been paired manually.

> ## v3.0.6 - 2021-05-11
> 
> Update of underlying library to patch a security vunerability, no functional changes.

> ## v3.0.5 - 2021-03-31
> 
> - Added an opt-out option for scheduling notification events during pairing to make setup more user friendly.

> ## v3.0.4 - 2021-03-04
> 
> - Updated the app description

> ## v3.0.3 - 2021-03-02
> 
> - Updated the branding with new logo, app color and images

> ## v3.0.2 - 2021-02-22
> 
> - Update to SDK3 (requires Homey firmware 5.x).
> - Changed the relay functionality from a button to a slider under the device to avoid accidentally opening the door.
> - Moved the functionality for adding the HTTP notifications from the app settings to the individual device settings for a more robust configuration. This requires you to re-configure your notifications in the DoorBird smartphone app though. See the support forum for more information.
> - Added manual pairing fo those situations where mDNS is not working
> - Added a extra relay sliders for devices that support multiple relays

> ## v.2.4.5 - 2020-04-14
> 
> Small code improvements, no functional changes.

> ## v2.4.3 - 2019-08-13
> 
> - FIX: fix for motion snapshot token (it displayed the live snapshot)
> - IMPROVEMENT: better error handling when permissions have not been configured correcty

> ## v2.4.2 - 2019-08-11
> 
> - FIX: small fix for devices being unavailable
> - FIX: small fix for quirky pairing wizard template

> ## v2.4.0 - 2019-08-08
> 
> IMPROVEMENT: implemented device discovery

> ## v2.3.4 - 2019-08-05
> 
> FIX: fixed setting the notification URLs from the app settings page

> ## v2.3.3 - 2019-07-17
> 
> FIX: small fix for relay as button capability

> ## v2.3.2 - 2019-07-12
> 
> - NEW: add default relay as button capability so it shows up as button in the mobile app under the device (requires repairing)

> ## v2.3.0 - 2019-05-24 & 2.3.1 - 2019-05-27
> 
> BREAKING CHANGES: this update will break the snapshot tokens, both the global and the trigger card tokens. The snapshot tokens have been updated to an officially supported image token that has been made available with firmware 2.2.0 and smartphone app version 2.4.0. You will have to update your flows where these snapshot tokens are in use. This update will install from firmware 2.2.0 and up.
> 
> - IMPROVEMENT: support for the new devices / driver images
> - IMPROVEMENT: improved performance for snapshots on trigger cards

> ## v2.2.8 - 2019-03-04
> 
> - FIX: improvements to pairing and settings template for firmware 2.x
> - FIX: code improvements to avoid continous spinner on email snapshot action cards

> ## v2.2.7 - 2018-12-27
> 
> FIX: removed incoming IP address security validation in api.js due to Athom removing the request object in firmware 2.x

> ## v2.2.6 - 2018-12-14
> 
> FIX: update compatibility to enable install on Homey firmware v2.x

> ## v2.2.5 - 2018-11-06
> 
> FIX: fix issue with pairing wizard preventing new DoorBirds to be added to Homey

> ## v2.2.4 - 2018-10-10
> 
> - NEW: extended the “open door” action card with a dropdown where you can select the desired relay (for DoorBird devices with more than 1 relay)
> - NEW: added a token with the relay name to the “door has been opened” trigger card allowing you to identify which relay has been triggered (for DoorBird devices with more than 1 relay, this requires you to re-add the notifications from the DoorBird Homey app settings page)
> - FIX: fixed the “ask to open door” action card

> ## v2.2.3 - 2018-09-08
> 
> - REFACTORING: switched from request node module to node-fetch (reduced footprint from 9MB to 1,5MB)
> - UPDATE: removed settings for scheduling relay notifications, this can now be set in the DoorBird smartphone app

> ## v2.2.2 - 2018-08-22
> 
> - DOCS: updated the description to explain in more detail how to configure the door relay trigger
> - UPDATE: updated app manifest to include id of new forum support topic
> - UPDATE: updated node packages to latest versions

> ## v2.2.1 - 2018-04-26
> 
> - FIX: fixed a bug which would cause issues with notifications for DoorBirds paired on v2.2.0

---

<div class="post-metadata">

**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 23, 2018, 8:53am UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/3 "2018-08-23T08:53:13Z")

</div>

With this app you can use your DoorBird as a motion sensor for [Heimdall](https://community.homey.app/t/134)

![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/1X/2b5a02d5c1fe08bdce241148cb00e568d0e8d9f0.png)

---

<div class="post-metadata">

**Author:** ![z3mrunner](https://avatars.discourse-cdn.com/v4/letter/z/85f322/32.png) [@z3mrunner](https://community.homey.app/u/z3mrunner)\
**Post date:** [August 26, 2018, 9:41am UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/4 "2018-08-26T09:41:33Z")

</div>

I am new, so not sure if this is the right place to post.  
In a former discussion I saw someone with the same problem:

 ![doorbird](https://us1.discourse-cdn.com/flex025/uploads/athom/original/1X/8fa95240d9b49a45e051456c77082547946a5b84.png)  
I double checked the IP, user en password but it still does not work.  
I use static IP adresse and the Doorbird is connected by ethernetcable.  
You posted earlier:  
[https://github.com/jghaanstra/com.doorbird/tree/debug](https://github.com/jghaanstra/com.doorbird/tree/debug)  
I tried to click on the link but I received a 404 error.

I am still very eager to use your app. Is there a way to debug my problem?  
Thnks in advance

---

<div class="post-metadata">

**Author:** ![z3mrunner](https://avatars.discourse-cdn.com/v4/letter/z/85f322/32.png) [@z3mrunner](https://community.homey.app/u/z3mrunner)\
**Post date:** [August 26, 2018, 10:13am UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/5 "2018-08-26T10:13:38Z")

</div>

Problem solved by logging into the doorbird with the same account.

---

<div class="post-metadata">

**Author:** ![Phuturist](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/phuturist/32/49_2.png) [@Phuturist](https://community.homey.app/u/Phuturist)\
**Post date:** [September 11, 2018, 6:10pm UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/6 "2018-09-11T18:10:48Z")

</div>

> ## v2.2.3 - 2018-09-08
> 
> - REFACTORING: switched from request node module to node-fetch (reduced footprint from 9MB to 1,5MB)
> - UPDATE: removed settings for scheduling relay notifications, this can now be set in the DoorBird smartphone app

---

<div class="post-metadata">

**Author:** ![AdrianLiteAuto](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/adrianliteauto/32/8740_2.png) [@AdrianLiteAuto](https://community.homey.app/u/AdrianLiteAuto)\
**Post date:** [October 10, 2018, 6:41am UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/7 "2018-10-10T06:41:23Z")

</div>

my first post. New user here.  
I have added the doorbird intercom, a very useful app. Thank you.  
I guess you dont have a new d2101 to test with? These new doorbird units now have 2 relays to control, any chance of adding functionality to control the second relay also please?

Thanks.

---

<div class="post-metadata">

**Author:** ![AdrianLiteAuto](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/adrianliteauto/32/8740_2.png) [@AdrianLiteAuto](https://community.homey.app/u/AdrianLiteAuto)\
**Post date:** [October 10, 2018, 6:45am UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/8 "2018-10-10T06:45:44Z")

</div>

Also noticed that having Homey ask you if you want to open the door, doesn;t actually trigger the relay.  
I can trigger this with a virtual device(lock) and a flow card, but not via a flow as attached. Any ideas?

 ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/d/d2a8827cd42e740ff140ee826cafe48d64332c5e.jpeg)

---

<div class="post-metadata">

**Author:** ![Phuturist](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/phuturist/32/49_2.png) [@Phuturist](https://community.homey.app/u/Phuturist)\
**Post date:** [October 10, 2018, 10:09am UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/9 "2018-10-10T10:09:57Z")

</div>

> [@AdrianLiteAuto](#):
>
> I guess you dont have a new d2101 to test with? These new doorbird units now have 2 relays to control, any chance of adding functionality to control the second relay also please?

I see the API has been updated to support multiple relays. I just need to figure out how to properly support this without being able to test it (I dont have a d2101 laying around 😉 )

> [@AdrianLiteAuto](#):
>
> Also noticed that having Homey ask you if you want to open the door, doesn;t actually trigger the relay

Hmm, I’ll look into this as well.

And thank you for your donation, it’s very much appreciated … 🙏

---

<div class="post-metadata">

**Author:** ![AdrianLiteAuto](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/adrianliteauto/32/8740_2.png) [@AdrianLiteAuto](https://community.homey.app/u/AdrianLiteAuto)\
**Post date:** [October 11, 2018, 2:50am UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/10 "2018-10-11T02:50:35Z")

</div>

no problem, new api is quite detailed, so shouldnt be an issue to update. Could you add support for the IO controller also, should be same configuration as multiple relays.  
If you need access to one to test with, I can add you as a user with api access to our one in the showroom, it has a IO controller also.  
If you can add the additional relay, i’ll even pop in another little donation 😉

---

<div class="post-metadata">

**Author:** ![AdrianLiteAuto](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/adrianliteauto/32/8740_2.png) [@AdrianLiteAuto](https://community.homey.app/u/AdrianLiteAuto)\
**Post date:** [October 11, 2018, 5:22am UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/11 "2018-10-11T05:22:58Z")

</div>

Sorry, Another thing if it could be modified is the device widget. Within the app the device widget of the Doorbird shows the motion sensor and “generic alarm”(not sure what this is). Can this be changed to allow direct use of the relays 1&2 instead. I have had to create a virtual device and Flow to trigger the Door relays. it would look much cleaner if it were part of the Doorbird Device Widget.  
you can pm me on slack at #LiteAutomation  
Cheers

---

<div class="post-metadata">

**Author:** ![Phuturist](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/phuturist/32/49_2.png) [@Phuturist](https://community.homey.app/u/Phuturist)\
**Post date:** [October 11, 2018, 5:56am UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/12 "2018-10-11T05:56:24Z")

</div>

> [@AdrianLiteAuto](#):
>
> Could you add support for the IO controller also, should be same configuration as multiple relays.

I published a new release yesterday which allows you to select any of the registered relays for the DoorBird. Please have a look if this works for the io controllers as well.

> [@AdrianLiteAuto](#):
>
> Can this be changed to allow direct use of the relays 1&2 instead. I

This would require a pretty big change to the app and would require everyone to re-pair and recreate their flows. I need to think about that. I’ll probably wait until Homey 2.x and the new mobile app are available.

---

<div class="post-metadata">

**Author:** ![AdrianLiteAuto](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/adrianliteauto/32/8740_2.png) [@AdrianLiteAuto](https://community.homey.app/u/AdrianLiteAuto)\
**Post date:** [October 11, 2018, 6:20am UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/13 "2018-10-11T06:20:08Z")

</div>

I understand. It just seems more suitable to have direct action with the relays rather than to see if the motion sensor has been activated. Meanwhile ill just set up virtual devices.  
Should I remove and re-add the doorbird or just reapply the http URL notifications?

---

<div class="post-metadata">

**Author:** ![Phuturist](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/phuturist/32/49_2.png) [@Phuturist](https://community.homey.app/u/Phuturist)\
**Post date:** [October 11, 2018, 9:16am UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/14 "2018-10-11T09:16:11Z")

</div>

> [@AdrianLiteAuto](#):
>
> Should I remove and re-add the doorbird or just reapply the http URL notifications?

Re-adding will only be necessary once I as the relays as capability (which is required for them to show in the device card). There is also no need to re-apply the htpp notifications. You will need to update your flow however if you use the open door action card. But the update still needs to be approved by Athom. I will post the changelog here once published.

---

<div class="post-metadata">

**Author:** ![Phuturist](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/phuturist/32/49_2.png) [@Phuturist](https://community.homey.app/u/Phuturist)\
**Post date:** [October 18, 2018, 4:42pm UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/15 "2018-10-18T16:42:52Z")

</div>

> ## v2.2.4 - 2018-10-10
> 
> - NEW: extended the “open door” action card with a dropdown where you can select the desired relay (for DoorBird devices with more than 1 relay)
> - NEW: added a token with the relay name to the “door has been opened” trigger card allowing you to identify which relay has been triggered (for DoorBird devices with more than 1 relay, this requires you to re-add the notifications from the DoorBird Homey app settings page)
> - FIX: fixed the “ask to open door” action card

---

<div class="post-metadata">

**Author:** ![IAmJos](https://avatars.discourse-cdn.com/v4/letter/i/6f9a4e/32.png) [@IAmJos](https://community.homey.app/u/IAmJos)\
**Post date:** [November 6, 2018, 10:15pm UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/16 "2018-11-06T22:15:08Z")

</div>

Hi, new to Doorbird and Homey here.

Installing Doorbird with a bit of help was not the hardest thing. The Doorbird connects to my phone and to the tablet when the button is pressed. All good.

The trickier part would be connecting to Homey: I add the IP Address, username and password but the ‘connect’ /'Verbind’button never gets visible. When I hit “Test Connection” nothing happens. This is the same behaviour I get when I try to set the DoorBird Notification HTTP URLS.

Any idea where I am already blocking?

Joris

---

<div class="post-metadata">

**Author:** ![Phuturist](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/phuturist/32/49_2.png) [@Phuturist](https://community.homey.app/u/Phuturist)\
**Post date:** [November 6, 2018, 10:26pm UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/17 "2018-11-06T22:26:59Z")

</div>

> [@IAmJos](#):
>
> Any idea where I am already blocking?

Hmm, it seems a bug has made it into the pairing wizard and is preventing new DoorBirds to be added. I’ll look into it and release a fix. If no DoorBirds have been added to Homey you can not setup the notifications URLs either.

I’ll see if I can submit a fix this evening, then it’s up to Athom to approve the update.

---

<div class="post-metadata">

**Author:** ![Alex\_B](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/alex_b/32/36643_2.png) [@Alex\_B](https://community.homey.app/u/Alex_B)\
**Post date:** [November 7, 2018, 9:11pm UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/18 "2018-11-07T21:11:00Z")

</div>

Hi, I have also the problem that I can’t connect the doorbird with homey. Doorbird is working fine with the DoorBird app. Sometimes I have the message Unknown error, are you sure you have entered the correct IP address and Homey is on the same network as the DoorBird? Please check your settings and try again. But most time nothing happens.

I have double checked the settings. I have this problem with the doorbird connected by WiFi and LAN. And connecting via the homey app and online. The doorbird runs on firmware version 000112. Connecting doorbird with [http://xxx/bha-api/view.html](http://xxx/bha-api/view.html) works fine.

---

<div class="post-metadata">

**Author:** ![Phuturist](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/phuturist/32/49_2.png) [@Phuturist](https://community.homey.app/u/Phuturist)\
**Post date:** [November 8, 2018, 4:44pm UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/19 "2018-11-08T16:44:13Z")

</div>

There is a fix for this pending in the app store and waiting for Athom to approve it. If you can’t wait you could install it from github using the command line install.

---

<div class="post-metadata">

**Author:** ![IAmJos](https://avatars.discourse-cdn.com/v4/letter/i/6f9a4e/32.png) [@IAmJos](https://community.homey.app/u/IAmJos)\
**Post date:** [November 9, 2018, 10:44am UTC](https://community.homey.app/t/app-pro-cloud-doorbird/115/20 "2018-11-09T10:44:42Z")

</div>

Great! Looking forward to test it!

[Next page](https://community.homey.app/t/app-pro-cloud-doorbird/115.md?page=2)
