Blockbusterr

Automate your media library with smart content discovery from Trakt.

Blockbusterr automatically adds trending, popular, and highly-rated movies and TV shows from Trakt to your Radarr/Sonarr library. Configure once, let it run on a schedule, and never manually manage Trakt lists again.

---

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
• 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.

Feature	Manual Trakt Lists	Blockbusterr
Setup	Configure in each *arr app	One unified dashboard
Limits	All or nothing	Top N items per job
Filters	None	Genre, rating, runtime, language, etc.
Activity Log	Check each app separately	Unified log with posters
Preview	No preview capability	Test before enabling

---

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 Trakt - Trending, popular, anticipated, etc.
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