2025-07-23 12:55:49 +02:00
2025-07-21 15:44:14 +02:00
2025-07-21 15:44:14 +02:00
2025-07-21 15:44:14 +02:00
2025-07-21 15:18:34 +02:00
2025-07-21 15:44:14 +02:00

Futurehome Home Assistant add-on

Futurehome add-on for Home Assistant. The add-on aims to be a complete drop-in replacement for the official Futurehome app, implementing support for all Futurehome-supported device types.

Features

This plugin:

  1. Fetches all devices metadata from Futurehome hub and maps them to Home Assistant Devices/Entities.
  2. Fetches and updates devices state.
  3. Fetches and updates devices availability.

Installation

  1. Configure Local API in Smarthub settings in Futurehome app.
  2. Block internet access (WAN) for the hub in your router settings (optional, but strongly recommended to block any future hub firmware updates).
  3. In Home Assistant Add-on store install and start Mosquito MQTT broker (if you haven't already) (todo: is it really needed? or will it be installed automatically when enabling the mqtt integration?).
  4. In Home Assistant enable MQTT integration (if you haven't already).
  5. Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.
  6. Search for "Futurehome" in add-on store.
  7. Install, configure, and run Futurehome add-on.

Futurehome Device Services Compatibility Chart

This chart lists all services supported by the Futurehome hub, along with their current implementation status.

Devices commonly consist of multiple services: for example, a presence sensor might expose a sensor_presence service with a presence (true/false) value, and also a battery service if it is battery-powered.

Some services are more common than others. Some are deprecated entirely.

todo add more services todo document which services are not documented in github FIMP api and are only present in reverse engineered app code (app store/play store) | Service | Example device | Implemented in any capacity | Full implementation verified | todo change columns | --- | --- | --- | --- | | alarm_appliance | | | | | alarm_burglar | | | | | alarm_emergency | | | | | alarm_fire | | | | | alarm_gas | | | | | alarm_health | | | | | alarm_heat | | | | | alarm_lock | | | | | alarm_power | | | | | alarm_siren | | | | | alarm_system | | | | | alarm_time | | | | | alarm_water | | | | | alarm_water_valve | | | | | alarm_weather | | | | | appliance | | | | | barrier_ctrl | | | | | basic | | | | | battery | | | | | blinds | | | | | boiler | | | | | chargepoint | Futurehome Charge | | | | color_ctrl | | | | | complex_alarm_system | | | | | door_lock | | | | | doorman | | | | | fan | | | | | fan_ctrl | | | | | fire_detector | | | | | garage_door | | | | | gas_detector | | | | | gate | | | | | gateway | | | | | heat_detector | | | | | heat_pump | | | | | heater | | | | | input | | | | | leak_detector | | | | | light | | | | | media_player | | | | | meter | | | | | meter_elec | HAN-Sensor | | | | meter_gas | | | | | meter_water | | | | | out_bin_switch | | | | | out_lvl_switch | Smart LED Dimmer | | | | power_regulator | | | | | scene_ctrl | | | | | sensor | | | | | sensor_accelx | | | | | sensor_accely | | | | | sensor_accelz | | | | | sensor_airflow | | | | | sensor_airq | | | | | sensor_anglepos | | | | | sensor_atmo | | | | | sensor_baro | | | | | sensor_co | | | | | sensor_co2 | | | | | sensor_contact | | | | | sensor_current | | | | | sensor_dew | | | | | sensor_direct | | | | | sensor_distance | | | | | sensor_elresist | | | | | sensor_freq | | | | | sensor_gp | | | | | sensor_gust | | | | | sensor_humid | | | | | sensor_lumin | | | | | sensor_moist | | | | | sensor_noise | | | | | sensor_power | | | | | sensor_presence | | | | | sensor_rain | | | | | sensor_rotation | | | | | sensor_seismicint | | | | | sensor_seismicmag | | | | | sensor_solarrad | | | | | sensor_tank | | | | | sensor_temp | | | | | sensor_tidelvl | | | | | sensor_uv | | | | | sensor_veloc | | | | | sensor_voltage | | | | | sensor_watflow | | | | | sensor_watpressure | | | | | sensor_wattemp | | | | | sensor_weight | | | | | sensor_wind | | | | | siren | | | | | siren_ctrl | | | | | thermostat | Thermostat | | | | user_code | | | | | virtual_meter_elec | | | | | water_heater | | | | | water_valve | | | |

meta services: | association | | | | | diagnostic | | | | | indicator_ctrl | | | | | ota | | | | | parameters | | | | | dev_sys | | | | | technology_specific | | | | | time | | | | | version | | | |

todo add demo mode checkbox? sample data

Description
Futurehome add-on for Home Assistant. Designed to be a complete drop-in replacement for the official Futurehome app, with support for all device types compatible with the Futurehome hub. See the FAQ for more details.
Readme MIT 2.3 MiB
Languages
TypeScript 99.8%
JavaScript 0.1%