# hypfer/valetudo

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/hypfer-valetudo).**

8,689 stars · 462 forks · JavaScript · apache-2.0

## Links

- GitHub: https://github.com/Hypfer/Valetudo
- Homepage: https://valetudo.cloud
- awesome-repositories: https://awesome-repositories.com/repository/hypfer-valetudo.md

## Topics

`cloud-free` `dreame` `roborock` `robot-vacuum` `smarthome` `valetudo` `xiaomi`

## Description

Valetudo is a custom firmware project for robot vacuums that enables local-only control, removing dependencies on cloud servers and protecting user privacy. It replaces proprietary vendor binaries with open source software to ensure that data, including floor plans and images, is not uploaded to external clouds.

The project distinguishes itself by providing a rooted firmware installation process that prevents forced vendor updates. It implements a standardized control interface across different hardware brands and utilizes an MQTT-based message bus to facilitate integration with open source automation platforms and remote monitoring tools.

The system covers a wide range of capabilities, including real-time map visualization, advanced hardware configuration for suction and water flow, and cleaning zone management via virtual walls. It also includes tools for map data standardization, consumables monitoring, and manual robot driving.

Users can manage their devices through a responsive web-based dashboard and deploy the firmware using over-the-air updates or hardware-level flashing.

## Tags

### Part of an Awesome List

