Adaptive Cover for Home Assistant (Marketplace integration)

Installs: 518 sharing analytics
GitHub stars: 352
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v1.4.8, October 26, 2026
Category: Blinds and curtains
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: adaptive_cover
Source: github.com/basbruss/adaptive-cover
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

Screenshots From the README of basbruss/adaptive-cover.

About

Adaptive Cover is an integration that moves vertical, horizontal and tilted blinds based on the sun's position. It calculates a cover position that filters out direct sunlight when the sun is within a set field of view of the window. It offers three strategy modes: basic, climate, and security, where climate mode takes presence, indoor and outdoor temperature, weather, lux and irradiance into account. Security mode closes covers when nobody is home, and manual control of a cover is detected and left alone for a set duration. It adds covers, sensors, a binary sensor for sun in front of the window, switches, selects, buttons and scenes, plus an optional hub that controls all blinds together. It runs locally and is configured in the UI.

Automatic summary of the README and code of basbruss/adaptive-cover. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Covers
Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Cover entry

Name
Add blueprint to HomeAssistant
Type of blind

Automation

Minimum position adjustmentMinimum change in position required before adjusting the cover's position
Minimum interval between position changesMinimum time interval between position changes; minimum is 2 minutes
Starting timeStarting time for each day; before this time, the cover will remain stationary
Entity indicating starting timeEntity representing starting time state, overriding the fixed start time set above. Useful for automating the start time with an entity
Duration of manual overrideThe duration of manual control before resetting to automatic control
Reset Manual override durationOption to reset the manual override duration after each manual adjustment; if disabled, the duration only applies to the first manual adjustment
End timeEnding time for each day; after this time, the cover will remain stationary
Entity indicating ending timeEntity representing ending time state, overriding the fixed end time set above. Useful for automating the end time with an entity
Manual override threshold
Ignore intermediate positions during manual override (opening and closing)
Never auto-correct after manual overrideManual control on covers where this is enabled is only cleared by an explicit action, never by the automatic timer.
Window or door sensor (optional)Contact sensor for a window or door. While it reports open, the integration will not close this cover automatically. An unknown or unavailable sensor counts as open, so a flat battery degrades the protection instead of closing on an open door.
Always adjust position to sunset default at end time; Useful if end time is before actual sunset
Pre-close notice delaySeconds between the adaptive_cover_will_close event and the actual move when the integration closes a cover automatically. Manual commands, scenes and security mode are never delayed. 0 disables the feature.
Pre-close notice thresholdPosition at or below which a move counts as closing. The notice only fires when the cover moves from above this value to at or below it.

Vertical cover

Window AzimuthAdjust Azimuth
Window HeightSpecify window height in meters
Shaded areaDistance from cover to shaded area in meters
Shaded area height adjustmentHeight of the shaded area relative to the bottom of the closed blind in meters (positive = above). Lets the blind stay further open when the area to keep out of the sun, e.g. a desk, is higher up
Default PositionDefault cover position as a percentage
Default Position entityEntity providing the default position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable.
Minimum PositionMinimum adjustable cover position as a percentage
Minimum Position entityEntity providing the minimum position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable.
Maximum PositionMaximum adjustable cover position as a percentage
Maximum Position entityEntity providing the maximum position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable. If the minimum is not below the maximum, the fixed values are used.
Only force the minimum position when the sun is in front of the window
Only force the maximum position when the sun is in front of the window
Field of view leftField of view angle to the left of the window center
Field of view rightField of view angle to the right of the window center
Cover EntitiesSelect entities to control via integration

Climate settings

Inside temperature entity
Presence entity (optional)Entity representing room or home presence status
Weather entity (optional)Monitors weather conditions, and outside temperature
Outside temperature sensor (optional)Overrides outside temperature from weather entity if both are set
Low temperature thresholdMinimum comfortable temperature
High temperature thresholdMaximum comfortable temperature
Default position — winter (optional)Position used when the sun is not in front of the window and the winter (heating) branch is active. Leave empty to use the standard default position.
Default position — summer (optional)Position used when the sun is not in front of the window and the summer (cooling) branch is active. Leave empty to use the standard default position.
Transparent blindThe blind is transparent and should always close fully when summer mode is active
Lux sensor (optional)Use lux sensor to determine if cover should reduce glare in presence mode
Lux thresholdThreshold for lux sensor, above this value glare should be reduced
Irradiance sensor (optional)Use irradiance sensor to determine if cover should reduce glare in presence mode
Irradiance thresholdThreshold for irradiance sensor, above this value glare should be reduced
Minimum outside temperature for summer mode

