Skip to content

jmcollin78/versatile-thermostat-ui-card

Repository files navigation

GitHub Release GitHub Activity License hacs BuyMeCoffee

Tip

UI Card for Versatile Thermostat

Tip This card is dedicated to the Versatile Thermostat integration which is available in HACS also and here.

This card is based on the beautiful Better Thermostat UI Card. It adds some feature so that you can use Versatile Thermostat directly from the card. A big thanks to @KartoffelToby for this Better Thermostat UI Card.

Notes:

  1. The VTherm should be in V8.x or above to work well with this version.
  2. Only VTherm climate entities will have a correct display with this card. Other climate should work rougthly

When presence is detected:

Versatile Thermostat UI Card with presence

When safety is detected:

Versatile Thermostat UI Card with security

When activity is detected:

Versatile Thermostat UI Card with activity

When overpowering is detected:

Versatile Thermostat UI Card with overpowering

When window open is detected:

Versatile Thermostat UI Card with window open

When window bypass is activated:

Versatile Thermostat UI Card with window bypass

With all status icons:

Versatile Thermostat UI Card with all status icons

The card configuration:

Versatile Thermostat UI Card configuration

Goals

  • Add versatile_thermostat support for showing the extra status
  • Improve the UI for Touch devices

Installation

For installation you should have HACS installed. Then add this repository https://github.com/jmcollin78/versatile-thermostat-ui-card in HACS and install the card. You have to reload you browser after installation.

Then you can add the new card into your dashboard.

Options

Note: those options should be improved with official release

Name Type Default Description
type string Required custom:versatile-thermostat-ui-card
entity string Required The entity id of climate entity (must be a versatile_thermostat entity). Example: climate.hvac
name string/boolean optional override the default entity name
disable_name boolean optional true to hide the name
disable_circle boolean optional true to hide the circle for setpoint. If no checked, an colored ellipse on the background is displayed instead. This option save space
disable_window boolean optional turn off the window open indicator
disable_overpowering boolean optional turn off the overpowering indicator
disable_heat boolean optional turn off the on/heat button
disable_cool boolean optional turn off the on/cool button
disable_heat_cool boolean optional turn off the on/heat_cool button
disable_auto boolean optional turn off the on/auto button
disable_dry boolean optional turn off the on/dry button
disable_fan_only boolean optional turn off the on/fan_only button
disable_off boolean optional turn off the off button
disable_sleep_mode boolean optional turn off the sleep mode button
disable_buttons boolean optional turn off the plus/minus buttons
disable_safety_warning boolean optional turn off the security warning (when a temperature sensor is out)
disable_power_infos boolean optional turn off the power informations
disable_auto_fan_infos boolean optional turn off the auto-fan informations
disable_target_icon boolean optional hide the target icon for the setpoint temperature (which can be confusing with the room temperature)
set_current_as_main boolean optional Exchange target temperature and room temperature
autoStartStopEnableEntity string Optional The entity id of auto-start/stop entity (must be a switch entity). Example: switch.clim_salon_auto_start_stop
powerEntity string Optional The entity id of sensor entity which gives the real power consumed by the VTherm. Example: sensor.clim_salon_power
allow_lock_toggle boolean Optional true to display a lock icon to lock/unlock the thermostat. If a code is configured in VTherm, a keypad will be displayed.
disable_timed_preset boolean Optional true to hide the timed preset duration selector next to preset icons.
use_manual_duration_input boolean Optional true to use a manual input field instead of the preset duration selector (15min, 30min, 1h, 4h, 8h, 24h).

Example:

type: custom:versatile-thermostat-ui-card
entity: climate.multi_climate
set_current_as_main: true
disable_circle: true
disable_menu: true
autoStartStopEnableEntity: switch.multi_climate_enable_auto_start_stop
powerEntity: sensor.multi_climate_power

configuration window

Actions

Some actions are available directly on the card.

Disable the auto-fan mode

For over_climate you have the possibility to configure the auto-fan mode feature. See versatile_thermostat README.

If the auto-fan mode is configured, you can toggle between the configured auto_fan_mode configured for the VTherm and the None mode (which disable the auto-fan mode).

To toggle the auto-fan mode you must:

  1. click on the Auto-fan icon at the left of the Thermostat.

By-pass the window detection

If an open window has been detected, you want to bypass it by clicking on the window icon (above the temperatures). This will enable the window by-pass and then disable the window detection impact. Notice that the icon change to this one when the by-pass is set: window bypass icon

Lock/Unlock the thermostat

You can lock or unlock the thermostat by clicking on the lock icon at the top right of the card. If a pincode is configured in the Versatile Thermostat integration, a keypad dialog will appear to enter the code. This requires the allow_lock_toggle option to be set to true in the card configuration.

