supergamer1337 / media-cleaner

Media Cleaner is a simple CLI tool to clean up your media library based on your Overseerr requests and Tautulli history, written in Rust.

Media Cleaner

Media Cleaner is a simple CLI tool to clean up your media library based on your Overseerr requests and Tautulli history, written in Rust.

It was written to help me clean up my Plex library, but it should work for anyone with a similar setup. It's not perfect, but it works for me. (This project was written partly to help me learn Rust, so please don't judge me too harshly, though feedback is always welcome.)

Installation

Just download the latest release for your platform from the releases page.

Usage

Config

Make sure you have a config file in the same directory as the executable (or more specifically the root of the working directory when you launch it). It should be named config.yaml and look something like this (this was chosen instead of CLI arguments to make it easier for repeated use):

# The number of items to show in the list of items to select.
# Useful to limit if your terminal is small, as it can be quite buggy if the list doesn't fit.
# Default to 5 if not specified.
items_shown: 5
plex:
    url: https://YOUR_PLEX_URL
    token: YOUR_PLEX_TOKEN
overseerr:
    url: https://YOUR_OVERSEERR_URL
    api_key: YOUR_API_KEY
tautulli:
    url: https://YOUR_TAUTULLI_URL
    api_key: YOUR_API_KEY
sonarr: # If you don't use Sonarr, just leave this section out
    url: https://YOUR_SONARR_URL
    api_key: YOUR_API_KEY
sonarr_4k: # If you don't have a 4k Sonarr instance, just leave this section out
    url: https://YOUR_SONARR_4K_URL
    api_key: YOUR_API_KEY
radarr: # If you don't use Radarr, just leave this section out
    url: https://YOUR_RADARR_URL
    api_key: YOUR_API_KEY
radarr_4k: # If you don't have a 4k Radarr instance, just leave this section out
    url: https://YOUR_RADARR_4K_URL
    api_key: YOUR_API_KEY

All fields have to be filled in, except for Sonarr or Radarr (though if their root is listed, all values have to be filled). If both Sonarr and Radarr are missing, the program will give you an error, as it requires at least one of them to be active.

You can get your api keys from the respective applications. A simple search should help you find it. For the Plex token, you can follow this guide.

ALSO MAKE SURE CSRF IS TURNED OFF IN OVERSEERR.

Ignoring users

If you want to ignore a user (or multiple) simply add them to the ignored_users list in the config file. This is useful if you have a user that you don't want to remove media for, for example yourself. The user is matched by their Overseerr username, so make sure you use the same username in both places.

Example:

ignored_users:
    - MyUser
    - SomeOtherUser

Running the program

Once you have your config file, you can run the program with ./media-cleaner (or .\media-cleaner.exe on Windows). If nothing is shown immediately, you have to wait for it to finish all the requests to gather the appropriate data. Afterwards it will bring up a list of possible sorting options for your requests. After that it will instead show a list of all your requests, sorted in the way chosen, with the media data associated with that item (watch history, space, etc.), simply select the ones you want to remove (with space) and press enter. This will (after a confirmations screen) remove the request from Overseerr and tell Sonarr and Radarr to remove the show and its files.

Arguments

Arguments are used to either:

1. Speed up the process by skipping certain screens.
2. Change the behavior of the program.

Sorting

You can also pass an argument to the program to skip the sorting screen and go straight to the requests screen. The argument is the sorting method you want to use, and can be one of the following:

• -s: Sort by size
• -sa: Sort by size, in ascending order
• -n: Sort by name
• -nd: Sort by name, in descending order
• -t: Sort by media type

Getting a list of all media

By passing in the flag -C, the program will instead show a list of all media in your library, with the same information as the requests screen. This is useful if you want to see what media you have in your library, and what you can remove. Even though that item does not have a request associated with it. Otherwise it works the same as the "normal" requests screen.

Issues and PRs

You are welcome to open issues, but please be aware that this is a hobby project written to help me learn Rust, and as such have no ambitions to a) implement features I don't want (though you are free to open a PR and I'll have a look at it), and b) fix issues that don't plague me personally (unless I feel it is large enough to warrant a fix).

When it comes to PRs, I'm happy to accept them, but please be aware that I'm not a professional programmer (yet), so I might not be able to give you the best feedback. Similarly, it may take some time while I take the time to look at it.

License

This project is licensed under the MIT license. See the LICENSE file for more details.

media-cleaner's Issues

0: Empty list of items given to `MultiSelect`

Getting error

`Error:
0: Empty list of items given to MultiSelect

Location:
src\main.rs:30

Backtrace omitted. Run with RUST_BACKTRACE=1 environment variable to display it.
Run with RUST_BACKTRACE=full to include source snippets.`

Show how many episodes in the last season for a given series

When using -C, some requests are not shown

As stated in the title, if you use the option to show all media (-C), it may incorrectly show that there are no requests at times. This is most likely due to the merging of the the requests list, and media list.

Overseer API Error

Overseer version 1.32.5
media-cleaner-v0.1-linux-x64

Error: 
   0: error decoding response body: missing field `pageInfo` at line 1 column 75
   1: missing field `pageInfo` at line 1 column 75

Location:
   src/overseerr/api.rs:14

Backtrace omitted. Run with RUST_BACKTRACE=1 environment variable to display it.
Run with RUST_BACKTRACE=full to include source snippets.

Thanks for putting this together, excited to get it working and clean up my library!

Add more sorting options than just name (media type, size etc.)

Feature Request: Ignore requests from certain users

Hi,

First of all thank you so much for developing this. I have been looking for a tool to help me cull watched requests from my libary!

Would it be possible to add a list in the config for user to ignore? I would like to only see requests not made by me.

Jellyfin/Ombi Long Shot

I know it's not the actual purpose of this script, but is there any way this could be used for Jellyfin instead of Plex (which means no Tatulli either) and Ombi instead of Overseer? I'm going mad trying to script these things myself.

Thanks!

Calculate the total amount of space saved before deletion

Show how much space is saved during the confirmation step.

Fine grained configuration and user notice

Is it any plans to add more fine grained configuration to this project, like series to never delete, if someone started to watch the show, if any tags are set, send message to the user that the show is set for deletion and he can halt it if he wants to keep it for another x days.

Multiple Sonarr / Radarr instance

Hello!

First of all, thank you for your work!

Is it possible to define multiple Sonarr / Radarr instance-s in the config?

I have 3 Sonarr, 3 Radarr for 3 different "user groups", but 1 Overseer, 1 Tautilli, 1 Plex for request and media deduplication.

Or should i have 3 media-cleaner instance with different configurations?

Thank you again! ❤️

Should support usage with only Radarr or Sonarr, not require both.

Better error checking for API

The errors given by different response codes, should be given to the user in an appropriate way. That way it will be easier to debug/solve potential issues.

Change TMDB to use Plex instead. Thus minimizing reliance on other external systems.