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
- 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.
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