Skip to content
Self-contained control webinterface for xiaomi vacuum robots
JavaScript CSS HTML Other
Branch: master
Clone or download
Latest commit d751a63 Jan 17, 2020
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Create support_request.md Jan 17, 2020
assets/logo Logo Kerning Apr 6, 2019
client theme: persist user choice into local storage Nov 29, 2019
deployment speed up the build by using 1 run Jun 28, 2019
develop read model from device.conf and provide it with /api/current_status May 13, 2019
lib refactors shutdown calls from sync to async Nov 29, 2019
util Added more letters to text drawing utility May 31, 2019
.gitignore Add a Makefile (#159) Apr 8, 2019
.travis.yml
Dockerfile feat(docker): switch to yarn and latest node lts Oct 2, 2019
LICENSE Initial commit Jul 12, 2018
Makefile Moved MQTT PNG Drawing to seperate project Apr 12, 2019
README.md Update README.md Oct 3, 2019
Testing.md Added development / building script and documentation Nov 20, 2018
index.js refactors shutdown calls from sync to async Nov 29, 2019
package.json Bump to Valetudo 0.4.0 Jul 14, 2019
yarn.lock Bump lodash from 4.17.11 to 4.17.14 Jul 14, 2019

README.md

valetudo

Free your vacuum from the cloud

Build Status

PSA: DO NOT UPDATE YOUR GEN2 TO 1910 & GEN1 TO 4004

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.

Please don't forget to take a look at the FAQ where you should find the answers to all of your questions.

Currently supported Features

  • 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

Screenshots:

image image image image image image image image image image image

Join the Discussion

Resources

You can’t perform that action at this time.