plexmon

A FreeBSD application that monitors filesystem changes in Plex Media Server library directories and triggers partial library scans.

Features

• Real-time monitoring of Plex library directories using FreeBSD's kqueue
• Automatic detection of Plex libraries and their paths
• Selective partial scans of only changed directories
• Grouping of filesystem events with the same path to prevent scan overload
• Directory structure caching to reduce I/O operations
• Using hash tables for path lookups during comparisons
• Can run as a daemon or in the foreground

Requirements

• libcurl
• json-c

Installation

From Source

# Install dependencies
pkg install curl json-c
# Clone the repository
git clone https://github.com/srevn/plexmon.git
cd plexmon
# Compile
make
# Install
make install
# Create and edit configuration
cp /usr/local/etc/plexmon.conf.sample /usr/local/etc/plexmon.conf
vi /usr/local/etc/plexmon.conf

Configuration

Edit the configuration file /usr/local/etc/plexmon.conf:

# Plex server URLplex_url=http://localhost:32400
# Plex authentication tokenplex_token=YOUR_PLEX_TOKEN_HERE
# Minimum scanning delay for filesystem events (in seconds)scan_interval=1
# Maximum time to wait for Plex server at startup (in seconds)startup_timeout=60
# Log level (info or debug)log_level=info
# Log file (only used when running as daemon)log_file=/var/log/plexmon.log

Finding Your Plex Token

1. Sign in to Plex Web App
2. Inspect any request to the Plex server (using browser developer tools)
3. Look for a parameter called X-Plex-Token

Usage

Running Manually

# Run in the foreground with verbose output
plexmon -v
# Specify alternate config file
plexmon -c /path/to/config
# Run as daemon
plexmon -d