Skip to content

Releases: openhab/openhab-distro

openHAB 5.1.3

22 Feb 21:35

Choose a tag to compare

This patch release contains the following bug fixes:

Runtime

Type Issue Change
Bug Fixes 5351 Restore model validation not to fail on diagnostic errors for rules and scripts
5376 Fix community marketplace discourse parsing

User Interfaces

UI Type Issue Change
Main UI Bug Fixes 3868 Align x-axis and query to daysOfMonth for aggregated series
3869 zwave: Fix zwave network map display in 5.1.x
3889 item-state-preview: Fix toggle switch not being fully re-rendered on Item change
3894 useStatesStore: Fix error in expression tester with =items formula

openHAB 4.3.10

22 Feb 21:38

Choose a tag to compare

This patch release contains the following bug fixes:

Runtime

Type Issue Change
Bug Fixes 5376 Fix community marketplace discourse parsing

openHAB 5.2.0.M1

15 Feb 17:51

Choose a tag to compare

This is a monthly milestone build for the upcoming openHAB 5.2 release, which brings many fixes and improvements.

New Add-ons

The following add-ons are newly introduced:

Add-on Type Issue
Bluelink (Hyundai/Genesis) Binding #19823
Geocoding Profile Transformation #19921
RemehaHeating Binding #19494

The following improvements were made:

Runtime

Type Issue Change
Enhancements 1842 Upgrade Karaf to 4.4.9
1861 Backup script: Exclude heap dumps, crash dumps & voice add-on userdata directories
4633 Rule file provider
5043 ChannelTransformation: log exact syntax errors in transformations
5101 use Instant instead of ZonedDateTime in Riemann sum methods
5116 Add support for RegEx expressions in event WebSocket topic filter
5195 Upgrade Karaf to 4.4.9
5203 Enhancements and corrections in openapi spec
5235 Add time zone support for ZonedDateTime action inputs
5236 Adjust REST HTTP response status codes
5250 Add support for short-form metadata namespace in Item Yaml config
5252 Add support for short-form expire property in Item Yaml config
5254 Karaf features: Update supported schema versions
5280 Add INFO log for config TEXT param value not parsed a…
5282 Log warning on Thing config errors
5283 Allow empty or null metadata values via the REST API
5295 API /file-format/parse: do not extend thing/channel config
5303 Optimize ZonedDateTime.now().toInstant()
5305 Do not generate thing label if same as in thing type
5308 Updated item and persistent REST services to use itemName vs. itemname.
5313 Add support for short-form syntax in YAML Semantic Tags
5316 Add StateOfCharge Semantic Tag Property
5325 Decouple session & API token management from ManagedUser implementation & JaasAuthenticationProvider fixes
5328 UserRegistryImpl: Allow registering additional ManagedProviders & Allow field access for subclasses of GenericUser
5332 Allow "configuration" in syntax as alternative to "config"
5333 Add utility method to cast profile configurations to specific classes
5341 Enhance removedModel method in all providers
5342 Validate ThingUID part during ChannelUID construction
5349 DSL: implicit RiemannType import
5352 Support 'keywords' field in addon.xml schema
Bug Fixes 1857 Upgrade Maven and downgrade karaf-maven-plugin
5184 add metric area/volume units
5216 Add missing media type for output of /links/orphans API
5225 Switch to using asynchronous send with Jetty websockets
5226 Fix UIResource GET endpoints require no auth if implicit user role disabled
5241 Use quotes for numbers stored as strings when generating YAML
5242 Normalize thing/channel config in response of /file-format/parse API
5244 Allow cross-binding bridges when generating code for a thing
5248 Add special handling to thing/channel config param of…
5257 IconServlet: Suppress error logging when client disconnected while sending response
5272 Fix StartlevelTrigger triggers twice during startup & Passes wrong startlevel as payload
5273 Set config descriptions for SimpleRule & Improve null handling
5296 Fix Instant deserialization for action inputs
5304 Fix LogDTO.compareTo to avoid overflow and contract violation
5334 DSL Rule - allow using org.openhab.core.persistence.extensions.PersistenceExtensions.RiemannType.TRAPEZOIDAL
5348 Only consider fully qualified discovery results
5351 Restore model validation not to fail on diagnostic errors for rules and scripts

