Plex

Music Assistant has support for using Plex (MusicLibrary). Contributed by micha91 and maintained by anatosun

Plex is a media server you run yourself, paired with apps for phones, TVs and browsers. It indexes the music and video held on your own storage and streams it to you wherever you are.

This source connects Music Assistant to the music library on your Plex server. Everything you have already organised there becomes part of your Music Assistant library.

Features

Subscription FREE	Yes
Self-Hosted Local Media	Yes
Media Types Supported	Artists, Albums, Tracks, Playlists, Audiobooks, Podcasts
Recommendations Supported	Yes
Lyrics Supported	No
Endless Mix	No
Artist Top Tracks Support	Yes
Similar Artists Support	No
Similar Tracks Support	Yes
Maximum Stream Quality	FLAC 192kHz 24 bit
Login Method	Password

Other

• Search the Plex server
• Track progress for audiobooks/podcasts across Plex clients

Configuration

• Click the Use Plex GDM to discover local servers button, this should discover your local server and prefill the local_server_ip and local_server_port fields
• If GDM discovery fails, the 2 fields mentioned above will be filled with “Discovery failed… ”. In this case, please add the IP address (without any http:// prefix) of your server, and the port (usually 32400) that you are exposing it on
• Select the SSL (HTTPS) toggle if required. If this setting is enabled an option in the Advanced Settings will be activated which requires the certificate to be verified (default is on)
• If you login to Plex via MYPLEX.TV, click the Authenticate on MYPLEX.TV button, this may trigger your browser pop-up detection, so watch out for that, authenticate as you normally would for Plex
• If you have configured Plex to allow local connection without authentication (see below), click the Authenticate Locally button
• Select the library and type (Music, Audiobook, or Podcast) that you would like to use; options will be auto-selected based on your existing configuration, but you can change as needed.
• Save the settings

Advanced Settings

• Extended recommendations. Enabled by default. Adds extra rows on the Discover view to include Mixes For You (the personalised mixes Plex builds from the listening history), recent library playlists and On This Day releases, matching the rows Plex’s own clients show. Changes take effect on the next recommendations refresh

Plex Configuration

• If you want to allow Music Assistant to connect to Plex without authentication, go to your Plex configuration, Settings / Network. In the field labeled List of IP addresses and networks that are allowed without auth enter the IP address of the computer running Music Assistant, and Save Changes

Known Issues / Notes

• A Plex source is always bound to a user account and a library
• If you have multiple libraries and/or library types, you need to add the Plex provider multiple times
• If you have multiple Plex accounts, which have their own playlists, you can also add them as separate provider instances
• If a Plex Media Server is running on the same host as MA, the Plex Connect plugin will fail to start because both attempt to bind to the GDM discovery port (32412). This is a known incompatibility. To resolve this it is necessary to run MA in Docker and remap the port, or run Plex and MA on separate hosts