Releases: homebridge-plugins/homebridge-eufy
Release list
v4.7.2
v4.7.2
Required actions — read before upgrading
This release drops support for older runtimes. Upgrade your environment first, or the plugin will not install:
- Node.js 24.5.0 or newer is required. Node 20 and 22 are no longer supported.
- Homebridge 2.0 or newer is required. Homebridge 1.x is no longer supported.
New device support
- Garage Control Cam E110 / E120 (T8452 / T8453) — the camera and each garage door now appear as separate HomeKit tiles with their own names.
- Open/close each door from HomeKit; door state updates whether actuated from HomeKit or the physical button.
- Door sensor battery level is reported.
- Doors and the camera's helper switches can be individually enabled/named in the camera config, so you don't get a tile for a door you don't have.
If one of these devices was already in your setup, delete it from the Homebridge accessory cache before restarting so it is recreated with the new support.
Thanks to @icortes95 for contributing this support.
v4.7.0
New device support
- FamiLock E34 (T85P0) — device image and recognition added.
Improvements & fixes
- Keypad devices no longer show a useless HomeKit toggle and detail view in the plugin UI.
- Error messages surfaced to the plugin UI are now sanitized so internal details are not leaked.
- Diagnostics archives now use a
.tar.gzextension so GitHub accepts them as attachments. - Login no longer stacks timers on repeated attempts; a leftover login timeout is cleared up front.
- Storage cleanup skips subdirectories instead of failing silently, and no longer leaks a file handle.
Under the hood
- Rebuilt on the TypeScript 7 toolchain.
- Dependencies refreshed (Homebridge 2, support libraries).
- Source formatting standardized with Prettier (no functional change).
Notes
- No configuration changes are required beyond the runtime upgrades above.
- Existing accessories, cameras, and station settings carry over unchanged.
v4.7.1
v4.7.1
Hotfix for a logging regression introduced in v4.7.0.
- Fixed broken logging: v4.7.0 shipped a logging library upgrade that spammed the log with
tslogwarnings and errors on every line, and could break the log files. Reverted to the previous stable logging library.
If you installed v4.7.0, upgrade to v4.7.1 to clear the log errors.
v4.7.0
Required actions — read before upgrading
This release drops support for older runtimes. Upgrade your environment first, or the plugin will not install:
- Node.js 24.5.0 or newer is required. Node 20 and 22 are no longer supported.
- Homebridge 2.0 or newer is required. Homebridge 1.x is no longer supported.
New device support
- FamiLock E34 (T85P0) — device image and recognition added.
Improvements & fixes
- Keypad devices no longer show a useless HomeKit toggle and detail view in the plugin UI.
- Error messages surfaced to the plugin UI are now sanitized so internal details are not leaked.
- Diagnostics archives now use a
.tar.gzextension so GitHub accepts them as attachments. - Login no longer stacks timers on repeated attempts; a leftover login timeout is cleared up front.
- Storage cleanup skips subdirectories instead of failing silently, and no longer leaks a file handle.
Under the hood
- Rebuilt on the TypeScript 7 toolchain.
- Dependencies refreshed (Homebridge 2, support libraries).
- Source formatting standardized with Prettier (no functional change).
Notes
- No configuration changes are required beyond the runtime upgrades above.
- Existing accessories, cameras, and station settings carry over unchanged.
v4.7.0
v4.7.0
Required actions — read before upgrading
This release drops support for older runtimes. Upgrade your environment first, or the plugin will not install:
- Node.js 24.5.0 or newer is required. Node 20 and 22 are no longer supported.
- Homebridge 2.0 or newer is required. Homebridge 1.x is no longer supported.
If you are on the Homebridge UI, update Node.js and Homebridge before installing 4.7.0.
What's new
- Rebuilt on the TypeScript 7 toolchain for faster, more reliable builds.
- Dependencies refreshed across the board (Homebridge 2, logging, and support libraries).
- Codebase formatting standardized with Prettier — no functional change, but a cleaner base for future fixes.
Notes
- No configuration changes are required beyond the runtime upgrades above.
- Your existing accessories, cameras, and station settings carry over unchanged.
v4.6.2-beta.6
fix: use .tar.gz extension for encrypted diagnostics to avoid GitHub upload blocks
v4.6.2-beta.5
chore: refactor and harden homebridge-ui server
v4.6.2-beta.4
chore: upgrade eslint and @eslint/js to v10
v4.6.2-beta.3
v4.6.2-beta.2
This is an experimental pre-release. It bundles 10 upstream eufy-security-client changes that are still awaiting merge in bropat's repository. We're shipping them early via a scoped fork so users can benefit now and report issues.
Things may break. If you encounter problems, please open an issue with your diagnostics — your feedback helps us validate these changes before they land upstream.
What changed
This release switches the underlying eufy-security-client library to a scoped fork (@homebridge-eufy-security/eufy-security-client) that includes the following fixes and features:
New device support
- NVR S4 Max (T8N00) — initial device registration
- PoE Bullet-PTZ Cam S4 (T8E00) — full device support with livestream, talkback, pan & tilt
- LOCK_85V0 (T85V0) — registered in DeviceProperties and DeviceCommands maps
Streaming & audio fixes
- ADTS multi-RDB frame normalization — fixes garbled audio on cameras that send multiple ADTS frames per P2P packet
- E340 on MiniBase Chime — no longer sends unsupported livestream command that caused stream failures
- Indoor cameras on HomeBase — correctly routes livestream through the right path
- Configurable P2P stream timeouts — stream start/stop timeouts are now tuneable
Other fixes
- ECDH encryption for T8214 and T8425 — fixes P2P session establishment on these devices
- SoloCam E42 rtspStreamUrl — adds missing RTSP stream URL property
- Missing GenericTypeProperty labels — 5 device types now show proper names
How to install
npm install @homebridge-plugins/homebridge-eufy-security@betaOr update via the Homebridge UI using the beta channel.
Reverting
If this release causes issues, downgrade to the previous beta:
npm install @homebridge-plugins/homebridge-eufy-security@4.6.2-beta.1v4.6.2-beta.1
Internal
- Fixed release workflow that was incorrectly publishing to npm
latestwhen creating GitHub pre-releases.
v4.6.2-beta.0
New beta branch started from 4.6.1. No functional changes — version bump only.