Repolode
giuseppe99barchetta

giuseppe99barchetta/SuggestArr

Automatically requests movies, TV shows and anime to Seer based on what Jellyfin, Plex or Emby users recently watched.

Stars
1,376
Forks
45
Open issues
8
Last commit
5 days ago

What is it?

SuggestArr is a media automation tool for self-hosted media servers. It reads recently watched titles from Jellyfin, Plex or Emby, finds similar movies, TV shows and anime, and submits them as download requests to Seer. Recommendations come from TMDb by default, or from any OpenAI-compatible LLM that also gives a short reason for each pick.

Beyond automatic suggestions, it supports per-user Trakt history, watch-history CSV imports, and public list imports from MDBList or Trakt. Users can also describe what they want in plain language through AI Search. Request control options include approval before sending to Seer, pausing jobs while requests are pending, and auto-declining stale requests. A cleanup job can remove old unfavorited requests, running in dry-run mode by default.

Setup happens through a web interface with scheduling, user management, live logs and connection tests. It stores data in SQLite, PostgreSQL or MySQL, and offers a public REST API with Swagger UI. It is distributed as a Docker image.

Key features

  • 01Uses Jellyfin, Plex or Emby watch history as the basis for recommendations.
  • 02Finds similar titles via TMDb or any OpenAI-compatible LLM with reasons.
  • 03Supports AI Search for plain-language requests.
  • 04Imports public lists from MDBList or Trakt on a schedule.
  • 05Offers approval gates, job pausing and auto-decline of stale requests.
  • 06Filters out titles already on streaming services in your country.

Use cases

  • Keeping a household Jellyfin or Plex library stocked with shows similar to what viewers already enjoy.
  • Letting several users on one media server receive personalized suggestions.
  • Running recommendations through a local Ollama model for a private setup.
  • Importing a friend's public Trakt or MDBList list into your Seer requests.

Quick start

  1. 1

    Create a docker-compose.yml with the SuggestArr service

  2. 2

    Start SuggestArr with Docker Compose

    docker compose up -d
  3. 3

    Open http://localhost:5000 in your browser and follow the setup wizard

Things to know

  • Requires a TMDb API key, plus a running Jellyfin, Plex or Emby server and a Seer instance.

In collections

Topics

FAQ

What is SuggestArr?
Automatically requests movies, TV shows and anime to Seer based on what Jellyfin, Plex or Emby users recently watched. SuggestArr is a media automation tool for self-hosted media servers. It reads recently watched titles from Jellyfin, Plex or Emby, finds similar movies, TV shows and anime, and submits them as download requests to Seer. Recommendations come from TMDb by default, or from any OpenAI-compatible LLM that also gives a short reason for each pick.
Is SuggestArr free to use? What license does it have?
SuggestArr is open source under the MIT license. Check the license terms before using it in commercial products.
Is SuggestArr still maintained?
Actively maintained. The last commit to SuggestArr was on Nov 2, 2026.
What can I use SuggestArr for?
Keeping a household Jellyfin or Plex library stocked with shows similar to what viewers already enjoy. Letting several users on one media server receive personalized suggestions. Running recommendations through a local Ollama model for a private setup. Importing a friend's public Trakt or MDBList list into your Seer requests.
How do I install SuggestArr?
Create a docker-compose.yml with the SuggestArr service Start SuggestArr with Docker Compose: docker compose up -d Open http://localhost:5000 in your browser and follow the setup wizard
Where can I get SuggestArr?
The source code and installation instructions are on GitHub: https://github.com/giuseppe99barchetta/SuggestArr

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects