Skip to content

Releases: stevezau/shortlist

v0.1.0-beta.1 — first public beta

Pre-release

Choose a tag to compare

@stevezau stevezau released this 21 Jul 03:49

Shortlist's first public beta. A private, personalized "Picked for You" row for every user on your Plex server — built from each person's own watch history, visible only to them.

⚠️ Beta. This has been running in production on my own server, but it's only really been tested there so far. Expect rough edges. Please open an issue if you hit a bug — I'm watching them. There's a safe mode (SHORTLIST_DRY_RUN=1) that writes nothing to Plex so you can try it against a real server first.

Highlights

  • A private row per user, from their actual watch history (a 20-episode binge counts as one show)
  • Optional AI curator — Claude / OpenAI / Google / local Ollama — that picks titles and writes a one-line "Because you watched X". Or run with no AI at all (heuristic mode, the default).
  • Only recommends titles already in your library — no dead-end suggestions
  • Multiple rows + shared rows, each with its own sources, size, libraries, schedule, placement, and poster
  • Leak-safe privacy — rows are delivered hidden and revealed only after the per-user exclusions exist; share filters are snapshotted and fully restored on uninstall
  • Optional Radarr/Sonarr requests for great picks you don't own yet (off by default)
  • One Docker container, /config volume, dark web UI, ~10-minute setup wizard

Get it

docker run -d --name shortlist \
  -p 5959:5959 -e TZ=Etc/UTC -e PUID=1000 -e PGID=1000 \
  -v /path/to/shortlist/config:/config \
  --restart unless-stopped \
  ghcr.io/stevezau/shortlist:0.1.0-beta.1

Or use the compose example. Then open http://your-host:5959 and follow the wizard.

Requirements: Plex Media Server ≥ 1.43.2.10687 · Plex Pass on the admin account · a free TMDB key. Tautulli and an LLM key are optional.

📖 Getting started · Full changelog in CHANGELOG.md