homebridge-doorbell-telegram-photo v0.4.0

homebridge-doorbell-telegram-photo

homebridge-doorbell-telegram-photo is a homebridge plugin to send pictures to Telegram chats e.g. based on a trigger, for example on a doorbell ring.

As input sources you can use:

• a http(s) URL for snapshots e.g. provided from your camera

• a ffmpeg command to grab a snapshot from the camera's video stream

The plugin adds a switch to be used for an automation rule to trigger in case of an doorbell event.

The plugin supports Basic Auth and Digest Auth and can extract the credentials from the URL if they provided in the form of http(s)://USER:PASSWORD@host/path

Installation

• Install the plugin via Config UI X
• Create a Telegram Bot as described in the link, if required

• Configure the plugin settings via Config UI X:

  • Provide an individual name of the camera
  • Provide the bot Id of the Telegram Bot (without the leading "bot" in the bot Id). The bot Id is received from bot father once the bot is created
  • Provide one or more chat Ids of the Telegram Chat to send the pictures to. Usually the first sign of the chat Id is a minus sign which must be included. To find out the chat Id you can send a telegram message to the bot in the desired chat and then open the following url in the browser: https://api.telegram.org/[BOT_ID]/getUpdates. (include the leading bot in the botId). Copy the chat Id from here
  • Check "use ffmpeg" option if your camera does not support an http(s) url for snapshots.
  • In the url field either provide the http URL for the snapshot of the camera or the ffmpeg command, e.g.:

    -i rtsp://...

  -fflags nobuffer -flags low_delay -fflags discardcorrupt -analyzeduration 0 -probesize 2000 -rtsp_transport tcp -i rtsp://...

• In Home App add an automation rule that triggers the switch of this plugin in case of an doorbell event