Quick Start

Get Blockbusterr up and running in 3 simple steps.

Prerequisites

Docker

Docker installed on your system

Trakt Account

Free account at trakt.tv

*arr Stack

Radarr/Sonarr (optional for testing)

Step 1: Launch Blockbusterr

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

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

Then run:

docker-compose up -d

version: '3.8'

networks:
  media:

services:
  blockbusterr:
    image: ghcr.io/mahcks/blockbusterr:latest
    container_name: blockbusterr
    networks:
      - media
    ports:
      - "9090:9090"
    volumes:
      - ./data:/app/data
    restart: unless-stopped

  radarr:
    # ... radarr config
    networks:
      - media

  sonarr:
    # ... sonarr config
    networks:
      - media

Verify it’s running:

docker logs blockbusterr

You should see output indicating the server started on port 9090.

Step 2: Create Trakt Application

Go to Trakt API Applications
Fill in the application details:
- Name: Blockbusterr
- Redirect URI: urn:ietf:wg:oauth:2.0:oob
- Permissions: /checkin, /scrobble
Click Save App and copy your Client ID and Client Secret

Navigate to http://localhost:9090 and fill in:

Trakt Client ID & Client Secret (from Step 2)
Click Authorize Trakt to connect your account
Configure Radarr/Sonarr URLs and API keys (optional)

Create data/config.yaml:

trakt:
  client_id: "your_client_id"
  client_secret: "your_client_secret"

# Optional: Add *arr integrations
radarr:
  api_url: "http://radarr:7878"
  api_key: "your_radarr_api_key"

sonarr:
  api_url: "http://sonarr:8989"
  api_key: "your_sonarr_api_key"

Restart the container:

docker restart blockbusterr

What’s Next?

Set Up Scoring

Configure how movies/shows are scored

Configure Filters

Define what content to block or allow

Create Jobs

Automate your library management

Step 2: Configure Integrations

Open your browser and navigate to http://localhost:9090
Connect Trakt (Required)
- Via Web UI
- Via Config File
1. Click Configuration tab
2. Scroll to Trakt section
3. Enter your Client ID and Client Secret (Get them here)
4. Click “Authorize with Trakt”
5. Log in to Trakt and approve
OAuth Complete
Edit config/config.yaml:
trakt: client_id: "your_client_id" client_secret: "your_client_secret"
Then authorize via the Web UI to get tokens.

Connect Radarr (Optional)

radarr:
  enabled: true
  url: "http://radarr:7878"  # Use container name
  api_key: "your_radarr_api_key"
  quality_profile_id: 1
  root_folder: "/movies"

radarr:
  enabled: true
  url: "http://radarr:7878"
  api_key: "your_radarr_api_key"
  quality_profile_id: 4  # HD-1080p
  root_folder: "/movies"
  search_on_add: true      # Auto search
  monitored: true          # Auto monitor
  minimum_availability: "released"

Availability Options:

announced - As soon as announced
inCinemas - When in theaters
released - When available (recommended)
preDB - Before public release

Click “Test Connection” in the UI

Or via API:

curl "http://localhost:9090/v1/radarr/validate"

Expected response:

{
  "valid": true,
  "message": "Connection successful",
  "version": "4.7.5"
}

Connect Sonarr (Optional) - Similar to Radarr setup

Step 3: Configure Your First Job

Choose a Job Type

Trending

What’s hot right now
Best for: Current buzz

Popular

Most watched this week
Best for: Mainstream hits

Smart Popular

Adaptive rating thresholds
Best for: Balanced quality

Configure with Filters

Start conservative - high quality only:

jobs:
  trending_movies:
    enabled: true
    schedule: "0 */6 * * *"
    limit: 10
    filters:
      min_rating: 7.0
      min_votes: 2000

~5-8 movies per run

Balanced quality and quantity:

jobs:
  trending_movies:
    enabled: true
    schedule: "0 */6 * * *"
    limit: 20
    filters:
      min_rating: 6.5
      min_votes: 1000
      exclude_genres: ["Documentary"]
      include_languages: ["en"]

~12-16 movies per run

Full control with scoring:

jobs:
  smart_popular_movies:
    enabled: true
    schedule: "0 */6 * * *"
    limit: 25
    base_min_rating: 7.0
    adjustment_factor: 2.0
    filters:
      min_votes: 1000
      min_year: 2020
      max_runtime: 180
      exclude_genres: ["Documentary", "Reality"]
      include_countries: ["us", "gb", "ca"]
    scoring:
      rating_weight: 0.5
      popularity_weight: 0.4
      recency_weight: 0.1

~18-23 movies per run

Preview Before Enabling
- Via Web UI
- Via API
1. Go to Jobs tab
2. Click “Preview” button
3. Review what would be added
4. Check filter reasons for rejected items
5. Adjust filters if needed
Terminal window
curl -X POST http://localhost:9090/v1/jobs/preview/trending-movies
Get only items that will be added:
Terminal window
curl -s -X POST http://localhost:9090/v1/jobs/preview/trending-movies \ | jq '.items[] | select(.filtered_out == false and .already_exists == false)'
Enable and Monitor
- Save your configuration
- Enable the job
- Check the Activity tab to see what gets added

What’s Next?

Learn about different job types
Configure advanced filters and scoring
Set up smart jobs for adaptive content discovery
Explore the API reference

Troubleshooting

Container won’t start?

Check Docker logs: docker logs blockbusterr
Ensure port 9090 is not already in use

Can’t connect to Radarr/Sonarr?

Verify the URL is accessible from within the Docker container
Use container names if using Docker networking (e.g., http://radarr:7878)
Check API keys are correct

Jobs not running?

Verify the job is enabled in the configuration
Check the schedule format is valid (cron syntax)
View logs for errors