Skip to content

Cleaner

Cleaner (nav label for Library Maintenance) is the admin toolkit for finding and removing unwanted library media. Enable it under Settings when the maintenance feature flag is available, then open Cleaner in the nav.

Sections

SectionPurpose
OverviewHigh-level maintenance status and insights
ExclusionsTitles or libraries that rules should skip
RulesDefine keep / remove criteria
CollectionsCollection-aware maintenance helpers
CandidatesItems matching rules, ready for review
CalendarSchedule-oriented maintenance view
Storage MetricsSpace and library size context
Rule LibraryReusable rule templates
Cleaner SettingsFeature configuration
LogsRun history and diagnostics

Typical workflow

  1. Configure exclusions for anything that must never be touched.
  2. Create or pick rules from the rule library.
  3. Review Candidates before acting.
  4. Run cleanup and check Logs for what changed.

Cleaner is separate from ColleXions (which builds Plex collections) and Upgrader (which improves file quality through ARR).

Built for the self-hosting community.