Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dolezsa/thermal_comfort

Thermal Comfort sensor for HA (absolute humidity, heat index, dew point, thermal perception)
https://github.com/dolezsa/thermal_comfort

absolute-humidity comfort-model comfort-zone dew-point dew-point-perception heat-index thermal-comfort thermal-perception thermal-stress

Last synced: about 2 months ago
JSON representation

Thermal Comfort sensor for HA (absolute humidity, heat index, dew point, thermal perception)

Host: GitHub
URL: https://github.com/dolezsa/thermal_comfort
Owner: dolezsa
License: other
Created: 2019-04-07T22:38:29.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2024-10-16T19:57:39.000Z (2 months ago)
Last Synced: 2024-10-18T00:26:42.285Z (2 months ago)
Topics: absolute-humidity, comfort-model, comfort-zone, dew-point, dew-point-perception, heat-index, thermal-comfort, thermal-perception, thermal-stress
Language: Python
Homepage:
Size: 2.73 MB
Stars: 600
Watchers: 14
Forks: 117
Open Issues: 38
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

        # [![thermal_comfort](https://raw.githubusercontent.com/dolezsa/thermal_comfort/master/icons/logo.png)](https://github.com/dolezsa/thermal_comfort)

[![hacs_badge](https://img.shields.io/badge/HACS-Default-41BDF5.svg?style=for-the-badge)](https://github.com/hacs/integration)

![GitHub release (latest by date)](https://img.shields.io/github/downloads/dolezsa/thermal_comfort/latest/total?style=for-the-badge&color=f55041)

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](https://github.com/dolezsa/thermal_comfort/blob/2.2/documentation/sensors.md) /

 [1.5](https://github.com/dolezsa/thermal_comfort/blob/1.5/documentation/sensors.md) /

 [master](https://github.com/dolezsa/thermal_comfort/blob/master/documentation/sensors.md)**

### 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](https://raw.githubusercontent.com/dolezsa/thermal_comfort/master/screenshots/outside.png)

## Usage

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

sensors.

**UI/Frontend (Config Flow)

 [2.2](https://github.com/dolezsa/thermal_comfort/blob/2.2/documentation/config_flow.md) /

 [1.5](https://github.com/dolezsa/thermal_comfort/blob/1.5/documentation/config_flow.md) /

 [master](https://github.com/dolezsa/thermal_comfort/blob/master/documentation/config_flow.md)**

**YAML

 [2.2](https://github.com/dolezsa/thermal_comfort/blob/2.2/documentation/yaml.md) /

 [1.5](https://github.com/dolezsa/thermal_comfort/blob/1.5/documentation/yaml.md) /

 [master](https://github.com/dolezsa/thermal_comfort/blob/master/documentation/yaml.md)**

## Installation

### Requirements

#### 2.2

Home Assistant >= 2023.12.0

#### 1.5

Home Assistant >= 2021.12.0

#### master

Home Assistant >= 2023.12.0

### Using [HACS](https://hacs.xyz/) (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

* Use git:

```sh

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

```

* Download the source release and extract the custom_components folder into your home assistant config folder.

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

### Custom Icons

[Install](https://github.com/rautesamtr/thermal_comfort_icons#install) Thermal Comforts icon pack.

Enable the custom icons options for your sensor in the

 [frontend](https://github.com/dolezsa/thermal_comfort/blob/master/documentation/config_flow.md#configuration-options)

 or in [yaml](https://github.com/dolezsa/thermal_comfort/blob/master/documentation/yaml.md#sensor-configuration-variables).

## Localization 🌎🗺

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

[![translation badge](https://inlang.com/badge?url=github.com/dolezsa/thermal_comfort)](https://inlang.com/editor/github.com/dolezsa/thermal_comfort?ref=badge)