Pull request Compare This branch is 32 commits ahead, 814 commits behind openhab:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
ESH-INF removed colons Sep 26, 2017
META-INF updated version numbers Sep 24, 2017
OSGI-INF update license Sep 26, 2017
lib added apache codec library 1.10 Sep 24, 2017
src/main/java/org/openhab/binding/camera update license Sep 26, 2017
.classpath added apache codec library 1.10 Sep 24, 2017
.project generic IP camera binding support Sep 24, 2017
README.md Escape < and > in readme Mar 8, 2018
TODO.md reformat and added further description Sep 26, 2017
about.html added newline Sep 24, 2017
build.properties added apache codec library 1.10 Sep 24, 2017


Camera Binding

The binding integrates simple IP base cameras.

Almost every IP camera has a simple HTTP access API defined by Urls to access at least static images. This binding supports these types of cameras for fetching and displaying images in a openHAB UI. At a later stage motion/change detectors might be added as well as video processing.

Supported Cameras

All cameras supporting simple HTTP based API fetching for JPG/PNG images. Please contact the author Thomas Hartwig thomas.hartwig@gmail.com for camera Url examples if not listed here.

Vendor Single snapshot URL Video capture (not yet supported)
Axis http://<CAMERA>/jpg/image.jpg
Bosch http://<CAMERA>/snap.jpg


Currently camera discovery is not supported, probably ONVIF might supported soon.

Thing Configuration

Currently a camera can be added and configured in the PaperUi for instance. Following parameters are supported:

  • Poll time: the update interval of the image to fetch from the camera
  • Snapshot Url: the url to fetch the image from see examples above
  • Username: username when the camera is protected, this uses the standard HTTP authorization protocol, however username and password might be specified via the Snapshot Url as a parameter, please check camera model documentation for correct parameter syntax
  • Password: password when the camera is protected



This is the base image channel which is updated periodically in the configured interval. This is currently the only supported channel.