Support / Guide

Intently for Plexamp actions reference

Every key and dial action, and the settings that shape how it looks and behaves.

Keys

Now Playing

Album art with a thin amber progress line along the bottom. Paused dims the art and shows a pause badge. Press plays or pauses and hold loves the track (both configurable).

Style: Album art, Art + title, or Title only (typography on the cover’s color). On Art + title blocks, the title and artist read straight across the bottom row.

Album-art blocks. Cover size spreads the art across a square 2×2, 3×3 or 4×4 block. A 4×4 cover is fetched at a higher resolution so it stays sharp. Picture chooses how the cover meets the gaps between keys:

  • Spread across the keys (the default) puts a slice of the cover edge to edge on every key, so the gaps push the slices apart.
  • Whole, seen through the keys keeps the cover’s true shape, as if seen through a window, with the gaps hiding a thin strip. Adjust Gap until a straight line across the keys looks straight on your Stream Deck.

Title-only blocks can be any shape from 1 to 4 keys wide and 1 to 3 rows tall: 3 × 1 reads like a marquee, and 3 × 2 leaves room for the artist and album underneath. Titles are set as large as they’ll fit, one line per row of keys, so you read straight across each row. Short titles in tall blocks spread down the rows instead of huddling in the top row, and every line starts in the block’s left key. No key ever shows two stacked title lines, and no word ever straddles the gap between keys.

Title layout picks how words meet the gaps:

  • Keep words within a key: each word sits inside one key.
  • Big type across keys: large lettering spread evenly over the keys, whole letters on each key, like a sign painted across tiles. Titles of several words break between words where possible.
  • Smart (the default): keeps words within a key, and switches to big type only for short titles whose long words would otherwise come out small.

When a one-row block has keys left over after the title, the artist moves into the next free key, with the album beneath it or in the key after, so no key sits empty.

Outline. An outline traces the outside of the block in a bright version of the album’s color (amber for black-and-white covers), following each key’s rounded corners, so the keys read as one panel. Adjust Thickness (2–20 px on the 144 px key image; default 9) and From edge (default 2 px), or set Outline to None. On album art the outline is off by default; turned on, it draws a frame over the cover without shrinking or cropping the art. With the outline on, progress becomes a thin bar inside it.

While paused, a small badge sits in the block’s bottom-right corner. On 2×2 and 4×4 covers, where the middle falls on the gaps between keys, it sits in the top-right corner instead.

Building a block: fill it with Now Playing keys, set up any one of them, and pick its position. The rest of the block follows automatically, with the same style, outline and press/hold controls, each key in its own place. Changing any key later updates the whole block. If a block shrinks, keys left outside it go back to single keys.

Transport

Play/pause (toggle), Play only, Pause only, next, previous, stop, skip back or ahead (default 10 s back and 30 s ahead, adjustable), volume up/down, or mute. The play/pause key glows with the album’s color while music plays.

Shuffle / Repeat

Shows the current state in amber when on. Shuffle toggles. Repeat cycles off → all → one, with a 1 badge for repeat-one.

Love

A filled rose heart when the track is loved. Press to toggle it. It uses your Plex rating, so it matches what Plexamp shows.

Play This

One press starts a playlist, album, artist or station, optionally shuffled. Pick it in the settings: playlists and stations come from a list, albums and artists from a search. The key face is that item’s art.

Plexamp Status

Watches Plexamp (the player), your Plex server, or Both, each with a status light, name, response time and version. Plexamp runs playback; the Plex server supplies art, lyrics, the queue, Love and Play This, and is checked every 20 seconds (every 5 while it’s down). Both, the default, stacks the player over the server on one key; Plexamp only and Plex server only show just that one, larger. Press to re-check now: ✓ when everything it watches answers, ⚠ when something doesn’t.

Dials

Now Playing Dial

The strip shows art, title, artist, album, elapsed and remaining time, and a progress bar, over a gradient taken from the album art. Turn to scrub: the new spot previews in gold and the plugin jumps there when you stop. Push plays or pauses (or skips to next). Tap the strip on the left for previous, the middle for play/pause, and the right for next.

Volume

Plexamp’s own volume, shown as a big number and a bar. Turn to change it, push or tap to mute, and again to restore.

Up Next

The next track in the queue, with its art. Turn to browse ahead, and push or tap to play the one shown. It snaps back after 8 seconds.

Lyrics

Time-synced lyrics, with the previous line faint above, the current line large, the next line below, and a thin amber sweep showing progress through the line. The strip leaves out the song title, which is shown elsewhere on the deck, so the lyrics get the room.

Spread across stretches lyrics over 2–6 dials: put a Lyrics action on each dial in the run and number them left to right, and one line reads across the whole strip.

Each dial under the lyrics can do its own job with its Knob setting:

Knob Turn Push
Lyrics Browse lines (shown in gold), then push or tap to jump playback there Play/pause. Push and turn together to nudge timing earlier or later for that song, remembered across restarts; hold the strip to reset
Volume Change volume Mute
Scrub Move through the song Play/pause
Next / previous track One skip per turn Play/pause
Nothing

Each knob is labeled quietly on the bottom line of the strip, with its live value where it has one: ◂ LINES ▸ (◂ UNTIMED ▸ for lyrics that aren’t synced), VOL 64%, SEEK 1:23 or ◂ TRACK ▸. Labels light up gold while you turn the knob. Set Knob label to Only while turning to hide one otherwise.

Timing in the Lyrics settings shifts lyrics for every song, for example to match audio output delay. Per-song timing shows how many songs you’ve adjusted, with a button to clear them. Untimed lyrics scroll evenly through the song, and tracks with no lyrics show the title.

How it stays in step

  • Plexamp streams an update whenever the track, play state or volume changes, so keys change the moment Plexamp does.
  • The plugin also checks shuffle, repeat and position about three times a second. Plexamp only refreshes the position it reports about once a second, so the plugin runs its own clock from the freshest reading. That keeps progress bars and lyrics in step with Plexamp rather than up to a second behind. Seeks, stalls and track changes reset it.
  • Album art and the queue come from your Plex server. The plugin asks for exactly the size it needs, then caches it.
  • Lyrics come from your Plex server: Plex Pass lyrics, or .lrc / .txt files beside your music. Timed lyrics are preferred, and the line advances five times a second, so it changes right on the beat.
  • Background tints stay in a deep, mid-dark band, so white text stays readable even on pale covers.
  • When a key sends a command, it updates immediately and briefly ignores conflicting reports, so nothing flickers back.
  • If Plexamp quits, keys go dark with OFFLINE. The plugin retries and picks up again on its own when Plexamp is back.

Still stuck? Contact support.