Widget

Energy

A live power-flow diagram. Solar, grid, home, and battery each become a node, and animated dots stream between them in the real direction power is moving — pulling from the sun, importing or exporting on the grid, charging or draining the battery.

What it does

The energy widget reads up to five power sensors and draws them as a flow diagram. Solar, Grid, and Home nodes always appear; a Battery node appears when you turn it on. Faint lines connect each source to Home, and when power is actually flowing, glowing dots animate along the line — more power means more dots, moving faster. Each node shows its icon and (optionally) its current value.

The widget adapts to its size on the dashboard:

Mini (very small tile) — just the home power figure, big and legible, under a house icon.
Small — a compact stat grid (solar, home, grid, and battery if enabled) instead of the diagram.
Full — the animated flow diagram.

Direction is read from the sign Flux doesn't guess. Grid positive means importing (line flows grid → home); negative means exporting (home → grid). Battery positive means discharging (battery → home); negative means charging (home → battery). The grid node icon even flips to an export arrow while you're sending power back.

Add it

Enter edit mode, tap Add Widget, choose Energy.
Open the widget's inspector (tap the widget while editing) and assign your power sensors under Power Sensors.
At minimum pick a Solar production and Grid sensor. Add a battery (and battery level) if you have one. Leave Home use empty to have Flux compute it.

What kind of entity Each slot wants a power sensor in W or kW (the widget also understands MW). It reads the entity's unit of measurement and normalizes everything to watts internally, so you can mix a kW solar sensor with a W grid sensor.

Power sensors

Slot	What to assign
Solar production	Current solar output. Clamped to zero or above (no negative solar).
Grid (+import / −export)	Net grid power. Positive = importing from the grid, negative = exporting to it.
Battery (+discharge / −charge)	Battery power. Positive = discharging (feeding the home), negative = charging. Only shown when Show battery is on.
Battery level %	Optional state-of-charge sensor. When set, the battery node shows a percentage instead of its wattage. Only shown when Show battery is on.
Home use (optional)	Your home's consumption. Leave empty and Flux computes it as `solar + grid + battery`.

Settings

Option	What it does
Arrange node positions…	Opens a full-screen editor where you drag the Solar, Grid, Home, and Battery nodes anywhere you like. Dragging turns off auto-layout so your placement sticks.
Show battery	Adds the Battery node (and its flow line) and the Battery / Battery-level slots. On by default.
Show values	Shows each node's current power figure under its icon. Off shows icons only. On by default.

Auto-layout vs. drag Until you arrange nodes by hand, Flux auto-positions them for the tile's shape — sources spread well away from Home so the flow lines stay clear, with a different arrangement for wide versus tall tiles. The moment you drag a node, auto-layout switches off and your positions are kept. Node circles are also auto-shrunk so two can never overlap.

How the flow animates

Each connecting line carries dots only when its sensor reads more than ~1 W. The number of dots scales with the power (more watts, more dots) and the speed scales too, so a hard-charging battery or a heavy grid draw visibly moves faster than a trickle. A line with no flow stays a faint static thread.

Units & values

Values are formatted automatically: anything under 1 kW reads in whole watts (e.g. 740 W), and 1 kW or more reads in kilowatts to one decimal (e.g. 3.2 kW). The battery node shows a percentage when a battery-level sensor is assigned, otherwise its wattage.

Node colors are fixed Solar is orange, Grid is purple, Home is green, and Battery is teal — these are baked into the diagram so the flow is always readable at a glance.