Announcement: New official iOS-watchOS app release- version 3.3.0

We have released version 3.3.0 of the openHAB app for iOS and watchOS. The headline change is a complete migration to Apple’s App Intents framework, replacing the legacy SiriKit extension. Alongside that, the release includes a significant number of fixes and improvements.

Siri Shortcuts — App Intents

The Shortcuts integration has been rewritten on the App Intents framework. The old SiriKit extension has been removed. All actions now run in the background without launching the app.

The following actions are available: control a switch, read item state, set a dimmer or rollershutter value, set a color, set a number, control a player, set a string, set a date/time, check a contact sensor state, and switch the active home. Items and homes use stable cross-device identifiers, so shortcuts created on one device synchronise correctly to another. Group items are now included in the item picker. The “Get Item State” action returns the formatted display value in addition to the raw state string.

App Intents are also available on Apple Watch with full multi-home support.

Credential Security

Connection credentials are now stored in the system Keychain instead of UserDefaults, both on iPhone and on Apple Watch. This keeps credentials out of app data backups and aligns the app with iOS security guidelines.

watchOS — WidgetKit Complications

The deprecated ClockKit complications have been replaced with WidgetKit. The new complications support all current watch face families and use the standard system timeline mechanism.

Notifications

Foreground push notifications now display image attachments when present. If a notification action fails — for example because the server was briefly unreachable — the notification is re-posted so the user can retry without waiting for a new one. Navigation to a sitemap sub-page triggered by tapping a notification is more reliable across both foreground and background launch paths.

Reliability & Polish

A number of long-standing issues have been addressed:

  • Sitemap sub-pages refresh their items when the app returns to the foreground
  • Sub-page navigation is deferred until the root sitemap poll has completed, avoiding blank screens on slow connections
  • Optimistic widget state is reverted when a command is rejected by the thing
  • Relative image widget URLs are resolved against the server root URL
  • Image widgets no longer flicker during periodic auto-refresh
  • The Input widget sends the correct value when the state description changes unit mid-session
  • A prompt is shown when Local Network access has not been granted, avoiding silent connection failures

Localisation

The string catalogue has been cleaned up and completed: French, Italian, Dutch translations now cover all keys

Hi Tim,

Many thanks for the great news! I’ve tried pulling the new app immediately.

Unfortunately, the App Store is still installing 3.2.77 even though it’s offering it as being 3.3.0.

After installing the app I’ve stopped/restarted the app on the phone as well as on the watch. Both are still showing the 3.2.77 in the “about” screen.

Any advice how to force pulling the real 3.3.?

Thanks,

C.

App Store version 3.3.0 (286) is TestFlight version 3.2.77 (286).
A version 3.3.2 (288) will align version numbers. It is currently in review. This version brings a fix to those that are already on iOS 27.

Good to know, thanks for clarifying and again for all the effort!

Seems that all of the openHAB items have been removed from Siri shortcuts after updating to this version. Every place that a shortcut referenced an openHAB item now shows “Unknown Action”. After manually re-adding the items the shortcuts work properly. Is there something I can do get all of the items back without having to add them one by one?

The new version comes with a proper synchronisation of actions across devices of the user based on the name of the home. The downside is that shortcuts need to be redefined.

Thanks for your help. IIRC in the previous versions of the app dimmers could be sent a value of “ON” or “OFF” but I haven’t been able to find how to do that with the new version. “Set Dimmer or Roller Shutter Value” only allows numeric values. “Set Switch State” does not display dimmer items in the pick list. Is there a way to send ON/OFF to a dimmer item?

There currently isn’t a way to send ON/OFF to a dimmer. but a good point to be added

Ok, i can work around it. Is there something I should do to so that this is not forgotten? Some sort of ToDo list somewhere?

This should be a quick fix.

It would be great to have some testing on the 3.3.x series which we use to prepare the fixes and small additions for the current stable release. Currently on TestFlight you could test 3.3.5 which allows speech recognition Allow speech recognition by digitaldan · Pull Request #1281 · openhab/openhab-ios · GitHub and brings a fix for basicUI on iPad.

Please note that in parallel we are testing on the 3.4.x series on TestFlight Home Screen and Lock Screen Widgets. This will require to raise the deployment target to iOS 18! To select a TestFlight version click in TestFlight the icon for openHAB. You can then select in “Versions and Build Groups” all earlier versions until they expire after 90 days.

TestFlight allows for Build Groups that make it easy to stage rollouts, isolate experimental features, and manage different audiences without creating separate apps. Going forward we willl make use of them: New TestFlight Groups