Home Assistant custom integration that controls vertical blinds, horizontal awnings, and venetian (tilt) blinds based on sun position — filtering direct sunlight while maximizing natural light, with climate-aware operation.
📖 Full documentation lives on the Wiki.
- Three cover types — vertical blinds, horizontal awnings, venetian (tilt)
- Basic & Climate modes — geometric sun tracking, plus a temperature-aware strategy for winter / summer / intermediate
- 10-handler override pipeline — force override → weather → manual → custom position → motion → cloud suppression → climate → glare zones → solar → default
- Safety overrides — force override (rain/wind/fire), weather safety (wind/rain), manual override that pauses on physical/app/voice moves
- Always-on diagnostics — decision trace, sun position, position verification; debug mode without touching YAML
- 15 runtime services (v2.18.0+) — change any setting from automations and scripts without opening the Options UI
Dive deeper: How It Decides · Climate Mode · Enhanced Geometric Accuracy
HACS (recommended): Add https://github.com/jrhubott/adaptive-cover-pro as a custom repository → search Adaptive Cover Pro → download → restart Home Assistant → add the integration.
Manual: Copy custom_components/adaptive_cover_pro/ into config/custom_components/, restart Home Assistant, add the integration.
Full steps: Installation · First-Time Setup
| 🚀 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 |
| ⚙️ Configuration | Common · Glare Zones · Weather Safety · Climate · Summary Screen |
| 🔌 Entities & services | Entities · Runtime Configuration Services · Position Verification · Somfy RTS (My Position) |
| 🛠️ Operations | Troubleshooting · Known Limitations |
| 🧪 Testing | Testing the Algorithms · Simulation Notebook |
If Adaptive Cover Pro has saved you time or made your home a little smarter, you can fuel the next commit:
Inspired by and originally forked from Adaptive Cover by Bas Brussee (@basbruss), whose ideation and base implementation sparked this project. Adaptive Cover Pro has since grown into a substantially different codebase with a new architecture and feature set, but the original vision deserves real credit.
Original forum post that inspired both projects: Automatic Blinds.
See the For Developers wiki hub for setup, architecture, workflow, testing strategies, code standards, and the automated release process.