[APP][Pro] HomeKit Device Bridge

Apps
,
1

I have currently released a test version, and I will try to provide support as much as I can based on the feedback I receive. As I am both a student and working, I will try to update it when I have time.

HomeKit Device Bridge for Homey

Bring supported devices from your local Homey system into Apple Home with native HomeKit controls, fast local synchronization, and a single configurable bridge.

The app runs locally on supported Homey systems. Homey Cloud and Homey Bridge are not supported because HomeKit bridging requires local network access.

Supported Accessory Types

HomeKit Device Bridge automatically detects your Homey devices and exposes compatible capabilities using the most suitable native HomeKit accessory type:

  • Lights: On/off, brightness, color, color temperature, and Apple Adaptive Lighting where supported.
  • Switches & Outlets: Reliable power control and state synchronization.
  • Climate: Air conditioners, heat pumps, thermostats, fans, air purifiers, and humidifiers with supported controls and sensors.
  • Window Coverings: Blinds and curtains with position and horizontal tilt controls where available.
  • Security: Locks, garage doors, doorbells, smoke alarms, motion sensors, contact sensors, leak sensors, and tamper status.
  • Sensors: Temperature, humidity, air quality, battery, and other supported measurements.
  • Remotes & Buttons: HomeKit button events for supported Homey remotes and controllers.
  • Smart TVs: Native HomeKit television accessories with input switching and Apple Remote support where available.

Native Features

  • Automatic Discovery: Compatible Homey devices are detected and categorized automatically.
  • Selective Bridging: Choose exactly which devices you want to expose from the app settings.
  • Offline Awareness: Devices that are unavailable in Homey are reported as not responding in Apple Home.
  • Stable Pairing: HomeKit IDs remain stable across normal app restarts to preserve rooms and automations.
  • Flow Starter Devices: Add one or more Flow Starter devices in Homey, expose them to Apple Home, and use each switch to trigger a Homey Flow.
  • Local & Fast: Device communication and synchronization happen locally on your Homey system.

Setup Instructions

  1. Install the HomeKit Device Bridge app on your supported local Homey system.
  2. Open App Settings and select the devices you want to expose.
  3. Pair the main bridge using the setup code shown in the orange bridge card.
  4. Pair TV accessories separately when you want native Apple Remote support.
  5. Use the reset options only when you need to regenerate a HomeKit accessory identity.

Support & Donation

If you find this app useful and want to support its development, you can buy me a coffee!

Donate via PayPal: PayPal.Me

Developed by Ugur BENEK (ugrbnk@me.com)

2

v1.1.13 ā€” Stability & Bug Fixes

  • Fixed memory leak: device listeners are now properly destroyed on app shutdown

  • Fixed device filtering (TV, AC, Air Purifier) during HomeKit sync after restart

  • TV filter no longer incorrectly matches lights or switches

  • Fixed unnecessary errors from child_lock listener on unsupported devices

  • Fixed settings page crash when Homey API was slow to initialize

3

Version 1.1.18 Test version

We are taking your Homey Pro device experience to the next level with this major update!

New Features:

  • Premium User Interface: A completely redesigned settings page with a modern ā€œGlassmorphismā€ look. Manage your devices more efficiently with real-time search and intuitive category tabs.

  • Standalone Accessory Support: Smart TVs, Air Purifiers, and Climate devices are now published as standalone accessories. This ensures superior stability and native native performance within Apple Home.

  • Unique Pairing Codes: Each standalone accessory now features its own unique, stable setup code, displayed directly on the device card for a seamless pairing experience.

  • Advanced Device Classification: Enhanced filtering logic for TVs, Air Purifiers, and Climate systems. Hybrid devices (like the Aqara W100) are now intelligently handled as both climate controllers and remotes.

  • Device Icon Integration: Your Homey device icons are now visible in the settings UI, allowing for much faster device identification.

Improvements & Bug Fixes:

  • Memory Optimization: Significant improvements to memory management, addressing crash issues in large-scale smart home setups.

  • Dynamic Synchronization: Enhanced device syncing allows for adding or removing devices on the fly without needing to restart the bridge.

  • Bugs Smashed: Resolved various sensor reporting errors (Leak, Smoke, Contact, etc.) and fixed several icon synchronization and category misclassification issues.

