Energy Flow Card Plus

The card supports two different mathematical models for calculating the visual velocity (flow rate) of the dots on the lines.

1. Standard Flow Formula (Relative)

This is the default formula. It calculates flow rate relative to the total power in the system. As the total power changes, the velocity of individual lines changes to maintain a consistent visual density.

Formula: max - (value / totalLines) * (max - min)

• max: max_flow_rate configuration.
• min: min_flow_rate configuration.
• value: The power of the current line.
• totalLines: The sum of all consumption and production lines.

2. New Flow Formula (Absolute)

This model calculates flow rate independently for each line. A specific wattage (e.g., 10W) will always result in the same dot velocity, regardless of what other devices are doing. This is often more intuitive for interpreting perceived power.

To enable this, set use_new_flow_rate_model: true in your main configuration.

Formula: if (value > maxIn) return maxOut; else return ((value - minIn) * (maxOut - minOut)) / (maxIn - minIn) + minOut;

Configuration parameters for the New Model:

• min_expected_power (minIn): The wattage at which the lowest speed is selected.
• max_expected_power (maxIn): The wattage at which the highest speed is selected.
• max_flow_rate (maxOut): The fastest speed (e.g., 1 dot per second).
• min_flow_rate (minOut): The slowest speed (e.g., 1 dot every 5 seconds).

When defining devices (like grid, solar, battery, etc.) within the energy-flow-card-plus, you can use the following options to control how their state and metadata are displayed:

• entity (required): The Home Assistant Entity ID providing the state value.
• unit_of_measurement: A string for the unit (e.g., 'W', 'kW'). Note: Must be wrapped in quotes.
• icon: An optional icon path to display next to the state.
• unit_white_space (boolean): Defaults to true. Set to false to remove whitespace between the state and the unit.
• display_zero (boolean): Defaults to false. Set to true to show info even if the state is 0 or unavailable.
• display_zero_tolerance (number): If set, the device is displayed only if the state is greater than this value. This overrides the need for display_zero.
• decimals (number): Number of decimal places to round the value to.
• template (string): A HA Template to display. Note: This can only be used if entity is NOT set.
• accept_negative (boolean): Defaults to false. If true, negative values are displayed as negative; otherwise, they are converted to positive.
• sum_total (boolean): If true, the secondary info field on the solar bubble is summed with the main entity to create a total consumption value.
• tap_action, hold_action, double_tap_action: Objects defining the Home Assistant actions triggered on the secondary info text.

The energy-flow-card-plus card provides extensive configuration options for appearance and behavior. To achieve a look similar to the official Energy Flow Card, you only need to configure the entities object. Most other options are for advanced customization.

Core Card Options

The Power Outage feature allows the card to react when the grid connection is lost. You can configure how the card detects the outage and how it represents the state (e.g., showing a generator).

• entity (required): The Entity ID that changes state during an outage (e.g., binary_sensor.grid_connection_status).
• entity_generator: The Entity ID providing the generator's power (e.g., sensor.generator_power). If omitted, the card assumes the grid is the only source.
• state_alert: The state of the outage entity that triggers the alert. Defaults to 'on'.
• icon_alert: The icon to show instead of the grid icon during an outage. Defaults to mdi:transmission-tower-off.
• label_alert: Text displayed below the icon during an outage.
• calculate_flow_rate:
  • false (default): No special calculation.
  • true: Calculates flow rate using a formula.
  • number: Sets a fixed interval for dots (e.g., 10 means one dot flows every 10 seconds).

This example demonstrates the full capability of the card, including custom icons, names, individual device tracking, and decimal formatting.

type: custom:energy-flow-card-plus
entities:
  home:
    entity: sensor.home_consumption
    color_icon: solar
  fossil_fuel_percentage:
    entity: sensor.fossil_fuel_percentage
    icon: mdi:pine-tree
    color_icon: true
    display_zero: true
    name: Non Fossil
    state_type: power
  grid:
    icon: mdi:ab-testing
    name: Provider
    entity:
      production: sensor.grid_production
      consumption: sensor.grid_consumption
  solar:
    icon: mdi:solar-panel-large
    entity: sensor.solar_production
  battery:
    name: Bateria
    icon: mdi:bat
    entity:
      consumption: sensor.battery_consumption
      production: sensor.battery_production
  individual:
    - entity: sensor.car_power
      icon: mdi:car-electric
      color: "#80b8ff"
      name: Denim Flash
      color_icon: false
    - entity: sensor.motorbike_power
      name: Qivi
      color_icon: true
      display_zero: true
      color: "#ff8080"
      icon: mdi:motorbike-electric
base_decimals: 0
kilo_decimals: 2
min_flow_rate: 0.9
max_flow_rate: 6
kilo_threshold: 10000
clickable_entities: true
title: Energy Flow Card Plus