2024.12.5
Home ▸ Integrations ▸

Modern Forms

Modern Forms has a line of smart Wi-Fi-connected fans that allow for cloud or local control of the fan and light. There is support for individual sleep timers for the fan and light that can be set and cleared independently.

Configuration

To add the Modern Forms integration to your Home Assistant instance, use this My button:

Modern Forms can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Modern Forms.

  • Follow the instructions on screen to complete the setup.

Note

If the Modern Forms fan does not have a light unit installed, then the Light entities and actions will not show up.

Fans

The Modern Forms integration has support for the Modern Forms fans. This includes directional support, and sleep timer actions for the fan.

Lights

The Modern Forms integration has support for the Modern Forms fans light. This includes brightness, and sleep timer actions for the light.

Binary sensors

The Modern Forms integration provides binary sensors for the following information:

  • Fan sleep timer active status
  • Light sleep timer active status

Sensors

The Modern Forms integration provides sensors for the following information:

  • Fan sleep timer time expiring
  • Light sleep timer time expiring

Switches

The Modern Forms integration provides support for the following toggleable attributes of a fan:

  • Away mode - to allow the fan simulate someone being home.
  • Adaptive learning - for allow learning for away mode.

Actions

Action modern_forms.clear_fan_sleep_timer

This action will clear the sleep timer for the fan if it has been set. It will not turn off the fan when the timer is cleared.

Action modern_forms.clear_light_sleep_timer

This action will clear the sleep timer for the light if it has been set. It will not turn off the light when the timer is cleared.

Action modern_forms.set_fan_sleep_timer

This action will set a sleep timer for the fan. When the sleep timer is expired it will turn off the fan.

Data attribute Required Description
sleep_time yes The amount of time in minutes to set the sleep timer for. This is time in minutes from 1 to 1440 (1 day).

Action modern_forms.set_light_sleep_timer

This action will set a sleep timer for the light. When the sleep timer is expired it will turn off the light.

Data attribute Required Description
sleep_time yes The amount of time in minutes to set the sleep timer for. This is time in minutes from 1 to 1440 (1 day).

Note

Modern Forms Fans use NTP to pool.ntp.org in order to set its internal clock and check of sleep timers have expired. Sleep timers will only work if the Modern Forms Fans have internet NTP access. You can block off cloud access for the fan and only leave NTP (UDP port 123) outbound working for the sleep timers.