TypeScript ISC

homebridge-tapo-camera

Homebridge plugin for TP-Link TAPO security cameras

K

kopiro

Dernière activité 29 sept. 2026
kopiro/homebridge-tapo-camera

170

étoiles

25

forks

7

issues ouvertes

camerahomebridgehomebridge-pluginhomekit

Ce README est souvent en anglais.

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://homebridge-plugins.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.

Update March 2025 In the Tapo app, go to "Me" (bottom right), then "Tapo Lab", then "Third-Party Compatibility", change to "On" and the integration should start working again.

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.

  • "Floodlight" switches on/off the floodlight (only for supported cameras, opt-in via config).

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.

Expose only switches and sensors

If your camera is already paired with HomeKit natively, you can use this plugin only for the TAPO controls that native HomeKit does not expose.

Set disableStreaming to true to skip the Homebridge camera stream while keeping the toggle accessories. If you also do not want the ONVIF motion sensor, set disableMotionSensorAccessory to true; in that setup, streamUser and streamPassword are not required.

{
  "name": "My Camera Controls",
  "ipAddress": "192.168.0.XXX",
  "password": "your-tapo-password",
  "disableStreaming": true,
  "disableMotionSensorAccessory": true
}

To keep the ONVIF motion sensor enabled, provide streamUser and streamPassword from the TAPO app camera account.

RTSP transport

Camera streams use UDP by default. Set rtspTransport to "tcp" for a camera if UDP is unreliable on your network.

{
  "name": "My Camera",
  "rtspTransport": "tcp"
}

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.

Projets similaires

Control for Tapo cameras as a Home Assistant component

Pythoncameracamerashome-assistant
JJurajNyiri
2 k étoiles159

HomeKit support for the impatient.

TypeScripthaphomebridgehomekit
Hhomebridge
25,5 k étoiles2 k

Homebridge Plugin Providing FFmpeg-based Camera Support

TypeScriptaudiocameraffmpeg
Hhomebridge-plugins
1,1 k étoiles234