plexcontentmanager

Plex Content Manager

A command-line tool for managing and curating Plex Media Server content.

Features

• Connect to your Plex server securely
• List all empty collections across your libraries
• Delete empty collections with confirmation
• Batch operations with force option to skip confirmations

Installation

From PyPI (Recommended)

pip install plexcontentmanager

If you encounter an "externally-managed-environment" error, use one of these alternative installation methods:

Using pipx

# Install pipx if not already installed
pip install --user pipx
pipx ensurepath

# Install plexcontentmanager
pipx install plexcontentmanager

Using a virtual environment

# Create a virtual environment
python -m venv venv

# Activate the virtual environment
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install plexcontentmanager
pip install plexcontentmanager

From Source

git clone https://github.com/alexboutros/plexcontentmanager.git
cd plexcontentmanager
pip install -e .

Usage

Configuration

First, configure your Plex server connection:

plexcontent config --server "https://your-plex-server:32400" --token "your-plex-token"

You can view your current configuration:

plexcontent config

Test Connection

Verify that your connection to the Plex server is working:

plexcontent test-connection

Managing Collections

List all empty collections:

plexcontent list-empty-collections

Delete empty collections (with confirmation):

plexcontent delete-empty-collections

Delete empty collections without confirmation:

plexcontent delete-empty-collections --force

Finding Your Plex Token

https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/

Security & Privacy

This application stores your Plex token locally in ~/.plexcontentmanager/config.json. The token is:

• Never transmitted to any server other than your specified Plex server
• Stored as plaintext in the configuration file
• Only used to authenticate with your Plex server

For security reasons:

• The source code is available on GitHub for review
• You can optionally use a dedicated Plex account with limited permissions for this tool
• You can delete the configuration file (~/.plexcontentmanager/config.json) when not in use