Homebridge Phyn

A Homebridge plugin for Phyn Smart Water Assistant and Phyn Plus devices. Exposes your water monitors to Apple Home with real-time state updates.

For Users

Installation

npm install -g homebridge-phyn

Configuration

We highly recommend configuring this plugin using the Homebridge Config UI X interface.

Credentials

The credentials required for this plugin are the exact same Email Address and Password you use to log into the official Phyn app on iOS or Android.

Discovering your Device ID

By default, the plugin will map all homes and devices to your Apple Home. If you wish to configure specific devices differently (such as disabling the valve control on one specific monitor), you must provide the Device ID.

When the plugin starts up, it logs the ID of every device it discovers in the Homebridge console. Example: Adding new accessory: Main Water Line [ID: 01234567-89ab-cdef-0123-456789abcdef]. Copy this ID into the Config UI.

Manual Configuration (config.json)

{
    "platforms": [
        {
            "platform": "PhynPlatform",
            "name": "Phyn",
            "email": "[email protected]",
            "password": "your_phyn_password",
            "temperatureUnit": "F",
            "enableValve": true,
            "enableLeakSensor": true,
            "enableTemperatureSensor": true,
            "enableHumiditySensor": true,
            "devices": [
                {
                    "deviceId": "01234567-89ab-cdef-0123-456789abcdef",
                    "enableValve": false,
                    "enableLeakSensor": true
                },
                {
                    "deviceId": "fedcba98-7654-3210-fedc-ba0987654321",
                    "enableValve": true
                }
            ]
        }
    ]
}