Every widget there is

The complete list of widgets Mirra ships with, grouped the way the scene editor groups them, with what each one shows and what it needs before it will show anything.

Most widgets are on every plan. Webhook needs Pro. Every Home Assistant widget and the Spotify widget need Home or above. The menu board carries no plan gate of its own — but it needs a menu, and Menus are part of the business plans.

Save as PDF This did not answer it

What a widget is

A widget is one thing on a screen — the clock, the agenda, a light switch, a photograph. A scene is an arrangement of them on a twelve-column grid, eight rows tall in landscape and eighteen in portrait, and a screen shows one scene at a time.

Widgets are curated and ship with Mirra. There is no widget store and no way to install somebody else's code, which is a deliberate limit rather than a gap: a third-party widget would be untrusted JavaScript running on a panel that can see your calendar, your cameras and your home. The trade is that the list below is the list, and it grows when we add to it.

There are forty-one widget types. Sixteen of them stand behind no integration at all.

Widgets may overlap. That is what makes a photograph behind a clock possible, and it is why the grid does not push things out of the way when you drag one on top of another.

Adding one to a scene

Every widget is placed the same way, from the screen it is going on.

The scene editor. The palette is the lower panel; the settings panel appears when a widget is selected.

Open Screens and choose the screen
The scene editor is per-screen. The canvas is drawn in the shape the scene was made in, so a portrait scene stays portrait even when you are looking at it from a landscape screen.
Pick the scene you are editing
A screen can hold several scenes and swap between them on a schedule. Widgets belong to a scene, not to the screen.
Find the widget under Add widget
The palette is grouped by category. Core widgets appear by name — "+ Clock", "+ Photo frame". An integration's widgets are collapsed behind one tile, so Home Assistant's fourteen arrive as a single "+ Home Assistant…" that opens a picker.
Click it to select it, and set it up
The panel underneath is headed with the widget's name — "Photo frame settings", "Dial settings" — and holds three things: Appearance, When to show, and the widget's own fields.
Press Save & push
Nothing reaches the wall until you do. The button is disabled when there is nothing to save, and the header says "Unsaved changes" until then.

An integration that is turned off has no tile in the palette at all. If you have connected Home Assistant and cannot find its widgets, the palette says so at the bottom and links to Integrations.

What decides whether you can place it

Four separate things gate a widget, and they are separate on purpose — a widget you have turned off is not the same as one your plan does not include, and neither is the same as one that has nothing to show yet.

The Integrations page and the scene editor's palette both work from the same answer, so they cannot disagree with each other about whether your photo frame is ready.

The three questions asked of every widget, in the order you can act on them.

Your plan. Webhook needs Pro. Every Home Assistant widget and the Spotify widget need Home. Everything else is on every plan.
The integration being on. Turn Home Assistant off and its fourteen widgets leave the palette. Core widgets are never gated this way — a household one setting away from having no clock is not a household anybody should be able to create by tidying a page.
Something to show. The photo frame needs an album, the agenda a connected calendar, the art frame a collection, the light widgets a light. The catalogue says which is missing rather than leaving you to work it out from a blank rectangle on a wall.
Your kind of account. The menu board widget itself carries no plan gate, but the menus it draws on are part of the business plans, because a household has no use for one.

Time

Three widgets, none of which needs anything connected. The size after each name is the size it arrives at, in grid cells — you can resize any of them afterwards.

The clock and the date are bare by default, with no card behind them, because they are usually the first thing laid over a photograph.

Clock: Large time display. One setting: 24-hour or 12-hour.Default: 5 × 3 cells
Date: Weekday and date. Nothing to configure.Default: 5 × 1 cells
Countdown: Days until a date you type in, with a title above it. Counts down to midnight on the day and then stops at zero.Default: 3 × 2 cells

Calendar

Four widgets, all reading the same merged set of events. They need the Calendar integration on and at least one calendar connected — an iCal link, CalDAV, Google or Outlook.

Each of them carries the same Calendar field, which chooses between all your calendars, one named calendar, or this screen's own room. That last option is what lets one scene serve forty identical door panels outside forty different meeting rooms.

Agenda: Upcoming events as a list, grouped under Today, Tomorrow and weekday headings.Default: 4 × 5 cells
Coming up next: The next single thing happening, in full, with its notes underneath. Looks fourteen days ahead by default.Default: 5 × 3 cells
Week calendar: A column per day — three, five, seven or fourteen of them — the way a wall planner reads.Default: 12 × 4 cells
Month calendar: The whole month at once, with week numbers, a calendar legend, and optionally a forecast in each of the next fourteen days.Default: 12 × 7 cells

