# sqzw-x/mdcx

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/sqzw-x-mdcx).**

3,394 stars · 455 forks · Python · gpl-3.0

## Links

- GitHub: https://github.com/sqzw-x/mdcx
- awesome-repositories: https://awesome-repositories.com/repository/sqzw-x-mdcx.md

## Topics

`crawler` `emby` `jav-scraper` `jellyfin` `metadata` `movie-crawler` `movie-metadata` `movie-scrapper` `movies` `python` `scraper`

## Description

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.

## Tags

### Content Management & Publishing

- [Metadata Catalogers](https://awesome-repositories.com/f/content-management-publishing/media-cataloging-interfaces/metadata-catalogers.md) — Organizes personal media libraries by fetching and attaching descriptive metadata to each file for easy browsing and search. ([source](https://github.com/sqzw-x/mdcx/blob/master/server.py))
- [Metadata-Fetching Organizers](https://awesome-repositories.com/f/content-management-publishing/media-management/media-servers/library-organization/metadata-fetching-organizers.md) — Organizes a personal collection of media files by fetching and attaching descriptive metadata from online sources.
- [Self-Hosted Media Managers](https://awesome-repositories.com/f/content-management-publishing/media-management/self-hosted-media-managers.md) — Hosts a browser-based interface that lets users browse, search, and manage their media collection remotely. ([source](https://github.com/sqzw-x/mdcx/blob/master/server.py))

### Development Tools & Productivity

- [Web-Scraped Metadata Renamers](https://awesome-repositories.com/f/development-tools-productivity/developer-utilities-libraries/workflow-productivity-enhancers/developer-productivity-utilities/file-management-utilities/bulk-file-renamers/metadata-and-hash-renamers/web-scraped-metadata-renamers.md) — Scrapes metadata from online sources and renames local video files to match a standardized naming scheme.
- [Web-Scraped Metadata Renamers](https://awesome-repositories.com/f/development-tools-productivity/developer-utilities-libraries/workflow-productivity-enhancers/developer-productivity-utilities/file-management-utilities/bulk-file-renamers/tag-based-file-renamers/web-scraped-metadata-renamers.md) — Scrapes metadata from online sources and renames local video files to match a standardized naming scheme. ([source](https://github.com/sqzw-x/mdcx/blob/master/server.py))

### Graphics & Multimedia

- [Plugin-Based Scrapers](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/media-manipulation/media-processing/video-analysis-processing/video-metadata-scraping/plugin-based-scrapers.md) — Loads metadata from multiple online sources through interchangeable adapter modules that each implement a common scraping interface.
- [Media Management Interfaces](https://awesome-repositories.com/f/graphics-multimedia/web-based-media-players/media-management-interfaces.md) — Hosts a browser-based interface that lets users browse, search, and manage their media collection remotely.

### Software Engineering & Architecture

- [Naming Pattern Engines](https://awesome-repositories.com/f/software-engineering-architecture/configuration-driven-rule-engines/naming-pattern-engines.md) — Applies user-defined naming patterns and formatting rules to transform scraped metadata into standardized file names.

### Networking & Communication

- [REST API Frontends](https://awesome-repositories.com/f/networking-communication/proxy-servers/clash-configuration-managers/api-web-interfaces/rest-api-frontends.md) — Presents a browser-based management interface that communicates with the backend exclusively through RESTful API endpoints.

### Operating Systems & Systems Programming

- [Media File Watchers](https://awesome-repositories.com/f/operating-systems-systems-programming/system-administration-maintenance/file-system-management/file-systems/file-change-detection/file-watch-resource-triggers/media-file-watchers.md) — Monitors filesystem directories for new or changed media files and triggers metadata scraping and renaming workflows automatically.