Blockbusterr

[!IMPORTANT] Blockbusterr v2 is available for public beta testing. Read the v2 documentation and v2.0.0-beta.2 release notes. Use latest-beta to follow beta updates; the stable latest image remains on v1.

Automate your media library with smart content discovery from TMDB, Simkl, or Trakt.

Blockbusterr automatically adds trending, popular, and highly-rated movies and TV shows to your Radarr/Sonarr library. Choose a discovery source per job, configure once, and let it run on a schedule.

Documentation

Full documentation available at blockbusterr.dev

• Quick Start Guide
• Installation Methods
• Configuration
• Jobs Overview
• Filters & Scoring
• Real-World Examples
• API Reference

Quick Start

Get running in 60 seconds:

docker run -d \
  --name blockbusterr \
  -p 9090:9090 \
  -v $(pwd)/data:/app/data \
  ghcr.io/mahcks/blockbusterr:latest

Then open http://localhost:9090 and configure your services.

→ Full Quick Start Guide

Features

• 17 Job Types - Trending, popular, anticipated, favorited, box office, and more
• Multiple Discovery Sources - Use TMDB, Simkl, or Trakt per job
• Smart Filtering - Genre, certification, runtime, year, language, country, keywords
• Weighted Scoring - Combine IMDb, Trakt, TMDB, and Metacritic ratings
• Two Integration Modes - Direct to Radarr/Sonarr or via Jellyseerr for approval
• Activity Tracking - See what was added, when, and why with visual logs
• Job Preview - Test configurations before enabling to avoid surprises
• Unified Dashboard - Manage movies and TV shows in one place
• Smart Jobs - Adaptive scoring that balances popularity with quality

📸 Screenshots

Dashboard & Configuration

Job Preview & Management

Activity Log

Why Blockbusterr?

The Problem: Managing Trakt lists in Radarr/Sonarr is tedious - configure each list separately, no filtering, no limits, no unified tracking.

The Solution: One dashboard to rule them all. Set filters once, configure jobs with limits, see everything that's added in one activity log.

Use Cases

• Family Server - Block R-rated content, require G/PG/PG-13 only
• Quality Curator - Only add movies scoring 80+, minimum 50k IMDb votes
• Genre Specialist - Sci-fi and fantasy only, no comedies or romance
• Completionist - Add everything trending with minimal filtering

→ See Real-World Examples

Installation

Docker Compose (Recommended):

version: '3.8'
services:
  blockbusterr:
    image: ghcr.io/mahcks/blockbusterr:latest
    container_name: blockbusterr
    ports:
      - "9090:9090"
    volumes:
      - ./data:/app/data
    environment:
      - TZ=America/New_York
    restart: unless-stopped

Other methods: Binary, from source, with full stack → Installation Guide

Configuration

Blockbusterr can be configured via:

• Web UI - http://localhost:9090 (easiest)
• config.yaml - Mount as volume or edit in container
• Environment Variables - For Docker deployments

→ Configuration Guide

How It Works

1. Jobs run on schedule (cron) - e.g., "Trending Movies" every 6 hours
2. Fetch content from your selected source - TMDB, Simkl, or Trakt
3. Apply filters - Genre, rating, runtime, certification, language
4. Calculate scores - Weighted average of IMDb/Trakt/TMDB ratings
5. Check threshold - Only content scoring above threshold proceeds
6. Add to library - Direct to Radarr/Sonarr or create Jellyseerr request
7. Log activity - Track what was added with posters and metadata

→ Learn About Jobs | → Filters & Scoring

Contributing

Contributions welcome! Please open an issue or PR.

Development:

git clone https://github.com/mahcks/blockbusterr.git
cd blockbusterr
make dev

Community

Join our Discord for support, questions, and discussion:
https://discord.com/invite/c8vb3VZqmg

License

MIT License - see LICENSE file for details.

Support

If Blockbusterr saves you time, consider giving it a star!

*Made for the arr community