explaingit

adnpolymerase/ha-appliance-card

Analysis updated 2026-05-18

16JavaScriptAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A Home Assistant dashboard card showing washer, dryer, or dishwasher status and controls, that works with any brand through configurable entity mapping.

Mindmap

mindmap
  root((appliance card))
    What it does
      Shows washer dryer status
      Program and time remaining
      Start pause stop controls
    Tech stack
      JavaScript
      Home Assistant
      HACS
    Features
      Brand agnostic mapping
      Multi language state detection
      Animated illustrations
    Setup
      One required entity
      Visual editor autofill
      Installed via HACS
    Audience
      Home Assistant users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Show a laundry machine's live status and remaining time on a Home Assistant dashboard.

USE CASE 2

Add start, pause, and stop buttons for a dishwasher without brand-specific integration code.

USE CASE 3

Normalize inconsistent state names from different appliance brands into one clean status.

USE CASE 4

Build a custom smart plug based laundry monitor using template sensors mapped to the card.

What is it built with?

JavaScriptHome AssistantHACSLovelace

How does it compare?

adnpolymerase/ha-appliance-cardakaakshat246/ecoscore-browser-extensionanalysis-tools-dev/website-old
Stars161616
LanguageJavaScriptJavaScriptJavaScript
Last pushed2023-04-06
MaintenanceDormant
Setup difficultyeasyhardeasy
Complexity2/53/51/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Requires an existing Home Assistant setup with the appliance already exposed as entities.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

HA Appliance Card is a custom dashboard widget for Home Assistant, a popular smart home platform, that shows the status of a washer, dryer, or dishwasher on one card. It displays whether the appliance is running, what program it is on, how much time is left, whether the door is open, any alerts, and buttons to start, pause, resume, or stop it, depending on what the appliance's smart plug or manufacturer integration exposes. The card does not assume any particular brand. Instead of building in support for specific manufacturers like Samsung or LG, it lets you map each piece of information, such as the state sensor or the door sensor, to whatever entity your setup already has, so it works with Electrolux, Samsung, LG, Home Connect, Miele, or even a basic smart plug paired with your own custom sensors. It also automatically recognizes many different raw state values, like Idle, RUNNING, or the French En marche, across twelve languages, and maps them into a consistent idle, running, paused, done, delayed, or error status, with the option to define your own mapping for anything it does not already recognize. Visually, the card shows a simple animated illustration, water for a washer, tumbling clothes for a dryer, or a spray arm for a dishwasher, which is static when the appliance is idle, and there is a compact mode that hides the illustration and shows only text. A progress bar can either read directly from a percentage sensor if the device provides one, or be estimated on the fly from the time remaining. Only one setting is required to get started, the entity that reports the appliance's overall state, and everything else is optional. The card includes a visual editor that tries to auto-fill the other fields by looking for matching entities on the same device once you pick the main state entity. It is installed through HACS, the Home Assistant Community Store, as a custom repository since it is not yet in the default store. The project is released under the MIT license, a permissive license that allows free use including commercially.

Copy-paste prompts

Prompt 1
Help me install ha-appliance-card through HACS as a custom repository in my Home Assistant setup.
Prompt 2
Show me a YAML configuration for this card that maps my washer's state, door, and remaining time entities.
Prompt 3
Explain how the state_map option works so I can normalize my dryer's raw status values.
Prompt 4
Help me set up start and stop button entities for my dishwasher using this card's controls.

Frequently asked questions

What is ha-appliance-card?

A Home Assistant dashboard card showing washer, dryer, or dishwasher status and controls, that works with any brand through configurable entity mapping.

What language is ha-appliance-card written in?

Mainly JavaScript. The stack also includes JavaScript, Home Assistant, HACS.

What license does ha-appliance-card use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is ha-appliance-card to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is ha-appliance-card for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.