Skip to content

Recipes

jv edited this page Jun 6, 2026 · 4 revisions

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. There are two places to do this depending on the kind of page:

On a regular Tiles page (the media player is a normal tile):

  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.

On a Now Playing (media) page (the auto board has no per-tile gear):

  1. Edit mode on the page.
  2. Click the image icon ("Artwork and media settings") on the device's row — it appears on both shown and hidden devices.
  3. In the settings popup:
    • Show artwork — toggle the album-art background on/off for that device.
    • Artwork source — leave blank to auto-detect, or pick a companion media_player that exposes artwork.
  4. Save. The choice is stored per device on the page (view.mediaOverrides) and applies to every media_player entity merged into that device.

See Switch a page to Now Playing (media) for the full Now Playing board walkthrough.


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).

Search and cast with Music Assistant

Search the Music Assistant library and play a result on any player, right from the dashboard.

Requires the Music Assistant integration set up in Home Assistant. Glance auto-discovers it — there's nothing to configure in the dashboard.

  1. Add the launcher. In Edit mode, add the Music Search tile from the tile picker (it appears alongside your entities). On a Media page you can instead toggle the Music Assistant button on in the page's edit controls.
  2. Open it. Tap the tile — a search flyout opens on the right.
  3. Search. Type an artist, album, track or playlist. Optionally narrow by type (All / Artists / Albums / Tracks / Playlists / Radio), set a result limit, and toggle Library only (your own library vs. streaming providers) or Favourites only.
  4. Pick a player. Choose a target from the player dropdown — it lists only Music Assistant players (and only ones currently active; sync/speaker groups stay). Your last choice is remembered.
  5. Play. Tap any result to cast it to the selected player.

Don't see your speaker in the dropdown? It must be a Music Assistant player and currently available — players disabled in MA, or that are unavailable, are filtered out.

Credit. Inspired by fastxl2024/mass-search-card.


Switch a page to Now Playing (media)

Turn a page into an auto "Now Playing" board that lists your media devices and shows transport controls only when something is actually playing — no manual tile placement.

  1. Switch the board type. Enter Edit mode (pencil) → Manage Pages. On the page you want, set the board-type dropdown to Now Playing. (Switch back to Tiles any time to restore a normal control page.)
  2. Show / hide devices. In the page's Edit mode, a type-ahead filter lists every detected media device. Toggle each one shown or hidden — hidden devices stay listed in edit mode (with their settings button) so you can bring them back.
  3. Merge duplicate devices. When one physical device exposes several media_player entities (e.g. an Android TV with ADB + Cast + remote) and the name heuristics can't tell they're the same, select them and Merge into one. A badge + split button let you undo. (Persists as view.mediaMerge.)
  4. Pick a tile size. Use the Small / Medium / Large selector — columns are a fixed width so a single playing tile doesn't stretch across the whole page.
  5. Combine grouped speakers. Leave Combine grouped speakers on (default) so a synchronized speaker group shows a single group card instead of the group plus each member. It recognises standard group_members groups (Cast / Sonos / Squeezebox), Music Assistant sync groups, and the silent passive speaker outputs an MA group drives — while never hiding a lone playing speaker. Turn it off to show every grouped speaker separately.
  6. Toggle the Music Assistant button. Turn the Music Assistant button on/off in the page's edit controls (see Search and cast with Music Assistant).
  7. Per-device artwork & media settings. Click the image icon on a device row to set Show artwork and an Artwork source for that device — see Fix missing media artwork.

Everything you set here is saved in your layout backup. For a full tour of every board type and per-page setting, see Pages & Board Types.


Switch a page to Sensor graphs

Turn a page into a sensor graphs board — a clean page of trend/sparkline cards for your sensor.* entities instead of control tiles.

  1. Enter Edit modeManage Pages.
  2. Set the page's board-type dropdown to Sensor graphs.
  3. Optionally hide the greeting / weather / people header widgets with the three per-page header toggles next to the dropdown.

A Sensor graphs page is the same underlying kind a NOC (servers) board builds on (kind: 'sensors'). Switching a page to NOC (servers) simply adds a noc config on top — see NOC / Servers Dashboard.


Switch a page to a Cameras page

Turn a page into a camera wall that shows your camera.* feeds in a grid (CameraGrid) instead of control tiles.

  1. Enter Edit modeManage Pages.
  2. Set the page's board-type dropdown to Cameras.
  3. Optionally hide the greeting / weather / people header widgets with the per-page header toggles — handy for a clean, wall-mounted camera screen.

Want a camera on a regular tile instead of a whole page? See Add a camera feed to a tile.


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.

Clone this wiki locally