sanderdrummer/Valetudo

Free your vacuum from the cloud

Valetudo is a standalone binary which runs on rooted Vacuums of the Xiaomi ecosystem and aims to enable the user to operate the robot vacuum without any Cloud Connection whatsoever.

Valetudo provides (almost) all settings and controls of the Xiaomi Vacuum in a mobile-friendly webinterface as well as optional MQTT Connectivity which supports Home Assistant Autodiscovery.

Supported Hardware

Currently, there are two different families of supported robot vacuums

Roborock Vacuums

There are two supported Roborock vacuums:

Gen 1 Xiaomi Mi SDJQR02RR aka Mi Robot Vacuum rockrobo.vacuum.v1
Gen 2 Roborock S50/S51/S55 (depending on color) roborock.vacuum.s5

Everything else is unrootable (yet) and therefore not supported by Valetudo.
This includes the S6 as well as the S5 Max.

Please note that there's currently an unresolved problem with random firmware resets on roborock vacuums.
We're looking into it.

Furthermore, newer firmware versions such as 1910 for Gen 2 as well as 4004 for Gen 1 disabled local OTA Updates.
If you have these firmware versions installed, you will not be able to root the robot without factory-resetting it first.

Viomi Vacuums

Currently, there's WIP support for the following Viomi Vacuums:

Xiaomi Mijia STYJ02YM viomi.vacuum.v7

See here for more information on that.

Getting started

For Roborock vacuums, just follow the installation guide.

The configuration file stored in /mnt/data/valetudo/config.json survives firmware upgrades. The Valetudo binary however does not so if you are upgrading your firmware, you will have to follow said guide again.

Please don't forget to take a look at the FAQ where you should find the answers to all of your questions.