The art frame
How the art widget turns a screen into a picture frame — collections of your own, our curated catalogue, framing and mats, and what a household actually chooses to hang on the wall.
The art widget is available on every plan and needs no integration. Collections we curate may be free, a one-off purchase or a monthly subscription; on a deployment with no payment provider configured, priced collections say so rather than offering a button that cannot work.
What the art frame is
The art widget shows one work at a time, full screen, the way a frame shows a painting. It is not the photo frame with different pictures in it, and two differences carry the weight.
It fits rather than fills. A photograph cropped to a screen is still that photograph; a painting cropped to a screen is a different painting, and that crop is the single thing that makes a digital art frame look cheap. What is left over becomes a mat, the way a framed print has one.
It also moves, imperceptibly. A screen that is on for sixteen hours a day will etch a still image into itself over months. The drift is slow enough that nobody consciously sees it and large enough that no pixel holds one value for long.
Where collections come from
Art is organised into collections, and the Art page in the top bar shows two shelves. What separates them is who made them, not how they behave on a wall.
- Your collections — built from images you upload. Nobody else ever sees them, published or not.
- Our catalogue — collections we curate. Some are free and already yours; others carry a one-off price or a monthly subscription.
- A collection you no longer have access to stops playing. If you cancel a subscription it keeps working until the end of the period you have already paid for.
Making a collection of your own
Open Art and press New collection
You are asked for a title. The collection appears on the “Your collections” shelf straight away, empty.
Press Upload works
Several files at once is fine. Each work is stored at full size, its pixel dimensions are measured, and its colours are worked out once so that no screen ever has to sample the image itself. Anything over 40 MB, or in a format Mirra does not accept, is skipped.
Fill in the details of each work
Click a work to open Details. Title, Artist, Year, Medium, Credit line, Source URL and Licence. The credit line matters: it is the condition a museum releases an image under, and the screen shows it whether or not the licence compels it.
Give the collection a description
Press Description. One or two lines, shown wherever the collection is offered. It is also what the search box on this page matches against — somebody hunting for seascapes will not remember that the collection is called “Salt and Weather”.
An account can keep 40 collections of its own, and a collection can hold 500 works. Our curated collections are ours and do not count towards that.
Choosing what hangs on the wall
A collection sitting on the Art page shows nothing. Pointing a screen at it is a separate step, and it is per screen — one household can have a Hokusai in the hall and its own photographs of a holiday in the study.
Open Screens and pick the screen
Then choose the scene the frame belongs in.
Under Add widget, find Photos & art and press + Art
It arrives filling the grid — twelve columns by eight rows — because this is the widget people give a whole wall to. An art frame cropped into a corner is a photo frame.
Choose the collection
The picker lists everything this household may display: its own collections and whatever it holds from the catalogue.
Set the framing, the mat and the caption
Then save the scene. The screen picks it up without being restarted.
Everything the art widget can be set to
The colours behind the ambient mat and the light tinting are computed once, when a work is uploaded — as a flat palette and as eight bands across the picture. A seascape that is blue at one end and gold at the other lights a strip blue at one end and gold at the other, rather than averaging the two into brown.
Free, bought, subscribed — and what happens if you stop
Every collection in our catalogue carries its state on its card, because a price alone does not tell a button whether to say “Buy”, “Subscribed” or “Ends on the 3rd”.
- Free — yours already. Point a widget at it and it plays.
- Bought — yours to keep. A one-off payment, and it does not expire.
- Subscribed — a monthly payment, with a Cancel button beside it.
- Cancelled — plays until a stated date. Cancelling never blanks a wall the same afternoon.
- Payment failed — the card needs updating on the Plan page; the collection keeps playing while that is sorted out.
- Where a deployment has no payment provider configured, a priced collection shows its price and says payments are not set up here, rather than offering a button that would fail.
Cancelling a subscription is confirmed with a note about what happens next, but it is not reversible from that button — restarting means going through checkout again. What you have already paid for keeps playing until the period ends.
Shape: portrait, landscape and the mat between
A screen is mounted one way up and stays that way; a collection may be all portrait, all landscape, all square, or mixed. Mirra measures every work at upload and says something only when the answer would change a decision.
On the Art page, a line at the top tells you which way your own screens are mounted, and a catalogue card speaks up only when the fit is less than good. A row of green “fits your screen” labels on everything would bury the one warning worth reading. Inside a collection of your own, the shape of the whole set is stated once above the works, and each work carries its own shape on its thumbnail.
- All portrait — best on a screen mounted upright.
- All landscape — best on a screen mounted the usual way round.
- All square — suits a screen either way up.
- Mixed — some works will show with a wider mat, or the widget's Shape setting can skip the ones that would float.
What the screen reports, and what the mirror can tell you
The screen tells Mirra which piece it is currently showing. That is what lets the assistant answer “what am I looking at?” with the title, artist, year, medium and credit line of the thing actually on the wall — the server cannot work it out for itself, because the rotation is decided on the device.
What is showing right now is held in memory rather than written down. A screen changes picture every minute or two, and recording that would be thousands of rows a day about something only interesting at the moment it is asked.
On a collection you own, each work can also carry up to two minutes of your own recorded voice, made in the browser from the work's Details panel. When somebody asks the mirror about that piece, it can offer to play the recording instead of reading the metadata back.
Time on the wall is also counted towards paying artists whose collections are listed with us. What an artist is shown is their own earnings — never which households displayed their work.
Related
- Every widget there isThe 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.
- 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.
- Selling your work on MirraFor artists: applying to sell, the two gates between applying and earning, submitting a collection for listing, and exactly how the money reaches you.
- 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.
- Lights, light rules and WLEDOne light model across Home Assistant bulbs, WLED strips, Govee lamps and Hue bulbs: adding a controller, what a rule can do, how a segment becomes a light, and which of the four leave your network at all.
- The assistant: how a conversation worksHow you summon Mirra, what happens between hearing you and answering you, which tools it can reach, where the transcript goes, and what a conversation costs against your monthly allowance.
- Screen types, and what a screen can doWhat hardware can act as a Mirra screen, what each display reports about itself, and exactly what the capability record does and does not cover.
- BillingHow to subscribe, change plan, find your invoices and cancel — and what Mirra does on an install where payments were never configured.