Plugin to show original Plex track metadata in LMS when using Squeeze Plex Hub

🔗 Squeeze Plex Hub • 🔊 Lyrion • ⏯️ Plexamp • 🌐 Project Page

LMS Squeeze Plex Hub Plugin

Squeeze Plex Hub Plugin is a plugin for Lyrion Music Server (LMS) that enriches playback with Plex Media Server (PMS) metadata when tracks are loaded via the Squeeze Plex Hub application.

When audio is streamed into LMS through Squeeze Plex Hub, this plugin bridges the metadata gap by fetching and displaying the original Plex song information (title, artist, album, artwork, etc.) inside LMS and on connected players.

While optional, this plugin is strongly recommended when using the Squeeze Plex Hub project to unlock the best overall playback and metadata experience in LMS.

---

Features

• Displays Plex PMS metadata in LMS
• Automatically detects tracks loaded via Squeeze Plex Hub
• Shows correct title, artist, album, and artwork

---

Requirements

• Lyrion Music Server (LMS) with LMS Squeeze Plex Hub Plugin activated
• Squeeze Plex Hub >= 1.22.0
• Plex Media Server reachable from Squeeze Plex Hub and Lyrion Music Server

---

Installation

1. Go to LMS server settings -> Manage plugins and search for "Squeeze Plex Hub". It should be listed in the 3rd party plugins section.
2. Activate the plugin and restart.
3. Use Squeeze Plex Hub to play some tracks, the metadata should be added automatically.

If the plugin is not listed, add the following repository url in the Additional Repositories section and follow the installation instructions.

• https://raw.githubusercontent.com/onmomo/lms-squeeze-plex-hub/refs/heads/develop/repo/repo.xml

Manual Installation

1. Clone this repository
2. Mount the SqueezePlexHub directory into $LMS-ROOT-DIR/config/cache/Plugins
3. Ensure the plugin directory is named exactly: SqueezePlexHub
4. Restart LMS after any change

   LMS does not hot-reload plugins

---

Local Development 🛠️

Unit Testing

From repo root:

cpanm --installdeps --notest .
prove -lr t

macOS (LMS Package)

Install the Lyrion Music Server DMG for macOS, then symlink the plugin into LMS:

mkdir -p "/Users/$USER/Library/Application Support/Squeezebox/Plugins/SqueezePlexHub"
ln -sv "$PWD/SqueezePlexHub/"* "/Users/$USER/Library/Application Support/Squeezebox/Plugins/SqueezePlexHub"

Restart LMS after linking.

Docker (Development & Testing) 🐳

You can run LMS in Docker and mount the plugin directly:

docker run --rm -it \
  -e TZ=Europe/Zurich \
  -v $PWD/config:/config:rw \
  -v $PWD/SqueezePlexHub:/lms/Plugins/SqueezePlexHub:ro \
  -v $PWD/music:/music:ro \
  -v $PWD/playlist:/playlist:ro \
  -v /etc/localtime:/etc/localtime:ro \
  -p 9000:9000/tcp \
  -p 9090:9090/tcp \
  -p 3483:3483/tcp \
  -p 3483:3483/udp \
  lmscommunity/lyrionmusicserver

⚠️ Note: I could LMS not to work properly with Docker Desktop (macOS) for development. Native Linux Docker is recommended for best results.

How It Works 🧠

Squeeze Plex Hub loads tracks into LMS playlist The plugin detects those tracks Metadata is fetched from Plex Media Server LMS is updated in real-time with enriched metadata

Contributing 🤝

Pull requests, bug reports, and feature ideas are welcome. If you enjoy extending LMS, Plex, or using legacy Squeezebox hardware with Plex — contributions or sponsorships are appreciated.

👉 GitHub Sponsors

License

This project is licensed under the MIT License.

Disclaimer

LMS Squeeze Plex Hub Plugin is an independent, open source project and is not affiliated with, endorsed by, or officially supported by Plex, Plexamp, Logitech, or Slim Devices.
All product names and trademarks are the property of their respective owners.