Skip to content

Dimplex Hub for Home Assistant

Unofficial project — not affiliated with Dimplex

This integration is not affiliated with, endorsed by, or supported by Dimplex, Glen Dimplex Heating & Ventilation, or the Glen Dimplex Group. It is an independent community project built by reverse-engineering the official Dimplex Control Android app and the private cloud API it talks to.

There is no public or documented API. Dimplex can change or withdraw that API at any time and without notice, which may break this integration. Use it at your own risk.

Please do not contact Dimplex support about this integration — open an issue instead.

Control and monitor Glen Dimplex electric heating from Home Assistant. The integration talks to the Dimplex cloud, discovers your hub, zones and appliances, and exposes them as native entities — a thermostat per heater, dual-rate energy for the Energy Dashboard, and the appliance's engaged modes broken out so you can see what the heater is actually doing.

Install it Browse the entities

Start here

Install

HACS or manual, then restart and add the integration.

Connect your account

Email and password, or a browser auth code if that fails.

Modes & presets

What boost, away, advance and frost protection actually do — and why one Home Assistant preset cannot show all of them.

Temperature & schedules

How a setpoint is written, why "off" reports 7 °C, and what the cloud will not let you change.

Energy monitoring

Daily kWh history with T1 and T2 tariffs kept apart.

What you get

Climate control

A thermostat per appliance: target temperature, heat/off, and boost / away / eco presets. Setting a target uses the cloud's dedicated setpoint endpoint, so your timer schedule is left alone.

Mode visibility

The appliance holds a bitfield of modes and several can be engaged at once. Four diagnostic sensors surface boost, away, frost protection and advance individually, so a mismatch cannot hide behind a single preset.

Dual-rate energy

Daily kWh history per register. T1 and T2 are never summed, so off-peak and peak stay separate in the Energy Dashboard.

Stays connected

Tokens refresh automatically, polling backs off when heaters are idle, and re-authentication uses Home Assistant's built-in reauth flow.

Reference

Entities

Every entity, what it reads, and which are disabled by default.

Actions

The dimplex.* actions, their fields and accepted ranges.

Options

Platform toggles, poll intervals and what is stored in the config entry.

Troubleshooting

Setup failures, unavailable entities, and symptoms with known causes.

Appliance support

What is verified against hardware, inferred from the official app, and untested.

Before you file a bug

A diagnostics download decodes the appliance's engaged modes by name, which is usually enough to explain behaviour that looks wrong. Attaching one turns a long back-and-forth into a single reply.

Not every appliance family is equally tested

Panel heaters and QRAD are exercised regularly. Quantum storage heaters behave differently — a target does nothing until there is stored charge — and hot water cylinder support exists in the underlying library but has never been run against hardware. See appliance support for what is verified, inferred and untested.

Trademarks and attribution

"Dimplex", "Quantum", "QRAD", "Glen Dimplex" and related names and marks are the property of their respective owners. They are used throughout this documentation only to describe which hardware and cloud service this integration is compatible with, and do not imply any affiliation, sponsorship or endorsement.

Both this integration and the dimplex-controller Python client underneath it were produced by observing the official Dimplex Control Android app, its network traffic and its decompiled source, in order to interoperate with hardware the authors own. Neither ships any Dimplex code.

This project is licensed MIT and is provided without warranty of any kind.