Room Cards

Features

Overview#

custom:room-overview-card — Every room at a glance: one tile per room, tap a room to unfold its sensors, lights and plugs.

• One compact tile per room, coloured by what matters most: Water leak (red, blinking), 1 open (orange), Presence (blue), otherwise All closed / All quiet
• Small chips on each tile for the lights that are on, the plugs that are on with their power draw, and presence when an alert is already shown
• Header with the home status and totals: occupied rooms, lights on, power drawn by the plugs; on a narrow card (6 columns of a Sections view) the totals move to a line of their own under the title
• Tap the lights chip of the header to turn every light the card counts off (all_off_button), and the plugs chip to turn every plug off once confirmed in a popup listing them (plugs_off_button, off by default: a plug may feed a camera or a network switch)
• Tap a room to unfold its details at the top of the card: the Sensors, Lights and Plugs cards of that room; tap it again or anywhere else to fold it back
• Automatic discovery: every area with door, window, leak or presence sensors, lights or plugs becomes a room, with an icon picked from its name
• Same rules as the room cards: hidden entities are skipped, and so are light groups and the configuration and diagnostic entities of lights and plugs (door, window, leak and presence sensors count whatever their category); light switches count as lights
• Only the rooms with something open, on, detected or unavailable show; the detail button (top right) shows every room, and back, as does a click anywhere else (zoom: false: every room, always, no button); sort: state lists the rooms needing attention first

Sensors#

custom:room-sensors-card — Leak, door, window, opening and presence sensors of a room: what is open comes first, with how long it has been open.

• Header with an icon and a status pill coloured by the room state: All closed (green), 1 open (orange), Water leak (red, pulsing); a leak or opening sensor that is unavailable is no all-clear: 1 unavailable (orange)
• Open sensors listed first, leaks before doors and windows, with a blinking icon and how long they have been open
• Presence and motion sensors in blue (Detected / Clear), with a person icon next to the pill while someone is in the room; they are not alerts and never blink
• Icon picked from the sensor: sliding door, window, door, garage door, water drop, person, motion sensor
• Clean names: the Sensor / Capteur prefix, the area name and the trailing device-class word are removed (Capteur Porte Fenêtre Cuisine Porte → Porte Fenêtre Cuisine)
• Show only the open or active sensors (only_alerts), or hide the whole card when everything is closed, dry, reporting and nobody is there (hide_when_clear)
• Tap a sensor to open its details
• Automatic discovery from the area, or an explicit list with name and icon overrides

Sensors mini#

custom:room-sensors-mini-card — Only what is open or detected, for a compact dashboard; zoom in for every sensor.

• Room badge coloured like the Sensors card, the title and the status (1 open, Water leak) on the first line
• On the second line, a tinted pill with its name for each open, leaking or detecting sensor (blinking unless blink: false); quiet sensors are hidden, so a quiet room is a single line
• Zoom button (top right) switches the card to the full Sensors card — every sensor, with how long it has been open — and back, as does a click anywhere else (zoom: false removes it)
• Same discovery and options as the Sensors card: hide_when_clear (compact view only), presence, blink, include / exclude
• Tap a sensor to open its details

Lights#

custom:room-lights-card — Lights of a room: tap to toggle, drag to dim, turn everything off from the header.

• Header with an icon and a status pill: All off, or 2 on with a power button that turns every light of the room off
• Lights that are on listed first, tinted with their actual colour, brightness shown as a bar behind the tile
• Tap a light to toggle it, drag it sideways to set its brightness, hold it to open its details; from the keyboard: Enter or Space toggles, Shift+Enter or the context-menu key opens the details, ← / → dim by 10 % (the light is set once, when the key is released or after a short pause)
• Lights and light switches: a switch whose name says it drives a light (Lumière Canapé, Desk Lamp) is picked up too
• Clean names: the Lumière / Light prefix and the area name are removed (Lumière Canapé → Canapé)
• Show only the lights that are on (only_on), or hide the whole card when everything is off (hide_when_off)
• Tap the title to open a dashboard (navigation_path)
• Automatic discovery from the area, or an explicit list with name and icon overrides (custom icon sets supported)

Lights mini#

custom:room-lights-mini-card — The lights of a room on two lines, for a compact dashboard; zoom in to toggle and dim them.

