homebridge-mrcool-smartlight

Homebridge plugin for local control of MrCool HVAC units via the SmartLight SLWF-01 Pro bridge, using reverse-engineered local REST and Server-Sent Events (SSE) endpoints.

Features

- Local (LAN-only) control; no cloud dependency
- Set mode, fan speed, target temperature
- Optional vane swing control
- Beeper enable/disable
- Live state sync via SSE
- Debounced command dispatch with acknowledgement validation

Installation (after publish)

``
npm install -g homebridge-mrcool-smartlight
`

Or add to your Homebridge instance package.json:
`
"dependencies": {
"homebridge-mrcool-smartlight": "~0.1.0"
}
`
Then run npm install and restart Homebridge.

Configuration


Add to config.json platform section:
`
{
"platform": "MrCoolSmartLight",
"name": "MrCool",
"host": "192.168.1.50",
"pollInterval": 30,
"sse": true,
"swing": true,
"beeper": false
}
`

| Field | Description | Default |
|-------|-------------|---------|
| host | IP of SmartLight bridge | required |
| pollInterval | Fallback poll seconds if SSE drops | 30 |
| sse | Enable SSE realtime updates | true |
| swing | Expose swing control | false |
| beeper | Leave beeper enabled | false |

Development


`
npm install
npm run build
npm pack
`

Release

`
npm version patch # or minor / major
npm publish --access public
``

License

MIT