Caution
READ THIS BEFORE UPDATING
This is not an update to the plugin you already have. It is a new plugin that replaces it.
1. Check your Homebridge and Node versions first
You need Homebridge 2.5 and Node.js 24.5.0 or newer. On anything older this plugin simply will
not start.
2. Your current cameras and sensors will not carry over
The new plugin creates its own accessories in the Home app. The ones you have now stay behind as
"not responding" and you delete them yourself.
3. You will have to redo your rooms, names and automations
Once. Any automation using a eufy camera, sensor, lock or light will need to be pointed at the new
accessory. Take a screenshot of your automations before you start.
4. Your existing eufy settings are not reused
You set the plugin up again from scratch: log in, and configure it in the Homebridge UI.
5. Back up before you touch anything
In the Homebridge UI: Backup / Restore → Download Backup.
6. If your home depends on this working, wait a little
Version 4.7.2 still works today and is not going anywhere. Try this beta somewhere a camera going
dark is annoying rather than a problem.
But read the next point before deciding to stay on it.
7. Version 4.x is no longer being worked on
All maintenance from here goes to 5.x only. No fixes, no new devices, no eufy changes followed on
4.x — it is frozen at 4.7.2 and stays installable, nothing more. If eufy changes something on their
side that breaks 4.x, it will not be repaired.
So staying on 4.x is fine for now, and it is not a long-term plan.
New devices
- The eufy water sensor (T8920) shows up in the Home app as a Leak Sensor (#1274).
Live video and recordings
- HomeBase 2 stations whose cameras failed to connect with a "level-2 key derivation failed" error stream again (mega-yfue/eufy-sdk#650).
- Standalone cameras that refused the newer live-view handshake, like the Indoor Cam T8420, show a live picture (mega-yfue/eufy-sdk#606).
- The recordings stored on a HomeBase 3 can be read again (mega-yfue/eufy-sdk#654).
- A camera announcing an invalid network port no longer crashes the plugin (mega-yfue/eufy-sdk#622).
Locks
- Wi-Fi smart locks like the C30, C32, C33 and FamiLock S3 respond to the plugin, including on EU accounts (mega-yfue/eufy-sdk#621).
Settings and detection
- The motion detection switch on standalone cameras such as the T8442, T8170, T8171 and T8400 shows the right state and changes the setting the eufy app changes (mega-yfue/eufy-sdk#642).
- Naming no longer decides what a device is. A camera named "…Doorbell", "…Lock" or "…smoke…" no longer gets controls it doesn't have; locks, doorbells, pan-tilt cameras, spotlights and smoke alarms are recognised from eufy's own product description (mega-yfue/eufy-sdk#634, mega-yfue/eufy-sdk#636, mega-yfue/eufy-sdk#637, mega-yfue/eufy-sdk#638, mega-yfue/eufy-sdk#639).
- Siren, notification, live-view, audio, battery and camera settings only offer the values the product's own settings page offers, and are sent the way the eufy app sends them on that model (mega-yfue/eufy-sdk#647, mega-yfue/eufy-sdk#648, mega-yfue/eufy-sdk#649, mega-yfue/eufy-sdk#656, mega-yfue/eufy-sdk#657, mega-yfue/eufy-sdk#658).