/Valetudo

Self-contained control webinterface for xiaomi vacuum robots

Primary LanguageJavaScriptApache License 2.0Apache-2.0

valetudo

Free your vacuum from the cloud

Build Status

Valetudo is a standalone binary which runs on rooted Xiaomi Vacuums 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.

This Project is made possible by the work of many voluntary contributers. ❤

Supported Hardware

As of now, only Gen1 + Gen2 Xiaomi Vacuums are rootable and hence supported by Valetudo.

Getting started

Just follow the installation guide in the wiki.

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.

Currently supported Features

  • Live Map View
  • Go-To
  • Zoned Cleanup
  • Configure Timers
  • MQTT
  • 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

Screenshots:

image image image image image image image image image image image

Join the Discussion

FAQ

Q: Why the name?

A: Valetudo is the roman name for the greek goddess Hygieia which is the goddess of health, cleanliness and hygiene. Also I'm bad at naming things.