[Plugin] ASC – Automatic Shutter Controller for Domoticz
Posted: Tuesday 10 November 2026 10:27
Hello Domoticz community,
I would like to introduce ASC (Automatic Shutter Controller), an open-source Python plugin for Domoticz developed as part of the Szélessáv Smart Home project in Hungary.
ASC automates motorized shutters, roller blinds and other compatible shading devices, with two main objectives:
Improving energy efficiency while maintaining indoor comfort.
The plugin is now publicly available on GitHub, and we have also updated the documentation, including an English version.
Main Features
Unlike systems with fixed shading rules, ASC allows users to determine exactly how their shutters should behave under different environmental conditions.
The controller uses a configurable 36-state decision matrix:
3 indoor temperature ranges × 2 indoor/outdoor temperature relationships × 3 light levels × 2 presence states = 36 operating states.
Each operating state has its own configurable shutter position.
For example, during colder weather, opening the shutters can help take advantage of solar heat gains. During warmer weather, shading can reduce overheating and potentially lower cooling demand.
When someone is home, natural daylight and occupant comfort can be given priority over maximum energy savings.
These are illustrative strategies, not mandatory rules. The user can configure all 36 shutter positions according to the building, room orientation and personal preferences.
The default indoor temperature target range is 20–25 °C, but both limits can be adjusted independently.
HTML Configuration Interface
ASC includes a dedicated HTML configuration interface accessible through:
The interface provides:
Domoticz Controls and Settings
The plugin creates standard Domoticz devices for configuring and monitoring the controller.
These include:
Sensors and Weather Data
ASC can use the following sensors:
An indoor temperature sensor is optional.
When no indoor thermometer is configured, ASC uses a fixed 22 °C fallback value. This can also be useful for terrace shading and other installations without an indoor temperature sensor.
When local outdoor temperature, wind or lux sensors are unavailable, the controller can use Open-Meteo weather data.
Forecast-based lux values are estimates rather than direct measurements.
An internet connection is required for Open-Meteo forecasts, but ASC can operate using local sensors without relying on external cloud services.
Optional Presence Detection
ASC can also take occupancy into account when selecting the shutter position.
For example, when someone is home, the controller can prioritize natural daylight and occupant comfort. When nobody is home, settings can be optimized more strongly for temperature conservation.
The current implementation supports integration with our separate OpenWrt Presence project, which provides Wi-Fi and network-based presence detection.
Presence detection is optional and does not have to be enabled for basic shutter control.
Wind and Vibration Protection
ASC provides two additional protective functions.
Wind protection:
When wind speed exceeds the configured threshold, ASC can issue a protective shutter position command.
Wind speed can come from a local Domoticz sensor or Open-Meteo weather data.
Vibration protection:
A compatible vibration sensor can detect abnormal movement of an outdoor shading structure and trigger protective operation.
A configurable protection period prevents the controller from immediately returning to normal operation after a detected event.
Both features have separate Domoticz alert devices.
Please note that these are supplementary automation functions and are not substitutes for manufacturer-required safety systems.
Installation and Compatibility
ASC is a Python plugin for the Domoticz plugin framework.
The project includes:
The plugin has been used with Domoticz 2025.2. Compatibility with other versions may require additional testing.
Source Code and Documentation
GitHub repository:
https://github.com/szelessavalapitvany/ ... Controller
Project documentation (English version available):
https://www.szelessavmuhely.hu/en/shutter_control
The documentation covers installation, hardware configuration, the HTML interface, wind and vibration protection, and integration of existing RF-controlled shutters with Tasmota and Domoticz.
Feedback and Contributions
ASC is an ongoing open-source project, and we would welcome feedback from other Domoticz users.
Bug reports, suggestions, installation experiences and contributions are all appreciated.
I would also be interested in hearing how other users approach energy-efficient shading, especially when balancing indoor comfort, natural daylight and temperature management.
Developed by Szélessáv Közhasznú Alapítvány / Szélessáv Műhely, Hungary.
Thank you!
I would like to introduce ASC (Automatic Shutter Controller), an open-source Python plugin for Domoticz developed as part of the Szélessáv Smart Home project in Hungary.
ASC automates motorized shutters, roller blinds and other compatible shading devices, with two main objectives:
Improving energy efficiency while maintaining indoor comfort.
The plugin is now publicly available on GitHub, and we have also updated the documentation, including an English version.
Main Features
- Automatic shutter positioning based on indoor and outdoor temperature, light intensity and optional presence detection.
- 36 fully configurable operating states, each with an independently adjustable shutter position from 0% to 100%.
- Three indoor temperature ranges: below the minimum target, within the desired range and above the maximum target.
- Separate configurations depending on whether the outdoor temperature is higher or lower than the indoor temperature.
- Three light intensity ranges, with configurable lux thresholds and hysteresis to reduce unnecessary shutter movements.
- Optional presence detection to prioritize natural daylight and occupant comfort.
- Wind speed protection using local sensors or Open-Meteo weather data.
- Optional vibration-based protection for sensitive outdoor shading systems, including a configurable protection period.
- Manual shutter positioning and automatic operating modes.
- Custom HTML configuration interface integrated into Domoticz.
- Support for multiple shutters and multiple sensors per controller.
- Local operation without requiring a manufacturer's cloud service or subscription.
Unlike systems with fixed shading rules, ASC allows users to determine exactly how their shutters should behave under different environmental conditions.
The controller uses a configurable 36-state decision matrix:
3 indoor temperature ranges × 2 indoor/outdoor temperature relationships × 3 light levels × 2 presence states = 36 operating states.
Each operating state has its own configurable shutter position.
For example, during colder weather, opening the shutters can help take advantage of solar heat gains. During warmer weather, shading can reduce overheating and potentially lower cooling demand.
When someone is home, natural daylight and occupant comfort can be given priority over maximum energy savings.
These are illustrative strategies, not mandatory rules. The user can configure all 36 shutter positions according to the building, room orientation and personal preferences.
The default indoor temperature target range is 20–25 °C, but both limits can be adjusted independently.
HTML Configuration Interface
ASC includes a dedicated HTML configuration interface accessible through:
Code: Select all
Custom → ASC_Shutter_Redony- Current indoor and outdoor temperatures.
- Current illuminance and calculated light thresholds.
- The selected operating mode and shutter position.
- The complete 36-state configuration matrix.
- Separate settings for presence and absence.
- Individual shutter positions for each environmental condition.
- ASC_HTML_setup.png (260.1 KiB) Viewed 99 times
The plugin creates standard Domoticz devices for configuring and monitoring the controller.
These include:
- Operating mode selector: Off, Automatic and fixed percentage positions.
- Minimum and maximum indoor target temperatures.
- Opening and strong-light thresholds.
- Lux history period and lux hysteresis.
- Temperature hysteresis.
- Wind speed protection threshold.
- Vibration sensitivity and protection duration.
- Separate wind and vibration alert devices.
- ASC_kapcsolok.png (98.51 KiB) Viewed 99 times
ASC can use the following sensors:
- Indoor temperature sensors.
- Outdoor temperature sensors.
- Illuminance (lux) sensors.
- Wind speed sensors.
- Vibration sensors.
An indoor temperature sensor is optional.
When no indoor thermometer is configured, ASC uses a fixed 22 °C fallback value. This can also be useful for terrace shading and other installations without an indoor temperature sensor.
When local outdoor temperature, wind or lux sensors are unavailable, the controller can use Open-Meteo weather data.
Forecast-based lux values are estimates rather than direct measurements.
An internet connection is required for Open-Meteo forecasts, but ASC can operate using local sensors without relying on external cloud services.
Optional Presence Detection
ASC can also take occupancy into account when selecting the shutter position.
For example, when someone is home, the controller can prioritize natural daylight and occupant comfort. When nobody is home, settings can be optimized more strongly for temperature conservation.
The current implementation supports integration with our separate OpenWrt Presence project, which provides Wi-Fi and network-based presence detection.
Presence detection is optional and does not have to be enabled for basic shutter control.
Wind and Vibration Protection
ASC provides two additional protective functions.
Wind protection:
When wind speed exceeds the configured threshold, ASC can issue a protective shutter position command.
Wind speed can come from a local Domoticz sensor or Open-Meteo weather data.
Vibration protection:
A compatible vibration sensor can detect abnormal movement of an outdoor shading structure and trigger protective operation.
A configurable protection period prevents the controller from immediately returning to normal operation after a detected event.
Both features have separate Domoticz alert devices.
Please note that these are supplementary automation functions and are not substitutes for manufacturer-required safety systems.
Installation and Compatibility
ASC is a Python plugin for the Domoticz plugin framework.
The project includes:
- The Python plugin.
- Multilingual translation files.
- A dedicated HTML configuration interface.
- Installation and configuration documentation.
- ASC_Domoticz_hardwer.png (146.99 KiB) Viewed 99 times
Source Code and Documentation
GitHub repository:
https://github.com/szelessavalapitvany/ ... Controller
Project documentation (English version available):
https://www.szelessavmuhely.hu/en/shutter_control
The documentation covers installation, hardware configuration, the HTML interface, wind and vibration protection, and integration of existing RF-controlled shutters with Tasmota and Domoticz.
Feedback and Contributions
ASC is an ongoing open-source project, and we would welcome feedback from other Domoticz users.
Bug reports, suggestions, installation experiences and contributions are all appreciated.
I would also be interested in hearing how other users approach energy-efficient shading, especially when balancing indoor comfort, natural daylight and temperature management.
Developed by Szélessáv Közhasznú Alapítvány / Szélessáv Műhely, Hungary.
Thank you!