HomeyKit
With this app you can pair Homey to HomeKit and control your Homey devices using iOS, Siri and Shortcuts.
IMPORTANT: this app is deprecated
With the release of the new HomeKitty app, this app will not be developed any further, apart from an SDKv3 release before the release of the new Homey Pro.
You can keep on using HomeyKit for as long as you like, but it won’t be actively maintained anymore. You can run HomeyKit and HomeKitty on your Homey without getting in the way of each other (as long as your Homey has enough resources), so you can run HomeKitty on a “test home” to see if it works for you. It already supports more devices than HomeyKit, has some additional features, and hopefully it’s just altogether a better experience. Plus, it’s ready for the upcoming new Homey Pro.
HomeyKit support for the new 2023 Homey Pro
From version v5.1.0, currently in test, HomeyKit has preliminary HP2023 support.
However, I would urge all HomeyKit users to consider migrating to HomeKitty, as mentioned above.
Note on Home changes in iOS 16.2
With the current iOS 16.2 beta, Apple has introduced a new Home architecture (including support for Matter/Thread).
Upgrading to this architecture is optional. Given that the current beta is giving issues with HomeBridge and HomeyKit (at least for some people), my advice is to wait to upgrade.
For those that have upgraded already and are experiencing issues with HomeyKit (devices being unresponsive), the current test version (v4.3.0) should fix those issues. Be aware that test versions of apps can be subject to frequent changes and updates, and as a result, it may be required to do a full Home(y)Kit reset.
Usage Instructions
After installing the app grab your iPhone or iPad, open the Home app on your iOS device and then:
- Click the
+
at the top of the screen and choose Add New Home (name it anything you like) - Once the new home is created, choose Add Accessory > More options…
- (If your Homey isn’t already visible in the list of accessories, try My Accessory Isn’t Shown Here)
- Pick Homey (because HomeyKit isn’t officially certified by Apple, you’ll get a question about adding an uncertified accessory)
- Enter the code: 20020200 and Continue.
After Homey has paired with your iOS device your Homey devices will be added. When you add or remove a device from Homey the same wil happen in HomeKit. In the application settings for HomeyKit you can select which devices you want to pass (and not pass) to HomeyKit. By default, all supported devices will be passed.
The following classes are supported:
- Lights (with RGB or Temperature)
- Sockets
- Switches
- Motionsensors (with lux and temp)
- Locks
- Door/Window sensors (with temp)
- Thermostats
- Window coverings (blinds, curtains, sunshades)
- Buttons
- Fans/heaters
- Most on/off devices
- Home Alarm
- Most sensors
Donations
Donations are very welcome, though they come with no guarantees, warranties, or preferential treatment (just think of it that you’re donating for the work already done, not the work to be done).
For now, Paypal only: PayPal.Me
Issues
A lot of issues with HomeyKit are not related to the app but have external causes, like Homey’s networking being unstable (especially after a firmware update). Typically, when you have issues with any app, the first recourse is to PTP.
If your problems with HomeyKit are persistent, you can perform a full reset from the App Settings.
If you are sure you found an actual bug with the app you can create an issue on Github .
Changelog
5.0.0
- SDKv3 support and slimmed down the app considerably.
4.1.10
- Added link to community forum page
4.1.9
- Support for “remote” devices with onoff capabilities and fixed issues with “locked” subcapabilities.
4.1.8
- Make sure all devices are ready before being added to the bridge.
4.1.7
- Catching more Web API error.
4.1.6
- More small fixes
4.1.5
- Work around yet more issues with the Web API
4.1.4
- Catch errors when starting the bridge
4.1.3
- Limit the number of bridged accessories
4.1.2
- Work around more issues in the Web API
4.1.1
- More fixes to work around issues in v7.4.X-rc.Y
4.1.0
- Changes for Homey v7.4.0-rc.X
4.0.1
- Added support for state blinds/curtains/sunshades
4.0.0
- New stable release
3.0.13
- Added support for curtains and generic window coverings
3.0.12
- Added support for blinds (#180 and hopefully #159)
3.0.11
- Stability changes (hopefully fixes #137)
- Allow user to set different bridge identifier (#151)
- Added support for curtains (#153)
3.0.10
- Fixes #149 (issue with CO2 and CO sensors)
- Removing explicit subscription for device update events (not required anymore)
3.0.9
- Some fixes for Satel Integra support
3.0.8
- Swapped
button/homealarm_system
detection to work better with Heimdall
3.0.7
- Support for device class
speaker
- Fixed issue with settings
- Configurable settle time
- Support
onoff
for device classhomealarm
- Support
onoff
anddim
for device classsensor
- Removed log tab from settings page (wasn’t being used anyway)
3.0.6
- Wait longer after a reboot for devices to settle to prevent iOS from not recognizing devices anymore
3.0.5
- Prevent non-existent capabilities from being accessed/used
- Cleanups
- Debouncing dim so it doesn’t glitch as much
3.0.4
- Better check on required capabilities for devices to prevent crashes
3.0.3
- Also check
device.virtualClass
during device discovery.
3.0.2
- Fix to prevent issues due to Athom’s implementation hijacking our TCP port
3.0.1
- Fixed an issue with the settings page not being shown
3.0.0
- Homey v2 firmware support
- Changes to settings pages
- Option to clear persistent storage to resolve issues with Homey not being found by iOS
2.1.3
- Delay start of Homekit server until device count has settled (#93)
2.1.2
- Trying to fix #82
2.1.0
- Reintroduced settings page
- Other small fixes
2.0.12
- Filename uppercase fix
2.0.11
- Updated hap-nodejs, lodash and athom-api
- Added alarm system support for Heimdall
- Added fan support
2.0.10
- Fix for sensors
2.0.9
- Bugfixes in smoke and temperature class
2.0.8
- Multiple devices added (see Added support for various devices by nhassink · Pull Request #54 · swttt/com.swttt.homekit · GitHub )
2.0.7
- Fixed color bulbs
- Fixed thermostat
2.0.6
- Small fixes
2.0.5
- Small fixes
- Thermostat display units added
2.0.5
- Fixed contact sensor
2.0.4
- Beta appstore release
2.0.0
- Initial release where has-node got replaced by hap-nodejs