[RELEASE] MUMC - Multi-User Media Cleaner

[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.