dolezsa / thermal_comfort

Thermal Comfort sensor for HA (absolute humidity, heat index, dew point, thermal perception)
Other
620 stars 118 forks source link
absolute-humidity comfort-model comfort-zone dew-point dew-point-perception heat-index thermal-comfort thermal-perception thermal-stress

thermal_comfort

hacs_badge GitHub release (latest by date)

Thermal Comfort provides a variety of thermal indices and thermal perceptions including feels like temperatures in numeric and textual representation for Home Assistant.

Sensors:

Full list 2.2 / 1.5 / master

Numeric Indices

Thermal Comfort provides numerical indices like dew point, frost point, absolute humidity and moist air enthalpy that are numeric values usable for further automations but also human readable. e.g. dew point tells the temperature to which air must be cooled to produce dew on a surface.

Bio Indices / Perception

Thermal Comfort also provides a variety of bio indices like humidex or heat index giving numeric values of human perceived temperatures (feels like temperature). In addition we also provide textual perception sensors that describe the range of an index in human readable form e.g. comfortable or uncomfortable.

Custom Icons

Usage

To use Thermal Comfort check the documentation for your preferred way to setup sensors.

UI/Frontend (Config Flow) 2.2 / 1.5 / master

YAML 2.2 / 1.5 / master

Installation

Requirements

2.2

Home Assistant >= 2023.12.0

1.5

Home Assistant >= 2021.12.0

master

Home Assistant >= 2023.12.0

Using HACS (recommended)

This integration can be installed using HACS. To do it search for Thermal Comfort in the integrations section.

Manual

To install this integration manually you can either

git clone https://github.com/dolezsa/thermal_comfort.git
cd thermal_comfort
# if you want a specific version checkout its tag
# e.g. git checkout 1.0.0

# replace $hacs_config_folder with your home assistant config folder path
cp -r custom_components $hacs_config_folder

Finally you need to restart home assistant before you can use it.

Custom Icons

Install Thermal Comforts icon pack.

Enable the custom icons options for your sensor in the frontend or in yaml.

Localization 🌎🗺

Contribute translations directly with PRs or via inlang's web-editor.

translation badge