Skip to content
gh-wiki-init edited this page Aug 7, 2026 · 2 revisions

Unreal Custodian

Reclaim the Intermediate, Binaries, DerivedDataCache and cache folders your Unreal Engine projects and engines have been quietly hoarding — without touching anything you authored.

On two test machines: 96 projects / 224 GB reclaimable on macOS, and 539 projects / 14 engines / 2.0 TB reclaimable on a Windows machine that had 17 GB free.

Start here: Quickstart · How it decides what's safe: Safety-Model · Config format: Configuration · Common issues: FAQ · What's next: ROADMAP.md

Pages

  • Quickstart — install, first report, first cleanup
  • Safety-Model — disk pressure vs. age, the never-delete list, the engine-install rule, freshness measured two ways
  • Configuration — .ueclean.json reference
  • GUI — custodian.gui walkthrough
  • FAQ — Trash vs. --permanent, "why is my project skipped", Windows without Everything, symlinked plugins

Credits

Project discovery is built on Marshall's (@nocxr) Unreal Project Launcher — index-first discovery via Spotlight/Everything rather than a filesystem walk. See the README credits for the full story.

Clone this wiki locally