- hero.png (132.81 KiB) Viewed 137 times
I built it because the Home Connect app is fine for a quick look on your phone, and no help at all for the house around it. It can't tell Domoticz that the washer is done so the dryer reminder goes out, it doesn't keep a history of what the dishwasher uses, and it doesn't let a script start the dishwasher when the solar panels are producing. Domoticz does all of that well; it just couldn't see the appliances.
What it does
- Finds every appliance on your Home Connect account by itself and gives it its own set of devices, named after the name you gave it in the app
- Live state from Home Connect's event stream, so State, Program, Progress, Remaining time and the ready time follow within seconds instead of on a polling interval
- One State tile per appliance that reads like a sentence, for example Running, Cotton or Paused, Eco 50°, coloured by what it needs from you
- A Status code device with a fixed number per state, so a dzVents or Lua script keeps working whatever language the devices are in
- Appliance messages such as Program finished, Rinse aid nearly empty or Preheat finished as alert devices you can put a notification on
- The program's options and the appliance's settings as devices of their own, and every other value the appliance reports as a hidden device you can unhide
- For the washing machine: lifetime energy, water, detergent and softener as real Domoticz meters, so you get use per day, month and year
- Device names and values in English or Dutch
Devices
Everything is created automatically after you sign in. Every appliance gets the devices that fit it (a fridge has no programs, so it gets no program devices):
Code: Select all
Device | What it shows
------------------|------------------------------------------------------------
State | What it does, with the program: "Running, Cotton"
Power, Door | On/off and door contact
Remote control | Whether Domoticz may start it: "Remote start allowed"
Program | Running program and ready time: "Cotton, ready at 14:35"
Progress | Percentage of the running program
Remaining time | Minutes until it ends
Program choice | The selected program (selects it when control is on)
Actions | Start, Stop, Pause, Resume (control only)
Start at/Ready at | A clock time for a delayed start (control only)
Acknowledge | Confirms a message on the appliance (control only)
Status code | The state as a fixed number for scripts (hidden)
Total ... used | Washer: energy (kWh), water (L), detergent and softener (ml)
Code: Select all
Washer State Running, Cottons, Locked
Washer Program Cottons, ready at about 14:03
Washer Remaining time 47 min Progress 24%
Washer Remote control Remote start allowed
Washer Total water 1565 L (today 77 L)
Washer Total energy 11.780 kWh (today 0.425 kWh)
Dryer State Running, Cotton
Dryer Program Cotton, ready at about 14:15
Dishwasher Program Eco 50° (selected)
Oven Cavity temperature 31.0 C
Control is opt-in. There is an "Allow control" setting that is off by default; while it is off, every command is refused and the control devices stay hidden. Turn it on and you can choose a program, change its options, and start, stop, pause or resume it, also from scenes, timers and scripts. A delayed start is a clock time ("start at 02:30" for a dishwasher, "ready at 18:00" for a washer), and you can move it while the appliance waits.
Home Connect itself adds a safety step you can't skip: an appliance only accepts a start while remote start is switched on at the appliance, usually a button you press when you load it. So nothing starts that nobody prepared.
Every command is checked before it is sent. The plugin knows the program's allowed values and the appliance's state, so a start with the door open, a temperature out of range or a program while the oven is off is refused locally, with a message that says what to do next (The door of Dishwasher is not closed, Oven is switched off; switch it on first). That message also appears briefly at the top of the Domoticz screen (Domoticz 2026.1 or newer, can be turned off).
- notification.png (5.87 KiB) Viewed 137 times
- Your appliances in the Home Connect app
- A free account on developer.home-connect.com with the same email address as your Home Connect app account, and an application of type Device Flow registered there (the docs walk you through it, about 15 minutes the first time)
- Domoticz with the Python plugin system, 2026.4 or newer recommended; Python 3.11 or newer
- Internet access from the Domoticz machine to the Home Connect cloud
Standard library only, so there is nothing to pip install.
Install
Code: Select all
cd /opt/domoticz/plugins
git clone -b dist https://github.com/Rouzax/home-connect-domoticz-plugin homeconnect
sudo systemctl restart domoticzScreenshots
- washer-cards.png (137.62 KiB) Viewed 137 times
Installation, every setting, every device, control, a troubleshooting page organised by what you see, and security notes on what the plugin stores:
https://rouzax.github.io/home-connect-domoticz-plugin/
This is a beta, and I'd like help with
It runs every day here on a washer, a dryer, a dishwasher, a steam oven and a combination oven with microwave, and control was tested on real appliances. Other appliance types (fridges and freezers, coffee machines, hoods, cooktops, washer-dryers, cleaning robots) should work, because the plugin builds its devices from what the appliance reports rather than from a fixed list, but I haven't seen them myself. If you have one, I'd like to know how it looks, and the appliance support form on GitHub asks for exactly what helps. Bugs and ideas are welcome in the GitHub issues; the repository is the one in the install command above.
