2025-07-23 23:19:06 +02:00
2025-07-21 15:44:14 +02:00
2025-07-21 15:44:14 +02:00
2025-07-23 21:20:40 +02:00
2025-07-21 15:18:34 +02:00
2025-07-23 23:19:06 +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:

  • Fetches all devices metadata from Futurehome hub and maps them to Home Assistant Devices/Entities.
  • Fetches and updates devices state.
  • Fetches and updates devices availability.
  • Supports interacting with the devices as well as the official Futurehome app did.
  • Supports pairing new Zigbee/Z-Wave/Futurehome devices (if an offchance you used any third party integration like Phillips Hue you will be able to interact with it as long as its paired with the hub. However it's recommended to directly use the appropriate Home Asisstant integration for such devices).

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 enable MQTT integration.
  4. Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.
  5. Search for "Futurehome" in add-on store.
  6. 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 periodical refresh of devices todo periodical refresh of state

Service Example device Implementation status
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
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_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

| gateway | | | | sensor | | | | association | | | | diagnostic | | | | indicator_ctrl | | | | ota | | | | parameters | | | | technology_specific | | | | time | | | | version | | | | dev_sys | | |

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%