<p align="center">
   <a href="https://github.com/homebridge-plugins/homebridge-eufy-security"><img src="https://raw.githubusercontent.com/wiki/homebridge-eufy-security/plugin/img/homebridge-eufy-security.png" width="456px"></a>
</p>

<p align="center">
  <strong>Control your Eufy Security devices from Apple HomeKit</strong>
</p>

<p align="center">
  <a href="https://www.npmjs.com/package/homebridge-eufy-security"><img src="https://img.shields.io/npm/v/homebridge-eufy-security?color=green&label=stable" alt="stable"></a>
  <a href="https://github.com/homebridge-plugins/homebridge-eufy-security/wiki/Special-Version-(BETA---RC---HKSV)"><img src="https://img.shields.io/npm/v/homebridge-eufy-security/beta?label=beta" alt="beta"></a>
  <a href="https://github.com/homebridge/homebridge/wiki/Verified-Plugins"><img src="https://badgen.net/badge/homebridge/verified/purple" alt="verified"></a>
  <a href="https://www.npmjs.com/package/homebridge-eufy-security"><img src="https://img.shields.io/npm/dt/homebridge-eufy-security" alt="downloads"></a>
  <a href="https://discord.com/channels/432663330281226270/876907345962229791"><img src="https://img.shields.io/discord/432663330281226270?color=728ED5&logo=discord&label=discord" alt="discord"></a>
</p>

---

## ✨ Features

| | |
|---|---|
| 🎥 **Live Streaming** | P2P & RTSP livestream in the Home app |
| 📹 **HomeKit Secure Video** | Record and review clips natively in HomeKit |
| 🔔 **Doorbell & Sensors** | Ring notifications, motion & entry sensors |
| 🔐 **Locks & Guard Modes** | Smart lock control, arm/disarm your station |
| 🏠 **Bridged & Unbridged** | Run cameras as separate accessories for performance |

> **Supported devices** — Cameras, doorbells, floodlights, indoor cams, locks, sensors, stations & more.  
> See the full [Supported Devices](https://github.com/homebridge-plugins/homebridge-eufy-security/wiki/Supported-Devices) list.

---

## 🚀 Getting Started

| Requirement | |
|---|---|
| [Homebridge](https://homebridge.io) | `>=1.9.0` |
| Node.js | `20`, `22` or `24` |
| Eufy Account | A [dedicated guest account](https://support.eufylife.com/s/article/Share-Your-eufySecurity-Devices-With-Your-Family) is **mandatory** |

> **💡 Node.js & RSA_PKCS1_PADDING** — Node.js `18.19.1+`, `20.11.1+` and `21.6.2+` removed `RSA_PKCS1_PADDING` which affects P2P livestream on some devices. The plugin includes a built-in **Embedded PKCS1 Support** setting that works around this on Node.js 20 and 22. Node.js `24.5.0+` restores native support. See the [compatibility guide](https://github.com/homebridge-plugins/homebridge-eufy-security/wiki/Node.js-Compatibility-with-Eufy-Security-Plugin) for details.

---

## 📖 Documentation

| Setup | Features | Help |
|---|---|---|
| [Installation](https://github.com/homebridge-plugins/homebridge-eufy-security/wiki/Installation-and-Configuration#installation) | [Streaming](https://github.com/homebridge-plugins/homebridge-eufy-security/wiki/Streaming-Settings) | [Troubleshooting](https://github.com/homebridge-plugins/homebridge-eufy-security/wiki/Basic-Troubleshooting) |
| [Configuration](https://github.com/homebridge-plugins/homebridge-eufy-security/wiki/Installation-and-Configuration#configuration) | [HomeKit Secure Video](https://github.com/homebridge-plugins/homebridge-eufy-security/wiki/HomeKit-Secure-Video) | [Common Issues](https://github.com/homebridge-plugins/homebridge-eufy-security/wiki/Common-Issues) |
| [Bridged & Unbridged](https://github.com/homebridge-plugins/homebridge-eufy-security/wiki/Bridged-and-Unbridged-Mode-and-Problems) | [Supported Devices](https://github.com/homebridge-plugins/homebridge-eufy-security/wiki/Supported-Devices) | [Report a Bug](https://github.com/homebridge-plugins/homebridge-eufy-security/issues/new/choose) |
| [Beta Versions](https://github.com/homebridge-plugins/homebridge-eufy-security/wiki/Special-Version-(BETA---RC---HKSV)) | | [Changelog](https://github.com/homebridge-plugins/homebridge-eufy-security/blob/master/CHANGELOG.md) |

---

## 💛 Supporting

| Active Contributors |
|---|
| [Lenoxys](https://github.com/sponsors/lenoxys) |

**Founded by** [samemory](https://ko-fi.com/S6S24XCVJ) · **Powered by** [bropat](https://ko-fi.com/bropat)'s [eufy-security-client](https://github.com/bropat/eufy-security-client)

---

<sub>This project is not affiliated with Anker or Eufy Security. Use entirely at your own risk — see [LICENSE](LICENSE) for details.</sub>
