⭐ NEW V4 RELEASE ⭐
Fan, humidifier, dehumidifier, modern actions, and enhanced visuals
A Codex assisted, community maintained fork of simple-thermostat by @nervetattoo, kept working with current Home Assistant releases. The v4 modernization was heavily influenced by duczz/ha-simple-thermostat.
A compact Lovelace card for Home Assistant climate, fan, humidifier, and dehumidifier entities. It keeps the original small-card style while adding domain-aware setpoints, current values, action handling, richer mode controls, and enhanced visuals.
current_temperature_entity, sensors, and layout.sensors YAML into the current current_value_entity, entities, and layout.entities config shape. If you are staying on v3, use the v3 documentation.
Or add it manually in HACS:
-
Open HACS in Home Assistant.
-
Open Custom repositories.
-
Add this repository:
https://github.com/Wheemer/simple-thermostat -
Choose type Dashboard.
-
Install Simple Thermostat.
-
Refresh Home Assistant and clear the browser cache if the old card is still loaded.
If you installed simple-thermostat from another repository, uninstall the old HACS entry first. Then add this repository as the dashboard custom repository and install it again.
If you are not upgrading to v4, keep using the v3 documentation for the older config surface.
-
Download
simple-thermostat.jsfrom the latest release. -
Put it in your Home Assistant
wwwfolder. -
Add this Lovelace resource:
resources: - url: /local/simple-thermostat.js type: module
Use the Home Assistant visual editor for normal setup. In v4, the card reads the selected entity and shows the options that apply to that device, so most cards can be configured without opening YAML.
- Open a dashboard and choose Edit dashboard.
- Select Add card.
- Search for Simple Thermostat.
- Pick your climate, fan, humidifier, or dehumidifier entity.
- Adjust the controls, header toggles, extra entity rows, target controls, and appearance in the editor.
The editor handles the common v4 setup:
- Entity and current value selection.
- Climate, fan, humidifier, and dehumidifier controls.
- Header toggles and toggle icons.
- Extra entity rows, names, icons, and row layout.
- Setpoint visibility and v4 enhanced visuals.
- Advanced labels, precision, action type, and mode display options.
The card chooses sensible defaults from the selected entity:
| Domain | Target | Current value | Default controls |
|---|---|---|---|
climate |
Temperature | current_temperature or configured current value entity |
HVAC, preset, fan, swing, vane |
fan |
Percentage | Percentage when available | Fan speeds, direction, oscillating, state |
humidifier |
Humidity | current_humidity |
Mode, state |
Dehumidifiers use the Home Assistant humidifier domain.
YAML is still supported for advanced customization, migration, and manual dashboard editing, but it is no longer the recommended starting point for v4.
Use the YAML reference for:
- advanced mode filtering,
- extra entity attributes, units, decimals, relative time, and templates,
- manual setpoint definitions,
- service overrides,
- target value tap, hold, and double tap actions,
- scoped custom CSS,
- the full option reference.
| Version | Changes |
|---|---|
| v4.0.0-rc.6 | Polished the visual editor into a clearer setup flow. |
| Added simple extra entity row editing for entity, name, and icon. | |
| Moved precision, fallback, custom labels, actions, and mode display options into Advanced. | |
| Updated editor-first README guidance. | |
| v4.0.0-rc.5 | Aligned card lifecycle behavior more closely with v3. |
| Removed extra loading and missing-entity wrapper behavior. | |
| Added detach and reattach lifecycle regression coverage. | |
| v4.0.0-rc.4 | Hardened card lifecycle when Home Assistant provides state before config. |
| Kept optional extra entity rows from breaking the card during transient missing states. | |
Mapped auto_comfort preset variants to the comfort icon. | |
| Added lifecycle and icon regression tests. | |
| v4.0.0-rc.3 | Preserved last valid render during transient missing entity updates. |
| Tightened single-row entity spacing. | |
| Standardized dense mode button sizing. | |
| Added lifecycle regression tests. | |
| v4.0.0-rc.2 | Improved enhanced_visuals: false v3-style defaults. |
| Improved state text for climate, fan, humidifier, and dehumidifier cards. | |
| Refined header and entity toggle colors. | |
| Increased active icon animation visibility. | |
| Cleaned up dense climate mode layouts. | |
| Added contextual fan speed icons. | |
| Linked v3 documentation. | |
| v4.0.0-rc.1 | Added domain-aware climate, fan, humidifier, and dehumidifier support. |
| Added fan percentage setpoints and mode controls. | |
| Added humidifier and dehumidifier humidity controls. | |
| Added v4 enhanced visuals. | |
| Added Home Assistant 2024.8+ action support. | |
| Kept legacy config aliases supported. | |
| v4.0.0 | Requires Home Assistant 2024.8+. |
| Added climate, fan, humidifier, and dehumidifier domain-aware behavior. | |
| Added fan percentage setpoints, speed/preset modes, direction, oscillation, and state controls. | |
| Added humidifier and dehumidifier humidity setpoints, current humidity, modes, and state controls. | |
Added generic current_value_entity and entities options. | |
Imported legacy current_temperature_entity, sensors, and layout.sensors config names. | |
Kept version: 3 templated entity rows supported. | |
| Added automatic current value defaults for supported domains. | |
Added hide_setpoint. | |
| Added state-aware headers, header toggles, off-icon slash overlays, and fault icons. | |
| Added richer mode controls, mode icons, compact tooltips, and hidden headings by default. | |
| Added horizontal setpoint controls and target value tap, hold, and double tap actions. | |
| Added entity-aware visual editor options. | |
Added enhanced_visuals and documented CSS variables. | |
| Updated service calls, custom element registration, HACS packaging, and GitHub Actions builds. |