[APP][Pro] HomeKit Device Bridge for Homey

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.

Professional-grade bridge to bring your Smart TVs and Air Purifiers from Homey Pro into Apple HomeKit with native controls and ultra-fast response times.

Smart TV Features
Transform your Smart TV into a native HomeKit Television accessory with:

  • Automatic Discovery: Support for Samsung (SmartThings), LG (webOS), Sony (Bravia), Philips, Android TV, and more.
  • Dynamic Input Switching: Automatically maps HDMI ports and installed Apps (Netflix, YouTube, YouTube Kids, etc.) as HomeKit inputs.
  • Native Remote Control: Use the iOS Control Center Remote to navigate menus and control your TV.
  • Volume Control: Map TV volume to HomeKit (linked speaker service).
  • Power Sync: Bi-directional power state synchronization.

Air Purifier Features
Comprehensive support for modern Air Purifiers (Xiaomi, Dyson, Philips, IKEA, etc.):

  • Native Speed Control: Smooth rotation speed slider (0-100%).
  • Mode Synchronization: Toggle between Auto and Manual modes directly from Apple Home.
  • Filter Health Monitoring: Real-time filter life percentage and ā€œFilter Changeā€ notifications.
  • Advanced Sensor Suite: Automatically links and displays:
    • Air Quality (PM2.5)
    • Current Temperature
    • Relative Humidity
  • Child Lock & Swing: Map physical control lock and oscillation to HomeKit characteristics.

Supported Brands
This app uses intelligent capability mapping, making it compatible with almost any device that follows Homey standards, including:

  • Xiaomi (Mi Home): Full MIoT support including specialized mappings for the Air Purifier 4 & 4 Lite.
  • IKEA: Starkvind series support.
  • Philips: Air Purifier & Humidifier series.
  • Dyson: Pure Cool / Hot+Cool series.
  • Samsung / LG / Sony: Full TV ecosystem support.

Installation & Setup

  1. Install: Deploy the app to your Homey Pro.
  2. Discovery: Open App Settings on Homey to see the list of discovered devices.
  3. Enable: Toggle the devices you want to bridge to HomeKit.
  4. Pair: Use the HomeKit pairing code found in the app settings or logs.
    • Default Code: 234-23-462
  5. Add Accessory: In the Apple Home app, tap Add Accessory > More Options and select your devices.

Privacy & Performance

  • Local Only: No cloud accounts or external servers required. All communication stays within your local network.
  • Snappy Response: Optimized publication delay (1s) and efficient state synchronization.
  • Persistence: Remembers your device configurations across restarts.

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!