MELCloud Home v2.4.0-beta.1 - Real-Time Updates / Cloud Push - beta testers welcome

[andrew-blake]

I've just published v2.4.0-beta.1, the first beta of the real-time updates / Cloud Push release.

What's new

Real-time updates, on by default. Until now, changes made outside Home Assistant — the physical remote, the MELCloud Home app, a schedule — took up to a minute to show up (the polling interval). With v2.4.0 the integration listens for push updates from the MELCloud cloud, so changes appear in Home Assistant as soon as MELCloud knows about them — for most units that's within a few seconds. In short: Home Assistant is now as up to date as the MELCloud Home app.

One caveat: some setups (for example, ducted units with a wired wall controller) report changes to the cloud less promptly, so you may still see a delay there — that's the unit's WiFi adapter, not the integration, and the official app has the same lag.

There's nothing to set up. If the connection ever drops, the integration automatically falls back to the normal 60-second polling — your devices keep working either way.

Huge thanks to @mrdjtoto, who contributed this feature from the initial proposal and protocol investigation all the way through implementation.

How to tell it's working

• Change something with the remote or the MELCloud Home app — it should appear in Home Assistant about as quickly as it appears in the MELCloud Home app.
• There's a new "Real-time updates" sensor (in the Diagnostic section of the MELCloud Home device page) that shows whether the live connection is currently active.
• If you need to report a problem, please attach the integration's diagnostics download to the issue — it now includes details about the live connection.

How to turn it off

If you'd rather stick with polling only: Settings → Devices & Services → MELCloud Home → Configure → switch off "Real-time updates" → Submit.

Requires Home Assistant 2025.8.0 or newer

This release raises the minimum supported Home Assistant version to 2025.8.0. If you're on an older version, HACS will not offer you this update — upgrade Home Assistant first. Everything else keeps working in the meantime; you just won't see v2.4.0 until you upgrade.

Installing the beta

If you're comfortable running a beta, upgrade via HACS — no reconfiguration needed, your existing setup carries over on restart:

1. Open HACS → Integrations → MELCloud Home
2. Click the three-dot menu (top right) → Redownload
3. Select Need a different version?
4. Select v2.4.0-beta.1 and click Download
5. Restart Home Assistant

If you'd prefer to wait for the stable release, that's absolutely fine — I'm planning a few days of beta testing first.

Please report any issues as a new issue, and feel free to share feedback in this thread — especially how quickly changes from the remote or app show up for you.

Thanks for testing!