dorkhub

adaptive-cover-pro

Adaptive sun-tracking cover control for Home Assistant: blinds, awnings, and venetian tilts with climate-aware position…

jrhubott
Python14821 forksMITupdated 23 hours ago
git clone https://github.com/jrhubott/adaptive-cover-pro.gitjrhubott/adaptive-cover-pro

Version Tests Hassfest HACS Coverage

Adaptive Cover Pro

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_trace sensor 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.

Sky compass tracking the sun across a full day

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.

Tile card across four automation states

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.

Adaptive Cover Pro Card — all sections

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:

Buy Me A Coffee

more like this

BotLi

A highly configurable interface between Lichess API and UCI chess engines

Python69

oasis-firmware

Composable hardware programming, simulation, & flashing. Designed to run on both SBC (Raspberry Pi) and MCU (Arduino) p…

C69

Bk-Light-AppBypass

Async Python toolkit for driving the BK-Light ACT1026 32×32 AND ACT1025 16x64 RGB LED ("Action" Product) matrix over Bl…

Python85

search

search projects, people, and tags