• Room badge coloured like the Lights card, the title and the status on the first line: All off, or how many lights are on out of the total (2/4 on)
• The status doubles as a power button turning every light of the room off (all_off_button, on by default)
• On the second line, a pill tinted with its colour and showing its name for each light that is on, the icon alone for the others (only_on hides them)
• Zoom button (top right) switches the card to the full Lights card — tap to toggle, drag to dim — and back, as does a click anywhere else (zoom: false removes it)
• Same discovery and options as the Lights card: only_on, hide_when_off, include / exclude, navigation_path
• Tap a light to open its details

Plugs#

custom:room-switch-card — Smart plugs of a room with their power draw: what is on comes first, the most power-hungry first.

• Header with an icon and a status pill: All off, or 3 on · 1.2 kW
• Power draw of each plug, read from the power sensor of the same device, and the total in the header
• Plugs that are on listed first, the most power-hungry first
• Tap a plug to toggle it, hold it to open its details (keyboard: Enter or Space, Shift+Enter or the context-menu key)
• Optional power button on the status pill to turn every plug of the room off (all_off_button, off by default: a plug may feed a camera or a network switch)
• Plugs found by device class outlet, or by a name that says so (Prise Terrasse, Desk Plug); switches driving a light are left to room-lights-card
• Clean names: the Prise / Plug prefix or suffix and the area name are removed (Prise Machine à café → Machine à café)
• Show only the plugs that are on (only_on), or hide the whole card when everything is off (hide_when_off)
• Tap the title to open a dashboard (navigation_path)
• Automatic discovery from the area, or an explicit list with name, icon and power sensor overrides

Plugs mini#

custom:room-switch-mini-card — The plugs of a room on two lines, for a compact dashboard; zoom in to toggle them.

• Room badge coloured like the Plugs card, the title and the status on the first line: All off, or how many plugs are on out of the total and their power draw (2/4 on · 1.2 kW)
• With all_off_button: true, the status doubles as a power button turning every plug of the room off (off by default, like the Plugs card)
• On the second line, a pill with its name and power draw for each plug that is on (Coffee Machine 1.2 kW), the icon alone for the others (only_on hides them)
• Zoom button (top right) switches the card to the full Plugs card and back, as does a click anywhere else (zoom: false removes it)
• Same discovery and options as the Plugs card: only_on, hide_when_off, show_power, include / exclude, navigation_path
• Tap a plug to open its details

Environment#

custom:room-environment-card — Temperature, humidity, air quality, noise and light level of a room, coloured by comfort.

• Header with an icon and a status pill coloured by the reading that needs a look first: Comfortable (green), Cool (blue), Ventilate, Too humid, Noisy (orange), up to red past the alert thresholds, with +N when several readings are off
• One tile per reading, in a fixed order: temperature, humidity, CO₂, PM2.5, PM10, VOC, air quality index, noise, light level
• Each tile shows the value as Home Assistant formats it, with a thin gauge underneath; a comfort word (Dry, Moderate, Noisy…) is added when the reading is off, and to the light level (Dark, Dim, Bright)
• Only what is outside the comfort range is tinted; cold readings are blue, the light level is information only and never alerts
• Built-in comfort thresholds (WHO and common indoor guidelines), adjustable per kind with thresholds; °F and ppb sensors are handled
• Several sensors of the same kind in a room make one reading: their mean (three thermometers, one Temperature tile); unavailable and unknown sensors are left out of it and gathered in one muted 2 unavailable tile (a chip on the mini card) listing them
• Show only the readings outside the comfort range (only_alerts)
• Tap a reading to open its details and history; tap the title to open a dashboard (navigation_path)
• Automatic discovery from the area, or an explicit list with name and icon overrides

Environment mini#

custom:room-environment-mini-card — The same readings on a single line, for a compact dashboard.

• Room badge coloured by the reading that needs a look first, the title and the status on the first line
• One chip per reading on the second line: icon and value, the unit kept small (21,4°, 640 ppm); comfortable readings are plain, the others get a tinted pill
• Same discovery, thresholds, only_alerts, include / exclude and navigation_path as the Environment card; the chips wrap onto another line when the card is narrow or the room has many sensors
• Tap a reading to open its details and history
• Zoom button (top right) switches the card to the full Environment card — tiles, comfort words, gauges — and back, as does a click anywhere else (zoom: false removes it); zoomed in, every reading is shown, only_alerts only filtering the compact view

Environment overview#

custom:room-environment-overview-card — The indoor climate of every room at a glance; tap a room to unfold its readings.

• One tile per room with environment sensors, coloured by the reading that needs a look first: Ventilate, Too humid, Poor air (orange to red), Cool (blue), otherwise Comfortable
• On each tile: temperature, humidity and CO₂, plus any other reading outside the comfort range (PM2.5, noise…); same means and thresholds as the Environment card
• Header with the number of rooms to check and the home's average temperature and humidity
• Tap a room to unfold its Environment card at the top of the card; tap it again or anywhere else to fold it back
• Only the rooms needing a look show; the detail button (top right) shows every room, and back, as does a click anywhere else (zoom: false: every room, always, no button); sort: state lists them first; room order, names and icons with rooms, like the Overview

Prerequisites

• Home Assistant 2024.8 or later
• Areas set on the sensors, lights and plugs or on their devices, for the automatic discovery; otherwise list the entities by hand

Configuration

Common options#

The Sensors, Lights, Plugs and Environment cards share these options; each card below lists its own.

* area, include or entities is required.

Overview#

Minimal:

type: custom:room-overview-card

Full options:

type: custom:room-overview-card
title: Home
columns: 3
sort: name
presence: true
zoom: true
all_off_button: true
plugs_off_button: false
exclude_areas:
  - garage
exclude:
  - light.living_room_camera_floodlight
rooms:
  - area: living_room
  - area: kitchen
  - area: bedroom_1
    name: Bedroom
    icon: mdi:bed-king-outline
  - area: office
    navigation_path: /dashboard-home/office

Options reference#

Room options

Sensors#

Minimal:

type: custom:room-sensors-card
area: living_room

Full options:

type: custom:room-sensors-card
area: living_room
title: Living room
columns: 2
only_alerts: false
hide_when_clear: false
presence: true
blink: true
exclude:
  - binary_sensor.living_room_tv_cabinet

Alerts only#

Shows only what is open, leaking or detecting someone, and hides the card when the room is idle:

type: custom:room-sensors-card
area: living_room
only_alerts: true
hide_when_clear: true

Options reference#

In addition to the common options:

Sensors mini#

Same options as the Sensors card except only_alerts (the compact view always hides quiet sensors), plus zoom; columns only shapes the zoomed-in view:

type: custom:room-sensors-mini-card
area: living_room
hide_when_clear: true
zoom: true

Lights#

Minimal:

type: custom:room-lights-card
area: living_room

Full options:

type: custom:room-lights-card
area: living_room
title: Living room
navigation_path: /light
columns: 2
only_on: false
hide_when_off: false
show_brightness: true
all_off_button: true
exclude:
  - light.living_room_camera_floodlight

Explicit lights#

type: custom:room-lights-card
title: Living room
entities:
  - entity: light.kitchen
    icon: phu:ikea-jakobsbyn
  - entity: light.living_room
    icon: phu:ikea-jakobsbyn
  - entity: switch.sofa_lamp
    name: Sofa
  - entity: light.night_light
    name: Night light
    icon: mdi:lightbulb-night

Options reference#

In addition to the common options:

Lights mini#

Same options as the Lights card, all_off_button included (the power button on the status), plus:

For example, a living room showing only the lights that are on, the title opening the lights dashboard:

type: custom:room-lights-mini-card
area: living_room
navigation_path: /light
only_on: true

Plugs#

Minimal:

type: custom:room-switch-card
area: living_room

Full options:

type: custom:room-switch-card
area: living_room
title: Living room
navigation_path: /energy
columns: 2
only_on: false
hide_when_off: false
show_power: true
all_off_button: false
exclude:
  - switch.living_room_router

Explicit plugs#

type: custom:room-switch-card
title: Living room
entities:
  - entity: switch.microwave
    icon: mdi:microwave
  - entity: switch.tv
    name: TV
    power: sensor.tv_power
  - switch.coffee_machine_plug

Options reference#

In addition to the common options:

Plugs mini#

