Home

CHUB — Chodeus' Media Script Hub

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.

ℹ️ Note on this documentation: These wiki pages are AI-drafted (with Anthropic's Claude) against the actual source and human-reviewed before they land. If a page disagrees with the app, trust the code and please open an issue.

🚀 Where to start

New install? Follow these in order:

1. Installation — get CHUB running in Docker (~10 min). Platform guides: Unraid · Bare metal.
2. First Run — create the admin user, connect your instances, enable modules.
3. Modules — pick the chores you want, with a YAML snippet for each.
4. Configuration — the config.yml reference for fine-tuning.

Already running? See the UI Guide, Kometa Integration, and Webhooks. Extending CHUB? See the Developer Guide.

What CHUB does

• Posters — renames to match ARR/Plex naming, optimizes file size, re-applies brand/holiday borders, pulls sets from Google Drive, cleans up orphans. Also applies logos, square art, and backgrounds from Google Drive or fanart.tv.
• Media — finds duplicates via fuzzy title matching, flags low-rated or incomplete items, inline metadata editing with an audit trail, batch import into Radarr/Sonarr.
• Chores — 14 built-in modules (upgrade searches, rename sweeps, health checks, hardlink audits, Google Drive sync, Plex maintenance, etc.) run on cron/interval or on demand.
• Webhooks — Sonarr/Radarr/Tautulli events trigger poster and cleanup jobs the moment a new item lands.

What CHUB is not

• 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 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.yml on load (config-shape only — no database or match-state carries over), so the app state starts fresh. See Configuration and Credits.

Screenshots

Dashboard	Media	Posters

Need help?

Open an issue at chodeus/chub/issues. Include the CHUB version (GET /api/version), your install method, and the relevant log excerpt.

---

Next: Installation