plexer-cli 0.0.1.post2

Normalize media files for use with Plex Media Server

Plexer

Summary

A CLI tool made to make organizing your media for Plex Media Server easy. Normalize names of media files and directories to match the hierarchial requirements that Plex requires.

Features

Support

Currently, Plexer only supports organizing movies and other individual video files.

Roadmap

• Support for TV Shows (#28)
• Docker implementations (#29)
• MacOS support (#30)
• Windows support (#31)
• Metadata inference using file/directory info (i.e. analyze the video files to "guess" what the name, year, etc is) (#32)

Install

To install plexer, us pip/pipx/pipenv/your favorite build front-end to install the plexer-cli package.

pip install plexer-cli

Requirements

Media Metadata

The most important requirement before running plexer is to ensure that you've created a .plexer file in each of your target directories.

This is a JSON-formatted file that includes the movie metadata required by Plexer to perform its jobs.

Plexer File Generator

To easily create the .plexer file, you can use the one-liner below while in the movie's directory:

echo -n "Media Name: ";read MEDIA_NAME;echo -n "Release Year (YYYY): ";read RELEASE_YEAR;echo "{\"name\": \"${MEDIA_NAME}\", \"release_year\": \"${RELEASE_YEAR}\"}" > .plexer

It can be modified to support different types of media as well.

Usage

The source directory is the directory containing the raw media. The destination is where you'd like to save the processed media to.

usage: plexer.py [-h] [-v] [--version] -s SOURCE_DIR -d DESTINATION_DIR

options:
  -h, --help            show this help message and exit
  -v, --verbose         Verbosity (-v, -vv, etc)
  --version             show program's version number and exit
  -s SOURCE_DIR, --source-dir SOURCE_DIR
  -d DESTINATION_DIR, --destination-dir DESTINATION_DIR

Support & Feedback

If you run into issues while using Plexer, think you know a way to make it better, or just need help using it, create a new issue within this project and they will triaged when possible.

Development

Software Stack

For developing with Plexer, there are several tools that are in use:

1. Build Backend, Packaging, and Dependency Management:
   1. Hatch
2. Analysis Tools:
   1. Ruff
   2. Codacy
3. Testing:
   1. Pytest
   2. Tox