Photo Frame

A slideshow of public-domain art, nature photos, dogs, cats, foxes and ducks.

At a glance

OutputLiveRendered by the engine and streamed over Bluetooth as its data changes (about 5–9 frames a second).

Settings15every one editable live in the studio, or by an agent with update_app_settings

ButtonsNext photostudio buttons, or app_action over MCP

Sourcephotoframe.pysrc/deskdot/apps/photoframe.py

Settings
Setting	Type	Default	Options / range
Sources
Art: The Met`art_met`	on/off	On	on / off
Art: Cleveland Museum`art_cleveland`	on/off	On	on / off
Nature & random photos`picsum`	on/off	Off	on / off
Dogs`dogs`	on/off	Off	on / off
Cats`cats`	on/off	Off	on / off
Foxes`foxes`	on/off	Off	on / off
Ducks`ducks`	on/off	Off	on / off
Met search`art_query`What to look for in The Met's highlights, e.g. painting, landscape, flowers, cat	text	painting	up to 40 characters
Dog breed`dog_breed`Empty = any. e.g. husky, corgi, golden retriever, shiba	text	empty	up to 40 characters
Show
Seconds per photo`interval`	whole number	20	5 – 600
Motion`motion`	choice	Ken Burns	StillKen Burns
Crossfade`crossfade`	on/off	On	on / off
Caption (title · artist)`caption`	choice	Scroll once	OffScroll onceAlways
Image
Framing`framing`	choice	Smart crop	Smart cropCentre cropFit (letterbox)
LED colour`profile`	choice	Vibrant	VibrantNatural

render a frame to PNG (no panel needed)

$ uv run deskdot preview photoframe --settings '{"motion":"still"}' --out photoframe.png

show it on your panel (engine running)

$ curl -X POST http://127.0.0.1:8765/api/apps/photoframe/activate

Or ask your agent: “Show Photo Frame on my panel”. It calls show_app with "photoframe". New here? Set up DeskDot first.

Your screen, a window, the area under the cursor, or ambient colours — live on the panel.

Reacts to whatever your PC is playing — Spotify, YouTube, games. No mic needed.

Your webcam on the LEDs — follows your face, with pop-art, neon, thermal and 1-bit looks.

Your uploads — photos are LED-calibrated, pixel art stays crisp.