- [Robot Vacuums](https://awesome-repositories.com/f/awesome-lists/devtools/robot-vacuums.md) — Provides a complete system for managing robot vacuum operations, hardware settings, and cleaning zones. ([source](https://valetudo.cloud/pages/general/newcomer-guide/))
- [Smart Home Automation](https://awesome-repositories.com/f/awesome-lists/productivity/smart-home-automation.md) — Integrates vacuum hardware with open source automation platforms and MQTT message brokers.

### Mobile Development

- [Custom Hardware Firmware](https://awesome-repositories.com/f/mobile-development/mobile-operating-systems/firmware-customization-tools/custom-firmware-integration-systems/custom-hardware-firmware.md) — Implements a custom rooted firmware that replaces proprietary binaries to ensure local-only operation and privacy.

### Security & Cryptography

- [Local-Only Data Processing](https://awesome-repositories.com/f/security-cryptography/privacy-data-protection/local-only-data-processing.md) — Ensures all commands and data are processed within the local network to eliminate cloud dependencies and protect privacy.
- [User Privacy Protection](https://awesome-repositories.com/f/security-cryptography/user-privacy-protection.md) — Prevents the upload of floor plans, images, and audio to cloud storage to protect user privacy. ([source](https://valetudo.cloud/pages/general/why-valetudo/))

### Hardware & IoT

- [Automation Integrations](https://awesome-repositories.com/f/hardware-iot/connectivity-iot/home-automation/smart-home-bridges/automation-integrations.md) — Connects robot hardware to home automation hubs and ecosystems using standardized messaging protocols. ([source](https://valetudo.cloud/pages/general/newcomer-guide/))
- [Device Management](https://awesome-repositories.com/f/hardware-iot/connectivity-iot/internet-of-things/device-management.md) — Provides interfaces for monitoring and controlling robot vacuum hardware over a local network. ([source](https://valetudo.cloud/pages/integrations/home-assistant-integration/))
- [Robotics and Control](https://awesome-repositories.com/f/hardware-iot/embedded-robotics/robotics-autonomous-systems/robotics-drones/robotics-and-control.md) — Implements basic robotic control for starting, pausing, stopping, and docking the vacuum. ([source](https://valetudo.cloud/pages/usage/capabilities-overview/))
- [Rooted Installations](https://awesome-repositories.com/f/hardware-iot/firmware-management/rooted-installations.md) — Provides a rooted firmware installation process to enable local-only control and prevent forced vendor updates. ([source](https://valetudo.cloud/pages/usage/firmware-updates/))
- [Firmware Replacement Tools](https://awesome-repositories.com/f/hardware-iot/firmware-replacement-tools.md) — Provides tools to replace proprietary vendor firmware with custom open-source software to gain administrative access.
- [Hardware Interface Standardizations](https://awesome-repositories.com/f/hardware-iot/hardware-interface-standardizations.md) — Provides a consistent control interface across different hardware brands to manage multiple vacuum models. ([source](https://valetudo.cloud/pages/general/why-valetudo/))
- [Live Map Monitoring](https://awesome-repositories.com/f/hardware-iot/live-map-monitoring.md) — Displays real-time location and movement of the robot on a map of the environment. ([source](https://valetudo.cloud/pages/general/newcomer-guide/))
- [Local Robot Vacuum Control](https://awesome-repositories.com/f/hardware-iot/local-robot-vacuum-control.md) — Operates robot vacuums over a local network, removing dependencies on external cloud servers.
- [Open Source Automation Integrations](https://awesome-repositories.com/f/hardware-iot/open-source-automation-integrations.md) — Exposes device capabilities to open source automation platforms for deeper integration and remote management. ([source](https://valetudo.cloud/pages/general/why-valetudo/))
- [Robot Mapping and Visualization](https://awesome-repositories.com/f/hardware-iot/robot-mapping-and-visualization.md) — Creates and exports floor plans and real-time activity maps without uploading data to external clouds.
- [Robot Operation Automation](https://awesome-repositories.com/f/hardware-iot/robot-operation-automation.md) — Provides remote commands to automate the start, stop, and charging operations of the robot. ([source](https://valetudo.cloud/pages/integrations/mqtt/))
- [Navigation Behavior Configuration](https://awesome-repositories.com/f/hardware-iot/autonomous-flight-controllers/navigation-behavior-configuration.md) — Toggles obstacle avoidance, AI-based pet detection, and the balance between collision avoidance and coverage. ([source](https://valetudo.cloud/pages/usage/capabilities-overview/))
- [Cleaning Area Definitions](https://awesome-repositories.com/f/hardware-iot/cleaning-area-definitions.md) — Allows triggering of cleaning for specific rooms, segments, or custom-drawn zones on a map. ([source](https://valetudo.cloud/pages/usage/capabilities-overview/))
- [Cleaning Zone Management](https://awesome-repositories.com/f/hardware-iot/cleaning-zone-management.md) — Defines specific rooms, sets virtual walls, and establishes no-go zones to restrict movement. ([source](https://valetudo.cloud/pages/general/newcomer-guide/))
- [IoT Device Provisioning](https://awesome-repositories.com/f/hardware-iot/connectivity-iot/internet-of-things/device-management/iot-device-provisioning.md) — Simplifies the initial setup of new vacuum instances through a guided provisioning process. ([source](https://valetudo.cloud/pages/companion_apps/valetudo_companion/))
- [Firmware Deployment Tools](https://awesome-repositories.com/f/hardware-iot/firmware-deployment-tools.md) — Deploys customized firmware via OTA updates, shell manipulation, or hardware-level flashing. ([source](https://valetudo.cloud/pages/installation/roborock/))
- [Firmware OTA Update Systems](https://awesome-repositories.com/f/hardware-iot/firmware-management/remote-firmware-updaters/firmware-ota-update-systems.md) — Enables the wireless deployment of modified system images to maintain persistent local control over the device.
- [Map Data Management](https://awesome-repositories.com/f/hardware-iot/map-data-management.md) — Provides tools to reset maps, restore snapshots, and rename cleaning segments. ([source](https://valetudo.cloud/pages/usage/capabilities-overview/))
- [Map Data Standardization](https://awesome-repositories.com/f/hardware-iot/map-data-standardization.md) — Converts proprietary vendor map formats into a unified format for use in third-party applications. ([source](https://valetudo.cloud/pages/general/newcomer-guide/))
- [Mapping Process Execution](https://awesome-repositories.com/f/hardware-iot/mapping-process-execution.md) — Starts a dedicated mapping process to build a floor plan without performing a full cleanup. ([source](https://valetudo.cloud/pages/usage/capabilities-overview/))
- [Movement Restriction Zones](https://awesome-repositories.com/f/hardware-iot/movement-restriction-zones.md) — Configures virtual walls and restricted zones to prevent the robot from entering specific areas. ([source](https://valetudo.cloud/pages/usage/capabilities-overview/))
- [Real-Time Map Visualizations](https://awesome-repositories.com/f/hardware-iot/real-time-map-visualizations.md) — Provides a real-time visual representation of the robot's position and cleaning progress on a map. ([source](https://valetudo.cloud/pages/integrations/home-assistant-integration/))
- [Physical Performance Tuning](https://awesome-repositories.com/f/hardware-iot/robot-hardware-customization/physical-performance-tuning.md) — Enables advanced tuning of suction power, water flow, and sensor behavior for customized cleaning performance.
- [Robot Map Rendering](https://awesome-repositories.com/f/hardware-iot/robot-map-rendering.md) — Renders spatial map data within the dashboard to show coverage and robot location. ([source](https://valetudo.cloud/pages/companion_apps/lovelace_valetudo_map_card/))
- [Robot Vacuum Management Interfaces](https://awesome-repositories.com/f/hardware-iot/robot-vacuum-management-interfaces.md) — Offers a responsive web dashboard specifically for controlling robot vacuum operations. ([source](https://cdn.jsdelivr.net/gh/hypfer/valetudo@master/README.md))
- [Targeted Cleaning Operations](https://awesome-repositories.com/f/hardware-iot/targeted-cleaning-operations.md) — Triggers cleaning for specific map segments, predefined zones, or single locations using structured data payloads. ([source](https://valetudo.cloud/pages/integrations/mqtt/))

### Networking & Communication

- [MQTT Messaging Integrations](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/communication-apis/mqtt-messaging-integrations.md) — Implements an MQTT-based messaging system to exchange device status and control commands with a central broker.
- [Local Network Discovery](https://awesome-repositories.com/f/networking-communication/local-network-discovery.md) — Ensures all robot operations are executed over the local network without external cloud dependencies. ([source](https://valetudo.cloud/pages/general/why-valetudo/))
- [Local Web Interfaces](https://awesome-repositories.com/f/networking-communication/local-web-interfaces.md) — Provides a browser-accessible dashboard that communicates directly with the device via local network protocols.

### Operating Systems & Systems Programming

- [Firmware Rooting](https://awesome-repositories.com/f/operating-systems-systems-programming/firmware-rooting.md) — Gains administrative access to the operating system using hardware interfaces to allow custom software installation. ([source](https://valetudo.cloud/pages/installation/dreame/))
- [Firmware Update Protections](https://awesome-repositories.com/f/operating-systems-systems-programming/os-development-distributions/firmware-management/firmware-update-protections.md) — Prevents forced vendor firmware updates to ensure the persistence of local-only control. ([source](https://valetudo.cloud/pages/general/why-valetudo/))

### Data & Databases

- [Message Broker Connectivity](https://awesome-repositories.com/f/data-databases/redis-clients/cluster-connectivity/message-broker-connectivity.md) — Provides the ability to link robot hardware to an external message broker for remote control and monitoring. ([source](https://valetudo.cloud/pages/general/getting-started/))

### Development Tools & Productivity

- [Hardware Configuration Utilities](https://awesome-repositories.com/f/development-tools-productivity/hardware-configuration-utilities.md) — Implements low-level hardware adjustments for fan speed, water usage, and carpet sensor behavior. ([source](https://valetudo.cloud/pages/integrations/mqtt/))
- [Cleaning Hardware Settings](https://awesome-repositories.com/f/development-tools-productivity/session-configuration-management/runtime-setting-controls/cleaning-hardware-settings.md) — Enables precise control over water flow, mop extension, and twisting movements. ([source](https://valetudo.cloud/pages/usage/capabilities-overview/))

### Software Engineering & Architecture

- [Automated Device Discovery](https://awesome-repositories.com/f/software-engineering-architecture/automatic-configuration/automated-device-discovery.md) — Automatically locates and configures compatible robot instances using standard home automation discovery. ([source](https://valetudo.cloud/pages/integrations/mqtt/))
- [Hardware Abstraction Layers](https://awesome-repositories.com/f/software-engineering-architecture/hardware-abstraction-layers.md) — Translates standardized control commands into proprietary payloads for various robot vacuum hardware models.
- [Device Control Interfaces](https://awesome-repositories.com/f/software-engineering-architecture/tool-exposure-interfaces/device-control-interfaces.md) — Exposes a web interface and messaging bridge for external platforms to trigger and monitor device activities. ([source](https://cdn.jsdelivr.net/gh/hypfer/valetudo@master/README.md))

### User Interface & Experience

- [Vacuum Suction Configurators](https://awesome-repositories.com/f/user-interface-experience/range-sliders/fan-speed-range-configurators/vacuum-suction-configurators.md) — Allows setting fan speed and toggling automatic suction increases when carpets are detected. ([source](https://valetudo.cloud/pages/usage/capabilities-overview/))
- [Web-Based Control Panels](https://awesome-repositories.com/f/user-interface-experience/web-based-control-panels.md) — Provides a responsive web-based control panel for device management without proprietary apps. ([source](https://valetudo.cloud/pages/general/why-valetudo/))
- [Web Dashboards](https://awesome-repositories.com/f/user-interface-experience/web-dashboards.md) — Provides a browser-based dashboard for operating the device independently of cloud accounts. ([source](https://valetudo.cloud/pages/general/getting-started/))

### Web Development

- [Network Instance Detection](https://awesome-repositories.com/f/web-development/network-instance-detection.md) — Detects active robot instances on the local network using broadcasts to avoid manual IP entry. ([source](https://valetudo.cloud/pages/companion_apps/valetudo_companion/))