> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kansolabs.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Robot Vacuum Map

> A live map of your robot vacuum in Home Assistant, from Xiaomi's cloud, with no rooting.

Robot Vacuum Map is a Home Assistant integration, installed through HACS, that draws a live map of your robot vacuum from Xiaomi's cloud. It reads Xiaomi, Roborock, Dreame, Viomi, Roidmi and iJai vacuums, and needs no rooting.

![A map drawn without rooms](https://raw.githubusercontent.com/kanso-labs/home-assistant-robot-vacuum-map/main/images/map_no_rooms.png)

![The same map with its rooms coloured](https://raw.githubusercontent.com/kanso-labs/home-assistant-robot-vacuum-map/main/images/map_rooms.png)

It is a kanso-labs copy of Piotr Machowski's [Xiaomi Cloud Map Extractor](https://github.com/PiotrMachowski/Home-Assistant-custom-components-Xiaomi-Cloud-Map-Extractor), with a domain of its own, `robot_vacuum_map`, so the two can be installed side by side. The copy exists so that the Xiaomi Robot Vacuum S20+ is drawn live.

> **[Install](/home-assistant/robot-vacuum-map/installation.md)**
>
> Through HACS, on Home Assistant 2026.3 or later.

> **[Set it up](/home-assistant/robot-vacuum-map/configuration.md)**
>
> Sign in to Xiaomi, pick the vacuum, then adjust the map.

> **[Entities](/home-assistant/robot-vacuum-map/entities.md)**
>
> The map, its controls and a sensor for each element.

> **[Supported vacuums](/home-assistant/robot-vacuum-map/supported-vacuums.md)**
>
> Which map API a model is read through.

## Source

The integration lives in [kanso-labs/home-assistant-robot-vacuum-map](https://github.com/kanso-labs/home-assistant-robot-vacuum-map), and its work is planned on the [Robot Vacuum Map project](https://github.com/orgs/kanso-labs/projects/7). It is MIT licensed, keeping Piotr Machowski's copyright notice beside Kanso Labs', and it credits almirus for the S20+ work in [upstream pull request #750](https://github.com/PiotrMachowski/Home-Assistant-custom-components-Xiaomi-Cloud-Map-Extractor/pull/750).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.