I have baked a custom integration to control Eufy Security Cameras and access RTSP (real time streaming protocol) and P2P (peer to peer) stream if possible. Integration supports doorbells, cameras, home bases, motion and contact sensors and it is far from complete.

Under the hood, it is using eufy-security-ws (https://github.com/bropat/eufy-security-ws) web socket application which uses eufy-security-client (https://github.com/bropat/eufy-security-client) to communicate with eufy servers and devices over cloud and peer to peer connection. So, I am following versioning of eufy-security-ws directly as add-on version.

Big thanks to @bropat who made this possible. Please consider buying a coffee for him over here: https://ko-fi.com/bropat

• start_rtsp_livestream / stop_rtsp_livestream (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.. This service starts a new stream using RTSP. Currently, it is limited to one stream per home assistant. bropat/eufy-security-client#63
• start_livesteam / start_p2p_livestream / stop_livestream / stop_p2p_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_rtsp / disable_rtsp: to enable RTSP option in cameras, you can use this services, but I rather prefer you to enable it using the mobile app because enabling rtsp configuration also triggers a new stream to start which causes issues for integration.
• 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

Locks (not the Wifi), motion and contact sensors are supported and native services can be used.

• force_sync - get latest changes from cloud as some changes are not generating notifications to be captured automatically

Check here: https://github.com/fuatakgun/eufy_security/issues Supported devices: https://github.com/bropat/eufy-security-client#known-working-devices

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 (preferably with adming rights), enable motion notifications with full picture and enable push notifications. This integration depends on push notifications to catch any updates.

Please log-in using your new account in respective mobile app to validate that new account has full access to all shared devices. If the issue still persists, creating a new account also solved it many times. If you still have the issue, please create an issue over here: https://github.com/bropat/eufy-security-client

Moreover, if you are having issues related to home base states, please double check if you see a message in add on logs regarding to these changes as below examples, if you are not receiving, you have a problem with push notifications or device sharing, I cannot help.

2022-07-11 14:06:35.442  INFO  Alarm mode for station T8010N2320460480 changed to: AWAY 
2022-07-11 14:06:36.562  INFO  Received push notification for changing guard mode 
2022-07-11 14:17:17.904  INFO  Alarm mode for station T8010N2320460480 changed to: HOME 
2022-07-11 14:17:18.466  INFO  Received push notification for changing guard mode 

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 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 (please always set STREAMING QUALITY, CODEC and COMPRESSION to LOW) this could change between 1 to 5 seconds. I am able to stream more than 15 minutes for my 2C cameras using P2P. 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: [email protected]
• If you are located in US, use shared test account: [email protected]

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:
  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 [email protected] -e PASSWORD=password_goes_here -e COUNTRY=country_code -p 3000:3000 bropat/eufy-security-ws:X.Y.Z. To find out correct values for X.Y.Z, please check here https://github.com/fuatakgun/eufy_security_addon/blob/main/config.json#L3
• 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 HACS, downloading files over UI, restarting home assistant and setting up integration.
• Double check if your configuration.yaml includes ffmpeg integration. If not, please do like this; https://www.home-assistant.io/integrations/ffmpeg/#configuration . This integration relies on ffmpeg to be setup to live stream via P2P and capture images from live RTSP/P2P streams.

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), save the configs and start the add-on. 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 and start the add-on.

5- Start the Add-On and validate if it is running well checking the logs.

1- Go to HACS and search for 'Eufy Security'

2- Install the Eufy Security repository

3- You need to restart your HA instance to pick up new repository.

4- After restart, go to Configuration - Integrations page and click on Add Integration

5- Search for Eufy Security and click on it

6- In next page, use localhost if you have used Add-on installation, otherwise put your Docker instance ip address and keep 3000 as port

7- You will be shown devices connected to your account. Or you can be alerted with captcha notification.