Skip to content
Simple card for Xiaomi robot vaccums in Home Assistant's Lovelace UI
Branch: master
Clone or download
Latest commit c13f058 May 21, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples Support friendly/custom name Apr 9, 2019
img Optimize ecovacs vacuum image Apr 29, 2019
CHANGELOG.md Update version (2.2.0) May 21, 2019
LICENSE Initial commit Apr 8, 2019
README.md Update version (2.2.0) May 21, 2019
tracker.json Update version (2.2.0) May 21, 2019
xiaomi-vacuum-card.js Add clean spot button and button display-options (closes #7) May 21, 2019

README.md

xiaomi-vacuum-card

Simple card for Xiaomi (and some other) robot vaccums in Home Assistant's Lovelace UI

GH-release GH-last-commit GH-code-size

Setup

Add xiaomi-vacuum-card.js to your <config>/www/ folder. Add the following to your ui-lovelace.yaml file:

resources:
  - url: /local/xiaomi-vacuum-card.js?v=2.2.0
    type: js

If you want to use the vacuum background image, add img/vacuum.png to <config>/www/img/.

(Optional) Add to custom updater

  1. Make sure you have the custom_updater component installed and working.

  2. Add a new reference under card_urls in your custom_updater configuration in configuration.yaml.

custom_updater:
  card_urls:
    - https://raw.githubusercontent.com/benct/lovelace-xiaomi-vacuum-card/master/tracker.json

Options

Name Type Default Description
type string Required custom:xiaomi-vacuum-card
entity string Required vacuum.my_xiaomi_vacuum
name string/bool friendly_name Override entity friendly name (set to false to hide title)
image string/bool /local/img/vacuum.png Custom path/name of background image (set to false to disable background)
buttons object/bool (see below) Set to false to hide button row
labels object (see below) Customize or translate label names

Buttons object

Name Type Default Description
start bool true Show or hide start button
pause bool true Show or hide pause button
stop bool true Show or hide stop button
spot bool false Show or hide clean spot button
locate bool true Show or hide locate button
return bool true Show or hide return to home button

Labels object

Name Type Default Description
status string Status Change status label
battery string Battery Change battery label
mode string Mode Change mode label
main_brush string Main Brush Change main brush label
side_brush string Side Brush Change side brush label
filter string Filter Change filter label
sensor string Sensor Change sensor label
hours string h Change hours label

Other vendors

This card was originally written for Xiaomi (Roborock) vacuum cleaners, but version 2.0 and later has added support for some other vendors too. If you think any more vendors should be added, feel free to open an issue or contribute directly with a PR.

Name Type Default Description
vendor string xiaomi Supported vendors: xiaomi, ecovacs

Note: Vendor ecovacs shows by default the clean spot button instead of the stop button

Examples

xiaomi-vacuum-card

Hidden title/name

xiaomi-vacuum-card-no-title

Hidden button row

xiaomi-vacuum-card-no-buttons

No background image

xiaomi-vacuum-card-no-background

- type: custom:xiaomi-vacuum-card
  entity: vacuum.xiaomi_vacuum_cleaner
  image: /local/custom/folder/background.png
  name: Xiaomi Vacuum
  buttons: true
  labels:
    status: Etat
    battery: Batterie
    mode: Puissance
    main_brush: Brosse Principale
    side_brush: Brosse Latérale
    filter: Filtre
    sensor: Capteurs

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/.

My cards

xiaomi-vacuum-card | github-entity-row | multiple-entity-row | attribute-entity-row

BMC

You can’t perform that action at this time.