Better Thermostat
This custom component for Home Assistant will add crucial features to your climate-controlling Thermostatic Radiator Valves to save you the work of creating automations to make it smart.
https://github.com/KartoffelToby/better_thermostat
Category: Consumption
Sub Category: Buildings and Heating
Keywords
climate energy-efficiency hacktoberfest hacs home-assistant home-automation homeassistant moes sea801 sea802 sensor smarthome spzb0001 thermostat ts0601 tuya zigbee zigbee2mqtt
Keywords from Contributors
consumption hue-lights metering power virtual-sensors varta varta-storage water
Last synced: about 12 hours ago
JSON representation
Repository metadata
This custom component for Home Assistant will add crucial features to your climate-controlling TRV (Thermostatic Radiator Valves) to save you the work of creating automations to make it smart. It combines a room-temperature sensor, window/door sensors, weather forecasts, or an ambient temperature probe to decide when it should call for heat and automatically calibrate your TRVs to fix the imprecise measurements taken in the radiator's vicinity.
- Host: GitHub
- URL: https://github.com/KartoffelToby/better_thermostat
- Owner: KartoffelToby
- License: agpl-3.0
- Created: 2021-10-30T16:21:04.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2025-03-19T12:40:48.000Z (about 1 month ago)
- Last Synced: 2025-04-25T13:49:33.203Z (1 day ago)
- Topics: climate, energy-efficiency, hacktoberfest, hacs, home-assistant, home-automation, homeassistant, moes, sea801, sea802, sensor, smarthome, spzb0001, thermostat, ts0601, tuya, zigbee, zigbee2mqtt
- Language: Python
- Homepage: https://better-thermostat.org
- Size: 1.7 MB
- Stars: 1,042
- Watchers: 23
- Forks: 144
- Open Issues: 213
- Releases: 30
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
README.md
Better Thermostat
For more info visit: https://better-thermostat.org/
Requirements
- Minimum required Home Assistant version:
2024.12
(Latest tested version:2025.3.0)
Companion UI
We've created a companion UI element which can display more information than the default thermostat element in Home Assistant. Check it out via HACS: better-thermostat-ui-card
- If you have a question or need help please create a new discussion or check if your question is already answered
- If you have a suggestion, found a bug, or want to add a new device or function create a new issue
- If you want to contribute to this project create a new pull request
Features
This integration brings some smartness to your connected radiator thermostats setup:
- Uses a temperature sensor far away from the radiators to measure the real room temperature
- Makes your TRVs fully compatible with Google Home
- Let your windows disable your heating (avoid programming this via an automation)
- Your weather forecast provider will turn your heat on/off
- Or an outside air temperature sensor can do this as well
- Does some valve maintenance automatically, to avoid them getting stuck closed over the summer
- Group multiple TRVs to one (e.g. for a room with multiple radiators)
- Enhance the default TRV Algorithm with some smartness to reduce energy consumption
Which hardware do we support?
We support all thermostats which are compatible with Home Assistant as long as they are shown up as a climate entity
Integrations that are tested
- Zigbee2Mqtt
- Deconz
- Tado
- generic_thermostat
How to setup
Install this integration via HACS or copy the files from the latest release
Configuration details can be found in the documentation or on our website: better-thermostat.org
Some nice-to-know config tips for the configuration.yaml
Example Window/Door - Sensor config
group:
livingroom_windows:
name: Livingroom Windows
icon: mdi:window-open-variant
all: false
entities:
- binary_sensor.openclose_1
- binary_sensor.openclose_2
- binary_sensor.openclose_3
Combine multiple TRV to one (Group)
No worry, Better Thermostat supports grouping out of the box
Contributing?
checkout the CONTRIBUTING.md file
☕ Support
If you want to support this project, you can ☕ buy a coffee here.
Owner metadata
- Name: Tobias Haber
- Login: KartoffelToby
- Email:
- Kind: user
- Description: A Fullstack web application developer from Germany with a passion for open source projects in the smart home industry. Skilled in various programming languages.
- Website: https://t-haber.de
- Location: Germany
- Twitter: Kartoffeltoby
- Company: @dundd
- Icon url: https://avatars.githubusercontent.com/u/8983030?u=c0e47cba24451d547afc534439c4298bd94ab8bb&v=4
- Repositories: 51
- Last ynced at: 2025-04-24T06:11:24.550Z
- Profile URL: https://github.com/KartoffelToby
GitHub Events
Total
- Create event: 10
- Commit comment event: 1
- Release event: 5
- Issues event: 202
- Watch event: 231
- Member event: 2
- Issue comment event: 933
- Push event: 35
- Pull request review comment event: 3
- Pull request review event: 18
- Pull request event: 58
- Fork event: 25
Last Year
- Create event: 10
- Commit comment event: 1
- Release event: 5
- Issues event: 202
- Watch event: 231
- Member event: 2
- Issue comment event: 933
- Push event: 35
- Pull request review comment event: 3
- Pull request review event: 18
- Pull request event: 58
- Fork event: 25
Committers metadata
Last synced: 4 days ago
Total Commits: 849
Total Committers: 61
Avg Commits per committer: 13.918
Development Distribution Score (DDS): 0.539
Commits in past year: 69
Committers in past year: 19
Avg Commits per committer in past year: 3.632
Development Distribution Score (DDS) in past year: 0.754
| Name | Commits | |
|---|---|---|
| KartoffelToby | k****t@t****e | 391 |
| @RubenKelevra | c****d@g****m | 234 |
| Wolfgang Tom | m****l@w****e | 86 |
| James McMahon | j****n@p****t | 17 |
| Folfy | f****y | 15 |
| Dr. Torge Valerius | 2****b | 8 |
| Tobias Haber | t****r@d****g | 7 |
| felixhaeberle | 3****e | 7 |
| NinDTendo | d****d@g****m | 4 |
| Jameson_UK | 1****k | 4 |
| xX7 | 5****7 | 3 |
| misa1515 | 6****5 | 3 |
| chigelo | 1****o | 3 |
| Thomas Wendt | t****y@g****t | 3 |
| Fettlaus | 8****s | 3 |
| Eric HOUET | e****t@d****v | 3 |
| Cycor | 6****r | 3 |
| developer | d****t@s****e | 2 |
| Hans | 1****c | 2 |
| Jiří Furda | 2****a | 2 |
| Krystian Kotkowski | 6****o | 2 |
| LeoCal | 2****l | 2 |
| Maximilian Pott | m****2@g****m | 2 |
| Michael Mior | m****r@g****m | 2 |
| Nicolas Liaudat | n****t | 2 |
| Oliver Butler | d****v@o****k | 2 |
| Pablo C | P****s | 2 |
| Tomcat86878 | 7****8 | 2 |
| Michal Schwarz | m****z@g****m | 1 |
| Nik | 4****x | 1 |
| and 31 more... | ||
Committer domains:
- gmx.net: 2
- wp.pl: 1
- schumacher.dev: 1
- orangesquash.org.uk: 1
- generac.com: 1
- me.com: 1
- falial.de: 1
- oliverbutler.uk: 1
- schaller-digital.de: 1
- deltacast.tv: 1
- division.ag: 1
- phs.scot: 1
- wolfgangtom.de: 1
- t-haber.de: 1
Issue and Pull Request metadata
Last synced: 1 day ago
Total issues: 535
Total pull requests: 124
Average time to close issues: 4 months
Average time to close pull requests: 20 days
Total issue authors: 354
Total pull request authors: 44
Average comments per issue: 5.33
Average comments per pull request: 1.82
Merged pull request: 95
Bot issues: 0
Bot pull requests: 0
Past year issues: 185
Past year pull requests: 43
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 21 days
Past year issue authors: 142
Past year pull request authors: 20
Past year average comments per issue: 4.92
Past year average comments per pull request: 2.79
Past year merged pull request: 25
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- RubenKelevra (53)
- code-chicken (8)
- kuduacz (7)
- folfy (7)
- R1DEN (6)
- bsafh (5)
- pbranly (5)
- LinuxfarmerHH (5)
- Soukyuu (5)
- daniushko (4)
- DeimicUser (4)
- mueller-esch (4)
- oleksii-kalinin (3)
- 0verEngineer (3)
- jamesonuk (3)
Top Pull Request Authors
- RubenKelevra (30)
- KartoffelToby (17)
- folfy (11)
- wtom (7)
- cygnusb (4)
- albummi (4)
- jamesonuk (4)
- LeoCal (4)
- misa1515 (3)
- hpuac (2)
- Mneric (2)
- UkeHa (2)
- Moohan (2)
- xX7 (2)
- jerome992 (1)
Top Issue Labels
- new bug (256)
- feature (127)
- bug (85)
- wait for feedback (57)
- stale (34)
- under investigation (24)
- enhancement (21)
- faq (15)
- duplicate (15)
- help wanted (11)
- documentation (7)
- special device (5)
- new function (4)
- question (3)
- wontfix (2)
- new integration (1)
- chores (1)
- good first issue (1)
Top Pull Request Labels
- enhancement (14)
- bug (10)
- documentation (10)
- chores (4)
- feature (2)
Dependencies
- actions/checkout v2 composite
- psf/black stable composite
- actions/checkout v2 composite
- home-assistant/actions/hassfest master composite
- actions/checkout v3 composite
- actions/configure-pages v2 composite
- actions/deploy-pages v1 composite
- actions/jekyll-build-pages v1 composite
- actions/upload-pages-artifact v1 composite
- actions/checkout v2 composite
- hacs/action main composite
- black ==23.9.1 development
- codespell ==2.2.2 development
- flake8 ==4.0.1 development
- homeassistant ==2023.9.2 development
- pre-commit ==2.15.0 development
- ruff ==0.0.289 development
- yamllint ==1.32.0 development
Score: 11.245764715739195