Skip to content

Latest commit

Β 

History

95 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🏠 Indeklima

Multi-room indoor climate monitoring for Home Assistant β€” temperature, humidity, COβ‚‚, VOC, formaldehyde and barometric pressure, with mold risk assessment, dehumidifier control, LED alarm feedback, and a polished custom frontend.

Version Quality Scale HACS


If your bathroom wall starts sweating and your bedroom feels like a rainforest, Home Assistant will happily tell you the humidity is 78%. What it won't tell you is whether that's dangerous or just uncomfortable β€” or what to actually do about it.

Indeklima does. It reads your existing sensors and turns raw numbers into something you can act on: mold risk warnings, room-by-room severity scores, ventilation recommendations, and β€” since v2.6.0 β€” direct dehumidifier control with LED alarm feedback.

About the project

Indeklima is a custom Home Assistant integration built to monitor indoor climate across multiple rooms at once, using sensors you already have β€” no special hardware required. It collects data from your existing sensors (temperature, humidity, COβ‚‚, VOC, formaldehyde, pressure), calculates an overall severity score per room and globally, and gives concrete recommendations for ventilation and dehumidification.

Since version 2.6.0, Indeklima can also control a physical dehumidifier directly β€” turning it on/off via a button or automatically based on humidity and mold risk, with LED feedback and configurable quiet hours. Since version 2.7.0, the dehumidifier LED switches to red alarm, regardless of manual/auto mode, whenever the room's overall indoor climate status is critical. Since version 2.8.0, the alarm blinks instead of staying solid, holds for a couple of cycles after recovery (to avoid flicker), the threshold can be overridden per room, and a "critical since" timestamp is stored on each room's status sensor. Since version 2.9.0, dehumidifier mode, the "critical since" timestamp, and LED alarm status are all mirrored in the panel and Lovelace cards. Version 2.9.1 fixed a bug where outdoor weather data was silently skipped whenever any window in the house was open. Version 2.9.9 adds VOC and formaldehyde to the indeklima-tablet-card's house-wide averages (both the frontend cell and the websocket payload, which previously silently dropped both fields), and reworks the tablet card's layout to fill the available screen height/width instead of using fixed pixel sizes designed for one specific tablet resolution.

Features

  • Multi-room monitoring β€” configure as many rooms as you like, each with its own sensors
  • Severity score (0–100) per room and globally, based on humidity, COβ‚‚, VOC and formaldehyde
  • Mold risk calculation (low / moderate / high / critical) β€” uses a dedicated mold sensor if available, otherwise falls back to the room's humidity sensor
  • Dehumidifier recommendation per room and globally, based on mold risk, humidity trend and ventilation status
  • Built-in dehumidifier control (v2.6.0+): physical button toggle, automatic on/off, LED feedback (manual/automatic/off/blinking red alarm when indoor climate is critical, v2.7.0–2.8.0), auto-off timer, configurable quiet hours (global + per room), per-room alarm threshold and "critical since" timestamp (v2.8.0+), with dehumidifier mode, critical-since timestamp, and LED alarm state all mirrored in the UI (v2.9.0+)
  • Ventilation recommendation based on indoor climate and outdoor weather data
  • Air circulation status based on open internal doors
  • Trends (rising/falling/stable) for humidity, COβ‚‚ and severity over a 30-minute rolling window
  • Window/door detection distinguishing between outdoor and internal openings
  • Danish-first UI β€” English code and logs, Danish UI and notifications (translatable via translations/)
  • Custom Lovelace panel with sidebar, room overview, sparklines and interactive cards
  • Gold Tier HA Quality Scale β€” diagnostics, repair flow, system health, full test coverage

Installation

Via HACS (recommended)

  1. Add this repository as a custom repository in HACS (category: Integration)
  2. Install "Indeklima" from HACS
  3. Restart Home Assistant
  4. Go to Settings β†’ Devices & services β†’ Add integration and search for "Indeklima"

Manual installation

  1. Copy custom_components/indeklima to your config/custom_components/ folder
  2. Restart Home Assistant
  3. Add the integration as described above

Configuration

All configuration is done via the UI β€” no YAML required.

Setting up a room

For each room you can select:

  • Humidity, temperature, COβ‚‚, VOC, formaldehyde and pressure sensors (multiple sensors of the same type are supported β€” their average is used)
  • A dedicated mold sensor (optional β€” otherwise falls back to the room's humidity sensor)
  • Window/door sensors, marked as outdoor or internal
  • A dehumidifier (switch or humidifier entity)
  • A dehumidifier LED (light entity) for visual manual/auto/off feedback
  • A dehumidifier button (any entity β€” supports both real button entities and click-count sensors)
  • The dehumidifier's auto-off duration (default 45 minutes)
  • A quiet-hours override for that specific room

Global settings (Settings β†’ Indeklima β†’ Configure)

  • Thresholds: max humidity summer/winter, max COβ‚‚, VOC and formaldehyde
  • Weather integration: optional weather entity for ventilation recommendations
  • Quiet hours: global time window in which dehumidifiers won't turn on automatically (unless mold risk is high/critical)

Entities

Hub level (~19 sensors): averages for each measured quantity, overall severity score and status, open window count, air circulation, trends, ventilation and dehumidifier recommendations, mold risk.

Per room: status, temperature, humidity, COβ‚‚, pressure (if configured), mold risk and dehumidifier recommendation (with a mode attribute showing manual/auto/off).

Dashboard

Indeklima adds a sidebar panel with two tabs β€” a full-house overview and a per-room detail view, including sparklines and interactive cards. If you prefer to build your own dashboard, standalone Lovelace cards are also available.

Language

The integration is Danish-first: UI, notifications and translations are in Danish (translations/da.json), while all code, comments and logs are in English (strings.json is the primary source). If your Home Assistant is set to a different language, English labels are used as the fallback.

If something goes wrong

If a sensor drops out or the coordinator fails to update, Indeklima surfaces it as a repair issue in HA's Repairs panel instead of failing silently. Check Settings β†’ System β†’ Repairs. For deeper troubleshooting steps, see the guide linked below.

Documentation

Contributing

Bug reports and pull requests are welcome β€” see CONTRIBUTING.md for the dev setup, code standards, and fork/clone workflow.

License

MIT. See LICENSE.

About

🏠 Indeklima - Home Assistant Custom Integration

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages