# \[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:** 1\
**Showing post:** 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.

---

_[View the full topic](https://community.homey.app/t/app-pro-cloud-doorbird/115)._
