Valetudo aims to be a vendor-agnostic abstraction and cloud replacement for vacuum robots which started as a standalone binary on rooted roborock vacuums.

View the Project on GitHub Hypfer/Valetudo


Newcomer Guide Late 2021 Why Valetudo? Getting Started Supported Robots Capabilities Overview Rooting instructions Upgrading Buying supported robots


Roborock OTA Viomi

Companion Apps

Valetudo Companion (Android) Valeronoi Lovelace Valetudo Map Card I can't believe it's not Valetudo node-red-contrib-valetudo Fun & Games Other Noteworthy Projects


MQTT Home Assistant Node-RED openHAB


FAQ Frequently requested features Roborock, Files to backup Troubleshooting


Building and Modifying Valetudo Valetudo core concepts MQTT


Supported Dreame Devices Supported Roborock Devices Supported Viomi Devices Newcomer Guide Early 2021


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.

These are the Valetudo Docs. Simply use the navigation menu on the left to find what you’re looking for.

If you’re missing something, or you’ve found something wrong or outdated, feel free to edit the page and open a PR. You can also add new pages if you want to document something that isn’t documented yet.

Also, make sure to check out the companion apps section.



image image

image image





Join the Discussion

Expectation Management

This project is the hobby of some random guy on the internet. There is no intent to monetize Valetudo now or in the future meaning that market share is irrelevant. Therefore, this is run as a zero compromises project.

This project is not user focussed. It is provided for free as open source to anyone but that’s all. User satisfaction is no goal of Valetudo.

As Valetudo only exists because it is fun to maintain/improve/etc., any departure from this core policy would be the death of the project. It could be a slow death with the values slowly eroding in favour of monetization/data stealing/etc. but it would be a death either way.

I don’t want Valetudo to die. I’m pretty sure that you don’t want that either. Thus, please be mindful of that fact next time you’re angry about your ideas being rejected because they don’t fit the projects goals.