ShotHeadman/mdcz：基于 Electron 的 JAV 影片元数据刮削与管理工具

项目介绍

ShotHeadman/mdcz 是一个托管在 GitHub 上的开源项目，主要使用 TypeScript 编写，采用 GNU General Public License v3.0 许可证，目前获得 461 个 Star、37 次 Fork。

仓库全名: ShotHeadman/mdcz

README 摘要

中文 | English MDCz 高效、现代的影片元数据刮削与媒体库管理工具 MDCz 是什么？ MDCz 是一款现代化的本地影片元数据刮削与整理工具。配合 Emby、Jellyfin 等媒体库管理软件，通过智能识别影片番号或文件名，自动抓取多站点的元数据、高清封面、剧照及演职员信息，生成标准化 NFO 文件，并自动规范化重命名与归类本地影片。核心功能多站点聚合刮削 — 支持 DMM、FC2、AVBase、AVWikiDB、JavBus、JavDB、MGStage、Prestige 等主流数据源双端支持 — 提供开箱即用的跨平台桌面客户端与轻量 WebUI / Docker 自托管方案演员别名归一 — 支持自定义演员名称映射，将不同来源的别名自动合并为标准规范名 Emby / Jellyfin 深度集成 — 自动同步人物头像、生成规范 NFO 文件及多级剧照多媒体格式兼容 —…

完整内容见 GitHub 原始 README 或本页。

常见问题

mdcz 用什么语言开发？

主要使用 TypeScript 编写，采用 GNU General Public License v3.0 许可证，目前有 461 个 Star。

mdcz 可以免费商用吗？

仓库标注的许可证为 GNU General Public License v3.0，商用前请先阅读仓库 LICENSE 文件确认授权范围。

如何获取 mdcz 的源码？

可以直接克隆仓库：git clone https://github.com/ShotHeadman/mdcz.git，默认分支为 main；安装与运行步骤见仓库 README。

mdcz 最近还在维护吗？

仓库最近一次更新为 1 天前，当前有 7 个未关闭 Issue；Star 数为 461，可作为社区活跃度的参考。

关于

GNU General Public License v3.0
461 Stars
37 Forks
4 Watching

简要分析

热度分

539

价值分

287

活跃状态

活跃

GitHub

语言占比

Batchfile

CSS

Dockerfile

HTML

JavaScript

PowerShell

Shell

TypeScript

Release

MDCz v0.21.06 天前
MDCz v0.20.02 周前
MDCz v0.19.13 周前
MDCz v0.19.03 周前
MDCz v0.18.010月5日

贡献者

中文 | English

MDCz

高效、现代的影片元数据刮削与媒体库管理工具

Electron React TypeScript pnpm License

MDCz 概览

MDCz 是什么？

MDCz 是一款现代化的本地影片元数据刮削与整理工具。

配合 Emby、Jellyfin 等媒体库管理软件，通过智能识别影片番号或文件名，自动抓取多站点的元数据、高清封面、剧照及演职员信息，生成标准化 NFO 文件，并自动规范化重命名与归类本地影片。

核心功能

多站点聚合刮削 — 支持 DMM、FC2、AVBase、AVWikiDB、JavBus、JavDB、MGStage、Prestige 等主流数据源
双端支持 — 提供开箱即用的跨平台桌面客户端与轻量 WebUI / Docker 自托管方案
演员别名归一 — 支持自定义演员名称映射，将不同来源的别名自动合并为标准规范名
Emby / Jellyfin 深度集成 — 自动同步人物头像、生成规范 NFO 文件及多级剧照
多媒体格式兼容 — 完善支持分段影片（CD1/CD2/Part）、STRM 流媒体文件及外挂字幕文件关联移动
批量工作台 — 具备可视化批量任务队列与执行前变更对比（Diff Preview）
实用工具箱 — 提供重名查重、规则重命名及媒体库数据维护能力

下载与安装

桌面客户端

前往 Releases 下载对应文件：

文件	适用于	自动更新	数据目录
`MDCz-<版本>-win-x64-setup.exe`	Windows 10 及以上，推荐	应用内下载，重启后安装	`%APPDATA%\mdcz`
`MDCz-<版本>-win-x64-portable.zip`	Windows 便携版，解压即用	提示新版本，需手动下载替换	程序目录下的 `data\`
`MDCz-<版本>-mac-arm64.dmg`	macOS Apple Silicon（不提供 Intel 版）	提示新版本，需手动下载替换	`~/Library/Application Support/mdcz`
`MDCz-<版本>-linux-x86_64.AppImage`	Linux x64	应用内下载，重启后安装	`~/.config/mdcz`

便携版的配置、数据库和日志都在 data\ 里，升级时保留这个文件夹，替换其余文件即可。

Note 注意

应用没有代码签名，首次运行时系统会拦截：

Windows 提示「Windows 已保护你的电脑」：点「更多信息」→「仍要运行」。
macOS 提示「已损坏，无法打开」：把 MDCz 拖进「应用程序」后，在终端执行 xattr -cr /Applications/MDCz.app。
Linux：先执行 chmod +x MDCz-*.AppImage 再运行。

Docker 部署（推荐 NAS / 服务器）

推荐使用仓库提供的 compose.yaml 进行部署，详细步骤请参考 Docker 部署与维护指南。

快速上手：将配置模板复制为 .env，填写真实版本号与媒体路径后，执行 docker compose up -d 即可启动。
首次访问：浏览器打开 http://<服务器IP>:3838（默认绑定 127.0.0.1，NAS 局域网访问请在 .env 中调整绑定 IP）。系统无默认密码，首次访问直接按提示设置管理员密码，随后即可在设置中添加媒体库。

WebUI 压缩包（不使用 Docker）

Releases 中的 mdcz-<版本>.tar.gz 可直接在装有 Node.js >= 24 的机器上运行，安装和启动方式见包内 README。

源码运行

环境准备与开发命令见 CONTRIBUTING.md。

界面预览

刮削结果	剧照和预告片

Tip 提示

这里使用奥德赛的相关信息只是为了演示，大家都知道这个软件暂时获取不了正经电影的这些信息。

注意事项

Warning 警告

本项目处于活跃迭代阶段。核心刮削与整理功能已就绪，部分高级设置项仍在完善中。遇到异常欢迎提交 Issue。

Important 重要

网络环境提示：不同数据源存在地域访问限制。例如 DMM 仅支持日本 IP，部分站点会屏蔽特定代理。请根据目标数据源在网络设置中配置合适的代理分流规则。

上游与致谢

上游项目：MDCx，感谢原作者的卓越贡献。

授权许可

本项目采用 GPLv3 开源协议。使用本项目即代表同意以下条款：

本项目仅供技术研究与个人交流使用。
请勿在公共社交平台大范围传播或商业化。
使用过程中请严格遵守当地法律法规，用户自行承担法律责任及后果。

问题反馈 · LINUXDO 社区

暂无评论

mdcz