Better Thermostat for Home Assistant (Marketplace integration)

Installs: 8.2k sharing analytics
GitHub stars: 1.5k
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: 1.9.3, October 26, 2026
Category: Climate, Thermostats and heating
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: better_thermostat
Source: github.com/KartoffelToby/better_thermostat
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Better Thermostat adds smart control to existing radiator thermostat valves that appear as climate entities in Home Assistant. It can measure room temperature with a separate sensor, and it can turn heating off when a window or door opens, or when outdoor temperature or a weather entity says so. Several valves can be grouped into one, and valve maintenance runs automatically to keep valves from sticking over the summer. Control algorithms include MPC, PID, TPI, AI Time Based, and plain target temperature matching, with auto-tuning for PID still in beta. Preset temperatures are adjustable through number entities and are kept across restarts, and extra sensors and switches expose values such as heating power and child lock. It works locally, is set up in the UI, and offers device triggers such as window opened or target temperature reached.

Automatic summary of the README and code of KartoffelToby/better_thermostat. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
Device triggers Its devices can start automations directly.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Climate
Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Connect

Name
The real thermostat
The cooling device (optional)
Minimum seconds between repeated cooler commands (0 = disabled)
Temperature sensor
Humidity sensor
Window sensor
Door sensor
The outdoor temperature when the thermostat should turn off
Tolerance, to prevent the thermostat from turning on and off too often
Delay before the thermostat should turn off when the window is opened
Delay before the thermostat should turn on when the window is closed
Delay before the thermostat should turn off when the door is opened
Delay before the thermostat should turn on when the door is closed
Outdoor temperature sensor

Advanced

Overheating protection?Some TRVs don't close the valve completely when the temperature is reached. Or the radiator has a lot of rest heat. This can cause overheating. This option can prevent this.
If 'auto' means 'heat' for your TRV and you want to swap it
Ignore all inputs on the TRV like a child lock
If you use HomematicIP, you should enable this to slow down the requests to prevent the duty cycle
If your thermostat has no own maintenance mode, you can use this one
Calibration typeHow the calibration is applied on the TRV *Target Temperature Based*: Apply the calibration to the target temperature. *Offset Based*: Apply the calibration to the temperature offset.
Calibration modeHow the calibration is calculated *Normal*: Uses your external temperature sensor to correct the TRV's internal sensor. Simple and reliable for most setups. *Aggressive*: Similar to Normal, but pushes the TRV harder to reach temperature faster. Good if your room heats slowly. *AI Time Based*: Learns your room's heating patterns over time and adjusts automatically. Balances comfort and efficiency. *MPC Predictive*: Advanced algorithm that predicts temperature changes and optimizes valve position. Best for stable, efficient heating with minimal overshooting. Learns your room's thermal behavior. *PID Controller*: Classic control method that responds to temperature errors. Good for systems with varying heating power or external disturbances. *TPI Controller*: Calculates heating duty cycles based on temperature difference. Simple and effective for consistent heating patterns.
If your TRV doesn't support the 'off' mode, enable this to use target temperature 5°C instead

After setup

Name
The real thermostat
Temperature Sensor
Humidity sensor
Window Sensor
Door sensor
The outdoor temperature when the thermostat should turn off
Tolerance, to prevent the thermostat from turning on and off too often
Delay before the thermostat should turn off when the window is opened
Delay before the thermostat should turn on when the window is closed
Delay before the thermostat should turn off when the door is opened
Delay before the thermostat should turn on when the door is closed
Outdoor temperature sensor
Weather entity to get the outdoor temperature
Target minimum temperature
Overheating protection?Some TRVs don't close the valve completely when the temperature is reached. Or the radiator has a lot of rest heat. This can cause overheating. This option can prevent this.
If 'auto' means 'heat' for your TRV and you want to swap it
Ignore all inputs on the TRV like a child lock
If you use HomematicIP, you should enable this to slow down the requests to prevent the duty cycle
If your thermostat has no own maintenance mode, you can use this one
Calibration typeHow the calibration is applied on the TRV *Target Temperature Based*: Apply the calibration to the target temperature. *Offset Based*: Apply the calibration to the temperature offset.
Calibration modeHow the calibration is calculated *Normal*: Uses your external temperature sensor to correct the TRV's internal sensor. Simple and reliable for most setups. *Aggressive*: Similar to Normal, but pushes the TRV harder to reach temperature faster. Good if your room heats slowly. *AI Time Based*: Learns your room's heating patterns over time and adjusts automatically. Balances comfort and efficiency. *MPC Predictive*: Advanced algorithm that predicts temperature changes and optimizes valve position. Best for stable, efficient heating with minimal overshooting. Learns your room's thermal behavior. *PID Controller*: Classic control method that responds to temperature errors. Good for systems with varying heating power or external disturbances. *TPI Controller*: Calculates heating duty cycles based on temperature difference. Simple and effective for consistent heating patterns.
If your TRV doesn't support the 'off' mode, enable this to use target temperature 5°C instead

Texts from the code of KartoffelToby/better_thermostat.

Entities

NumbersPID Kp (Proportional), PID Ki (Integral), PID Kd (Derivative), Eco, Eco Min, Eco Max, Away, Away Min, Away Max, Boost, Boost Min, Boost Max, and 13 more
SensorsTemperature EMA, Temperature EMA 1h, Temperature Slope, Heating Power, Heat Loss, Virtual Temperature, MPC Gain, MPC Loss, MPC Insulation (Ka), PID Kp, PID Ki, PID Kd, and 3 more
SwitchesPID Auto Tune, Child Lock

Actions

Run valve maintenance nowRun the valve maintenance cycle immediately for this Better Thermostat entity.
Reset heating powerReset the heating power to its default value.
Reset PID learningsClear all learned PID state for this entity.Fields: Apply PID defaults after reset, Default kp, Default ki, Default kd

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.

From the README

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
Dynamic preset temperature learning & persistence (baseline/"no preset" remembers the last temperature you set and survives restarts)
Advanced Control Algorithms: Choose between MPC, PID, TPI, AI Time Based or simple target temperature matching for precise control.
Selectable Presets: Configure which preset modes are available for your thermostat during setup.

From the README of KartoffelToby/better_thermostat, GNU AGPL v3.0. Shortened.