homebridge-modern-forms

Modern Forms Homebridge Plugin

Add support for Modern Forms fans to Homekit using Homebridge.

Prerequisites

• Have Homebridge setup

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
}