homebridge-doorbird is a plugin for Homebridge. Giving you an integrated experience with your DoorBird unit.
It provides; a camera stream using the FFMpeg plugin project as a basis for this DoorBird Platform. The doorbell is part of the camera as a service. Motion sensor, lock mechanism and light service is all included. Activate notifications on the sensor(s) if you want iOS notifications pushed to your Home screen (requires a HomeKit Hub e.g. Apple TV or iPad for remote access). You will see the Intercom on your DoorBird stream, however this is not supported in FFMpeg currently, it needs work.
If you are new to Homebridge, please first read the Homebridge documentation.
1 Install Homebridge:
sudo npm install -g homebridge2 Install FFMpeg, and setup Google Drive (optional) as per FFMpeg plugin
3 Install homebridge-doorbird:
sudo npm install -g homebridge-doorbird4 Configure plugin:
Update your configuration file. See config.json in this repository for a sample. Swap xxx for IP or credentials, wherever appropriate.
Try either RTSP or MJPEG for your camera stream, stability and speed is variable between the two:
-re -f mjpeg -i http://xxxusername:xxxpassword@xxx.xxx.xxx/bha-api/video.cgi
-rtsp_transport tcp -re -i rtsp://xxxusername:xxxpassword@xxx.xxx.xxx:8557/mpeg/media.amp
- Add Accessory: Add DoorBird accessory in Home app. The setup code is the same as homebridge. The device does not appear automatically in Home app. It requires you to add the Accessory and onboard it.
Add the platform in config.json in your home directory inside .homebridge.
This uses the DoorBird notifications API, you must register your endpoint(s) like so as DoorBird will make calls to the included webserver using DoorBird's notification api:
- Doorbell
wget -q 'http://doorbird-ip/bha-api/notification.cgi?http-user=XXX&http-password=XXX&event=doorbell&subscribe=1&url=http://homebridge-ip:5005/doorbell.html'- Motion sensor
wget -q 'http://doorbird-ip/bha-api/notification.cgi?http-user=XXX&http-password=XXX&event=motionsensor&subscribe=1&url=http://homebridge-ip:5005/motion.html'You can check your API registrations inside the DoorBird app itself, under Administration -> HTTP Calls.
If you want command line events to fire off on Doorbell and Motion Sensor, then add the call(s) in your config.json to the cmd_doorbell or cmd_motionsensor.
This is useful if you want Homebridge to talk to other home automation endpoints, you can add a simple wget -q foo.
- Relays and Devices
The default relay for the plugin to lock/unlock is the first relay in the Video Door Station.
Doorbird supports multiple relays in the door station itself and on the following optionally attached peripheral devices:
- A1081 E/A Controller (https://www.doorbird.com/downloads/manual_a1081_en_de.pdf) - TESTED
- A1101 Indoor Station (https://www.doorbird.com/downloads/datasheet/datasheet_a1101_en.pdf) - UNTESTED
You may switch the lock/unlock functionality to any of the relays in either the door station, E/A controller or the indoor station (UNTESTED).
Sample Config snippet for alternate relay:
"relay_no": "2"
Sample Config snippet for peripheral device:
"use_peripheral": true,
"peripheral_name": "gggggg",
"peripheral_relay_no": "1",
The name of the controller or station can be found in the App: Administration > Peripherals > Device (6-letter word)
ToDo: expose additional relays and digital inputs in homekit