VTherm Climate Replication

VTherm Climate Replication is a Home Assistant custom integration for Versatile Thermostat.

It links a physical thermostat entity to a Versatile Thermostat climate entity and forwards the physical thermostat state changes to the target VTherm. The goal is to use a real thermostat as a physical remote control for a VTherm.

What the integration does

For each configured pair, the integration listens to the selected physical climate entity and updates the selected Versatile Thermostat climate entity.

The integration currently replicates:

• HVAC mode
• Target temperature
• Preset mode when the target VTherm supports presets

Each replication entry also creates a switch entity. This switch can be used to temporarily disable replication without removing the configuration entry. When the switch is turned on again, the target VTherm is immediately resynchronized with the current state of the physical thermostat.

Requirements

Before installing this integration, make sure that:

• Versatile Thermostat is already installed in Home Assistant
• the physical thermostat you want to mirror is available as a climate entity
• the target Versatile Thermostat is already created and available as a climate entity

Installation

Option 1: Install with HACS

1. Open HACS in Home Assistant.
2. Add this repository as a custom repository.
3. Select the Integration category.
4. Install VTherm Climate Replication.
5. Restart Home Assistant.

Option 2: Manual installation

1. Copy the custom_components/vtherm_climate_replication folder into your Home Assistant custom_components directory.
2. Restart Home Assistant.

Configuration

This integration is configured from the Home Assistant user interface. There is no YAML configuration.

1. Go to Settings > Devices & Services.
2. Select Add Integration.
3. Search for VTherm Climate Replication.
4. Choose the physical thermostat climate entity.
5. Choose the Versatile Thermostat climate entity to update.
6. Confirm the configuration.

The two selected climate entities must be different.

You can create multiple replication entries, but the same physical climate and target climate pair cannot be configured twice.

How to use it

After the integration is configured:

• change the HVAC mode on the physical thermostat to update the VTherm
• change the target temperature on the physical thermostat to update the VTherm
• change the preset on the physical thermostat to update the VTherm when presets are supported
• use the replication switch entity to enable or disable forwarding at runtime

Notes

• The integration adds a switch platform only.
• Replication is enabled by default when a configuration entry is created.
• Turning replication back on triggers a full state resynchronization from the physical thermostat to the target VTherm.

Contributions are welcome!

If you wish to contribute, please read the contribution guidelines.

🍻 Thanks for the beers 🍻

---