agregarr-dev
Active fork of Agregarr: sync performance fixes, placeholder lifecycle improvements, and open upstream PRs. Docker image at bitr8/agregarr.
Automatically checked · GitHub checked 2026-11-17

Overview
Agregarr (bitr8 fork)
Agregarr builds Plex collections from TMDB, IMDb, Letterboxd, MDBList, Trakt, AniList, TVDB, and Plex label lists. It also draws overlays onto posters and creates Coming Soon placeholders for titles you don't have yet.
Upstream Agregarr has been quiet since April 2026. This fork carries on the work with fixes, new features, and releases every few weeks. I maintain it, and I've been contributing upstream for the last year or so. Docker releases use bitr8/agregarr.
Docs: bitr8.github.io/agregarr-guide
Already running Agregarr?
Swap one line in your compose file to move to the fork.
- image: agregarr/agregarr:latest
+ image: bitr8/agregarr:latest
Run docker compose up -d. The fork uses your existing config folder, so your collections, overlays, and settings stay where they are.
[!WARNING]
Still running
agregarr/agregarr? Switch to this image. Upstream's:latest(v2.4.2, March 2026) includesyoutube-search-without-api-key, a package npm pulled and flagged as malicious (MAL-2026-18270). It also runs on Node 20. Releases from this fork remove that package and include the Node, Express, axios, sharp, and Next.js security updates. See v2.12.1 and v2.12.3.
[!IMPORTANT]
Agregarr supports Plex Media Server 1.43.3.10861 and newer. Older builds contain actively exploited security vulnerabilities (CISA KEV: CVE-2026-96652, CVE-2026-96654, CVE-2026-96655, CVE-2026-96656), so the Plex Version health check turns red on them. TV edition placeholders need 1.43.3 or newer and stay off below that version. See Plex's security notice.
Docker
| Tag | What it tracks |
|---|---|
:latest | Stable releases. Recommended for most users. |
:2.13.0 (etc.) | Pinned to a specific release. |
:develop | Bleeding edge. Builds on every push to develop, may break. |
Release tags support amd64 and arm64 (Apple Silicon, RPi 4+). The :develop tag only supports amd64.
Compose example
services:
agregarr:
image: bitr8/agregarr:latest
container_name: agregarr
volumes:
- /path/to/config:/app/config
- /path/to/placeholder/movies:/data/movies # Optional: Coming Soon
- /path/to/placeholder/tv:/data/tv # Optional: Coming Soon
environment:
- TZ=Australia/Sydney
- PUID=1000 # Your host user ID (run `id -u`)
- PGID=1000 # Your host group ID (run `id -g`)
- UMASK=022
ports:
- 7171:7171
restart: unless-stopped
Replace the example paths with your own, run docker compose up -d, then open http://YOUR_HOST:7171 and sign in with Plex.
[!WARNING]
File permissions: Set
PUIDandPGIDto the user that owns your media directories. If you leave them out, the container runs as root and may create directories with restrictive permissions. That can break imports in Sonarr, Radarr, and other apps. On Unraid, usePUID=99andPGID=100.
The upstream docs still cover the general configuration, including services, collections, and overlays.
FlixPatrol collections need a Cloudflare solver for Networks Top 10 and streaming charts. The setup is under Integrations in the docs.
What the fork adds
The docs have a page for each feature.
- Collections: presets, Library Essentials, label collections, per-user targeting, filtered hubs, sort titles, and more sources.
- Cycle Lists: a single Home row that moves to the next list each time it syncs.
- Export and import: collection configs can move between instances as JSON.
- Overlays: conditions, extra template variables, colour scales, layout checks, and a live sync dashboard.
- Episode scanning: shows and seasons get resolution, HDR, Dolby Vision, and audio badges from their episode files.
- Maintainerr countdown: deletion countdowns appear on movie, show, and season posters using your own template.
- Coming Soon placeholders: trailers from TMDB or YouTube, download-status checks, folder naming options, and TV edition folders.
- Health checks: eighteen checks under Settings > About, plus muting and job history.
- Integrations: Cloudflare solvers, Tracearr, Seerr ignore patterns, and Sonarr-first episode dates.
- Settings and performance: details on the fork's extra settings and how it keeps syncs quick on big libraries.
Posterizarr can hand items back to Agregarr after an *arr import. It's off by default. See the Posterizarr integration guide.

You'll find each version's changes in the release notes.
Relationship to upstream
This fork wouldn't exist without upstream Agregarr.
It's still GPL-3.0 and reads upstream's config, so switching over only needs an image swap.
I've offered fixes back as PRs where they fit upstream.
Support
Use GitHub issues for bugs, feature requests, and new source requests.
Include the version shown under Settings > About and the relevant lines from config/logs/agregarr-YYYY-MM-DD.log. Fixes land on develop, then ship in the next release. Older releases don't get backports.
Found something exploitable? Use the private route in SECURITY.md, not a public issue.
Contributing
PRs are welcome. Read CONTRIBUTING.md first: agree on the scope in an issue, keep the PR to one concern, and test it against a real Plex server.
The docs take pull requests too, and every page has an edit button. See Contributing on the docs site.
Licence
GPL-3.0, same as upstream.
Credits
Built on Agregarr.
Thanks to Damienlee69 (label collections), Bergasha (season count template variables), Marcus Isdahl (Posterizarr integration), Rubeanie (show-poster countdown and the Seerr build), gh0st-runner (dynamic title prefix), and diblaze (the yt-dlp trailer search approach).