[APP][Pro][TEST] Fhem SDK v3

Hey everyone,

I have brought the original FHEM app back to life as a modern Homey SDK v3 app. The old app only works on earlier Homey generations, so this new version is intended for current Homey Pro systems and is now available as a test version.

Install the test version here:

Current test version

Version: 2026.7.4
Platform: Homey Pro / SDK v3
Connection: Local HTTP or HTTPS connection to the FHEM web interface

What is included

The app connects Homey directly to a local FHEM server and supports the following device types:

  • Lights
  • Sockets and switches
  • Thermostats
  • Window coverings
  • Temperature, humidity, power, luminance, motion and contact sensors

Devices can use the original FHEM homeyMapping attribute for precise capability mapping. When no mapping is present, the app can safely detect several common device types through FHEM’s genericDeviceType metadata.

Local connection and reliability

The app communicates directly with FHEM without requiring MQTT. It includes:

  • Live FHEM event streaming for quick state updates
  • CSRF token support for recent FHEM versions
  • Optional HTTP Basic Authentication
  • Automatic reconnect with exponential backoff
  • Full state synchronization after reconnecting
  • Event-stream monitoring and periodic status reconciliation
  • Correct Homey availability reporting when FHEM cannot be reached

Flow support

Homey automatically provides Flow cards based on the capabilities of each paired device, including:

  • On, off and dim actions
  • Temperature and humidity changes
  • Motion and contact alarm triggers and conditions
  • Thermostat temperature control
  • Window covering controls
  • Power and energy updates

The original custom FHEM action cards are also included for setting power, meter and measured temperature readings.

Flow cards become available after a compatible FHEM device has been paired with this new app.

Languages

Visible app texts are available in:

  • English
  • Dutch
  • German

Setup

First open the app settings and enter the FHEM host, protocol, port and path. Username and password are optional. After saving the settings, add a device through Homey and select the appropriate FHEM device type.

For the most accurate results, configure a homeyMapping attribute in FHEM. Automatic detection is available as a convenient fallback, but the FHEM metadata may occasionally identify a device as the wrong type.

Important when migrating from the old app

This SDK v3 version uses the new app ID nl.nobrainerhomey.fhem. Homey therefore treats it as a separate app. Existing devices from the old nl.sietse.homey.fhem app cannot be migrated automatically and must be paired again. Keep the old app installed until you have verified the new devices and Flows.

This project is a modernized SDK v3 port of the original FHEM Homey app by Sietse Visser (vogon1), which is no longer maintained.

Please test the app and let me know in this topic what works well and what can be improved. Feedback about setup, device detection, mappings, live updates, reconnect behavior and Flow cards is especially welcome.