Releases: openhab/openhab-distro
Release list
openHAB 2.5.1
openHAB 2.5.1 is a small patch release that is fully backward compatible with 2.5.0.
It contains version 2.5.0 of the core runtime bundles.
Note that the dashboard footer therefore still shows "2.5.0 Release Build", even if you have the 2.5.1 distro installed.
The following changes are shipped with 2.5.1:
Distro
| Type | Issue | Change |
|---|---|---|
| Bug Fixes | 1041 | Fixed missing dashboard if addons.kar is installed |
| 1051 | Removed yahooweather items | |
| 1046 | Removed duplicate entry for transform.map from demo pom.xml | |
| 166 | Fixed bundle symbolic name for HABPanel | |
| Enhancements | 1041 | Changes required for delivering patch releases for 2.5 |
| 1059 | Use the latest 1.14.x add-on from Maven | |
Add-ons
| Add-on | Type | Issue | Change |
|---|---|---|---|
| amazonechocontrol | Bug Fixes | 6617 | Fixed typo in log |
| chromecast | Bug Fixes | 6711 | Fixed IAE when downloaded image is 'null' |
| 6744 | Stop stream instead of throwing NPE | ||
| deconz | Enhancements | 6716 | Added support for ZHAFire sensors |
| enocean | Bug Fixes | 6519 | Ignore messages with unknown RORG |
| groheondus | Bug Fixes | 6760 | Do not require users to configure timeframe for waterconsumption |
| harmonyhub | Bug Fixes | 6636 | Harmony discovery fix |
| homematic | Enhancements | 6720 | add missing homematic-ip devices #6623 |
| Bug Fixes | 6530 | Make lookup table for device description case insensitive | |
| innogysmarthome | Bug Fixes | 6721 | Fix Dimmer / Rollershutter / Gen 1 devices and Pushbutton |
| kodi | Bug Fixes | 6627 | Fixed assignment of values for channels 'userrating' and 'rating' |
| 6809 | Strip URL parameters from the end of the file extension | ||
| Logreader | Bug Fixes | 6786 | Changed FileTailer to use own executor service |
| Enhancements | 6648 | update smtp server name to have it consistent | |
| max | Enhancements | 6692 | Max always update channels & avoid config updates |
| miio | Enhancements | 6448 | Added device strings |
| 6567 | Add indicator light channel for Mi-Power plug | ||
| 6778 | Xiaomi Robot Vacuum Status and Error Codes added. | ||
| 6779 | Xiaomi Robot Vacuum Channel "state_code" and "error_code" added | ||
| Bug Fixes | 6615 | Fixed wrong channel for vacuum thing | |
| mqtt | Enhancements | 6704 | Enable discovery timeout reset |
| 6755 | Allow outgoing format | ||
| Bug Fixes | 6589 | [homeassistant] fix state/command values for switches | |
| network | Enhancements | 6770 | Fix misleading latency values |
| opensprinkler | Enhancements | 6731 | Show if a station is queued and allow to remove it from the queue |
| Bug Fixes | 6649 | Fix type cast exception | |
| 6650 | Adapt to breaking api changes of opensprinkler | ||
| pioneeravr | Bug Fixes | 6616 | Fixed typo in log |
| satel | Bug Fixes | 6772 | Fixes for arming in mode 1 |
| somfytahoma | Bug Fixes | 6797 | Added checks to omit null type mismatch errors |
| sonos | Enhancements | 6705 | Discovery of Sonos One SL |
| Bug Fixes | 6765 | Avoid resuming a wrong playlist after a notification | |
| Telegram | Enhancements | 6736 | Support data URI scheme for base64 encoded images |
| tesla | Enhancements | 6677 | Re-add force refresh channel and other small improvements |
| Bug Fixes | 6638 | Fixed Model X thing-type id | |
| 6768 | ignore unknown types and prevent NPEs | ||
| toon | Enhancements | 6802 | Removed Toon binding |
| tplinksmarthome | Enhancements | 6773 | Added support for KP303 |
| Bug Fixes | 6774 | Fix typo thing xml kl110 devices | |
| 6776 | Fix special characters in data | ||
| 6803 | Added socket timeout avoids block | ||
| valloxmv | Bug Fixes | 6709 | Typo in folder name prevents binding from working correctly |
| yeelight | Bug Fixes | 6644 | Fix autodiscovery with multiple network interfaces. (#6643) |
| Zigbee | Enhancements | 546 | Temperature measurement server |
| 547 | Add state description for fan mode sequence | ||
| ZWave | Enhancements | 1222 | Add serial port reconnection logic (Closes #1213) |
| 1282 | Add alarm_combustiblegas channel | ||
| 1285 | Add notification_siren channel |
openHAB 2.5.0
This is the official release of openHAB 2.5.0.
The binaries are available on Bintray and via "Stable" on our APT repository.
New and Noteworthy
The openHAB 2.5 release contains many new features, enhancements and bug fixes, both for the core runtime and for many add-ons.
You can find the most relevant ones listed in detail below.
Quick links:
- Notes about new add-ons
- Notes about the core runtime
- Notes about the add-ons
- Notes about the legacy add-ons
- Upgrade Process for openHABian, APT, RPM, Manual Installations
- Breaking Changes that require manual interaction after the upgrade.
Relevant Changes
New Add-ons
The following add-ons are newly introduced with the 2.5 release:
Runtime
| Type | Issue | Change |
|---|---|---|
| New Feature | 506 | Added Ephemeris service |
| 611 | Binary to JSON converter initial contribution | |
| Enhancements | 6777 | Added min, max and step parameters for slider widget |
| 6810 | Added support of unit "Deutsche Haerte (°dH)" | |
| 6864 | Update children of disabled bridge to UNINITIALIZED/BRIDGE_UNINITIALIZED | |
| 588 | Added units mm/h, in/h and MW/h | |
| 617 | Added standard gravity and dBm Units | |
| 695 | Added units kvarh and kvar | |
| 747 | Added profiles to control Player Items via default system triggers | |
| 759 | Added profiles to control Rollershutter Items via default system triggers | |
| 771 | Added i18n feature for dynamic command descriptions | |
| 785 | Added i18n feature for profiles | |
| 793 | Added printf for console | |
| 862 | Small improvements of hexutils API and implementation | |
| 911 | Added 'ThingStatusTrigger' for NGRE | |
| 915 | Added EphemerisConditions for NGRE |
|
| [945](h... |
openHAB 2.4.0
This is the official release of openHAB 2.4.0.
The binaries are available on Bintray and via "Stable" on our APT repository.
New and Noteworthy
The openHAB 2.4 release contains many new features, enhancements and bug fixes, both for the core runtime and for many add-ons.
You can find the most relevant ones listed in detail below.
Quick links:
- Notes about the Core runtime
- Notes about the Add-ons
- Upgrade Process for openHABian, APT, RPM, Manual Installations
- Breaking Changes that require manual interaction after the upgrade.
Relevant Changes
Core Runtime
| Type | Issue# | Change |
|---|---|---|
| Enhancements | 5629 | Added metadata console command |
| 5643 | Distinguish between no item found and no item for pattern in item console command | |
| 5648 | Made max number of sitemap SSE subscriptions configurable | |
| 5721 | Serialize degree celsius with °C instead of special character | |
| 5732 | Added Dobson unit | |
| 5827 | Made jmDNS handle network changes | |
| 5846 | Added Bar unit | |
| 5882 | Made jUPNP handle network changes | |
| 6031 | Sorted Text-to-Speech options in console | |
| 6043 | Sorted audio sink and source options in console | |
| 6051 | Extended console command for things to show more information | |
| 6105 | Added console command to remove inbox entries by thing UID or thing type | |
| 6130 | Improved error reporting in inbox approve REST resource | |
| 6420 | Added mbar unit | |
| 6425 | Remove old mDNS discovery results from Inbox | |
| 6427 | Performance improvements in registries | |
| 6480 | Allow calling Timer#reschedule() after a timer has terminated | |
| 6504 | Allow disabling of Things through console command and Paper UI | |
| 6563 | Added Miligram per Cubic Metre unit | |
| 6575 | Added Microwatt per Square Centimetre unit | |
| 6628 | Upgraded to JmDNS 3.5.5 | |
| 6673 | Upgraded to JUPnP 2.5.1 | |
| 396 | Upgrade to Karaf 4.2.1 | |
| 447 | Added arm64 support for serial port access | |
| Bug Fixes | 4468 | Fixed circular service reference in automation component |
| 5683 | Use media type json for thing's config status REST response | |
| 5690 | Consider GroupItem's base dimension in arithmetic group functions | |
| 5696 | Correctly support Dimmer and Color items in toggle profile | |
| 5698 | Do not use invalid filenames on Windows for JSON storage | |
| 5707 | Prevented exceptions when dealing with empty sitemap models | |
| 5726 | Fixed Internal Server Error thrown by REST API on /{thingUID}/status | |
| 5910 | Releasing of sitemap SSE subscriptions improved | |
| 6087 | Fixed ClassCastException in mDNS client | |
| 6656 | Suppressed EOFExceptions on chart image creation | |
| 372 | Corrected rounding behaviour of decimal values in 1.x compatibility layer | |
| 426 | Prevented NPEs if persistence service does not play nice |
New Add-ons
The following add-ons are newly introduced with the 2.4 release:
| Add-on | Type | Issue# |
|---|---|---|
| AirVisual Node | Binding | #2805 |
| Dresden Elektronik deCONZ | Binding | #4213 |
| DSMR | Binding | #3720 |
| EnOcean | Binding | #3826 |
| evohome | Binding | #2342 |
| Google Cloud Text-to-Speech | Voice | #3721 |
| GPSTracker | Binding | #3839 |
| GROHE ONDUS | Binding | #3696 |
| HABot | UI | #1 |
| Homematic | Binding | #5695 |
| KM200 | Binding | #1877 |
| Konnected | Binding | #3702 |
| Leap Motion | Binding | #3820 |
| meteoblue | Binding | #4821 |
| Modbus | Binding | #2246 |
| MQTT | Binding | #5880 |
| Neato | Binding | #1709 |
| NEEO | Binding | #3191 |
| NibeUplink | Binding | #2695 |
| Nuki | Binding | #2019 |
| OneWire | Binding | #4287 |
| Open UV | Binding | #3595 |
| OpenWeatherMap | Binding | #5694 |
| Pico Text-to-Speech | Voice | #3125 |
| PLCLogo | Binding | #2286 |
| Powermax | Binding | #2225 |
| SmartMeter | Binding | #2167 |
| SolarEdge | Binding | #2770 |
| Somfy Tahoma | Binding | #2503 |
| SonyAudio | Binding | #4838 |
| ValloxMV | Binding | #2990 |
| Xiaomi Mi IO | Binding | #2548 |
| Yeelight | Binding | #3582 |
###...
openHAB 2.3.0
This is the official release of openHAB 2.3.0.
The binaries are available on Bintray and via "Stable" on our APT repository.
New and Noteworthy
The openHAB 2.3 release contains many new features, enhancements and bug fixes, both for the core runtime and for many add-ons.
You can find the most relevant ones listed in detail below.
Quick links:
- Notes about the Core runtime
- Notes about the Add-ons
- Upgrade Process for openHABian, APT, RPM, Manual Installations
- Breaking Changes that require manual interaction after the upgrade.
Relevant Changes
New Addons
The following add-ons are newly introduced with the 2.3 release:
2.x Core
| Type | Issue# | Change |
|---|---|---|
| Enhancements | #646 | Fix backup creation when using custom directory |
| #678 | Some improvements to demo sitemap and items | |
| #655 | Upgrade to Karaf 4.1.5 | |
| #274 | support special words in dashboard tile URL's. | |
| #4390 | Added item metadata infrastructure | |
| #5178 | Added LATEST and EARLIEST group functions for DateTime groups | |
| #5588 | Added usage help for inbox console command | |
| #4848 | Allow configuration of a broadcast address | |
| #5417 | Avoid sending update notification for a chart widget having a refresh argument | |
| #5253 | Handle audio exceptions more gracefully | |
| #5315 | Introduced discovery for USB devices with serial port | |
| #4818 | Introduced unit support with new QuantityType | |
| Bug Fixes | #4383 | Added support for quoted strings in rule triggers |
| #5417 | Avoid sending update notification for a chart widget having a refresh argument | |
| #5442 | Catch and handle exception from chart image generation | |
| #5499 | Consider color conditions when producing sitemap events | |
| #5299 | Fixed daylight saving time (DST) bug in scheduled jobs | |
| #5437 | Fixed NPE in RuleEngine if startup rule has an error | |
| #5549 | Fixed pattern parsing for patterns with square brackets | |
| #5241 | Fixed stopping of currently playing streams | |
| #4982 | Fixed unique item name validation | |
| #5523 | Fixed wrong order of widgets after sitemap changes |
2.x Addons
User Interfaces
| UI | Type | Issue# | Change |
|---|---|---|---|
| Basic | Enhancements | #5073 | Made home icon clickable |
| #5071 | Show label and icon for Mapview widgets | ||
| Bug Fixes | #4920 | Fixed handling of MJPEG video | |
| #5061 | Fixed live update for Microsoft Edge | ||
| Classic | Enhancements | #5078 | Show label and icon for Mapview widgets |
| HABPanel | Enhancements | #302 | Ability to add Switch items to charts (translate ON/OFF to 1/0) |
| #279 | Add tooltips in icon picker | ||
| #259 | Button: Add display options | ||
| #256 | Internationalization/localization | ||
| #276 | Pin drawer & improve widgets resize handling | ||
| #263 | Prompt user to confirm dashboard removal | ||
| Bug Fixes | #266 | Chart/timeline: Fixed date calcs, 2D period, optional serviceId | |
| #288 | Fixed NaN display when dimmer issued ON/OFF command | ||
| #280 | Fixed rendering bug with the experimental dashboard mobile mode | ||
| #278 | Updated ESH Classic Iconset description file | ||
| #277 | Use browser language if unset on server | ||
| Paper | Enhancements | #5576 | Added editor for item metadata |
| #5169 | Display representation property in Things view & Inbox | ||
| #5046 | Expanded config parameter description to 3 lines | ||
| #5067 | Made chart service settings available | ||
| #5092 | Only u... |
openHAB 2.2.0
This is the official release of openHAB 2.2.0.
The binaries are available on Bintray and via "Stable" on our APT repository.
New and Noteworthy
The openHAB 2.2 release contains many new features, enhancements and bug fixes, both for the core runtime and for many add-ons.
You can find the most relevant ones listed in detail below.
Besides many interesting new bindings (e.g. integration to Loxone, LG TVs and iCloud), there are many exciting tools around setup and administration: The new Home Builder interface enables newbies to easily generate initial item and sitemap files to start from. All textual configuration is as comfortable as never before through the VS Code Extension, which now supports syntax checking, content assist and a lot more and which is now the official replacement of the previous "Designer".
Last but not least, there are now backup, restore and update scripts available for Linux, MacOS and Windows likewise.
Quick links:
- Notes about the Core runtime
- Notes about the Add-ons
- Upgrade Process for openHABian, APT, RPM, Manual Installations
- Breaking Changes that require manual interaction after the upgrade.
Relevant Changes
Core Runtime
Enhancements
- #220 - Updated to new openHAB logo
- #609 - Added home builder to standard package
- #507 - Backup and restore scripts for Linux/MacOS
- #512 - Backup script for Windows
- #593 - Formatted the demo / example files
- #594 - Increased thread pool sizes
- #608 - Reduced scan frequency of FileInstall and increased its start level
- #473 - Upgrade script for Windows
- #570 - Upgrade to Karaf 4.1.3 and Jetty 9.3.22
- #185 - Added support for dashboard links to external services.
- #217 - Dashboard internationalization
- #256 - Improved the feature installation logic
- #4291 - Charts Enhancements: Themes, DPI, legend hiding
- #1854 - Added sumSince method in scripts/rules
- #4462 - Enhanced rule interpretation error messages
- #4148 - Exposed a Language Server
- #3930 - Implemented option to choose default network interface
- #4439 - Improved scale transformation service
- #4379 - JsonPath transformation service now complies with the contract
- #3001 - Provided a trigger for thing Online/Offline status in rules.
- #4414 - Redesigned volume icon
- #4197 - TTS voice selection now done using locale matching based on RFC 4647
Bug Fixes
- #4380 - Charts: Explicitly close the image output-stream to avoid resource leaks
- #3752 - Added Composite Jobs for range events if scheduled at same instant
- #4051 - Added support for URIs with user info but no password for the ProxyServlet
- #3855 - Allow JSR223 scripts with same name in different directories
- #2080 - avoid NPE if default TTS cannot be found
- #3795 - Break circle dependencies in GroupItem members
- #4524 - Improved error handling in ChartServlet
- #3832 - Script/rules now gracefully handle null return values
- #1846 - Set correct percent value for Rollershutter item
Add-ons
The following add-ons are newly introduced with the 2.2 release:
- Pushbullet Action
- cm11a Binding
- DMX Binding
- Feican Binding
- iCloud Binding
- Jeelink Binding
- LG webOS Binding
- LIRC Binding
- Loxone Binding
- Nest Binding
- Plugwise Binding
- RegoHeatPump Binding
- RotelRa1x Binding
- Serial Button Binding
- TP-Link Smart Home Binding
- WeatherUnderground Binding
- Home Builder
The following changes were done on existing 2.x add-ons:
Paper UI
Enhancements
- #3782 - Reworked bindings list view & binding detail view
- #3755 - Added options for language & regional settings
- #4256 - Added time zone configuration option
- #4568 - Introduced config option provider for serial ports
Bug Fixes
- #3731 - Performance improvements on control page
- #4340 - Added rollershutter group type
- #4120 - Allow negative integer input for parameters with default pattern
- #3968 - Prevent duplicate things during digest cycle
Basic UI
Enhancements
- #4336 - Use chart themes in UI themes
- #4338 - Internationalization support
- #4386 - Support for HTTP live streams
Bug Fixes
- #3749 - Escape HTML characters
- #4534 - Fixed refresh of hidden/visible image/chart
- #3958 - Set widget value regardless of whether or not visibility has changed
- #3846 - Reload page if sitemap has been changed
HABPanel
Enhancements
- #225 - Community widget gallery
- #210 - New Selection widget
- #202 - Import widgets from a GitHub repository
- #233 - New openHAB logo and meta tags for iOS Safari
- #215 - Add header & drawer display options
- #251 - Include all data in raw local panel configuration editor
- #207 - Item picker: icons for item types
- #197 - Icon picker: allow custom icons or custom URLs
- #204 - Experimental: custom widgets for main menu tile
- #216 - Experimental: custom widgets for drawer and headers
- #250 - Experimental: option to hide dashboard from side drawer menu
- [#199](https://github.com/openha...
openHAB 2.1.0
This is the official release of openHAB 2.1.0.
The binaries are available on Bintray and via "Stable" on our APT repository.
New and Noteworthy
The openHAB 2.1 release contains many new features, enhancements and bug fixes, both for the core runtime and for many add-ons. You can find the most relevant ones listed in detail below.
A few major new changes to highlight are the Eclipse IoT Marketplace integration, which allows browsing and installing of 3rd party add-ons, which are not part of the official distribution. Furthermore, there is now a new alternative to the Designer for editing the config files: The new VS Code Extension for openHAB - it isn't yet available in the official Microsoft store, but nonetheless easy to install.
Relevant Changes
- Core Runtime: New features & Enhancements, bug fixes
- 2.x Add-ons: New features, enhancements, bug fixes
- 1.x Add-ons: New features, enhancements, bug fixes
- Upgrade Process for openHABian, APT, RPM, Manual Installations
Core Runtime
New Features & Enhancements
- #149 - add openHAB version and build info to dashboard footer
- #158 - automatically set the system location, if browser allows it
- #464 - removed default sitemap setting for Basic UI
- #434 - Change gnu to posix tar to support large UID/GID
- #412 - Consider OPENHAB_* environment variables on startup
- #3707 - upgraded to latest JmDNS 3.5.2 patch releases
- #3634 - Add 2D as new chart period
- #3593 - Provide better status information when bridge is missing
- #3587 - Implemented unique geolocation for ESH installation
- #3500 - Provide JSON streaming for REST resources
- #3429 - Only restore backup if there indeed was an unreadable file.
- #3420 - Added ConsoleCommand for adding/removing tags to/from items
- #3365 - OSGI Console: ability to trigger channel with null event
- #3274 - Introduce function NONE for item groups
- #3076 - Initial contribution of an IoT Market extension service
- #3001 - Provide a trigger for thing Online/Offline status in rule.
- #2981 - added state descriptions to some system channels
- #2872 - validate models before loading them
- #2753 - Use Jetty's ProxyServlet implementation
- #3234 - Add createTimerWithArgument method for rules
Bug Fixes
- #115 - fixed dangling audio streams if files are played concurrently
- #458 - Fix refresh intervals for charts in the demo sitemap
- #3088 - fix race condition which could leave a thing in INITIALIZING
- #2992 - Stop blaming handlers for being queued
- #2915 - fixed INCREASE/DECREASE of master volume for Mac
- #3169 - fix NPE in Configuration.toString()
- #3148 - fixes bug when ignoring hidden files
- #3222 - retain order of channels in ChannelTypeResource
2.x Add-ons
The following add-ons are newly introduced with the 2.1 release:
- #3653 - IKEA Trådfri Binding
- #1660 - Xiaomi Mi Binding
- #2134 - BigAss Fan Binding
- #2085 - OneBusAway Binding
- #2035 - D-Link Smart Home Binding
- #2009 - SleepIQ Binding
- #1812 - ZoneMinder Binding
- #1738 - AirQuality Binding
- #1703 - Tankerkönig Binding
- #1589 - Niko Home Control Binding
- #1573 - Synop Message Analyzer Binding
- #1543 - SenseBox Binding
- #1535 - Windcentrale Binding
- #1367 - Gardena Binding
- #1329 - Folding@home Binding
- #1252 - Atlona PRO3 Binding
- #1242 - LG TVs serial Binding
- #1202 - Bosch Indego Connect Binding
- zigbee#1 - ZigBee Binding
- #432 - Eclipse IoT Market Extension
Enhancements on Existing 2.x Add-ons:
Basic UI
- #3693 - encode state in icon URL for colorpicker widget
- #3669 - improvements for non SSE browsers
- #3576 - fit images into main container
- #3526 - dynamic update of the frame title
- #3379 - now updates new sitemap widgets without restart
- #3055 - Display of image items in classic/basic UI
HABPanel
- #187 - Theming improvements + 2 new themes, custom stylesheet option (@kubawolanin)
- #181 - Apply transformations to item states
- #171 - Allow globally provisioned widgets through bundle configuration
- #158 - Color picker widget: Alternative "aCKolor" style
- #151 - Panel name setting
- #150 - Experimental dashboard option: font scaling
- #149 - Custom widget configuration improvements
- #147 - Style improvements: visual feedback on click etc.
- #148 - Knob widget: Add a few missing options
- [#143](http...
2.0.0
This is the official release of openHAB 2.0.0.
The binaries are available on Bintray and via "Stable" on our APT repository.
2.0.0 Release Candidate 1
This is the release candidate for openHAB 2.0.0 - it is meant for final testing and finding of critical issues that need to be fixed before the final release.
The binaries are available on Bintray and via "Testing" on our APT repository.
2.0.0 beta5
This release brings many new bindings, bug fixes and enhancements.
Please see the changes done in
The binaries are available on Bintray.
2.0.0 beta4
This release brings much better stability especially regarding reliability of startup behavior and rule executions. There have been many new bindings as well and it is the first beta release to include the two new user interfaces HABmin and HABPanel.
Please see the changes done in
The binaries are available on Bintray.