github homebridge-plugins/homebridge-eufy v5.0.0-beta.21

pre-release2 hours ago

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 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.

Fixed

  • Locks and security system: a lock or arming change the device takes a while to confirm no longer ends as a failure in Home once the device has acted (#1135).
  • A control that timed out now tells you to use the Eufy app for it, instead of suggesting a retry that fails the same way (#1134).
  • Snapshots: in the default Refresh mode, a new motion snapshot now replaces the old picture (#1137).
  • Diagnostics files now show why a live view failed to start, and which motion events reached no camera, so a report can be answered from the first file (#1138, #1139).

Updated eufy library (SDK 0.4.0-beta.18)

  • Motion snapshots: a snapshot eufy has not finished publishing yet is fetched again instead of being missed.
  • Quieter log: a routine message some devices send is no longer reported as unhandled.

Still open

  • No streaming from an S1 Pro base (#1089).
  • Standalone cameras freeze when a live view is opened again quickly (#1127).
  • Motion from eufyCam 3 behind a HomeBase 3 does not reach Home (#1114).
  • The HomeBase siren is not in HomeKit yet (#1129).

Don't miss a new homebridge-eufy release

NewReleases is sending notifications on new releases.