Add-ons

Add-on Type Issue Change
ahawastecollection Enhancements 19834 Add christmasTree channel
ambientweather Enhancements 20159 Change ambient server domain
astro Enhancements 19789 Add Circadian light
19830 Refresh zodiac handling
19875 Refresh SeasonCalc and add icon package
19949 Switching radiation to immutable and Instant
19974 Refactor Moon Distance
19981 Add solar midnight event
20007 Adds dynamic icons for Sun Eclipses
20063 Tweak sun and moon position classes
20066 Adds moon_day and moon_phase icon sets
20077 Review Eclipses calculations
20104 Rework Moon Phase calculations
Bug Fixes 19843 Don't attempt to publish state to trigger channels on linked
19982 Fix premature event scheduling
20078 Refactor event scheduling
20085 Fix circadian luminosity bounds
automower Bug Fixes 19959 Fix NullPointerException for POI mode
avmfritz Bug Fixes 20071 Fix unit for energy values while polling
basicprofiles Enhancements 19753 Add time-weighted average profile
boschshc Enhancements 19956 Support Door/Window Contact II [+M]
19960 Support Radiator Thermostat II (with and w/o Matter)
20139 Support TemperatureOffset service for thermostats
coronastats Enhancements 20129 Remove binding
easee Bug Fixes 20189 Adopt allowed values for currents since easee also allows 1-5A.
energidataservice Enhancements 19917 Add semantic...
Read more

openHAB 5.1.2

09 Feb 05:17

Choose a tag to compare

This patch release contains the following bug fixes:

Runtime

Type Issue Change
Enhancements 5282 Log warning on Thing config errors
5295 API /file-format/parse: do not extend thing/channel config

Add-ons

Add-on Type Issue Change
ambientweather Enhancements 20159 Change ambient server domain
Astro Bug Fixes 19982 Fix premature event scheduling
avmfritz Bug Fixes 20071 Fix unit for energy values while polling
easee Bug Fixes 20189 adopted allowed values for currents since easee also allows 1-5A.
froniuswattpilot Enhancements 20103 Upgrade wattpilot4j to 2.3.0 & OSGi-ify it
heos Bug Fixes 20025 Fix decoding of favorite names
homekit Bug Fixes 20004 Improve thread synchronization
20034 Fix UoM for state updates
20052 Fix HTTP Host Header
20183 Suppress discovery of accessories with 'null' ip address
jsscripting Enhancements 20195 Upgrade openhab-js to 5.17.0
matter Bug Fixes 20096 Map JS undefined to Java Null
mideaac Bug Fixes 20065 Add Fan Speed Option for Version 3
radiothermostat Bug Fixes 20134 Fix thermostat schedule error handling
ring Bug Fixes 20166 Fix download of videos
20167 Fix rediscovery of objects
roborock Bug Fixes 20013 Fix login for accounts not yet upgraded to new authentication protocol
20022 Fix warning about invalid channel fw-features
20023 Fix NullPointerException
20028 Fix rediscovery of existing vacuum Things
20046 Fix Room mapping channel
20111 Fix status#clean-area channel
20192 Fix NumberFormatException when handling REFRESH
shelly Bug Fixes 19894 Fix NullPointerException for PM Mini updates
tasmotaplug Bug Fixes 20109 Fix command mapping for power channel 3
teslascope Bug Fixes 20045 Fix rediscovery of existing vehicle Things
transform.vat Enhancements 20191 Update rates
tuya Bug Fixes 20042 Remove extraneous toLowerCase
unifiprotect Bug Fixes 19968 Fix camera and doorbell motion events
z-wave Bug Fixes 2016 Correct the device Action IsFailedNode
2015 Migrate controller & device node actions from config actions to Thing actions
2020 Refactor ZWave node actions to return status messages
2021 Add device actions; replace failed node and ping node

User Interfaces

