
Now Playing
Spotify / YouTube Music / any player: album art, karaoke lyrics, vinyl, cassette, CD, VU meters, radio dial and more.
At a glance
update_app_settingsapp_action over MCPSettings
| Setting | Type | Default | Options / range |
|---|---|---|---|
| General | |||
LayoutlayoutLyrics from LRCLIB, a community database (other lyric sites as a fallback). | choice | Karaoke | KaraokeSynced lyricsLyrics over artWord popAlbum artArt + titleLiving artVinylCDCassetteMosaicArt + infoMinimalBig titleColour washSpectrumVU metersWaveformRadio dial |
Take over while music playstake_overIn the playlist | on/off | On | on / off |
Lyric colourcolorCurrent line in the Synced lyrics layout | colour | #ffd600 | any colour (#rrggbb) |
AccentaccentProgress and equaliser (unless themed from art) | colour | #00ff8c | any colour (#rrggbb) |
Show art when no lyricsfallback_cover | on/off | On | on / off |
| Track info | |||
Show albumshow_albumAfter the artist | on/off | Off | on / off |
Show where it playsshow_sourceA small generic glyph: music app, browser or player | on/off | On | on / off |
Long textscroll_style | choice | Marquee (loops) | Marquee (loops)BouncePages of words |
Scroll speed (px/s)scroll_speed | number | 12.0 | 6 – 24 |
| Lyrics | |||
Lyric offset (s)offsetPositive = earlier | number | 0.3 | -5 – 5 |
Sung colourkaraoke_color | colour | #ffd600 | any colour (#rrggbb) |
Unsung colourkaraoke_dim | colour | #5a5a78 | any colour (#rrggbb) |
Lyric sizefont | choice | Auto (big when it fits) | Auto (big when it fits)Big 7 pxCompact 5 px |
Lyric alignmentlyric_align | choice | Centre | CentreLeft |
Sung highlighthighlight | choice | Sweep through words | Sweep through wordsWhole wordsUnderline |
Line spacingline_spacing | choice | Normal | TightNormalLoose |
Translation linetranslationWhen the lyrics carry one (same-time lines in the LRC) | on/off | On | on / off |
Follow page themefollow_themeUse the page theme's colours (Settings → Display & colour) for the colours you haven't changed. Off = this app's own colours. | on/off | On | on / off |
| Display | |||
Progress barshow_progress | on/off | On | on / off |
Show timeshow_time | on/off | On | on / off |
Timetime_mode | choice | Elapsed | ElapsedRemaining |
| Song change | |||
Between songstransition | choice | Dissolve | CutSlideDissolveArt zoom |
Rotate layoutsrotate | choice | Off | OffEvery songEvery few seconds |
Rotate throughrotate_set | choice | Best of | Best ofArtLyricsRetro gearTrack info |
Rotate every (s)rotate_every | whole number | 45 | 10 – 600 |
| Paused & idle | |||
When pausedpause_style | choice | Layout's own | Layout's ownDimPause signFreezeIdle screen after 20 s |
When nothing playsidle_screen | choice | NO MUSIC | NO MUSICClockLast album artRecent coversCalm wavesSilenceNothing |
Recent covers wallwall_size | choice | 4 covers | 4 covers16 covers |
| Art | |||
Art brightnessart_brightness | number | 1.0 | 0.2 – 1.0 |
Art behind lyricsart_dimBackground level for Lyrics over art | number | 0.3 | 0.05 – 0.7 |
Colours from album arttheme_from_artSung colour and accent follow the cover's palette | on/off | On | on / off |
Art styleart_style | choice | Smooth | SmoothPixelatedPosterisedDithered |
DitherditherDithered art and Mosaic | choice | Ordered (crosshatch) | Ordered (crosshatch)Error diffusionNone |
Coloursart_colorsPosterised / dithered art and Mosaic | whole number | 6 | 2 – 16 |
Contrastart_contrast | number | 1.0 | 0.5 – 1.8 |
Saturationart_saturation | number | 1.0 | 0.0 – 2.0 |
Pulse with the beatbeat_syncLiving art breathes with system audio (starts audio capture) | on/off | Off | on / off |
| Layout options | |||
Big title sizetitle_size | choice | Huge (14 px) | Huge (14 px)Tall (10 px) |
Cassette shellcassette_shell | choice | From the cover | From the coverBlackChromeRed |
VU metersvu_style | choice | Twin needles | Twin needlesLED ladders |
CD rainbow sheencd_shine | on/off | On | on / off |
Radio bandradio_band | choice | FM | FMAM |
Mosaicmosaic_grid | choice | Big tiles (8 × 8) | Big tiles (8 × 8)Small tiles (16 × 16) |
Waveformwave_style | choice | Mirrored bars | Mirrored barsTrace |
| In the browser | |||
Where the song comes fromweb_sourceA browser tab can't see your music apps. ListenBrainz needs only your user name; Last.fm needs your user name and a free API key; or type the song in. | choice | Typed in | Typed inListenBrainzLast.fm |
User nameweb_userYour ListenBrainz or Last.fm user name | text | empty | up to 64 characters |
Last.fm API keyweb_api_keyFree at last.fm/api/account/create (only for Last.fm). Kept in this browser. | text | empty | up to 64 characters |
Song (typed in)web_titleClear it when the music stops | text | empty | up to 120 characters |
Artist (typed in)web_artist | text | empty | up to 120 characters |
Try it
$ uv run deskdot preview nowplaying --settings '{"layout":"lyrics"}' --out nowplaying.png$ curl -X POST http://127.0.0.1:8765/api/apps/nowplaying/activateOr ask your agent: “Show Now Playing on my panel”. It calls show_app with "nowplaying". New here? Set up DeskDot first.
More media apps

Photo Frame
A slideshow of public-domain art, nature photos, Wikimedia's picture of the day, dogs, cats, foxes and ducks.

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

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

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