Photos, art and music

The portal calls this group "Photos & art". Two of the three are core; the third needs Spotify.

Art and the photo frame look similar and are pointed at different things. The photo frame shows an album you uploaded. The art frame shows a collection — one you assembled, or one we curate, which is why it is ready to use before you have uploaded anything.

Art: A collection of artwork, shown full screen, matted rather than cropped by default. Can drift slowly to protect the panel, tint your lights to match the picture, and show a different collection to each person it recognises. Needs a collection.Default: 12 × 8 cells
Photo frame: A slideshow from one of your albums. Needs an album.Default: 7 × 4 cells
Spotify: What is playing, with the album cover large enough to be a scene of its own. Needs Spotify connected and the Home plan. Showing playback works on a free Spotify account; controlling it needs Premium.Default: 6 × 6 cells

The building

One widget, and nothing has to be connected for it — the plans are your own drawings and the screens on them are your own fleet. In the palette it sits under Smart home.

The setting that matters is Plan, whose default is "the plan this screen is on". A screen works that out for itself, so one scene holding one Floor plan tile can go to every panel in a building and each will draw its own storey with itself ringed. A screen that has not been placed on any plan says so on the tile rather than drawing a floor it is not on.

Floor plan: The building drawn flat or standing up, with every screen on it — green when it reported in within the last ninety seconds, ringed when it is the screen you are standing in front of, red during an emergency broadcast it has confirmed it is showing. Lights placed on the plan are drawn lit or unlit. Needs a plan, and by default one this screen has been placed on.Default: 6 × 5 cells

Three more widgets draw on Twinview — Board numbers, Board list and Board breakdown — and they are covered in the Twinview article rather than here, because what they show depends entirely on how your project is set up.

Information and household

Everything here is core — no integration stands behind any of it — though several read something from outside. Weather reads Open-Meteo, News reads whatever feed you point it at, and Webhook shows whatever another service sends it.

Insights: What the house has noticed — a window open with rain coming, lights on in an empty house, a freezer warming up. Needs nothing, and finds more with Home Assistant connected. Silent most of the day on purpose.Default: 4 × 3 cells
Thermostat: What the temperature is, what it is set to, and buttons to change it by a step you choose. Core rather than filed under one system: it works on a Home Assistant climate entity or a Hive thermostat, and says on the tile which it is reading.Default: 4 × 3 cells
Weather: Conditions now, plus an optional three-, five- or seven-day forecast and a detail row of sun, wind, humidity, pressure and UV. Set by latitude and longitude.Default: 4 × 3 cells
News: Headlines from an RSS feed. Any feed URL; the BBC news feed is the starting value.Default: 5 × 3 cells
Note: A short fixed message. The simplest widget there is, and the right one for a line that never changes.Default: 3 × 2 cells
Scrolling text: A line that moves: your own messages, the house's own observations, or both. Scroll left or right for a strip along the foot of a board, or up to hold one message at a time long enough to be read. The pace is yours, in seconds.Default: 12 × 1 cells
Webhook: Shows whatever another service posts to it, with an age line so a stale number never looks current. Can also switch scenes or show and hide other widgets when it fires. Needs the Pro plan.Default: 4 × 2 cells
Menu board: Prices, dishes and photographs from one of your menus, in your choice of layout. Needs a menu, created under Menus, which is part of the business plans.Default: 6 × 6 cells
Greeting: A welcome that changes with the time of day and with who the screen recognises, with a subtext line driven by rules you write.Default: 8 × 3 cells
Tasks: Open tasks from your household list — the same list the assistant adds to.Default: 3 × 4 cells

Lights, whichever system they are on

Two of these are core rather than filed under an integration, and that is deliberate. A light is not an integration — it is a thing on a wall, and there are four ways of getting one into Mirra: Home Assistant, WLED, Govee and Hue. Filing the only widgets that can set a colour under any one of them would mean the households on the other three could not reach them.

The three WLED widgets are the opposite case: they hold things the general vocabulary cannot express — a controller's own saved presets, its effect and palette catalogues, and a strip that has a physical shape. WLED carries no plan gate, because a strip behind a television should not cost more than a strip.

