EDIT: I’ve moved this over to a GitHub repository, which is much easier for tracking changes. I also renamed it from “Plex Notifier” to “Plex iNotifier” to help avoid confusion with the “Plex Notify” application. You’re still welcome to report issues here, or submit an issue ticket on GitHub.
_The GitHub repository is here: https://github.com/talisto/plex-inotifier_
Plex iNotifier
Plex is an amazing piece of software. One issue with Plex Media Server, though, is that it doesn’t auto-update the library when there are changes on connected network shares. This can be annoying if you run your PMS on a different machine (e.g. Nvidia Shield, Mac Mini, etc) than where your media library is stored (e.g. NAS), as you either have to trigger an update on PMS manually when adding/moving/renaming content or wait for the library update interval to kick in.
So, I wrote a script to automate that (borrowed heavily from here).
The script works by tying into inotify on the NAS, which is a kernel subsystem that notices changes to the filesystem and reports those changes to applications. The script uses inotify to monitor the media directories on the NAS for changes, then connects to the remote Plex Server’s web API to find the appropriate media section to refresh. If it finds a matching section, it uses the web API to send an update command to that section.
Installation
- Clone the GitHub repository or download the latest zipfile.
- Make sure you have “Python3” installed.
- You’ll need to install the “pynotify” Python module. The easiest way is to install the Python EasyInstall utility; Shell into your server, and run:
wget https://bootstrap.pypa.io/ez_setup.py -O - | python3then run:easy_install pyinotify - Save the
plex-inotify.pyscript somewhere on your NAS/fileserver, e.g./usr/local/bin - Edit the
plex_server_hostvariable near the top of your script to match the IP address of your Plex Server. If you have local DNS resolution, you can use a hostname instead. - Edit the
path_mapsvariable to map the local paths of the media shares on your fileserver to their corresponding library names in your Plex Media Server. - You should change the
daemonizevariable toFalsefor testing purposes until you’re sure that everything is working properly. - Try running the script with
python3 plex-inotify.py, and if all goes well, it will load up without errors
If you set daemonize to True, then the script will fork itself into a background task when you run it. It will stay running even if you log out of the shell.
IMPORTANT: With the security changes in PMS version 1.1.0, if your Plex Media Server is signed in to a plex.tv account, you’ll need to set the plex_account_token variable (see “troubleshooting” below) or you can add the IP address of your fileserver to the following advanced preference: Settings > Server > Network > List of IP addresses and networks that are allowed without auth.
Troubleshooting
-
If you see a bunch of errors that say something like
Errno=No space left on device (ENOSPC), then your inotify watcher limit is too low. Runsysctl -n -w fs.inotify.max_user_watches=16384and then try again. Keep raising the number until the errors go away. -
If you see an error that says
Errno=No such file or directory (ENOENT), then you didn’t configure yourpaths_mapsproperly. Make sure each entry in the list is a local path to your media on the NAS and then the corresponding library/section name on your PMS. -
If you’re getting an error that says
urllib.error.HTTPError: HTTP Error 401: Unauthorized, then you need to set theplex_account_tokenvariable. Follow this link for instructions on how to get your account token. Make sure that when you’re setting the variable, you wrap the token in quotes, like this:plex_account_token = 'A2ekcFXjzPqmefBpv8da'
Let me know if you find this useful!
You either have a PIN set on your Plex account, or you have multiple users set up in your PMS. So the script needs an account token to authenticate with PMS. I’ve updated the script with a new 