I have baked a custom integration to control Eufy Security Cameras and access RSTP (real time streaming protocol) stream if possible. You can turn on and turn off cameras and if your camera is on, you can view live stream. Morevoer, there are some additional sensors for motion detection, person detection, battery level and wifi signal.
Big thanks to @bropat who made this possible. Please consider buying a coffee for him over here: https://ko-fi.com/bropat
- start_rtsp / stop_rtsp (RTSP): if your camera can stream over RTSP, please enable it over eufy app, this is more more reliable and less power consuming and you can use these services to start and stop stream.. Attention: users had reported that using
stop_rtspis disabling RTSP functionality at all for the camera. fuatakgun#53 - start_livesteam / stop_livestream (P2P): if there is no support for RTSP, you can use P2P streaming, this should work for all camera types but much more power consuming for your HA instance.
- turn_on / turn_off: it first checks if there is rtsp attribute in camera and if yes; it will use RTSP services, if not, it will use P2P services.
- enable / disable: enable and disable respective device
- alarm_arm_home / alarm_arm_away / alarm_disarm / alarm_guard_schedule (requires configuration on eufy app) / alarm_guard_geo (requires configuration on eufy app)
- alarm_arm_custom1 / alarm_arm_custom2 / alarm_arm_custom3 - you need to create custom configurations for these to work
- alarm_trigger / alarm_trigger_with_duration - trigger alarm on home station
- reset_alarm - stop the alarm state
- force_sync - get latest changes from cloud as some changes are not generating notifications to be captured automatically
Please throw some :)
1- Create a separate account for HA integration as that account will be logged out automatically from mobile app when HA integration logged in. Do not forget to share your cameras with your new account and enable notifications for them. This integration depends on push notifications to catch events.
2- RTSP - As of now, live stream is limited to 3 minutes and this is a hard limitation by Eufy, so we do not have a solution in place. So, if you keep live stream running more than 3 minutes, it will be turned off by hardware but your home assistant will not be notified on this. So, next time you want to start live stream, you notice that nothing will be happening as we assume that it is already running. As a workaround, please call stop and start in order. fuatakgun#10 (comment)
3- P2P - To have P2P streaming work out, we have an additional add-on to mirror incoming video bytes and stream as it is an RTSP stream. But to do so, integration first needs to analyze X seconds from incmoing bytes to understand video codec information (dimensions, fps, codec etc) and then initializes the stream on add-on. So, depending on your hardware and video quality this could change between 1 to 5 seconds. If your P2P stream fails to start, please play with this configuration in integration options page. Check below image;
4- Please do not enable Preload Stream functionality in Camera View if your camera is battery powered (not streaming all the time) for two reasons; it is not adding functionality in our use case and it sends a signal to enable live stream to your cameras which might end up excessive battery consumption.
5- One user reported that there is an issue regarding to 2k Battery Doorbell in terms of receiving motion and person detection sensor. If you are having a similar issue, please apply this solution: fuatakgun#22 (comment)
6- I am more than happy to debug individual issues as long as you follow setup instructions. I need you to share your problematic cameras with me so that I can use my own machine to debug the issue. For each debugging request, please create a github issue so we can track from there. Do not forget to remove the sharing settings after we are done :)
- If you are located in EU, use my account:
fuatakgun@gmail.com - If you are located in US, use shared test account:
eufydeveloper@gmail.com
6- If you have any other issue, please create it an issue on github repository, give information about your home assistant hardware, camera model, streaming type (rtsp or p2p), steps required to generate the issue. Enable excessive logging and share your logs from integration and related add ons.
logger:
default: info
logs:
custom_components.eufy_security: debug
Warning, there is an existing integration (https://github.com/nonsleepr/ha-eufy-security) and I have used the same internal name with this integration, unintentinally. You can not keep both integrations and trying to install might cause issues. You can backup old one if you want to test this, just rename custom_components/eufy_security into something else (eg eufy_security_nonsleepr)
Please follow screenshots below. In summary;
- You will first install HASS Add On assuming you are running on Hassos or Supervised. If not, please execute this command to run docker instance manually
docker run -it -e USERNAME=email@address.com -e PASSWORD=password_goes_here -p 3000:3000 bropat/eufy-security-ws:0.3.3 - Later on, you should install RTSP Server Add On to have faster/more reliable p2p streaming. I will deprecate/not support file based streaming soon, so, please migrate in timely manner. If you are not using Hassos or Supervised installation please execute this command to run docker instance manually
docker run --rm -it -e RTSP_PROTOCOLS=tcp -d -p 8554:8554 -p 1935:1935 aler9/rtsp-simple-server - When you are done with HASS Add On, you will install integration via adding integration address to HACS, downloading files over UI, restarting home assistant and setting up integration.
- Double check if your
configuration.yamlincludesffmpegintegration. If not, please do like this; https://www.home-assistant.io/integrations/ffmpeg/#configuration . This integration relies onffmpegto be setup.
1- Go to Add-On Store page and select Repositories
2- Add custom repository URL
https://github.com/fuatakgun/eufy_security_addon
3- Confirm that you can see Eufy Security WS Addon
4- Click on Eufy Security WS Addon, install add-on and switch to Configuration page, fill username, password and country code (2 letter). I advise you to create a new account and share your cameras from main account to new account. Use that new account for home assistant purposes only.
5-Validate that you are connected checking logs page.
1- Go to Add-On Store page and select Repositories
2- Add custom repository URL
https://github.com/fuatakgun/rtsp_simple_server
3- Confirm that you can see RTSP Simple Server Addon - probably at the end of the page
4- Click on RTSP Simple Server Addon, install add-on, please do not change any configuration.
5- Start the Add-On and validate if it is running well checking the logs.
1- Go to HACS and click on Custom repositories
2- Add custom integration repository URL
https://github.com/fuatakgun/eufy_security/
3- Install the Eufy Secucirty repository
4- You need to restart your HA instance to pick up new repository.
5- After restart, go to Configuration - Integrations page and click on Add Integration
6- Search for Eufy Security and click on it
7- In next page, use localhost if you have used Add-on installation, otherwise put your Docker instance ip address and keep 3000 as port
8- You will be shown devices connected to your account.
9- If your camera does not support RTSP based live streaming, you can use Start Live Stream and Stop Live Stream services rather than turn_on and turn_off because they tend to be using RTSP functions. They require camera entities as input, you can use UI for this.
10- If you want faster P2P live streaming, go to Integration Configuration section and enable it.
You can use WebRTC for light speed streaming inside Home Assistant.
1- Install WebRTC following these steps: https://github.com/AlexxIT/WebRTC#installation
2- Disable Auto Start on Click to be sure that cameras are not starting to stream autoamtically.
3- Setup two conditional cards for each camera as below, do not forget to put correct camera entity names (replace entrance with your camera name)
- So, when camera is not streaming, you will get latest captured image and when you click on image, it will start streaming (camera.turn_on service call).
- When camera is streaming, you will get WebRTC card which has 1-2 seconds latency while streaming.
- type: conditional
conditions:
- entity: binary_sensor.entrance_streaming_sensor
state: 'False'
card:
type: picture-entity
entity: camera.entrance_camera
tap_action:
action: call-service
service: camera.turn_on
service_data: {}
target:
entity_id: camera.entrance_camera
- type: conditional
conditions:
- entity: binary_sensor.entrance_streaming_sensor
state: 'True'
card:
type: custom:webrtc-camera
entity: camera.entrance_camera
RTSP Experience with WebRTC: https://drive.google.com/file/d/1qIYUx82C0CnpsTycP9dTS0NX6IEqeqHD/view?usp=drivesdk
P2P Experience with WebRTC: https://drive.google.com/file/d/1qCW9XX32vInQgFF7hPqoxp-ssno2Sye9/view?usp=drivesdk
Thanks @conorlap for this. - fuatakgun#43