Valetudo

Open source cloud replacement for vacuum robots enabling local-only operation

View the Project on GitHub Hypfer/Valetudo

General

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

Installation

Roborock OTA Viomi

Companion Apps

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

Integrations

MQTT Home Assistant Node-RED openHAB

Misc

FAQ Roborock, Files to backup Style Guide Troubleshooting

Development

Building and Modifying Valetudo Valetudo core concepts MQTT

Archive

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

valetudo

Free your vacuum from the cloud

Valetudo is the de-facto-standard open-source software solution for cloud-free vacuum robots empowering thousands of users.
Since it was started in 2018, it has matured to a reliable fire-and-forget solution that just works.

Valetudo is made, managed, maintained and more by me, Sören Beye, with occasional contributions by these awesome people.
It would not exist without the ongoing work of Dennis Giese, who is constantly providing us with new ways of liberating and gaining actual ownership of our robots.

As there is no telemetry built-in and no commercial interest to change that, I can’t tell you how many users exactly are there, however judging by download counts and support group members, I’d guesstimate that there are a few thousand.

If you want to learn more about why someone would want to use something like Valetudo, check out the Why Valetudo? page.

If you want to learn more about why someone would not want to use something like Valetudo, check out the Why not Valetudo? page.

To choose the right robot to buy, head over to Buying supported robots.

If you want to learn more about why I’m building Valetudo, the answer is actually pretty simple:
When I was looking for a vacuum robot for myself, I didn’t find anything that matched what I was looking for.
Thus, in a brief moment of hubris, I thought to myself: “How hard can it be?”.
Now, four years later, we’re here and I’m quite happy with how it turned out.

Valetudo is licensed under the Apache-2.0 open-source license, because you need to be able to know what your smart devices are doing and also alter (some parts of) it without being dependent on some vendor and/or third party. The only way of truly achieving that is by being able to see and modify the code.

The Apache-2.0 license is a very permissive license and a lot of work is being shared for free here, so I trust people to not take advantage of that and sell Valetudo; especially not as their own work.
Please don’t disappoint me. Thank you.

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

The getting started guide is a good place to start.

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

Screenshots

Phone/Mobile

image image

image image

Tablet/Desktop

image

image

image

image

Join the Discussion

Expectation Management

This project is the hobby of some random guy on the internet who really does not care about market share.
It does what I want it to do, so I’m happy with it.