Home

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: Getting the Files

Put the files from this Repo into a known folder on your Unraid server. I use the following:

/mnt/user/appdata/plexcache/plexcache_app.py

I'll keep using this in my examples, but make sure to use your own path.

---

Step 2: Configure the script:

Running the Setup Script and generating your plexcache_settings.json file. Click the link for full instructions and guidance.

---

Step 3: 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. Click the link for full instructions and guidance.

---

Advanced Options and Command-Line Arguments

There are a few command-line arguments and other settings that are mostly not necessary to change, but are helpful in certain situations such as debugging issues etc, so those are all listed HERE.

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")