Skip to content

Omnibattery

Use your home battery to reduce grid costs

Omnibattery connects compatible home batteries to Home Assistant so they can follow household demand, store available solar energy and charge when your schedule or electricity price makes it worthwhile.

Is Omnibattery for me?

Use it if you already have a supported battery and a Home Assistant sensor that measures power imported from or exported to the grid. It is especially useful when you want one place to coordinate batteries, solar forecasts, electricity prices and household loads.

You do not need it if the manufacturer's own control already meets your needs, or if you only want to view battery data without Home Assistant adjusting battery power.

Check whether your exact battery is compatible before installing.

Supported brands at a glance

Brand How Omnibattery connects Start here
Marstek Venus Modbus TCP, Modbus RTU or a LilyGo RS-485/ESPHome bridge Marstek setup
Zendure SolarFlow Local HTTP API Zendure setup
Anker SOLIX Solarbank Modbus TCP Anker SOLIX setup
Huawei SUN2000 + LUNA2000 Modbus TCP through the inverter Huawei setup
Sessy Home Battery Local HTTP API through the Sessy dongle Sessy setup
Hoymiles MS-A2 and HiBattery MQTT through Home Assistant Hoymiles MQTT setup
Indevolt SolidFlex and PowerFlex Local HTTP API Indevolt setup

Omnibattery can coordinate supported brands in the same installation. Check the installation requirements before changing any manufacturer settings.

What it can do for you

  • Match battery power to home consumption

    Reduce unwanted grid import or export as appliances turn on and off.

  • Make better use of solar energy

    Combine live production, battery capacity and forecasts to decide when energy should be stored.

  • Charge when grid energy makes sense

    Use time windows or electricity prices to buy only the energy your home is expected to need.

  • Coordinate several batteries

    Share demand across compatible batteries while respecting each battery's charge, discharge and state-of-charge limits.

How to start

  1. Check the requirements and install Omnibattery.
  2. Add the integration and connect your grid sensor and battery.
  3. Open the Omnibattery sidebar panel to confirm power and state of charge, then enable only the features that suit your home.

Already using Marstek Venus Energy Manager? Follow the upgrade guide so your settings, entity history and dashboards remain connected.

Your control dashboard

The sidebar panel is installed with the integration; it does not require another Home Assistant Community Store (HACS) card or YAML dashboard configuration. Use Overview to follow live energy flow and daily history, Batteries to inspect each unit, and Control to enable and adjust optional features.

Omnibattery dashboard showing home energy flow

Advanced details

Omnibattery's proportional–derivative (PD) controller reacts when the grid sensor publishes a new value and adjusts battery power toward the configured grid target, including zero import or export. Tuning profiles from Very smooth to Very aggressive and the PD Control Quality sensor help identify a response that is stable, oscillating or slow. An optional direct-tracking mode follows the grid reading 1:1 in one control cycle, without integral, derivative, smoothing or rate-limit behavior.

The integration can coordinate up to ten batteries. It uses state-of-charge priorities, energy hysteresis and efficiency-aware sharing while applying per-battery and system power limits. See Multi-battery management.

The dashboard's Overview tab includes an animated state-of-charge ring, a Grid↔Home↔Battery↔Solar flow diagram, diagnostics, history charts and a measured/projected daily timeline. Batteries shows each unit's power, state of charge, health, cells, daily energy, optional maximum power point tracking (MPPT) inputs, firmware and controls.

Optional energy features include:

  • Predictive charging using time slots, dynamic pricing or real-time prices, including Tibber; its demand estimate uses a seven-day rolling history of household consumption
  • Time slots for independent charge and discharge windows, each with its own state-of-charge and power settings
  • Capacity protection (peak shaving) to reserve energy for demand above a configured threshold
  • Weekly full charge, which can charge to 100% for balancing, and a cell balance monitor that records cell-voltage spread and protects the open-circuit rest period
  • Solar charge delay when expected production can fill the battery later
  • Hourly net balance, which adjusts the PD target toward a configurable hourly grid-energy result and can use an external balance sensor
  • Load exclusion for electric vehicle chargers and other large loads, with an individual exclusion setting from 0–100%
  • Proactive Home Assistant fault and alarm notifications when a battery driver provides that telemetry; System Alarm Status summarizes the fleet as OK, Warning or Fault

State of charge (SOC) is the battery's remaining usable energy. The battery management system (BMS) applies the device's own cell and safety limits in addition to Omnibattery's software controls.

Disclaimer

Liability disclaimer

This software is provided "as is", without warranty of any kind. Use is at your own risk. The developer assumes no responsibility for damage to batteries, inverters, electrical installations, financial losses or personal injury.

If you do not agree to these terms, do not install or use this integration.

Support

If you find this integration useful, you can support the project:

Buy Me A Coffee