# Shortlist

Shortlist is a self-hosted tool that adds per-user movie and TV recommendation rows to your Plex server, including a private, personalized "Picked for You" row. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3310/shortlist

## Description

Shortlist is a self-hosted tool that adds per-user movie and TV recommendation rows to your Plex server, including a private, personalized "Picked for You" row. Each user gets a personal collection row built automatically from their own watch history — visible only to them, never to anyone else. Optional AI curation (Claude / OpenAI / Gemini / local Ollama) explains each pick with a "Because you watched X", or run it with no AI at all. It only ever recommends titles already in your library, and can optionally ask Radarr/Sonarr for the ones you're missing. Each row is a labeled collection excluded on every other account's share — delivered hidden and only promoted once those exclusions are in place — with a fully reversible uninstall that restores your share filters from a snapshot. NOTE: this is a public beta; please report issues on GitHub.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

72/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 11 days ago)
- Popular: 41 (112 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 94 (no serious findings, 1 minor, CI, tests)

## Links

- Unraid: https://ca.unraid.net/apps/shortlist-1ahbctd17buf7h?q=shortlist
- Official website: https://shortlistapp.dev
- Documentation: https://shortlistapp.dev/getting-started/
- GitHub: https://github.com/stevezau/shortlist

## Common questions

### Does Shortlist have to run on the same machine as Plex?

No. It only needs to reach the Plex server over the network, and it runs as a Docker container.

### What port does the example Shortlist Docker Compose expose?

It maps host port 5959 to container port 5959. You then open the Shortlist UI on that host and port.

### Can I see what Shortlist would change before it writes to Plex?

Yes. Set SHORTLIST_DRY_RUN=1 in the container environment to see every change it would make while writing nothing to Plex.

### Does Shortlist require an AI API key?

No, it works without an AI key. If you enable AI curation, it can use Claude, OpenAI, Gemini, or a local server such as Ollama.

### How does Shortlist keep a row private to one Plex user?

Each row is labelled, and every other account's Plex share filter is told to hide that label before the row is promoted to Home. This relies on Plex's label-based share filters.

### Does uninstalling Shortlist restore the Plex share filters it changed?

Yes, the uninstall is fully reversible and restores your share filters from a snapshot.

---
Source: Our Local Host (https://ourlocalhost.com/app/3310/shortlist), the self-hosted and open-source app directory.
