Skip to content
chodeus edited this page Oct 22, 2026 · 18 revisions
CHUB — Chodeus' Media Script Hub. Media management for Plex + ARR.

MIT License Python Docker Image

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.

🚀 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 — the setup wizard: choose a login, connect your instances, then 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 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 full image 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.

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 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.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
Dashboard Media Posters

Need help?

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

Clone this wiki locally