homebridge-aquacell

Homebridge plugin for Culligan AquaCell water softeners (Mijn AquaCell app).

Shows salt levels for both compartments in Apple HomeKit so everyone at home can see when salt needs refilling.

Uses the same reverse-engineered cloud API as the Home Assistant AquaCell integration and aioaquacell library by Jordi Epema.

HomeKit accessories

| Accessory | Type | Value | |-----------|------|-------| | Zout links / rechts | Humidity sensor | Salt % (0–100) | | Dagen zout resterend | Light sensor* | Days until empty | | Zout OK links / rechts | Contact sensor | Closed = enough salt, Open = refill needed | | i-Lid batterij | Battery | % | | i-Lid dicht | Contact sensor | Closed = lid on sensor |

*HomeKit has no "days remaining" sensor — days are exposed via Light Sensor (numeric value = days).

Installation

npm install -g homebridge-aquacell

Or via Homebridge UI → Plugins → search AquaCell.

Configuration

{
  "platform": "AquaCell",
  "name": "AquaCell",
  "username": "[email protected]",
  "password": "your-password",
  "softenerDsn": "",
  "pollInterval": 3600,
  "lowSaltThreshold": 15,
  "_bridge": {
    "name": "Homebridge AquaCell",
    "username": "0E:XX:XX:XX:XX:XX",
    "port": 51220
  }
}

| Option | Description | |--------|-------------| | username / password | Mijn AquaCell app credentials | | softenerDsn | Optional device serial (auto-discovered if empty) | | pollInterval | Seconds between API polls (default 3600) | | lowSaltThreshold | Contact sensor triggers at or below this % (default 15) |

Discovery

[email protected] AQUACELL_PASS=secret npm run discover

Notes

• The softener reports to the cloud about once per day — values won't change every minute.
• Requires WiFi setup via the official Mijn AquaCell app first.
• Supports dual-compartment models (left/right salt blocks).

License

MIT