ha-appliance-card - GitLite

KO | EN

gitlite — search

#kubernetes #json #machine-learning #sql #monitoring #dotnet #golang #chatbot #claude #agent

ha-appliance-card

(★ 17)

Home Assistant Lovelace card for washers/dryers/dishwashers — works across brands via configurable entity mapping

ha-appliance-card 최신버젼 다운로드

ZIP 다운로드

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일 경로 직접 입력

링크

예시

명령어 용어집

이 문서에서 사용된 명령어를 모아봤습니다. 낯선 명령어가 있다면 펼쳐서 확인해보세요.

🔍

`done`

설명 보기 ▼

`for`, `while`, `select`, `until` 루프의 끝을 표시하는 쉘 키워드.

tldr for

`for` 키워드 문서 확인:

tldr while

`while` 키워드 문서 확인:

tldr select

`select` 키워드 문서 확인:

🔍

`compact`

설명 보기 ▼

NTFS 파티션의 파일 및 디렉터리 압축 상태를 확인하거나 변경.
더 많은 정보: <https://learn.microsoft.com/windows-server/administration/windows-commands/compact>.

compact

현재 디렉터리의 파일 압축 상태 표시:

compact /c {{path\to\file}}

지정한 파일 압축:

compact /u {{path\to\file}}

지정한 파일 압축 해제:

# 프로젝트 배지

hacs_badge 바로가기
GitHub Release 바로가기
HACS Action 바로가기
HA Version 바로가기
License: MIT 바로가기
Buy Me A Coffee 바로가기

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<a href="https://buymeacoffee.com/adnpolymerase" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-orange.png" alt="Buy Me A Coffee" height="60"></a>
<a href="https://adnpolymerase.github.io/HA/" target="_blank"><img src="https://raw.githubusercontent.com/ADNPolymerase/HA/main/assets/site-button.svg" alt="Link to my github.io for my other projects" height="60"></a>

A Lovelace card for washers, dryers and dishwashers — cycle in progress, program, remaining time, door status, alerts and controls.

No brand assumed: every field is a configurable entity mapping, so it works with **any** integration (Electrolux, Samsung, LG, Home Connect, Miele, a smart plug + template sensors…).

> Status: early preview. Feedback and issues welcome.
> 🇫🇷 [Lire en français](README.fr.md)

![HA Appliance Card screenshot](https://raw.githubusercontent.com/ADNPolymerase/ha-appliance-card/main/docs/screenshot.png)

## Features

- **State normalization**: `Idle`, `RUNNING`, `wash`, `En marche`… are auto-detected (accent-insensitive, 12 languages) and mapped to idle / running / paused / done / delayed / error. `state_map` covers anything else; unmatched states are shown as-is.
- **Animated illustration** (washer water, dryer tumbling, dishwasher spray arm) — static when idle, auto-detected or set via `appliance_type`. The door is shown ajar on the illustration while open. `compact: true` keeps only the text.
- **Progress bar** from a direct percentage sensor, or estimated client-side from the remaining time.
- **Program, info lines** (temperature, spin speed…), **door, alerts, connectivity** (top-right wifi icon) — each optional and independent.
- **Start / pause / resume / stop** controls, only shown for the entities you configure.
- **Visual editor**: pick the state entity and the other fields are auto-suggested from sibling entities on the same device.

## Installation (HACS)

Not yet in the default HACS store — add it as a custom repository:

1. HACS → "⋮" menu → **Custom repositories**.
2. Repository: `https://github.com/ADNPolymerase/ha-appliance-card`, category: **Dashboard**.
3. Install **HA Appliance Card**, then add a `custom:ha-appliance-card` card (YAML or visual editor).

## Configuration

Only `state_entity` is required — everything else is optional. In the visual editor, setting the state entity auto-fills the other fields when a matching sibling entity is found on the same device; each field can still be changed or cleared.

| Option | Description |
|---|---|
| `state_entity` | **Required.** Entity reporting the appliance's overall state (any domain). |
| `state_map` | Optional map: raw state → `idle`\|`running`\|`paused`\|`done`\|`delayed`\|`error`. |
| `state_show_raw` | `true` to display the raw state text instead of the translated label (color/animation still follow the detected category). |
| `name` | Card title. Defaults to the state entity's friendly name. |
| `compact` | `true` to hide the illustration and show only text. |
| `appliance_type` | `auto` (default) \| `washer` \| `dryer` \| `dishwasher`. |
| `program_entity` / `program_format` | Program/cycle entity. `clean` (default) trims common `"<category> Pr <name>"` patterns; `raw` shows the state as-is. |
| `remaining_time_entity` / `remaining_time_unit` | Remaining duration. Unit `auto` (default), `seconds`, or `minutes`. |
| `remaining_time_hide_when_idle` | `true` to only show remaining time while the appliance is running. Prevents stale completion timestamps (e.g. Samsung SmartThings keeping a past finish time after the cycle ends) from displaying. |
| `progress_entity` | Optional 0–100 sensor; overrides the client-side estimate. |
| `door_entity` / `door_open_state` / `door_invert` | Door sensor, the state meaning "open" (default `on`), and an invert toggle. |
| `alerts_entity` | Entity whose *attributes* are on/off flags; any "on/true/active" attribute is shown as an active alert. |
| `connectivity_entity` / `connectivity_connected_state` | Connectivity sensor and the state meaning "connected" (default `on`). |
| `info_entities` | Up to 5 `{ entity, icon?, label?, value_map? }` extra info lines (temperature, spin speed…). Entities with a `timestamp`/`date` device class are formatted in the local timezone using the Home Assistant language, like HA itself shows them. `value_map` relabels raw values, for integrations reporting a phase as a bare code or an untranslated token (see below). |
| `start_entity` / `pause_entity` / `resume_entity` / `stop_entity` | Button/switch/script entities wired to the corresponding control. Only configured ones are shown. |

### Example

```yaml
type: custom:ha-appliance-card
state_entity: sensor.lave_linge_appliance_state
program_entity: select.lave_linge_program_uid
remaining_time_entity: sensor.lave_linge_time_to_end
door_entity: binary_sensor.lave_linge_door_state
alerts_entity: sensor.lave_linge_alerts
info_entities:
  - entity: select.lave_linge_temperature
    icon: mdi:thermometer
  - entity: select.lave_linge_spin_speed
    icon: mdi:rotate-3d-variant
pause_entity: button.lave_linge_execute_command_pause
stop_entity: button.lave_linge_execute_command_stopreset
```

### Relabeling raw values (`value_map`)

Some integrations report the cycle phase as a bare number or an untranslated
token. `value_map` turns those into readable text, per info entity:

```yaml
info_entities:
  - entity: sensor.washing_machine_program_phase
    icon: mdi:washing-machine
    label: Phase
    value_map:
      0: Ready
      1: Washing
      2: Rinsing
      3: Spinning
      18: Finished
```

Keys are matched against the raw state exactly first, then case-insensitively
(so `washing` also matches a state of `Washing`). Unmapped values are shown
as-is, and a mapped label replaces the value entirely (no unit is appended).

In the visual editor the same thing is edited as one `code: label` per line,
under each info entity. `=` also works as the separator, blank lines and lines
starting with `#` are ignored, and only the first `:` or `=` splits the line so
a label may itself contain one.

## License

MIT — see [LICENSE](LICENSE).