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