Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kopiro/homebridge-tapo-camera
Homebridge plugin for TP-Link TAPO security cameras
https://github.com/kopiro/homebridge-tapo-camera
camera homebridge homebridge-plugin homekit
Last synced: 1 day ago
JSON representation
Homebridge plugin for TP-Link TAPO security cameras
- Host: GitHub
- URL: https://github.com/kopiro/homebridge-tapo-camera
- Owner: kopiro
- License: isc
- Created: 2021-10-05T19:29:13.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-01-21T22:36:24.000Z (9 days ago)
- Last Synced: 2025-01-22T08:01:44.355Z (9 days ago)
- Topics: camera, homebridge, homebridge-plugin, homekit
- Language: TypeScript
- Homepage:
- Size: 480 KB
- Stars: 138
- Watchers: 8
- Forks: 13
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# homebridge-tapo-camera
Make your TP-Link TAPO security camera compatible with Homekit through Homebridge / HOOBS.
[](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
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](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](https://github.com/JurajNyiri/HomeAssistant-Tapo-Control/blob/main/add_camera_with_new_firmware.md) 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:
```sh
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](https://github.com/homebridge/ffmpeg-for-homebridge) binaries manually.