SuggestArr

SuggestArr

Docker app from LubricantJam's Repository

Automatically request suggested movies and TV shows to Jellyseerr based on recently watched.

Overview
Automatically request suggested movies and TV shows to Jellyseerr based on recently watched.

🚀 SuggestArr - Media Automation Made Simple

SuggestArr: recommendations from what you watch, sent to Seer

Build Status Platform Support Docker Pulls Buy Me a Coffee External image (view source)

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

Home Requests
Home dashboard with request stats, recap and suggestions awaiting approval Requests sent to Seer, with posters and availability
AI Search Jobs
AI Search results for a plain-language request Scheduled 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

Categories

Download Statistics

1,559,417
Total Downloads
197,126
This Month
132,108
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Links

Details

Repository
ciuse99/suggestarr:latest
Last Updated2026-11-02
First Seen2024-10-16

Runtime arguments

Web UI
http://[IP]:[PORT:5000]
Network
host
Shell
bash
Privileged
false

Template configuration

Web UI PortPorttcp
Target
5000
Value
5155
configPathrw
Target
/app/config/config_files
Value
/mnt/user/appdata/suggestarr