# PiotrMachowski/Home-Assistant-custom-components-Xiaomi-Cloud-Map-Extractor

This custom integration provides a way to present a live view of a map for Xiaomi (Roborock/Viomi/Roidmi/Dreame) vacuums without a need for rooting.

Repository: https://github.com/PiotrMachowski/Home-Assistant-custom-components-Xiaomi-Cloud-Map-Extractor
Canonical: https://ross.abutalabs.com/products/home-assistant-custom-components-xiaomi-cloud-map-extractor
Language: Python
License: MIT
License Family: permissive
Topics: home-assistant, custom-component, xiaomi, xiaomi-smart-home, vacuum, robot, roborock, cloud, map, vacuum-map, hacs, xiaomi-vacuum, viomi, roidmi, dreame
Last push: 2026-02-20T03:21:16+00:00

## Health v2 (maintenance only)
Score: 65/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 68, release rhythm 40, longevity 100
- inputs: {"age_days": 2164, "days_push": 194, "days_rel": 425, "gap_med": 11, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1419, forks 163 (observed 2026-08-28T04:04:40.438863+00:00)

## What it is
A Home Assistant custom integration that extracts and displays a live map view of Xiaomi-family robot vacuums (Roborock, Viomi, Roidmi, Dreame) via the Xiaomi cloud, without rooting the device. It is installable through HACS or manually and renders map images with room segmentation inside Home Assistant dashboards.

## Use cases
- show a live map of my Xiaomi robot vacuum in Home Assistant
- view Roborock vacuum map without rooting
- display vacuum cleaning map with rooms in a dashboard
- extract the map from Xiaomi cloud for my Dreame vacuum
- monitor my robot vacuum's cleaning progress visually
- integrate Viomi or Roidmi vacuum maps into Home Assistant

## When to choose
- you use Home Assistant with a supported Xiaomi/Roborock/Viomi/Roidmi/Dreame vacuum
- you want a live map view without rooting the vacuum or running Valetudo
- you prefer a HACS-installable custom component

## When to avoid
- you don't use Home Assistant
- you want fully local map extraction without cloud access
- your vacuum model is not in the supported devices list

## Facets
- artifact type: plugin
- maturity: active
- function: image-processing, monitoring, plugin-system
- domain: iot, self-hosted
- platform: python, self-hosted
- tags: home-assistant, hacs, xiaomi, roborock, vacuum-map, custom-component, smart-home, automation, docker

## Member repositories
- PiotrMachowski/Home-Assistant-custom-components-Xiaomi-Cloud-Map-Extractor (main) score 65

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:40.438863+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:37:51.301994+00:00, confidence not recorded.
  - readme: https://github.com/PiotrMachowski/Home-Assistant-custom-components-Xiaomi-Cloud-Map-Extractor (fetched 2026-08-28T04:04:40.438863+00:00, sha c710f754ab96)
- Data as of 2026-08-30T08:39:29.467469+00:00.