SuggestArr

Effortlessly request recommended movies, TV shows and anime to Jellyseer/Overseer based on your recently watched content on Jellyfin, Plex or Emby—let SuggestArr handle it all automatically, keeping your library fresh with new and exciting content!

Automatically checked · GitHub checked 2026-11-17

SuggestArr

Overview

🚀 SuggestArr - Media Automation Made Simple

SuggestArr: recommendations from what you watch, sent to Seer

Build Status Platform Support Docker Pulls Buy Me a Coffee

SuggestArr automates media recommendations and download requests based on what you watch on Jellyfin, Plex or Emby. It takes recently watched content, finds similar titles through TMDb (or an AI model), and sends the requests to Seer.

Features

  • Jellyfin, Plex and Emby as watch-history sources, plus optional per-user Trakt and Simkl history and imported watch history (CSV or manual TMDb titles with ratings).
  • Recommendations from TMDb, or from any OpenAI-compatible LLM (OpenAI, Ollama, OpenRouter, LiteLLM…) with a short reason for each pick.
  • AI Search: describe what you want to watch in plain language and request results in one click.
  • Public list import from MDBList or Trakt, as a scheduled job or a single import.
  • Request control: optional approval before sending to Seer, pause jobs while Seer requests are pending or suggestions are still unwatched, auto-decline stale Seerr requests.
  • Cleanup automation: remove old SuggestArr requests that nobody added to favorites (dry-run by default).
  • Filters: skip content already on streaming services in your country, plus quality and per-user filters.
  • Web interface for setup, scheduling, users, requests and live logs, with connection tests during setup.
  • Recaps and milestones you can share (details).
  • One-tap rating prompts on Telegram a while after you watch something (details).
  • SQLite, PostgreSQL or MySQL database.
  • Public REST API with Swagger UI.

See the Feature Guide for how each feature works.

Screenshots

HomeRequests
Home dashboard with request stats, recap and suggestions awaiting approvalRequests sent to Seer, with posters and availability
AI SearchJobs
AI Search results for a plain-language requestScheduled jobs and their recent runs

Users in these screenshots are fictional; titles, ratings and posters come from TMDb. This product uses the TMDB API but is not endorsed or certified by TMDB. Regenerate them with cd client && TMDB_API_KEY=... npm run screenshots (without a key, placeholder titles are used).

Requirements

Quick start

services:
  suggestarr:
    image: ciuse99/suggestarr:latest   # also ghcr.io/giuseppe99barchetta/suggestarr:latest
    container_name: SuggestArr
    restart: always
    ports:
      - "${SUGGESTARR_PORT:-5000}:${SUGGESTARR_PORT:-5000}"
    volumes:
      - ./config_files:/app/config/config_files
    environment:
      - LOG_LEVEL=${LOG_LEVEL:-info}           # optional
      - SUGGESTARR_PORT=${SUGGESTARR_PORT:-5000} # optional
docker compose up -d

Then open http://localhost:5000 and follow the setup wizard.

TrueNAS SCALE: SuggestArr is in the community catalog. Open Apps → Discover Apps, search for SuggestArr and install it.

Unraid: open the Apps tab (Community Applications), search for SuggestArr and install it. An official template is also available in unraid/template.xml.

For TrueNAS and Unraid details, source install, reverse proxy, authentication, backups and recommended settings, see the Installation Guide.

Public API

External integrations use the stable API at /api/v1 (endpoints under /api/* are internal). Swagger UI is at http://localhost:5000/docs (or /<SUBPATH>/docs), and the OpenAPI document at /api/v1/openapi.json and /api/v1/openapi.yaml. See the API guide.

Support SuggestArr ❤️

SuggestArr is free, open source and built in my spare time. If it saves you time or helps you find something great to watch, a small donation helps me keep improving it.

Support on Ko-fi Buy Me a Coffee

You can also help without donating: star the repo ⭐, report bugs, or share SuggestArr with other Plex, Jellyfin and Emby users.

Community and contributing

Questions, ideas and help on Discord. Issues and pull requests are welcome.

License

MIT