1.25.0 • Published 3 years ago

vacuum-card-miot v1.25.0

Weekly downloads
-
License
MIT
Repository
-
Last release
3 years ago

Vacuum Card

npm version hacs Patreon Buy Me A Coffee Twitter

Vacuum cleaner card for Home Assistant Lovelace UI

By default, Home Assistant does not provide any card for controlling vacuum cleaners. This card displays the state and allows to control your robot.

Preview of vacuum-card-miot-miot

Installing

💡 Tip: If you like this project and want to get some stickers and postcards, consider becoming a patron:

or just buy me a cup of ☕️ or 🥤:

HACS

This card is available in HACS (Home Assistant Community Store).

Just search for Vacuum Card in plugins tab.

Manual

  1. Download vacuum-card-miot-miot.js file from the latest-release.
  2. Put vacuum-card-miot-miot.js file into your config/www folder.
  3. Add reference to vacuum-card-miot-miot.js in Lovelace. There's two way to do that:
    1. Using UI: ConfigurationLovelace DashboardsResources Tab → Click Plus button → Set Url as /local/vacuum-card-miot-miot.js → Set Resource type as JavaScript Module. Note: If you do not see the Resources Tab, you will need to enable Advanced Mode in your User Profile
    2. Using YAML: Add following code to lovelace section.
      resources:
        - url: /local/vacuum-card-miot.js
          type: module
  4. Add custom:vacuum-card-miot to Lovelace UI as any other card (using either editor or YAML configuration).

Using the card

This card can be configured using Lovelace UI editor.

  1. In Lovelace UI, click 3 dots in top left corner.
  2. Click Configure UI.
  3. Click Plus button to add a new card.
  4. Find Custom: Vacuum Card in the list.
  5. Choose entity.
  6. Now you should see the preview of the card!

Sorry, no support for actions and stats in visual config yet.

Typical example of using this card in YAML config would look like this:

type: 'custom:vacuum-card-miot'
entity: vacuum.vacuum_cleaner
stats:
  default:
    - attribute: filter_left
      unit: hours
      subtitle: Filter
    - attribute: side_brush_left
      unit: hours
      subtitle: Side brush
    - attribute: main_brush_left
      unit: hours
      subtitle: Main brush
    - attribute: sensor_dirty_left
      unit: hours
      subtitle: Sensors
  cleaning:
    - attribute: cleaned_area
      unit: m2
      subtitle: Cleaning area
    - attribute: cleaning_time
      unit: minutes
      subtitle: Cleaning time
actions:
  - name: Clean living room
    service: script.clean_living_room
    icon: 'mdi:sofa'
  - name: Clean bedroom
    service: script.clean_bedroom
    icon: 'mdi:bed-empty'
  - name: Clean kitchen
    service: script.clean_kitchen
    icon: 'mdi:silverware-fork-knife'

Here is what every option means:

NameTypeDefaultDescription
typestringRequiredcustom:vacuum-card-miot
entitystringRequiredAn entity_id within the vacuum domain.
mapstringOptionalAn entity_id within the camera domain, for streaming live vacuum map.
map_refreshinteger5Update interval for map camera in seconds
imagestringdefaultPath to image of your vacuum cleaner. Better to have png or svg.
show_namebooleantrueShow friendly name of the vacuum.
show_statusbooleantrueShow status of the vacuum.
show_toolbarbooleantrueShow toolbar with actions.
compact_viewbooleanfalseCompact view without image.
statsobjectOptionalCustom per state stats for your vacuum cleaner
actionsobjectOptionalCustom actions for your vacuum cleaner.

stats object

You can use any attribute of vacuum or even any entity by entity_id to display by stats section:

NameTypeDefaultDescription
entity_idstringOptionalAn entity_id with state, i.e. sensor.vacuum.
attributestringOptionalAttribute name of the stat, i.e. filter_left.
unitstringOptionalUnit of measure, i.e. hours.
subtitlestringOptionalFriendly name of the stat, i.e. Filter.

actions object

You can defined custom scripts for custom actions i.e cleaning specific room and add them to this card with actions option.

NameTypeDefaultDescription
namestringOptionalFriendly name of the action, i.e. Clean bedroom.
servicestringOptionalA service to call, i.e. script.clean_bedroom.
iconstringOptionalAny icon for action button.
service_dataobjectservice_data for service call

Animations

I've added some animations for this card to make it alive. Animations are applied only for image property. Here's how they look like:

CleaningDocking
Cleaning anumationReturning anumation

Supported languages

This card supports translations. Please, help to add more translations and improve existing ones. Here's a list of supported languages:

  • English
  • Українська (Ukrainian)
  • Deutsch (German)
  • Français (French)
  • Italiano (Italian)
  • Nederlands (Dutch)
  • Polski (Polish)
  • Русский (Russian)
  • Español (Spanish)
  • Čeština (Czech)
  • Magyar (Hungarian)
  • עִבְרִית (Hebrew)
  • Português (Portuguese)
  • Svenska (Swedish)
  • Norsk bokmål (Norwegian)
  • Norsk nynorsk (Norwegian)
  • Dansk (Danish)
  • 한국어 (Korean)
  • Suomi (Finnish)
  • Català (Catalan)
  • 正體中文 (Traditional Chinese)
  • Việt Nam (Vietnamese)
  • Lietuvių (Lithuanian)
  • Your language?

Supported models

This card relies on basic vacuum services, like pause, start, stop, return_to_base, etc. It should work with any robot vacuum, however I can physically test it only with my own robot vacuum.

If this card works with your vacuum cleaner, please open a PR and your model to the list.

  • Roborock S6 MaxV
  • Roborock S6
  • Roborock S6 Pure
  • Roborock S5
  • Roborock S5 Max
  • Roborock S50
  • Roborock S4
  • Roborock S4 Max
  • Roborock E25
  • Roborock E4
  • Mijia Robot Vacuum Cleaner 1C (STYTJ01ZHM)
  • Xiaomi Mi Robot (STYJ02YM)
  • Xiaomi Mi Robot 1S
  • Xiaomi Mi Roborock V1 (SDJQR02RR)
  • Xiaomi Mijia 1C
  • Roomba 675
  • Roomba 960
  • Roomba 981
  • Roomba i7+
  • Dyson 360 Eye
  • Neato D7
  • Neato D6
  • Neato D4
  • Shark IQ
  • Ecovacs Deebot 950
  • EcoVacs Deebot OZMO T8 AIVI
  • EcoVacs Deebot N79
  • Eufy Robovac 30c
  • Eufy Robovac 15C Max
  • Mi Robot Vacuum-Mop P
  • Your vacuum?

Development

Want to contribute to the project?

First of all, thanks! Check contributing guideline for more information.

Inspiration

This project is heavily inspired by:

  • MacBury Smart House — basically, this project is a refinement of MacBury's custom card.
  • Benji vacuum card — this is where I noticed this vacuum card design for the first time.

Huge thanks for their ideas and efforts 👍

License

MIT © Denys Dovhan