UI Type Issue Change
Main UI Enhancements 3788 useUIOptionsStore: Make darkMode reactive
Bug Fixes 3627 Charts: Fix oh-time-axis doesn't adjust begin/end for series with offset
3741 oh-list: Fix various issues when editing
3748 oh-colorpicker-item: Add missing space between colorpicker and toggle
3749 Developer sidebar: Fix expression tester doesn't display falsy values
3750 Fix stylesheet config not applied to oh-block, oh-grid-col, oh-grid-row
3754 oh-input: Fix reference to getVariableScope method
3760 oh-canvas-item: Fix 0 values for x, y, w, h config parameters ignored
3761 f7-list-group css: Fix style regression from grouped list indentation fix
3776 useThingEditStore: Fix firmware data no reset if not available
3778 Ensure directives are at the top
3779 oh-canvas-item: Fix f7-swiper autoplay & Auto Size not working
3781 widget-mixin: Fix JS error in childWidgetContext if widget not found
3799 oh-swiper: Fix children cannot be added
3809 Link details: Fix reactivity when invalid link removed
3815 oh-plan/map-page: Fix stylesheets for leaflet pages
3816 Thing details: Add checkbox to display EXPERT thing actions
3817 oh-masonry: Fix style leak & Clean-up unused class from home
3834 parameter-options: Fixed issue with parameter of type BOOLEAN that has specified options
3860 oh-canvas-item: Fix f7-swiper autoplay not working on initial page rendering

openHAB 5.1.1

08 Jan 20:57

Choose a tag to compare

This patch release contains the following bug fixes:

Runtime

Type Issue Change
Bug Fixes 5225 Switch to using asynchronous send with Jetty websockets
5226 Fix UIResource GET endpoints require no auth if implicit user role disabled
5241 Use quotes for numbers stored as strings when generating YAML
5242 Normalize thing/channel config in response of /file-format/parse API
5244 Allow cross-binding bridges when generating code for a thing
5248 Add special handling to thing/channel config param of…

Add-ons

Add-on Type Issue Change
automower Bug Fixes 19959 Fix NullPointerException for POI mode
entsoe Bug Fixes 19867 Fix XML error handling
homekit Bug Fixes 19965 Support bridges with hardware embedded accessory things
homematic Bug Fixes 19932 Properly consider special values in DP value validation
hueemulation Enhancements 19948 Upgrade JUPnP to 3.0.4
ipp Bug Fixes 19915 Prevent NullPointerException if printer UUID is missing
jsscripting Bug Fixes 19879 Upgrade to openhab-js 5.16.2
lutron Bug Fixes 19886 Fix infinite loop in switch status update
modbus.lambda Bug Fixes 19901 Correcting inconsistencies in three channel id's
19928 Prevent overwriting modbus binding details
tuya Bug Fixes 19930 Avoid refresh if there are no measurables
unifiprotect Bug Fixes 19882 Various fixes
viessmann Bug Fixes 19942 Fix parsing of unit milliAmpere
19970 Fix parsing of unit KiloJoule
19973 Fix ViessmannAccountHandler tried updating when disposed
visualcrossing Bug Fixes 19931 preciptype is a list of strings not a single value
yamahamusiccast Bug Fixes 19895 Fix NPE/instability on UDP state update

User Interfaces

UI Type Issue Change
Basic UI Bug Fixes 3675 Align handling of webaudio setting with Main UI
Main UI Enhancements 3645 Keep model picker and sitemap editor visualisation toggle states across sessions
Bug Fixes 3642 Fix groups not saved when adding points or equipment to model
3647 Fix blank screen if simple navbar is enabled
3650 Fix searchbar in binding selection when adding Thing
3653 oh-swiper: Don't set swiper-slide width to 100%
3654 Overview tab: Remove extraneous top space
3656 Script editor: Allow return outside functions/global return
3662 Fix Main UI load fails if implicit user role is disabled
3663 Persistence health page: Fix invalid problem link
3665 generic-widget-component: Only bind $attrs to parent element
3673 Thing page: Fix Z-Wave network viewer action, thing action caching, action config groups
3677 oh-*-card widgets: Fix style applied to both oh-card and child component
3681 Charts/Analyzer: Fix rotation issue
3684 Model: Fix JS error on Item selection
3687 oh-map/oh-plan: Fix various Leaflet related issues
3706 Fix empty plusNanos() code generation
3707 oh-knob: Fix circle not filled & Can't control Item with NULL/UNDEF state
3708 Merge component.slots.after[0] & $slots.after
3709 oh-video: Fix video.js player loading lifecyle
3719 oh-block/widget-mixin: Make code more robust to missing values
3732 Model: Fix expansion state reset on returning into model
3733 useModelStore: Ensure required elements are present when converting to ModelItem

