What the plugin connects to
| Connection | Used for | What it carries |
|---|---|---|
Plexamp’s control port (127.0.0.1:32500 by default) |
Playback commands, now-playing info, volume, shuffle and repeat | No password or token, except when Play This starts something (see below) |
| plex.tv (HTTPS) | Sign-in and finding your Plex servers | Your Plex account token |
| Your Plex Media Server | Album art, lyrics, the queue, Love ratings, playlists, server health | That server’s access token, sent in a request header |
The plugin doesn’t run a server of its own and doesn’t open any ports on your computer.
How the plugin protects you
- Sign-in without a password. You sign in on plex.tv in your own browser with Plex’s PIN flow. The plugin never sees your Plex password, and you can revoke its access from your Plex account at any time.
- Your token stays out of view. The token lives in the Stream Deck app’s settings on this computer. It’s never sent to the settings panel, never written to the plugin’s logs, and is sent to your server in a request header rather than in web addresses.
- Server addresses come only from your Plex account. Plexamp’s control port has no password, so anything answering on it could claim the music is coming from any address. The plugin ignores those reported addresses. If Plexamp is playing from a server the plugin isn’t using yet, it looks that server up on your Plex account by its ID and uses the address and access plex.tv lists for it. Servers that aren’t on your account are ignored.
- Requests stay on your server. Every path a server sends back, such as where a song’s lyrics are stored, is checked to make sure it stays on that same server. A request is refused if it would lead to another host, so a crafted response can’t send your token elsewhere.
- Player and profile data is checked. Track IDs, queue IDs and artwork paths from the player, and the items saved on Play This keys, must look exactly like Plex’s own before the plugin uses them. Stream Deck profiles can be shared and downloaded, so a crafted profile or a rogue device on the player’s port can’t steer requests to other parts of your server, or have your server’s artwork service fetch an outside address. Numbers in key settings are kept to sensible ranges.
- Play This stays at home. Starting a playlist hands your server’s access token to the player, so the plugin only does that for a Plexamp on this computer or a private home-network address. If the Player address points anywhere else, Play This refuses with a message instead.
- No redirects. The plugin refuses network redirects, so a request carrying your token can’t be bounced to a different address.
- Secure connections. The plugin uses the HTTPS addresses plex.tv lists for your server, local ones first, and tests each one before using it. It falls back to plain HTTP only on your home network, and never sends your token over plain HTTP across the internet. This works with Plex’s Secure connections: Required setting.
- Safe settings panel. The settings panel makes no network requests of its own. Every track, playlist, account and server name is escaped before it’s displayed, so text from a server can’t inject code. The only page the panel opens is plex.tv’s own sign-in page.
- Safe key images. Titles, artists and lyrics are escaped before they’re drawn on keys and strips.
- Malformed data can’t stall it. Lyrics and player messages are read in a single pass, so even a huge or broken file is handled quickly, and odd characters in titles are replaced rather than causing errors.
- Size limits. Responses from Plexamp or a server are capped (2 MB for data, 512 KB for lyrics, 8 MB for images), unfinished event-stream data is capped at 1 MB, and album art is decoded under strict size limits. The art, lyrics and queue caches are capped too, so a misbehaving device can’t exhaust memory.
- Dependencies. The installed plugin includes only Elgato’s Stream Deck SDK (with the libraries it brings along) and a small image decoder. A known memory flaw in a library bundled with the SDK (zod) is closed by requiring the fixed version. Build tools aren’t shipped. A dependency audit found no known vulnerabilities as of version 0.4.15.
- Tested. An automated test suite checks these protections on every build: a crafted path that would leave the server is refused, a player-reported address is never used, crafted IDs and artwork paths are refused, the token never goes over plain HTTP to a remote address or to a player outside your home network, malformed lyrics are handled in linear time, and oversized responses are refused.
Risks to be aware of
These come from how Plex and Plexamp work, not from this plugin:
- Plexamp’s control port has no password. Anything that can reach a Plexamp player on port 32500 can control it, with or without this plugin. The plugin talks to desktop Plexamp over this computer’s own loopback address (
127.0.0.1), but whether Plexamp’s port is also reachable from other devices depends on your firewall. A headless player on your network is reachable by anything else on that network. - Play This hands your server’s access token to the player. That’s how Plex lets a player stream your music. Plexamp may record that request, including the token, in its own log. The plugin only does this for players on this computer or your home network, but only point it at players you own and trust.
- The token is stored on this computer. As with every Stream Deck plugin, settings are stored where programs running under your user account on this computer can read them. A full backup of your Stream Deck configuration may include the token.
- Servers shared with you. A Plex server someone shares with you sees the requests you make to it, as with any Plex app. Its access token works only on that server.
Using it safely
- Install only from a copy you trust, and check the version in Stream Deck’s plugin list.
- Leave the Player address at
127.0.0.1unless you’re controlling another Plexamp you own. - For a headless player, allow port 32500 on that device only from your Stream Deck computer, for example with a firewall rule or a rule between VLANs. Never forward port 32500 from the internet.
- Keep Secure connections set to Preferred or Required in your Plex Media Server’s network settings.
- Import Stream Deck profiles only from people you trust. The plugin checks what’s in them, but a profile is still a set of buttons someone else built.
- Treat Stream Deck backups like a password. Screenshots of the plugin’s settings are fine, because the token is never shown there.
- If this computer is lost or you stop using the plugin, sign out in the Plexamp bar, then remove the device under Authorized Devices in your Plex account. It appears there as Intently for Plexamp (or Plexamp for Stream Deck if you signed in before version 0.4.16).
- Keep the plugin updated. Security fixes are listed in the release notes.
Reporting a security issue
If you find a security problem, email [email protected] with “Security” in the subject. Please don’t post details publicly until a fix is released.
Still stuck? Contact support.