Timed preset

The timed preset feature allows you to temporarily switch to a preset for a specific duration. After the duration expires, the thermostat will automatically return to its previous preset.

This feature requires Versatile Thermostat v8.4.2 or above.

How to use

  1. Next to the preset icons, you will see a duration selector (or input field if use_manual_duration_input is enabled)
  2. Select a duration: 15 min, 30 min, 1h, 4h, 8h, or 24h (or enter a custom duration in minutes if using manual input)
  3. Click on the desired preset icon
  4. The preset will be activated for the selected duration

The new timed preset field:

timed preset

When the select duration is open:

timed preset select open

With the option to enter manually the duration:

timed preset select open

When a timed preset is active

When a timed preset is active:

  • The duration selector is replaced by the remaining time display (e.g., "45 min" or "2h30" for durations over 1 hour)
  • A cancel button (X) appears next to the remaining time
  • Click the cancel button to immediately cancel the timed preset and return to the previous preset

timed preset when active

Configuration options

  • disable_timed_preset: Set to true to completely hide the timed preset feature
  • use_manual_duration_input: Set to true to use a free input field (in minutes) instead of the preset duration selector

Example with timed preset using selector (default):

type: custom:versatile-thermostat-ui-card
entity: climate.living_room

Example with manual duration input:

type: custom:versatile-thermostat-ui-card
entity: climate.living_room
use_manual_duration_input: true

Example with timed preset disabled:

type: custom:versatile-thermostat-ui-card
entity: climate.living_room
disable_timed_preset: true

Informations on current state

Display some messages

When the mode or the preset or the target temperature has been changed due to special event (window detection, motion detection, power, ...) an information icon like information icon or warning icon is diplayed on the left bar. Click on it and you will see why your VTherm is not in the requested state.

Example when the setpoint has been changed due to motion detection:

message activity detected

Another example when the VTherm has been turned off by the auto-start/stop feature:

message turned of by auto-start/stop

When overpowering and shedding is activated and the setpooint has been set with the power_temp configuration value:

shedding message

If the VTherm has been turned off by the auto-start/stop feature:

auto stop message

When the timed preset is active:

timed preset message

When a heating failure is detected:

heating failure message

See more informations on heating failure detection in the VTherm documentation.

Just click another time to the information icon to close the information popup.

Update of underlying scheduled

When the update of the underlying has been delayed due to temporal filter (see on VTherm documentation), then an update icon will be displayed in the left bar:

underlyoing update delayed

Safety state

The safety state informs you that one off the temperature sensors configured in your VTherm don't have send any new temperature to your VTherm. When this happens, there is a risk of overheating and then the VTherm turns into the safety state. This is displayed like that:

safety message

The safety mode has been activated because the outdoor temperature sensor's last measurement was 554 minutes ago (and the room temperature was 13 min ago which is more normal).

More informations on the safety mode can be found here.

Icons used

Icon Meaning
information icon Some information messages are available. Click on it to see it
warning icon Some warning informations messages are available. Click on it to see it
underlying update delayed icon The underlying device's update has been delayed. See temporal filter on VTherm documentation
presence detected icon The presence is detected
motion detected icon The activity (ie motion) is detected
window detected icon The window is detected as open. Click on it to bypass the window detection
window bypass icon The window bypass is active. Click on it to cancel the bypass
overpowering detected icon An overpowering detection has been done. The VTherm is in shedding mode
auto stop icon The VTherm has been turned off by the auto-start/stop feature.
target temperature icon The target temperature (setpoint)
havc action cooling The underlying device is cooling (hvac_action is cooling)
havc action idle in cool mode The underlying device is idle and the mode is Cool (hvac_action is idle and the hvac_mode is Cool)
havc action heating The underlying device is heating (hvac_action is heating)
havc action idle in heat mode The underlying device is idle and the mode is Heat (hvac_action is idle and the hvac_mode is Heat)

Example:

a full example of a card with many icons

Help wanted!

It would be awsome if you help me to translate this card to other languages.

Create a PR, the Translation is done in json files checkout the en translation here

Please add your language to this list as well while you are making your PR. Put it in alphabetical order and according to ISO 639-1.

Translations

INLANG Editor

What we have so far:

  • en - Reference
  • bg
  • ca
  • cn
  • cs
  • da
  • de
  • el
  • es
  • fi
  • fr - Reference
  • hu
  • it
  • nl
  • no
  • pl
  • pt
  • ro
  • ru
  • sv
  • sl
  • sk
  • tr
  • uk

Support me


About

A custom card for a Versatile thermostat in home assistant based on versatile_thermostat integration

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published