--- title: "Smart thermostat" description: "Smart thermostat is a Marketplace integration for Home Assistant. It has 852 installs sharing analytics, works locally and was last updated October 19, 2026." canonical: "https://vulpo.app/integrations/marketplace/scratman-hasmartthermostat" url: "https://vulpo.app/integrations/marketplace/scratman-hasmartthermostat.md" last-updated: "2026-10-22" version: "1.4" --- # Smart thermostat > Smart thermostat is a Marketplace integration for Home Assistant. It has 852 installs sharing analytics, works locally and was last updated October 19, 2026. Smart thermostat is a Home Assistant integration that adds a virtual thermostat driven by a PID controller. It appears as a climate entity and works locally, with setup done in the UI. A heater or air conditioner with a simple on/off switch can be controlled through pulse width modulation, where the on time depends on the temperature error and how it changes over time. The heating actuator can be a switch, valve, light or number entity, and a room temperature sensor is required, with optional cooling actuators and an outdoor sensor for compensation. Settings cover target temperature limits, hot and cold tolerance, preset temperatures, PID gains, sampling period and autotune options. Safety settings set an output level for when the sensor stops updating or becomes unavailable. Automatic summary of the README and code of ScratMan/HASmartThermostat. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=ScratMan&repository=HASmartThermostat&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=ScratMan&repository=HASmartThermostat&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Main Configuration - **Thermostat Name**: Name displayed for the climate entity in Home Assistant. - **Heating Actuator(s)**: Switch, valve, light, or number entity controlling heat (Required). - **Room Temperature Sensor**: Temperature sensor measuring the room temperature (Required). - **Cooling Actuator(s)**: Optional actuator used when cooling mode is active. - **Outdoor Temperature Sensor**: Optional outdoor sensor used for Ke compensation. - **Invert Actuator Polarity**: Enable if the actuator must be turned off to heat (e.g., inverted relay). - **Cooling / AC Mode**: Switch the main actuator to cooling mode instead of heating. - **Force Actuator Off When Thermostat is Off**: Ensures the actuator is physically turned off when HVAC mode is OFF. ### Temperature Settings - **Minimum Target Temperature**: Leave blank to use Home Assistant default value. - **Maximum Target Temperature**: Leave blank to use Home Assistant default value. - **Initial Target Temperature** - **Hot Tolerance**: Hysteresis above setpoint. - **Cold Tolerance**: Hysteresis below setpoint. - **Initial HVAC Mode** - **Preset Sync Mode** - **Disable PID in Boost Preset**: Forces PID mode to OFF when Boost preset is enabled. ### Preset Temperatures - **Away Temperature** - **Eco Temperature** - **Boost Temperature** - **Comfort Temperature** - **Home Temperature** - **Sleep Temperature** - **Activity Temperature** ### PID Controller - **Proportional Gain (Kp)** - **Integral Gain (Ki)** - **Derivative Gain (Kd)** - **Outdoor Compensation Gain (Ke)**: Gain applied to the difference between target and outdoor temperature. - **PWM Period**: Full cycle time for pulse-width modulation regulation. - **Keep-alive Interval**: Periodically re-sends turn on/off commands to actuators. - **PID Sampling Period** - **Autotune Rule** - **Autotune Noise Band** - **Autotune Lookback Period** ### Advanced Settings - **Output Precision** - **Minimum Output** - **Maximum Output** - **Output Clamp Low** - **Output Clamp High** - **Minimum Cycle Duration** - **Minimum Off Cycle Duration** - **Sensor Stall Timeout**: Timeout before falling back to safety level if sensor stops updating. - **Safety Output Level**: Output percentage applied when sensor is stalled or unavailable. - **Debug Mode** Texts from the code of [ScratMan/HASmartThermostat](https://github.com/ScratMan/HASmartThermostat). ## At a glance - Kind: Marketplace integration - Category: [Climate](https://vulpo.app/integrations/category/climate.md), Thermostats and heating - Number: 852 installs sharing analytics; 540 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: 2026.10.2, last updated October 19, 2026 - Domain: `smart_thermostat` - Source: - Issues: - Screenshot: https://vulpo.app/integrations-img/f931170ce3c901b7.webp (from ScratMan/HASmartThermostat's README) In Vulpo: Climate card, Apple Watch, Climate Live Activity (Pro) [Widgets & Live Activities in Vulpo](https://vulpo.app/features/widgets-and-live-activities) Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/marketplace/scratman-hasmartthermostat --- - HTML version of this page: https://vulpo.app/integrations/marketplace/scratman-hasmartthermostat - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml