Skip to content

Releases: Rayce185/Recommendarr

Recommendarr v1.0.0

09 Mar 04:47
@Rayce185 Rayce185
v1.0.0
c8d62d4

Choose a tag to compare

View all tags
Recommendarr v1.0.0 Latest
Latest

The first stable release. A self-hosted media recommendation engine for Plex that learns from viewing behavior across all server users to generate personalized, explainable recommendations.

Highlights

  • 6 recommendation modes — Watch Tonight, Worth Grabbing, Rediscover, Mood Match, Group Night, Discovery Feed
  • AI-powered explanations — optional LLM generates natural language "why we picked this" for every recommendation (Ollama, OpenAI, Anthropic)
  • Smart mood matching — natural language input like "just got dumped, distract me, no romcoms" parsed into genre/keyword weights
  • Social layer — taste overlap scores, friend system with activity feed, friend suggestions, privacy controls
  • World Cinema Map — geographic discovery with taste matching across 195 countries
  • Coming Soon Calendar — TMDB + Radarr/Sonarr release tracking
  • Collection tracking — detects partially watched franchises (MCU, John Wick, etc.) with one-click requests
  • Full Plex integration — OAuth login, watchlist sync, Seerr/Overseerr request support

What's Included

Recommendation Engine

Watch Tonight, Worth Grabbing, Rediscover, Mood Match, Group Night, Discovery Feed, Trending (global/country/provider), and Browse with advanced filters (year range, rating threshold).

Social Features

Friend system (request/accept/decline), activity feed, friend suggestions (≥30% taste overlap), Group Night friend picker, taste overlap scoring, privacy controls.

Discovery Tools

World Cinema Map, Cultural Pulse (RSS-powered themes), Coming Soon Calendar, Notification Center, Recommendation History, Why Not? (negative transparency), "Because You Watched X" attribution.

User Experience

Taste profiles (auto-generated + manual tuning), feedback loop (thumbs up/down/dismiss), profile export/import, dark/light theme, mobile responsive, PWA support.

Administration

User switcher (preview any user's recs), editable settings panel, N-instance Servarr registry, AI provider configuration via UI.

Quick Start

docker run -d \
  --name recommendarr \
  --restart unless-stopped \
  -p 5055:5055 \
  -v /path/to/data:/app/data \
  -e PLEX_URL=http://your-plex:32400 \
  -e PLEX_TOKEN=your-plex-token \
  -e TAUTULLI_URL=http://your-tautulli:8181 \
  -e TAUTULLI_API_KEY=your-tautulli-key \
  -e TMDB_API_KEY=your-tmdb-key \
  rayce185/recommendarr:1.0.0

Open http://your-server:5055 and log in with your Plex account.

Requirements

  • Docker
  • Plex Media Server (admin token)
  • Tautulli (watch history)
  • At least one of: Radarr, Sonarr
  • Seerr/Overseerr (TMDB discovery + request proxy)
  • TMDB API key (free)
  • Optional: Ollama, OpenAI, or Anthropic for AI features (all features work without LLM)

Stack

Python (FastAPI) + React (Vite) + nginx + SQLite — single container, no external databases needed.

Links

Assets 2
Loading