Self-host boxarr
v2.1.0Automated box office tracking for Radarr
- Stars
- 295
- CPU
- Any x86_64 or ARM64
- RAM
- 256MB minimum
- Storage
- 100MB+ for application and data
- Port
- 8888 (Web interface and API)
- Requires
- Radarr
ghcr.io/iongpt/boxarr
What is boxarr?
This application tracks weekly box office charts from Box Office Mojo and connects with Radarr to add trending theatrical releases to your media library automatically. A responsive web dashboard displays the current top 10 movies with their Radarr status, and quality profiles can be managed through the interface. The software supports automatic movie additions with customizable filters for genre, age rating, language, and minimum weekend gross. Scheduled weekly updates, genre-based folder organization, quality upgrade buttons, and a REST API are also included. Deployment options cover Docker, Docker Compose, manual Python installation, Kubernetes with Helm, and systemd on Linux. Radarr v3.0 or newer and connectivity to Box Office Mojo are required. The interface offers Dark, Light, and Auto theme modes and functions on mobile browsers. No built-in authentication exists, so the tool is intended for trusted local networks only.
Should you self-host boxarr?
boxarr scores 49/100 on selfhost.directory (how scoring works) and ranks #70 of 142 in Media Management. It has 295 GitHub stars.
It shipped 9 stable releases in the past year. The latest, v2.1.0, came out on 26 August 2026. New versions land roughly every 2 days.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Python.
Its closest alternative on selfhost.directory is Reclaimerr (52/100, 571 stars). It scores higher overall, so compare the two before you pick. See boxarr vs Reclaimerr side by side.
Features
- Advanced Custom Filtering
- Auto-add movies
- Auto-Tagging
- Dark/Light/Auto Theme Support
- Genre-based root folders
- Language Filter
- Minimum Weekend Gross Filter
- Quality profile management
- Quality Upgrade Buttons
- REST API
- Scheduled Updates
- Web-based Configuration Wizard
- Weekly Box Office Tracking
boxarr README
FAQ
Can I use the API?
Yes, Boxarr provides a full REST API. Documentation is available at http://localhost:8888/api/docs.
Is there a mobile app?
No dedicated mobile app, but the web interface is fully responsive and works well on mobile devices.
Can I change the theme?
Yes, Boxarr supports Dark, Light, and Auto (follows system preference) themes. Go to Settings → UI → Theme to switch.
How should I access Boxarr remotely?
Use a VPN (recommended), reverse proxy with authentication (nginx basic auth), or SSH tunnel for secure remote access.
Is Boxarr designed for internet exposure?
No, Boxarr is designed for local network use only. It has no built-in authentication, no user management, no encryption, and HTTP only.
Can I track box office for a country other than the US?
Yes, set the Box Office Region in Settings to any supported country to fetch that country's Box Office Mojo weekend chart.
How much storage does Boxarr need?
Application ~50MB, configuration ~10MB, weekly data ~1MB per week, logs ~50MB rotating. Total recommended: 200MB minimum.
Can I run multiple instances?
Yes, you can run multiple Boxarr instances by using different config directories and port mappings.
Which installation method should I use?
Docker is recommended for most users. Docker Compose for home servers. Manual for development.
What data source does Boxarr use?
Boxarr fetches box office data from Box Office Mojo, which provides weekly top 10 rankings and revenue information.
Is Boxarr free?
Yes, Boxarr is completely free and open source under the GPL v3 license.
Do I need Radarr to use Boxarr?
Yes, Radarr v3.0+ is required as Boxarr is a companion tool that extends Radarr's functionality.
What is Boxarr?
Boxarr is an automated tool that tracks weekly box office data and integrates with Radarr to help you maintain a current movie library with trending films.
More in Media Server
Broadcast BoxSelf-hosted WebRTC broadcast server for real-time video streaming. Replace Twitch/Youtube live streaming with sub-second latency via WHIP/WHEP protocols.
cabernetCabernet is a self-hosted, open-source IPTV platform organizing Pluto TV, XUMO, and M3U/XMLTV streams for Plex, Emby, Jellyfin, and TVheadend.
CalendarrSelf-hosted Docker container that fetches TV show and movie release calendars from Sonarr and Radarr and posts scheduled notifications to Discord and Slack via webhooks.
Calibre Web AutomatedSelf-hosted ebook library with automated ingest, conversion, metadata, and KOReader sync. Combines Calibre-Web UI with Calibre power.
camkeepA lightweight, self-hosted Network Video Recorder (NVR) designed for home NAS and edge devices.
ChannelHoarderSelf-hosted, open-source tool that watches channels on multiple video sites and saves new uploads in a Plex-friendly layout with a modern web UI.
ChannelWatchSelf-hosted, open-source monitor for Channels DVR tracking live TV, recordings, disk space, and server health with multi-DVR support.
checkrrSelf-hosted, open-source tool that scans media libraries for corrupt files and automatically requests replacements via Sonarr, Radarr, or Lidarr.
chimeraSelf-hosted web app to remotely install GOG, Epic, and Flathub games, upload ROMs for 20+ emulators, and control system actions on Linux gaming machines.
CinephageA single self-hosted app that manages movies, series, live TV, and streaming — replacing Radarr, Sonarr, Prowlarr, Bazarr, Overseerr, and FlareSolverr.
cli_debridSelf-hosted media automation that scrapes torrents/Usenet, uses debrid services, and organizes libraries for Plex/Jellyfin/Emby with auto quality upgrades.
CliparrSelf-hosted, open-source tool that clips video from Plex, Jellyfin, or local files directly in your browser — no server-side FFmpeg needed.
0 comments