Same options as the Plugs card, show_power included (the total in the status, each plug's draw on its chip), plus:

For example, with the power button on the status, leaving out the router plug:

type: custom:room-switch-mini-card
area: living_room
all_off_button: true
exclude:
  - switch.living_room_router

Environment#

Minimal:

type: custom:room-environment-card
area: living_room

Full options:

type: custom:room-environment-card
area: living_room
title: Living room
navigation_path: /dashboard-home/living-room
columns: 2
only_alerts: false
show_gauge: true
show_history: true
thresholds:
  temperature: [17, 19, 24, 27]
  co2: [800, 1200]
exclude:
  - sensor.living_room_tv_temperature

Thresholds#

Each kind has four limits — alert low, warning low, warning high, alert high — or two (warning, alert) for the kinds that only go wrong upwards. Set your own under thresholds, in the unit of the sensor; null leaves a side out.

A temperature sensor in °F gets the default limits converted; a cool room (warning low band) is information, not a warning.

Outdoor areas. In an area whose name says it is outside (Terrasse, Jardin, Balcon, Patio, Extérieur, Terrace, Garden, Balcony, Outdoor…), temperature, humidity and noise are information only — the weather and the street, not a comfort issue: they never tint the card nor make the room one to check. Set thresholds for them (on the card, or per room on the overview) to bring the levels back.

Wet rooms. In a room whose name says it is a bathroom, a shower room or a laundry (Salle de bain, Salle d'eau, Douche, Buanderie, Bathroom, Shower, Laundry), humidity defaults to [25, 35, 70, 80]: 61 % after a shower is fine there. Your own humidity thresholds always win.

Options reference#

The Environment card takes these options on top of the common options:

Environment mini#

Same options as the Environment card, plus zoom; columns, show_gauge and show_history only shape the zoomed-in view:

type: custom:room-environment-mini-card
area: living_room
navigation_path: /dashboard-home/living-room
zoom: true
exclude:
  - sensor.living_room_pm25

Environment overview#

Minimal:

type: custom:room-environment-overview-card

Full options:

type: custom:room-environment-overview-card
title: Indoor climate
columns: 3
sort: state
zoom: true
thresholds:
  co2: [800, 1200]
exclude_areas:
  - garage
exclude:
  - sensor.living_room_tv_temperature
rooms:
  - area: living_room
  - area: bedroom_1
    name: Bedroom
  - area: office
    navigation_path: /dashboard-home/office
  - area: cellar
    thresholds:
      humidity: [30, 40, 75, 85]

Options reference#

How it works

Overview#

The card goes through every entity with an area (set on the entity or on its device), with the same rules as the room cards:

• Sensors: binary_sensor with device class moisture, door, window, opening or garage_door
• Presence: binary_sensor with device class occupancy, presence or motion, camera detections included except pets, and vehicles outside the outdoor rooms
• Lights: every light except light groups, and every switch whose name contains lumière, lampe, lamp, light, veilleuse or guirlande
• Plugs: every other switch with device class outlet, or whose name contains prise, multiprise, plug, outlet or socket, with the power sensor of the same device

Hidden entities are skipped, and so are the configuration and diagnostic entities of lights and plugs (an indicator LED, say); door, window, leak and presence sensors count whatever their entity category, like on the Sensors card. A room is shown when it has at least one of them.

A tile shows the most important state of the room: a wet leak sensor, then open doors and windows, then presence, otherwise All closed (or All quiet for a room without door or window sensors). The details of a room are the Sensors, Lights and Plugs cards of that area, for the kinds of entities the room has.

Sensors#

The card keeps every binary_sensor of the area whose device class is moisture, door, window, opening or garage_door, and with presence (the default) occupancy, presence or motion (the area set on the entity, or on its device). Hidden entities are skipped. Camera detections count too (motion, person, line crossing), except the pet detections, and the vehicle detections outside an outdoor room: a sensor whose entity ID or name says pet, animal, dog, cat (chien, chat), or vehicle, véhicule, car (voiture). A room is outdoor when its name says jardin, terrasse, balcon, patio, extérieur, cour, allée, porche, portail, parking, garden, terrace, balcony, outdoor, outside, yard, driveway, porch or gate; outdoor: true / false overrides it. Leave out any other sensor with exclude.

The room is in alert when a sensor is open (orange) and critical when a leak sensor is wet (red). Presence and motion are information, not alerts: shown in blue, they never change the header colour. Wet leak sensors come first, then open doors and windows, then detected presence, then the others by name. The icon follows the sensor: a sensor whose entity ID contains porte_fenetre, baie, sliding or patio gets a sliding door, whatever its device class (garage doors, leak, presence and motion sensors excepted), a window sensor (or a door sensor with fenetre / window in its ID) gets a window.

Lights#

The card keeps every light of the area (the area set on the entity, or on its device), plus every switch of the area whose name contains lumière, lampe, lamp, light, veilleuse or guirlande as a word. Hidden entities, configuration and diagnostic entities (such as indicator LEDs) and light groups are skipped.

Lights that are on come first, then by name. A tap calls homeassistant.toggle; dragging a dimmable light sideways shows the brightness under the finger and calls light.turn_on with brightness_pct on release; a hold opens the more-info dialog. The pill calls homeassistant.turn_off on the lights of the card that are on.

Plugs#

The card keeps every switch of the area (the area set on the entity, or on its device) whose device class is outlet, or whose name contains prise, multiprise, plug, outlet or socket as a word. Hidden entities and configuration or diagnostic entities are skipped, and so are switches whose name says they drive a light (lumière, lampe, lamp, light, veilleuse, guirlande): those belong to room-lights-card.

The power draw comes from the first sensor of the same device with the power device class (W or kW), or from the power sensor set on the entity. Plugs that are on come first, the most power-hungry first, then by name. A tap calls homeassistant.toggle, a hold opens the more-info dialog, and the pill calls homeassistant.turn_off on the plugs of the card that are on when all_off_button is set.

Environment#

The card keeps every sensor of the area (the area set on the entity, or on its device) whose device class is temperature, humidity, carbon_dioxide, pm25, pm10, volatile_organic_compounds, volatile_organic_compounds_parts, aqi, sound_pressure or illuminance. Hidden entities and configuration or diagnostic entities (a battery or CPU temperature, say) are skipped: list another one in exclude if a device reports a reading that does not describe the room.

The sensors of a same kind make one reading: the mean of the ones reporting a number (unavailable and unknown sensors are left out, and a kind with none left is not shown; they are counted in a muted N unavailable tile, kept with only_alerts, whose tap opens the first of them); a single sensor keeps Home Assistant's formatting, a mean is shown with one decimal for temperature and none for the others. A tap opens the details of the first sensor of the reading.

Each reading falls in one of five bands of its thresholds. The header takes the reading with the highest severity (alert, then warning, then information), the kind order breaking ties. Values are formatted by Home Assistant (number format and display precision of the entity); a tap opens the more-info dialog with its history.

Environment overview#

The card finds the rooms the way the Environment card does, area by area, and shows each with the same readings and levels. A room needs a look when one of its readings is in a warning or alert band; the header counts those rooms, and its averages count each room once (its mean temperature and humidity).

Support

If you find this project useful, you can support its development:

Features

• show_title option (also in the visual editor) hides the header's title on every room card, the status pill and buttons keeping their place, for a card placed under a section heading of its own (asked in juju35/ha-vehicle-card#72).

Fixes

• Sensors and Overview cards: the motion and presence detections of cameras are no longer left out — a room whose only presence sensor is a camera now shows its motion, person and line crossing detections. Pet detections never count; vehicle detections count only in outdoor rooms (Terrasse, Jardin, Garden…, guessed from the area name), and outdoor: true / false sets it on the Sensors card and in the Overview's rooms entries.

Improvements

• Environment card: a tile's tooltip gives the lowest and highest values of its 24 h curve (Temperature — 21.4 °C · 24 h 19.8 °C – 22.6 °C): the curve shows the trend but has no scale. A tap still opens the reading's history.

Fixes

• Environment card: the 24 h curve takes the lower half of its tile, under the value and gauge, instead of the whole tile where it crossed the name and the icon.

Documentation

• The environment screenshots show the 24 h curves: the screenshot harness can now answer the recorder (ws option), the environment script with a day of 5-minute means.

Maintenance

• No code change: released again to check the installation from the Marketplace.

Features

• Environment card: each tile draws the last 24 hours of its reading as a faint curve behind it (show_history, on by default; also in the zoomed-in mini card). One recorder statistics query (5-minute means) covers every tile and is refreshed at most every 5 minutes; sensors without statistics simply get no curve.