mirrors
/
Valetudo
mirror of https://github.com/Hypfer/Valetudo.git
0
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Cloud replacement for vacuum robots enabling local-only operation
2,106 Commits 3 Branches 62 Tags 217 MiB
JavaScript 66.1%
TypeScript 32.7%
Kaitai Struct 0.8%
CSS 0.2%
HTML 0.2%
Go to file
Sören Beye 9dab16c50e fix(mqtt): Bump to mqttjs v5.5.5 to fix some keep-alive related issues 2024-04-30 19:17:27 +02:00
.github chore(build): Bump all github actions to node 20 2024-04-25 20:30:43 +02:00
assets feat(ui): Replace new icons with custom new icons + remove new icon dependency 2023-12-24 09:34:31 +01:00
backend fix(mqtt): Bump to mqttjs v5.5.5 to fix some keep-alive related issues 2024-04-30 19:17:27 +02:00
build_dependencies/pkg/v3.5 chore(build): Bump to NodeJS v20.10.0 2023-12-06 18:28:51 +01:00
docs docs(vendor.roborock): Fix link to init override method 2024-04-25 19:45:08 +02:00
frontend fix(ui): Prevent the creation of virtual walls with a length of 0 2024-04-27 17:35:31 +02:00
util feat(mqtt): Publish ValetudoEvents to MQTT and allow interacting with it via MQTT 2024-01-26 18:03:17 +01:00
.automated_overrides.eslintrc.json chore: Minor misc cleanups 2022-07-24 09:17:29 +02:00
.eslintrc.json chore: Disallow some more footguns with eslint 2023-12-03 19:18:00 +01:00
.gitignore chore: Add .vscode to .gitignore (#1470) 2022-04-14 10:50:53 +02:00
.npmrc chore: Bump dependencies 2022-05-22 18:03:11 +02:00
.pedantic_overrides.eslintrc.json chore: Minor misc cleanups 2022-07-24 09:17:29 +02:00
CONTRIBUTING.md docs: Misc 2024-01-06 10:49:31 +01:00
LICENSE chore: Update license 2021-09-23 19:28:33 +02:00
README.md docs: Update telegram group invite links 2024-03-08 10:10:01 +01:00
package-lock.json fix(mqtt): Bump to mqttjs v5.5.5 to fix some keep-alive related issues 2024-04-30 19:17:27 +02:00
package.json chore(release): 2024.02.0 2024-02-14 20:36:39 +01:00

README.md

valetudo

Free your vacuum from the cloud

Valetudo is a cloud replacement for vacuum robots enabling local-only operation. It is not a custom firmware.
Here's a diagram illustrating the core operation principle:

Because Valetudo is not a custom firmware, it cannot change anything about how the robot operates.
What it can do however is protect your data and enable you to connect your robot to your home automation system without having to detour through a vendor cloud, which, apart from the whole data problematic, might not be reachable due to your internet connection being down or some servers in the datacenter being on fire.

Not having to leave your local network of course also benefits the latency of commands, status reports etc.

Valetudo aims to be proof that easy to use and reliable smart appliances are possible without any cloud and/or account requirements. Maybe at some point it might help convince vendors that there is another way of doing things.

By default, Valetudo provides control over your vacuum robot via a responsive webinterface that works on all of your devices. It can be used on phones, tablets as well as your desktop computer.

Furthermore, there's a REST-interface documented with Swagger UI as well as MQTT. With support for both Homie and Home Assistant Autodiscovery for MQTT, you should be able to connect Valetudo to the open-source smarthome software of your choice.

For more information, check out the newcomer guide, the getting started guide and also the docs in general at https://valetudo.cloud

There, you will find a list of supported robots.

Screenshots

Phone/Mobile

Tablet/Desktop

image

image

image

image

Further questions?

Valetudo Telegram group

Contributing

Make sure to familiarize yourself with the ./CONTRIBUTING.md

Honourable mentions

Valetudo and its companion applications are developed using JetBrains IDEs such as WebStorm. Licenses for those have been provided for free by JetBrains to the project in context of their open source support program since multiple years now.

Thanks a lot for that!