Repository navigation
Home
chodeus edited this page Oct 22, 2026
·
18 revisions
CHUB is a self-hosted web app that keeps a Plex library tidy. Point it at your Radarr, Sonarr, Lidarr, and Plex; it renames posters, finds duplicates, re-applies borders, searches for upgrades, cleans up orphaned files, and more — on a schedule or on demand.
Run it in Docker, open it in a browser, configure it once, then let it work.
New install? Follow these in order:
- Installation — get CHUB running in Docker (~10 min). Platform guides: Unraid · Bare metal.
- First Run — the setup wizard: choose a login, connect your instances, then enable modules.
- Modules — pick the chores you want, with a YAML snippet for each.
-
Configuration — the
config.ymlreference for fine-tuning.
Already running? See the UI Guide, Kometa Integration, and Webhooks. Extending CHUB? See the Developer Guide.
- Posters — renames to match ARR/Plex naming and applies them through Kometa or straight to Plex, optimizes file size, re-applies brand/holiday borders, pulls sets from Google Drive, cleans up orphans and stale copies. Also applies logos, square art, and backgrounds from local files or fanart.tv.
- Media — one search across every instance, finds duplicates and folder collisions, flags incomplete metadata, reports ARR↔Plex mismatches and nested folders, mirrors ARR tags into Plex labels, and shows library statistics.
-
Chores — 14 built-in modules (upgrade searches, rename sweeps, health checks, hardlink audits, Google Drive sync, Plex maintenance, etc.) run on hourly, daily, weekly, monthly or cron schedules, or on demand. The
fullimage adds a CL2K poster maker and a poster self-healer. - Webhooks — Sonarr/Radarr/Tautulli events trigger a poster job the moment a new item lands. CHUB can add its webhook to your *arrs for you.
- Not a Kometa replacement — Kometa manages Plex metadata and collections; CHUB manages poster files and media chores. They complement each other.
- Not for public internet — has an optional login and rate limiting, but no WAF/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 new UI. It auto-migrates a DAPS
config.ymlon load (config-shape only — no database or match-state carries over), so the app state starts fresh. See Configuration and Credits.
| Dashboard | Media | Posters |
|---|---|---|
![]() |
![]() |
![]() |
Open an issue at chodeus/chub/issues. Include the CHUB version (Settings → System, or GET /api/version), your image tag or install method, and the relevant log excerpt.
Next: Installation


