dreame-vacuum is a Home Assistant custom integration that lets owners of Dreame, MOVA, Mijia and Trouver robot vacuums control and monitor their machines — including full map support — directly from Home Assistant instead of the vendor's mobile app.

What it is

dreame-vacuum is a Python custom component for Home Assistant that functions as a complete app replacement for Dreame robot vacuums, exposing settings and state as auto-generated Home Assistant entities and exposing cleaning control through Lovelace dashboards. It covers a wide range of Dreame, MOVA, Mijia and Trouver robot vacuums and mops, and it can be configured through a DreameHome, MovaHome, Xiaomi Home or Trouver account, or run entirely locally over the LAN without any cloud dependency.

The concrete problem it solves is the fragmentation and cloud lock-in of controlling a robot vacuum through a vendor app on a phone: map data, per-room settings and cleaning history normally stay inside the DreameHome or Xiaomi Home ecosystem and cannot feed into home automations. This integration decodes and renders that map data inside Home Assistant, exposes every setting and state as entities, and emits persistent notifications and events, so vacuum behaviour becomes part of the same dashboard and automation system as the rest of the home.

Key capabilities

• Supports live and multi-floor map support with zone, spot and room cleaning.
• Provides per-room suction, water volume and cleaning order for customized cleaning.
• Exposes almost every setting and state dynamically as auto-generated entities, including map, room and consumable entities.
• Records cleaning and cruising history, obstacle photos, map backup and recovery, and saved WiFi maps.
• Emits persistent notifications and events that can drive Home Assistant automations.
• Ships backend translations for 40 languages.
• Includes an interactive map editor via the embedded Dreame Vacuum Card.

Who uses it and how

• Home Assistant users who want to retire the DreameHome, MovaHome, Xiaomi Home or TROUVER mobile app and run vacuum control from their own dashboard instead.
• Local-only adopters who add the device over the LAN without any cloud account, keeping the machine off vendor servers.
• Multicloor households that rely on multi-floor map support and per-room cleaning configuration for different levels of a home.
• Automation builders who use the persistent notifications and events, together with the documented YAML templates for supported Lovelace cards, to script cleaning routines.
• Users of the integration's supported-device list to confirm their specific Dreame, MOVA, Mijia or TROUVER model code and the features it exposes before committing.

Getting started

The integration is installed through HACS or by manual setup as a Home Assistant custom component, with minimum version and hardware requirements documented at dreame-vacuum.tasshack.com/installation; devices are then added with a Dreamehome, Xiaomi Home, MOVAhome or TROUVER account, or locally over the LAN.

How it compares

The project stands alongside other Home Assistant custom components for robot vacuums, and the registry's facts name no specific competitor for direct comparison.

When to use it — and when not

A self-hoster must operate Home Assistant itself and choose between running the integration with a cloud account (DreameHome, MovaHome, Xiaomi Home or TROUVER) or setting up local LAN control, which shifts responsibility for connectivity and device access onto the user. It should not be chosen by someone who wants a vendor-supported mobile app experience or who owns a robot outside the documented Dreame, MOVA, Mijia and Trouver line-ups, and prospective users should review the 24 open issues and the supported-devices list to gauge how complete coverage is for their particular model.