energy-line-gauge

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

energy-line-gauge

★ 43 Open GitHub ↗

A customizable line gauge with a legend, optionally showing device power use as a percentage of a main entity.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Energy Line Gauge
[![GitHub package.json version](https://img.shields.io/github/package-json/v/Tomer27cz/energy-line-gauge)](https://github.com/Tomer27cz/energy-line-gauge/blob/master/package.json)
![Maintained](https://img.shields.io/maintenance/yes/2026)
![Validate HACS](https://img.shields.io/github/actions/workflow/status/Tomer27cz/energy-line-gauge/.github/workflows/validate-hacs.yaml?label=Validate%20HACS)
[![GitHub license](https://img.shields.io/github/license/Tomer27cz/energy-line-gauge)](https://img.shields.io/github/license/Tomer27cz/energy-line-gauge/blob/master/LICENSE)
[![hacs_badge](https://img.shields.io/badge/HACS-Default-orange.svg)](https://github.com/custom-components/hacs)
![GitHub Repo stars](https://img.shields.io/github/stars/Tomer27cz/energy-line-gauge?style=flat)
![GitHub issues](https://img.shields.io/github/issues/Tomer27cz/energy-line-gauge?style=flat)
![GitHub Issues or Pull Requests](https://img.shields.io/github/issues-pr/Tomer27cz/energy-line-gauge)
![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/Tomer27cz/energy-line-gauge/total)
![GitHub Downloads (all assets, latest release)](https://img.shields.io/github/downloads/Tomer27cz/energy-line-gauge/latest/total)
![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/Tomer27cz/energy-line-gauge)

<h1 align="center">A line Gauge with a focus on Energy Usage</h1>
<p align="center">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/main.png" alt="Main Image"/>
</p>

The main idea of this card is to show the energy consumption of your devices as a percentage of the **main entity** (your entity for tracking whole **house consumption**).

My electricity meter is a **Sagemcom XT211**, I made a **[custom ESPHome component](https://github.com/Tomer27cz/xt211)** to read data from it (or any other DLMS/COSEM PUSH meter using RS485).

The card is designed to resemble the Home Assistant **Energy panel** style. The **auto color** option will use the colors in the same order as the energy panel.

<div id="table-of-contents">
<h1>Table of Contents</h1>

* [Installation](#installation)
    * [Installation via HACS](#installation-via-hacs)
    * [Manual installation](#manual-installation)
* [Configuration](#configuration)
    * [Visual Editor](#visual-editor)
    * [YAML Only](#yaml-only)
    * [Main Options](#main-options)
    * [Types](#types)
    * [Entities](#entities)
* [Examples](#example)
    * [Icons in the legend](#icon)
    * [Only Line](#legend_hide)
    * [Delta](#delta)
    * [Legend with all entities](#legend_all)
    * [Normal usage](#normal-usage--how-i-use-it-)
    * [Position (Text & Title Placement)](#position)
    * [Legend (Layout & Alignment)](#legend)
    * [Theme (Corner Styles)](#theme)
    * [Style (Text Styling)](#style)
    * [Overflow (Text Overflow Handling)](#overflow)
* [State Content](#state_content)
    * [Untracked State Content](#untracked_state_content)
* [Offset](#offset)
* [Statistics](#statistics)
* [Line Separators](#line_separators)
* [Templating](#templating)
* [Sorting](#sorting)
* [Severity](#severity)
* [Issues](#issues)
* [Contribute](#contribute)

</div>

<div id="installation">
<h1>Installation</h1>

<div id="installation-via-hacs">
<h2> Installation via <a href="https://hacs.xyz/">HACS</a><img src="https://img.shields.io/badge/-Recommended-%2303a9f4" alt=""/></h2>

1. Make sure the [HACS](https://github.com/custom-components/hacs) custom component is installed and working.
2. Search for `energy-line-gauge`
3. Click Download and then select the latest version.
4. Reload home-assistant.
</div>

<div id="manual-installation">
<h2> Manual installation</h2>

1. Download the three files from the [latest release](http://www.github.com/Tomer27cz/energy-line-gauge/releases/latest)
2. Create a `energy-line-gauge` folder inside your `config/www` folder and place the files in there
3. Include the card code in your `ui-lovelace-card.yaml`
  ```yaml
  resources:
    - url: /local/energy-line-gauge/energy-line-gauge.js
      type: module
  ```
Or alternatively set it up via the UI:
`Configuration -> Lovelace Dashboards -> Resources (TAB)`
For more guidance check out the [docs](https://developers.home-assistant.io/docs/frontend/custom-ui/registering-resources/).

</div>
</div>

***

<div id="configuration">
<h1> Configuration</h1>

Version 2.0 added a **Visual Editor** to make the configuration easier.
You can find the Card in your Card Selector or by scrolling down to the bottom of the Card Selector and selecting `Manual Card`.
Then you can paste the following code into the Card Editor:
`type: 'custom:energy-line-gauge'`

## YAML Only

Some features are not yet available in the Visual Editor. For example the ability to set `min` and `max` to be an entity or color `auto`.
```yaml
type: 'custom:energy-line-gauge'
entity: sensor.glow_power_consumption

title: Power Consumption
subtitle: Glow

title_position: top-left
title_text_size: 2
title_text_style: shadow-light

title_text_color: gray
subtitle_text_color: black

min: 0
max: sensor.glow_power_consumption

precision: 0
unit: W
cutoff: 5
offset: 1d
sorting: value-desc

position: left
text_size: 2.5
text_style: weight-bold
text_color: auto

line_height: 3
corner: 'square'
state_content_separator: '|'
line_separator: true
line_separator_width: 'each010'
line_text_color: auto

color: "#00aafa"
color_bg:
    - 40
    - 40
    - 40

line_text_position: 'bottom-right'
line_text_size: 1.5
line_text_style: shadow-medium
line_text_overflow: fade
overflow_direction: right

tap_action:
  action: more-info
  entity: sensor.glow_power_consumption
hold_action:
  action: none
double_tap_action:
  action: none

legend_hide: false
legend_all: false

legend_position: bottom-center
legend_alignment: center
legend_indicator: icon-fallback
legend_text_size: 1
legend_text_style: italic
legend_text_color: gray

show_delta: false
delta_position: bottom-center

untracked_legend: true
untracked_legend_label: Untracked
untracked_legend_icon: mdi:flash
untracked_legend_indicator: icon-fallback

untracked_state_content:
  - name
  - state
untracked_line_state_content:
  - percentage

suppress_warnings: false

statistics: false
statistics_day_offset: 1
statistics_period: 'hour'
statistics_function: 'mean'

severity: true 
severity_levels:
  - from: 50
    color: red
  - from: 100
    color: yellow
  - form: 200
    color: green
severity_blend: false

entities:
  - entity: sensor.plug_0_power
    name: Plug 0
    icon: mdi:flash
    color: "auto"
    cutoff: 5
    unit: W
    multiplier: 1
    precision: 0
    state_content:
      - name
      - state
      - percentage
    line_state_content:
      - percentage
    legend_indicator: '-'
  - entity: sensor.plug_1_power
    attribute: device_class
    name: Plug 1
    color:
      - 244
      - 189
      - 74
```

<hr/>

## Main Options

There are a lot of settings you can customize your sensors with:

| Setting                        |         type          |            default             |                                         example                                          | description                                                                                                                                |
|--------------------------------|:---------------------:|:------------------------------:|:----------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------------------------------------------------|
| `entity`                       |       entityID        |          *!required*           |                                       sensor.power                                       | You can specify the entity_id here as well.                                                                                                |
| `attribute`                    |        string         |             *none*             |                                     battery_voltage                                      | Replace the state with the value of this entity attribute. Does not work when using statistics.                                            |
| `title`                        |        string         |             *none*             |                                    Power Consumption                                     | The title of the Card (font_size: 2rem). Supports [templating](#templating).                                                               |
| `subtitle`                     |        string         |             *none*             |                                           Glow                                           | Text in gray below the title (font_size: 1rem). Supports [templating](#templating).                                                        |
| `title_position`               |     PositionType      |           `top-left`           |                                           left                                           | Position of the title [see examples](#position)                                                                                            |
| `title_text_size`              |        number         |              `2`               |                                           1.5                                            | Font size of the title, subtitle is 2x smaller.                                                                                            |
| `title_text_style`             |     TextStyleType     |             *none*             |                                        ['italic']                                        | Text style of the Title ans Subtitle [see examples and hierarchy](#style)                                                                  |
| `title_text_color`             |       ColorType       |  `var(--primary-text-color)`   |                                           gray                                           | Text color of title.                                                                                                                       |
| `subtitle_text_color`          |       ColorType       | `var(--secondary-text-color)`  |                                          black                                           | Text color of subtitle.                                                                                                                    |
| `min`                          |  number or entityID   |              `0`               |                                           100                                            | The minimum value of the gauge. Can be an entity_id.                                                                                       |
| `max`                          |  number or entityID   |            *entity*            |                                       sensor.power                                       | The maximum value of the gauge. Can be an entity_id.                                                                                       |
| `precision`                    |        number         |              `0`               |                                            2                                             | The number of decimals to display.                                                                                                         |
| `unit`                         |        string         |             *none*             |                                            W                                             | This string will be appended to the end of the value. Supports [templating](#templating).                                                  |
| `cutoff`                       |        number         |              `0`               |                                            10                                            | Any entity with a value below or equal to this will not be displayed or counted.                                                           |
| `offset`                       |        string         |             *none*             |                                            1d                                            | Offset state into the past [see more](#offset).                                                                                            |
| `sorting`                      |      SortingType      |             *none*             |                                        alpha-asc                                         | Sort the line and legend entities [see more](#sorting).                                                                                    |
| `line_height`                  |        number         |              `3`               |                                            2                                             | Height of the line in rem.                                                                                                                 |
| `corner`                       |      CornerType       |            `square`            |                                         circular                                         | The theme (shape) of the gauge [see examples](#theme)                                                                                      |
| `state_content_separator`      |        string         |            `' ⸱ '`             |                                           '-'                                            | This string is added between state content items in legend and line.                                                                       |
| `line_separator`               |         bool          |            `false`             |                                           true                                           | Separates the line segments with the background color.                                                                                     |
| `line_separator_width`         |  SeparatorWidthType   |           `total050`           |                                         each008                                          | Width of separators. Total - Percentage gets divide, Each - Each separator gets fixed percentage [see more](#line_separators).             |
| `line_separator_color`         |       ColorType       | `var(--card-background-color)` |                                          white                                           | Color of the line separators.                                                                                                              |
| `position`                     |   ValuePositionType   |             `left`             |                                           none                                           | Position of the main label [see examples](#position)                                                                                       |
| `text_size`                    |        number         |             `2.5`              |                                            2                                             | Font size of the main value (in rem).                                                                                                      |
| `text_style`                   |     TextStyleType     |             *none*             |                                     ['weight-bold']                                      | Text style of the Value [see examples and hierarchy](#style)                                                                               |
| `text_color`                   |       ColorType       |  `var(--primary-text-color)`   |                                          white                                           | Text color of the Value                                                                                                                    |
| `line_text_position`           |   LinePositionType    |             `left`             |                                       bottom-right                                       | Position of the state content in the line [see examples](#untracked_state_content)                                                         |
| `line_text_size`               |        number         |              `1`               |                                           1.5                                            | Font size of the state content in the line (in rem)                                                                                        |
| `line_text_style`              |     TextStyleType     |             *none*             |                                     ['shadow-hard']                                      | Text style of the State content inside the Line [see examples and hierarchy](#style)                                                       |
| `line_text_color`              |       ColorType       |             `auto`             |                                          black                                           | Color of text in line. Automatic text color is calculated using a standard luminance formula based on human perception.                    |
| `line_text_overflow`           |   TextOverflowType    |           `tooltip`            |                                           fade                                           | What happens when the text in the line overflows [see examples](#overflow)                                                                 |
| `overflow_direction`           | OverflowDirectionType |            `right`             |                                           left                                           | Direction text slides or disappears to when overflowing [see examples](#overflow)                                                          |
| `color`                        |       ColorType       |        *primary-color*         |                                         #00aafa                                          | The color of the gauge. And the untracked legend.                                                                                          |
| `color_bg`                     |       ColorType       |  *secondary-background-color*  |                                       [40, 40, 40]                                       | The background color of the gauge. Only visible if the gauge is not filled (max is entity).                                                |
| `tap_action`                   |     Action Config     |          *more-info*           | [Configuration](https://www.home-assistant.io/lovelace/actions/#configuration-variables) | Single tap action for item.                                                                                                                |
| `hold_action`                  |     Action Config     |          *more-info*           | [Configuration](https://www.home-assistant.io/lovelace/actions/#configuration-variables) | Hold action for item.                                                                                                                      |
| `double_tap_action`            |     Action Config     |             *none*             | [Configuration](https://www.home-assistant.io/lovelace/actions/#configuration-variables) | Double tap action for item.                                                                                                                |
| `legend_hide`                  |         bool          |            `false`             |                                           true                                           | This will hide the legend = only line visible. [example](#legend_hide)                                                                     |
| `legend_all`                   |         bool          |            `false`             |                                          false                                           | Display all the entities regardless of the cutoff. (does not affect gauge) [example](#legend_all)                                          |
| `legend_position`              |     PositionType      |        `bottom-center`         |                                          right                                           | Position of the legend [see examples](#legend)                                                                                             |
| `legend_alignment`             |     AlignmentType     |            `center`            |                                      space-between                                       | Alignment of the legend items [see examples](#legend)                                                                                      |
| `legend_indicator`             |     IndicatorType     |        `icon-fallback`         |                                          circle                                          | Colored part next-to the legend text. [see examples](#legend)                                                                              |
| `legend_text_size`             |        number         |              `1`               |                                           1.5                                            | Font size of the legend text (in rem) - not including icon                                                                                 |
| `legend_text_style`            |     TextStyleType     |             *none*             |                                    ['black-outline']                                     | Text style of the legend text [see examples and hierarchy](#style)                                                                         |
| `legend_text_color`            |       ColorType       | `var(--secondary-text-color)`  |                                           gray                                           | Color of the subtitle text.                                                                                                                |
| `show_delta`                   |         bool          |            `false`             |                                           true                                           | Show the state, sum and delta of all the devices in respect to the main entity. [example](#delta)                                          |
| `delta_position`               |     PositionType      |        `bottom-center`         |                                        top-center                                        | Position of delta around value and line                                                                                                    |
| `untracked_legend`             |         bool          |             `true`             |                                          false                                           | Show the legend for untracked consumption.                                                                                                 |
| `untracked_legend_label`       |        string         |    `Untracked consumption`     |                                        Untracked                                         | The label for the untracked legend. (default is translated). Supports [templating](#templating).                                           |
| `untracked_legend_icon`        |        string         |             *none*             |                                        mdi:flash                                         | Display an icon instead of the colored circle. (icon will also be colored)                                                                 |
| `untracked_legend_indicator`   |     IndicatorType     |        `icon-fallback`         |                                          state                                           | Colored part next-to the legend text. [see examples](#legend)                                                                              |
| `untracked_state_content`      | UntrackedStateContent |           `['name']`           |                                        ['state']                                         | What info will be shown after the circle or icon. Order matters. Info will be separated by a dot. [see examples](#untracked_state_content) |
| `untracked_line_state_content` | UntrackedStateContent |             *none*             |                                      ['percentage']                                      | Info will be shown in the line. Order matters. Info will be separated by a dot. [see examples](#untracked_state_content)                   |
| `suppress_warnings`            |         bool          |            `false`             |                                           true                                           | Do not show the warnings, such as "Entity unavailable" or "Entity not found"                                                               |
| `statistics`                   |         bool          |            `false`             |                                           true                                           | Enable the statistic data. Data from statistic will be displayed instead of current state [see more](#statistics).                         |
| `statistics_day_offset`        |        number         |              `1`               |                                            7                                             | Whole number of days into the past.                                                                                                        |
| `statistics_period`            |   StatisticsPeriod    |             `hour`             |                                           day                                            | Statistical period [see more](#statistics).                                                                                                |
| `statistics_function`          |  StatisticsFunction   |             `mean`             |                                           max                                            | Statistical function [see more](#statistics).                                                                                              |
| `severity`                     |         bool          |            `false`             |                                           true                                           | Replace color of the main entity based on the state leves defined in `severity_levels` [see more](#severity)                               |
| `severity_levels`              |     SeverityLevel     |             *none*             |                               (Example [here](#severity))                                | List of levels with associated colors (from {value} the color will be {color}) [see more](#severity)                                       |
| `severity_blend`               |         bool          |            `false`             |                                           true                                           | Blend colors in between levels using RGB interpolation based on the state. [example](#severity)                                            |
| `entities`                     |       Entities        |             *none*             |                                    (Example in yaml)                                     | The list of entities. Config [here.](#entities)                                                                                            |

### Types

The types are used in the configuration. The type is used to define what kind of data is expected.

|         Type          | description                                                                                                                                                                                                                                                                                                                                                         |
|:---------------------:|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|        string         | A string of characters (text)                                                                                                                                                                                                                                                                                                                                       |
|        number         | A number.                                                                                                                                                                                                                                                                                                                                                           |
|         bool          | `true` or `false`                                                                                                                                                                                                                                                                                                                                                   |
|       entityID        | String containing an entity id. Example: `sensor.plug_1_power`                                                                                                                                                                                                                                                                                                      |
|     PositionType      | Single: `left`, `right`, `none`, `top-left`, `top-center`, `top-right`, `bottom-left`, `bottom-center`, `bottom-right`                                                                                                                                                                                                                                              |
|   ValuePositionType   | Single: `left`, `right`, `none`, `top-left`, `top-center`, `top-right`, `bottom-left`, `bottom-center`, `bottom-right`, `in-title-right`, `in-title-left`                                                                                                                                                                                                           |
|   LinePositionType    | Single: `left`, `right`, `none`, `center`, `top-left`, `top-center`, `top-right`, `bottom-left`, `bottom-center`, `bottom-right`                                                                                                                                                                                                                                    |
|      CornerType       | Single: `square`, `lite-rounded`, `medium-rounded`, `rounded`, `circular`                                                                                                                                                                                                                                                                                           |
|      SortingType      | Single: `alpha-asc`, `alpha-desc`, `value-asc`, `value-desc`, `none`                                                                                                                                                                                                                                                                                                |
|  SeparatorWidthType   | Single: `total020`, `total030`, `total040`, `total050`, `total060`, `total070`, `total080`, `total090`, `total100`, `each002`, `each004`, `each006`, `each008`, `each010`, `each012`, `each014`, `each016`, `each018`, `each020` [mode]{num}{num}.{num}                                                                                                             |
|     AlignmentType     | Single: `left`, `right`, `center`, `space-around`, `space-between`, `space-evenly`, `new-line`, `new-line-left`, `new-line-right`                                                                                                                                                                                                                                   |
|     TextStyleType     | Array of any: `weight-lighter`, `weight-bold`, `weight-bolder`, `style-italic`, `decoration-underline`, `decoration-overline`, `decoration-line-through`, `transform-uppercase`, `transform-lowercase`, `transform-capitalize`, `family-monospace`, `shadow-light`, `shadow-medium`, `shadow-heavy`, `shadow-hard`, `shadow-neon`, `black-outline`, `white-outline` |
|   TextOverflowType    | Single: `ellipsis`, `clip`, `tooltip`, `tooltip-segment`, `fade`                                                                                                                                                                                                                                                                                                    |
| OverflowDirectionType | Single: `left`, `right`                                                                                                                                                                                                                                                                                                                                             |
|       ColorType       | An array of three numbers (RGB), `auto`, `var(--custom-color)`, or any string that will work as a CSS color. See [examples and more](#colors)                                                                                                                                                                                                                       |
|     ActionConfig      | Event cased by an Action. See more [Configuration](https://www.home-assistant.io/lovelace/actions/#configuration-variables)                                                                                                                                                                                                                                         |
| UntrackedStateContent | Array of any: `state`, `name`, `percentage`, `icon`                                                                                                                                                                                                                                                                                                                 |
|   StatisticsPeriod    | Single: `5minute`, `hour`, `day`, `week`, `month`                                                                                                                                                                                                                                                                                                                   |
|  StatisticsFunction   | Single: `max`, `mean`, `min`, `state`, `sum`, `change`                                                                                                                                                                                                                                                                                                              |
|     IndicatorType     | Single: `circle`, `icon`, `icon-fallback`, `none`, `name`, `state`, `percentage`                                                                                                                                                                                                                                                                                    |
|     StateContent      | Array of any: `state`, `name`, `last_changed`, `last_updated`, `percentage`, `icon`                                                                                                                                                                                                                                                                                 |

</div>

## Entities

The only required field is `entity`. The rest of the fields are optional. Color `auto` can only be set in the YAML file (or it will be set to `auto` by default when creating the card).

You can set the `entity` to `none`, `null` or `undefined` to create a "spacer" to "consume" an automatic color (I had a unique "gap" in my HA energy panel colors - the color index skipped a color).

#### Each entity has its own settings:

| Setting              |     type      |     default      |                                         example                                          | description                                                                                                                                          |
|----------------------|:-------------:|:----------------:|:----------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------|
| `entity`             |   entityID    |   *!required*    |                                   sensor.plug_0_power                                    | You can specify the entity_id here as well.                                                                                                          |
| `attribute`          |    string     |      *none*      |                                     battery_voltage                                      | Replace the state with the value of this entity attribute.  Does not work when using statistics.                                                     |
| `name`               |    string     |      *none*      |                                          Plug 0                                          | The name of the entity to be displayed in the legend. Supports [templating](#templating).                                                            |
| `icon`               |    string     |      *none*      |                                        mdi:flash                                         | Display an icon instead of the colored circle. (icon will also be colored) [example](#icon)                                                          |
| `color`              |   ColorType   |      `auto`      |                                           auto                                           | The color of the gauge and legend. (auto: Home Assistant Energy panel - the same order)                                                              |
| `cutoff`             |    number     |  *main cutoff*   |                                            10                                            | Any entity with a value below this will not be displayed.                                                                                            |
| `unit`               |    string     |  *entity unit*   |                                            kW                                            | String that is added to the end of entity state. Supports [templating](#templating).                                                                 |
| `multiplier`         |    number     |       `1`        |                                          0.001                                           | Entity state will be multiplied by this number. Useful when you have entities in kW and W. Automatically set (adjusts to be the same as main entity) |
| `precision`          |    number     | *main precision* |                                            1                                             | Will override main precision pre entity.                                                                                                             |
| `state_content`      | StateContent  |    `['name']`    |                                    ['name', 'state']                                     | State content in the legend. Order matters. Info will be separated by a dot.                                                                         |
| `line_state_content` | StateContent  |      *none*      |                                 ['percentage', 'state']                                  | State content in the line. Order matters. Info will be separated by a dot.                                                                           |
| `line_text_color`    |   ColorType   |      *main*      |                                          black                                           | Color of text in line. Automatic text color is calculated using a standard luminance formula based on human perception.                              |
| `legend_indicator`   | IndicatorType | `icon-fallback`  |                                          circle                                          | What indicator will be left of the text in the legend.                                                                                               |
| `legend_text_color`  |   ColorType   |      *main*      |                                          white                                           | Color of the legend text.                                                                                                                            |
| `tap_action`         | Action Config |   *more-info*    | [Configuration](https://www.home-assistant.io/lovelace/actions/#configuration-variables) | Single tap action for item.                                                                                                                          |
| `hold_action`        | Action Config |   *more-info*    | [Configuration](https://www.home-assistant.io/lovelace/actions/#configuration-variables) | Hold action for item.                                                                                                                                |
| `double_tap_action`  | Action Config |      *none*      | [Configuration](https://www.home-assistant.io/lovelace/actions/#configuration-variables) | Double tap action for item.                                                                                                                          |
<p>

</div>

<hr/>

## Examples

### Icons in the legend

```yaml
type: 'custom:energy-line-gauge'
entity: sensor.glow_power_consumption
entities:
  - entity: sensor.pc_power
    name: Plug 0
    icon: mdi:desktop-classic
  - entity: sensor.stove_power
    name: Plug 1
    icon: mdi:stove
untracked_legend_icon: mdi:flash
untracked_state_content:
  - name
  - state
```
</div>

### Only Line

```yaml
type: 'custom:energy-line-gauge'
entity: sensor.glow_power_consumption
position: none
legend_hide: true
corner: square
```
</div>

### Delta

<div id="delta">
Shows the difference between the main entity and the sum of all the entities.

```yaml
type: 'custom:energy-line-gauge'
entity: sensor.glow_power_consumption
legend_hide: true
show_delta: true
corner: square
position: left
entities:
  ...
```
</div>

### Legend with all entities

```yaml
type: 'custom:energy-line-gauge'
entity: sensor.glow_power_consumption
legend_all: true
corner: square
position: left
entities:
  ...
```
</div>

### Normal usage ( how I use it )

Mainly using the default settings.
I am using the automatic color option, and I have the entities in the same order as I have them in the Home Assistant Energy panel.

```yaml
type: custom:energy-line-gauge
entity: sensor.glow_power_consumption
min: 0
unit: W
entities:
  - entity: sensor.plug_0_power
    name: PC
  - entity: sensor.nous_zigbee_plug_power
    name: Bed
  - entity: sensor.immax_wifi_plug_wattage
    name: Bedroom Outlet
untracked_legend: true
untracked_legend_label: Untracked
```

## Position

### `position: none` `title_position: none` `legend_position: none` `line_text_position: none`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/position/none.png" alt="none">

### `position: left` `title_position: left`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/position/left.png" alt="left">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/title_position/left.png" alt="left">

### `position: right` `title_position: right`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/position/right.png" alt="right">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/title_position/right.png" alt="right">

### `position: top-left` `title_position: top-left`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/position/top-left.png" alt="top-left">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/title_position/top-left.png" alt="top-left">

### `position: top-center` `title_position: top-center`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/position/top-center.png" alt="top-center">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/title_position/top-center.png" alt="top-center">

### `position: top-right` `title_position: top-right`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/position/top-right.png" alt="top-right">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/title_position/top-right.png" alt="top-right">

### `position: bottom-left` `title_position: bottom-left`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/position/bottom-left.png" alt="bottom-left">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/title_position/bottom-left.png" alt="bottom-left">

### `position: bottom-center` `title_position: bottom-center`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/position/bottom-center.png" alt="bottom-center">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/title_position/bottom-center.png" alt="bottom-center">

### `position: bottom-right` `title_position: bottom-right`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/position/bottom-right.png" alt="bottom-right">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/title_position/bottom-right.png" alt="bottom-right">

### `position: in-title-right` `title_position: top-center`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/position/in-title-right.png" alt="in-title-right">

### `position: in-title-left` `title_position: top-center`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/position/in-title-left.png" alt="in-title-left">

## Legend

### `legend_position: left` `legend_alignment: center`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_position/left.png" alt="left">

### `legend_position: right` `legend_alignment: center`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_position/right.png" alt="right">

### `legend_position: top-*` `legend_alignment: center`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_position/top.png" alt="top">

### `legend_position: bottom-*` `legend_alignment: center`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_position/bottom.png" alt="bottom">

## Legend Alignment

### `legend_alignment: left`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_alignment/left.png" alt="left">

### `legend_alignment: right`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_alignment/right.png" alt="right">

### `legend_alignment: center`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_alignment/center.png" alt="center">

### `legend_alignment: space-around`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_alignment/space-around.png" alt="space-around">

### `legend_alignment: space-between`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_alignment/space-between.png" alt="space-between">

### `legend_alignment: space-evenly`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_alignment/space-evenly.png" alt="space-evenly">

### `legend_alignment: new-line`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_alignment/new-line.png" alt="new-line">

### `legend_alignment: new-line-left`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_alignment/new-line-left.png" alt="new-line-left">

### `legend_alignment: new-line-right`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_alignment/new-line-right.png" alt="new-line-right">

## Legend Indicator

### `legend_indicator: circle`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_indicator/circle.png" alt="circle">

### `legend_indicator: icon`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_indicator/icon.png" alt="icon">

### `legend_indicator: icon-fallback`
If no icon is set, it will show a circle.

### `legend_indicator: none`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_indicator/none.png" alt="none">

### `legend_indicator: name`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_indicator/name.png" alt="name">

### `legend_indicator: state`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_indicator/state.png" alt="state">

### `legend_indicator: percentage`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/legend_indicator/percentage.png" alt="percentage">

</div>
</div>

## Theme

### `corner: square`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/theme/square.png" alt="square">

### `corner: lite-rounded`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/theme/lite-rounded.png" alt="lite-rounded">

### `corner: medium-rounded`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/theme/medium-rounded.png" alt="medium-rounded">

### `corner: rounded`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/theme/rounded.png" alt="rounded">

### `corner: circular`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/theme/circular.png" alt="circular">

## Style

### `weight-bolder` → `weight-bold` → `weight-lighter`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/weight-bolder.png" alt="weight-bolder">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/weight-bold.png" alt="weight-bold">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/weight-lighter.png" alt="weight-lighter">

### `style-italic`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/style-italic.png" alt="style-italic">

### `decoration-underline` `decoration-overline` `decoration-line-through`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/decoration-underline.png" alt="decoration-underline">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/decoration-overline.png" alt="decoration-overline">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/decoration-line-through.png" alt="decoration-line-through">

### `transform-uppercase` → `transform-lowercase` → `transform-capitalize`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/transform-uppercase.png" alt="transform-uppercase">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/transform-lowercase.png" alt="transform-lowercase">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/transform-capitalize.png" alt="transform-capitalize">

### `family-monospace`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/family-monospace.png" alt="family-monospace">

### `shadow-neon` → `shadow-hard` → `shadow-heavy` → `shadow-medium` → `shadow-light`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/shadow-neon.png" alt="shadow-neon">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/shadow-hard.png" alt="shadow-hard">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/shadow-heavy.png" alt="shadow-heavy">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/shadow-medium.png" alt="shadow-medium">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/shadow-light.png" alt="shadow-light">

### `black-outline` → `white-outline`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/black-outline.png" alt="black-outline">
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/text_style/white-outline.png" alt="white-outline">

</div>

## Overflow

### `line_text_overflow: ellipsis`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/overflow/ellipsis.png" alt="ellipsis">

### `line_text_overflow: clip`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/overflow/clip.png" alt="clip">

### `line_text_overflow: fade`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/overflow/fade.png" alt="fade">

### `line_text_overflow: tooltip`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/overflow/tooltip.png" alt="tooltip">

### `line_text_overflow: tooltip-segment`
Each of the state content parts will disappear one by one when the text is too long. The first part will be removed, then the second part and so on.

## Overflow Direction

### `line_text_overflow_direction: right`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/overflow/fade.png" alt="fade">

### `line_text_overflow_direction: left`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/overflow/fade-direction-left.png" alt="fade">

</div>

## Colors

The color configuration has been through a lot of changes in the past. The current version is very flexible and allows you to set the color of each entity separately, as well as the text color in the line and legend. The automatic color option is also available, which will use the same colors as the Home Assistant Energy panel.

This card has a custom color selector that has been added in [v2.2.6](https://github.com/Tomer27cz/energy-line-gauge/releases/tag/v2.2.6).

It allows to select from Home Assistant color variables, custom RGB color or any CSS color string. It accepts any string that is a valid CSS color, for example `red`, `#ff0000`, `rgb(255, 0, 0)`, `var(--my-color)` and so on.

### Linear Gradient

One very powerful configuration option is the ability to set a linear gradient as the color of the main line, background or entity.

You could set the main line to be an accent tick at the end.
```
linear-gradient(
    to left,
    var(--accent-color) 0%,
    var(--accent-color) 0.2rem,
    transparent 0.2rem,
    transparent 100%
);
```
And set the background to display a range of acceptable values.
```
linear-gradient(
    to right, 
    var(--secondary-background-color) 0%, 
    var(--secondary-background-color) 40%, 
    var(--primary-color) 40%, 
    var(--primary-color) 60%, 
    var(--secondary-background-color) 60%, 
    var(--secondary-background-color) 100%
  );
```

</div>

## State Content

<div id="state_content">
The state content is the text displayed in the legend and the line. You can choose what to display and in which order.  The order in the config matters. The text will be separated by `state_content_separator` config option.

The position of the text in the line is set by `line_text_position`. Options are `left`, `right`, `none`, `center`, `top-left`, `top-right`, `top-center`, `bottom-left`, `bottom-right`, `bottom-center`.

| Option         | description                                                  |    Example    |
|----------------|--------------------------------------------------------------|:-------------:|
| `name`         | Specified in config or if not the `friendly_name` attribute. |    Plug 1     |
| `state`        | The state of the entity, with the `unit` added at the end.   |     158 W     |
| `last_changed` | The last time the entity changed state.                      | 6 seconds ago |
| `last_updated` | The last time the entity was updated.                        | 6 seconds ago |
| `percentage`   | The percentage of the entity in respect to the main entity.  |      55%      |
| `icon`         | Specified in config or if not the `icon` attribute.          | mdi:lightbulb |

```yaml
type: custom:energy-line-gauge
entity: input_number.test_num_2
min: 0
max: 100
entities:
  - entity: input_number.test_num
    color: auto
    state_content:
      - name
      - state
      - percentage
    line_state_content:
      - state
      - percentage
line_text_position: left
line_text_size: 1
untracked_legend: false
```
</div>

### Untracked State Content

| Option         | description                                                                                       |  Example  |
|----------------|---------------------------------------------------------------------------------------------------|:---------:|
| `name`         | Specified in config or `Untracked consumption`(translated).                                       | Untracked |
| `state`        | Main entity state minus sum of device states, with the `unit` added at the end. (can be negative) |   -15 W   |
| `percentage`   | One hundred minus the sum of device widths                                                        |    3%     |
| `icon`         | Specified in config.                                                                              | mdi:flash |

```yaml
type: custom:energy-line-gauge
entity: input_number.test_num_2
min: 0
max: 100
entities:
  - entity: input_number.test_num
    color: auto
    line_state_content:
      - percentage
line_text_position: center
line_text_size: 2
legend_hide: true
untracked_legend: false
untracked_line_state_content:
  - percentage
```

### `line_text_position: *` `line_text_size: 1.5`
<img src="https://github.com/Tomer27cz/energy-line-gauge/raw/main/.github/img/line_text_position/3-3-line-text.png" alt="line_text_position">

</div>

## Offset

Added in [v2.1.6](https://github.com/Tomer27cz/energy-line-gauge/releases/tag/v2.1.6). Feature request [#3](https://github.com/Tomer27cz/energy-line-gauge/issues/3) (see for more info).

The offset is the time into the past that the state will be displayed. The offset is in seconds, minutes or days. It has to be a **whole positive number**. Examples `1d`, `80s`, `60m` or `2h`.

The recommended *minimum* is 60 seconds, use a lower number at your own risk. Lower numbers mean more requests to the recorder. The maximum offset depends on your recorder settings. The default is 10 days. If you want to use a higher number, you have to change the `purge_keep_days` setting in your recorder settings.

</div>

## Statistics

Added in [v2.1.7](https://github.com/Tomer27cz/energy-line-gauge/releases/tag/v2.1.7). Feature request [#3](https://github.com/Tomer27cz/energy-line-gauge/issues/3) (see for more info).

Home Assistant calculates the statistical data. The `statistics-graph` card uses the same API, hence why this card has similar configuration. The statistics will be displayed instead of the current state.  The `start_time` is 00:00:00 of the day. The `end_time` is 23:59:59 of the day.

The statistics only support `sensors` with state_class of `measurement`, `total` or `total_increasing`.

- `statistics` is a boolean. If set to true, the card will display the statistics instead of the current state.

- `statistics_day_offset` is the number of days into the past. It has to be a whole positive integer. The default is 1 day.

- `statistics_period` is the period on which the statistics are calculated (the average of the whole day or each hour). The default is `hour`. The options are `5minute`, `hour`, `day`, `week`, `month`.

- `statistics_function` is the function used to calculate the statistics. The default is `mean`. The options are `change`, `max`, `mean`, `min`, `state`, `sum`.

Some entities only support `mean`, `min` and `max` (For example `sensor.plug_1_power` - state_class: measurement). And some entities only support `change`, `state` and `sum` (For example `sensor.plug_1_summitation_delivered` - state_class: total). A warning will be shown if the entity does not support the selected function: `No statistics found.`.

</div>

## Line Separators

Added in [v2.2.4](https://github.com/Tomer27cz/energy-line-gauge/releases/tag/v2.2.4). Feature request [#14](https://github.com/Tomer27cz/energy-line-gauge/issues/14).

You can add gaps between segments in the line. The gaps can be customized with `line_separator_width` and `line_separator_color`.

### `line_separator_width` - Separator width options: [mode]{num}{num}.{num}

- `total020` → `total100` (2% - 10% of the total line width)
- `each002` → `each020` (0.2% - 2% of each segment width)

</div>

## Templating

Added support for [Home Assistant templating](https://www.home-assistant.io/docs/configuration/templating/) in [v2.2.7](https://github.com/Tomer27cz/energy-line-gauge/releases/tag/v2.2.7).

The following fields support templating: `title`, `subtitle`, `unit`, `untracked_legend_label`, entity `name`, entity `unit`.

An example of templating in the title:

```yaml
type: custom:energy-line-gauge
entities: []
entity: sensor.pipe_temperature
unit: °C
title_position: right
title: "{{ states('binary_sensor.pump_status') | upper }}"
```

You can learn more about templating in Home Assistant [here](https://www.home-assistant.io/docs/configuration/templating/).

</div>

## Sorting Entities

Added in [v2.2.8](https://github.com/Tomer27cz/energy-line-gauge/releases/tag/v2.2.8). Feature request [#16](https://github.com/Tomer27cz/energy-line-gauge/issues/16).

You can sort the entities in the legend and line by using the `sorting` configuration option. The options are:
- `alpha-asc` - Sort entities alphabetically in ascending order (A-Z) based on their names.
- `alpha-desc` - Sort entities alphabetically in descending order (Z-A) based on their names.
- `value-asc` - Sort entities by their values (current, statistical or historical) from lowest to highest.
- `value-desc` - Sort entities by their values (current, statistical or historical) from highest to lowest.
- `none` - No sorting, display entities in the order they are defined in the configuration.

</div>

## Severity

Added in [v2.2.8](https://github.com/Tomer27cz/energy-line-gauge/releases/tag/v2.2.8).

You can set the color of the main line based on the value of the entity. The colors will show only if `severity: true`

The colors and levels are defined in the `severity_levels` configuration option. Each level has a color and a "from" value. The "from" value is the minimum value for that level. The levels are evaluated from highest to lowest, meaning that if the value is above the "from" value of a level, that level's color will be used if there is not a level with a higher value.

```yaml
color: red
severity: true
severity_levels:
  - from: 10
    color: orange
  - from: 20
    color: yellow
  - from: 30
    color: green
```

- The base color is `red`. 
- From `10` to `20` the color will be `orange`.
- From `20` to `30` the color will be `yellow`.
- From `30` and above the color will be `green`.

`severity_blend: true` - Blending is supported when the value is between two levels. The color will be a blend of the two levels based on the value's position between the two levels. RGB interpolation is used.

</div>

## Issues / Feedback / Suggestions

If you find a bug or have a suggestion, please let me know on the [GitHub issues page](https://github.com/Tomer27cz/energy-line-gauge/issues). I am happy about every feedback and will try to fix the issue as soon as possible.

</div>

## Contribute

If you want to contribute to the project, you can do so by forking the repository and creating a pull request. I am happy about every contribution, whether it is a bug fix, a new feature or a documentation improvement.

</div>
<hr/>

### **All contributions are welcome!**

### **If you like the card, consider ⭐ starring it.**

energy-line-gauge

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README