Skip to main content

python library for accessing the openHAB REST API

Project description

Codacy badge Documentation Status pypi version

python library for accessing the openHAB REST API

This library allows for easily accessing the OpenHAB REST API. A number of features are implemented but not all, this is work in progress.


  • python >= 3.5
  • python :: dateutil
  • python :: requests
  • python :: typing

Note on openHAB1:

The current version is focused on OpenHAB 2.x; OpenHAB 1.x might still work, though this is not tested. If you require older OpenHAB support, please use an older version of this library.


Install the latest version using pip:

pip install python-openhab


Example usage of the library:

from openhab import openHAB

base_url = 'http://localhost:8080/rest'
openhab = OpenHAB(base_url)

# fetch all items
items = openhab.fetch_all_items()

sunset = items.get('Sunset')

# fetch a single item
item = openhab.get_item('light_switch')

# turn a switch on

# send a state update (this only update the state)
item.state = 'OFF'

# send a command

# check if item state is NULL
if item.state is None and item.is_state_null():

# check if item state is UNDEF
if item.state is None and item.is_state_undef():

Note on NULL and UNDEF

In OpenHAB items may have two states named NULL and UNDEF, which have distinct meanings but basically indicate that an item has no usable value. This library sets the state of an item, regardless of their OpenHAB value being NULL or UNDEF, to None. This in order to ease working with the library as we do cast certain types to native types.

In order to check if an item’s state is either NULL or UNDEF, you can use the helper functions:


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for python-openhab, version 2.12.0
Filename, size File type Python version Upload date Hashes
Filename, size python_openhab-2.12.0-py3-none-any.whl (21.9 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size python-openhab-2.12.0.tar.gz (9.3 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page