Energy Meter Tracker

Energy Meter Tracker — Half-hourly electricity metering app for Home Assistant

GitHub Repository

I’ve built a Home Assistant app that records your electricity usage in precise half-hour blocks — the same intervals UK energy supplier uses for billing.

Why?

The built-in Energy dashboard tracks totals but doesn’t give you visibility into individual half-hour periods. If you’re on an Agile or time-of-use tariff, or you want to understand how your battery, EV charger or heat pump is affecting your grid consumption, you need half-hourly data.

What it does

  • Records import and export meter readings at every :00 and :30 boundary
  • Boundary interpolation — even if your sensor updates every 60 seconds, the block delta is calculated precisely to the boundary timestamp, not to whenever the last reading happened to land
  • Sub-meter support — track EV chargers, home batteries and heat pumps; the engine distributes grid consumption across them using a grid-authoritative algorithm (the main meter is always the source of truth)
  • Gap filling — if the app restarts mid-session it detects missing blocks and interpolates them automatically
  • Backup — data is copied to /share after every block finalise, with zip snapshots before every config change
  • Four HA sensors — cumulative import/export kWh and cost, compatible with the Energy dashboard and Utility Meter
  • Web UI — config wizard, charts, logs viewer, help page, all accessible from the sidebar

Requirements

Installation

Add the repository to your HA app store:

https://github.com/RGx01/energy-meter-tracker-addon

Settings → Apps → App Store → ⋮ → Repositories → paste the URL above.

Disclaimer

This app is for informational use only. It provides a close approximation of your half-hourly consumption based on local sensor readings. It cannot replicate your supplier’s authoritative HH reconciliation — do not use it for billing disputes.

Feedback welcome

This is a v1.1.0 release — feedback, bug reports and feature requests are very welcome via GitHub Issues. I’m particularly interested in hearing from users with tariff types and set ups.


1 Like

Who told you my energy supplier uses half hour blocks?

Whoever it was, they are wrong. My energy supplier uses 5 minute blocks.

Thanks @tom_l. I updated the description to be UK suppliers. My first app, never going to be perfect or universal. Take it easy.

I was just joking about your choice of words. No hard feelings.

Hi All
Is it going to work with Mini Octopus

In short, I don’t think it’s possible right now. The app relies on meter reads for any missed reconciliation, If anyone knows if it is possible it would be @BottlecapDave as his integration provides demand power from the mini. I read in a few places that the mini only works with import but mine does export too so there could be some hope.

@tom_l I’ve made some changes, meters with reconciliation windows of 5, 15 and 30 minute blocks are now supported.