I wanted to share a custom integration I’ve been building for my Eufy X10 Pro Omni. It’s a top-level addition built on the excellent eufy-clean by jeppesens and adds room-level control, a learning/ETA system, and a full automation event API that the base integration doesn’t provide.
What it adds:
- Room-level cleaning — select rooms by name, build and reorder a queue before starting
- Per-room settings — suction, mop mode, cleaning passes, saved as named profiles
- Run profiles — save a full run configuration and trigger it from an automation or the UI
- Room rules engine — attach conditional rules to rooms that apply at job start (block a room, override its settings, etc.)
- Learning system — the integration records how long each room actually takes and builds ETA estimates that improve with each run. Includes confidence scoring and stall detection.
- Automation events —
eufy_vacuum_job_finished,eufy_vacuum_room_started/finished,eufy_vacuum_path_blocked,eufy_vacuum_stall_detected,eufy_vacuum_run_incomplete- Incomplete run recovery — after a cancelled or interrupted job, the card shows missed rooms and lets you re-queue them with a single tap
- Dock management — wash mop, dry mop, empty dust from the UI
- Built-in Lovelace panel card with a theme editor — registers itself, no manual resource setup
How it’s built: Honestly, this was slowly vibe coded over several months with significant AI assistance. It works reliably for me on the X10 Pro Omni but I can’t make promises about other models or commit to heavy ongoing support. Full user guide and developer documentation are included in the repo if anyone wants to extend it or adapt it for another vacuum.
Repo: GitHub - kingchddg901/eufy-vacuum-manager: Full-featured Home Assistant integration for Eufy robot vacuums — room-level control, learning system, automation hooks, and custom card · GitHub
Install: HACS → Custom repositories → add the URL above → Integration type