Skip to content

kopiro/homebridge-tapo-camera

Repository files navigation

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

  • "Eyes" controls the privacy mode; when it's on it means that the camera is able to see (this is to make sure we support the command "Hey Siri, turn on Camera", as this will disable privacy mode).

  • "Alarm" switches on/off the alarm sound.

  • "Notifications" switches on/off the notifications sent to your TAPO app.

  • "Motion Detection" switches on/off the motion detection system.

  • "LED" switches on/off the LED.

An example Home automation could be:

  • When leaving home, enable Eyes, Alarm, Notifications, Motion Detection, LED
  • When arriving home:
    • If you care about your privacy, disable Eyes to switch on privacy mode
    • If you want the camera always on, but no notifications, just disable Alarm and Notifications

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.