The Lovelace Xiaomi Vacuum Map Card is a popular integration used in smart home systems to display and manage the cleaning maps generated by Xiaomi robotic vacuum cleaners. For many homeowners who use Home Assistant or similar automation platforms, this custom card provides a powerful and visually appealing way to view their robot vacuum’s progress, cleaning history, and live map updates directly from the dashboard. With a combination of functionality and design flexibility, the Lovelace Xiaomi Vacuum Map Card enhances both usability and control for smart cleaning devices.
What Is the Lovelace Xiaomi Vacuum Map Card?
The Lovelace Xiaomi Vacuum Map Card is a custom visual component that allows users to display interactive vacuum maps within the Home Assistant Lovelace UI. It connects to supported Xiaomi or Roborock vacuums through integrations such asXiaomi MiioorValetudo. Once set up, the card shows the live map of your home, allowing you to monitor real-time cleaning areas, create virtual zones, and even send direct cleaning commands without leaving your smart home dashboard.
Essentially, it turns a simple cleaning device into an interactive smart home feature. You can see exactly where your vacuum has cleaned, pause or start cleaning sessions, and set target zones for spot cleaning all through a visual interface.
Key Features of the Xiaomi Vacuum Map Card
One of the main reasons the Lovelace Xiaomi Vacuum Map Card has gained popularity is its wide range of features that cater to both casual users and advanced smart home enthusiasts. Some of the most notable features include
- Real-time map updates showing the vacuum’s position and cleaning progress.
- Support for multiple maps and rooms, ideal for multi-floor homes.
- Interactive buttons for start, pause, dock, and spot clean commands.
- Customizable icons and colors for different vacuum states (cleaning, charging, paused, etc.).
- Zone selection and go-to-point functionality directly from the map interface.
- Compatibility with Valetudo or native Xiaomi integrations for map rendering.
These features make it more than just a visualization tool it’s a control center for your vacuum robot. Users who want deeper integration can even automate cleaning schedules based on sensors or events in their home.
Integration with Home Assistant
Home Assistant is one of the most popular open-source smart home platforms, and the Lovelace Xiaomi Vacuum Map Card fits perfectly within its ecosystem. It works as a Lovelace custom card, meaning users can add it to their dashboard using simple YAML configuration. The card communicates with the vacuum’s integration to fetch map data and send commands.
For example, after installing the necessary dependencies, you can define the card in your dashboard configuration with attributes such asentity,map_source,camera, andvacuum_controls. This setup gives you complete flexibility over how your map looks and functions. You can even combine multiple cards for different vacuums or display them alongside other smart home sensors like air quality, motion, or humidity.
Supported Devices
The Lovelace Xiaomi Vacuum Map Card supports a wide range of Xiaomi and Roborock devices. It can work with vacuum cleaners using the Mi Home app or with firmware based on Valetudo, an open-source software that enables local control of robot vacuums. Commonly supported models include
- Xiaomi Mi Robot Vacuum 1C
- Roborock S5, S6, and S7 series
- Mi Robot Vacuum Mop series
- Dreame and Viomi models with compatible map data
For best performance, users should confirm that their device supports map export or live map rendering, as not all Xiaomi vacuums provide direct access to their internal maps.
How the Map Rendering Works
At the core of the Lovelace Xiaomi Vacuum Map Card lies the ability to display detailed and dynamic cleaning maps. The map data is typically retrieved from the vacuum’s internal memory or through a companion integration like Valetudo. The data is then rendered as an image or vector graphic, showing walls, rooms, and the vacuum’s route.
Advanced versions of the card even allow for interactive elements. You can tap specific areas of the map to instruct the vacuum to clean a spot or define virtual boundaries to prevent it from entering certain zones. The map updates automatically during cleaning sessions, giving you live feedback on progress and coverage.
Customization and User Interface
One of the biggest strengths of the Lovelace Xiaomi Vacuum Map Card is its high level of customization. Users can adjust nearly every visual aspect, from icon sets and background colors to button placement and scaling. This flexibility ensures the card fits seamlessly into any Home Assistant dashboard layout, whether minimalist or feature-rich.
Some customization options include
- Changing the size and shape of vacuum icons.
- Selecting which control buttons appear on the interface.
- Adjusting map zoom levels and camera orientation.
- Enabling or disabling overlays for room boundaries and cleaning paths.
With just a few lines of YAML configuration, you can tailor the appearance to your preferences. For example, you can display only the essential controls start, pause, and dock or include full manual zone control for advanced usage.
Setting Up the Lovelace Xiaomi Vacuum Map Card
Setting up the card usually involves a few steps, depending on your Home Assistant installation. First, you need to ensure that the Xiaomi or Roborock vacuum is properly integrated into your system. Then, install the Lovelace card via the Home Assistant Community Store (HACS) or by manually adding the JavaScript resource file.
After installation, you can configure the card by editing your dashboard YAML file. A basic setup might look like this
type customxiaomi-vacuum-map-card entity vacuum.xiaomi_vacuum map_source camera camera.vacuum_map vacuum_controls [start, pause, stop, return_to_base]
This configuration tells the card which vacuum entity to control and which camera feed to use for the map display. From there, you can experiment with more advanced parameters to enhance the visual layout and add interactivity.
Benefits of Using the Xiaomi Vacuum Map Card
Integrating the Lovelace Xiaomi Vacuum Map Card into your Home Assistant dashboard offers several benefits beyond simple monitoring. It provides a centralized control system, making it easier to manage household cleaning routines. Some key advantages include
- Visual insight into cleaning coverage and efficiency.
- Ability to control the vacuum directly from the dashboard without using the Mi Home app.
- Improved automation potential when combined with other smart devices.
- Greater privacy and independence through local control using Valetudo.
For example, you could create an automation that starts a cleaning cycle when everyone leaves the house, and the Lovelace card will show progress in real time until the task is complete.
Common Issues and Troubleshooting
While the Lovelace Xiaomi Vacuum Map Card is stable and well-maintained, users may occasionally encounter issues during setup. Common problems include missing map images, incorrect entity references, or outdated integrations. Most of these can be resolved by verifying your integration settings and ensuring that the vacuum’s map data is accessible to Home Assistant.
If the map fails to load, check whether your vacuum supports live map streaming or whether you are using the correct camera entity. For Valetudo users, confirming that the web server integration is active often solves map-related problems.
Future of Smart Vacuum Integration
As smart home technology continues to evolve, tools like the Lovelace Xiaomi Vacuum Map Card demonstrate how devices can become more interactive and transparent. Future versions may offer even richer features, such as multi-map switching, AI-based room labeling, and integration with voice assistants. These improvements will make managing home cleaning even more intuitive and automated.
Developers and the Home Assistant community continue to refine the card, ensuring compatibility with new vacuum models and expanding customization capabilities. For users who value full control and real-time insights, this integration remains one of the most impressive examples of smart home innovation.
The Lovelace Xiaomi Vacuum Map Card has transformed how users interact with their Xiaomi and Roborock vacuum cleaners. By combining real-time visualization, custom controls, and deep integration with Home Assistant, it bridges the gap between smart cleaning hardware and intuitive digital control. Whether you want a clear overview of your cleaning routine or a fully automated setup, this map card brings a new level of convenience and intelligence to your smart home environment.