Repository navigation
FreshAirIQ 0.26.7.0
FreshAirIQ 0.26.7.0
The living house map: room information of your choice, a rooms overview, floors per card, the removable moisture by room and a weather world that joins house, sun, wind and weather – plus an honest fan wording on the map and an optional global automation lock.
House map
- Room information on the plan (card option
room_info, per roomroom_overrides, also in the card editor): any combination of name, temperature, relative and absolute humidity, recommendation, CO₂ and mould risk. Without a choice the label is exactly as before; a layer chosen in the menu still shows its reading. Small rooms drop readings first and keep door leaves and open sashes free; hidden values stay in the room details. - Optional "Rooms" button next to the menu (
rooms_button): every room of the shown floors in the map's own style with temperature, relative/absolute humidity, recommendation, mould risk and removable moisture; a tap opens the room details, ⌖ shows the room on the plan (its floor, a short highlight). Live updates refresh the open window in place. - Floors per card (
floors_visible,default_floor): hidden floors never return by themselves (auto focus included), one floor always stays; display only – calculation and saved plan unchanged. Still no "all floors" view. - The moisture chip's window lists the removable moisture by room – the rooms' own published values (realistic amount for the recommended time, or during an airing the amount so far and the time left) with floor and state; the total is the FreshAirIQ card's, a rounding difference is shown.
- Weather world (
weather_effects: off · subtle · dynamic = as before · full). "Full": the light of the real sun (sun.sun) in colour and strength, a sky that follows the sun's elevation steplessly, the house's shadow away from the sun (only with a confirmed north, none under a cloud deck), clouds and rain with the measured wind, gusts sweeping the garden in strong wind and storm, rings of rain on the ground and a darker sky in heavy rain and thunderstorms, a soft rare brightening (no claimed strike), fog veil, cool frost light, stars, and the moon's phase only with a moon-phase entity. Effects stay outside the rooms and never cover labels. - Weather overview behind the weather chip (or "Weather" in the menu), in the map's sky: condition, temperature, feels like, humidity, pressure (hPa), chance of rain, date/time, the sun's day arc, the next hours as a curve with rain bars, the next days as ranges, the wind as a compass rose with Beaufort; every part optional (
weather_info, also a compass rose on the plan). Optional own weather entity (weather_entity); forecasts through Home Assistant'sweather/subscribe_forecast, one shared subscription per entity and type, only while something shows them. Units converted (wind, pressure); missing values show "–". - Weather details: with an own weather entity, wind speed, gusts and direction come from that entity (overview, compass rose, clouds, rain, wind streams); FreshAirIQ's wind fills only a missing value and is then named. Compass texts (NW, SW, NNE …, also German) are accepted for the wind direction – in the card and in FreshAirIQ's own wind evaluation, which dropped a text direction before. Date, time and forecast times follow Home Assistant's time zone. Forecast subscriptions are shared per Home Assistant connection (a connection change subscribes anew). Each value of the weather window can be chosen on its own (
weather_details: condition, temperature, apparent, humidity, pressure, rain_chance, dew_point, uv) – a value switched off never comes back by itself, none chosen shows none, no condition shows no symbol at all; cards that never chose any show all of them as before. - Smooth weather world: fewer rain rings, cheaper animations (opacity only, no blend mode, no mask over moving parts) – checked in a real browser for sun, rain, storm, snow, thunderstorm, day and night: labels stay uncovered, the effects stay inside the card.
- The weather at the top right shows what the card chooses (
weather_chip: temperature, condition symbol, humidity, wind, rain, feels like, pressure, sunrise/sunset, date/time; without a choice temperature and humidity as before, an empty choice shows none); a narrow card shows the first ones. A tap opens the full weather window. - A finer weather window in the map's sky: the present weather as a hero (a drawn weather symbol instead of emoji, temperature, condition, today's high and low, date and time), the values as labelled tiles (feels like, humidity, dew point, pressure, chance of rain, UV with its level), the sun's day as a lit arc with day length and the sun's elevation, the wind as a compass rose with gusts and a Beaufort scale, the next hours as a calm curve with symbols and rain bars, the next days as ranges with today's temperature marked. What the source lacks is left out.
- Rooms overview: the whole room card is the button (no extra round buttons beside it) – name, floor, recommendation in the plan's state colour and frame, temperature, relative and absolute humidity, mould risk and removable moisture; a tap opens the room's details and shows its floor behind ("Show on the plan" is in the room's window).
- A room tapped (on the plan or in the overview): its outline stands out, the rest of the floor is quieter, its windows and doors stay visible; the room's window tells everything the FreshAirIQ card knows about the room in the map's style – why (with every reason), climate with target, water in the air and CO₂, wall humidity and mould risk (and where the value comes from), moisture and forecast, air exchange, a moisture source, the fan, learning, windows and doors with their state and delay, the room model and extra sensors. Live updates refresh it in place.
- The menu (bottom right) grouped like a small app: information (the house's decision and key figures, more about the decision – water in the house air with its last days, airing threshold, night forecast, pollen, people at home, learning, last airing –, moisture by room, weather, rooms), control and modes (guests, the view on the plan, the animation level), tools (edit the floor plan, airing log as PDF/CSV – the FreshAirIQ card's own export –, support) and notes.
- Calmer wind: no small white strokes around the house any more; fewer ribbons, slower, each with its own lane, length, wave, pace and brightness – no two alike; the wind's strength stays readable (a breath of air: a few faint ribbons, a storm: more and livelier ones), the direction is unchanged. The air through an open window still flows in, without bright heads.
- Corrections: an explicit
weather_chipchoice wins over olderweather_sensors(a card with onlyweather_sensorsshows them as before); whatever the weather display at the top right shows, a tap opens the weather window (also withweather_info: [compact]only) – which parts the window shows stays the card's choice. - Every view behind the FreshAirIQ card's details is now in the house map, computed by the card itself (same data, rules and texts) and drawn in the map's style: "Lernt dein Zuhause kennen" with "Aktuell lernt FreshAirIQ" and the four learning areas, "Wie gut FreshAirIQ aktuell vorhersagt" with the passive formula comparison, water in the house air by room, airing threshold, night forecast, pollen, the IQ decision and the last airing (menu → Learning, house details → Background). The room details add the theoretical amount, the forecast's cost, the airflow factor, the last measurement and learning measurement with its diagnosis, feedback from reality, shadow learning, routine and strategy IQ, the balance of the last days and the display-only note.
- Performance checked under longer load: three house maps visible at once in a storm with full weather, 30 s with live updates – 75–110 ms main-thread time per second in total, 12–15 animation frames per second, no growth of DOM nodes or memory, nothing left running after removal. A real phone's temperature and energy use cannot be measured in the test environment (headless browser on a server CPU) – that remains an external runtime check.
- Animation levels (
animation_level: off · minimal · normal · intense · auto, also in the menu) and parts (animation_parts: wind, weather, light, ambient). Auto: reduced motion → off, a phone or small card → minimal, otherwise normal. With auto, a card untouched for 2 minutes steps down, after 10 minutes it rests (a still picture) until it is touched again; hidden, scrolled-away and covered (a window open) maps pause. One animation loop for every house map on the page, at the level's frame rate (12/20/30 per second) instead of the screen's 60, and a canvas resolution by level. Measured in the browser test (main-thread time per second, 0.26.7.0 → now): phone emulation 437 → 26 ms (default weather), 458 → 33 ms (storm), 385 → 12 ms (sun); desktop 140 → 53 ms, 186 → 60 ms, 119 → 54 ms; wind path updates 631 → 36 (phone) and 200 (desktop) per second. - Layout (
layout: auto · focus · info): a wide card uses its free sides for a weather and status column beside the plan; the plan's geometry is unchanged. - Performance: animations pause outside the visible area and on hidden pages, the air loop stops while paused, small cards draw fewer effects, reduced motion and
animation: falsekeep everything still; no timer or subscription stays after the card is removed. Dialogs fit short landscape screens. - A room aired only by its exhaust fan never reads "Close" on the map any more: the fan's state decides – "Switch the fan off" (by hand, failed command, no automation, automation lock), "Fan stops automatically", follow-up, moisture source, shared fan, other automation, lock period – with a matching tone, as the integration's messages and the FreshAirIQ card already did.
- Floor plan editor: "Rotate 90°" explains itself after choosing a room (about its centre, anticlockwise, windows and doors turn with it); the guides say the same.
UI hotfix
- "Intense" is lively again: an explicitly chosen level (minimal, normal, intense) no longer steps down after 2 minutes without a touch – only auto adapts by itself; hidden pages, cards out of view and reduced motion still pause or stop it. Intense draws more wind ribbons in three layers with a stronger swing and brightness, livelier clouds, rays and precipitation – still 30 frames a second, no white strokes.
- The menu no longer offers "View on the plan"; the card setting (start layer) decides the view, a view stored by the old menu no longer hides a changed setting.
- Sun arc: the marker lies on the drawn curve; the day runs from sunrise to sunset (solar noon at the top), the night on a flat arc below the horizon; with Home Assistant's location the day's sunrise and sunset are computed (NOAA, checked against astral), otherwise taken from sun.sun; polar day and night are named.
- Back in every window of the house map (top left, one level, scroll kept, Escape like Back, Close closes all); a window opened right from the plan has no made-up menu step; only one native dialog at a time.
- The weather display at the top right takes real mouse clicks and taps again (a decorative layer's
pointer-events: nonealso hit the button). - New choice "Absolute humidity" (g/m³) for the weather at the top right and the weather window – FreshAirIQ's own outdoor value (now also on the dashboard live channel, additive) or, for a chosen weather entity, its temperature and humidity with the integration's formula; invalid values are left out, existing choices stay.
- One continuous animated surface: no solid bars above and below the plan – sky, weather and wind ribbons run on under the controls; the sky and the moving weather (clouds, rain, snow, fog, stars, flash, gusts, rain rings) lie in their own layer under the plan that the browser only moves or fades instead of repainting the drawing – measured at 1440 px with full weather in a software-rendered browser: rain, storm and thunderstorm 50–83 → 33 ms per frame at the 95th percentile; the controls keep their places on semi-transparent backgrounds and never cover rooms, windows or doors. At minimal (phones) the wind stays around the house too and only the still sky continues under the bars; measured against the previous build under equal load: no higher main-thread time at off, minimal and normal, intense about 10 % more for its livelier picture.
Inside doors, house map and settings
- Inside doors: every opening contact now says where it leads – "Outside" (window, terrace, balcony or front door) or "Another room" (room door, inside opening), optionally with the connected room. An inside door never starts an airing, never chooses the incoming air, never counts for the contact mode "all", feeds no learning, statistics or forecast and never makes up cross ventilation; with an airing through a window it counts as the real connection between two rooms (open joins them, closed separates them unless a doorless opening joins them anyway). Existing contacts stay outside openings until you change them; a contact classified differently in two rooms is refused in the form and reported (previous behaviour kept). The exhaust fan keeps its own start reason.
- Removing a contact from a room leaves none of its settings behind (reference air, covers, cover follow, kind, passage door, side, connected room) – adding the same sensor again starts fresh; unchanged configurations are not touched.
- House map: outside air is drawn only where a real outside opening is open. A doorless passage or an inside door drawn on an outside wall is shown as a drawing conflict instead of a permanent air path, and the wind threads no longer slip through narrow joints between two drawn rooms; wind along the facades, sun and weather stay.
- Card settings in seven groups (General, Floors & navigation, Room information, Weather display, Weather window, Animation & look, Advanced) with a short explanation each, options shown in their context, outdated floors/rooms of another entry named with one-tap clean-up, no row wider than a phone; every key, value and default as before.
- Floor plan editor: shorter start, a hint for every mode and tool (L/U shapes, T shape via Precision), touch wording without keys, and steps ticked only when shown (a moved room, assigned contacts, a saved plan). North as a question with a compass rose (drag or angle, plain-language direction, examples); facades, wind and sun share one angle contract, checked against the Python side.
- Corrections after the review: one inside-door sensor names one door – a sensor shared by two rooms that also names a third room, or one shared by three rooms, joins no rooms and is reported as a configuration issue; a contact whose side is in conflict creates no inside connection. A window with an inside and an outside contact opens to the outside only by its outside contact. Cross ventilation reads inside doors with the same debounce as every opening, and a tilted three-state inside door reaches the house map as tilted.
- Settings: "Connected room" is explained as an inside-door setting and a room chosen for an outside opening is refused with an explanation instead of being dropped silently; clearer texts for the contact logic (inside doors never start an airing), the legacy cross-ventilation field and a contact set up differently in two rooms (German and English).
- Floor plan editor: a changed north angle needs a new confirmation (number field, keys and compass; the same angle keeps it), windows and doors naming a contact FreshAirIQ no longer has are marked and named in the hint (nothing is deleted), and "Adjust position and shape" follows the saved plan, also after reopening, undo and redo.
- House map windows (UI order): every window – removable moisture before and while airing, openings, air paths, a room without data, support, the menu – has the blue house map style; window titles in a readable colour on their header; tiles, hints and secondary texts checked at 4.5:1 in every window. "Removable moisture" explains in one sentence what is shown before and while airing, why the rooms listed differ, and why 0 ml can show right after opening; the full explanation is folded away. Names as the sensors ("Entfernbare Feuchtigkeit", "Prognosesicherheit"), minutes in the moisture window written alike.
- House map design (card editor "Design & colours", option
design): FreshAirIQ design (default, unchanged), the Home Assistant theme (light, dark, custom and transparent themes; a theme switch is followed at once) or own colours, border width and corner radius – for the frame and windows of this card only; plan, weather and the room state colours never change; unreadable combinations are replaced automatically. - Browser compatibility (Safari/WebKit, Firefox, wider system fonts): the floor plan editor keeps working when the browser refuses pointer capture (Firefox) and answers a size change in the next frame (no resize loop error in Safari); the forecast days, the menu entries of the house window and the card editor's selection fields stay inside narrow cards; a small room keeps its readings (down to the 12 px of the smallest name) before they are left out.
- Weather forecasts: when Home Assistant's connection changes, the house map moves its forecast subscriptions to the new connection at once and ends those of the old one (until now only with the next redraw – never in a hidden browser tab); a forecast another card still shows on the old connection stays.
- Room labels look the same in every weather: the plan keeps one rendering layer, so moving rain no longer switches the labels' font smoothing (subpixel → greyscale) in Chromium-based browsers.
Marketplace, downloads and branding
- hassfest: the translations follow Home Assistant's current schema (an unused options selector block and the older duplicate form sections removed, the room subentry names its type "Room"/"Raum"); the integration declares that it is set up from the UI only (
CONFIG_SCHEMA). No visible text or setting changes. - Installation archive: every release carries
freshairiq.zipfor manual installs (downloads counted by GitHub), the files ofcustom_components/freshairiqat its root – the same files an install from the source archive gives, built reproducibly (sorted files, fixed time stamp, same SHA-256 for the same source;tools/build_install_zip.py). The release workflow publishes only after the checks pass: draft with both assets → asset verified → published. Configuration, entities, rooms, floor plans, dashboard settings and learned data are untouched by the change of the download path. - The Marketplace and HACS keep installing from the source archive (hacs.json unchanged, no
zip_release): updates work as before and every earlier release stays installable from the repository menu; existing releases are not changed. - Download statistics from GitHub's own release data (
tools/release_downloads.py, weekly workflowdownloads.yml): downloads offreshairiq.zipand other assets per release and in total. GitHub does not count the source archives (installs through the Marketplace and HACS), so these are not in the numbers and earlier releases have no counted downloads; a download is not an installation. No telemetry. - HACS and hassfest validation as their own workflows (no ignored checks), workflows least-privilege; manifest ordered for hassfest with the categories
climate.fans_ventilationandsensors.air_quality. - Branding in German and English: the branding artwork now also in English (same design, only the text differs) for the English README; a language-neutral logo card and GitHub social preview; README language selection; installation via the Marketplace (Home Assistant 2026.11+) or HACS with a My Home Assistant button.
Integration
- Optional global automation lock (Notifications & energy → Automation lock, e.g.
input_boolean.urlaub): while it is on FreshAirIQ starts no automatic device action – no covers, no fan switched on; a fan FreshAirIQ switched on itself is switched off once and followed to its result; fans switched by hand or by other automations are left alone. Recommendations, warnings and diagnostics stay. When the lock ends the situation is decided anew – nothing is queued. An unavailable or deleted lock entity does not lock. New status binary sensor "Automation lock" for other automations (FreshAirIQ does not pause them). The fan control reports the new statelocked(andstoppingwhile its own switch-off runs). Local lock periods and per-room device locks are unchanged.