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

Overview
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 |
|---|---|
![]() | ![]() |
| AI Search | Jobs |
![]() | ![]() |
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
- Docker (recommended) or Python 3
- A TMDb API key
- Jellyfin, Plex or Emby
- Seer
- Optional: PostgreSQL/MySQL, an OpenAI-compatible LLM, a Trakt app, a Simkl app
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.
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




