Skip to content
This repository has been archived by the owner on Jan 7, 2022. It is now read-only.

nickbreaton/homebridge-modern-forms

Repository files navigation

Modern Forms Homebridge Plugin

Add support for Modern Forms fans to Homekit using Homebridge.

Prerequisites

Setup

  1. Add any fans you'd like to control to your home network.

    1. Download the Modern Forms iOS or Android app.
    2. Follow the instructions to pair your fan.
    3. Verify your fans show up in the app and can be controlled.
    4. Optionally, delete the app.
  2. Add the following to your Homebridge config.json under platforms.

    {
        "platform": "ModernForms"
    }
  3. Verify your config.json looks similar to the following.

    {
        "bridge": {
            "name": "Name",
            "username": "XX:XX:XX:XX:XX:XX",
            "port": 00000,
            "pin": "000-00-000"
        },
        "platforms": [
            {
                "platform": "ModernForms"
            }
        ]
    }
  4. You’re all set! Any fans you saw in the Modern Forms app should appear in the Home app automatically.

Configuration

Specifying Fan IP Addresses

If any of your fans are not automatically found, try specifiying their IP addresses in the following format.

{
    "platform": "ModernForms",
    "fans": [
        {
            "ip": "192.168.0.10"
        },
        {
            "ip": "192.168.0.11"
        }
    ]
}

Disabling Auto Discovery

If you would like to disable the automatic discovery of fans on your network, specify the following option. You will need to specify the IP address of your fans manually as shown above.

{
    "platform": "ModernForms",
    "autoDiscover": false
}

About

Add support for Modern Forms fans to Homekit using Homebridge.

Topics

Resources

License

Stars

Watchers

Forks