Valetudo

Self-contained control webinterface for xiaomi vacuum robots

Github星跟蹤圖

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

主要指標

概覽
名稱與所有者Hypfer/Valetudo
主編程語言JavaScript
編程語言JavaScript (語言數: 6)
平台
許可證Apache License 2.0
所有者活动
創建於2018-07-12 07:07:43
推送於2025-06-15 11:05:53
最后一次提交2025-06-15 13:05:42
發布數70
最新版本名稱2025.05.0 (發布於 )
第一版名稱0.0.1 (發布於 )
用户参与
星數7.4k
關注者數97
派生數416
提交數2.3k
已啟用問題?
問題數532
打開的問題數0
拉請求數417
打開的拉請求數0
關閉的拉請求數108
项目设置
已啟用Wiki?
已存檔?
是復刻?
已鎖定?
是鏡像?
是私有?