Products / Intently / Stream Deck plugin
Intently for Plexamp
Music. On Purpose.
Turn Stream Deck keys and dials into a Plexamp remote, with album art across your keys, one-press playlists and stations, and time-synced lyrics across your dials.
An example Stream Deck + XL page: a 4×4 album cover with its title, labeled transport keys, a title block, Play This playlists, and lyrics across three dials.
Intently for Plexamp turns your Stream Deck into a dedicated control surface for Plexamp. Album art spreads across your keys, your favorite playlists and stations sit one press away, and the dials scrub, set volume, browse what’s up next, and scroll time-synced lyrics across the touch strip.
It’s built for the Stream Deck + XL, and every key action works on regular Stream Decks too. Nothing gets installed on the Plexamp side: the plugin talks to the control server Plexamp already runs, the same one the headless player uses. Playback controls work the moment Plexamp is running. Signing in with your Plex account adds album art, Love, Up Next, Play This and lyrics.
Intently for Plexamp is the first in Intently, a family of apps from Intentional Technologies that each focus intently on one thing and do it well.
Features
What it does
Album art across your keys
Now Playing shows the cover on a single key, or spreads it across a 2×2, 3×3 or 4×4 block, with a thin progress line and an optional outline in the album's own color.
Titles set like signage
Title-only blocks up to 4 × 3 keys set the song large, one line per row, without ever splitting a word across the gap between keys.
Transport, shuffle, repeat and Love
Play, pause, skip, scrub back or ahead, volume and mute, plus shuffle, repeat and a Love key that matches your Plex rating.
One-press playlists and stations
Play This starts a playlist, album, artist or station with a single press, shuffled if you like, with its art on the key.
Lyrics across your dials
Time-synced lyrics with the current line large and a progress sweep, stretched across up to six dials, with per-song timing you can nudge and keep.
Dials that feel right
Scrub through a song, set Plexamp's volume, and browse Up Next by turning a knob, all shown on the touch strip over colors drawn from the album art.
Always in step
Keys update the moment Plexamp changes, and the plugin keeps its own clock so progress bars and lyrics stay on the beat.
Status at a glance
Plexamp Status watches the player and your Plex server, with status lights, response times and versions on one key.
Compatibility
Works with your Stream Deck
Stream Deck + XL
Built for it. Every key action and every dial action, including lyrics across up to six dials.
Stream Deck +
Every key action and every dial action.
Stream Deck, XL, MK.2, Mini and Neo
Every key action. Dial actions need a Stream Deck + or + XL.
Security
Built to keep your Plex account safe
No password, ever
You sign in on plex.tv in your own browser. The plugin never sees your Plex password, and you can revoke its access at any time.
Your token stays home
It's stored by the Stream Deck app on your computer, never shown in settings or written to logs, and never sent over plain HTTP across the internet.
Nothing new exposed
The plugin runs no server and opens no ports. It talks to Plexamp, plex.tv and your own Plex server, and nothing else.
Hardened and tested
Server paths, IDs and shared profiles are checked, redirects are refused, responses are size-capped, and an automated test suite checks these protections on every build.
Before you install
Requirements
- Windows 10 or 11 (64-bit), or macOS 13.5 Ventura or later
- Stream Deck app 7.1 or later
- Plexamp 4.x, running on the same computer (or a headless Plexamp on your network), with Remote Control turned on
- Plex Media Server anywhere on your network, such as a NAS or another computer (tested with version 1.43)
- Optional: sign in with your Plex account for album art, Love, Up Next, Play This and lyrics
- For lyrics: Plex Pass on the server owner's account, or .lrc / .txt lyric files beside your music
Guides
Setup and help
- Getting started with Intently for PlexampInstall the plugin, connect it to Plexamp, sign in with Plex, and set up your first keys and dials.
- Intently for Plexamp actions referenceEvery key and dial action, and the settings that shape how it looks and behaves.
- Recipes: covers, title blocks and a one-button startBuild a 2×2 album cover, a marquee title block, and a single home-page key that opens Plexamp, starts the music and jumps to your Plexamp profile.
- Controlling a headless PlexampPoint the plugin at Plexamp running on another device, such as a Raspberry Pi, and keep that connection safe.
- Troubleshooting Intently for PlexampFixes for offline keys, missing album art and lyrics, timing that's off, and how to find the plugin's logs.
- FAQ and contactCommon questions, and how to reach support.
Release notes
What's new
Version 0.4.22
- The minimum macOS version is now 13.5 Ventura, matching what the Stream Deck app and its built-in Node.js 24 need. Windows stays at Windows 10 (64-bit) or later.
Mac support November 2026
- Tested on macOS as well as Windows: playback, album art and title blocks, Play This, lyrics dials, sleep and wake, and restarts.
Version 0.4.22
- New Intently icons: the plugin icon and the action-list icon now carry the Intently family mark.
Earlier releases
Version 0.4.20
- Gap now starts at 41 px, tuned on a Stream Deck + XL, and its slider shows the value.
Version 0.4.19
- New Picture setting for album-art blocks: keep the cover whole, seen through the keys like a window, so circles stay round and lines stay straight across the gaps. Gap fine-tunes it to your Stream Deck.
Version 0.4.18
- Plexamp Status views now show only what they watch: Plexamp only and Plex server only fill the key with that one connection, and Both is the default for new keys.
- Actions that depend on Plex (Love, Play This, Up Next, Lyrics, and album art on Now Playing) say so when Plex isn't available: SIGN IN when you're signed out, PLEX OFFLINE when your server isn't answering, plus a note in their settings.
Version 0.4.17
- Fixes the plugin quitting on macOS when Plexamp briefly refused a connection, caused by a known problem in the networking code built into the Stream Deck app's runtime on Mac, which the plugin now works around.
- A clearer message when Plexamp is running with Remote Control turned off ("Plexamp hung up").
- The settings panel no longer sits on "checking…" if the plugin stops answering; it says so after a few seconds.
Version 0.4.16
- The plugin is now named Intently for Plexamp, the first in the Intently family of apps by Intentional Technologies, LLC. Its actions now appear under Intently for Plexamp in the Stream Deck action list.
Version 0.4.15
- Security hardening from a full review: IDs and artwork paths from the player or a shared profile are checked before use. Play This only hands your token to players on this computer or your home network, and the token is never sent over plain HTTP across the internet.
- The lyrics reader is faster and can't be stalled by malformed files. Odd characters in titles no longer cause errors. Key settings are kept to sensible ranges, and the Player address keeps only the host and port.
Version 0.4.14
- Title-only blocks one row high: when a short title leaves keys unused, the artist and album fill them instead of leaving a key empty.
Version 0.4.13
- The Scrub, Volume, Up Next and Lyrics dials have their own knob faces in the Stream Deck app, replacing the squashed sample strips shown there before.
Version 0.4.12
- Album art up to 4 × 4 keys, with everything a 3 × 3 cover has. A 4 × 4 cover is fetched at a higher resolution so it stays sharp.
Earlier versions
- Lyrics knobs: each dial under the lyrics can control lyrics, volume, scrub or tracks, or nothing, labeled on the bottom line of the strip.
- Lyric timing: the plugin runs its own clock from Plexamp's freshest position report, with a global Timing setting and per-song nudges that are remembered.
- Block settings sync, outlines on album art, and title-only blocks from 1 × 1 to 4 × 3.
- Security hardening: server addresses come only from your Plex account, server paths are checked, redirects are refused, and responses are size-capped.
- Published under Intentional Technologies, LLC, with plugin ID net.intentionaltechnologies.plexamp.
- Plexamp Status, Play-only and Pause-only Transport options, the Lyrics dial, and the first version's Now Playing keys and dial, transport, shuffle and repeat, Love, Play This, Volume and Up Next.