Eufy Mega Security | A new approach to Eufy camera integration for Home Assistant

Share your Projects! Custom Integrations
, , ,
1

Hi everyone,

I’ve been working on Eufy Mega Security, an open-source Home Assistant app and custom integration for Eufy cameras, especially the battery-powered models that do not provide a permanent RTSP stream.

The project started with a simple problem: Eufy cameras can generate useful motion, person-detection, and event-image data, but getting reliable live video and snapshots into Home Assistant I found surprisingly difficult - with sometimes three different projects needed just to get a camera feed. I just wanted something easy for myself, but it sorta ballooned - and was hard frikkin’ work trying to figure this out without using the excellent but now deprecated eufy-security-ws as a safety blanket!

Eufy Mega Security currently provides:

  • Eufy camera entities in Home Assistant
  • Motion and person binary sensors
  • Last-recognized-person information when HomeBase provides it
  • Retained event snapshots, so a sleeping battery camera can still show its last useful image
  • On-demand live viewing
  • Fresh snapshots and short recordings
  • Push-driven updates rather than relying entirely on polling

The gateway talks to Eufy’s current Mega platform for authentication, device discovery, events, and key material. Live video uses Eufy’s native PPCS peer-to-peer camera transport.

It does not use the expiring Web Portal Access PIN, and it does not depend on eufy-security-client. The Eufy protocol code runs in a separate gateway service, while the Home Assistant integration stays focused on entities and the Home Assistant API.

So far I’ve been testing with:

  • HomeBase 3
  • Three EufyCam 2C battery cameras
  • A video doorbell
  • A wired T817L camera

This is still an early project, and Eufy’s protocols are undocumented and can change. Some cameras may complete the connection handshake but still fail to send video if they are asleep, out of battery, or affected by network conditions.

I’m looking for testers

If you have Eufy cameras, particularly models that are poorly supported by existing integrations, I’d love to hear how this behaves for you.

Useful test reports would include:

  • Camera model
  • Whether it is battery-powered or wired
  • Whether it is connected through a HomeBase
  • Whether motion events arrive
  • Whether event snapshots appear
  • Whether live view, fresh snapshots, and recordings work
  • Any redacted gateway diagnostics

Please do not post Eufy passwords, verification codes, session files, or private account details.

I’m also looking for contributors

There is plenty of room for developers to help:

  • Testing additional Eufy camera and HomeBase models
  • Improving PPCS compatibility
  • Adding protocol fixtures and regression tests
  • Improving the Home Assistant camera experience
  • Reviewing authentication and security boundaries
  • Improving documentation and troubleshooting
  • Helping make the Eufy client library useful outside Home Assistant

The repository includes a first-day developer guide explaining the architecture, Mega API, authentication flow, event-image formats, PPCS streaming, and the Home Assistant boundary.

GitHub:
GitHub - mscodemonkey/eufy-mega-security: Event-first Eufy camera gateway and Home Assistant integration · GitHub

If you have a camera that existing integrations struggle with, please give it a try and let me know what happens. Compatibility reports are especially valuable at this stage.

13 Likes
2

Dumb question time… I noticed a few of my issues got closed out on Eufy Security WS and that it now redirects to mega-yfue/eufy-sdk

I honestly don’t know what this means for me, a user of the current addon and integration

Is this related?
@bropat ran the original, but not the new one or this one

So what’s the deal with Eufy? Do i need to start again?!

3

Hi there,

Just trying this out but no dice after setting my verification code and restarting the app:

Eufy connection authentication-required: Eufy requested an email verification code; add it to the add-on configuration and restart
curl: (7) Failed to connect to 127.0.0.1:3218 after 0 ms: Could not connect to server
Eufy gateway listening on http://0.0.0.0:3218 (eufy provider)
Eufy provider failed: Mega request failed (26006: Failed to login.)
4

I get this in the log. Integration can’t connect

image

5

Exactly the same issue as BalooDK

6

“Hi! I’m testing your amazing new Eufy Mega Security add-on. My Doorbell and two C2 cameras are discovered perfectly. However, my Indoor Cam and two EufyCam 3 (S330) connected via HomeBase 3 are not showing up in the integration at all. They are ignored during discovery. Could you please add support for these device types?” i am willing to test some things for you

2 Likes
7

Hi, same issue here, for me.
Only T8210 and T8113 recognized, and nothing via Homebase 3

8

Please raise an issue on GitHub. I’m integrating devices as people tell me about them, because I only have a few. If you’re happy to test, I’m happy to try! There have also been several new releases since you posted too, so you may find some of your other devices are now supported…

9

This is nothing to do with either of those projects, no. This project is very early stage but I’m adding devices and features every day.

10

@BalooDK @dervish
Please raise an issue on GitHub after updating to the latest version, grab some logs and I should be able to see what’s going on. Or the latest version might even fix your problem - I did some work on improving authentication already. First thing to try with that would be switching off 2FA on your guest user account just to test to see if it’ll authenticate without 2FA. Then we can look further. I’m happy to help!

11

The app has a lot more features now including support for a lot more cameras connected through your HomeBase 3. HomeBase 2 support will come later, I just need to remember where I last saw mine!

12

Hi @martinjsteven many thanks for all your efforts. I have installed the app and integration and all looks very neat, it just does not get any snapshots or recordings but I am sure it can be fixed, I will log a ticket (I have a T81A0)
All sensors looks great and battery and motion detection is spot on!
Super work! Thanks!

1 Like
13

Hello. I have the Eufy S120. Wondering if someone has this camera and is working with this integration?
Model Number: T81A0

14

I have Eufy T8210 paired with a HomeBase 2. Would love to test.

15

My doorbell is working, my solar camera nog (Eufy S340 | T8170)

16

I have managed to connect my guest account to my T8010, but no entities (as expected I guess?), if you need someone to test stuff for the T8010 give me a shout!

18

Hi Martin, first a big THANK YOU for building this new integration !!!
You mentioned that you build it especially for battery-powered cameras.
Would be nice to integrate non-battery-powered cameras like the T8600 too to be able to react to events fired by those cameras in HA. After the old eufy integration died I still see the stream but can’t read any events and react to them. Thanks a lot !!!
I also can test T8114 via HomeBase2 if you integrate them.

19

Hi, thank you for developing.
I installed everything and it looks to be ok.

The really thing i want for a long time is a card to see the live view of my camara’s in HA.

I read the manual but it is to difficult for me to get a live card with view.

Is it possible to write a simple manual to build this.

Thank you very much

20

I have a eufy door bell E340 with chime 2. I have it set up on my home WiFi. I’m in the process of moving as much as possible to home assistant and would love to test for you.
I can follow instructions but am not a programming expert.

21

Looks like the E340 is supported.