openHAB 5.1.0

22 Dec 20:59

Choose a tag to compare

This is the official release of openHAB 5.1.0.

The binaries are available on our download page and via "Stable" on our APT repository.

New and Noteworthy

The openHAB 5.1 release is a feature release that 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.

Please also note our release blog post, which describes the major new features in depth.

openHAB 5.1 is backward compatible to openHAB 5.0 setups, though there are a few exceptions where manual action is required to adapt an existing setup, so please carefully check the section on breaking changes. It is especially important to know that openHAB 5.x requires Java 21, so in case you are coming from a 4.x installation and haven't yet upgraded, this is mandatory.

Quick links:

Relevant Changes

New Add-ons

The following add-ons are newly introduced:

Add-on Type Issue
HomeKit Binding #19340
Lambda Heat Pump Binding #19378
Midea AC Binding #17749
Modbus FoxInverter Binding #19637
MSpa Binding #18746
Roborock Binding #19117
Sedif Binding #18718
SomfyCUL Binding #19207
UniFi Protect Binding #19411
Viessmann Binding #19123

Runtime

The following improvements were made to the core and the distro:

Type Issue Change
Enhancements 4032 Add pcm audio websocket with dialog support
4682 Persistence no default strategies and persistence configuration health check
4793 New API for conversion between file format and JSON
4910 Add tests for rules and rule templates JSON parsers
4913 Apply default semantic tags from linked channels to items
4919 AbstractScriptModuleHandler: Remove prefixes from ctx keys when setting execution context
4929 Marketplace fixes
4932 Upgrade Karaf from 4.4.7 to 4.4.8
4937 Add ItemChannelLinkRegistry to DefaultScriptScopeProvider
4942 Update Jackson to 2.19.2
4943 Add jackson-datatype-jdk8 bundle to Jackson feature
4948 Apply timeout logging to scheduled executor service
4961 Add new HTTP actions for images
4967 Persistence extensions query optimization
4969 Apply blocked task logging to scheduled executor service
4983 Make REST endpoints accept more logger name characters
4990 Pass event source to profiles
5006 Fix network interface configuration option enumeration
5028 Details error message in log when, in an UI transformation, a script is the error cause.
5030 MQTT transport: add cleanSession/cleanStart parameter
5032 Isolate discovery result registrations from binding threads
5040 Add item overloads for providing source
5041 Allow passing source when sending commands via REST API
5051 Make TimerImpl thread-safe
5054 AbstractScriptModuleHandler: Inject module type ID into context
5064 Refactor BusEvent to ScriptExtension
5072 Same thread executor
5073 Set event source for updates and commands from bindings according to new standards
5074 Very minor rulesupport fixes
5077 Script DSL: accept Collection Literals
5079 Send source for console commands to items
5080 Include source with item event descriptions when present
5081 Pass event sources through item state update/change events
5082 Set event source for restoring item states from persistence
5083 Allow cross-binding bridges
5092 Refactor Windows USB discovery
5094 Do not require Strategies{} in persistence/ files
5095 Support UPnP namespaces
5100 Add AbstractThingHandlerDiscoveryService constructor for tests to use
5106 make FilterCriteria.Operator.getSymbol public
5110 Added dimension for price per volume and related currency units
5119 Added support for TimeSeries on Offset-Profile
5122 Populate source when sending Item events via BusEvent
5131 Allow source from header in REST API
5140 Added semantic property for Prices
5142 Lower the log level for useTags
5153 Changes prefix for isolated models
5164 Add a couple more methods
5178 Add HomeAssistantAddonUpgrader to upgradetool
5180 Add HomieAddonUpgrader to upgradetool
Bug Fixes 4917 Map chart interpolation parameter into sitemap JSON response
4922 AbstractScriptModuleHandler: Recompile scripts on dependency change
4928 DSL Items Parser: Fix incorrect parsing of keywords encountered in the wrong context
4971 Fix script engine missing error during startup
4974 Fix ActionHandler nullness annotation
4978 Fix version number in YAML examples
4996 Fix USB discovery on Windows in ...
Read more

