Whats New

What's New

A curated, newest-first list of recent user-facing features across Adaptive Cover Pro (the integration) and its companion Lovelace card. Each entry links to the documentation for that feature.

For the complete change history including bug fixes, see the full release notes: Integration releases · Card releases.

---

Integration

v2.28.0 — 2026-06-21

• Force Override merged into Custom Positions — Force Override is no longer a separate config step. Any custom position slot set to priority 100 inherits the same safety semantics: commands fire outside the schedule window and bypass all send gates. Existing Force Override config migrates automatically into slot 5, and each slot now accepts a list of binary sensors (any one active triggers it) plus an optional Jinja2 condition template with OR/AND combine mode. → Custom Position
• Templates in threshold fields — nine numeric threshold fields (comfort temperatures, outdoor threshold, lux, irradiance, cloud coverage, wind speed, rain rate, wind direction tolerance) accept a Jinja2 template instead of a fixed number, rendered once per cycle with a safe fallback when a template fails. An optional occupancy template on Motion Override counts as presence when it renders truthy. The Configuration Summary shows [template] instead of the raw expression. → Templated Thresholds
• Generate FOV from measurements — the two-mode "Define field of view by" selector is replaced with a single "Generate field of view from measurements" button. Tick it and submit to fill the left/right FOV angles from your window width and reveal depth; the toggle then clears so you can fine-tune either angle directly. The sliders stay visible and editable. A formula fix corrects fov_from_reveal to use atan(width / depth) rather than atan(half_width / depth) — re-verify any Measurements-mode FOV after upgrading. → Sun Tracking
• Position matching is now opt-in — a new "Enable position matching" toggle (default off) controls whether a cover that settles off-target is re-commanded. With it off, the cover is commanded once; a noticeable delta engages manual override instead of retrying. The tolerance slider moves to the Position Settings step. Existing covers keep matching enabled through the upgrade. → Position Matching
• Climate status sensor exposes setpoints and a typed reason — sensor.climate_status now always reports temp_low, temp_high, temp_summer_outside, and an inactive_reason slug (active, mode_off, outside_time_window, thresholds_not_met, other_mode_active, readings_unavailable), even when the climate handler is inactive. → Diagnostic Sensors
• Solar-tracking forecast in diagnostics dump — the downloaded diagnostics now include a position_forecast section: a solar-tracking-only projection for the rest of today that holds window geometry constant and walks the sun forward, for validating sun/FOV geometry and timing. It carries a description field so it is never mistaken for the live decision (read decision_trace for that). → Diagnostic Sensors
• Held position in the manual override trace — the manual override sensor's decision_trace now includes the position the cover is being held at, so you can read what it's locked to without opening diagnostics. → Diagnostic Sensors
• Oscillating awning vertical-drop model — oscillating (drop-arm) awnings compute shading with a vertical-drop model, and the arm-length range now reaches 6.0 m to match larger installations. → Oscillating Awning
• Configuration Summary in your language — the narrative summary in the config and options flow renders in English, German, or French to match your Home Assistant UI language. → Summary Screen

v2.27.0 — 2026-06-08

• Minimize movements — opt-in sun tracking that snaps to a few fixed coverage levels instead of following the sun continuously, cutting motor movements while never letting in more direct sun. → Sun Tracking
• Sun-state classification — the decision_trace sensor (and downloaded diagnostics) now expose a one-word sun_state — hitting, in_fov_not_valid, or outside_fov — so dashboards and automations can read at a glance why solar tracking is or isn't engaging. → Diagnostic Sensors
• Forecast matches runtime — the position forecast now runs through the same position primitives as the live pipeline, so its samples honour min/max limits, the 1% floor, rounding, and minimize-movements quantization exactly as the cover will. → Diagnostic Sensors

v2.26.0 — 2026-06-07

• Oscillating (drop-arm) awning cover type — a new cover type with arm-sweep geometry, appearing automatically in the cover-type picker. → Oscillating Awning
• Schedule window exposed — schedule_start and schedule_end are now published as attributes on the control-status sensor, so the active automation window is visible to dashboards and automations. → Diagnostic Sensors

v2.25.1 — 2026-06-03

• Venetian tilt-only custom positions — a custom-position slot can adjust just the slat tilt and leave the carriage position under pipeline control. → Custom Position

