Widget

Map

A live location map. Pick the people and phones you care about and Flux draws each one as a pin where they are right now. The camera auto-fits — it frames everyone with padding and re-zooms whenever someone moves, so nobody ever drifts off the visible map.

What it does

The map shows a pin for each selected tracker. Coordinates come straight from your Home Assistant person and device_tracker entities (their latitude / longitude attributes), so pins move live as those entities update. Each pin is either an avatar — a circle with a photo or a 2-letter label — or a small color-coded dot you tap to reveal who it is. Inside the tile the map doesn't pan or zoom by hand; the auto-fit owns the camera so everyone always stays in frame.

Pins move on their own You don't refresh anything. When a person or device_tracker entity reports a new location, its pin slides to the new spot and the map re-frames so the whole group stays visible.

Add it

Enter edit mode, tap Add Widget, choose Map.
Open the widget's inspector (tap the widget while editing) and tap Add person / phone.
Pick a person or device_tracker entity. Repeat for everyone you want on the map.
For each tracker, optionally set a 2-letter label, a color, and a photo for the pin.

No coordinates, no pin A tracker only appears once its entity reports latitude and longitude. If you've added people but the tile is empty, the selected entities haven't reported a location yet.

Full screen

Tap the widget to open the full-screen map. On iPhone and iPad this gives you full native pan and zoom — drag to move, pinch to zoom — and a close button in the top corner. Pins here show the tracked person's Home Assistant photo (entity_picture) when one exists, falling back to the colored circle and label.

On Apple TV The full-screen map fills the whole screen with no static controls. Press the remote's Play/Pause button to summon a pan/zoom panel — a directional pad to move the map, plus zoom in/out, recenter, and close buttons. Press Play/Pause again (or Menu) to dismiss it. The map itself isn't remote-interactive on tvOS; the panel is what drives it.

Settings

Setting	What it does
Pin style	Avatars — circles with a photo or initials, always visible. Small dots — compact color-coded dots; tap a dot on the widget to reveal that person's avatar and name, tap again to collapse it back to a dot. Default is avatars.
Person / phone	Each tracker is a Home Assistant `person` or `device_tracker` entity. Add as many as you like with Add person / phone.
Label	A short label drawn in the pin, kept to 2 letters. Leave it blank to use the initials of the entity's friendly name.
Color	The pin/dot color. Drives the small-dot color and the fallback circle behind the label when there's no photo. Defaults to the theme accent.
Photo	An avatar image shown in the pin instead of the letters. Stored at a reduced size to keep dashboards light.

Photos in full screen vs. tile In the tile, the pin photo is the image you attach in the inspector. In the full-screen map, Flux prefers the tracked person's Home Assistant photo (entity_picture) when one is available.