This Homebridge plugin provides accessories for Windmill Air Conditioners and Windmill Air Purifiers.
- Windmill AC - Full thermostat, fan control, and power consumption monitoring
- Windmill Air Purifier - Power, fan speed/mode, air quality monitoring, filter status, and additional controls
The AC plugin exposes a thermostat accessory, fan accessory, and power consumption sensor.
| HomeKit Mode | Windmill Mode |
|---|---|
| OFF | Turns off the air conditioner |
| HEAT | Fan |
| COOL | Cool |
| AUTO | Eco |
| HomeKit Speed | Windmill Speed |
|---|---|
| 0 | Auto |
| 1 - 33 | Low |
| 34 - 66 | Medium |
| 67 - 100 | High |
The AC exposes a light sensor that displays power consumption in watts (shown as "lux" in HomeKit). This is a common workaround since HomeKit doesn't have a native power meter characteristic.
The Air Purifier plugin exposes an air purifier accessory with air quality sensor, filter maintenance status, and additional control switches.
- Power On/Off - Turn the purifier on or off
- Fan Speed - Control the operating mode via the speed slider
- Air Quality Sensor - Real-time PM2.5 readings with quality levels
- Filter Status - Filter life percentage with change indicator (alerts when below 20%)
- Child Lock - Lock/unlock physical controls on the device
- Autofade - Toggle display auto-dimming
- Beeping - Toggle button sounds
- White Noise - Toggle between White Noise (ON) and Whisper (OFF) sleep sounds
| HomeKit Speed | Windmill Mode |
|---|---|
| 0 - 15 | Sleep |
| 16 - 30 | Low |
| 31 - 45 | Eco |
| 46 - 60 | Medium |
| 61 - 85 | High |
| 86 - 100 | Boost |
Based on EPA PM2.5 guidelines:
| PM2.5 (µg/m³) | HomeKit Quality |
|---|---|
| 0 - 12 | Excellent |
| 13 - 35 | Good |
| 36 - 55 | Fair |
| 56 - 150 | Inferior |
| 150+ | Poor |
Your Auth Token is visible directly in the Windmill Dashboard:
- Login to the Windmill Air Dashboard
- Navigate to Devices
- Your Auth Token is displayed in the Auth Token column for each device
Use the homebridge-config-ui-x plugin or HOOBS for the easiest setup experience.
Add entries to the accessories array in your Homebridge config.json:
{
"accessory": "HomebridgeWindmillAC",
"name": "Bedroom AC",
"token": "<YOUR_AC_AUTH_TOKEN>"
}{
"accessory": "HomebridgeWindmillAirPurifier",
"name": "Bedroom Air Purifier",
"token": "<YOUR_AIR_PURIFIER_AUTH_TOKEN>"
}{
"accessories": [
{
"accessory": "HomebridgeWindmillAC",
"name": "Bedroom AC",
"token": "<YOUR_AC_AUTH_TOKEN>"
},
{
"accessory": "HomebridgeWindmillAC",
"name": "Living Room AC",
"token": "<YOUR_AC_AUTH_TOKEN>"
},
{
"accessory": "HomebridgeWindmillAirPurifier",
"name": "Bedroom Air Purifier",
"token": "<YOUR_AIR_PURIFIER_AUTH_TOKEN>"
},
{
"accessory": "HomebridgeWindmillAirPurifier",
"name": "Living Room Air Purifier",
"token": "<YOUR_AIR_PURIFIER_AUTH_TOKEN>"
}
]
}- Verify your Auth Token is correct
- Check that your device is online in the Windmill Dashboard
- Ensure your Homebridge server has internet access
The filter change indicator will alert you when filter life drops below 20%. Replace your filter and the status will update automatically.
This is expected. HomeKit doesn't have a native power meter, so we use a light sensor where the "lux" value represents watts. Third-party apps like Eve may display this more intuitively.
# Install dependencies
npm install
# Build
npm run build
# Lint
npm run lint- Added Air Purifier support
- Added PM2.5 air quality sensor
- Added filter life monitoring
- Added child lock control
- Added autofade, beeping, and white noise switches for Air Purifier
- Added power consumption monitoring for AC
- Fixed fan speed behavior when changing modes
- Improved temperature handling
- Initial release with AC support
Apache-2.0