Skip to content

Home

Jump to bottom
StudioNirin edited this page Dec 12, 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 unraid_mover_exclusions.txt to work, you need to add it to Mover Tuner as an exception text file. You can manually add custom entries to this file, as long as you add them above the marker line ("### Plexcache exclusions below this line")

Clone this wiki locally