Lovelace Windrose Card

aukedejong · March 3, 2026, 6:30pm

Release version 2.0.0

Finally the next big version is ready. I made it a major version bump, because there are breaking configuration changes.

The configuration error messages should guide you in fixing the cards configuration.

Four feature requests are implemented.

For me the coolest new feature, it’s possible to play an animation of the windrose over time.
There is a new example in the EXAMPLES.md which demonstrates this.

Bugs, please report them on GitHub.

The new features:

More options to configure a time period with a period code, exmaple: -200h (200 hours), -2w (2 weeks), -2m+1w (2 month, 1 week)
Button to toggle between the speed sensor used for the rose graph. Fixes #172.
Button to shift the time period hours back or forward in time.
Button to start an animation of windrose over time.
Windbar scale options added: percentage relative. Fixes #167.
Rose legend circle percentages configurable, default auto.
Added use_for_windrose in windspeed_entities object. Can be changed with a button.
New data_period option: preset_period
Possible options: today, yesterday, last_7_days, last_30_days, this_week, last_week, this_month, last_month, last_6_months, this_year, last_year
The data_period properties can be used in the buttons config. With a button click you can change the period and statistics config of the data used. Fixes #174
New template vars: start_date, start_time, end_date, end_time
The exact start and end date time of the active period. Useful when using buttons to shift the time period.
Rename template vars: period-hours and period-minutes to match-period-hours and match-period-minutes.
New template vars: period-hours and period-minutes, now containing the whole period, not only that of the first and last matched measurement.
When there is no value available for an template variable, the placeholder is removed from the template.
Improved error handling, when no measurements are found.
Button border color can now be configured. Fixes #176
Default generated config uses more features.
All removed/moved/changed config options should show an error message with helpful info, to help with the upgrade.

For a complete list see: RELEASE_NOTES.MD

Spax279 · March 4, 2026, 5:43pm

Hi
With the Update i get following error

Konfigurationsfehler
speed_ranges option on root level is moved to windspeed_entities object.

Can somebody fix it ?
This is my YAML Code

ttype: custom:windrose-card
title: null
data_period:
  period_selector:
    location: bottom
    active_color: black
    active_bg_color: white
    log_measurement_counts: true
    buttons:
      - hours: 1
        title: 1h
      - hours: 12
        title: 12h
      - hours: 24
        title: 1 Tag
        active: true
      - hours: 240
        title: 10 Tage
refresh_interval: 30
windspeed_bar_location: right
wind_direction_entity:
  entity: sensor.wetterstation_windrichtung
  name: Windgeschwindigkeit
  use_statistics: false
  direction_compensation: 0
windspeed_entities:
  - entity_id: sensor.wetterstation_windgeschwindigkeit
    name: Windgeschwindigkeit
    speed_unit: kph
    use_statistics: false
    windspeed_bar_full: true
    output_speed_unit: kph
    speed_range_beaufort: false
    center_calm_percentage: true
speed_ranges:
  - from_value: 0
    color: green
  - from_value: 10
    color: yellow
  - from_value: 20
    color: blue
  - from_value: 30
    color: orange
  - from_value: 40
    color: red
corner_info:
  top_left:
    label: Windgeschwindigkeit
    unit: " km/h"
    entity: sensor.wetterstation_windgeschwindigkeit
    label_text_size: 40
    value_text_size: 50
    input_unit: kph
    output_unit: kph
    precision: 1
  top_right:
    label: gefühlte Temperatur
    unit: " °C"
    entity: sensor.wetterstation_gefuhlte_temperatur
    label_text_size: 40
    value_text_size: 50
    input_unit: kph
    output_unit: kph
    precision: 1
  bottom_right:
    label: Luftdruck
    unit: " hPa"
    entity: sensor.wetterstation_luftdruck_nhn
    label_text_size: 40
    value_text_size: 50
    input_unit: kph
    output_unit: kph
    precision: 1
  bottom_left:
    label: Luftfeuchte
    unit: " %"
    entity: sensor.wetterstation_luftfeuchte_1
    label_text_size: 40
    value_text_size: 50
    input_unit: kph
    output_unit: kph
    precision: 1
direction_labels:
  cardinal_direction_letters: NOSW
  show_cardinal_directions: true
  show_intercardinal_directions: true
windrose_draw_north_offset: 0
current_direction:
  show_arrow: true
  arrow_size: 80
  center_circle_size: 30
compass_direction:
  auto_rotate: false
  entity: ""
cardinal_direction_letters: N,O,S,W
matching_strategy: direction-first
center_calm_percentage: true
background_image: /hacsfiles/lovelace-windrose-card/H30_2.png

Cadster · March 4, 2026, 6:41pm

Just follow the msg and you wil be oke, also look at the examples.

windspeed_entities:
  - entity_id: sensor.wetterstation_windgeschwindigkeit
    name: Windgeschwindigkeit
    speed_unit: kph
    use_statistics: false
    windspeed_bar_full: true
    output_speed_unit: kph
    speed_range_beaufort: false
    center_calm_percentage: true
    speed_ranges:
    - from_value: 0
      color: green
    - from_value: 10
      color: yellow
    - from_value: 20
      color: blue
    - from_value: 30
      color: orange
    - from_value: 40
      color: red

And so work your way throug de error msgs.

aukedejong · March 9, 2026, 6:14pm

Release version 2.1.0

Reminder, if you skipped version 2.0.0, ithas breaking changes. The error message should guide you to a correct configuration.

Features:

Added clip_background_image option in rose_config. Hide the background image part outside the outer circle. Fixes #184
Added option new_row for button, force the button to the next row. Fixes #178

Fixes:

Don’t allow data_period and active period_selector button at the same time… Before the active button was used for the period, the data_period was ignore.
Default config for new card still used the hours_to_show option. Fix the default generated config and made it use a more features.
Text cleanup in the examples, fixes #192

aukedejong · March 17, 2026, 6:29pm

Release version 2.2.0

Features:

Added Period code options for minutes and seconds. Example -10s (10 seconds back) and -10mi (10 minutes back). Fixes #194
Added rose_opacity option, useful if you want the background to be visible. Fixes #198

Fixes:

When using relative period config, recalculate the time period when the card auto refreshes. Fixes #199

aukedejong · March 23, 2026, 6:31pm

Release version 2.3.0

Feature or fix:

When a percentage doesn’t fit the windbar segment, a dot is visible. When hovering/touching the segment, a popup shows the percentage. Fixes #193

aukedejong · April 3, 2026, 11:39am

Release version 2.4.0

Feature:

Center circle, where the calm percentage normally is displayed, can now be configured to show other values. Fixed #78

Fixes:

Fixed situations where a lot of log message where logged. Thanks 2bitoperations
Auto determining input speed unit when used in corner info. Fixes #203

vbakh · June 4, 2026, 11:40am

Great card, thanks a lot!!!
Could you please explain how wind direction and speed measurements are mapped to the (up to) 32 windrose segments?
Does windrose show the last <wind_direction_count> values, or use some kind of sampling or aggregation?

aukedejong · June 4, 2026, 3:55pm

Hi,
I'm not sure I understand your question correctly.
Did you have a look a the readme?

https://github.com/aukedejong/lovelace-windrose-card#Object-matching_strategy

Depending on the matching strategy wind direction and windspeed measurements are matched.

The rose_config.wind_direction_count configures the amount of leaves the windrose can display.
Every matched measurement couple is grouped per wind direction range and speed range. Percentages are calculated with these counts.

Does this answers your questions?

vbakh · June 4, 2026, 7:15pm

Yes, it does. Thanks a lot!

freedom2000 · July 25, 2026, 8:07pm

Hi,

Quite new to HA and even newer to your great wind rose card, I already love both of them.

I built an open source/open hardware weather station a few years ago and decided to integrate it into my HA.
public access is here : https://thingspeak.mathworks.com/channels/2209680

And my HA integration is there

So far so good, but this card doesn’t work on my pixel 6 smartphone running latest Android 17 kernel !

I opened an issue on github.
Thanks for sharing your work
JP

KruseLuds · July 26, 2026, 3:12am

I love that! Your weather station on that website - are you sending them the information, or - ?

freedom2000 · July 26, 2026, 8:12am

HI,
Thanks,
Yes this station is a little “complex” as the airfield is far away from the house which is hosting internet access (2km). So I have put a lora network between station and house.

Station wakes up every 2min during day time (1 hour during night) and performs measurements and sends them to house.
House sends them to thingSpeak and to WindyApp and synchronizes next wake up of the station

All the details are here : https://hackaday.io/project/191652-long-range-weather-station-65

I am even surprised by the overall reliability of this solar powered cheap system

KruseLuds · July 26, 2026, 3:48pm

Very nice!

aukedejong · August 16, 2026, 8:28am

Released version 2.4.3

Fix:

Fix errors in introduced in previous build, related to date time formatting and the log_measurement_counts option. Fixes #219

Thanks il77781 for reporting the bug.

aukedejong · August 18, 2026, 5:24pm

Released version 2.4.4

Fix:

Adds target ES2017 to esbuild, to support older browsers. Fixes #222

Thanks tikhdm for the PR

aukedejong · August 22, 2026, 1:37pm

Release version ~~2.5.0~~ 2.6.0

Feature:

Adds the possibility to use min and max Home Assistant statistics data. Before only the mean value was used.

Thanks sanchobear. Fixes #223

aukedejong · August 29, 2026, 1:31pm

Released version 2.7.0

Fix, feature change statistics type config:

Type min and mix is not supported by wind direction sensors, removed config option. Type mean is always used.
More info, see readme paragraph Home Assistant data retention