what it does
A customisable button card for Home Assistant focused on entity status. State-based icons, colors, labels, and animations give you at-a-glance visibility of your devices.
- state-based icon, color, label per entity
- built-in defaults for
lock,light,switch,cover,climate,media_player,alarm, and more - transitional state animations (e.g. locking blink)
- secondary entity support (e.g. door sensor paired with a lock)
- configurable tap, double-tap, and hold actions
- camera reveal — slide cameras down from the button when a configured state is active
- visual editor with native HTML controls that integrate cleanly with HA theming
install via HACS [recommended]
- open HACS in your Home Assistant instance
- Frontend → + Explore & Download Repositories
- search for Status Button Card by akaDashe
- download, restart Home Assistant
install manually
- download
status-button-card.jsfrom the latest release - copy to
config/www/status-button-card/ - Settings → Dashboards → Resources → add as JavaScript Module (url:
/local/status-button-card/status-button-card.js)
basic config
type: custom:status-button-card
entity: lock.front_doorwith secondary entity + state overrides
type: custom:status-button-card
entity: lock.front_door
secondary_entity: binary_sensor.front_door_contact
name: Front Door
icon: mdi:door-closed-lock
show_name: true
show_label: true
state_appearances:
- state: locked
icon: mdi:lock
label: Locked
color: "rgba(46, 175, 80, 0.9)"
- state: unlocked
icon: mdi:lock-open
label: Unlocked
color: "rgba(244, 67, 54, 1)"
- state: locking
icon: mdi:lock-clock
label: Locking...
animate: true