v2.25.0 — 2026-06-02

• Configurable position-match tolerance — set how close a cover's reported position must be to its target before it counts as "matched", silencing redundant commands from covers that report slightly off. → Position
• Full-day position forecast — the forecast sensor now spans the whole calendar day (00:00 → 24:00) on a midnight-aligned axis, so the companion card's forecast strip lines up cleanly. → Diagnostic Sensors

v2.23.0 — 2026-05-26

• Position forecast sensor — a new diagnostic sensor projecting today's solar-tracked position forward, consumed by the companion card. → Diagnostic Sensors
• adaptive_cover_pro.stop service — stop a cover through the ACP stack so the stop is ACP-stamped instead of read as a manual override. → Runtime Configuration Services
• manual_ignore_external option — limit manual-override detection to ACP-issued commands so RF remotes and external automations don't pause control. → Automation
• Custom-position slot enable/disable — silence a configured custom-position slot with a per-slot toggle without losing its settings. → Custom Position
• My-preset entities gated by a toggle — the Somfy "My" button and number entities are now opt-in via a config toggle (existing entries are migrated automatically). → My Position Support (Somfy RTS)
• Home Assistant unit system in the UI — geometry config displays in your configured unit system and sensors carry unit attributes. → v2.23.0 release notes

v2.22.0 — 2026-05-22

• My Position (Somfy "My") button + number entities — a pipeline-aware button to send the motor's programmed "My" preset, plus a runtime-configurable number for its value. → My Position Support (Somfy RTS)
• Custom sunrise/sunset time entities — supply seasonally-adjusted sunrise/sunset boundaries from your own entities (e.g. Sun2). → Sun Tracking

v2.21.0 — 2026-05-17

• Configurable venetian post-settle hold — the delay between carriage settle and tilt dispatch is now a setting (0–10 s) instead of a hard-coded constant, for actuators with slow tilt re-assert. → Tilt
• adaptive_cover_pro.set_position service — move a cover to a position while respecting custom-position minimum-mode floors (use this instead of cover.set_cover_position). → Runtime Configuration Services

---

Companion Card

The companion Lovelace card ships separately with its own release cycle.

v2.8.0 — 2026-06-16

• Throttle countdown in decision strip — when the integration rate-limits consecutive adjustments, the decision-strip section shows a live countdown banner ("Next adjustment allowed in …") that ticks every second. → Panel Card
• Clarified target labels and marker fixes — during a manual-override divergence, the covers bar labels the solar would-be position distinctly instead of sharing a plain "Target" label; the target marker is clamped so it no longer overflows the rail at 0%/100%; the sky-compass legend gains a second "held" row when the actual cover position differs from the target. → Panel Card · Sky Compass Card

v2.7.0 — 2026-06-15

• Interactive sky-compass legend — the legend now draws live SVG glyphs instead of static color swatches: the sun glyph glows gold only while the sun is inside the field of view, the moon glyph renders its real current phase, and the window entry shows a slim arrow matching the plotted window line. "Window normal" is renamed "Window azimuth", and Sun + Moon sit at the top of the multi-entry legend. → Sky Compass Card
• Solar target in the covers bar — during a manual override the covers bar labels "Target" with the position the integration would have sent (matching the sky compass), while each cover's fill and number stay at the held position. The mismatch badge is suppressed when the divergence is an intentional override, and its column is reserved so toggling it no longer reflows the bar. → Dashboard Cards
• Pipeline view held position — the decision-strip shows a handler's held position as its primary position when the integration supplies one, with the solar would-be inline as secondary context. Lights up with a companion integration build that exposes the field; degrades gracefully on older builds. → Dashboard Cards

v2.6.2 — 2026-06-15

• Forecast strip "now" cursor tooltip — the vertical line marking the current time on the forecast strip now shows the current local time in a floating tooltip on hover, matching the elevation chart. A wider invisible hit area makes the thin cursor easy to hover. → Dashboard Cards

v2.6.1 — 2026-06-13

• Custom floating tooltips across all cards — hover tooltips no longer use the browser's native SVG title pop-ups, which clip at viewport edges and ignore your theme. The card now draws its own cursor-following bubble that flips when it would overflow the screen and matches the HA theme. Tune it per card with a tooltips block, or set tooltips: { enabled: false } to go back to native tooltips. → Dashboard Cards

