MDCx is a self-contained media management tool that automatically scrapes metadata from online sources and renames local video files to match standardized naming schemes. It organizes personal media libraries by attaching descriptive information to each file, enabling easy browsing and search through a browser-based interface.
The tool operates through a modular backend that includes a configurable rule engine for defining naming patterns, plugin-based scrapers that load metadata from multiple sources, and a filesystem watcher that triggers processing workflows automatically when new media files are detected. A background task queue offloads long-running operations to keep the web interface responsive, while SQLite provides persistent storage for metadata, scraping history, and user configuration.
MDCx also includes error-handling mechanisms that resolve metadata retrieval failures to ensure complete data collection, and it enforces consistent Python code style through configurable linting and auto-formatting rules. The web-based management interface communicates with the backend exclusively through RESTful API endpoints, allowing remote browsing, searching, and management of media collections without command-line tools.