Recordhound
Docker app from TheTimeTheSpace's Repository
Music recommendations built from your own Plex library and listening history.
Requirements
Overview
Readme
View on GitHub![]()
Music recommendations built from your Plex library and listening history. Browse new artists, see why each one was picked, preview them, and send what you want to Lidarr. Nothing is downloaded automatically.
What you need
- A Plex server with a music library, and its token
- A free Last.fm API key (last.fm/api/account/create; any app name, callback URL can be blank)
- Optional: a Last.fm or ListenBrainz account with your scrobbles, Spotify, and Lidarr
Setup
- Install from Community Apps and open the WebUI (
http://SERVER-IP:8789). - Settings opens on first start. Enter your Plex URL and token, and your Last.fm key. Use Test on each, then Save.
- The first sync looks up a few hundred artists on Last.fm and takes several minutes. Lookups are cached for a month, so later syncs are quick. Syncs run nightly.
What's in it
- For You: top picks, Because you play…, genre rows, deep cuts, new releases from artists you love, and albums you're missing.
- All Picks: every pick, endlessly, with genre include/exclude and filters for how well known an artist is.
- You Stream: artists you play a lot on Last.fm, ListenBrainz or Spotify but don't own. Send them to Lidarr from here.
- Artist pages: 30-second previews, why it was picked, bio, albums (owned ones marked), similar artists, and links to Spotify, Apple Music, Bandcamp and more.
- Lidarr: add artists with your quality and metadata profiles and choose what to monitor.
- Save, Not interested, Already know them, and Don't learn from (for kids' music or someone else's albums).
Listening history
Plex play counts (including Plexamp) and star ratings are always used. Optionally add:
- Last.fm: enter your username.
- ListenBrainz: enter your username (your profile must be public).
- Spotify history file: request your data at spotify.com/account/privacy and upload the zip Spotify emails you. No developer account needed.
- Spotify account: keeps your top, followed and saved artists current. Spotify only allows this through a personal developer app: create one at developer.spotify.com/dashboard with the redirect URI
http://127.0.0.1:8789/callback, paste its Client ID in Settings, click Connect Spotify, approve, then paste back the address of the page that fails to load. Spotify requires Premium for developer apps, limits each to 5 users, and ends connections after six months.
How it picks
Your star ratings count most, then how much you play an artist anywhere, then what you own (adjustable). Recordhound walks Last.fm's similar-artist data out from your strongest artists, scores candidates against a profile of the genres and scenes you return to, and explains each pick with the artists that led to it.
Tips
- Raise Minimum Last.fm listeners in Settings for better-known picks, or lower it and use Deep cuts for obscure ones.
- Your data is in the Data folder (
recordhound.db,settings.json). Delete both to start fresh.
Categories
Related apps
Explore more like this
Explore allLinks
Details
ghcr.io/shaderf/recordhound:latestRuntime arguments
- Web UI
http://[IP]:[PORT:8789]/- Network
bridge- Shell
bash- Privileged
- false
Template configuration
Port for the web interface. If you change it and use Spotify, set the same port in your Spotify app's redirect URI.
- Target
- 8789
- Default
- 8789
- Value
- 8789
Database, cache and settings.
- Target
- /data
- Default
- /mnt/user/appdata/recordhound
- Value
- /mnt/user/appdata/recordhound
Used for the nightly sync time.
- Target
- TZ
- Default
- America/New_York
- Value
- America/New_York
User the app runs as. 99 is Unraid's nobody.
- Default
- 99
- Value
- 99
Group the app runs as. 100 is Unraid's users.
- Default
- 100
- Value
- 100
Permissions for new files.
- Default
- 022
- Value
- 022