Home
CHUB is a self-hosted web app that keeps a Plex library tidy. Point it at your Radarr, Sonarr, Lidarr, and Plex, and it takes care of the boring chores: renaming posters, finding duplicates, re-applying borders, searching for quality upgrades, cleaning up orphaned files, and more.
You run it in Docker, open it in a browser, configure it once, and then let it work on a schedule.
If you're installing for the first time, follow these in order:
- Installation — get CHUB running in Docker (10 minutes). Unraid and bare-metal alternatives: Unraid · Bare metal.
- First Run — admin user, instance connections, module enablement, schedule.
- Modules — pick which chores you want, with a YAML snippet for each.
Once CHUB is running:
- UI Guide — what every page in the app does.
-
Kometa integration — align Kometa +
poster_renamerrso posters flow end-to-end. - Webhooks — trigger CHUB from Sonarr / Radarr / Tautulli.
- Troubleshooting · FAQ · Credits.
Scripting against CHUB or extending it? See the Developer Guide.
Keeps posters tidy. Renames them to match your ARR/Plex naming, batch-optimizes file size, re-applies brand or holiday borders, pulls new ones from Google Drive, and cleans up orphans.
Keeps media tidy. Finds duplicates with fuzzy title matching, flags low-rated or incomplete items, lets you edit metadata inline with a full audit trail, and batch-imports into Radarr or Sonarr.
Runs chores on a schedule. Thirteen built-in modules (upgrade searches, rename sweeps, health checks, hardlink audits, Google Drive sync, Plex maintenance, etc.) run on cron or interval — or on demand from the dashboard.
Reacts to your ARR stack. Webhooks from Sonarr/Radarr/Tautulli trigger poster rename and cleanup jobs the moment a new item lands, so you don't wait for the next scheduled run.
- Not a replacement for Kometa. Kometa manages Plex metadata and collections; CHUB manages poster files and media chores. They complement each other.
- Not for public internet exposure. CHUB has built-in login and rate limiting, but no WAF or DDoS protection. Keep it on a LAN or behind a VPN / reverse proxy.
- Not a DAPS upgrade. CHUB is a fork of DAPS with a refreshed UI and extra audit work. There's no data migration — it's a clean install. See Credits.
| Dashboard | Media | Posters |
|---|---|---|
 |
 |
 |
Open an issue at chodeus/chub/issues. Include the CHUB version (shown in Settings → Interface, or GET /api/version), your install method, and the relevant log excerpt.