eufy skill

Use this when a task references the Eufy camera kit, S380 HomeBase, S340/S330/S230 cameras, or anything that needs alarms/images from those devices.

Environment

•Ensure the helper package is installed:

bash

pip install -e /Users/marianobelinky/Coding/belidis/eufy

•
Generate/edit the config once per operator:
bash
```
eufy config init
$EDITOR ~/.config/eufycli/config.toml
```
Fill [account] (email/password/app password), [stations] / [cameras] aliases, default [paths], and optional [webhook] URL (usually http://127.0.0.1:5000/api/eufy/events).
•Secrets hierarchy: EUFY_PASSWORD / EUFYCLI_PASSWORD env var → account.password → account.password_command.
•Override config paths via EUFYCLI_CONFIG / CLI --config flag.
•
Optional guard/alarm control requires eufy-security-ws:
bash
```
docker run --rm -p 3000:3000 -e USERNAME=... -e PASSWORD=... bropat/eufy-security-ws:latest
```
Then set the [ws] block (enabled = true, url, schema) in config.toml.

•Account sanity check

bash

eufy login            # lists stations/cameras/IPs

•Pull a still

bash

eufy snapshot driveway                # uses alias
eufy snapshot T8140XXXXXXXXXXXX -o ./tmp

Images land in paths.media unless -o overrides it.

•Guard / siren (needs ws bridge)

bash

eufy ws guard homebase away
eufy ws alarm homebase --seconds 60

The Flask hub (repo: tuya-hub/tuya-hub) exposes endpoints once the eufycli package is installed:

Endpoint	Purpose
`GET /api/eufy/status`	Returns `{available,status}` to show config/install issues.
`GET /api/eufy/cameras`	Lists metadata/thumbnails for dashboards.
`POST /api/eufy/camera/<alias-or-serial>/snapshot`	Streams JPEG stills (headers include capture timestamp).
`POST /api/eufy/events`	Accepts `{"events": [...]}` (exact payload from `eufy events watch`).
`GET /api/eufy/events`	Returns the cached events buffer for UI panels/alerts.

Pairing workflow:

•Install eufycli inside the hub's virtualenv (pip install -e /Users/.../belidis/eufy).
•Restart the Flask app so services.eufy.EufyService loads the config.
•Launch eufy events watch on a machine that stays on the same LAN and point --webhook to the Flask endpoint.
•Use the new REST endpoints (or eufy snapshot ...) from automations, Tuya flows, or Clawdis scripts.

•Config missing – /api/eufy/status shows the exact error (e.g., account.email missing). Run eufy config init and edit the file.
•CaptchaRequiredError – rerun eufy login; the CLI will print a base64 captcha blob. Solve it and re-run with --captcha-id/--captcha-code (Typer prompts automatically). After a successful login the session refresh works silently.
•403/InvalidCredentials – Eufy accounts with 2FA require app passwords. Generate one inside the Eufy Security app and store it in the config or EUFY_PASSWORD.
•Guard/Alarm commands fail – confirm docker logs for eufy-security-ws show client connected, that the [ws] block has enabled = true, and that the CLI can reach the server (eufy ws guard ...). The Tuya hub does not call guard endpoints automatically; keep using the CLI or build an automation around it.
•Snapshots stale – eufy snapshot ... returns the last motion thumbnail. Trigger motion or use the Eufy app to refresh; RTSP livestreams require enabling RTSP per camera (inside the native app) and storing rtsp_username/password there, which the CLI will surface later.