openHAB Android Client

Introduction

openHAB Android application is a native client for openHAB. It uses REST API of openHAB to render sitemaps of your openHAB.

Features

• Control your openHAB server and openHAB Cloud instance
• Receive notifications from openHAB Cloud
• Change items via NFC tags
• Send voice commands to openHAB
• Discover devices and add them as items
• Supports wall mounted tablets

Localization

Concerning all values-* folders at mobile/src/main/res

All language/regional translations are managed with Crowdin. Please do NOT contribute translations as pull requests against the mobile/src/main/res/values-* folders directly, but submit them through the Crowdin web service:

• https://crowdin.com/project/openhab-android

Thanks for your consideration and contribution!

Setting up development environment

If you want to contribute to Android application we are here to help you to set up development environment. openHAB Android app is developed using Android Studio and also can be build with maven.

• Download and install Android Studio Android -> SDK Manager
• Check out the latest code from Github via Android Studio
• Install SDKs and Gradle if you get asked
• Click on "Build Variants" on the left side and change the build variant of the module "mobile" to fullDebug

You are ready to contribute!

Before producing any amount of code please have a look at contribution guidelines

Build flavors

An optional build flavor "foss" is available for distribution through F-Droid. This build has GCM and crash reporting removed and will not be able to receive push notifications from openHAB Cloud.

Trademark Disclaimer

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.

Google Play and the Google Play logo are trademarks of Google Inc.