v2.6.0 — 2026-06-13

• Climate thresholds and inactive reason in the panel — the climate panel now shows the configured indoor/outdoor temperature thresholds and, when climate control is idle, spells out why it isn't acting. → Panel Card
• Force-override custom-position (slot 5) display — the card reflects the integration's v2.28.0 force-override-into-custom-position behaviour, with badge visibility to match; requires integration v2.28.0 or newer and degrades gracefully on older builds. → Tile Card
• Tile controls reflow on mobile — override tile controls collapse onto a full-width row at phone widths instead of overflowing. → Tile Card
• Shared registry fetch and re-render throttling — all three cards now share a single entity-registry fetch and throttle re-renders, so the dashboard stays responsive without re-querying Home Assistant on every state update. → Dashboard Cards

v2.5.0 — 2026-06-08

• Three-state sun dot — the compass and elevation-chart sun dot reads warm by day and grey at night: gold (with a glow when actively hitting, flat when in-FOV-not-valid), light yellow when above the horizon but outside every FOV, and dim grey below the horizon — reading the integration's decision_trace.sun_state with a graceful fallback on older builds. → Sky Compass Card
• Sections layout sizing — all three cards advertise grid options so the Home Assistant Sections view sizes and resizes them correctly. → Dashboard Cards
• Narrow-column tile reflow — the tile card measures its own width and drops the controls onto their own row in narrow Sections columns instead of truncating. → Tile Card
• Cover-bar / compass color match — cover-bar fill colors now align with the sky-compass palette, and the compass override wedge matches the window color. → Dashboard Cards

v2.4.0 — 2026-06-07

• Actual-vs-target cover wedge — the sky compass draws a second wedge showing the gap between where a cover is commanded and where it physically sits. → Sky Compass Card
• Multi-window FOV ribbon — each window contributes its own stacked field-of-view row inside the elevation chart grid. → Sky Compass Card
• Schedule window across all cards — the automation schedule window is shaded on the elevation chart and shown as an off-schedule badge on the decision strip and tile card. → Dashboard Cards

v2.3.0 — 2026-06-02

• Live card-picker previews — all three cards now render a live preview in the Lovelace card picker using a real config entry from your install. → Dashboard Cards

v2.2.0 — 2026-05-31

• Sun Today elevation chart — a 24-hour sun-elevation curve clipped to the window's FOV and elevation limits, on both the sky compass and the tile more-info dialog. → Sky Compass Card

v2.1.0 — 2026-05-31

• Tile badge overhaul — the contextual badge moves inline onto the state row, the Resume action folds into a tappable badge, a "Cloudy" cloud-suppression badge is added, and every badge kind becomes individually toggleable (grouped in the editor). → Tile Card

v2.0.0 — 2026-05-26

• Tile card — a new compact single-row card: icon, name, position, ↑■↓ controls, a contextual badge, and an inline Resume button. → Tile Card
• ACP more-info dialog — a card-rendered dialog with the plain-English decision sentence, target position, per-cover bars, forecast strip, control toggles, and a collapsible advanced section. → Panel Card
• Forecast strip — a hand-drawn SVG strip plotting today's projected position with hover snapping and sunrise/sunset/FOV event markers. → Panel Card
• Full localization (EN/FR) — every card surface routes through a translation layer, with the locale read from Home Assistant. → v2.0.0 release notes

v1.7.0 — 2026-04-30

• FOV wedge respects elevation limits — when min_elevation/max_elevation are set, the sky-compass wedge becomes an annular sector instead of a full pie slice. → Sky Compass Card

v1.6.0 — 2026-04-29

• Sky Compass legend toggle — click a legend row to hide or show that cover's overlays (session-only). → Sky Compass Card

v1.5.0 — 2026-04-24

• Configurable north offset — rotate the entire compass (sun, wedges, labels) with a north_offset setting while readouts stay in true degrees. → Sky Compass Card
• Per-cover color overrides — give each cover an explicit color on the standalone sky compass, merged over the auto-assigned palette. → Sky Compass Card

v1.4.0 — 2026-04-23

• Sky Compass card — a new standalone card overlaying multiple windows' FOV, blind spot, and cover position on a shared sun compass. → Sky Compass Card