Support / Guide

Troubleshooting Intently for Plexamp

Fixes for offline keys, missing album art and lyrics, timing that's off, and how to find the plugin's logs.

Connection

“Plexamp hung up” Plexamp is running but isn’t accepting remote commands. In Plexamp, open Settings → Remote Control and make sure Remote Control is on. On a Mac, if it’s already on, turn it off and back on, then press Test in the Plexamp bar.

OFFLINE, or “Plexamp isn’t running” Start Plexamp. If it is running, check the Player field in the Plexamp bar. The default is 127.0.0.1:32500.

“No answer from the plugin” The plugin itself stopped. Quit and reopen the Stream Deck app, and send the plugin’s log (see below) to support.

SIGN IN or PLEX OFFLINE on a key or dial That action needs your Plex server. SIGN IN means you’re signed out: sign in from the Plexamp bar in any action’s settings. PLEX OFFLINE means your Plex server isn’t answering: check that it’s running and reachable, then press Plexamp Status to re-check.

Album art and Play This

No album art Sign in to Plex in the Plexamp bar. If you’re signed in and art is still missing, press Plexamp Status to reconnect.

Play This does nothing The plugin builds a play queue on your server and asks Plexamp to play it. Check the plugin log for the error. If the Player address points to a device outside your computer or home network, Play This refuses on purpose. See controlling a headless Plexamp.

Lyrics

“No lyrics for this track” Your Plex server has no lyrics for it, and Plexamp would show none either. Lyrics come from LyricFind, which needs Plex Pass on the server owner’s account and internet access on the server, or from .lrc / .txt files named exactly like the song file, next to it. The plugin checks again every 10 minutes, so lyrics that come back show up without a restart.

“Couldn’t load lyrics” The server lists lyrics for the song but didn’t deliver them. The plugin retries after 30 seconds and writes the reason to its log. If lyrics vanish for every song in Plexamp as well, check that your Plex server is still signed in to your account and can reach the internet.

Lyrics run early or late First compare with the lyrics in Plexamp itself.

  • If Plexamp is off by the same amount, the lyrics were timed against a different recording, such as a remaster. Push and turn the Lyrics dial to fix that song; the change is remembered.
  • If every song is off by the same small amount, use Timing in the Lyrics settings.

Logs

The plugin keeps logs in its folder, under logs:

  • Windows: %APPDATA%\Elgato\StreamDeck\Plugins\net.intentionaltechnologies.plexamp.sdPlugin\logs
  • macOS: ~/Library/Application Support/com.elgato.StreamDeck/Plugins/net.intentionaltechnologies.plexamp.sdPlugin/logs

Your Plex token is never written to the logs, so they’re safe to send.

Still stuck?

Email support with the plugin version (shown in Stream Deck’s plugin list), your Stream Deck app version, your operating system and its version, what you expected and what happened, and the log file if you can. See support.


Still stuck? Contact support.