openHAB 5.1.0.RC3

21 Dec 22:53

Choose a tag to compare

This is a Release Candidate build for the upcoming openHAB 5.1 release, which brings the following fixes:

Add-ons

Add-on Type Issue Change
ahawastecollection Bug Fixes 19833 Fix typo in channel id lightweight
matter Bug Fixes 19844 Prevent adding an OnOff switch to a Fan when not intended

User Interfaces

UI Type Issue Change
Main UI Bug Fixes 3632 Config parameter: Fix password cannot be displayed if read-only
3634 useRuntimeStore: Fix docSrcUrl computation for RC versions
3635 Vite: Emit static assets to dedicated dirs & cache in service worker
3636 Thing details: Display channels tab after going back from channels
3637 Script/Code editor: Fix search panel closes on click
3639 Things Inbox: Fix JS issues including missing f7router
3640 Add-on details: Fix invalid back navigation

openHAB 5.1.0.RC2

20 Dec 23:14

Choose a tag to compare

This is a Release Candidate build for the upcoming openHAB 5.1 release, which brings many fixes and improvements.

Runtime

Type Issue Change
Bug Fixes 1847 update script: Apply file ownership for files created by upgradetool
5213 Persistence upgrader: Fix unmanaged config not respected
5214 Fix /links/orphans API (return of the result)

Add-ons

Add-on Type Issue Change

User Interfaces

UI Type Issue Change
Main UI Bug Fixes 3625 Only show the clipboard copy confirmation when necessary

openHAB 5.1.0.RC1

19 Dec 23:54

Choose a tag to compare

This is a Release Candidate build for the upcoming openHAB 5.1 release, which brings many fixes and improvements.

Runtime

Type Issue Change
Bug Fixes 5194 EnrichedSemanticTagDTO members not listed in openapi spec
5196 Perform simple escaping when building event sources
5197 Fix minor copy-pasted text inconsistencies and typos
5201 Upgrade JUPnP to 3.0.4
5212 Persistence upgrader: Create default persistence settings if no configuration so far

Add-ons

Add-on Type Issue Change
freeboxos Bug Fixes 19814 Add IPSec VPN server
homewizard Bug Fixes 19829 Fixed setting mode 'standby' for batteries not supporting the latest api version
velbus Bug Fixes 19803 Add missing channel 80 and fix label

User Interfaces

UI Type Issue Change
Main UI Bug Fixes 3587 Charts: Add missing number format localization
3589 Follow-up fixes and enhancements for #3123
3595 Fix stylesheet not working for layout grid items
3596 useStatesStore: Don't request constructor prop from SSE
3598 Analyzer: Fix controls cannot be reopened
3601 oh-state-series: Fix incorrect end time calculation
3602 Developer -> Widgets: Fix tags not shown anymore
3603 oh-toggle: Fix regression for Dimmer items
3605 Analyzer: Fix controls not closed when analyzer closed
3606 Model cards: Fix back navigation from analyzer
3608 Fix back button issue
3610 Blockly: Fix ReferenceError due to non-existing input
3611 Fix issues with addons-setup-wizard
3612 oh-plan-page: Make marker tooltips non interactive
3614 config-parameter: Fix showPassword icon does not show up
3615 Analyzer: Fix style leak & Reduce vertical block margin
3616 oh-map-marker: Display default icon if nothing set
3620 Analyzer: Fix Vue render error on Item change

openHAB 5.1.0.M4

14 Dec 21:12

Choose a tag to compare

This is a monthly milestone build for the upcoming openHAB 5.1 release, which brings many fixes and improvements.

New Add-ons

The following add-ons are newly introduced:

Add-on Type Issue
HomeKit Binding #19340
Sedif Binding #18718
UniFi Protect Binding #19411
Viessmann Binding #19123

The following improvements were made:

Runtime

