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.
Live video and recordings
- Cameras whose video the plugin converts, like the SoloCam S220 and eufyCam 3, show a live picture in the Home app again on bridges with many processor cores, such as Apple Silicon Macs (#1258).
- Cameras on stations whose security key eufy now sends in a different format connect again (mega-yfue/eufy-sdk#646).
Notifications and sensors
- Sound and crying detection only trigger motion on cameras that actually have them, following eufy's own product description (mega-yfue/eufy-sdk#623).
- A change eufy announces without its new value now reaches the Home app once the plugin has read it (mega-yfue/eufy-sdk#635).
- Entry sensors and water leak sensors read what the eufy app reads, and are recognised from eufy's own product description (mega-yfue/eufy-sdk#631, mega-yfue/eufy-sdk#632).
Settings
- The spotlight switch is removed on models whose light control is not confirmed yet. If your light switch disappears, please open an issue with a diagnostics file (mega-yfue/eufy-sdk#613).
- Night vision uses the setting your camera reports and offers the modes it supports (mega-yfue/eufy-sdk#627).
- The motion detection switch on the Indoor Cam T8410 changes the same setting as the eufy app (mega-yfue/eufy-sdk#625).
- Settings that cannot be changed through eufy's cloud connection are no longer offered (mega-yfue/eufy-sdk#610).
- Per-product options now come from eufy's own description of each product instead of model lists, and a station's settings are read as soon as it connects (mega-yfue/eufy-sdk#628, mega-yfue/eufy-sdk#629, mega-yfue/eufy-sdk#630, mega-yfue/eufy-sdk#633).