Adaptive cover pro
Adaptive sun-tracking cover control for Home Assistant: blinds, awnings, and venetian tilts with climate-aware positioning and a priority override pipeline.
Sun-tracking cover automation with an inspectable decision pipeline, full venetian sequencing, glare zones, and a seasonal climate arbiter — for Home Assistant. The project is written primarily in Python, distributed under the MIT License license, first published in 2026. Key topics include: adaptive-control, asyncio, awning, blinds, climate-control.
Adaptive Cover Pro
Sun-tracking cover automation with an inspectable decision pipeline, full venetian sequencing, glare zones, and a seasonal climate arbiter — for Home Assistant.
Full documentation lives on the Wiki.
What it does
- Four cover types with full geometric modeling — vertical blinds, horizontal awnings, tilt-only blinds, and venetian blinds; each uses real window and facade geometry, not rules of thumb.
- Inspectable decision pipeline — handlers run in priority order (weather safety, manual, custom positions with templated triggers, climate, glare, solar) and each reports its reason. A
decision_tracesensor shows exactly why the cover is at 45% — no black boxes. - Venetian blinds done properly — dual-axis sequencer waits for the carriage to settle before sending tilt, handles back-rotation across a 45-second post-settle window, and pre-positions tilt on opening to eliminate flicker. Covers KNX, Shelly, and Somfy IO buses.
- Climate mode with a full seasonal arbiter — winter heating, winter insulation, summer cooling, and glare comfort each have independent logic; presence, lux, irradiance, and cloud cover are all suppression inputs.
- Glare zones — name the floor areas you want protected (TV, dining table); the cover deploys further than pure sun tracking when a protected zone would receive direct sun.
- 15 runtime services — every parameter is scriptable from automations; no UI interaction needed to change mode, position limits, or overrides at runtime.
More detail: How It Decides · Climate Mode · Enhanced Geometric Accuracy
Companion Lovelace card
The Adaptive Cover Pro Card turns the integration's sensors into a dashboard you can read at a glance. It's HACS-installable and ships three cards in one bundle.
Sky compass — watch the sun cross each window in real time: its arc through the field of view, the shaded wedge of the cover closing to track it, sunrise and sunset, and the day's elevation curve underneath.
<img src="https://raw.githubusercontent.com/jrhubott/adaptive-cover-pro-card/main/images/sky-compass-timelapse.gif" alt="Sky compass tracking the sun across a full day" width="540">Tile card — one compact row per shade: icon, live position, ↑ ■ ▼ controls, and a badge that tells you which automation is driving the cover right now (Auto, Solar tracking, a Manual override with its expiry and a resume button, Motion, and more). Tap any tile for the full pipeline trace, today's forecast, the compass, and override controls.
Full card — everything in one place: the compass, the elevation chart, the pipeline decision strip with the winning handler highlighted, per-cover position bars, and override controls.
<img src="https://raw.githubusercontent.com/jrhubott/adaptive-cover-pro-card/main/images/card-preview.png" alt="Adaptive Cover Pro Card — all sections" width="340">Setup and options: Lovelace Card · Sky Compass Card.
Quick install
HACS (recommended): In HACS, search Adaptive Cover Pro, download, restart Home Assistant, then add the integration.
Manual: Copy custom_components/adaptive_cover_pro/ into config/custom_components/, restart Home Assistant, and add the integration.
Full steps: Installation · First-Time Setup
Documentation
| 🚀 Getting started | Installation · First-Time Setup · Cover Types · Migrating from Adaptive Cover |
| 🧠 How it works | How It Decides · Basic Mode · Climate Mode · Enhanced Geometric Accuracy |
| 🎨 Dashboard | Lovelace Card — install, configure, and use the companion card that visualizes the full pipeline |
| ⚙️ Configuration | Sun Tracking · Glare Zones · Weather Safety · Climate · Summary Screen |
| 🔌 Entities & services | Entities · Runtime Configuration Services · Position Verification · Somfy RTS (My Position) |
| 🛠️ Operations | Troubleshooting (incl. stopping false manual overrides) · Known Limitations |
Support
If Adaptive Cover Pro has been useful, you can support the project:
Contributors
Showing top 12 contributors by commit count.
![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)
Related Repositories
DanielMartensson/Adaptive-Control
Adaptive control methods developed by Karl Johan Åström and Björn Wittenmark from the 70-80's for industrial use
rssalessio/PyDeePC
Python library that implements DeePC: Data-Enabled Predictive Control
MTry/homebridge-smart-irrigation
Turn any electrical irrigation valve into a smart-valve.. or run your pumps on a smart schedule based on your climate! This homebridge plugin exposes a multi-zone irrigation sprinkler dummy control system to Apple's HomeKit. Although a dummy, it brings smarts of an evapotranspiration based climate and plant adaptive irrigation controller with the use of OpenWeatherMap API. The plugin can optionally email you, and/or send you push notifications through Pushover or Pushcut, with the watering schedule it has calculated, or when a watering run is completed, along with the next 7-day weather forecast. Added option to expose system controls to Homekit allowing a user to enable/disable irrigation, rechecks, push and email notifications from within the Home App. Associated WaterLevel Characteristic shows the % of watering cycle remaining.
muellerlab/xadapt_ctrl
Project Code for the paper "A Learning-based Quadcopter Controller with Extreme Adaptation"
robotsorcerer/awesome-neurocontrol
A curated list of neural applications in control theory and practice
LozioAlce/L1_AC
This is a project where an Adaptive Flight Control based on L1 adaptive control is designed and tested using MATLAB/Simulink [ L1 adaptive control code ]