# dgiese/dustcloud

Xiaomi Smart Home Device Reverse Engineering and Hacking

Repository: https://github.com/dgiese/dustcloud
Canonical: https://ross.abutalabs.com/products/dustcloud
Language: C
License: GPL-3.0
License Family: copyleft
Topics: iot, xiaomi, xiaomi-smart, root, hacking, vacuum, vacuum-cleaner
Last push: 2024-02-16T21:41:35+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3175, "days_push": 929, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2281, forks 260 (observed 2026-08-28T04:06:33.879478+00:00)

## What it is
A research project for reverse engineering and rooting Xiaomi Smart Home devices, including robot vacuums, providing methods to root devices without breaking the warranty seal. It served as a reference cloud emulation for Xiaomi devices but is now outdated, with vacuum functionality integrated into Valetudo.

## Use cases
- root xiaomi vacuum robot without voiding warranty
- reverse engineer xiaomi smart home devices
- emulate xiaomi cloud locally
- flash custom firmware on xiaomi vacuum
- cut xiaomi vacuum off from cloud
- hack xiaomi iot devices

## When to choose
- researching Xiaomi IoT device security or firmware internals
- needing historical documentation, teardowns, and UART logs for Xiaomi devices
- studying cloud emulation approaches for smart home devices

## When to avoid
- wanting a maintained local control solution for Xiaomi vacuum robots - use Valetudo instead
- looking for actively supported rooting instructions for current devices
- needing a general-purpose Xiaomi device control library - use python-miio instead

## Facets
- artifact type: application
- maturity: abandoned
- function: reverse-engineering, security, embedded
- domain: iot, security, reverse-engineering, robotics
- platform: embedded, iot
- tags: xiaomi, vacuum-robots, rooting, cloud-emulation, smart-home, firmware-hacking, linux

## Member repositories
- dgiese/dustcloud (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:33.879478+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-30T02:41:21.137687+00:00, confidence not recorded.
  - readme: https://github.com/dgiese/dustcloud (fetched 2026-08-28T04:06:33.879478+00:00, sha 8d0f194ed26a)
- Data as of 2026-08-30T08:39:29.467469+00:00.