openHAB client for iOS
This is the IOS native client for openHAB.
This is the primary openHAB app which contains the latest features and is updated regularly. This includes Apple Watch support, enhanced notifications, widgets and more. Requires at least iOS 16 and openHAB 2.x and later.
(Official App Store Link Coming Soon)
Beta releases are available on TestFlight.
This is the legacy app for users on iOS 15 or earlier as well as openHAB system 1.x and later (tested to at least openHAB 4). This app only receives security updates and minor fixes and is not intended for most users.
Beta releases are available on TestFlight.
- Control your openHAB server directly and through a openHAB Cloud instance
- Enhanced push notification from openHAB Cloud and the openHAB cloud binding
- Apple Watch companion app
- Widgets (coming soon!)
The app will try and connect using the Local URL as the primary connection, and if that fails or is not reachable, falls back to the local URL.
This sets up the app to use the openHAB demo server and can be used to experience the app without needing to install openHAB.
This is the primary connection to your openHAB instance, a fully qualified URL with a IP or host is required.
Example:
https://openhab.local:8443
This is the secondary connection to your openHAB instance, a fully qualified URL with a IP or host is required.
If using the openHAB cloud service, leave this as the default setting of https://myopenhab.org.
When set to the public cloud, the app will also register for push notifications (as long as credentials are correct)
Example:
https://myopenhab.org
This will be sent if the local or remote server challenges for authentication, or if "Always Send Credentials" is checked on. If using the openHAB cloud, these should be set to those login credentials.
Allows the installation of p12 formatted certificates for use in client side authentication setups.
To install a client certificate, rename the certificate with the extension .ohp12, then send it to your iOS device (airdrop, icloud, dropbox, etc..), then open/save and select openHAB from the "Open In" menu (you may need to select "More..." to see all apps).
To delete a certificate, swipe left on the certificate name in the certificate menu
If using openssl v3 to generate certificates, make sure to add -legacy -certpbe pbeWithSHA1And40BitRC2-CBC to the pk12 export command.
See openssl/openssl#19871 for more information on V3 compatibility with Apple products.
Useful for wall or fixed installations, will disable the Idle screen timeout.
Sends crash reports to Google / Firebase.
Allows audio and video communications in the Main UI for views and widgets that require it.
Allows the user to enter a path to act as the starting point when the Main UI is loaded. Clicking the "+" button will prompt to enter the current path the of Main UI view.
Clears the Main UI web cache.
Allows sitemap sliders to send changes as the control is sliding in realtime.
Clears the sitemap cached images.
Select which type of icon the sitemap view will attempt to load for icons.
Sort order when presenting multiple sitemaps for selection.
The Apple watch requires a sitemap with the name watch.sitemap.
Note that some advanced sitemap features may not be supported on the Apple watch and its recommended to keep this sitemap simple and appropriate for interaction on a small display.
When using the Watch app, slide left to bring up the configuration view and select "sync" to ensure the local, remote and username/password configurations are synced to the watch.
Clicking "Home" will navigate to the Main UI from the user's openHAB system. Clicking this when the Main UI is already visible will force a reload the Main UI.
Tiles are the alternative UIs installed on a user's system and will be opened in an embedded browser.
Sitemaps show the available sitemaps on the users system. Selecting a sitemap will present the native sitemap renderer view.
Notifications is a list of push notification retrieved from the openHAB cloud (if configured).
Settings opens the application settings view.
The app will persist the last primary view opened (Main UI or Sitemaps) when the app is opened or restarted.
The openHAB Cloud Connector allows users to send push notifications mobile devices registered with an openHAB Cloud instance such as myopenHAB.org.
Push Notifications on iOS support:
- Title and message text
- Image and video attachments
- Up to 3 action buttons (long press notification)
- Collapsible / updated notifications
- Removing notifications
Coming soon !
If you want to contribute to the iOS application we are here to help you to set up development environment. openHAB iOS app is developed using Xcode and the standard iOS SDK from Apple. The iOS application is based on the iOS 16 and watchOS 8 SDK and makes uses of several Swift packages.
To start developing you need an Apple Developer account.
- Download and install Xcode
- Check out the latest iOS application code from GitHub
- Open the project workspace openHAB.xcworkspace
You are ready to contribute!
Before producing any amount of code please have a look at the contribution guidelines.
And also please support with the localization of openhab-ios:
Product names, logos, brands and other trademarks referred to within the openHAB website are the property of their respective trademark holders. These trademark holders are not affiliated with openHAB or our website. They do not sponsor or endorse our materials.
Apple, the Apple logo, iPhone, and iPad are trademarks of Apple Inc., registered in the U.S. and other countries and regions. App Store is a service mark of Apple Inc.
