twarne/openhab

Source code of the open Home Automation Bus (openHAB)

Introduction

The open Home Automation Bus (openHAB) project aims at providing a universal integration platform for all things around home automation. It is a pure Java solution, fully based on OSGi. The Equinox OSGi runtime and Jetty as a web server build the core foundation of the runtime.

It is designed to be absolutely vendor-neutral as well as hardware/protocol-agnostic. openHAB brings together different bus systems, hardware devices and interface protocols by dedicated bindings. These bindings send and receive commands and status updates on the openHAB event bus. This concept allows designing user interfaces with a unique look&feel, but with the possibility to operate devices based on a big number of different technologies. Besides the user interfaces, it also brings the power of automation logics across different system boundaries.

For further Information please refer to our homepage http://www.openhab.org. The release binaries can be found in the 'releases' section on Github.

Demo

To see openHAB in action, you can directly access our demo server - choose one of these options:

• Check out the Classic UI on the demo server (use !WebKit-based browser, e.g. Safari or Chrome)
• Check out the GreenT UI on the demo server (use !WebKit-based browser, e.g. Safari or Chrome)
• Install the native Android client from the Google Play Store on your Android 4.x smartphone, which is preconfigured to use the demo server.
• Install the native iOS client from the AppStore on your iPhone, iPod Touch or iPad, which is preconfigured to use the demo server.
• Try the REST API directly on the demo server

If you just want to watch for a start, you might also like our YouTube channel!

Quick Start

If you do not care about reading docs and just want to see things running, here are the quick start instructions for you:

1. Download the release version of the openHAB runtime.
2. Unzip it to some local folder
3. Download the demo configuration files
4. Unzip to your openHAB folder
5. run start.sh resp. start.bat
6. Point your browser at http://localhost:8080/openhab.app?sitemap=demo

If you want to use more bindings, you can download the addons.zip and extract it into the addons folder of the openHAB runtime.

If you are interested in more details, please see the setup guide.

Further Reading

Check out the presentations that have been done about openHAB so far. If you are interested in the system architecture and its internals, please check out the wiki for the Architecture.

Community: How to get Support and How to Contribute

If you are looking for support, please check out the different support channels that we provide.

As any good open source project, openHAB welcomes any participation in the project. Read more in the how to contribute guide.

If you are a developer and want to jump right into the sources and execute openHAB from within Eclipse, please have a look at the IDE setup procedures.

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.