This integration has moved — Marstek Venus Energy Manager is now Omnibattery
New repo: GitHub - ffunes/Omnibattery: Custom integration to monitor and control Marstek Venus and Zendure batteries in Home Assistant. · GitHub
New thread: [Custom Integration] Omnibattery - One integration for pluggable solar batteries
Development continues under a new name. It’s the same integration and the same author — but
it now also drives Zendure SolarFlow (2400 AC+ / Pro) alongside Marstek, and can run
both brands in the same install, so a Marstek-only name no longer made sense.
Nothing is lost when you move. Your configuration, entity IDs (they stay
marstek_venus_*), recorder history, long-term statistics, dashboards and automations are
all preserved.
How to migrate
HACS can’t rename an integration’s domain in place, so this isn’t an in-place update — you
install the new repo and migrate across. One step matters more than the rest:
Update this integration to v2.0.6 and restart BEFORE anything else.
That release silently writes a recovery snapshot of your full configuration to
.storage, and that snapshot is what survives the domain change. If you skip it and HACS
removes the old entries, you may have to reconfigure everything from scratch.
Then:
- HACS → Custom repositories → add
https://github.com/ffunes/omnibattery
(type: Integration) and install it. Leave the old repo in place for now.
- Restart Home Assistant.
- Settings → Devices & Services → Add Integration → Omnibattery. It detects your
existing config and shows a confirmation screen — confirm to run the migration. It
recreates your entries on the new domain, repoints every entity without changing its ID,
and copies the stored data (daily energy totals, accumulators, balance history).
- Once Omnibattery is running, remove the old integration and repository from HACS.
- Ctrl+F5 so the renamed sidebar panel loads.
Take a full HA backup first (Settings → System → Backups). And if you already deleted
the old integration: the snapshot from step 0 still survives — the setup flow will find it
and offer to restore from it.
Support moves too
The old repo is now archived / read-only for issues. From here on:
Issues · ffunes/Omnibattery · GitHub
Please don’t post bugs in this thread (or the new one) — forum threads have no tracking, no
state and no way to tell an open bug from a fixed one, so reports posted here get buried and
lost. A GitHub issue gets labelled, linked to its fix, and closed where the next person can
find it. Attach diagnostics + debug logs and I’ll actually see it.
Thanks to everyone who tested, reported and contributed here. See you in the new thread. 