# Detailed Energy Card

> Open source card for Home Assistant: power from PV, battery and grid through the house, floors and rooms down to each consumer. With a visual editor, installable via HACS.

A Lovelace card that shows where your power goes: from PV, battery and grid through the house, floors and rooms down to each consumer.

## Key facts

- Licence: MIT
- Install: HACS
- Home Assistant: 2024.8 or later
- Languages: DE · EN
- Version: 0.8.1
- Source code: https://github.com/stacknoise/detailed-energy-card

## Features

The whole flow at a glance.

### From source to socket

PV, battery and grid flow through the house, floors and rooms down to each consumer. One card instead of ten.

### Floors and rooms from Home Assistant

No free text: floors and areas come straight from your instance, names and icons included.

### Visual editor

Everything can be set up without YAML, in German and English. Sensors that are already assigned are hidden.

### Feed-in, battery, self-sufficiency

Charging and feeding in reverse the arrows, self-sufficiency sits in the top corner once a grid sensor is configured. “Unassigned” shows what is missing.

### Thresholds

Lines and bars change colour with power, with a traffic-light preset. Higher levels are also drawn thicker, so they stay readable without telling colours apart. Idle consumers fade out.

### Many rooms

More than six rooms scroll or wrap into two rows. The selection can be remembered.

## Views

Click a floor, click a room.

- With floors
- Without floors
- All rooms of a floor
- Many rooms in two rows

## Editor

Without a line of YAML.

Pick floors and rooms from the areas of your Home Assistant, and colours from a palette or as a hex value.

- Editor: general and colours
- Editor: sources and structure

## Installation

On your dashboard in five steps.

1. Open HACS, ⋮ → Custom repositories.
2. Enter `https://github.com/stacknoise/detailed-energy-card` with the type Dashboard.
3. Search for Detailed Energy Card and download it.
4. Reload the browser.
5. Add card → Detailed Energy Card, or `type: custom:detailed-energy-card` in YAML.

Example (YAML):

```yaml
type: custom:detailed-energy-card
title: Energiefluss
home:
  total_entity: sensor.hausverbrauch_power
sources:
  - { entity: sensor.pv_leistung, type: solar, name: PV }
  - { entity: sensor.akku_leistung, type: battery, soc_entity: sensor.akku_soc }
  - { entity: sensor.netz_leistung, type: grid }
floors:
  - floor_id: erdgeschoss
    rooms:
      - area_id: kueche
        consumers:
          - entity: sensor.backofen_power
            name: Backofen
```

All options are documented in the README on GitHub.

## Contact

- Developer: Anton Graichen-Hartl, Stacknoise (https://www.stacknoise.com/en/)
- E-Mail: anton.hartl@stacknoise.com
- GitHub: https://github.com/stacknoise
- Web page: https://www.stacknoise.com/en/energy-card/
- Deutsche Version: https://www.stacknoise.com/energy-card.md