Skip to content

eufy_vacuum

Room-level control for robot vacuums (Eufy and Roborock today) in Home Assistant — a custom integration paired with the eufy-vacuum-command-center Lovelace card. Choose exactly which rooms to clean and in what order, give each room its own settings, save reusable profiles, and watch a learning system get more accurate over every run.

Tested on the Eufy X10 Pro Omni and the Roborock S6 (a second-brand adapter). Capabilities differ by brand and model — brand differences are called out inline throughout the guide. These docs are generated from the docs/ tree in the repository — edit there, not on the rendered site.

Where to start

  • User Guide

    Set up and drive the card day to day — rooms, queue, running a clean, the map, maintenance, profiles, themes.

  • Advanced

    Services, automation examples, the learning system, map configuration, room rules, and the theme system in depth.

  • Developer

    Architecture, the manager, the adapter system, every subsystem, the card architecture, and the render harness.

  • Testing

    How the test suite is structured, how to run it, fixtures, patterns, and per-subsystem coverage.

  • Contributing

    Porting the adapter to a new brand, and authoring or sharing animal companions.

  • Theme Gallery ↗

    Browse the real card rendered under every community-submitted theme — the live render gallery.

Highlights

  • Room-level control — pick rooms and order per run, with per-room mode, suction, water, path, passes, and edge-mop.
  • Profiles & run profiles — save room settings or a whole room selection and reapply in one tap, optionally as an ordered sequence with mid-run charge or wait stops (vacuum, dock and top up, then mop — all one job).
  • Learning system — per-room timing estimates that improve with use, with confidence indicators.
  • Custom maps — auto-detect rooms from a screenshot, hand-draw named layouts on any backdrop, or (on live-map brands like Roborock) draw rooms straight over the live map with no upload. See Making your own maps.
  • Theming — fully customizable from the card, including a colorblind-safe theme. See Theme system to use it, or Authoring a theme to build one.
  • AI-assisted theming — the token system is documented as a machine-readable spec, so you can hand an AI a vibe (a photo, a few hex swatches), have it author a complete theme JSON, then render it through the harness and refine. See Authoring themes with an AI.