homebridge-alula-connectpro

A Homebridge dynamic-platform plugin for Alula Connect and Connect+ Pro cloud security panels, including systems sold through Cove.

This is an independent interoperability project. It is not affiliated with, endorsed by, or supported by Alula or Cove.

Features

• Live panel state over the Alula WebSocket API.
• HomeKit Security System with Stay, Away, Night, and Disarm.
• Contact sensors for configured doors and windows.
• Leak, smoke, and heat alarm accessories.
• Live open, bypass, alarm, tamper, low-battery, signal, and online state where exposed.
• Optional contact-zone bypass switches.
• OAuth refresh, reconnect, snapshot reconciliation, command acknowledgements, timeouts, serialization, and duplicate-command suppression.

Connect+ Pro firmware 0.1.6.0 has been live-tested with all four alarm modes and zone bypass/unbypass. Other Alula panel families may behave differently; reports and pull requests are welcome.

Safety

This plugin controls a safety-critical, potentially professionally monitored alarm.

• Keep the official application and keypad available.
• Put professional monitoring in test mode during setup and after upgrades.
• Do not repeatedly submit login credentials or PINs; the cloud and keypad rate-limit.
• Alarm control and zone bypass are disabled by default.
• Life-safety zones never receive bypass switches.

Requirements

• Homebridge 1.8 or newer (Homebridge 2 is recommended).
• Node.js 20, 22, or 24.
• An Alula/Cove account and, for control, the keypad PIN.

Installation

Search for homebridge-alula-connectpro in the Homebridge UI, or install it from a terminal:

npm install -g homebridge-alula-connectpro

Configuration

Configure the plugin through the Homebridge UI:

• Email or account number: the login used by the official application.
• Password: the account password.
• Arm/disarm PIN: the numeric keypad PIN; required only for alarm control.
• Enable alarm control: allows HomeKit to arm and disarm the panel.
• Add zone bypass switches: adds a bypass switch to contact-zone accessories.

Example (do not publish a real configuration):

{
  "platform": "AlulaConnectPro",
  "name": "Alula Connect Pro",
  "username": "YOUR_ACCOUNT",
  "password": "YOUR_PASSWORD",
  "pin": "YOUR_PIN",
  "enableControl": false,
  "enableZoneBypass": false
}

Credentials and the PIN are used locally by Homebridge to authenticate to Alula. They are never written to plugin logs.

Diagnostics

From a source checkout, read-only diagnostics are available without Homebridge:

npm install
npm run diagnose -- panels "YOUR_ACCOUNT" "YOUR_PASSWORD"
npm run diagnose -- status "YOUR_ACCOUNT" "YOUR_PASSWORD"

The status command prints sanitized protocol counters, not credentials or OAuth tokens.

Development

npm install
npm run lint
npm test

See CONTRIBUTING.md and SECURITY.md.

License

MIT