# denysdovhan/vacuum-card

Vacuum cleaner card for Home Assistant Lovelace UI

Repository: https://github.com/denysdovhan/vacuum-card
Canonical: https://ross.abutalabs.com/products/vacuum-card
Homepage: https://denysdovhan.com/smart-home
Language: TypeScript
License: MIT
License Family: permissive
Topics: home-assistant, homeassistant, hass, lovelace, custom-cards, vacuum, robot-vacuum, hacs
Last push: 2026-08-18T10:57:28+00:00

## Health v2 (maintenance only)
Score: 88/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 69, longevity 100
- inputs: {"age_days": 2312, "days_push": 15, "days_rel": 207, "gap_med": 1, "n_releases_24m": 6}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1246, forks 624 (observed 2026-08-28T04:04:07.158026+00:00)

## What it is
A custom Lovelace card for Home Assistant that displays the state of robot vacuum cleaners and provides controls like start, stop, pause, and return to dock. It is installable via HACS or manually and configurable through the UI editor or YAML.

## Use cases
- control my robot vacuum from the home assistant dashboard
- show vacuum cleaner status and battery in lovelace
- add a vacuum card to home assistant UI
- display filter and brush lifetime stats for my vacuum
- send cleaning segment commands to xiaomi miio vacuum
- customize vacuum card actions and shortcuts in lovelace

## When to choose
- you use Home Assistant with a robot vacuum and want a dedicated control card
- you want configurable stats, shortcuts, and actions for your vacuum entity
- you install custom cards via HACS and want a well-maintained option

## When to avoid
- you don't use Home Assistant or Lovelace dashboards
- you need a card for non-vacuum devices
- you need visual editor support for actions, shortcuts, and stats, which is not yet available

## Facets
- artifact type: plugin
- maturity: active
- function: ui-components, developer-tools
- domain: iot, frontend
- platform: browser, self-hosted
- tags: home-assistant, lovelace, custom-card, hacs, robot-vacuum, typescript, dashboard, home-automation, web

## Member repositories
- denysdovhan/vacuum-card (main) score 88

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:07.158026+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:08:02.874489+00:00, confidence not recorded.
  - readme: https://github.com/denysdovhan/vacuum-card (fetched 2026-08-28T04:04:07.158026+00:00, sha c4c7a6eebf33)
  - homepage: https://denysdovhan.com/smart-home (fetched 2026-08-29T12:19:31.798067+00:00, sha 3629b6d3e3ce)
  - site_page: https://denysdovhan.com/smart-home/software/getting-started (fetched 2026-08-29T12:19:31.807270+00:00, sha b2ca318cc6e6)
  - registry_npm: https://registry.npmjs.org/vacuum-card (fetched 2026-08-29T12:19:31.809133+00:00, sha f0bd5f38738c)
- Data as of 2026-08-30T08:39:29.467469+00:00.