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 take a look at the knowledge base article to find out more about the supported models.

A mitigation for the Roborock factory resets has been found. For more information on that take a look at the release notes for 0.5.1 or Issue #206

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.

Screenshots:

And even more screenshots

Currently supported Features

This is an outdated list of Valetudo features on Rockrobo vacuums

• Live Map View
• Go-To
• Zoned Cleanup
• Configure Timers
• MQTT (including TLS support)
• MQTT HomeAssistant Autodiscovery
• Start/Stop/Pause Robot
• Find Robot/Send robot to charging dock
• Power settings
• Consumables status
• Wifi settings
• Carpet Mode
• Cleaning History
• Volume Control

Join the Discussion

• #valetudo on irc.freenode.net
• Valetudo Telegram group

Resources

• I can't believe it's not Valetudo - A companion service for PNG Maps