Skip to content
forked from Hypfer/Valetudo

Self-contained control webinterface for vacuum robots

License

Notifications You must be signed in to change notification settings

bmwm69/Valetudo

 
 

Repository files navigation

valetudo

Free your vacuum from the cloud

Build Status

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.

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:

image image

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

Resources

About

Self-contained control webinterface for vacuum robots

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 79.1%
  • CSS 19.1%
  • HTML 1.7%
  • Other 0.1%