Light: One light — on, off, brightness, colour and warmth, with up to five one-tap colour swatches. Anything the light itself cannot do is hidden. Needs a light, from Home Assistant, WLED, Govee or Hue.Default: 2 × 3 cells
Light scenes: A few named looks, each applied across several lights at once. A brightness of zero turns them off. Needs lights, from any of the four providers, and a single look can mix them.Default: 4 × 2 cells
The strip: The whole WLED strip drawn as a strip, each segment in its own colour, tap a segment to toggle it.Default: 4 × 2 cells
Presets: A WLED controller's own saved looks, as buttons. Needs a controller with presets saved on it.Default: 4 × 2 cells
Effect: Pick an effect and a palette from the controller's catalogue and set its speed and intensity.Default: 4 × 3 cells

Home Assistant

Thirteen widgets, all needing Home Assistant connected and the Home plan. In the palette they sit behind one tile, and the picker offers them under four headings grouped by what you are trying to do rather than by how they are built — "I want to see a number" and "I want to press something" is how people arrive at this.

The Thermostat used to be the fourteenth and is now core, listed under Information and household above, because Hive households have thermostats too and filing it here put it out of their reach.

Every entity picker filters to what the widget can actually use, and every one of them keeps a way to see the full list. Home Assistant lets people put anything in any domain, and a filter that is too clever locks somebody out of their own setup.

State: Show one thing. An icon and label that change with a thing's state — locked, open, home. No domain filter, so it is the one to reach for when nothing more specific fits.Default: 3 × 2 cells
Dial: Show one thing. A numeric value on a dial, with your own range, low and high bands, unit and decimal places.Default: 3 × 3 cells
Trend: Show one thing. A number and where it has been, over the last day by default. Needs Home Assistant's recorder, which is on by default.Default: 4 × 3 cells
Switch: Control one thing. An on/off switch you can reach from the screen, with an optional tap-twice confirmation.Default: 3 × 2 cells
Button: Control one thing. Runs a scene, script or service when pressed. Worth confirming for anything with consequences — a screen on a wall gets brushed past.Default: 3 × 2 cells
Slider: Control one thing. Brightness, volume or any number you can set by dragging.Default: 4 × 2 cells
Camera: Rooms and devices. A still from a camera, refreshed on its own every ten seconds by default. Stills rather than video, because a stream would keep a Pi's decoder busy all day.Default: 5 × 4 cells
Now playing: Rooms and devices. What is on any media player — Spotify, Apple Music, YouTube Music or anything else on a speaker — with optional play, pause and skip.Default: 5 × 3 cells
Home: The whole house. A compact list of entities you choose; tap lights and switches to toggle them.Default: 4 × 4 cells
All secure?: The whole house. One line for what is locked and what is not. Can show nothing at all when everything is shut, which is the calmest option on a mirror.Default: 5 × 2 cells
Low batteries: The whole house. The sensors about to go flat, worst first, hidden entirely while they are all above your threshold — thirty per cent to begin with.Default: 4 × 3 cells
Scene buttons: The whole house. A row of shortcuts — Movie, Bedtime, Away — one button per scene or script you pick.Default: 6 × 2 cells
Energy now: The whole house. What the house is drawing and what the panels are making, with a grid figure that goes negative when you are exporting.Default: 5 × 2 cells

What the catalogue will not do

It will not run code we did not write. There is no way to add a widget type yourself, no embedded web page widget, and no scripting surface on a screen. If a widget you want is not here, it is not here yet.

It also will not hide a widget that your household pays for and has merely turned off. Those two states read differently everywhere — the palette drops a turned-off integration entirely and tells you where the switch is, while a widget your plan does not include stays visible with an upgrade note on it. A feature nobody can see is a feature nobody upgrades for.

Turning an integration off never takes anything off a wall. While its widgets are sitting on a scene, the Integrations page names the scene and the switch stays put.

The photo frameHow to build an album, point a screen's photo frame at it, control how photos are cropped and dimmed, and turn one into a full-bleed background for the rest of a scene.
The agenda widgetWhat the agenda draws from, how far ahead it looks, how it picks between your calendars and a meeting room's, and why an empty agenda is not the same as a broken one.
The tasks widgetOne household task list, kept in the portal or by talking to the assistant, shown on any screen with the tasks widget.
The scene editorThe scene editor is where you arrange a screen's widgets on a twelve-column grid, watch the real widgets render behind them, and push the result to the wall.
Integrations: what they are, and turning them onAn integration is an outside source that several widgets draw on — this explains what turning one on and off does, and why Mirra refuses to turn one off while its widgets are still on a scene.
Plans and allowancesWhat each Mirra plan includes — screens, household members and assistant credits — how credits are metered, and what happens when you reach a limit.