Type Issue Change
Enhancements 4682 Persistence no default strategies and persistence configuration health check
5077 Script DSL: accept Collection Literals
5142 Lower the log level for useTags
5153 Changes prefix for isolated models
5164 Add a couple more methods
5178 Add HomeAssistantAddonUpgrader to upgradetool
5180 Add HomieAddonUpgrader to upgradetool
Bug Fixes 5098 Script DSL: do implicit import java.time.temporal.ChronoUnit;
5104 Change error code 500 to 400
5144 Add missing 400 response documentation to REST API endpoints
5151 Eliminate double localization of discovery results
5154 Consider item pattern formatter even without label
5181 Handles properly channels with group

Add-ons

Add-on Type Issue Change
ecovacs Enhancements 19745 Update supported device list
19750 Add support for Deebot X8
emby Bug Fixes 19752 Fix WebSocket buffer overflow for large session payloads
energidataservice Enhancements 19748 Remove binding configuration
entsoe Enhancements 19676 Quarterly-hour prices
freeboxos Enhancements 19669 Add VPN Server monitoring
hdanywhere Bug Fixes 19804 Deduplicate channel type
homeassistant Enhancements 19767 Move binding to configuration to the proper place
homewizard Enhancements 19765 Update batteries channels to latest api version
homie Enhancements 19700 Split Homie from MQTT Binding
http Enhancements 19519 Replace deprecated URL constructor
jsscripting Enhancements 19740 Upgrade to openhab-js 5.16.1
lifx Bug Fixes 19788 Eliminate log warnings for fixed color temperature lights
matter Enhancements 19762 Door Lock Pin Code Support
modbus.e3dc Enhancements 19763 Add performance ratio channels
monopriceaudio Enhancements 19775 Add support for 8 zone model
pythonscripting Enhancements 19793 Update helperlib.version to 1.0.15
roborock Bug Fixes 19760 Update login to use new protocol
sunsynk Bug Fixes 19741 Adapt to user logon requires a nonce and sign.
Yamaha MusicCast Enhancements 19798 Set DAB and FM tuner presets

User Interfaces

UI Type Issue Change
Basic UI Enhancements 3281 Adjust prefs label/description related to icons
3518 New NULL or UNDEF rendering for Slider, Colorpicker and Colortemperaturepicker
HABot Enhancements 3467 add source to commands
Main UI Enhancements 3123 Persistence strategies not automatically applied
3398 Upgrade to Blockly v11 and respective plugin versions
3483 Analyzer: Refactor to TypeScript and add oh-state-series support
3503 Refactor config sheet advanced toggle
3531 Update Google Assistant Metadata Definition
3554 Sitemap default icon for input widget
3564 Item picker: Refine group filter and add semantic filter
3577 Refactor $oh.media to TypeScript and use fetch()
3579 Compact F7 tables on Aurora
Bug Fixes 3530 Fix developer-dock title width too narrow
3536 Remove manual service worker registration
3539 oh-grid-layout: Fix grid widget sizing issues
3540 Redirect /overview to /overview/
3541 Fix oh-grid-item configuration not possible & Page save error
3542 Model page: Various style fixes
3543 oh-popup, oh-popover & oh-sheet: Several fixes
3544 Charts: Fix duplicate REST requests
3545 Fix other apps title too narrow
3546 oh-grid-item: Fix wrong configure/YAML popups opened
3547 Layout edit: Fix onPageBeforeOut clean-ups not performed in some cases
3548 oh-popover: Fix incorrect popover positioning
3549 oh-layout-page: Fix stylesheet not working
3552 Thing page: Fix channels cannot be added or edited
3553 oh-cell: Fix expanded cell is hidden below other widgets
3555 oh-context: Properly inherit attributes
3560 Rule edit: Fix condition wizard issues
3566 Adjusted comment text style to black to be visible on yellow background
3568 Thing details: Code tab fixes
3571 parameter-options: Fix issues due to type-mismatch for INTEGER/DECIMAL
3574 Fix back navigation issues for Thing add pages
3578 Analyzer/Charts: Fix week starting on Sunday starts on Monday
3584 Setup wizard: Fix location picker not opening
3585 Fix developer searchbar & item picker search not focused