Ventilation Recommendation – Ventilate smarter, automatically at the right time!
Hi Community! 
I’d like to share a Blueprint I developed with the help of Claude Sonnet (AI-assisted).
It analyzes indoor and outdoor temperature & humidity, calculates the absolute humidity difference
and notifies you when ventilating actually makes sense – via Push, Alexa or persistent HA notification.
Beta notice: This is currently a beta version. It has been tested on my own
Home Assistant instance, but may still contain bugs or rough edges. Feedback is very welcome!
Important – German only for now:
My English is not the best, so this Blueprint is currently available in German only.
All input fields, labels and notification texts are in German.
Once everything is running stable and clean, I plan to release a fully translated English version.
Thank you for your understanding!
Features
Sensor-based logic – reads indoor/outdoor temperature and humidity regularly
Configurable thresholds – ventilation is recommended when the absolute humidity difference
exceeds the threshold AND indoor humidity is too high
Time window control – notifications only during configurable time slots (e.g. daytime only)
Multi-channel notifications – Push via Companion App (with optional dashboard action button),
persistent HA UI message, and Alexa voice output
Message variants – short hint, detailed text, or fully custom text with template support
Auto room name detection – automatic fallback: room name → friendly name → entity ID
Duplicate prevention – optional input_texthelper to avoid repeated identical notifications
Debug mode – shows sensor values, difference, name source and blueprint version
Requirements
- Home Assistant (recent version recommended)
- Indoor & outdoor temperature sensors (
sensor) - Indoor & outdoor humidity sensors (
sensor) - At least one notification target (Companion App, Alexa media player or persistent notification)
- (Optional) An
input_texthelper for duplicate prevention - (Optional) A dashboard URL for the action button
Import
Or import manually via this URL:
https://gist.github.com/tiwo85/7fbb5e8c065e02e8eefa18e8ea37ff59/raw
Automatic Update Notifications (NEW!)
Get notified automatically about new versions using Blacky’s Blueprint Update Notification:
Required Sensors
1. Gist Version (Remote)
sensor:
- platform: rest
name: "Ventilation Recommendation Blueprint Gist Version"
icon: mdi:cloud-tags
resource: "https://gist.githubusercontent.com/tiwo85/7fbb5e8c065e02e8eefa18e8ea37ff59/raw/lueftungsempfehlung_notify.yaml"
method: GET
headers:
accept: "text/plain"
value_template: >
{% set match = value | regex_findall('\\*\\*Version\\s+([0-9.]+)\\*\\*') %}
{{ match if match else 'unknown' }}
scan_interval: 86400
2. Local Version
text
command_line:
- sensor:
name: "Ventilation Recommendation Blueprint Local Version Number"
icon: mdi:code-not-equal-variant
command: "grep -oE '[*][*]Version [0-9.]+' /config/blueprints/automation/tiwo85/lueftungsempfehlung_notify.yaml | grep -oE '[0-9.]+'"
scan_interval: 86400
Quick Setup
- Import Blacky’s Blueprint
- Add sensors to
configuration.yaml→ Restart HA - Configure:
text
Remote: sensor.ventilation_recommendation_blueprint_gist_version
Local: sensor.ventilation_recommendation_blueprint_local_version_number
Name: Ventilation Recommendation
Done! → Automatic push notifications for updates
🗺️ ToDo & Roadmap
Already implemented 
:
- Push notifications (Companion App)
- Persistent HA UI notifications
- Alexa voice output
- Dashboard action button
- Short/long/custom messages
- Auto room name detection + manual override
- Duplicate prevention via status helper
- Debug mode
- Time windows
- 3 notification modes (change/always/reminder)
- Repeat reminders for closed windows
- Threshold hysteresis to prevent flickering
- NEW Alexa native integration (multiple devices)
Planned 
:
- Status-based actions (lights/fan/switch)
- Lovelace status cards
- Multiple notification targets
- Action on window reminder
Full English version (v1.0.0)
📝 Changelog
v0.4.4 (25.02.2026)
- Alexa native integration: Multiple devices selectable
- Bug fix: Native Alexa service corrected to notify.send_message
v0.4.3 (24.02.2026)
- Bug fix: Template variables in debug mode corrected
v0.4.2 (24.02.2026)
- Threshold hysteresis to prevent flickering
v0.4.1 (24.02.2026)
- Manual room name input
- 3 notification modes (change/always/reminder)
- Repeat reminders for closed windows
- Extended name preferences
v0.4.0 (24.02.2026)
- Notification modes introduced
- Repeat reminder functionality
- Status storage improvements
v0.3.0 (23.02.2026)
- Input sections grouped
- Emojis added
- UI improvements
v0.2.5 (23.02.2026)
- Time window support
v0.2 (23.02.2026)
- Initial core features
Feedback & Questions
Any feedback, bug reports or feature ideas are very welcome!
Drop a comment below or open an issue directly on the
Gist. 
Note: This Blueprint was developed with AI assistance (Claude Sonnet) and tested on my own
Home Assistant instance. Always review automations before enabling them.