
DSVT (Dual Smart Virtual Thermostat) is an open-source Python plugin for Domoticz. It provides heating, cooling, domestic hot water (DHW), and buffer tank control, as well as support for up to 12 independent temperature control zones.
DSVT can be used as part of the Szélessáv SmartHome OpenWrt firmware or installed on a suitably configured existing Domoticz system.
If you are using our Szélessáv SmartHome OpenWrt firmware, no separate installation is required because the DSVT plugin and its web-based configuration interface are already included in the system.
However, during the initial Domoticz configuration, you may still need to configure the geographical coordinates, local API access, and the DSVT hardware device.
The DSVT source code and installation files are available on GitHub:
The repository contains the Python plugin, web configuration interface files, language translations, and program components required for weather data processing.
Installation requires a working Domoticz environment with Python plugin support.
The exact directory locations may vary depending on the operating system, Domoticz package, and installation method.
If sufficient storage space is available and Git is installed, the DSVT repository can be cloned directly into the Domoticz plugins directory.
The following example uses the directory structure of the Szélessáv OpenWrt system.
cd /etc/domoticz/plugins git clone https://github.com/szelessavalapitvany/Domoticz-DSVT.git DSVT_HMV_ZONE_12
This command creates the following directory:
/etc/domoticz/plugins/DSVT_HMV_ZONE_12/
This directory contains the Python files and other components required for the plugin to operate.
DSVT has its own HTML-based configuration interface. The required files must be copied into the Domoticz templates directory.
cp -r /etc/domoticz/plugins/DSVT_HMV_ZONE_12/viewer/* /usr/share/domoticz/www/templates/
This command copies the contents of the repository's viewer directory into the Domoticz web templates directory.
Important: without installing the HTML configuration interface, the plugin's detailed setup page will not be available or function correctly.
On OpenWrt or other systems with limited available storage, cloning the entire Git repository may not be the most practical approach.
Git also creates a .git directory containing version control history and additional metadata.
For these systems, downloading the current DSVT version as a ZIP archive from GitHub may be preferable.
The ZIP archive is available at:
Download DSVT ZIP Archive (main branch)
If the repository's default branch is not main, use GitHub's Code → Download ZIP option instead.
After downloading, extract the archive and copy the files required for operation into the appropriate Domoticz directories.
The typical plugin directory is:
/etc/domoticz/plugins/DSVT_HMV_ZONE_12/
The typical HTML configuration interface directory is:
/usr/share/domoticz/www/templates/
ZIP-based installation avoids storing Git version history on the device and can therefore significantly reduce storage requirements.
Before starting DSVT for the first time, several Domoticz settings should be checked.
Open the following Domoticz menu:
Setup → Settings → System
Enter the actual latitude and longitude of the installation location.
DSVT uses these coordinates when requesting location-specific weather forecasts.
If the coordinates are missing or incorrect, weather-dependent control may produce inaccurate results or weather data retrieval may fail.
DSVT also communicates with Domoticz through its HTTP API.
If the plugin and Domoticz are running on the same device, the following local address can be used:
127.0.0.1
The required local access must be permitted in the Domoticz security settings.
Open:
Setup → Settings → Security → Trusted Networks
Add the following address:
127.0.0.1
Trusted network access should be restricted to addresses that are genuinely trusted.
If Domoticz and DSVT operate in different network environments, or if local API access requires authentication, configure the plugin connection parameters accordingly.
After installing the plugin files and restarting Domoticz, open:
Setup → Hardware
Create a new hardware device and select the following plugin:
DSVT + HMV (DHW) + 12 ZONE
During initial setup, leave the detailed configuration fields empty except for the required operating and connection parameters.
Enter the appropriate Domoticz IP address and port for your installation.
For example, on a local installation:
IP Address: 127.0.0.1 Port: 8080
If Domoticz uses a different port, enter that port instead.
After the hardware device is created, DSVT automatically creates the virtual devices required for its operation.
Important: detailed configuration of zones, heat sources, sensors, mixing valves, and other operating parameters should not be performed through the conventional Domoticz hardware configuration fields.
After creating the DSVT hardware device, the plugin's web-based configuration interface becomes available through the Domoticz Custom menu.
Open:
Custom → HTML setup!
This interface allows you to configure:
If the Custom menu or HTML setup page does not appear, check the following:
viewer files have been copied correctly.Appropriate Domoticz user permissions are required to access the Custom menu.
After installing the plugin or updating its Python code, restart the Domoticz service.
/etc/init.d/domoticz restart
sudo systemctl restart domoticz
The service name and restart procedure may differ depending on the installation.
After restarting, refresh the Domoticz interface in your web browser.
If the HTML configuration interface or translations do not update immediately, perform a forced browser refresh or open Domoticz in a new private browsing window.
This may be necessary because older JavaScript, HTML, or other static files may still be loaded from the browser cache.
DSVT development and new versions are published through the GitHub repository.
If DSVT was installed using Git, open the plugin directory:
cd /etc/domoticz/plugins/DSVT_HMV_ZONE_12 git pull
After updating, copy the web configuration interface files again:
cp -r /etc/domoticz/plugins/DSVT_HMV_ZONE_12/viewer/* /usr/share/domoticz/www/templates/
Then restart the Domoticz service.
If you have previously modified files in the local repository, git pull may report conflicts. In that case, save or resolve your local changes before updating.
On systems with limited storage, DSVT can also be updated by downloading a newer ZIP archive from GitHub.
Extract the archive and copy the required plugin and HTML configuration interface files into their respective target directories, replacing the previous versions.
In addition to updating the Python plugin, the contents of the viewer directory should also be updated, particularly when the configuration interface or its translations have changed.
After replacing the files, restarting Domoticz and refreshing the browser cache are recommended.
You can verify that DSVT has been installed successfully by checking the following:
If the plugin does not start, first check the Domoticz log. Python exceptions, missing files, and API connection problems are generally reported there.
The DSVT source code, updates, and issue tracker are available on GitHub:
When reporting a bug or compatibility issue, please include the Domoticz version, operating system, DSVT version, relevant log messages, and the affected configuration details.
A properly configured Domoticz environment and following the recommended installation sequence can significantly simplify the initial DSVT setup and future updates.