Cleanarr
Cleanarr is a simple web UI for finding and deleting duplicate and sample files in Plex Media Server TV and Movie libraries.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
22/100 Low
- Maintained
- 0last commit 916 days ago
- Popular
- 49275 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
- Security check
- 201 serious finding, 1 minor, CI, tests
Based on 4 of 5 factors.
Security check: 1 serious finding
- Uses certifi 2023.7.22, which has a known critical vulnerability (PyPI)
Automated checks on commit 44b86ca, 3 Nov 2026. Not an audit.
Availability: platform listings confirmed today, links checked 51 days ago
- GitHub stars
- 275
- Open issues
- 35
- Last commit
- 2024-05-19
- License
- MIT
- Activity
- stale
Checked 20 days ago - source: GitHub (se1exin/cleanarr)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is not supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Plex Server Configuration Enable “Settings > Library > Allow media deletion” in your Plex server settings. A valid Plex authentication token (found under Plex account settings) is required for Cleanarr to access your library. source
- Plex setup Enable Allow media deletion in Plex Settings > Library, then provide a Plex token and the correct Plex base URL when configuring the container. source
- Docker run Mount a /config volume and set Plex base URL and token parameters. source
- Plex requirements Before first run, enable "Settings > Library > Allow media deletion" in your Plex server and have your Plex Token (found in Plex account preferences) ready, as both are required by Cleanarr. source
- Plex setup and Docker configuration Enable "Settings > Library > Allow media deletion" in Plex Server, obtain a Plex token, and mount a config volume for Docker use. source
- First-Install Setup Enable media deletion in Plex library settings and supply your Plex token plus Plex base URL when running Cleanarr. source
Fetched 5 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Do I need to enable media deletion in Plex before using Cleanarr?
Yes. Enable Settings > Library > Allow media deletion on your Plex server.
Which Docker environment variables are required to connect Cleanarr to Plex?
Set PLEX_BASE_URL to your Plex server address and PLEX_TOKEN to a valid Plex token.
What should I set if Cleanarr has SSL connection issues with a Plex server that requires secure connections?
Set BYPASS_SSL_VERIFY=1 to disable SSL certificate verification.
How do I avoid Plex timeouts while scanning large libraries?
Set PAGE_SIZE to a lower value so results load in smaller chunks.
Can Cleanarr scan more than one Plex library?
Yes. Set LIBRARY_NAMES to semicolon-separated library names; the default is Movies.
Answers sourced from github.com
Community
- Reddit (reddit)
- I made anotharr,calling it Tidiarr : r/selfhosted - Reddit (reddit)
- What are you using instead of Plex-Cleaner? : r/homelab - Reddit (reddit)
- r/selfhosted on Reddit: Would there be an interest in an *arr companion ... (reddit)
- yall might appreciate this : r/DataHoarder - Reddit (reddit)
- Can't wait till Cleanarr is ready!! : r/Softwarr - Reddit (reddit)
Collected 53 days ago - public community threads