Skip to content

Repository files navigation

House Power Flow Card

A visual Home Assistant dashboard card for live solar, grid, home and optional battery power flows. It can switch scenes for weather and configurable holidays while keeping the flow lines aligned.

Home Assistant HACS Custom License: MIT Support on Ko-fi

Real House Powerflow Card

House Power Flow Card preview

What you can configure

  • Solar and grid sensors; battery, gas and low-carbon data are optional.
  • Dutch or English automatically from Home Assistant, with starter translations for German, French and Spanish.
  • Holiday scenes on/off, per holiday on/off and editable start/end dates.
  • Standard image alignment or your own flow paths/coordinates for a different house image.
  • A support button and popup that can be disabled or pointed at another donation page.
  • Existing custom:energy-house-aligned-v47-card dashboards remain compatible.

Install with HACS (easiest)

  1. Open HACS → Frontend.
  2. Open the three-dot menu and choose Custom repositories.
  3. Add https://github.com/tverweij92/House-Powerflow-Card and choose Dashboard.
  4. Search for House Power Flow Card, install it and restart/refresh Home Assistant.
  5. Add a Manual card to your dashboard and paste the minimal example below. HACS installs the supplied scenes with the card.

After adding the card, Home Assistant also shows a simple visual editor for the main sensors, language, battery, holidays and support button. Advanced scene dates and flow coordinates remain in YAML so they stay transparent and portable.

type: custom:house-power-flow-card
title: Energy overview
solar_power: sensor.your_solar_power
grid_power: sensor.your_grid_power
weather: weather.home

Replace the example entity IDs with your own entities. Battery, gas and holiday scenes stay out of the way until you configure them.

Add a battery

modules:
  battery: true
battery_charge_power: sensor.battery_charge_power
battery_discharge_power: sensor.battery_discharge_power
battery_soc: sensor.battery_state_of_charge
battery_capacity_kwh: 7

Set modules.battery: false to hide it even when battery sensors are present. With auto (the default), it appears only when at least one battery sensor is configured.

Holiday scenes and custom date ranges

Holiday scenes are off by default. This example enables Dutch defaults, keeps Christmas visible for two weeks and disables Sinterklaas:

holidays:
  enabled: true
  country: NL
  date_format: european
  items:
    kerst:
      enabled: true
      start: "18-12"
      end: "31-12"
    sinterklaas:
      enabled: false

You can add your own fixed range. image_name must match the beginning of the supplied day/evening filenames:

holidays:
  enabled: true
  date_format: european
  ranges:
    - name: birthday
      image_name: feest
      start: "10-08"
      end: "14-08"
      enabled: true

The card then looks for feest overdag.png and feest avond.png in image_directory.

Use another house image

Set automatic_images: false and provide a background. For exact alignment, use SVG path strings or simple point coordinates in the image's 1536 × 1024 coordinate system:

automatic_images: false
background_image: /local/my-house.png
layout:
  preset: custom
  coordinates:
    solar:
      - [100, 200]
      - [650, 200]
      - [850, 520]
    gridImport:
      - [100, 650]
      - [850, 650]
    gridExport:
      - [850, 690]
      - [100, 690]
    battery:
      - [950, 900]
      - [950, 690]

See the complete configuration guide and the ready-to-copy files in examples.

Support popup

The heart button opens a small popup. Configure or hide it like this:

support:
  enabled: true
  url: https://ko-fi.com/timverweij92
  title: Support House Power Flow Card
  message: Like the card? Help fund future improvements.

No link opens automatically; the visitor must click the button in the popup.

Upgrading from the old card

The old JavaScript file and card type still work for now. For new dashboards use:

type: custom:house-power-flow-card

After installing version 5 through HACS, change only the type line. Your existing sensor settings continue to work. Do not delete the old resource until the new card works on your dashboard.

Development and contributions

The project intentionally uses one dependency-free JavaScript file so beginners can inspect it. Pull requests run a syntax check, verify HACS metadata and check the image set. Translation contributions are welcome; see CONTRIBUTING.md.

License

Copyright © 2026 tverweij92.

About

A configurable HACS-compatible Home Assistant card for animated solar, grid, battery and home power flows.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages