Homeassistant Vacuum Viomi integration for HACS

Xiaomi Viomi vacuum robot integration for Home Assistant.

:warning: DISCLAIMER: This code is an early alpha release with all related consequences. If you decide to use it, any feedback is appreciated

Installation

HACS

Install it through HACS by adding this as a custom repository: https://github.com/nergal/homeassistant-vacuum-viomi, go to the integrations page in your configuration, click on the Add Integration button in the bottom right corner of a screen, and search for Xiaomi Viomi Vacuum.

Manual

Copy contents of custom_components folder to your Home Assistant config/custom_components folder. Restart Home Assistant, and then the integration can be added and configured through the native integration setup. If you don't see it in the native integrations list, press Ctrl+F5 to refresh the browser while you're on that page and retry.

Also you may add the manual configuration to configuration.yaml file, like the example below:

vacuum:
  - platform: xiaomi_viomi
    host: 192.168.1.1
    token: !secret vacuum
    name: Vacuum V8

Tested models

Disclaimer

This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with the Xiaomi Corporation, or any of its subsidiaries or its affiliates. The official Xiaomi website can be found at https://www.mi.com/global/.

License

This project is under the MIT license.

Additional information for users from Russia and Belarus

• Russia has illegally annexed Crimea in 2014 and brought the war in Donbas followed by full-scale invasion of Ukraine in 2022.
• Russia has brought sorrow and devastations to millions of Ukrainians, killed hundreds of innocent people, damaged thousands of buildings, and forced several million people to flee.
• Putin khuylo!