Weather Conditions

Weather ConditionsChoose the weather conditions that enable automatic window control.

Horizontal cover

Window AzimuthSpecify the Azimuth
Awning Span LengthTotal span length in meters
Awning HeightAdjust the height of the awning from the level of the workarea
Awning AngleAngle of the attached awning measured perpendicular from the wall to the ground
Shaded areaDistance from cover to shaded area in meters
Default PositionDefault cover position as a percentage
Default Position entityEntity providing the default position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable.
Minimum PositionMinimum adjustable cover position as a percentage
Minimum Position entityEntity providing the minimum position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable.
Maximum PositionMaximum adjustable cover position as a percentage
Maximum Position entityEntity providing the maximum position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable. If the minimum is not below the maximum, the fixed values are used.
Only force the minimum position when the sun is in front of the window
Only force the maximum position when the sun is in front of the window
Field of view leftField of view degrees to the left of the window center
Field of view rightField of view degrees to the right of the window center

Tilted cover

Window AzimuthSpecify the Azimuth
Slat DepthDepth of each individual slat in centimeters
Slat SpacingVertical distance between two slats in centimeters
Default PositionDefault cover position as a percentage
Default Position entityEntity providing the default position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable.
Minimum PositionMinimum Position
Minimum Position entityEntity providing the minimum position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable.
Maximum PositionMaximum adjustable cover position as a percentage
Maximum Position entityEntity providing the maximum position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable. If the minimum is not below the maximum, the fixed values are used.
Only force the minimum position when the sun is in front of the window
Only force the maximum position when the sun is in front of the window
Field of view leftDegrees to consider from the left side of the window center
Field of view rightDegrees to consider from the right side of the window center
Cover EntitiesSelect entities to control via integration
Inverse the state (needed for some covers that don't follow HA guidelines)

Blindspot

Start blindspot leftLeft edge of the blindspot
End blindspot rightRight edge of the blindspot
Blindspot elevationAny value equal or less is considered within the blindspot. Usefull if the sun can shine over the object in the blindspot

After setup

Minimum position adjustmentMinimum change in position required before adjusting the cover's position
Minimum interval between position changesMinimum time interval between position changes; minimum is 2 minutes
Starting timeStarting time for each day; before this time, the cover will remain stationary
Entity indicating starting timeEntity representing starting time state, overriding the fixed start time set above. Useful for automating the start time with an entity
Duration of manual overrideThe duration of manual control before resetting to automatic control
Reset Manual override durationOption to reset the manual override duration after each manual adjustment; if disabled, the duration only applies to the first manual adjustment
End timeEnding time for each day; after this time, the cover will remain stationary
Entity indicating ending timeEnsure that the position is consistently adjusted to the default sunset setting by the end time. This is particularly beneficial when the end time precedes the actual sunset.
Manual override threshold
Ignore intermediate positions during manual override (opening and closing)
Never auto-correct after manual overrideManual control on covers where this is enabled is only cleared by an explicit action, never by the automatic timer.
Window or door sensor (optional)Contact sensor for a window or door. While it reports open, the integration will not close this cover automatically. An unknown or unavailable sensor counts as open, so a flat battery degrades the protection instead of closing on an open door.
Always adjust position to sunset default at end time; Useful if end time is before actual sunset
Pre-close notice delaySeconds between the adaptive_cover_will_close event and the actual move when the integration closes a cover automatically. Manual commands, scenes and security mode are never delayed. 0 disables the feature.
Pre-close notice thresholdPosition at or below which a move counts as closing. The notice only fires when the cover moves from above this value to at or below it.
Window AzimuthAdjust Azimuth
Window HeightSpecify window height in meters
Shaded areaDistance from cover to shaded area in meters
Shaded area height adjustmentHeight of the shaded area relative to the bottom of the closed blind in meters (positive = above). Lets the blind stay further open when the area to keep out of the sun, e.g. a desk, is higher up
Default PositionDefault cover position as a percentage
Default Position entityEntity providing the default position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable.
Minimum PositionMinimum adjustable cover position as a percentage
Minimum Position entityEntity providing the minimum position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable.
Maximum PositionMaximum adjustable cover position as a percentage
Maximum Position entityEntity providing the maximum position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable. If the minimum is not below the maximum, the fixed values are used.
Only force the minimum position when the sun is in front of the window
Only force the maximum position when the sun is in front of the window
Field of view leftField of view angle to the left of the window center
Field of view rightField of view angle to the right of the window center
Cover EntitiesSelect entities to control via integration
Inside temperature entity
Presence entity (optional)Entity representing room or home presence status
Weather entity (optional)Monitors weather conditions, and outside temperature
Outside temperature sensor (optional)Overrides outside temperature from weather entity if both are set
Low temperature thresholdMinimum comfortable temperature
High temperature thresholdMaximum comfortable temperature
Default position — winter (optional)Position used when the sun is not in front of the window and the winter (heating) branch is active. Leave empty to use the standard default position.
Default position — summer (optional)Position used when the sun is not in front of the window and the summer (cooling) branch is active. Leave empty to use the standard default position.
Transparent blindThe blind is transparent and should always close fully when summer mode is active
Lux sensor (optional)Use lux sensor to determine if cover should reduce glare in presence mode
Lux thresholdThreshold for lux sensor, above this value glare should be reduced
Irradiance sensor (optional)Use irradiance sensor to determine if cover should reduce glare in presence mode
Irradiance thresholdThreshold for irradiance sensor, above this value glare should be reduced
Minimum outside temperature for summer mode
Weather ConditionsChoose the weather conditions that enable automatic window control.
Window AzimuthSpecify the Azimuth
Awning Span LengthTotal span length in meters
Awning HeightAdjust the height of the awning from the level of the workarea
Awning AngleAngle of the attached awning measured perpendicular from the wall to the ground
Shaded areaDistance from cover to shaded area in meters
Default PositionDefault cover position as a percentage
Default Position entityEntity providing the default position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable.
Minimum PositionMinimum adjustable cover position as a percentage
Minimum Position entityEntity providing the minimum position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable.
Maximum PositionMaximum adjustable cover position as a percentage
Maximum Position entityEntity providing the maximum position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable. If the minimum is not below the maximum, the fixed values are used.
Only force the minimum position when the sun is in front of the window
Only force the maximum position when the sun is in front of the window
Field of view leftField of view degrees to the left of the window center
Field of view rightField of view degrees to the right of the window center
Window AzimuthSpecify the Azimuth
Slat DepthDepth of each individual slat in centimeters
Slat SpacingVertical distance between two slats in centimeters
Default PositionDefault cover position as a percentage
Default Position entityEntity providing the default position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable.
Minimum PositionMinimum Position
Minimum Position entityEntity providing the minimum position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable.
Maximum PositionMaximum adjustable cover position as a percentage
Maximum Position entityEntity providing the maximum position as a percentage, overriding the fixed value above. Falls back to the fixed value when the entity is unavailable. If the minimum is not below the maximum, the fixed values are used.
Only force the minimum position when the sun is in front of the window
Only force the maximum position when the sun is in front of the window
Field of view leftDegrees to consider from the left side of the window center
Field of view rightDegrees to consider from the right side of the window center
Cover EntitiesSelect entities to control via integration
Inverse the state (needed for some covers that don't follow HA guidelines)
Start blindspot leftLeft edge of the blindspot
End blindspot rightRight edge of the blindspot
Blindspot elevationAny value equal or less is considered within the blindspot. Usefull if the sun can shine over the object in the blindspot
Value where opening starts
Value where closing starts
List of interpolationList of interpolation values, where 0 is fully closed and 100 is fully open
Custom interpolation listCustom range of interpolation values, where the beginning should represent closed and the end open

Texts from the code of basbruss/adaptive-cover.

Entities

SelectsControl mode
SwitchesSecurity mode

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.

From the README

This Custom-Integration provides sensors for vertical and horizontal blinds based on the sun's position by calculating the position to filter out direct sunlight.
This integration builds upon the template sensor from this forum post Automatic Blinds
Individual service devices for vertical, horizontal and tilted covers
Three strategy modes: basic, climate, security
Binary Sensor to track when the sun is in front of the window
Sensors for start and end time
Auto manual override detection
Climate Mode
Weather condition based operation
Presence based operation
Switch to toggle climate mode
Sensor for displaying the operation modus (winter, intermediate, summer)
Diagnostic sensor exposing all intermediate climate decision values
Security Mode (v1.9+)