Recordhound

Recordhound

Docker app from TheTimeTheSpace's Repository

Music recommendations built from your own Plex library and listening history.

Requirements

A Plex Media Server with a music library and a free Last.fm API key (last.fm/api/account/create). Last.fm scrobbles, ListenBrainz, Spotify and Lidarr are optional.
Overview
Music recommendations built from your own Plex library and listening history. A list to browse, never automatic downloads. Learns from Plex (Plexamp play counts and star ratings), Last.fm, ListenBrainz and Spotify, then finds new artists through Last.fm's similar-artist data, with a clear reason for every pick. Shows artists you stream but don't own, albums missing from artists you collect, and new releases from artists you love. Artist pages have 30-second previews, discographies and links to Spotify, Apple Music and Bandcamp. Send artists to Lidarr with your quality and metadata profiles. Needs a Plex server with a music library and a free Last.fm API key. Everything is set up on the Settings page after the first start.


Recordhound

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

  1. Install from Community Apps and open the WebUI (http://SERVER-IP:8789).
  2. Settings opens on first start. Enter your Plex URL and token, and your Last.fm key. Use Test on each, then Save.
  3. 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 all

Links

Details

Repository
ghcr.io/shaderf/recordhound:latest
Last Updated2026-11-16
First Seen2026-11-16

Runtime arguments

Web UI
http://[IP]:[PORT:8789]/
Network
bridge
Shell
bash
Privileged
false

Template configuration

Web UI portPorttcp

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
DataPathrw

Database, cache and settings.

Target
/data
Default
/mnt/user/appdata/recordhound
Value
/mnt/user/appdata/recordhound
Time zoneVariable

Used for the nightly sync time.

Target
TZ
Default
America/New_York
Value
America/New_York
PUIDVariable

User the app runs as. 99 is Unraid's nobody.

Default
99
Value
99
PGIDVariable

Group the app runs as. 100 is Unraid's users.

Default
100
Value
100
UMASKVariable

Permissions for new files.

Default
022
Value
022