onmomo/squeeze-plex-hub repository overview

⁠Squeeze Plex Hub

Squeeze Plex Hub bridges Plexamp (Plex) with your Logitech / Lyrion Music Server ecosystem so you can play Plex audio on Squeezebox (and compatible) players.

⁠Features

• Discovers LMS instances and attached Squeeze players automatically
• Advertises discovered Squeeze players to Plexamp so they appear as selectable targets with full Plexamp controls
• Enables multi-room audio playback using Squeezebox players controlled by Plexamp
• Shows player and server metadata
• Simple Docker-based deployment
• Full track metadata support on LMS in combination with the LMS Squeeze Plex Hub Plugin⁠

⁠Requirements

• Running Lyrion Music Server (formerly Logitech Media Server) with at least one connected player
  • LMS JSON/CLI interfaces enabled (default)
  • (optional) Enable the LMS Squeeze Plex Hub Plugin⁠ to get full track metadata support on LMS
• Plex Media Server with your audio library to stream from. No further media required on Lyrion Music Server
• Plexamp client (desktop or mobile) signed into the same Plex account
• Network: Squeeze Plex Hub must reach both LMS and Plexamp clients (usually same LAN)

⁠Run Squeeze Plex Hub

docker run -d \
   --network host \
   --name squeeze-plex-hub \
   onmomo/squeeze-plex-hub:latest

After start:

1. Navigate to http://localhost:3000 in your browser to access the Squeeze Plex Hub web interface.
2. The application will display all discovered Squeezebox players and Lyrion Music Server (formerly Logitech Media Server), along with their metadata. Use the interface to confirm which Squeezebox players can be controlled via Plexamp.
3. Use Plexamp to target discovered Squeezebox players.

No Plex credentials are ever stored. The app discovers LMS and Plex services on your local network only, and when initiating playback it forwards the Plex token so the Squeezebox player can stream directly from your Plex Media Server. The token is not persisted and expires after some time.

⁠Container Networking

Squeeze Plex Hub listens for UDP broadcast on port 32412 from Plex clients and responds with the discovered players. Therefore, it is essential that it can receive these UDP requests on that specific port.

• For best results, run the Plex Server (PMS) container in either host or bridge network mode, and always run Squeeze Plex Hub in host network mode. This ensures Plexamp clients on mobile devices connected to your local network can discover Squeezebox players. Docker does not forward UDP packets from the host network (e.g. mobile devices) to the bridge network.
• Important: If Plex Server is in host mode, always start Squeeze Plex Hub before Plex Server so it will always bind to UDP port 32412. If Plex Server starts first and binds this port, Squeeze Plex Hub will eventually not work and crash.
• In bridge mode, do not bind UDP port 32412 for Plex Server, then the startup order does not matter.
• Squeeze Plex Hub container will crash if it can't bind UDP port 32412.