Special Version (BETA RC HKSV)
If you're feeling brave, we also have a beta or release candidate version, often with new features or code changes that need testing. There are different methods of updating, based on the platform that you are running Homebridge on.
There is no need to uninstall your current version of the plugin for any of these platforms.
The current HKSV version of the plugin is:
The current beta version of the plugin is:
The current release candidate version of the plugin is:
Go to Plugin menu, then on the homebridge-eufy-security widget, click on 🔧.
You can use the 'Install Previous Version' feature to install a beta version.
This icon can be used to select a version of the plugin to install. The latest beta version is usually at the top of the list.
If Homebridge is installed using Docker use the following commands.
To install the beta version:
docker exec <container-name> npm install homebridge-eufy-security@beta
To install the release candidate version:
docker exec <container-name> npm install homebridge-eufy-security@rc
To revert back to the latest stable version:
docker exec <container-name> npm install homebridge-eufy-security@latest
These commands will only work if you are using a platform which installs plugins globally.
To install the beta, run the following command in your Homebridge terminal.
sudo npm install homebridge-eufy-security@beta -g
or if you wish specific version of a beta
sudo npm install [email protected] -g
To install the release candidate, run the following command in your Homebridge terminal.
sudo npm install homebridge-eufy-security@rc -g
To revert back to the stable version, run the following command in your Homebridge terminal.
sudo npm install homebridge-eufy-security@latest -g
You will need to restart Homebridge each time you change the version of the plugin.
If you experience an issue with the beta package then do create an issue on GitHub and mention that you are using the beta 😄.
Create a new file /etc/profile.d/nvm.sh
#!/bin/bash
export PATH="/opt/homebridge/bin:$PATH"
Then
git clone https://github.com/homebridge-eufy-security/plugin.git homebridge-eufy-security
cd homebridge-eufy-security
npm install
npm run build
npm link
Add submodule and Fetch Dev branch
git submodule add -b develop https://github.com/bropat/eufy-security-client.git eufy-security-client
Compil
cd eufy-security-client/
npm install
npm run build
npm link
cd ..
npm add eufy-security-client/
npm install
npm run build
The current beta introduces HomeKit Secure Video. This feature is very experimental at the current state. There are some users that report very good results, while others have serious issues. The main things to consider are:
- Do you have a powerful enough system running homebridge, that can handle encoding the recording and the stream at the same time.
- For now there are known issues regarding motion detection and RTSP streams
- This feature will most likely not work very well with battery powered devices, since the battery depletion will be relatively high.
- Apples Servers are very picky regarding the stream configuration, so if no timeline appears in the Home App, it might well be, that the recording is discarded. You'll have to be willing to fiddle with the settings to get this working.
There will be a dedicated wiki article for HomeKit Secure Video.
There is also an ongoing community discussion, which might help you getting started: Thread
Also have a look at the original issue.
This beta introduces 'Experimental Mode', which can be enabled via the 'Plugin Settings'.
This can be used to change the behaviour of eufy devices in a way, that is not officially supported by eufy itself.
Please be advised that this can have negative side-effects. We are not reliable for unwanted behaviour or damages that might result by this.
The current supported changes are:
- Enable RTSP streaming on devices, which are not natively able to utilise RTSP.