2025-07-21 15:20:40 +02:00
# Futurehome Home Assistant add-on
2025-08-02 10:26:43 +02:00
Futurehome add-on for Home Assistant, built using both public and reverse-engineered APIs. Designed to be a complete drop-in replacement for the official Futurehome app, with support for all device types compatible with the Futurehome hub.
2025-07-24 02:01:02 +02:00
2025-07-29 00:31:59 +02:00
2025-07-21 15:20:40 +02:00
2025-07-29 00:31:59 +02:00
2025-07-28 17:32:28 +02:00
2025-07-22 23:21:34 +02:00
## Features
2025-07-24 02:01:02 +02:00
This add-on:
2025-07-22 23:21:34 +02:00
2025-07-24 02:01:02 +02:00
* Fetches all device metadata from the Futurehome hub and maps them to Home Assistant devices/entities.
2025-07-24 20:54:06 +02:00
* Fetches and updates device states and availability in real time.
2025-07-24 02:01:02 +02:00
* Supports interaction with devices comparable to the official Futurehome app.
2025-07-28 16:12:12 +02:00
* Supports pairing and unpairing devices.
2025-07-24 02:53:11 +02:00
2025-07-29 00:31:59 +02:00
## Installation Guide
2025-07-21 23:14:23 +02:00
2025-07-29 00:31:59 +02:00
See the full [Installation Guide ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/docs/installation.md ) for step-by-step setup instructions.
2025-07-22 23:21:34 +02:00
# Futurehome Device Services Compatibility Chart
2025-07-24 02:01:02 +02:00
This chart lists all services supported by the Futurehome hub, along with their current implementation status.
2025-07-22 23:21:34 +02:00
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.
2025-07-24 02:01:02 +02:00
Some services are more common than others; some are deprecated entirely.
2025-07-22 23:21:34 +02:00
2025-07-26 20:55:19 +02:00
| Name | Service | Example device | Implementation status | Home Assistant entity |
| --- | --- | --- | --- | --- |
| Alarm | [alarm_appliance ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_alarm.ts ), [alarm_burglar ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_alarm.ts ), [alarm_emergency ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_alarm.ts ), [alarm_fire ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_alarm.ts ), [alarm_gas ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_alarm.ts ), [alarm_health ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_alarm.ts ), [alarm_heat ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_alarm.ts ), [alarm_lock ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_alarm.ts ), [alarm_power ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_alarm.ts ), [alarm_siren ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_alarm.ts ), [alarm_system ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_alarm.ts ), [alarm_time ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_alarm.ts ), [alarm_water ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_alarm.ts ), [alarm_water_valve ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_alarm.ts ), [alarm_weather ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_alarm.ts ) | [Brannvarsler ](https://www.futurehome.io/en_no/shop/brannvarsler-230v ) | ✅ | [Binary sensor ](https://www.home-assistant.io/integrations/binary_sensor/ ), [Button ](https://www.home-assistant.io/integrations/button/ ) |
| Blinds/door | [barrier_ctrl ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/barrier_ctrl.ts ) | | ✅ | [Cover ](https://www.home-assistant.io/integrations/cover/ ) |
| Battery | [battery ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/battery.ts )| | ✅ | [Sensor ](https://www.home-assistant.io/integrations/sensor/ ), [Binary sensor ](https://www.home-assistant.io/integrations/binary_sensor/ ) |
| Chargepoint | [chargepoint ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/chargepoint.ts ) | [Futurehome Charge ](https://www.futurehome.io/en_no/shop/charge ) | ✅ | [Sensor ](https://www.home-assistant.io/integrations/sensor/ ), [Switch ](https://www.home-assistant.io/integrations/switch/ ), [Number ](https://www.home-assistant.io/integrations/number/ ), [Select ](https://www.home-assistant.io/integrations/select/ ) |
2025-07-26 21:28:23 +02:00
| Color control | [color_ctrl ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/color_ctrl.ts ) | | ✅ | [Light ](https://www.home-assistant.io/integrations/light/ ) |
2025-07-27 01:38:18 +02:00
| Door lock | [door_lock ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/door_lock.ts ), [doorman ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/doorman.ts ) | [Yale Doorman ](https://www.assaabloy.com/ee/en/solutions/products/smart-locks/yale-doorman ) | ✅ | [Lock ](https://www.home-assistant.io/integrations/lock/ ), [Binary sensor ](https://www.home-assistant.io/integrations/binary_sensor/ ), [Switch ](https://www.home-assistant.io/integrations/switch/ ), [Number ](https://www.home-assistant.io/integrations/number/ ), [Button ](https://www.home-assistant.io/integrations/button/ ), [Select ](https://www.home-assistant.io/integrations/select/ ), [Sensor ](https://www.home-assistant.io/integrations/sensor/ ), [Text ](https://www.home-assistant.io/integrations/text/ ) |
2025-07-26 20:55:19 +02:00
| Fan | [fan_ctrl ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/fan_ctrl.ts ) | | ✅ | [Fan ](https://www.home-assistant.io/integrations/fan/ ) |
| Media player | [media_player ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/media_player.ts ) | | ✅ | [Select ](https://www.home-assistant.io/integrations/select/ ), [Number ](https://www.home-assistant.io/integrations/number/ ), [Switch ](https://www.home-assistant.io/integrations/switch/ ), [Image ](https://www.home-assistant.io/integrations/image/ ), [Sensor ](https://www.home-assistant.io/integrations/sensor/ ) |
2025-07-27 00:14:09 +02:00
| Meter | [meter_elec ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_meter.ts ), [meter_gas ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_meter.ts ), [meter_water ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_meter.ts ), [meter_heating ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_meter.ts ), [meter_cooling ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_meter.ts ) | [HAN-Sensor ](https://www.futurehome.io/en/shop/han-sensor ) | ✅ | [Sensor ](https://www.home-assistant.io/integrations/sensor/ ), [Button ](https://www.home-assistant.io/integrations/button/ ) |
2025-07-26 20:55:19 +02:00
| Binary switch | [out_bin_switch ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/out_bin_switch.ts ) | [16A Puck Relé ](https://www.futurehome.io/en_no/shop/puck-relay-16a ) | ✅ | [Switch ](https://www.home-assistant.io/integrations/switch/ ) |
| Level switch | [out_lvl_switch ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/out_lvl_switch.ts ) | [Smart LED Dimmer ](https://www.futurehome.io/en_no/shop/smart-led-dimmer-polar-white ) | ✅ | [Number ](https://www.home-assistant.io/integrations/number/ ) |
2025-07-26 22:44:17 +02:00
| Button | [scene_ctrl ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/scene_ctrl.ts ) | [Modusbryter ](https://www.futurehome.io/en_no/shop/modeswitch-white ) | ✅ | [Sensor ](https://www.home-assistant.io/integrations/sensor/ ), [Select ](https://www.home-assistant.io/integrations/select/ ) |
2025-07-29 00:48:24 +02:00
| Schedule entry | [schedule_entry ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/schedule_entry.ts ) | | ✅ | [Number ](https://www.home-assistant.io/integrations/number/ ), [Button ](https://www.home-assistant.io/integrations/button/ ), [Binary sensor ](https://www.home-assistant.io/integrations/binary_sensor/ ), [Sensor ](https://www.home-assistant.io/integrations/sensor/ ) |
2025-07-26 21:28:23 +02:00
| Binary sensor | [sensor_contact ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_binary.ts ), [sensor_presence ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_binary.ts ) | | ✅ | [Binary sensor ](https://www.home-assistant.io/integrations/binary_sensor/ ) |
| Numeric sensor | [sensor_accelx ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_accely ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_accelz ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_airflow ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_airq ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_anglepos ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_atmo ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_baro ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_co ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_co2 ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_current ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_dew ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_direct ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_distance ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_elresist ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_freq ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_gp ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_gust ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_humid ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_lumin ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_moist ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_noise ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_power ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_rain ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_rotation ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_seismicint ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_seismicmag ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_solarrad ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_tank ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_temp ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/_sensor_numeric.ts ), [sensor_tidelvl](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/s
2025-07-27 00:14:09 +02:00
| Siren | [siren_ctrl ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/siren_ctrl.ts ), [complex_alarm_system ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/complex_alarm_system.ts ) | [Brannvarsler ](https://www.futurehome.io/en_no/shop/brannvarsler-230v ) | ✅ | [Siren ](https://www.home-assistant.io/integrations/siren/ ), [Select ](https://www.home-assistant.io/integrations/select/ ), [Number ](https://www.home-assistant.io/integrations/number/ ), [Button ](https://www.home-assistant.io/integrations/button/ ), [Sensor ](https://www.home-assistant.io/integrations/sensor/ ) |
2025-07-27 01:38:18 +02:00
| Sound emitter | [sound_switch ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/sound_switch.ts ) | | ✅ | [Siren ](https://www.home-assistant.io/integrations/siren/ ) |
2025-07-26 20:55:19 +02:00
| Thermostat | [thermostat ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/thermostat.ts ) | [Thermostat ](https://www.futurehome.io/en_no/shop/thermostat-w ) | ✅ | [Climate ](https://www.home-assistant.io/integrations/climate/ ) |
2025-07-26 23:38:06 +02:00
| Keypad | [user_code ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/user_code.ts ) | | ✅ | [Sensor ](https://www.home-assistant.io/integrations/sensor/ ), [Binary sensor ](https://www.home-assistant.io/integrations/binary_sensor/ ), [Button ](https://www.home-assistant.io/integrations/button/ ), [Text ](https://www.home-assistant.io/integrations/text/ )|
2025-07-26 20:55:19 +02:00
| Water heater | [water_heater ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/water_heater.ts ) | | ✅ | [Water heater ](https://www.home-assistant.io/integrations/water_heater/ ) |
2025-07-24 02:01:02 +02:00
2025-07-27 00:31:18 +02:00
## Implemented system services
| Name | Service | Implementation status | Home Assistant entity |
| --- | --- | --- | --- |
2025-07-27 01:38:18 +02:00
| Fall-back Z-wave 'basic' service | [basic ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/basic.ts ) | ✅ | [Number ](https://www.home-assistant.io/integrations/number/ ) |
| Reboot device | [dev_sys ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/dev_sys.ts ) | ✅ | [Button ](https://www.home-assistant.io/integrations/button/ ) |
| Identify device | [indicator_ctrl ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/indicator_ctrl.ts ) | ✅ | [Button ](https://www.home-assistant.io/integrations/button/ ) |
| Advanced configuration of a device | [parameters ](https://github.com/adrianjagielak/home-assistant-futurehome/blob/master/futurehome/src/services/parameters.ts ) | ✅ | [Button ](https://www.home-assistant.io/integrations/button/ ), [Sensor ](https://www.home-assistant.io/integrations/sensor/ ), [Number ](https://www.home-assistant.io/integrations/number/ ), [Select ](https://www.home-assistant.io/integrations/select/ ), [Text ](https://www.home-assistant.io/integrations/text/ ) |
2025-07-27 00:31:18 +02:00
2025-07-29 00:46:35 +02:00
<!--
2025-07-27 01:28:48 +02:00
## Hub
2025-07-29 00:46:35 +02:00
| Name | Service | Implementation status | Description |
2025-07-27 01:28:48 +02:00
| --- | --- | --- | --- |
2025-07-29 00:46:35 +02:00
| Futurehome Smarthub | gateway | ✅ | Rebooting the hub.(wip) |
| ZigBee adapter | zigbee | ✅ | Pairing and unpairing devices. |
| Z-Wave adapter | zwave-ad | ✅ | Pairing and unpairing devices. |
| Other adapters | | ✅ | Unpairing devices. |
-->
2025-07-27 01:28:48 +02:00
2025-07-27 00:31:18 +02:00
## Other system, meta, unused, or not essential services
2025-07-24 02:01:02 +02:00
2025-07-25 01:07:19 +02:00
| Service | Description |
2025-07-24 02:01:02 +02:00
| --- | --- |
2025-07-27 01:28:48 +02:00
| association | Virtual association between devices. Easily reproducible using Home Assistant's built-in configuration. |
2025-07-26 23:06:00 +02:00
| battery_charge_ctrl | No devices or hub support this stub service. |
2025-07-27 00:31:18 +02:00
| diagnostic | Diagnostic (logging, etc) |
2025-07-26 23:06:00 +02:00
| inverter_consumer_conn | No devices or hub support this stub service. |
| inverter_grid_conn | No devices or hub support this stub service. |
| inverter_solar_conn | No devices or hub support this stub service. |
2025-07-27 00:31:18 +02:00
| ota | Managing OTA updates of devices |
2025-07-27 01:08:05 +02:00
| power_regulator | Automation. Easily reproducible using Home Assistant's built-in configuration. |
2025-07-27 00:31:18 +02:00
| schedule | No devices or hub support this stub service. |
2025-07-27 01:08:05 +02:00
| technology_specific | Should be covered by other services |
2025-07-27 00:31:18 +02:00
| time | Z-wave service for setting and reading time |
| time_parameters | Z-wave service for setting and reading time |
| version | Device hardware and software versions. Exposed through other means. |
| virtual_meter_elec | A virtual electricity meter that estimates energy usage by multiplying the device's configured average power consumption with its operating duration. Easily reproducible using Home Assistant's built-in configuration. |
