Warning

This project is no longer maintained.

I originally created this as a small side project while living in a rental unit that had a Modern Forms fan. I have since moved and don’t have any devices that can be used to test changes. Due to this, I will not be pushing any further updates.

Please refrain from reaching out regarding changes. The code is available free of charge; you are more than welcome to fork and distribute it under a new package name.

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
}