Repolode
Submit
iongpt

iongpt/boxarr

Automatically tracks weekly Box Office Mojo top-10 movies and adds them to your Radarr library.

View on GitHub
Stars
296
Forks
16
Open issues
2
Last commit
2 months ago

What is it?

Boxarr is a self-hosted tool that pulls the weekly box office top 10 from Box Office Mojo and checks each title against your Radarr library. Movies that are missing can be added automatically, so popular theatrical releases show up in your media collection without manual searching.

A web dashboard shows the current chart, each film's status in Radarr, and quality profile settings. Filters for genre, rating and release year control which films get added, and genre-based root folders can sort them into different directories. The region can be changed from the default US and Canada domestic chart to any Box Office Mojo area code.

Boxarr runs as a Docker container or a Python 3.10+ application, supports reverse proxies through a configurable URL base, and exposes a REST API. It requires Radarr v3.0 or later.

Key features

  • 01Fetches the weekly top 10 box office movies from Box Office Mojo.
  • 02Checks Radarr for existing movies and avoids duplicates.
  • 03Automatically adds trending movies with genre, rating and year filters.
  • 04Sorts movies into genre-based root folders.
  • 05Supports custom Box Office Mojo regions and a configurable scraper timeout.
  • 06Provides a web setup wizard, dashboard and REST API.

Use cases

  • Keeping a home media server stocked with recent theatrical hits without manual requests.
  • Building a historical library of films that were popular at release.
  • Following box office charts for a region outside the US and Canada.

Quick start

  1. 1

    Run the Docker container

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

    Open http://localhost:8888 and follow the setup wizard

  3. 3

    Enter your Radarr URL and API key, then save

Things to know

  • Requires a running Radarr instance (v3.0+) to add movies to.
  • Only tracks Box Office Mojo charts, so it covers mainstream releases only.

In collections

Self-hosted apps

Topics

#radarr#box-office#media-management#self-hosted#docker#automation

FAQ

What is boxarr?
Automatically tracks weekly Box Office Mojo top-10 movies and adds them to your Radarr library. Boxarr is a self-hosted tool that pulls the weekly box office top 10 from Box Office Mojo and checks each title against your Radarr library. Movies that are missing can be added automatically, so popular theatrical releases show up in your media collection without manual searching.
Is boxarr free to use? What license does it have?
boxarr is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is boxarr still maintained?
Updated within 6 months. The last commit to boxarr was on Aug 26, 2026.
What can I use boxarr for?
Keeping a home media server stocked with recent theatrical hits without manual requests. Building a historical library of films that were popular at release. Following box office charts for a region outside the US and Canada.
How do I install boxarr?
Run the Docker container: docker run -d --name boxarr -p 8888:8888 -v /path/to/config:/config ghcr.io/iongpt/boxarr:latest Open http://localhost:8888 and follow the setup wizard Enter your Radarr URL and API key, then save
Where can I get boxarr?
The source code and installation instructions are on GitHub: https://github.com/iongpt/boxarr

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects