Skip to content

Commit 0a2147b

Browse files
committed
update: readme
1 parent 60d83f9 commit 0a2147b

File tree

2 files changed

+22
-373
lines changed

2 files changed

+22
-373
lines changed

README.md

Lines changed: 11 additions & 187 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,13 @@ The **SILAM Pollen** integration provides a service consisting of sensors that d
3333
>
3434
> To evaluate coverage and choose the appropriate dataset, use the interactive map below.
3535
36-
[![Interactive pollen coverage map](https://danishru.github.io/silam_pollen/pollen_area.webp)](https://danishru.github.io/silam_pollen/)
36+
<a href="https://danishru.github.io/silam_pollen/" target="_blank" rel="noopener">
37+
<img
38+
src="https://danishru.github.io/silam_pollen/pollen_area.webp"
39+
alt="Interactive pollen coverage map"
40+
style="max-width:100%; cursor:pointer;"
41+
/>
42+
</a>
3743

3844
## 🆕 What’s new
3945

@@ -59,193 +65,11 @@ These changes are especially important ahead of the pollen season, ensuring time
5965

6066
[![More in release v0.3.1](https://img.shields.io/badge/More--in--release-v0.3.1-blue?style=flat)](https://github.com/danishru/silam_pollen/releases/tag/v0.3.1)
6167

62-
## Previous updates
63-
<details>
64-
<summary>Show</summary>
65-
66-
### v0.3.0 🚀 One glance — the full picture of weather and pollen.
67-
v0.3.0 delivers a cohesive experience: one card brings together weather and pollen with a familiar look, fast response, and clear presentation. The integration now ships **with the dashboard card included**: a local JS module is bundled — no CDN or external dependencies (you only need to add it once under “Resources”). The Basic panel preserves the simplicity of the stock Weather card, while the Extended panel unfolds all forecast and allergen layers — tidy, informative, and straight to the point.
68-
69-
![image](https://github.com/user-attachments/assets/2ccdf8ff-5afe-446f-a775-9c842e5c5060)
70-
71-
- 💠 **Experimental Lovelace card (local build)**
72-
- Self-contained JS bundle, **no CDN**, works offline.
73-
- Built-in visual editor (**LitElement**) — configure right in the UI.
74-
- **Live WebSocket updates** — no polling delays.
75-
- **Automatic i18n**: language, formats, and units from Home Assistant.
76-
- **Native MDI icons** and theme support.
77-
- **Compatible with any `weather.*`**, shines with `weather.silam_pollen_*_forecast`.
78-
79-
- 🖼 **Basic panel**
80-
- Mirrors the stock Home Assistant Weather card for maximum visual consistency.
81-
- For current weather, shows current conditions and **one primary attribute of your choice** — just like the stock card — and additionally lets you select **an unlimited number of draggable** attributes (toggle **row** or **column** layout).
82-
- When forecast is enabled for **SILAM**, the **forecast row** shows the **pollen index icon and state** instead of weather condition and temperature; for other weather integrations, behavior is **identical to the stock card**.
83-
- Supports a **scrollable list of forecast slots** if they don’t fit horizontally.
84-
- **Number of slots** is configurable in the editor: up to **12** via slider or **unlimited** via manual input.
85-
- Selecting attributes in the **additional block** unlocks wide possibilities to visualize weather data the way you like.
86-
87-
- 📊 **Extended forecast panel**
88-
- Modes: **Standard**, **Focus**, **Minimal**.
89-
- 🌿 **Allergen-level forecasts**
90-
![image](https://github.com/user-attachments/assets/15a81dae-7c99-4418-9525-08411045bd56)
91-
92-
- **A dedicated forecast line** for each selected allergen.
93-
- **Peak concentrations** highlighted in 12-hour and daily views.
94-
- **Show details on tap** on pollen blocks: opens the sensor card for the tapped allergen; behavior is configurable in the editor.
95-
- **Trend logic + icon** — clear up/down indication.
96-
-**Full forecast layers**
97-
![image](https://github.com/user-attachments/assets/b3d2b70a-fec7-4d37-b6b9-add38f4119a8)
98-
99-
- **Temperature** and **apparent temperature**, **precipitation** (probability and amount), **UV index**, **wind** (speed, gust, direction), **cloud coverage**, **humidity**, **dew point**, **pressure**.
100-
- **Meteo risk strip (experimental)**: fog (radiation/advection), dew, frost, icing/freezing rain, heavy rain/snow, heat, wind chill, strong/storm wind, “barometric saw”.
101-
- Slim strips for **humidity** and **dew point**, clear labels, refined typography.
102-
- **Gestures**: **tap** / **hold** / **double tap** (navigate, link, call service, perform action).
103-
104-
> [!IMPORTANT]
105-
> **After updating**, add the module manually:
106-
>
107-
> [![Open your Home Assistant instance and show your dashboard resources.](https://my.home-assistant.io/badges/lovelace_resources.svg)](https://my.home-assistant.io/redirect/lovelace_resources/)
108-
> **Settings → Dashboards → Resources → Add** → URL: `/local/absolute-forecast-card.js`**Resource type: JavaScript Module**.
109-
110-
---
111-
112-
### 🌿 Updated pollen sensor model
113-
- 🌸 **Pollen Forecast Sensor — now primary and out of beta**
114-
- 🗂️ **Pollen Index — deprecated**
115-
- Marked as **deprecated**.
116-
- Available only via the **Legacy** toggle (**off by default** for new installs).
117-
- **Migration** preserves compatibility: existing entries get `legacy=true`.
118-
119-
> [!NOTE]
120-
> If you relied on the previous index or legacy allergen aggregation, review and adjust thresholds in your automations and scripts.
121-
122-
[![More in release v0.3.0](https://img.shields.io/badge/More--in--release-v0.3.0-blue?style=flat)](https://github.com/danishru/silam_pollen/releases/tag/v0.3.0)
123-
124-
### v0.2.7 🚀 Major update of the "Pollen Forecast BETA" sensor!
125-
After its beta period, the forecast sensor is heading for a stable release—bringing more accuracy, data and possibilities for your dashboards.
126-
127-
- 🔄 **Re-worked algorithms in "Pollen Forecast BETA"**
128-
- The `state` now reflects the **current** pollen index from the *now* block, not the first hourly step.
129-
- Hourly forecasts aggregate the index and allergen levels by **maximum** within each three-hour window (was median).
130-
- Daily and 12-hour values are calculated using an **observational percentile** (no interpolation):
131-
≥ 18 points → 80th percentile · 12–17 points → 70th · < 12 points → maximum.
132-
133-
- 🌸 **Forecast sensor is always created**
134-
Sensor `weather.silam_pollen_{Zone Name}_forecast` is present regardless of options—*now* data are always available; **hourly**, **twice-daily (12 h)** and **daily** forecasts appear **only when the forecast option is enabled**.
68+
## All updates
13569

136-
- 🌅 **Daily forecast & allergen peaks**
137-
The sensor now includes a **daily forecast** (up to five days) based on the observational percentile.
138-
New attribute `allergen_peaks` reports **peak allergen concentrations** for both daily and twice-daily windows—shown when specific allergens are enabled.
139-
140-
-**New attributes for "Pollen Forecast BETA"**
141-
`next_condition`, `pollen_<allergen>`, `altitude`, `date`, `responsible_elevated`—extra context for automations and dashboards.
142-
143-
- ⏱️ **Diagnostic sensor “Forecast Horizon”**
144-
The new `sensor.silam_pollen_{Zone Name}_forecast_horizon` shows how many hours the current forecast (`state`) actually covers and what forecast length (`forecast_duration`) you asked for.
145-
146-
- 🖼️ **Supported in pollenprognos-card v2.4.1+**
147-
The card now renders the daily forecast via `weather.get_forecasts`.
148-
> **Version compatibility**
149-
> • pollenprognos-card ≥ **v2.4.1** requires **silam_pollen ≥ v0.2.7**
150-
> • Older card versions (≤ v2.4.0) remain compatible with silam_pollen ≥ v0.2.5.
151-
152-
> [!IMPORTANT]
153-
> These new algorithms may affect automations that relied on the old index or allergen-level values. Review your scripts and adjust thresholds or conditions if needed.
154-
155-
[![More in release v0.2.7](https://img.shields.io/badge/More--in--release-v0.2.7-blue?style=flat)](https://github.com/danishru/silam_pollen/releases/tag/v0.2.7)
156-
157-
### v0.2.6
158-
159-
- 🆕 **`native_name` Attribute**
160-
All allergen sensors now include a `native_name` attribute that reflects the original SILAM API key (e.g. `alder_m22`, `grass_m32`, etc.), ensuring better compatibility with external tools and visualizations.
161-
162-
- 🔧 **Unified `entity_id` Naming**
163-
Entity IDs (including defaults and resets) now correspond exactly to the keys in the localization files. For example, `sensor.silam_pollen_{Zone Name}_grass` remains identical across all languages and for every sensor in the integration.
164-
165-
> [!IMPORTANT]
166-
> To revert your entities to the new default names, follow the [device customization guide](https://www.home-assistant.io/docs/configuration/customizing-devices/) in the Home Assistant documentation.
167-
168-
> [!NOTE]
169-
> If you’ve already created automations or scripts, remember to update the referenced `entity_id` values.
170-
> > If your Home Assistant system language is English or Russian, you can ignore this notice — entity IDs will remain unchanged for these languages.
171-
172-
[![More in release v0.2.6](https://img.shields.io/badge/More--in--release-v0.2.6-blue?style=flat)](https://github.com/danishru/silam_pollen/releases/tag/v0.2.6)
173-
174-
### v0.2.5 🌟
175-
176-
This is a truly significant update for **SILAM Pollen**!
177-
178-
- 🎉 **Default HACS integration**
179-
Congratulations to us all — the integration is now included in the official HACS repository by default, making installation easier than ever!
180-
181-
- 🖼️ **Beautiful dashboards**
182-
Great news for dashboard lovers: [@krissen](https://github.com/krissen) has added **SILAM Pollen** support to the [pollenprognos-card](https://github.com/krissen/pollenprognos-card) (since v2.3.0) — now current conditions and pollen forecasts are available right on your dashboard!
183-
[Learn more here 👈](#dashboard-card)
184-
185-
- 📈 **Long-term statistics**
186-
Pollen sensors and the new diagnostic sensor now collect and display historical data.
187-
188-
[![More in release v0.2.5](https://img.shields.io/badge/More--in--release-v0.2.5-blue?style=flat)](https://github.com/danishru/silam_pollen/releases/tag/v0.2.5)
189-
190-
### v0.2.4
191-
192-
- **📖 Default README in English**
193-
The README file is now presented in English by default.
194-
195-
[![More in release v0.2.4](https://img.shields.io/badge/More--in--release-v0.2.4-blue?style=flat)](https://github.com/danishru/silam_pollen/releases/tag/v0.2.4)
196-
197-
### v0.2.3
198-
199-
- **📦 Prepared for HACS publication**
200-
Changes made to host the integration in the default HACS catalog.
201-
- **🌐 Added Slovak translation**
202-
Thanks to [@misa1515](https://github.com/misa1515) for implementing the Slovak localization!
203-
- **🌐 Added Dutch translation**
204-
Thanks to [@rubdos](https://github.com/rubdos) for implementing the Dutch localization!
205-
206-
[![More in release v0.2.3](https://img.shields.io/badge/More--in--release-v0.2.3-blue?style=flat)](https://github.com/danishru/silam_pollen/releases/tag/v0.2.3)
207-
208-
### v0.2.2
209-
210-
- **⏱️ Forecast duration setting**
211-
When creating or modifying an entry, you can now choose the forecast duration from 36 to 120 hours (default is 36 h). As the hours increase, the number of forecast points twice a day increases proportionally.
212-
- **🛠️ Diagnostic sensor “fetch_duration”**
213-
A sensor to display the data update execution time (API requests, processing, calculations). Disabled by default.
214-
- **🌐 Added Czech translation**
215-
Thanks to [@kasparmir](https://github.com/kasparmir) for the first implementation of the Czech localization!
216-
217-
[![More in release v0.2.2](https://img.shields.io/badge/More--in--release-v0.2.2-blue?style=flat)](https://github.com/danishru/silam_pollen/releases/tag/v0.2.2)
218-
219-
### v0.2.1
220-
221-
**🌸 Pollen Forecast (BETA)**
222-
- Hourly and twice-daily pollen forecasts now include values for selected allergens.
223-
- For each pollen sensor, there is now an attribute with the forecast for the next day, showing the daily forecast for the next day, just like for the pollen index.
224-
225-
[![More in release v0.2.1](https://img.shields.io/badge/More--in--release-v0.2.1-blue?style=flat)](https://github.com/danishru/silam_pollen/releases/tag/v0.2.1)
226-
227-
### v0.2.0
228-
229-
- **🌍 Support for two SILAM versions**
230-
Ability to choose between `SILAM Europe (v6.0)` and `SILAM Regional (v5.9.1)` — with an automatic availability check.
231-
`SILAM Regional (v5.9.1)` provides more **detailed and accurate forecasts** for Northern and Northwestern Europe.
232-
233-
- **🌸 Pollen Forecast (BETA)**
234-
New weather sensor with hourly and twice-daily pollen forecasts via `weather.get_forecasts`.
235-
236-
- **📊 Unified data handler + update service**
237-
All data are cached through `data_processing.py`.
238-
Added service `SILAM Pollen monitor: Manual Update` — can be called manually or in automations.
239-
240-
- **🎨 Icons for integration and sensors**
241-
Visual indicators are clearer: each allergen now has its own icon.
242-
243-
- **🌐 Localization (in 8 languages)**
244-
The interface is translated into: Russian, English, Finnish, Italian, Swedish, Norwegian, Danish, and German.
245-
246-
[![More in release v0.2.0](https://img.shields.io/badge/More--in--release-v0.2.0-blue?style=flat)](https://github.com/danishru/silam_pollen/releases/tag/v0.2.0)
247-
248-
</details>
70+
<a href="https://danishru.github.io/silam_pollen/site/blog" target="_blank" rel="noopener">
71+
Release history and changelog archive ↗
72+
</a>
24973

25074
## Installation
25175

0 commit comments

Comments
 (0)