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.
I built Recordhound because I listen both to my own library and on streaming services, and no recommendation app I tried took both into account. It combines your Plex library with your listening elsewhere, explains every pick, and lets you tune how it decides.

What you need
- A Plex server with a music library, and its token
- Optional: a ListenBrainz account with your scrobbles (free, and works with most streaming services), Spotify, Lidarr, and a Last.fm API key (see Last.fm)
Setup
When installing, Community Apps asks which version you want: Latest (stable releases, recommended) or Nightly (built every night from the newest code, with new features first and the occasional bug). You can switch any time by editing the container and changing the tag at the end of Repository, for example ghcr.io/shaderf/recordhound:latest. Your settings and data carry over. Two more tags exist for special cases: an exact version such as :0.13.0 to stay on one release or roll back if a release causes trouble, and :edge, test builds published while changes are being tried out (expect rough edges).
- Install from Community Apps and open the WebUI (
http://SERVER-IP:8789). - A short setup walkthrough opens on first start. Enter your Plex URL and token and use Test. Everything else is optional: the Getting started list on the home page points to the extras, and everything can be changed later in Settings.
- The first sync looks up every artist and can take 20 minutes or more, since MusicBrainz allows one lookup a second. Lookups are cached for a month, so later syncs are quick. Syncs run nightly.
What's in it
- For You: a This week summary, top picks (reshuffled weekly), New for you this week, Because you play…, genre rows, deep cuts, new releases from artists you love (including announced albums), albums you're missing, and albums you own but never played.
- All Picks: every pick, endlessly, with genre include/exclude and filters for how well known an artist is.
- Your Library: albums you own but have never played, ranked for you with a reason for each. One click puts the top ones in a Plex playlist for Plexamp.
- You Stream: artists you play a lot on ListenBrainz, Spotify or Last.fm but don't own. Send them to Lidarr from here.
- Rate: rate the artists you play, one at a time. Ratings go to Plex. Rate picks you already know so they stop being suggested.
- 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:
- ListenBrainz (free): enter your username (your profile must be public). This is also the way in for Apple Music, YouTube Music, Deezer, Tidal and other services; see below.
- 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
https://shaderf.github.io/recordhound-auth/, paste its Client ID in Settings, click Connect Spotify and approve. You come straight back. (That address is a small page that sends you back to your own Recordhound; how it works.) If you connected Spotify before this was possible, see the note in Settings → Spotify. Spotify requires Premium for developer apps, limits each to 5 users, and ends connections after six months. - Last.fm: enter your username. This needs a Last.fm API key, and from December 1, 2026 the key's account needs Last.fm Pro.
Listening on other services: Recordhound doesn't connect to Apple Music, YouTube Music, Deezer or Tidal directly, but ListenBrainz can collect your plays from them for free. The Web Scrobbler browser extension sends what you play in a service's web player (not its phone or desktop app), and multi-scrobbler runs on your server and collects plays from several services and players. Then add your ListenBrainz username in Settings. Plays count from the day you set this up.
How it picks
Your star ratings count most, then how much you play an artist anywhere, then what you own (adjustable). Artists you've played in the last six months get extra pull (adjustable under What you've played lately). Recordhound walks 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.
Where artist data comes from
By default, similar artists come from ListenBrainz (what its listeners play together) and Deezer (related artists), genre tags from MusicBrainz, fan counts from Deezer, and bios from Wikipedia. None of these need a key.
Last.fm: if you enter a Last.fm API key, Recordhound uses Last.fm's similar artists, tags and listener counts instead, and can read your scrobbles. From December 1, 2026, Last.fm keys only work while the account that owns the key has Last.fm Pro. If your key stops working, Recordhound switches to the free sources on its own and shows a warning; clear the key in Settings to make that permanent.
HTTPS
Either works:
- Reverse proxy (recommended): put the app behind Nginx Proxy Manager, SWAG, Caddy, Traefik, or
tailscale serve, and let it handle certificates. Proxies on your own network are trusted automatically, so the app knows it's on HTTPS (sign-in cookies are then marked secure). Serve it at the root of a domain or subdomain, e.g.https://recordhound.example.com; a sub-path like/recordhoundisn't supported. - Built-in: put a certificate and key in the Data folder (e.g.
certs/cert.pemandcerts/key.pem), then set HTTPS certificate to/data/certs/cert.pemand HTTPS key to/data/certs/key.pemin the container's advanced settings. Restart after renewing a certificate. With Tailscale,tailscale certcreates both files for your server'sts.netname.
If you turn on HTTPS, also turn on sign-in in Settings before reaching the app from outside your home.
Tips
- Rating artists is the biggest lever. The Rate page makes it quick.
- Raise Minimum Deezer fans (or Minimum Last.fm listeners with a Last.fm key) 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.
Filmhound and Recordhound are named for Daisy, my beagle and the hound of my life.
Source code and help
Recordhound is open source under the AGPL-3.0: github.com/ShadeRF/recordhound. Report problems or suggest ideas in its issues.
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. Changing it doesn't affect connecting Spotify.
- 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
Optional. Serve HTTPS directly: path inside the container to a certificate, e.g. /data/certs/cert.pem (put it in your Data folder). Leave empty for plain HTTP or when a reverse proxy handles HTTPS. If you set this, change the WebUI link to https.
- Target
- TLS_CERT
Optional. The certificate's private key, e.g. /data/certs/key.pem.
- Target
- TLS_KEY
Optional. Addresses allowed to tell the app a request came in over HTTPS (your reverse proxy). Empty trusts private networks (192.168.x, 10.x, 172.16-31.x and Tailscale), which suits a proxy on your own server.
- Target
- TRUSTED_PROXIES