Boxarr - Box Office Tracking for Radarr

Automatically track and add trending box office movies to your Radarr library

Boxarr monitors weekly box office charts and seamlessly integrates with Radarr to ensure your media library always has what people want to watch. No more manual searching for popular movies - Boxarr handles it automatically.

🎯 Why Boxarr?

• Stay Current - Never miss trending movies that everyone's talking about
• Save Time - No more manually searching for and adding popular films
• Smart Automation - Automatically add movies based on your preferences
• Family Friendly - Keep your media server stocked with what people actually want to watch

🤔 Why Not Seerr?

Seerr is excellent for request-based libraries where users actively request content. Boxarr serves a different purpose:

• Automatic vs Request-Based: Boxarr automatically adds mainstream hits without anyone having to request them
• Box Office Focus: Tracks actual commercial success, not just user requests
• Zero User Interaction: Works silently in the background, no user accounts or requests needed
• Complementary Tool: Use both! Seerr for specific requests, Boxarr for mainstream coverage

📋 Why Not Radarr Lists?

While Radarr lists are useful, Boxarr offers unique advantages:

• Box Office = Mainstream Appeal: Tracks movies with proven commercial success, ensuring broad appeal
• Unbiased Selection: Based on actual revenue data, not curator preferences or ratings
• Weekly Updates: Fresh data every week, not dependent on list maintainer updates
• Duplicate Prevention: Uses Radarr API to check existing movies before adding
• Historical Tracking: Build a library of movies that were culturally significant at release

Boxarr ensures your library includes the mainstream movies that dominated theaters - the films people are most likely to want to watch.

📚 Documentation

View the full documentation in our Wiki for detailed guides, configuration options, and troubleshooting.

✨ Key Features

• 📊 Weekly Box Office Tracking - Automatically fetches top 10 movies from Box Office Mojo
• 🔄 Radarr Integration - Seamlessly checks and adds movies to your library
• 🗂️ Genre‑Based Root Folders - Organize movies into folders by genre
• ⚡ Auto-Add Movies - Automatically add trending movies with smart filters
• 🔍 Advanced Custom Filtering - Fine-tune selections with genre, rating, and release year filters
• 📅 Scheduled Updates - Runs weekly on your preferred schedule
• 🎨 Beautiful Web UI - Clean, responsive interface for all devices
• 🚀 Easy Setup - Simple web-based configuration wizard

📋 Requirements

• Radarr v3.0+ (required)
• Docker (recommended) or Python 3.10+
• Network access to Box Office Mojo

🚀 Quick Start

Docker (Recommended)

docker run -d \
  --name boxarr \
  -p 8888:8888 \
  -v /path/to/config:/config \
  ghcr.io/iongpt/boxarr:latest

Visit http://localhost:8888 and follow the setup wizard.

Docker Compose

version: '3.8'

services:
  boxarr:
    image: ghcr.io/iongpt/boxarr:latest
    container_name: boxarr
    ports:
      - 8888:8888
    volumes:
      - ./config:/config
    restart: unless-stopped
    environment:
      - TZ=America/New_York  # Optional: Set your timezone

View full installation guide →

⚙️ Initial Setup

1. Open your browser to http://localhost:8888
2. Enter your Radarr URL and API key
3. Configure quality profiles and preferences
4. Save and start tracking!

View detailed setup guide →

📖 Configuration & Features

• Box Office Tracking - How weekly tracking works
• Configuration Guide - All settings explained
• Auto-Add Movies - Automatic movie additions with filters
• Genre-Based Root Folders - Smart content organization
• API Reference - REST API documentation

🔧 Advanced Configuration

Reverse Proxy Support

Boxarr can run behind reverse proxies (nginx, Traefik, Caddy) with custom URL base support.

environment:
  - BOXARR_URL_BASE=boxarr  # Access at /boxarr/

View reverse proxy setup guide →

API Access

Boxarr provides a REST API for integration and automation.

• Full API Reference →

📸 Screenshots

Dashboard View

Weekly Box Office

🆘 Help & Support

• Documentation Wiki - Full documentation
• FAQ - Frequently asked questions
• Troubleshooting Guide - Common issues and solutions
• GitHub Discussions - Community support
• Report Issues - Bug reports and feature requests

Contributing

We welcome contributions! Please see our Contributing Guide for guidelines.

License

GNU General Public License v3.0 - see LICENSE for details.

Acknowledgments

• Radarr for the excellent movie management platform
• Box Office Mojo for box office data
• The self-hosting community for inspiration and feedback

Disclaimer

This project is not affiliated with Box Office Mojo, IMDb, or Radarr. It's an independent tool created for personal media management.

Made with ❤️ for the self-hosting community