Cool Automation
homebridge-cool-automation · v2.2.3
Adds Cool Automation CoolMaster HVAC controller units to HomeKit as AC, fan and dehumidifier accessories.
What it says it supports
Brands
- Cool Automation
- CoolMaster
Devices it names
- Cool Master hub
Shows up in Apple Home as from its README
What people report
Works with CoolMasterNet units that expose the local TCP API; Cloud Only mode units cannot work.
- Works1
- Won’t be supported1
| Device | Status | What they said | Source |
|---|---|---|---|
| CoolMasterNet | Works | Maintainer and user confirm it works; multi-unit off-scene bug fixed in v2.1.0Saved copyDoes this plugin also work for the CoolMasterNet: http://www.coolmasternet.co.uk/ Thanks! Excerpt saved from GitHub on 2026-10-22. | Issue #8 · 2021-10 |
| CoolMaster (Cloud Only mode) | Won’t be supported | Cloud Only models/firmware expose no local API, so plugin cannot control themSaved copyThis is a product limitation. The plugin uses CoolMasterNet's local API on TCP port 10102 to read and control devices. Some Coolmaster device models / firmwares run in "Cloud Only" mode (no local API exposed), and unfortunately there is no way for the plugin to control those. If you want to use the Cool Automation hardware with this Homebridge plugin, you need a CoolMasterNet variant that has the local API enabled. Check with Cool Automation support whether your unit can have local API enabled on its current firmware, or whether you need a different model. Sorry for the long delay on this. I … Excerpt saved from GitHub on 2026-10-22. | Issue #17 · 2024-11 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local
Cool Master hub over IP, port 10102
You’ll need
- Cool Master hub IP address
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | ^1.8.0 || ^2.0.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^22.10.0 || ^24.0.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | CoolAutomation |
| License | GNU |
Community signals
| Downloads a week | 1 |
|---|---|
| Downloads a month | 55 |
| GitHub stars | 6 |
| Open issues | 0 |
| Closed issues | 22 |
| Last code push | 2026-05-13 |
| Latest version | 2.2.3 (2026-05-13) |
| First published | 2020-12-09 |
| Releases | 20 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- Fanv2
- HeaterCooler
- HumidifierDehumidifier
