FreshAirIQ v0.26.5.4 – Stability & Automation Improvements

FreshAirIQ v0.26.5.4

This update focuses on stability, more reliable ventilation recommendations, improved automatic exhaust fan control, and better dashboard compatibility.

Improvements & Bug Fixes

Automatic Exhaust Fan Control

• Fixed rapid on/off switching of automatically controlled exhaust fans.
• Improved handling of manual overrides and shared exhaust fans.
• Fixed fan control behavior after Home Assistant restarts.
• Improved notifications to distinguish automatic actions from required user actions.

Ventilation Recommendations

• Fixed contradictory ventilation recommendations.
• Improved CO₂-based ventilation decisions and hysteresis.
• Fixed recommendations that continued after a window was closed.
• Improved coordination between exhaust fans, humidity, CO₂, and cooling.

Temperature & Comfort

• Cooling recommendations now respect individual room comfort targets.
• Added a configurable lower temperature limit for cooling in Comfort mode.

Dashboard & User Interface

• Improved compatibility with custom Home Assistant themes, UIX, and card-mod.
• Fixed dialogs appearing inside dashboard cards instead of covering the screen.
• Added estimated room air exchange progress and time remaining to reach 95% air exchange.
• Improved fallback behavior when the live dashboard connection is interrupted.

Automation & Reliability

• Improved automation blueprints and device state synchronization.
• Fixed several edge cases involving multiple exhaust fans and shared devices.
• Improved error detection and recovery when devices fail to respond.

Important

If you use FreshAirIQ automation blueprints, re-import the updated blueprints to benefit from the latest fixes.

Thank you to everyone who reported issues, shared diagnostics, and helped improve FreshAirIQ!

Your feedback continues to make FreshAirIQ better.

FreshAirIQ v0.26.5.3 – Smarter Ventilation, Custom Themes & Stability Improvements

🌬️ FreshAirIQ v0.26.5.3

This release introduces improved ventilation recommendations, support for custom Home Assistant themes, reduced Recorder activity, and several fixes based on community feedback.

✨ New Features

Exhaust Fan Reference Sensors

• Configure temperature and humidity reference sensors from neighboring rooms for mechanical ventilation.
• Automatically use the appropriate reference depending on whether ventilation occurs through a window or exhaust fan.
• Support rooms without external windows.

Open Room Connections

• Configure permanently connected rooms without doors or contact sensors.
• Consider connected rooms during ventilation recommendations.
• Estimate passive ventilation effects in adjacent rooms.

Improved Temperature-Based Ventilation

• Keep ventilating when outdoor air can still help reach the room’s temperature target.
• Works beyond Summer Cooling mode.
• Prevent premature closing recommendations while useful cooling continues.

Shared Exhaust Fans

• Support exhaust fans assigned to multiple rooms.
• Keep fans running while at least one connected room still requires ventilation.

🎨 Custom Home Assistant Themes

FreshAirIQ now supports your active Home Assistant theme!

How to enable:

1. Edit your FreshAirIQ dashboard card.
2. Open Colours & theme.
3. Select Home Assistant theme.
4. Save your changes.

For YAML configurations:

theme: auto

The card can adopt your theme’s background, text, accent, border, shadow and transparency settings, including glass-style themes.

Custom styling with card-mod and UIX is also supported through --freshairiq-* CSS variables.

The original FreshAirIQ appearance remains the default.

🔧 Fixes & Improvements

More Stable Recommendations

• Reduced rapid switching between ventilate and close recommendations.
• Improved cooldown behavior after ventilation.
• Reduced contradictory recommendations between individual rooms and the whole-home evaluation.
• Improved detection of ventilation that is no longer effective.
• More realistic remaining-time estimates.

Notification Improvements

• Separate action, status and warning messages.
• Reduced repeated countdown notifications.
• Improved mould-risk event handling.
• Added configurable reminders for open actions.

Home Assistant Recorder Optimization

• Reduced unnecessary entity state updates.
• Added a dedicated live data channel for the dashboard.
• Reduced Recorder entries by approximately 43% in a comparative test, without changing ventilation calculations.

Settings & Configuration

• Apply configuration changes immediately without restarting Home Assistant.
• Fixed automatic cover control activation after changing settings.
• Fixed removing previously configured sensors and entities.
• Fixed disabled ventilation goals becoming active again.
• Improved preservation of settings when editing rooms.

📊 Ventilation History

• Added daily summaries to the PDF ventilation report.
• Added CSV export for individual ventilation sessions and daily summaries.
• Added daily totals, ventilation durations, moisture removal and averages.

❤️ Thank You!

Many improvements in this release were inspired by community feedback.

Thank you to everyone reporting issues, testing new features and sharing suggestions. Your feedback continues to make FreshAirIQ better!

Please report any remaining issues or unexpected ventilation recommendations through GitHub or the built-in diagnostics and feedback functions.

FreshAirIQ v0.26.5.2

Bugfix release addressing community reports from v0.26.5.1.

