From 872988587c8135fbcbd3aee52ed9f2fa066b6a43 Mon Sep 17 00:00:00 2001 From: Dave T <17680170+davet2001@users.noreply.github.com> Date: Wed, 30 Oct 2024 22:35:13 +0000 Subject: [PATCH 1/3] Update readme documentation --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 1330899..08ae45b 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ Energy Sankey is a collection of dashboard cards for homeassistant, dynamically The cards are ideal if you want to track your energy consumption and identify where your energy is going. There are two main cards: - - a card showing the total _energy_ flow based on a configurable time range (e.g. day so far). + - a card showing the total _energy_ flow based on a configurable* time range (e.g. day so far). - a user configurable card showing the _power_ flow for a set of sensors. This represents the live power flow at the current moment. Both cards base their configuration on the existing home assistant energy configuration. @@ -25,8 +25,8 @@ The diagram dynamically scales to fit the size of the window it is in (mostly). Outstanding issues to solve: - [ ] Sometimes there are thin dark lines between the blocks that make up the shapes, I believe this is caused by antialiasing, but I don't see an easy way of reducing/eliminating it, especially where the shapes are across two divs. -- [ ] If you stretch the card really wide, it sort of looks a bit silly. Perhaps that's not a major issue though. - [ ] There are probably more edge cases to experiment with, such as multiple generation sources, grid configured with only input or output, and either of those being negative to represent flow in the opposite direction. +- [ ] *Configurable time range is not yet implemented - [ ] Battery storage is not supported yet. That could be added in the future. From 16d6d28ddba858ac6170bebaf544d7efa0882f57 Mon Sep 17 00:00:00 2001 From: Dave T <17680170+davet2001@users.noreply.github.com> Date: Wed, 30 Oct 2024 23:03:08 +0000 Subject: [PATCH 2/3] Update README.md --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 08ae45b..f24d809 100644 --- a/README.md +++ b/README.md @@ -8,11 +8,13 @@ Energy Sankey is a collection of dashboard cards for homeassistant, dynamically The cards are ideal if you want to track your energy consumption and identify where your energy is going. +The aim is for as easy setup as possible. No configuring groups of child entities, complicated choices or hunting for info to populate a yaml configuration. + There are two main cards: - a card showing the total _energy_ flow based on a configurable* time range (e.g. day so far). - a user configurable card showing the _power_ flow for a set of sensors. This represents the live power flow at the current moment. -Both cards base their configuration on the existing home assistant energy configuration. +Both cards base their configuration on the existing home assistant energy configuration, and use the same colour scheme. Both are live and automatically updating. The cards try to display a coherent representation even if the data set is incomplete or physically impossible (e.g. exporting more than the total generated). This means it is ok for asynchronous updates to be made to any of the entities it is listening to. From ae0906998bae4c3e0f0d260c3f845c1a722e6c22 Mon Sep 17 00:00:00 2001 From: Dave T <17680170+davet2001@users.noreply.github.com> Date: Wed, 30 Oct 2024 23:26:49 +0000 Subject: [PATCH 3/3] Add installation instructions and badges --- README.md | 23 ++++++++++++++++++++--- 1 file changed, 20 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index f24d809..84cab41 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,10 @@ -[![hacs_badge](https://img.shields.io/badge/HACS-Custom-41BDF5.svg?style=for-the-badge)](https://github.com/hacs/integration) -# Energy Sankey +# Home Assistant Energy Sankey + +[![GitHub Release][releases-shield]][releases] +[![hacs_badge](https://img.shields.io/badge/HACS-Default-41BDF5.svg?style=for-the-badge)](https://github.com/hacs/integration) +[![License][license-shield]](LICENSE.md) + Energy Sankey is a collection of dashboard cards for homeassistant, dynamically displaying the flow of electrical energy and power. @@ -8,7 +12,7 @@ Energy Sankey is a collection of dashboard cards for homeassistant, dynamically The cards are ideal if you want to track your energy consumption and identify where your energy is going. -The aim is for as easy setup as possible. No configuring groups of child entities, complicated choices or hunting for info to populate a yaml configuration. +The aim is for as easy setup as possible. No configuring groups of child entities, complicated choices or hunting for info to populate a yaml configuration. In most cases, the default configuration should just work. There are two main cards: - a card showing the total _energy_ flow based on a configurable* time range (e.g. day so far). @@ -24,6 +28,15 @@ The colour of the flows heading to the consumers represents the blend of locally The diagram dynamically scales to fit the size of the window it is in (mostly). +# Installation + - Open HACS and search for Energy Sankey + - Click on the repository and select download + - Reload when prompted + - Select a dashboard and enter editing mode + - Type 'Sankey' in the search box + - Select 'Custom: Sankey Energy Flow Card' or 'Custom: Sakney Power Flow Card' + - The energy card does not require configuration + - The power card auto configures. If there are any problems with autoconfiguration, edit the displayed yaml to select the correct power entities for grid input / generation / consumers. Outstanding issues to solve: - [ ] Sometimes there are thin dark lines between the blocks that make up the shapes, I believe this is caused by antialiasing, but I don't see an easy way of reducing/eliminating it, especially where the shapes are across two divs. @@ -32,3 +45,7 @@ Outstanding issues to solve: - [ ] Battery storage is not supported yet. That could be added in the future. + +[license-shield]: https://img.shields.io/github/license/davet2001/homeassistant-energy-sankey-card.svg?style=for-the-badge +[releases-shield]: https://img.shields.io/github/release/davet2001/homeassistant-energy-sankey-card?style=for-the-badge +[releases]: https://github.com/davet2001/homeassistant-energy-sankey-card/releases