Seerr / Overseerr¶

Integrate with Seerr (or Overseerr) to make deletion decisions based on user requests. Deleterr supports two capabilities:

1. Exclude or target media based on whether it was requested through Seerr
2. Mark deleted media in Seerr so users can request it again

Prerequisites¶

1. A running Seerr (or Overseerr) instance
2. API key from Seerr Settings > General

Setup¶

1. Add global Seerr connection¶

seerr:
  url: "http://localhost:5055"
  api_key: "YOUR_SEERR_API_KEY"

2. Add Seerr exclusions to your library¶

libraries:
  - name: "Movies"
    radarr: "Radarr"
    action_mode: "delete"
    exclude:
      seerr:
        mode: "exclude"

Modes¶

Exclude Mode (default)¶

Protects requested media from deletion. Use this when you want to keep content that users asked for.

exclude:
  seerr:
    mode: "exclude"

Use case: "Don't delete movies that someone specifically requested."

Include-Only Mode¶

Only deletes media that was requested through Seerr. Everything else is skipped.

exclude:
  seerr:
    mode: "include_only"

Use case: "Only clean up content that came in through Seerr -- leave manually added content alone."

Filtering Options¶

Filter by User¶

Only consider requests from specific users (matched by username, email, or Plex username):

exclude:
  seerr:
    mode: "exclude"
    users: ["admin", "family-member"]

Filter by Request Status¶

Only consider requests with specific statuses (pending, approved, declined):

exclude:
  seerr:
    mode: "exclude"
    request_status: ["approved"]

Include Pending Requests¶

Control whether pending (not yet approved) requests count:

exclude:
  seerr:
    mode: "exclude"
    include_pending: false  # Only protect approved requests

Minimum Request Age¶

Only consider requests older than a certain number of days. This gives users a window to watch before the protection expires:

exclude:
  seerr:
    mode: "exclude"
    min_request_age_days: 30  # Requests older than 30 days can be deleted

Protect Unwatched Requesters¶

Protect content that hasn't been watched by the person who requested it. This combines Overseerr request data with Tautulli per-user watch history -- if the requester hasn't watched the content yet, it's protected from deletion.

exclude:
  overseerr:
    protect_unwatched_requesters:
      enabled: true
      min_request_age_days: 90   # Grace period: always protect requests younger than 90 days
      max_protection_days: 365   # Expiry: allow deletion after 1 year regardless
      user_mapping:              # Optional: map Overseerr users to Tautulli users
        overseerr_user: tautulli_user

How it works:

1. When Deleterr considers deleting an item, it checks if the item was requested via Overseerr
2. If it was, it looks up the requester's Tautulli watch history
3. If the requester hasn't watched the content, the item is protected from deletion
4. If the requester has watched it, normal deletion rules apply

User matching: Deleterr automatically matches Overseerr users to Tautulli users via their Plex username. If your usernames differ between systems, use user_mapping to define the mapping manually.

Grace period: min_request_age_days always protects requests younger than this, regardless of watch status. This gives users time before the watch-check even kicks in.

Expiry: max_protection_days sets a hard limit. After this many days, the item can be deleted regardless of whether the requester watched it.

Post-Deletion: Update Status¶

When update_status is enabled, Deleterr marks deleted media in Seerr so it can be requested again:

exclude:
  seerr:
    mode: "exclude"
    update_status: true

Without this, deleted media still shows as "available" in Seerr and users can't re-request it.

Full Example¶

seerr:
  url: "http://localhost:5055"
  api_key: "YOUR_SEERR_API_KEY"

libraries:
  - name: "Movies"
    radarr: "Radarr"
    action_mode: "delete"
    last_watched_threshold: 90
    added_at_threshold: 180
    max_actions_per_run: 20
    exclude:
      seerr:
        mode: "exclude"
        include_pending: true
        request_status: ["approved", "pending"]
        update_status: true

  - name: "TV Shows"
    sonarr: "Sonarr"
    series_type: "standard"
    action_mode: "delete"
    last_watched_threshold: 90
    added_at_threshold: 180
    max_actions_per_run: 20
    exclude:
      seerr:
        mode: "exclude"
        users: ["admin"]
        min_request_age_days: 60
        update_status: true

Migrating from overseerr config key¶

If you're upgrading from a version that used the overseerr config key, your existing config will continue to work. Deleterr automatically migrates overseerr to seerr at startup with a deprecation notice. To silence the notice, rename your config keys:

# Before (still works, but deprecated)
overseerr:
  url: "http://localhost:5055"
  api_key: "YOUR_API_KEY"

# After (recommended)
seerr:
  url: "http://localhost:5055"
  api_key: "YOUR_API_KEY"

The same applies to library-level exclusions: rename exclude.overseerr to exclude.seerr.

Configuration Reference¶

See Configuration Reference for the full field reference.