homebridge-rainbird-sprinklers

Homebridge platform plugin for RainBird ESP-TM2 irrigation controllers with LNK WiFi module.

Exposes each zone as an irrigation valve in HomeKit, with optional rain sensor support.

Requirements

• RainBird ESP-TM2 (or compatible) controller
• RainBird LNK WiFi module connected to the same network
• Homebridge v2.0.0 or later

Installation

Install via the Homebridge UI or manually:

npm install -g homebridge-rainbird-sprinklers

Configuration

Add the platform to your Homebridge config.json:

{
  "platform": "RainBirdSprinklers",
  "name": "RainBird",
  "host": "192.168.1.100",
  "password": "your-rainbird-password",
  "rainSensor": true,
  "rainSensorName": "Rain Sensor",
  "zones": [
    { "id": 1, "name": "Front Garden", "defaultDuration": 10 },
    { "id": 2, "name": "Back Garden", "defaultDuration": 15 },
    { "id": 3, "name": "Side Garden", "defaultDuration": 10 }
  ]
}

| Option | Type | Required | Description | |--------|------|----------|-------------| | host | string | yes | IP address of the RainBird LNK WiFi module | | password | string | yes | Password configured in the RainBird app | | rainSensor | boolean | no | Expose rain sensor as a leak sensor (default: true) | | rainSensorName | string | no | Name for the rain sensor accessory (default: "Rain Sensor") | | zones | array | yes | List of zones to expose | | zones[].id | number | yes | Zone number (1-based) | | zones[].name | string | yes | Display name in HomeKit | | zones[].defaultDuration | number | no | Default run time in minutes (default: 10) |

HomeKit Accessories

Each zone is exposed as an Irrigation Valve accessory with:

• On/off control
• Adjustable duration (via the HomeKit timer slider)
• Remaining duration countdown

The rain sensor (if enabled) is exposed as a Leak Sensor — active when rain is detected, which can be used in HomeKit automations to prevent irrigation when it rains.

Child Bridge

It is recommended to run this plugin as a child bridge for better stability. Enable this in the Homebridge UI under the plugin settings.