Filmhound

Filmhound

Docker app from TheTimeTheSpace's Repository

Movie and TV recommendations built from your own Plex library, ratings and watch history.

Requirements

A Plex Media Server and a free TMDB API key (themoviedb.org/settings/api). Seerr, Radarr, Sonarr, Letterboxd and Trakt are optional.
Overview
Movie and TV recommendations built from your own Plex library, ratings and watch history. A list to browse, never automatic downloads. Every pick says why ("Because you watched Out of the Past"). Endless scrolling, genre and decade filters, rows by theme, where-to-stream, trailers, actor pages, a watchlist, missing films from collections and directors you own, and upcoming releases from people you like. Send titles to Radarr or Sonarr with your quality profile, or request them through Seerr. Imports Letterboxd and Trakt history and can copy those ratings to Plex. Needs a Plex server and a free TMDB API key. Everything is set up on the Settings page after the first start.


Filmhound

Movie and TV recommendations built from your Plex library and watch history. Browse picks, see why each one was picked, and send what you want to Radarr, Sonarr or Seerr. Nothing is requested automatically.

What you need

  • A Plex server and its token
  • A free TMDB API key (themoviedb.org/settings/api)
  • Optional: Seerr (Overseerr/Jellyseerr), Radarr, Sonarr, a Letterboxd account, a Trakt account

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 later by editing the container and changing the tag at the end of Repository.

  1. Install from Community Apps and open the WebUI (http://SERVER-IP:8788).
  2. Settings opens on first start. Enter your Plex URL and token, and your TMDB key. Use Test on each, then Save.
  3. The first sync reads your library and looks up every title on TMDB. A few thousand titles take a few minutes; after that, syncs are quick and run nightly.

Finding your Plex token: Plex Web → any movie → ⋯ → Get Info → View XML. The token is the X-Plex-Token= value in the page address.

What's in it

  • For You: rows like Because you watched…, Because you have…, themed rows, hidden gems, your watchlist, Finish what you started (missing films from collections and directors you own) and Coming soon from people you like.
  • All Picks: every pick, endlessly, with filters for genres, years, rating, runtime, language, network and your streaming services.
  • Your Library: what you own but haven't watched, ranked for you. Send the top 50 to a Plex collection.
  • Rate: rate what you've watched, one at a time. Ratings on titles in Plex are saved to Plex.
  • Title pages: trailer, where to stream, cast and crew, and why it was picked. Add to Radarr or Sonarr, request through Seerr, save to your watchlist, or open More like this.
  • Search any movie, show or person.
  • History from elsewhere: Letterboxd (export upload plus your diary feed) and Trakt, optionally copied into Plex ratings.
  • Don't learn from: keep kids' movies or someone else's shows in Plex without them shaping your picks.

How it picks

Your ratings count most, then what you've watched, then what you own (adjustable). Each title in your library points to others through TMDB's recommendations; Filmhound adds a taste profile of the directors, writers, cast, keywords, genres, decades and franchises you return to, plus IMDb ratings for quality.

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://filmhound.example.com; a sub-path like /filmhound isn't supported.
  • Built-in: put a certificate and key in the Data folder (e.g. certs/cert.pem and certs/key.pem), then set HTTPS certificate to /data/certs/cert.pem and HTTPS key to /data/certs/key.pem in the container's advanced settings. Restart after renewing a certificate. With Tailscale, tailscale cert creates both files for your server's ts.net name.

If you turn on HTTPS, also turn on sign-in in Settings before reaching the app from outside your home.

Tips

  • Rating things is the biggest lever. The Rate page makes it quick.
  • Too many obscure picks? Raise Minimum TMDB votes in Settings. Too mainstream? Lower it.
  • Your data is in the Data folder (filmhound.db, settings.json). Delete both to start fresh.

Categories

Related apps

Explore more like this

Explore all

Links

Details

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

Runtime arguments

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

Template configuration

Web UI portPorttcp

Port for the web interface.

Target
8788
Default
8788
Value
8788
DataPathrw

Database, cache and settings.

Target
/data
Default
/mnt/user/appdata/filmhound
Value
/mnt/user/appdata/filmhound
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
HTTPS certificateVariable

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
HTTPS keyVariable

Optional. The certificate's private key, e.g. /data/certs/key.pem.

Target
TLS_KEY
Trusted proxiesVariable

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