Recipes

Recipes

Small, focused how-tos for common tweaks. Each one is done in the running app — no code or JSON editing. Most start the same way:

Open a tile's settings: enter Edit mode (pencil icon), then click the gear on the tile you want. That opens the Tile settings modal used by most recipes below.

---

Add a camera feed to a tile

Show a live camera thumbnail on any tile (and the full feed in its flyout) — handy for turning a door lock or a room tile into a quick glance at the camera.

1. Edit mode → gear on the tile.
2. Find the Camera feed section and click Attach camera.
3. Pick the camera.* entity.
4. Save. The camera now shows as a live thumbnail in the tile's empty space and as the full feed in the tile's flyout when tapped.

The camera appears both on the tile and in the flyout automatically — there's no separate "background vs. flyout" toggle.

---

Reverse a slider

If a light or cover slider feels backwards (e.g. dragging up lowers it), flip it.

1. Edit mode → gear on the tile.
2. Toggle Reverse slider on.
3. Save. The drag direction is now inverted for that tile.

For covers you'll also see Slide to set position just above it — that enables the drag-to-position gesture in the first place.

---

Resize a tile

1. Edit mode → gear on the tile.
2. In the Size section, pick one of 1x1 / 2x1 / 1x2 / 2x2.
3. Save. Your manual choice is always kept, even on tiles that auto-size by default (vacuums and covers auto-pick a tall 1x2).

The grid uses gap-filling (grid-auto-flow: dense), so smaller 1x1 tiles backfill the space left around a taller tile instead of leaving a hole.

---

Add quick actions & links to a tile's flyout

Give a tile's flyout extra buttons and related entities.

• Quick actions — in Tile settings, the Quick actions (flyout buttons) section lets you add one-tap service buttons that appear in the flyout.
• Linked entities — the Linked entities (shown in flyout) section → Add link attaches related entities (e.g. add a room's fan and sensor to a light's flyout) so they show together when the tile is opened.

---

Fix missing media artwork

When a player reports no album art (common on some Android TV / ADB entities), pull the artwork from a companion player.

1. Edit mode → gear on the media tile.
2. In Artwork source, leave it on Auto to auto-detect, or pick a companion media_player that does expose artwork.
3. Save.

---

Configure an at-a-glance button

Each button in the header glance strip is fully editable in edit mode.

1. Edit mode, then click the gear on a glance button (or add a new one).
2. Shows — pick the metric (lights / switches / fans / locks / covers / climate / people / media).
3. Label — type a custom label (leave blank to use the metric's default).
4. Open a flyout when tapped — toggle whether tapping shows the entities behind the number.
5. Exclude entities → Exclude an entity — hide specific entities from this button's count and flyout (e.g. a tablet's "screen" light that shouldn't count as a room light).

---

Set up a UniFi switch on the NOC board

Turn a page into a NOC (servers) board first (Manage Pages → board-type → NOC (servers) — see NOC / Servers Dashboard), then:

1. Add the node. Click Add Device, name it (e.g. "Office Switch"), give it an icon and accent color.
2. Auto-map the ports (one click). In the Switch ports section, click Auto-detect ports ("Find PoE switches & per-port sensors for this device"). On a UniFi switch this reads the live integration entities and fills in every physical port — naming each active port after its connected client, setting its live speed/color, and binding the per-port PoE switch and power-cycle button automatically. SFP/SFP+ ports are detected and offset by a one-port gap.
3. Or add ports manually. Use +8 / +24 to bulk-add ports, then per port:
   • Speed dropdown — GbE (1G), FE (100M), 2.5 GbE, 5 GbE, 10 GbE, SFP, SFP+, Disconnected, Disabled (drives the cell color).
   • Live Mbps sensor (speedometer icon) — "Bind a live Mbps sensor" to color the port automatically from real link speed instead of the manual dropdown.
   • Connectivity entity (link icon) — "Pick a connectivity entity…" to flip the port to Disconnected when the link drops.
   • PoE dropdown — No PoE badge / PoE / PoE+ / PoE++ for the lightning badge.
   • Power-cycle (restart icon) — "Bind the port power-cycle button"; on UniFi gear this is button.<device>_power_cycle. The flyout then gets a per-port PoE on/off and Power-cycle action.
   • Role dropdown — Standard / Uplink / Aggregate / Mirror glyph.
4. Link an uplink to its gateway. On the uplink port, use the link-to-node dropdown ("Link this port to another device…") and pick your gateway node. The port's flyout gets an Open jump button, and the gateway's flyout automatically gets a jump back — no need to configure both ends.

UniFi entity names (from Home Assistant's UniFi integration): PoE switch is switch.<device>_port_<N>_poe; the dedicated power-cycle is button.<device>_power_cycle. Auto-detect ports finds these for you.

Everything you set here is saved in your layout backup.

---

See also: Features · Configuration · NOC / Servers Dashboard.