[RELEASE] MUMC - Multi-User Media Cleaner

[hieroglyph]

Multi-User Media Cleaner
MUMC (pronounced Mew-Mick) will query your Jellyfin server for the movies, tv episodes, audio tracks, and audiobooks in your libraries.
Then delete media items you no longer want taking up disk space.

Cool! How Do I Use This?
First download the latest release: MUMC v5

Then check out the MUMC wiki.


MUMC Features

• YAML configuration
  
• Conditional behaviors
  
  • Favorites
    
  • Whitetags
    
  • Blacktags
    
  • Whitelists
    
  • Blacklists
    

• Keep or delete based on days since media type played
  
• Keep or delete based on days since media type created
  
• Keep or delete based on conditional behaviors
  
• Keep Minimum Episodes
  
• Keep Minimum Played Episodes
  
• Pass in alternate configuration
  
• Dry-run mode
  
• Match to libraries by
  • Id
    
  • Path
    
  • Network Path
    

• Enable/Disable library queries for specific users
  
• Enable/Disable queries for specific conditional behaviors
  
• Customize console output color and formatting based on output type
  
• Run script directly with Python or
  
• Run script in docker container (WIP)
  

[vbs]

Wow, this looks awesome, great work!

[4e90gzwz4]

Hello,

Would it be possible to add an archive function instead of deletion?
For example I have a separate HDD for content I've already watched but want to keep for while.

Thanks!

[yetanothersuperhero]

This looks awesome! Are there any plans for sending the deletions to *arr?

[hieroglyph]

MUMC (Multi-User Media Cleaner) v5.11 Release

MUMC (pronounced Mew-Mick) will query your Jellyfin libraries for movies, tv episodes, audio tracks, and audiobooks. Then delete media items you no longer want taking up disk space.

Cool! How Do I Use This?

•  Install the latest release version.
  
• Customize your configuration yaml.
  
• Schedule MUMC to run periodically.
  
• Enjoy no longer worrying about how much disk space is left.
  

How MUMC works:

• Use filter_statements or filter_tags to tell MUMC how to query your libraries for potential media_items ready to be deleted.
  
  • filter_statements apply filters to specific media_types (e.g movies, episodes, audio, etc...).
    
  • filter_tags use tags to apply filters to specific media_items and their children (e.g. movie, series, season, episode, album, audio, etc...).
    
• Use behavioral_statements or behavioral_tags to tell MUMC how to compare a media_item between one or more users to determine if it satisfies the criteria to be kept or deleted.
  
  • behavioral_statements define the keep or delete criteria that applies to specific media_types (e.g movies, episodes, audio, etc...) and the specified conditional_behavior (favorited, whitetagged, blacktagged, whitelisted, and blacklisted).
    
  • behavioral_tags use tags define the keep or delete criteria that applies to specific media_items and their children (e.g. movie, series, season, episode, album, audio, etc...).
    
• Use the configuration builder/editor to select the desired combination of users and libraries.
  
  • Individually select users and libraries.
    
  • Select only users; all libraries automatically selected according to each user's access policy.
    
  • Select only libraries; selected libraries applied to all users according to each user's access policy.
    
  • Select nothing; all libraries selected for all users according to each user's access policy.
    
• Point MUMC to one or more instances of Radarr and Sonarr.
  
  • When a media_item is deleted from Jellyfin:
    
    • Unmonitor and/or Delete movies, series, and episodes for Radarr/Sonarr.
      
• Configure how MUMC treats remaining episodes:
  
  • Keep a minimum number of episodes regardless of played state.
    
  • Keep a minimum number of played episodes to ensure the "Next Up" functionality works properly.
    
  • Configure MUMC to keep or delete the remaining played episodes after the series has ended.
    
• Configure how MUMC matches a media_item to its blacklisted/whitelisted parent library:
  
  • byId
    
    • Default behavior.
      
  • byPath
    
    • Use when a library has subfolders that are blacklisted and subfolders that are whitelisted.
      
  • byNetworkPath
    
    • Use when a library has subfolders that are blacklisted and subfolders that are whitelisted.
      
    • All subfolders must have a network share path defined.
      

[hieroglyph]

This looks awesome! Are there any plans for sending the deletions to *arr?

Unmonitoring/Deleting movies, series, episodes from Radarr/Sonarr is implemented in latest released version of MUMC.

---

Hello,

Would it be possible to add an archive function instead of deletion?
For example I have a separate HDD for content I've already watched but want to keep for while.

Thanks!

Unfortunately there is no Jellyfin API endpoint to movie media_items from one location to another.