kopiro / homebridge-tapo-camera

Homebridge plugin for TP-Link TAPO security cameras
ISC License
134 stars 12 forks source link
camera homebridge homebridge-plugin homekit

homebridge-tapo-camera

Make your TP-Link TAPO security camera compatible with Homekit through Homebridge / HOOBS.

verified-by-homebridge

photo_2021-11-23 11 57 48

The plugin exposes the camera RTSP video feed, and toggle accessories to configure your automations.

If your video feed is not working, try to check if any of the parameters at the video config can be tuned. You can use https://sunoo.github.io/homebridge-camera-ffmpeg/configs to check if someone has already found the right values for your camera.

[!IMPORTANT] On firmware build 230921 and higher, please follow this guide to make your camera compatible with this integration.

Toggle accessories

An example Home automation could be:

Motion sensor

The motion detection sensor is built on top of the ONVIF protocol and it is enabled by default.

Therefore you can set up automations and Homekit can send you notification in the Home app when motion is detected.

Make sure you activate "Activity Notifications" in the "Status and Notifications" tab in the accessory.

[!NOTE]
Some people may have issues resulting the plugin crashing at startup when this option is enabled. If you see an error like Error: read ECONNRESET at TCP.onStreamRead try to disable the motion sensor by setting disableMotionSensorAccessory to true

Installation

You can install it via Homebridge UI or manually using:

npm -g install homebridge-tapo-camera

Configuration

It is highly recommended that you use either Homebridge Config UI X or the HOOBS UI to install and configure this plugin.

FFmpeg installation

The plugin should take care of installing the ffmpeg automatically.

[!IMPORTANT]
If you're getting errors like FFmpeg exited with code: 1 and signal: null (Error), please follow the instructions here on how to install ffmpeg-for-homebridge binaries manually.