Plex

Plex is optional. Aurral creates an Aurral music library in Plex Media Server. It scans your flow downloads.

Aurral also builds Plex playlists for each enabled flow and shared playlist. The playlists appear in Plex and Plexamp.

Plex does not read Aurral’s .m3u files. Playlist sync uses the Plex API after Plex indexes the audio files on disk.

Setup

1. Match Lidarr’s media mount so Plex can read Aurral’s Downloads Folder tree (Match Lidarr).
2. Open Settings > Playback > Plex.
3. Select Connect Plex account.
4. Approve the PIN in the Plex pop-up window.
5. Select your Plex server.
6. Make sure that the server URL is correct.
7. Save the settings.
8. Select Test connection.
9. After a flow downloads tracks, select Sync to Plex now.

Aurral registers the library at <plex-visible-downloads>/aurral-weekly-flow. Track files are in flow subfolders under that path.

Navidrome M3U playlists are in aurral-weekly-flow/_playlists/. Plex does not use these files.

Plex compared with Navidrome

You can run both at the same time. They use the same download tree but different playback mechanisms.

	Navidrome	Plex
Playlist format	.m3u files on disk	Regular Plex playlists through the API
Library setup	Scan folders and read M3U	Aurral creates an Aurral music library through the API
Path mismatch fix	Use Navidrome paths in M3U files / M3U_PATH_MODE	Plex downloads path (optional)
Playlist names	[A] Flow name, [AS] Shared name	Bare flow or playlist name

Navidrome’s M3U path settings do not affect Plex.

Plex downloads path (optional)

Leave this field blank when Aurral and Plex use the same filesystem view. They can use one host or one shared Docker volume.

Set Plex downloads path if Plex uses a different mount prefix than Aurral.

Enter the downloads folder as Plex sees it. Aurral adds /aurral-weekly-flow when it creates the library.

Aurral writes to	Plex sees	Plex downloads path
/data/downloads/aurral	/data/downloads/aurral	Leave blank
/music/Aurral (in Docker)	/data/media (Plex container)	/data/media

Browse shows folders as Aurral sees them. If Plex’s mount differs, type Plex’s path manually.

Plex downloads path matches the Plex and Aurral library roots. This setting is not the same as the Navidrome M3U path setting.

Sync behavior

Sync to Plex now makes sure that the Aurral library exists. It starts a Plex scan.

The operation also builds or updates playlists.

Aurral also schedules catch-up synchronization while Plex scans the files.

Plex music scans can take minutes. If sync returns zero indexed tracks, wait for the scan to finish.

Catch-up starts automatically. You can also select Sync to Plex now again.

Aurral skips a rebuild if the track set has not changed. If you disable a flow, the next sync removes its Plex playlist.

Mixed Docker setups

When Aurral and Plex both run in Docker with the same /data mount Lidarr uses, leave Plex downloads path empty:

services:
  aurral:
    volumes:
      - /srv/media:/data
      - ./config:/config

  plex:
    volumes:
      - /srv/media:/data

Set the Downloads Folder path in the UI (for example, /data/downloads/aurral). You do not have to add the folder in Plex.

Aurral creates the Aurral library through the API.

If Aurral uses remote path mappings for Lidarr reuse on Windows, that affects how Aurral reads files internally. It does not replace Plex downloads path.

See Match Lidarr and Troubleshooting: Plex.