4

Version 1.1.19 Test version

  • Performance-focused optimizations were implemented, reducing unnecessary diagnostic overhead.

  • Per-device verbose logging was limited, and detailed diagnostic logs were made setting-driven (diagnostics_enabled).

  • Heavy startup diagnostic file writes (discovery_report, icon_debug) now run only when diagnostics are enabled.

  • Startup accessory publishing was changed to dynamic pacing (delay based on enabled device count) to smooth CPU spikes.

  • A temporary performance heartbeat/log mechanism was added and hardened for Homey runtime memory metric limitations.

  • mDNS publishing was improved with explicit network bind address selection; announcement timeout errors from lo/eth1/wpan0 were effectively eliminated.

  • Timer lifecycle cleanup was strengthened (onUninit clears timers/intervals), reducing risk of resource accumulation.

  • Based on profiling, no critical CPU runaway or clear memory leak pattern was observed; app behavior is stable.

5

hi , after a short time the bridged devices do not sync with homekit on Homey 2018 .
also the tv control of ios don t work on my samsung tv , and on my dyson fans the fan speed only from 0% - 10% ,11% till 100% don t work.

cf6d6904-03d7-49d0-8c5d-6ae5dc8e9b12
report

6

Hello, Iā€™ve released a beta version. Could you please take a look and let me know your thoughts? Please delete the TV and air purifier you added and add them again.

7

so ,

  1. at moment the synchronisation with homekit runs without problems ( 5h + longer as the last version)

  2. some devices has 3 buttons in Homekit ( as a remote) but that is not correct for example a simple outlet with energymeter is in homekit 2 devices , OnOff and 3 buttons.
    correct is OnOff and the energymeter

  3. Fans ( Dyson PureCool) are shown correct but the fan speed has
    now no function .
    (Dyson Humidfy only as fan option , no settings )

( Dyson Pure Hot Cool also ad fan only no heating option )

