Media Server

Latest Plex or Jellyfin additions as posters, plus who's streaming now.

At a glance

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

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

Sourcemediaserver.pysrc/deskdot/apps/mediaserver.py

Settings
Setting	Type	Default	Options / range
Connection
Server`server`	choice	Plex	PlexJellyfin
Host`host`e.g. 192.168.1.20 (blank = not set up)	text	empty	up to 120 characters
Port`port`0 = default (Plex 32400, Jellyfin 8096)	whole number	0	0 – 65535
Token / API key`token`Plex: X-Plex-Token. Jellyfin: Dashboard → API Keys. Sent as a header, never logged.	text	empty	up to 200 characters
Jellyfin user`user`Blank = the first user	text	empty	up to 60 characters
Display
Layout`layout`	choice	Poster	PosterShelfNow streaming
Seconds per item`rotate`	whole number	8	3 – 60
Show now-streaming count`sessions`Polls sessions every minute	on/off	On	on / off

render a frame to PNG (no panel needed)

$ uv run deskdot preview mediaserver --settings '{"server":"jellyfin"}' --out mediaserver.png

show it on your panel (engine running)

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

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

Spotify / YouTube Music / any player: album art, karaoke lyrics, vinyl, spectrum and more.

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

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.