https://github.com/bropat/eufy-security-ws

Small server wrapper around eufy-security-client library to access it via a WebSocket.
https://github.com/bropat/eufy-security-ws

cam doorbell eufy eufy-cloud eufycam eufysecurity websocket ws

Last synced: 3 months ago
JSON representation

Small server wrapper around eufy-security-client library to access it via a WebSocket.

• Host: GitHub
• URL: https://github.com/bropat/eufy-security-ws
• Owner: bropat
• License: mit
• Created: 2021-05-12T16:08:22.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2026-02-26T19:22:42.000Z (3 months ago)
• Last Synced: 2026-02-27T01:25:39.915Z (3 months ago)
• Topics: cam, doorbell, eufy, eufy-cloud, eufycam, eufysecurity, websocket, ws
• Language: TypeScript
• Homepage:
• Size: 951 KB
• Stars: 250
• Watchers: 12
• Forks: 61
• Open Issues: 34
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
![Logo](docs/_media/eufy-security-ws.png)

# eufy-security-ws

[![node](https://img.shields.io/node/v/eufy-security-ws.svg)](https://www.npmjs.com/package/eufy-security-ws)

[![NPM version](http://img.shields.io/npm/v/eufy-security-ws.svg)](https://www.npmjs.com/package/eufy-security-ws)

[![Downloads](https://img.shields.io/npm/dm/eufy-security-ws.svg)](https://www.npmjs.com/package/eufy-security-ws)

[![Total Downloads](https://img.shields.io/npm/dt/eufy-security-ws.svg)](https://www.npmjs.com/package/eufy-security-ws)

[![Dependency Status](https://img.shields.io/librariesio/release/npm/eufy-security-ws)](https://libraries.io/npm/eufy-security-ws)

[![Known Vulnerabilities](https://snyk.io/test/github/bropat/eufy-security-ws/badge.svg)](https://snyk.io/test/github/bropat/eufy-security-ws)

[![NPM](https://nodei.co/npm/eufy-security-ws.png?downloads=true)](https://nodei.co/npm/eufy-security-ws/)

Small server wrapper around [eufy-security-client](https://www.npmjs.com/package/eufy-security-client) library to access it via a WebSocket.

Join us on Discord:



The development of this server was inspired by the following project:

* [zwave-js-server](https://github.com/zwave-js/zwave-js-server)

Credits go to them as well.

If you appreciate my work and progress and want to support me, you can do it here:

[![ko-fi](https://www.ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/E1E332Q6Z)

[![Donate](https://img.shields.io/badge/Donate-PayPal-blue.svg)](https://www.paypal.me/pbroetto)

**This project is not affiliated with Anker and Eufy (Eufy Security). It is a personal project that is maintained in spare time.**

## Get started

To try it out or for more information, such as API documentation, Docker image, etc., please see [here](https://bropat.github.io/eufy-security-ws/).

## Deployment

Instructions aimed at maintainers for deploying a new version: [Deployment](docs/deployment.md)

### Security warning `CVE-2023-46809`

When starting the Docker container, you may see a log line:

    SECURITY WARNING: Reverting CVE-2023-46809: Marvin attack on PKCS#1 padding

This is expected and can be safely ignored, as the Eufy client still requires `RSA_PKCS1_PADDING` for cloud decryption. No code or runtime behavior is changed.

## Changelog

### 1.9.9 (2026-02-14)

* Upgrade to eufy-security-client 3.7.0

* Feature: Add search by date for events @temp-droid in https://github.com/bropat/eufy-security-ws/pull/502

* Fix: Fixed websocket handle by @temp-droid in https://github.com/bropat/eufy-security-ws/pull/499