Skip to content
StudioNirin edited this page Dec 2, 2025 · 26 revisions

PlexCache-R Home

Welcome to the PlexCache wiki! This is your ultimate resource for understanding and making the most out of the PlexCache Python scripts, a little but powerful tool to automate your Plex media management.

Need Assistance?

This project has been designed and tested for Unraid. Though I've made a lot of alterations and improvements, so all the edge-cases have almost certainly not been ironed out yet. Please leave a post in 'Issues' and let me know if anything breaks or throws an error.

It might work on other linux-based systems, and maybe even other operating systems, but I haven't tested any of it. If you do test it yourself, and come across any issues, let me know and I'll see what I can do to improve things. No guarantees though, I'm more focused on the Unraid implementation for now.

AlienTech42 has already done a really helpful video on the original PlexCache installation, and for now it's the best video-based resource. The install process is pretty much the same for PlexCache-R. However there are some settings in the setup.py that are either in a different place, or are completely removed/altered/added. So don't follow the video religiously! This Wiki now has full written instructions and descriptions of all the current settings and options (which didn't exist when this video was made). https://www.youtube.com/watch?v=9oAnJJY8NH0

Start Here

To get started, explore the following pages in the wiki:

Step 1: Configure the script:

Running the Setup Script and generating your plexcache_settings.json file.

Step 2: Run PlexCache-R:

There are other methods to run the PlexCache-R script, but I've only tested and use the UserScripts one, so that's all I'll list here for now. UserScripts Setup

Notes

  1. Log files are saved in a subfolder of your plexcache directory called 'logs'. Imaginative I know.
  2. For the plexcache_mover_files_to_exclude.txt to work, you need to add it to Mover as an exception text file.

Clone this wiki locally