Eufy HKSV Wake

Two-part integration for making flaky Eufy RTSP cameras usable in Apple Home through Scrypted.

It targets the failure pattern where Eufy answers RTSP OPTIONS but returns RTSP/1.0 404 Stream Not Found on DESCRIBE until the Eufy app or Home Assistant wakes the camera stream.

What This Can And Cannot Replace

This repo can handle:

• Waking Eufy RTSP streams from Home Assistant.
• Probing whether the RTSP stream is published.
• Optional motion-triggered and keepalive stream refresh.
• A Scrypted camera provider that calls the HA wake webhook when Apple Home opens live view.

This repo does not replace:

• eufy-security-ws / the HA Eufy integration. HA still needs those entities and services to start/stop Eufy RTSP.
• Scrypted HomeKit plugin. HKSV recording is implemented there, not in Home Assistant.
• Apple Home hub/iCloud+ requirements.

The practical architecture is:

Eufy camera/HomeBase
  -> HA Eufy integration start/stop RTSP services
  -> Eufy HKSV Wake custom integration
  -> Scrypted Eufy HKSV Wake camera provider
  -> Scrypted HomeKit plugin
  -> Apple Home live view + HKSV

Repository Layout

custom_components/eufy_hksv_wake/   Home Assistant custom integration
scrypted-eufy-hksv-wake/            Scrypted companion plugin
examples/                           Reference snippets

Home Assistant Install

HACS:

1. Push this repository to GitHub.
2. Home Assistant -> HACS -> Integrations -> Custom repositories.
3. Add your repo URL.
4. Category: Integration.
5. Install Eufy HKSV Wake.
6. Restart Home Assistant.

Manual:

cp -R custom_components/eufy_hksv_wake /config/custom_components/

Restart Home Assistant.

Home Assistant Camera Setup

Add one entry per camera:

Settings -> Devices & services -> Add integration -> Eufy HKSV Wake

Example:

Camera name: Garage
Eufy camera entity: camera.garage
RTSP URL used by Scrypted: rtsp://USERNAME:PASSWORD@10.0.10.200/live2
Optional motion sensor entity: binary_sensor.garage_motion_detected
Start RTSP service: eufy_security.start_rtsp_livestream
Stop RTSP service: eufy_security.stop_rtsp_livestream
Delay: 2
Refresh interval: 0
Probe timeout: 5

If RTSP credentials contain special characters, URL encode them:

@ -> %40
: -> %3A
# -> %23

After adding the entry, open the RTSP Stream Status sensor attributes and copy the webhook_path.

Scrypted Install

The Scrypted companion package is in:

scrypted-eufy-hksv-wake/

Build locally:

cd scrypted-eufy-hksv-wake
npm install
npm run build

For development deployment to your Scrypted server, use Scrypted's normal plugin development flow:

npx scrypted login
npx scrypted-deploy

Then in Scrypted:

1. Open the Eufy HKSV Wake plugin.
2. Add a camera.
3. Set the exact Eufy RTSP URL.
4. Set the full HA wake webhook URL:

http://HOME_ASSISTANT_IP:8123/api/webhook/eufy_hksv_wake_<id>

5. Start with Wake Delay Milliseconds = 2500.
6. Enable Scrypted HomeKit on that created camera and pair it to Apple Home.

Use this Scrypted companion camera only for flaky cameras. Stable cameras can still use Scrypted's standard RTSP camera plugin directly.

Services

Wake one camera:

action: eufy_hksv_wake.wake_stream
data:
  camera_entity_id: camera.garage

Probe one camera:

action: eufy_hksv_wake.probe_stream
data:
  camera_entity_id: camera.garage

Refresh all configured cameras:

action: eufy_hksv_wake.refresh_all

Tuning

For wired cameras:

• Prefer Eufy continuous RTSP if available.
• Keep Scrypted prebuffer enabled only after the stream stays stable.
• Use keepalive only for cameras that still sleep.

For battery cameras:

• Avoid periodic keepalive unless battery drain is acceptable.
• Use motion wake first.
• Expect HKSV reliability to be lower than with continuous wired RTSP.

Validation

Local checks used during development:

python3 -m compileall -q custom_components/eufy_hksv_wake
cd scrypted-eufy-hksv-wake
npm run check
npm run build