Skip to content
Blockbusterr

Integration Modes

Blockbusterr supports two integration modes for adding content to your library.

Quick Comparison

Section titled “Quick Comparison”

Direct Mode

Recommended for Single Users

Fully automated - Content added immediately to Radarr/Sonarr without approval.

Best for: Personal servers, solo users, complete automation

Jellyseerr Mode

Recommended for Multi-User

Request-based - Content creates Jellyseerr requests requiring approval.

Best for: Family servers, shared libraries, curated collections

Direct Mode

Section titled “Direct Mode”
Automation Single User

Content is added directly to Radarr and Sonarr without any approval workflow.

How It Works

Section titled “How It Works”
graph LR
    A[Job Runs] --> B[Content Found]
    B --> C[Passes Filters]
    C --> D[Added to Radarr/Sonarr]
    D --> E[Auto Search & Download]
  1. Job runs on schedule (e.g., daily at midnight)
  2. Content found from Trakt (trending, popular, etc.)
  3. Filters applied - reject low-rated or unwanted content
  4. Directly added to Radarr/Sonarr
  5. Auto-search starts immediately

Configuration

Section titled “Configuration”
integration:
  mode: "direct"


radarr:
  enabled: true
  url: "http://radarr:7878"
  api_key: "your_radarr_api_key"
  quality_profile_id: 1
  root_folder: "/movies"


sonarr:
  enabled: true
  url: "http://sonarr:8989"
  api_key: "your_sonarr_api_key"
  quality_profile_id: 1
  root_folder: "/tv"

Pros & Cons

Section titled “Pros & Cons”

✅ Pros

  • Fully automated, zero manual work
  • Faster content acquisition
  • Simpler setup (no Jellyseerr needed)
  • Direct control over Radarr/Sonarr settings
  • Perfect for trusted filters

❌ Cons

  • No approval workflow
  • Can’t manually review before adding
  • Not ideal for shared servers
  • No user request tracking
  • Less control over disk usage

Use Cases

Section titled “Use Cases”

Scenario: Single user with trusted filters.

jobs:
  curated_movies:
    type: "movie"
    list_type: "trakt_popular"
    fetch_count: 50
    threshold_score: 75  # High bar
    schedule: "0 0 * * 0"  # Weekly

Result: 10-15 high-quality movies added automatically every week.

Jellyseerr Mode

Section titled “Jellyseerr Mode”
Multi-User Approval

Content creates requests in Jellyseerr which require approval before being sent to Radarr/Sonarr.

How It Works

Section titled “How It Works”
graph LR
    A[Job Runs] --> B[Content Found]
    B --> C[Passes Filters]
    C --> D[Request Created in Jellyseerr]
    D --> E[Admin Approves]
    E --> F[Jellyseerr → Radarr/Sonarr]
    F --> G[Auto Search & Download]
  1. Job runs and finds content
  2. Filters applied - basic quality check
  3. Request created in Jellyseerr
  4. Admin approval required (or auto-approved based on Jellyseerr settings)
  5. Jellyseerr sends to Radarr/Sonarr
  6. Download starts

Configuration

Section titled “Configuration”
integration:
  mode: "jellyseerr"


jellyseerr:
  enabled: true
  url: "http://jellyseerr:5055"
  api_key: "your_jellyseerr_api_key"

Pros & Cons

Section titled “Pros & Cons”

✅ Pros

  • Manual review before adding
  • Request tracking and history
  • Multi-user support with quotas
  • Can deny bad suggestions
  • Better disk space control
  • User request management

❌ Cons

  • Requires manual approval (unless auto-approve)
  • Extra service to maintain (Jellyseerr)
  • Slightly more complex setup
  • Slower content acquisition
  • Jellyseerr configuration needed

Use Cases

Section titled “Use Cases”

Scenario: Multiple family members using Plex/Jellyfin.

integration:
  mode: "jellyseerr"


jobs:
  family_friendly:
    type: "movie"
    threshold_score: 65
    schedule: "0 8 * * *"

In Jellyseerr:

  • Kids have 5 requests/week
  • Parents can auto-approve
  • All requests tracked

Choosing the Right Mode

Section titled “Choosing the Right Mode”

Choose Direct Mode if:

  • ✅ You’re the only user
  • ✅ You trust your filters completely
  • ✅ You want maximum automation
  • ✅ You have large storage capacity
  • ✅ You don’t want to review requests

Choose Jellyseerr Mode if:

  • ✅ Multiple users share your server
  • ✅ You want to review before adding
  • ✅ Storage is limited
  • ✅ You run a curated library
  • ✅ You need request tracking

Switching Modes

Section titled “Switching Modes”

To switch from Direct → Jellyseerr:

  1. Update config.yaml to mode: "jellyseerr"
  2. Add Jellyseerr configuration
  3. Restart Blockbusterr
  4. Future jobs will create Jellyseerr requests

To switch from Jellyseerr → Direct:

  1. Update config.yaml to mode: "direct"
  2. Add Radarr/Sonarr configuration
  3. Restart Blockbusterr
  4. Future jobs will add directly

Next Steps

Section titled “Next Steps”

Configure Jellyseerr

Set up Jellyseerr integration

Configure Radarr

Set up Radarr for movies

Configure Sonarr

Set up Sonarr for TV shows

Create Jobs

Set up automated jobs