Filmhound
Docker app from TheTimeTheSpace's Repository
Movie and TV recommendations built from your own Plex library, ratings and watch history.
Requirements
Overview
Readme
View on GitHub![]()
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.
- Install from Community Apps and open the WebUI (
http://SERVER-IP:8788). - Settings opens on first start. Enter your Plex URL and token, and your TMDB key. Use Test on each, then Save.
- 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/filmhoundisn'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 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 allLinks
Details
ghcr.io/shaderf/filmhound:latestRuntime arguments
- Web UI
http://[IP]:[PORT:8788]/- Network
bridge- Shell
bash- Privileged
- false
Template configuration
Port for the web interface.
- Target
- 8788
- Default
- 8788
- Value
- 8788
Database, cache and settings.
- Target
- /data
- Default
- /mnt/user/appdata/filmhound
- Value
- /mnt/user/appdata/filmhound
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