and on all devices no Airquality states in Homekit.
dyson uses 1,2,3,ā€¦,10 as fans speed , homekit
use 0, 0.1 , 0.2, ā€¦, 1.0 ( thats why i use on the
homekitty app an ADV devices to compare this
with a math rule 1:10 .
i know with the homebrige plugin for dyson that this all is possible

All your devices are exposed as air purifiers in HomeKit, with support (also in Apple Home app) for:

  • On/off
  • Auto/manual
  • Fan speed
  • Oscillation on/off (for supported devices)
  • Relative humidity (for supported devices)
  • Current temperature (for supported devices; in Apple Home app only supported as separate sensor)
  • Air quality (incl. PM2.5, PM10, VOC and NO2 data for supported devices)

For heating devices, a thermostat is also exposes to HomeKit with support for:

  • On/Off
  • Target temperature

For humidifier devices, a humidifier is also exposes to HomeKit with support for:

  • On/Off
  • Auto/manual
  • Target relative humidity

maybe bridge them also as a homekit device like tv .

  1. My Shelly Shutter switch is only shows a temperature sensore no slider or else ( only the 3 push buttons :joy:
  2. a chronograp timer device is shown as unkown device type ( this device is not supported for homekit ,
  3. Tv : OnOff :white_check_mark:
    Vol. : slider ( eve app) :white_check_mark:
    Inputs : only show on selection but not more
    this selection has no function
    correct is Tv,HDMI1,HDMI2, ā€¦ also
    Browser , amazonprimevideo,netflix as
    input selction is possible
    apple remote app : vol :white_check_mark:
    mute :white_check_mark:
    OnOff :white_check_mark:
    all other buttons : right,left,ā€¦ info, back, play/
    pause without functions .

thats what i tested till now, on homey early 2018 / v13.1.0rc.1
on homekit app , eve app, in Controller for Homekit

ah and the waiting time after installation is set to 3000ms not 12000ms (default) or the description for this function is wrong . :upside_down_face:

8

Inputs: Only show on selection, but nothing more
This selection has no function
The correct ones are TV, HDMI1, HDMI2, ā€¦ and also
Browser, Amazon Prime Video, Netflix as
Does this information appear in the Homey app? Can you see the input information on the Homey interface? You mentioned that you use a Samsung TV. How did you add it to Homey?

9

Hello! Iā€™m trying to add a BlueAir Air Purifier into HomeKit with this plugin. Currently on HomeKit, I just see the ability to toggle between off, auto, and manual. The air quality sensor also just appears as excellent and 0 PM2.5, which is inaccurate. It wonā€™t control my Air Purifier at all either. I am using the BlueAir plugin, to be fair, so I expected some issues with compatibility. Iā€™m not sure if any of this could be addressed, but Iā€™d be happy to test!

10

Hello, I reviewed the Blueair app and noticed that its commands are incompatible with HomeKit.

  1. Use of ā€œIncorrect Termsā€ (Custom Capabilities)
    Homeyā€™s HomeKit support looks for standard names when mapping a deviceā€™s capabilities to HomeKit. For example:

HomeKit expects: fan_speed (with an underscore).
The Blueair app sends: fanspeed (without an underscore).
The app developer has defined fan speed and modes using custom names of their own choosing, rather than Homeyā€™s standard names. Since HomeKit does not recognize these custom names (ā€œfanspeed,ā€ ā€œautomode,ā€ ā€œbrightness2,ā€ etc.), it either ignores them entirely or treats them as simple options rather than a slider or an advanced control.

  1. Deviating from Standards (The ā€˜2ā€™ Suffix)
    Features with a ā€˜2ā€™ suffix, such as ā€œbrightness2ā€ seen in the app, are completely outside Homeyā€™s standards. The developer likely did this to distinguish the 0-100 data structure in newer Blueair models from older ones. However, for HomeKit, this is an ā€œunknown feature.ā€ Therefore, HomeKit cannot retrieve the ā€œbrightnessā€ or ā€œmodeā€ data it expects from an air purifier using these ā€˜2ā€™ suffixes.

  2. Data Missing (PM2.5)
    Due to ā€œdata key incompatibility,ā€ the PM2.5 value already appears as 0 on Homey. When the Homey-HomeKit bridge takes this 0 value and sends it to HomeKit, HomeKit naturally reports an incorrect status: ā€œAir quality is excellent, 0 PM2.5.ā€

In summary:
The reason for the improper transmission to HomeKit is that the app uses ā€œCustom Propertiesā€ instead of ā€œHomey Standard Properties.ā€

To fix this: The Blueair app developer needs to update the app to use standard names.

11

Hi! First of all thank you for the great app :grinning_face_with_smiling_eyes: Been using it since the launch and in the first versions my 2 Samsung smart tvā€™s showed up in Apple Home as tvā€™s, but since a few updates they show up as outlets. Is there something I can do at my side to change this or can you have a look at this? Can share a diagnostic report if necessary. Thank you!

12

Hello, if you send me the problem report, I can look into what the issue is.

13

Here it is: 8d9e1f24-25a8-4eba-ac60-9d0115e78ab7

Thank you for the quick reply!

14

Could you test it and provide feedback?

15

Thanks for the quick adjustment. Tested it but unfortunately still the same, also send you a diagnostic report.

16

Iā€™m receiving the diagnostic reports now; Iā€™ve made the corrections again.

17

Hello, I received the diagnostic report, but it still canā€™t find the TVs. Which app did you use to add the TVs to Homey? I also have two Samsung TVs, and theyā€™re transferring to HomeKit without any issues.

18

Iā€™m using the Samsung SmartThings community app, also tried official SmartThings app but same issue. Which app do you use / advise?

19

I use the Samsung Smart TV app. With SmartThings, the token expires after a while and the devices stop responding. But since your situation seems different, Iā€™ll look into it and get back to you.

20

Thanks! Tested that app and it works, so Iā€™ll keep this app active for the Homekit bridge. It would be great if you manage to get the Smartthings app working again in Homekit like it used to do in the first versions of your app :slight_smile: But no hurry, thanks for the help so far!