faraon1979/mediacleanerr repository overview

⁠MediaCleanerr 🚀

MediaCleanerr is a self-hosted solution designed for intelligent storage management and automated cleanup of media libraries, built to integrate seamlessly with the most popular media managers and servers.

It integrates directly with Radarr and Sonarr to identify old or low-activity content and schedule smart deletions, helping you keep your media server optimized without constant manual intervention.

⁠✨ Key Features

• Intelligent Cleanup
  Define rules based on content age and monthly deletion limits.

• Visual Warnings
  Automatically modifies posters in Jellyfin / Emby by adding a red frame and custom text when content enters its countdown phase.

• Spanish Title Detection
  Automatic detection of Spanish titles for improved visual organization.

• Collection Protection
  Protect complete sagas and display the real number of downloaded files per collection.

• Modern Dashboard
  Dashboard with statistics about reclaimable space, deletion candidates, and protected content.

• Full Integration
  Compatible with Plex, Tautulli, Jellyfin, Emby, Overseerr, Jellyseerr, and Jellystat.

⁠🛠️ Quick Installation (Docker Run)

Run the container by replacing the local volume path with your own:

docker run -d \
  --name mediacleanerr \
  -p 6050:5000 \
  -v /PATH/TO/YOUR/DATA:/data \
  --restart unless-stopped \
  faraon1979/mediacleanerr:latest

Web access:

http://YOUR_SERVER_IP:6050

⁠📋 Recommended Setup (Docker Compose)

version: "3.8"

services:
  mediacleanerr:
    image: faraon1979/mediacleanerr:latest
    container_name: mediacleanerr
    ports:
      - "6050:5000"
    volumes:
      - /PATH/TO/YOUR/DATA:/data
    restart: unless-stopped

Start the service:

docker compose up -d

⁠⚙️ First Steps

1. Access the web interface:

   http://YOUR_SERVER_IP:6050
   

   Copy
2. Complete the Initial Setup Wizard.
3. Configure your Radarr and Sonarr API keys.
4. Define your limits and rules in the RULES section.

⁠ℹ️ Important Notes

• Port 6050 is the external port and can be changed if needed.
• Port 5000 is internal and must not be modified.
• Data is stored outside the container using volumes.
• This container does not include any media content.
• Suitable for home servers, NAS systems, and VPS setups.

⁠🧑‍💻 Maintenance

Image maintained by faraon1979