Homebridge Pentair IntelliCenter

This is a plugin to integrate your Pentair IntelliCenter (1.064+) setup with Homebridge (in order to integrate it with Apple Home and Siri).

If you like this sort of thing, you might also be interested in "Pentameter". It polls, logs, and creates a visual dashboard for your Pentair IntelliCenter setup! A Docker Compose file is provided for one-command deployment.

Development and Testing

This is a fork of Windscar/homebridge-pentair-intellicenter, which itself is a fork of dustindclark/homebridge-pentair-intellicenter. dustindclark's original seems to have not been actively maintained since 2023. Windscar forked it and made a few updates, but has issues disabled and doesn't seem to accept pull requests. With great gratitude to both of them, I'm breaking this out into a repository that "I"* can actively maintain.

*All code is AI-generated (currently Claude Code) and directed, overseen, and tested by me. If running stuff from the internet scared you, this might horrify you.

I have all of the security doodads GitHub offers (dependency updates, code scans, etc.) enabled. I've cleared all issues, and aim to keep them clear.

I have a dual-body setup with a pool (IntelliFlo VSF pump, cleaner pump, heat pump, lights, and fountain feature) and spa (IntelliFlo VS pump, air blower, gas heater, lights). All testing is done on that using firmware 3.004+ (actively maintained and tested).

Features and Functionality

Exposes all bodies, all features, and any circuits marked as features in IntelliCenter. Knows power curves for VF and VSF pumps and exposes virtual lights to report RPMs (actual), watts (estimated), and GPM (estimated on VSF only).

Configuration Options

Yes, you need your local IP and your IntelliCenter login. If you enable the option to show VSPs they will expose as a fan that you can use to adjust between your system-configured min/max. It might also blow away your system-configured RPM settings. I consider this feature especially risky and personally disable it. Outside air temp is hopefully straightforward. There is also an option to expose all circuits — while tempting, doing this results in dozens of things getting exposed in Apple Home for me and I only use it for debugging.

Roadmap

• Pressure-testing auth necessity: Investigate whether authentication is truly required for all operations or if some functionality can work without credentials
• Info logging cleanup: Review and reduce excessive .info() logging statements throughout the codebase to improve log clarity and reduce noise
• More robust thermal state detection: Enhance heater state detection to better handle edge cases and provide more accurate heating/cooling status reporting

Local Development

For developers who want to test changes locally using Docker:

Quick Setup

1. Copy the template config:

   cp homebridge-config/config.template.json homebridge-config/config.json

2. Edit homebridge-config/config.json and replace:

   • YOUR_INTELLICENTER_IP with your IntelliCenter's IP address
   • YOUR_USERNAME with your IntelliCenter username
   • YOUR_PASSWORD with your IntelliCenter password

3. Build and start:

   ./start-dev.sh

4. Access Homebridge UI: http://localhost:8581 (default login: admin/admin)

Development Workflow

Initial Setup:

1. Install the plugin via Homebridge UI first (from npm registry)
2. Configure it with your IntelliCenter details

Testing Local Changes:

# Test your local code changes without publishing
./test-local.sh

This script:

• Builds your local plugin (npm run build)
• Copies the dist/ files directly into the running container's plugin directory
• Restarts Homebridge to load your changes
• Shows you how to watch for your specific logs

Other useful commands:

# View logs:
# For Docker:
docker compose logs -f homebridge

# For nerdctl (Rancher Desktop):
nerdctl compose logs -f homebridge

# Stop the environment:
./stop-dev.sh

# Watch for specific plugin logs:
nerdctl compose logs -f homebridge | grep "temperature range"

Note: Your config.json with real credentials is gitignored and won't be committed.