Free your vacuum from the cloud

Valetudo is an opinionated software solution for cloud-free vacuum robots installed on thousands of robots.
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, more than five 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

Tablet/Desktop

image

image

image

image

Further questions?

Valetudo Telegram group

Valetudo is a garden

This project is the hobby of some random guy on the internet. There is no intent to commercialize it, grow it or expand the target audience of it. In fact, there is intent to explicitly not do that.

Think of Valetudo as a privately-owned public garden. You can visit it any time for free and enjoy it. You can spend time there, and you can bring an infinite amount of friends with you to enjoy it. You can walk the pathways built there. You can sit on some patch of grass and maybe watch a Duck or something. You can leave a tip in the tip jar at the entrance if you really enjoy it and want to support it flourish.

You can take inspiration from it and bring that home to your own garden, giving it a personal twist and adapting it as needed. You can even make friendly suggestions if you have a really good idea that ties into the vision that is already there.

But, at the end of the day, you must understand that it is still privately-owned. You’re on someone else’s property over which you have no power at all. You will have to show the necessary respect. And - most importantly - you need to understand that letting you into this garden is a gift and should be treated as such.

If you don’t like this garden because you don’t like how it’s structured, or you feel like it’s missing something, or maybe I choose the wrong flowers to plant over there that’s fine. It’s just not for you then. You can leave at any time.

There is simply no ground to stand on to demand change to the garden. It doesn’t matter if it would attract more people or if all the other gardens in town are doing something in a specific way. It doesn’t matter if your idea of what gardens even are differs.
This at the end of the day is simply private property with free public access as a gift to everyone.

When it comes to software development, everyone has access to infinite plots of undeveloped land that they can claim at any time. Therefore, a garden being build with a specific vision does not take away the ability for anyone else to build their own garden with a different vision.

Valetudo

Cloud replacement for vacuum robots enabling local-only operation

View the Project on GitHub Hypfer/Valetudo

General

Newcomer Guide Why Valetudo? Why not Valetudo? Getting Started Supported Robots Rooting Essentials Buying Supported Robots

Installation

Dreame Roborock

Usage

Implementation Overview Capabilities Overview Upgrading Firmware Updates

Companion Apps

Valetudo Companion (Android) Valetudo Tray Companion 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 Style Guide Troubleshooting

Development

Building and Modifying Valetudo Valetudo core concepts MQTT