Skip to content
kaikreuzer edited this page Jun 23, 2014 · 8 revisions

openHAB iOS is an open-source application providing openHAB user interface on iOS platform. It is an integral part of openHAB project.

Basic information on iOS app

Please use openHAB iOS issues to submit bugs, feature requests and ideas on how to improve the iOS native app.

Connecting to openHAB

iOS app uses Bonjour/mDNS service discovery to find openHAB in local network. During startup iOS app detects the type of active network connection. If WiFi is used for network connection iOS app tries to discover openHAB. If iOS app is unable to discover openHAB on local network, it assumes this is not a home network and uses Remote URL from application settings to connect to openHAB. It goes the same way if mobile network connection is detected. All settings, including username, password and remote URL can be configured through 'Settings' menu which is available at any point by clicking 'Settings' on the top right corner of the screen. You can also configure a static URL (openHAB URL) in Settings and openHAB will never try to discover and will connect to this URL during startup. If local URL is not reachable app will failover to remote URL. When you connect to openHAB for the first time iOS app will ask you to select sitemap from the list of available sitemaps. It will remember your decision and open this sitemap automatically next time you launch the app. You can switch sitemap anytime using 'Select sitemap' from settings menu.

Security

We strongly recommend to use HTTPS, though HTTP is also available.

If username and password are configured iOS app will automatically use them for authenticating http requests to openHAB. If openHAB doesn't have any security configured iOS app will connect to openHAB anyway.

We strongly recommend to switch on user authentication in openHAB when enabling remote connection over the Internet!

User experience

iOS app is currently designed for mobile phones and tablets running iOS 7.

iOS app supports all openHAB sitemap widgets.

iOS app supports disabling screen timeout timer while iOS app is running. This is useful for those who use iOS device as a wall control panel. This can be set through Settings menu.

openHAB version support

iOS app is compatible with openHAB version starting from 1.0.0.

Using application

Please install release version of iOS app from the App Store:

iOSApp

Installation

###Linux / OS X

###Windows


##Configuration

User Interfaces


Community

(link to openHAB forum)

Development



Misc


Samples

A good source of inspiration and tips from users gathered over the years. Be aware that things may have changed since they were written and some examples might not work correctly.

Please update the wiki if you do come across any out of date information.

Collections of Rules on a single page

Single Rules

Scripts


Release Notes

Clone this wiki locally