PlexFileRenamer dev-2eaf0ff

PlexFileRenamer dev-2eaf0ff

A CLI tool to rename/move media files based on Plex Media Server metadata.

Features

• Reads Plex SQLite database (with WAL support)
• Supports Movies and TV Shows
• Dry-run mode to preview changes
• Copy and move modes
• Interactive per-library and per-location approval
• Custom output paths per location
• Script generation (CMD, PowerShell, Bash)
• Path mapping for network shares

Usage

plexfilerenamer [options] <database-path>

Options:
  --output         Output directory for renamed files
  --dry-run        Preview changes without applying them
  --script         Generate script file instead of executing
  --shell          Shell format: cmd, powershell, or bash
  --mode           Operation mode: copy or move (default: move)
  --auto-approve   Skip interactive prompts
  --path-map       Path mapping (old:new) for network shares