SoundScout

SoundScout is a self-hosted music discovery and acquisition app for Plex.

It uses Last.fm listening history to generate personalised recommendations, lets users import Spotify playlists, albums, and tracks from a web UI, downloads missing music into your library, and keeps Plex playlists in sync. It also supports monitored artists, so new releases can be picked up automatically.

Project links

Project: https://github.com/Ashyy0205/SoundScout

Container: ghcr.io/ashyy0205/soundscout:main

Template XML: https://raw.githubusercontent.com/Ashyy0205/SoundScout/main/SoundScout-template.xml

What it does

- Plex-authenticated web UI

- Last.fm-based recommendation generation

- Spotify playlist, album, and track import

- Automatic music acquisition into your Plex library

- Per-user settings and schedules

- Artist monitoring for new releases

Required paths

- /music -> your music library

- /config -> persistent SoundScout config and user/session data

- /app/data -> persistent app data, reports, and backlog state

- /root/.scraper -> scraper credentials folder containing config.json

Required settings

- PLEX_BASEURL = your Plex server URL, for example http://192.168.1.10:32400

- PLEX_MUSIC_LIBRARY = the name of your Plex music library section

- WEBUI_PUBLIC_URL = the public URL users will open in their browser, for example http://192.168.1.10:5000

Notes

- Plex sign-in is supported and recommended.

- Downloads require valid scraper credentials in /root/.scraper/config.json.

- The downloader currently tries services in this order: Tidal, then Qobuz, then Amazon.

- SoundScout is intended for users who already manage a Plex music library and want automated discovery plus assisted acquisition.

If you need support, please include the following in your post

- Your Unraid version

- Your SoundScout version or image tag

- A screenshot of your template settings

- The generated docker run command from Unraid

- Relevant container logs

- A clear description of what you expected and what actually happened

Known setup issues to check first

- WEBUI_PUBLIC_URL must be reachable from the browser. Do not use localhost unless the browser is on the same machine and that is truly how you access it.

- /root/.scraper/config.json must exist if you want downloads to work.

- Your Plex URL and Plex music library name must match your server exactly.

- Persistent folders must be mapped outside the container.

I will use this thread for support, bug reports, and setup help for the Unraid template and container.