Support / Guide

Getting started with Intently for Plexamp

Install the plugin, connect it to Plexamp, sign in with Plex, and set up your first keys and dials.

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.

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.