Plex Media Organizer

A powerful, intelligent media file organizer that follows Plex naming conventions. Built in Rust for performance and reliability.

🚀 Quick Start

Installation

Cargo (Recommended):

cargo install plex-media-organizer

Homebrew (macOS/Linux):

brew install lijunzh/plex-media-organizer/plex-media-organizer

Pre-built Binaries: Download from GitHub Releases

First Steps

# Setup configuration
plex-media-organizer setup

# Scan a directory
plex-media-organizer scan /path/to/movies

# Organize files (preview first!)
plex-media-organizer organize /path/to/movies --preview

✨ Features

• Intelligent Parsing: Advanced filename parsing with confidence scoring
• Plex Compatibility: Follows Plex naming conventions for optimal media server integration
• Multi-language Support: Handles English, Chinese, Japanese, Arabic, and other languages
• TMDB Integration: Enhanced metadata using The Movie Database API
• Database Backed: Persistent operation history with rollback capabilities
• Safety First: Preview mode and rollback support for all operations

📋 Commands

• setup - Interactive configuration setup
• scan - Analyze media directories
• test - Test parsing functionality
• organize - Organize media files
• rollback - Revert previous operations
• cleanup - Database maintenance

📁 Supported Formats

• Video: .mkv, .mp4, .avi, .mov, .wmv
• Languages: English, Chinese, Japanese, Arabic, Russian, and more
• Platforms: Linux, macOS, Windows

📚 Documentation

• User Guide - Complete documentation
• CLI Commands - Command reference
• Configuration - Setup options

🤝 Contributing

We welcome contributions! See Contributing Guide for details.

📝 License

MIT License - see LICENSE for details.

Made with ❤️ in Rust