Covers follow the window
Open a window and its cover goes all the way up. Close it again and the cover returns to where it was. If someone moved the cover in between, it stays where it is – even after a restart.
FreshAirIQ for Home Assistant
Fresh air.
Exactly when it helps.
FreshAirIQ reads your room sensors, the weather and your windows – and tells you, room by room, when airing really dries the air, when to keep going and when to close. And it learns how your home behaves.
Physics, not a hunch
82 % outside.
And still drier.
Relative humidity is misleading. Cold air holds far less water – so damp-looking autumn air can still dry your bathroom. FreshAirIQ compares what actually counts: absolute humidity, temperature and the volume of every room.
7.2g/m³
Outside · 9 °C at 82 %
11.0g/m³
Bathroom · 21 °C at 60 %
−3.8g/m³
Removed with every m³ of air you exchange
Meet Freshy
Your home’s climate,
at a glance.
Freshy is FreshAirIQ’s mascot and lives in the IQ view of the dashboard. One look is enough: Freshy shows what is going on in your home right now – and reacts to it.
- Rides the windWhile you air a room, Freshy is right in the middle of the airflow.
- Goes to bed with youShortly before night Freshy puts on a sleeping cap – at night Freshy sleeps.
- Knows the weatherRain, pollen or summer heat: Freshy reacts to what is happening outside.
Every room
Your whole home.
At a glance.
Room climate, mould risk, learning progress and the water in the air – for every room, grouped by floor. A summary shows at once which rooms need you.
- Water in the airLitres and millilitres instead of abstract percentages.
- Mould protectionEstimates the humidity on cold wall surfaces and warns early.
- Learning statusShows how well FreshAirIQ already knows each room.
Live airing
It knows when
to stop.
Open a window and FreshAirIQ follows the airing live: water removed so far, what the next five minutes would bring and how much heat you lose. As soon as the benefit is used up, it says close.
- Right durationNo more guessing between too short and too long.
- Heat in viewCooling and reheating cost are part of every decision.
- Night strategyPredicts the humidity overnight and suggests a short airing before bed.
The heart of FreshAirIQ
A model that learns
your home.
Every house is different: thick walls, a small bathroom, a window into the wind. FreshAirIQ starts with solid building physics – and from then on learns from every airing how your rooms really behave.
1Measure
Every airing is recorded: start values, duration, window, outdoor air and result.
2Predict
Before and during airing, FreshAirIQ predicts how much water will leave the room.
3Compare
The prediction is checked against what really happened – after the window is closed.
4Improve
Sound results refine the model – an improvement only counts once it holds up on different days.
Four things FreshAirIQ learns
Your home
How fast each room exchanges air, how much moisture walls and furniture buffer and how your windows and fans work.
Forecasts
Corrects its live forecasts and tests alternative models in parallel before adopting them.
Your habits
Daily routines such as showers, cooking and when you usually air.
Long term
Nights and seasons – slowly and only from genuinely different days.
Honest about what it knows.
FreshAirIQ shows experience maturity and forecast quality separately. A large number of measurements alone does not make a good model – improvement has to be proven against a fixed baseline, across independent airings on different days.
Automatic control
Let FreshAirIQ
handle it.
FreshAirIQ advises – and if you want, it acts. Covers and exhaust fans can be controlled automatically while you air. Everything is off by default and is switched on per room and per window.
No locking out
For a balcony or terrace door marked as a passage, the cover never closes while the door is open. If a button or another automation tries, FreshAirIQ stops it and opens the cover again.
Sun protection ahead of the sun
In summer cooling mode FreshAirIQ knows which window the sun is about to reach and closes its cover 15 minutes ahead on warm days. When the sun has left the window, it opens again.
The bathroom fan, on time
After a shower or while cooking, the exhaust fan runs with a follow-up time – or it follows the airing recommendation while the windows are closed. A maximum runtime keeps it in check.
FreshAirIQ only switches off what it switched on itself. If you switch a fan off, it stays off until the reason is over. Windows are never moved.
Blueprints
Ready-made automations.
Set up in two minutes.
Blueprints are automation templates for Home Assistant. You import one, pick your room and device in a form – and the automation is ready. No YAML required.
- 1Settings → Automations & scenes → Blueprints
- 2Import blueprint and paste the link from GitHub
- 3Create automation, choose room and device – done
Announce recommendations
Alexa, a speaker or Telegram say “Bedroom: please close the window.” With quiet times and a choice of which recommendations to announce.
Fan follows the room
A fan or ventilation unit runs while FreshAirIQ recommends airing – and not while the window is open.
Fan after showering
Runs only when a shower or cooking is detected, with follow-up time and maximum runtime. The evening airing advice does not trigger it.
Covers against the sun
Closes covers ahead of the sun on warm days and opens them when the sun has gone.
Prefer settings over automations? Covers and exhaust fans can also be controlled directly in the room settings – use one or the other for the same device.
Node-RED
Fits right into
your flows.
FreshAirIQ publishes every change as a Home Assistant event with a ready-to-speak sentence. In Node-RED you pick it up with the nodes you already know.
- events: allEvent type
freshairiq_room_action– fires when a room recommendation changes. Orfreshairiq_notificationfor every message, including a ready sentence inspeech. - switchBranch on
msg.payload.event.action:ventilate,close,okay… - call serviceSwitch a fan, play the sentence on a speaker or send it to your phone.
events: allfreshairiq_room_action
switchaction = ventilate
call servicefan.turn_on
{
"room_name": "Bedroom",
"action": "ventilate",
"house_aligned_action": "ventilate",
"message": "Bedroom: Please air the room.",
"humidity": 58.4,
"ventilation_active": false
}A look at the dashboard.
Even more for good air.
Mould early warning
Estimates the surface humidity on cold walls and flags rooms that need attention – an early indicator, not a lab diagnosis.
Summer cooling
Airs through the cool night and tells you to close once the outside air is no longer cooler.
NewCross ventilation & wind
Window directions, wind and room pairs for faster air exchange.
Pollen & fine dust
Holds back airing when the outdoor air is loaded.
Residents & guests
Presence and overnight guests sharpen the night forecast.
Energy in view
Reheating cost for heat pump, gas, oil, district heating or electric heating.
Private by design
Runs locally in Home Assistant. Diagnostics are only shared with your consent.
Install
Ready in minutes.
Add to HACS
In HACS, add the custom repository https://github.com/rupascha/freshairiq as an integration.
Install & restart
Install FreshAirIQ from HACS and restart Home Assistant.
Add your rooms
Settings → Devices & services → Add integration → FreshAirIQ. Pick sensors and windows per room.
Requires Home Assistant 2026.8 or newer, a temperature and humidity sensor per room and outdoor values (sensor or weather). Window contacts, CO₂, covers and fans are optional.
Questions & answers
Does FreshAirIQ open my windows?
No. It tells you when to open and close them. If you enable it, FreshAirIQ can control covers and exhaust fans – never windows.
Which sensors do I need?
A temperature and humidity sensor per room plus outdoor temperature and humidity. Window contacts make airing tracking and learning possible; CO₂ sensors add air quality as a goal.
How long does learning take?
FreshAirIQ is useful from day one thanks to building physics. The learned model gets noticeably better after a few weeks with airings on different days; nights and seasons take longer.
Does it work without the cloud?
Yes. All calculations run locally in Home Assistant. Sending diagnostics to help improve FreshAirIQ is optional and off unless you agree.
What does it cost?
Nothing. FreshAirIQ is free and open source under the MIT licence.
Is it an official Home Assistant integration?
No. FreshAirIQ is an independent community project and not affiliated with Home Assistant or Nabu Casa.
Which languages are supported?
German and English – the dashboard, notifications and settings follow your Home Assistant language.