HABmin is a web administration console for openHAB. It aims to provide a complete interface to administer openHAB, including the following features -:
- General configuration (openHAB.cfg)
- Configure bindings
- Configure items
- Configure mapping
- Configure sitemaps
- Configure ZWave network
- Configure rules and notifications
- Query and graph data from persistence stores
- View OSGi binding status
- View log files
The interface is a modern browser based system providing point and click, and drag and drop input. As features are added, the wiki is being updated - please take a look. The interface supports multiple languages - please help with translations.
HABmin interfaces to OpenHAB through a RESTful style interface - this is implemented as a separate bundle to the openHAB REST interfaces that support the standard user interface.
In addition to the REST interface, it is possible to define files that describe the configurable features of OpenHAB. These files describe the configuration required for a binding or an item and are used within openHAB and exposed through the HABmin REST interface. The files are defined in XML format and are not directly accessed by HABmin.
While HABmin is a supporting project to OpenHAB, providing access to openHAB's features, since the existing REST interface does not support most of the functionality required by HABmin, HABmin may drive this part of openHAB to some extent. It is also expected that as functionality is added to openHAB, HABmin will need to have its backend modified to reflect the final interfaces implemented in openHAB.
###Status The project is just getting started. Currently implemented are the following -:
- Graphing of data from the persistence store
- Item editor
- Sitemap editor
- General binding configuration (ie binding configuration in the openhab.cfg file)
- OSGI bundle status viewer
- Rule editor with syntax highlighting
- Item rule library (initial test phase)
- ZWave configuration interface (note: work in progress still)
Additionally, lot of the initial user interface has been boilerplated and some work has started on the REST interface for configuring bindings.
HABmin is an open source project. It makes use of a number of libraries under GPL license. The following major libraries are used -:
- ExtJS from Sencha
- Highcharts from Highsoft
- Download the project zip file from GitHub and unzip files in the directory webapps/habmin (you will need to create this directory).
- Place the org.openhab.io.habmin*.jar file into the addons directory (this is stored in the addons directory in the repository).
- Place the org.openhab.binding.zwave*.jar into the addons directory (this is stored in the addons directory in the repository). Note that this bundle is currently required for HABmin to start, but if you don't have zwave then it won't actually run if it's not configured. In the longer term this dependency will be removed.
You will probably need to restart openHAB for the new interfaces to take affect.
You can then start HABmin at the address http://localhost:8080/habmin/index.html (assuming openHAB is running on your local computer using the default port - if this is not the case, you will need to adjust the address accordingly).
If you wish to help with this project, please feel free to clone the repository and work on some features. I would like to maintain a top level TODO/Issues list which lists the main features that require work. Please feel free to add to this list, or discuss implementation issues within the issue. If you are going to work on a feature please make it known so we can avoid duplication.