Widget
Image
A plain picture tile. Attach a photo from your device and Flux fills the widget with it — a floor-plan, a family photo, a logo, a labeled diagram. Tap it on the dashboard to open the picture full-screen.
What it does
The image widget shows a single picture. You attach a photo from your device's library; Flux stores it with the widget and draws it to fill (or fit) the tile. Tapping the tile opens the image full-screen on a black backdrop, scaled to fit; tap anywhere or the close button to dismiss.
The image travels with your dashboard Attached photos are stored on the widget itself and sync with your layout, so the picture shows up everywhere your dashboard does — no external hosting needed.
Sources
Today there is one source you set up in the app:
- Attached photo — pick an image from your device's photo library. It's saved with the widget. This is the source the inspector exposes, and the one that opens full-screen on tap.
- URL — the widget can also render an image fetched from a web address (drawn to fill the tile, with a spinner while it loads). There's no in-app field to type a URL yet, so this path is only reached by data set outside the inspector.
- Camera snapshot — the model carries a camera-entity slot for a future snapshot source, but it isn't wired into rendering or the inspector. For a live camera feed, use the dedicated Camera widget instead.
Which one wins If a photo is attached, Flux always shows it. The URL is only used when no photo is attached. With neither, the tile shows a small photo placeholder.
Add it
- Enter edit mode, tap Add Widget, choose Image.
- Open the widget's inspector (tap the widget while editing).
- Tap Choose from device and pick a photo from your library.
- Set Fit to Fill or Fit, then leave edit mode.
Photos are downscaled When you attach a photo, Flux resizes it down before saving so dashboards stay light to sync and store. Use a clean, reasonably sized source image.
Settings
| Setting | What it does |
|---|
| Choose from device | Pick a photo from your library to attach. Once one is set, this becomes Change image. |
| Fit | Fill scales the picture to cover the whole tile (cropping the overflow). Fit scales it to show the entire picture inside the tile (letterboxed). Applies to the attached photo. |
| Remove image | Clears the attached photo. Shown only when one is attached. |
A note on Fill vs Fit The Fit setting controls the attached photo on the tile. A URL-sourced image always fills the tile, and the full-screen view always fits the whole picture regardless of this setting.
Tap to full-screen
On the dashboard, tapping an image widget that has a photo attached opens it full-screen — centered on black, scaled to fit, with a close button in the top corner. Tap anywhere on the image, or the close button, to dismiss.
Just a picture The image widget doesn't control anything or read an entity — it's a static photo tile. For live video use the Camera widget; for entity-driven artwork use the SVG widget.