junalmeida / ha-addons-meterparser

Addon for water and electricity meter parsers

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Home Assistant - Meter Parser AddOn

BuyMeCoffee Checks Last release 1

This is a Home Assistant AddOn (not HACS) to allow parse of dial and digits utility meters like water, gas, and electricity to provide energy consumption information to home assistant using a regular ip camera.

This repository is under alpha stage, so expect bugs and breaking changes.

Supports aarch64 Architecture Supports amd64 Architecture

Please consider sponsoring if you feel that this project is somehow useful to you.

Highlights of what Meter Parser can do

  • Parse Meters
  • Provide a consumption sensor of total_increasing state type.
  • Cheap IP or PoE cameras must do.
  • Sensor may be used by energy panel in home assistant, or Utility Meter integration to provide statistics and costs by any time span (monthly, daily, etc.)

Potential Downsides

  • Positioning a camera and getting a good image could be difficult.
  • Could be hard to setup calibration parameters.
  • To recognize digits, this project relys on OCR services on the internet. I am open to suggestions on better local libraries to scan digits. Recognizing dials is simple and local, no internet connection or APIs are required.

Reporting an Issue

File an issue in this Github Repository, add logs and if possible an image of your meter. Please redact sensitive information.

I also appreciate if you share the camera device specs and light conditions.

Credits

🎉 Dial Parser code is based on the awesome work of @mirogta, please support his work.

Footnotes

  1. Icons made by Smashicons from flaticon.com

About

Addon for water and electricity meter parsers

License:MIT License


Languages

Language:Python 96.8%Language:Dockerfile 2.9%Language:Shell 0.3%