• Fixed contradictory instructions telling users to keep the same window open and close it simultaneously, including the resulting recommendation switching.
• Fixed house and floor recommendations incorrectly telling users to close a room while an active moisture source, such as a sauna or shower, still requires ventilation with drier reference air.
• Added recognition of “geöffnet” in three-state templates using “geöffnet / gekippt / geschlossen”.
• Fixed automatic exhaust fan control only taking effect after a restart when enabled for an existing room. Disabling control now stops a fan started by FreshAirIQ.
• Added support for “Ventilate indirectly” in exhaust fan control following the ventilation recommendation.
• Expanded outdoor PM2.5 sensor selection to include compatible sensors without the PM2.5 device class and sensors from the WAQI integration.
• Extended dashboard text scaling to previously fixed small text on learning and information pages. Added “Learning model & analysis” settings and increased the maximum scale to 200%. The default remains 100%.
• Extended anonymous contact diagnostics with contact type, integration, three-state recognition and information about contacts sharing a display name.

Note: WAQI provides air quality index values, which are not equivalent to PM2.5 concentrations in µg/m³.

FreshAirIQ v0.26.5.1 – Stability, Automation & Sensor Improvements

FreshAirIQ v0.26.5.1

This update improves ventilation recommendations, learning, sensor compatibility and automation options.

🌬️ Recommendations & Learning

• Reduced switching between “Continue ventilating” and “Close”.
• More consistent recommendations across the dashboard, sensors and automations.
• Fixed learning for tilted windows, cross ventilation and exhaust fans.
• Corrected duration tracking for exhaust-fan ventilation.
• Optional temperature and CO₂ goals can now be disabled.

⚙️ Automation & Summer Cooling

• Added optional presence-aware notifications.
• Updated announcement blueprints to follow the house recommendation by default.
• Added moisture-source detection for automations and a bathroom-fan blueprint.
• Improved summer cooling and sun protection, including configurable shading before direct sunlight reaches a window.
• Added optional automatic control of covers and exhaust fans, disabled by default.

🌡️ Sensors & Configuration

• Added support for unitless VOC index sensors, including IKEA VINDSTYRKA via Zigbee2MQTT.
• Improved selection of temperature and humidity sensors without a device class.
• Fixed room creation and editing so changes take effect immediately.

📱 Dashboard & Diagnostics

• Improved scroll restoration when navigating between rooms, including Safari and the iOS app.
• Spread scheduled diagnostic uploads across individual slots between 00:30 and 06:00 local time.
• Improved diagnostic anonymisation and support messages.
• Updated compatibility with Home Assistant 2026.10.

Blueprint users: Re-import the updated blueprints to access the new options.

Thank you for your feedback, bug reports and suggestions! FreshAirIQ remains in public beta.

FreshAirIQ v0.26.5.0 – English Localization & Automation Blueprints

FreshAirIQ v0.26.5.0

This release focuses on improving international accessibility, expanding automation capabilities, and refining the English-language experience.

🌍 Localization & Language Support

• Improved English localization throughout FreshAirIQ.
• Refined language handling in the configuration flow.
• Improved consistency between configuration dialogs and the dashboard.

⚙️ New Automation Blueprints

• Added an English room announcement blueprint for creating voice notifications based on room actions.
• Added an English device-following blueprint for triggering device actions based on room activity.
• Made automation setup more accessible to English-speaking Home Assistant users.

📚 Documentation

• Updated the README and changelog.
• Expanded documentation for the new automation blueprints.

🏠 Home Assistant

• Continued improving integration with Home Assistant’s configuration and automation systems.

⸻

Thank you for testing FreshAirIQ and helping improve the project!

FreshAirIQ remains under active development. Feedback, bug reports, and suggestions are always welcome.

FreshAirIQ v0.26.4.10 – Planned Airing & Community Fixes

🌬️ FreshAirIQ v0.26.4.10 – Planned Airing & Community Improvements

This update improves ventilation recommendations, fixes issues with exhaust fan handling, and introduces a new 15-minute cooldown between feedback submissions.

✨ Improved Planned Airing

• Fixed premature recommendations to close windows while sufficient ventilation potential remains.
• Ventilation sessions now more reliably respect the planned duration calculated when ventilation begins.
• Additional windows opened during an ongoing ventilation session follow the remaining planned ventilation time.
• Improved consistency between individual room, floor, whole-house, and live ventilation assistant recommendations.
• Safety limits and unfavorable outdoor conditions continue to take priority.

🌀 Exhaust Fan Improvements

• Fixed incorrect window-closing recommendations in rooms ventilated exclusively by exhaust fans.
• Added clearer instructions for operating exhaust fans.
• Improved handling of simultaneous window and exhaust fan ventilation.
• Prevented exhaust fans from prematurely ending planned window ventilation sessions.

💬 Feedback Improvements

• Introduced a new 15-minute cooldown between feedback submissions.
• Added a countdown showing when feedback can be submitted again.
• Improved error handling and status messages during feedback submission.

