Widget

Cover

A tile for anything that opens and closes — blinds, roller shades, curtains, garage doors, sliding gates, awnings, and boat lifts. The icon draws the live position and glides through the motion over your configured travel times, so the graphic matches the real hardware instead of snapping.

What it does

The cover widget drives a single Home Assistant cover.* entity. It shows a picture of the cover that reflects exactly how far open it is — slats filling a window, a garage door descending, a gate rolling across the driveway — alongside up, stop, and down controls. When the device is moving, the icon animates through the travel; if the device reports its real position, that takes over automatically.

The icon is the position The drawing isn't decorative — it renders the actual open percentage. A cover that reports current_position shows that exact amount; one that only reports open/closed shows fully open, fully closed, or mid-way while it travels.

Add it

Enter edit mode, tap Add Widget, choose Cover.
Pick the cover.* entity it controls.
Open the widget's inspector (tap the widget while editing) and choose the icon style, colors, and travel times.

Controls

Every cover tile has three commands, mapped to the standard Home Assistant cover services:

Control	What it does
Up (chevron ▲)	Calls `open_cover` — opens the cover (raises a boat lift). Highlights while the device reports `opening`.
Stop (■)	Calls `stop_cover` — parks the cover wherever it is, mid-travel. Never affected by Invert.
Down (chevron ▼)	Calls `close_cover` — closes the cover (lowers a boat lift). Highlights while the device reports `closing`.

Each tap fires a light haptic. With Invert direction on, the up and down buttons are swapped (so a backwards-wired motor reads correctly), but Stop is never flipped.

Position read-out When the entity reports current_position and isn't actively moving, the tile shows "NN% open". Otherwise it shows the state as a word — Open, Closed, Opening…, Closing… — with Invert flipping the meaning of those words too.

How it adapts to the tile

The layout changes with the tile size:

Large (hero) — a big centered graphic with the name, position line, and a full row of up / stop / down buttons.
Standard — graphic on the left, name and state in the middle, a vertical up / stop / down stack on the right.
Compact — graphic plus a single smart button that opens the cover when it's more than half closed, or closes it when it's more than half open.

Turning the label off (the widget's label position) hides the name and the text position line — the icon already shows the position graphically.

Settings

Setting	What it does
Icon	The graphic style: Blinds (slats), Roller shade, Curtains, Garage door, Sliding gate, Awning, or Boat lift. Each draws and animates its own way.
Open color	Color of the moving part when fully open. Off → theme accent.
Closed color	Color of the moving part when fully closed. Off → falls back to the open color. The moving part blends from closed → open color as it travels.
Structure color	Color of the fixed parts — window frame, garage roof, gate posts, lift posts. Off → secondary theme color.
Invert direction	For hardware wired backwards: flips both the up/down buttons and the displayed position. Stop is unaffected.
Time to open / raise	How long the icon takes to animate fully open (or, for a boat lift, to raise). 2–300 s, default 15 s.
Time to close / lower	How long the icon takes to animate fully closed (or to lower a boat lift). 2–300 s, default 15 s.

Travel times are about the animation Most covers don't stream their position, so Flux glides the icon through the motion over these times to match the real hardware. They don't change how long your cover actually moves — set them to roughly match. If the device does report live positions, those override the animation and the icon re-anchors to the truth.

Notes

The widget controls one cover.* entity. A cover that reports current_position gets a precise graphic and percentage; one that only reports open/closed states still animates open→closed over the travel times. The boat-lift style reuses the same open/close services and travel times as "raise" and "lower". On Apple TV the tile is focusable and the inner buttons are remote-friendly.