Before you start
- Windows 10 or 11 (64-bit), or macOS 13.5 Ventura or later, with the Stream Deck app 7.1 or later.
- Plexamp 4.x, running on the same computer. Nothing gets installed on the Plexamp side.
- Plex Media Server anywhere on your network, such as a NAS or another computer. It’s needed only for album art, Love, Up Next, Play This and lyrics.
- In Plexamp, make sure Settings → Remote Control is turned on. The plugin talks to the control server Plexamp already runs on port 32500, the same one the headless player uses.
1. Install the plugin
Install Intently for Plexamp from Elgato Marketplace inside the Stream Deck app. If you received the plugin file directly, double-click net.intentionaltechnologies.plexamp.streamDeckPlugin instead.
The actions appear under Intently for Plexamp in the Stream Deck action list.
2. Drag an action onto a key or dial
Drag any Plexamp action onto a key or dial. It connects to Plexamp on this computer (127.0.0.1:32500) on its own. Plexamp only needs to be running.
Playback controls work right away, without signing in.
3. Sign in with Plex (recommended)
Open the Plexamp bar at the top of any action’s settings and click Sign in with Plex. Your browser opens plex.tv. Approve it there, and the plugin finds your server by itself. The plugin never sees your Plex password.
Signing in adds:
- Album art and the art-tinted backgrounds
- Love, Up Next and Play This
- Lyrics
Actions that need Plex say so. Their keys and dials show SIGN IN when you’re signed out, or PLEX OFFLINE when your server isn’t answering, and their settings show a note under the Plexamp bar explaining what’s missing.
4. Build your page
A good starting point on a Stream Deck + XL:
| Where | What to put there |
|---|---|
| Dials, left to right | Now Playing Dial · Volume · Up Next · Lyrics 1/3 (knob: scrub) · Lyrics 2/3 (knob: lyrics) · Lyrics 3/3 (knob: tracks) |
| Keys, rows 1–2 | A 2×2 Now Playing cover, then Previous, Play/Pause, Next, Back 10, Ahead 30, Shuffle, Mute, Repeat, Love and Plexamp Status |
| Keys, rows 3–4 | Play This keys for the playlists, albums and stations you reach for most, such as Library Radio and Time Travel Radio |
On a regular Stream Deck, every key action works the same way. The dial actions need a Stream Deck + or + XL.
See the actions reference for what each action can do, and recipes for album-art blocks, title blocks, and a one-button “start my music” key.
If something isn’t working
- Keys show OFFLINE: start Plexamp. If it’s running, check the Player field in the Plexamp bar (default
127.0.0.1:32500). - “Plexamp hung up”: Plexamp is running but isn’t accepting remote commands. Turn on Settings → Remote Control in Plexamp. On a Mac, if it’s already on, turn it off and back on, then press Test in the Plexamp bar.
More fixes are in troubleshooting.
Still stuck? Contact support.