🛠️ Maintenance & Reliability

• Cleaned up unused legacy code and dashboard helper functions.
• Added regression tests for planned airing and feedback functionality.
• Preserved support for German and English ventilation recommendations.

❤️ Thank You!

A big thank you to everyone testing FreshAirIQ, reporting bugs, and sharing suggestions!

Your feedback, ideas, and real-world experiences help me make FreshAirIQ smarter and more reliable with every update.

FreshAirIQ is still in public beta. Please continue reporting unexpected behavior through the built-in feedback feature or GitHub.

FreshAirIQ v0.26.4.5 – English Localization, Dashboard & Stability

🌿 FreshAirIQ v0.26.4.5

This release brings significant improvements to English localization, dashboard usability, configuration, diagnostics, and overall stability.

🌍 Improved English Localization

• Expanded English translations across configuration menus and room settings.
• Improved ventilation recommendations, explanations, and status messages.
• Updated notification texts, dashboard labels, and ventilation reports.
• Improved consistency between German and English interfaces.

🏠 Dashboard Improvements

• More compact and organized room overview.
• Clearer ventilation priorities, progress indicators, and room details.
• Enlarged Details, Guest Rooms, and Support buttons for easier touchscreen operation.
• Fixed several dashboard layout and interaction issues.

🍃 Freshy – 11 Animated Moods

• Introduced 11 different moods and animations.
• Freshy responds to ventilation needs, weather, air quality, sensor issues, and nighttime conditions.
• Improved integration into the existing dashboard.

⚙️ Centralized Configuration

• Consolidated settings under Home Assistant → Settings → Devices & Services → FreshAirIQ → Configure.
• Improved room creation and editing workflows.
• Simplified navigation and reduced configuration inconsistencies.

🧠 Recommendation Improvements

• Fixed recommendation tracking when keeping windows closed is the correct action.
• Improved internal evaluation and validation of ventilation scenarios.

🔒 Privacy & Diagnostics

• Automatic diagnostic uploads now require explicit consent, including for existing installations.
• Improved diagnostic anonymization and error reporting.
• Expanded troubleshooting information and error identification.

🛠️ Bug Fixes & Stability

• Fixed issues affecting room configuration and dashboard interactions.
• Corrected missing translation parameters and notification names.
• Improved room icon handling, sensor processing, and nighttime settings.
• Expanded automated regression testing.

⸻

❤️ Thank You!

FreshAirIQ is a free, community-driven Home Assistant hobby project currently in public beta.

Thank you to everyone contributing feedback, bug reports, and suggestions. Your input directly helps improve the integration.

Feedback from English-speaking users is especially welcome!

Please continue reporting any issues you encounter.

Version: v0.26.4.5

FreshAirIQ v0.26.2.8 – Rooms Dashboard Hotfix

FreshAirIQ v0.26.2.8

🛠 Hotfix

• Fixed an issue where the Rooms button in the FreshAirIQ dashboard could not be opened.
• Restored the Rooms button to the proven direct click-handler mechanism used by the other dashboard action buttons.
• No changes were made to the recommendation logic, room data, or other FreshAirIQ functionality.

Thank you for your patience and the quick feedback! 💚

FreshAirIQ v0.26.2.7 – Rooms Dashboard Hotfix

FreshAirIQ v0.26.2.7

🛠 Hotfix

• Fixed an issue where the Rooms tile in the FreshAirIQ dashboard could no longer be opened.
• The Rooms tile now uses the dashboard’s central navigation and overlay mechanism for more reliable interaction.
• No changes were made to the recommendation logic or room data.

Thank you for the quick feedback! 💚

FreshAirIQ v0.26.2.6 – Smarter Recommendations & Dashboard Improvements

FreshAirIQ v0.26.2.6

This release focuses on smarter and more consistent ventilation recommendations, improved multi-room handling, and additional dashboard customization.

✨ Improvements

• Improved recommendation logic for multiple rooms with different ventilation needs
• Improved handling of critical CO₂ levels, humidity and mold-risk situations
• Better conflict handling when ventilation helps one goal but negatively affects another
• More consistent recommendations during active ventilation
• Improved handling of mechanical ventilation and exhaust fans
• More adaptive recommendation texts based on the current situation and learning progress

🎨 Dashboard

• Added individual font-size settings directly to the FreshAirIQ card editor
• Font sizes can be adjusted separately for different dashboard sections
• Available steps: 80%, 90%, 100%, 110%, 120%, 130%, 140% and 150%
• Existing cards remain unchanged at the default 100%
• Improved compact room and goal presentation

⚙️ Configuration

• Improved room configuration and navigation
• Improved entity selection and compatibility
• Various UI, mobile and consistency improvements

🛠 Fixes

• Fixed several recommendation conflicts in multi-room scenarios
• Fixed CO₂ versus ventilation-close handling
• Fixed incomplete font scaling in some dashboard sections
• Additional stability and regression fixes