appstore/apps/mdcz

MDCz

产品介绍

MDCz 是一个高效、现代的影片元数据刮削与管理工具。它提供自托管 WebUI，可识别影片编号、抓取元数据与图片、生成 NFO 文件，并整理本地媒体文件，适合与 Emby、Jellyfin 等媒体库配合使用。

主要功能

• 从多个数据源刮削影片、演员、封面和缩略图等元数据。
• 生成 NFO 文件并按规则重命名、移动和归类影片。
• 批量扫描媒体目录，并通过 WebUI 查看任务进度和日志。
• 提供资料库、设置、维护工具和自动化接口。
• 使用 SQLite 保存配置、认证状态和任务数据。

访问说明

• Web 端口：安装表单中的 PANEL_APP_PORT_HTTP，默认 3838。
• 首次访问会进入初始化向导。
• 管理员密码由安装表单生成，并自动填入首次设置页面；请妥善保存，升级时不要随意更换。
• 初始化向导中的媒体目录必须填写容器路径 /media，不能填写宿主机路径。

数据持久化

• APP_DATA_DIR 挂载到 /data，保存 SQLite 数据库、配置文件和认证状态。
• MEDIA_DIR 挂载到 /media，供 MDCz 扫描和整理影片文件。
• 默认媒体目录位于 ./data/media，也可以改为现有媒体库的绝对路径。
• 升级前应备份 APP_DATA_DIR；执行批量整理前还应备份媒体文件或先使用预览功能。

权限与文件操作风险

官方镜像以 UID/GID 1000:1000 的非 root 用户运行。初始化脚本会修正应用数据目录权限；如果 MEDIA_DIR 指向已有媒体库，需要确保 UID 1000 对其中的文件和子目录具有读写权限。

MDCz 的核心功能会创建目录与 NFO/图片文件，并可能按照设置移动、重命名或清理媒体文件。请先在少量文件上验证整理规则，不要直接对唯一副本执行批量操作。

网络与内容说明

• 不同元数据源可能存在地区访问限制，部分站点需要合适的代理或出口地区。
• 元数据源和影片内容可能受到服务条款、版权或当地法律限制，请仅处理有权持有和管理的内容。
• 对公网开放时，建议通过 1Panel 网站反向代理启用 HTTPS。

版本说明

• 0.10.0：固定的首个官方 WebUI 自托管版本。
• latest：跟随官方最新发布镜像，升级前应阅读上游发布说明并备份数据。

项目采用 GPL-3.0 许可证。

Introduction

MDCz is a self-hosted video metadata scraper and library management tool. It provides a browser WebUI for scraping metadata, generating NFO files, and organizing media for systems such as Emby and Jellyfin.

Features

• Scrape metadata and artwork from multiple providers.
• Generate NFO files and organize local media with configurable naming rules.
• Persist configuration, authentication state, and tasks in SQLite under /data.
• Mount the writable media library at /media; verify rules on a small sample before batch operations.

Links

• Project: https://github.com/ShotHeadman/mdcz
• Server documentation: https://github.com/ShotHeadman/mdcz/blob/main/apps/server/README.md
• Release: https://github.com/ShotHeadman/mdcz/releases/tag/v0.10.0