Skip to content

chen8945/BluRayRemuxKit

BranchesTags

Repository files navigation

BluRayRemuxKit

🚀 懒人导航：太长不看？点击直接跳转到一键运行命令

自动化将蓝光原盘（BDMV）或 ISO 镜像批量 Remux 为 MKV，支持智能正片识别、BDInfo 深度解析与重构、以及交互式轨道编辑。

参数说明

参数 必选 默认值 说明
-i, --input 是 — 包含蓝光原盘（文件夹）或 ISO 文件的根目录，支持递归扫描多层子目录
-o, --output 否 ./output 输出 MKV 文件的保存目录
-t, --temp 否 — MakeMKV 临时根目录；未指定时默认使用 <输出目录>/<原盘目录>/temp/
--bdinfo-dir 否 — 外部 BDInfo 文本的统一存放目录
--commentary 否 ask 导评轨道处理策略（keep 保留 / drop 剔除 / ask 询问）
--best-audio 否 ask 最高规格音轨精简策略（交互询问时默认 yes；no 保留全部 / yes 仅保留最高规格 / ask 询问）
--simplify-subs 否 ask 外语字幕精简策略（yes 默认精简外语 / no 全部保留 / ask 询问）
--makemkv-mode 否 auto MakeMKV 处理策略，仅对多段播放列表生效（auto 自动检测问题盘 / force 直接先走 MakeMKV / ask 逐盘询问）
--skip-interactive 否 — 开启全自动静默模式，跳过所有手动确认和轨道编辑环节
--continue-on-error 否 — 容错模式，某个原盘处理报错时自动跳过并继续处理下一个
--delete-source 否 — 处理成功后自动删除原盘源文件 (ISO/BDMV)，并删除当前任务匹配到的 BDInfo 文件或控制台粘贴生成的临时 BDInfo 缓存 (谨慎使用，请务必记得把映射中的 :ro 删除)
--keep-temp 否 — 保留并复用 MakeMKV 产出的临时 MKV，并强制保留源文件与 BDInfo（测试使用，请勿开启）
--debug 否 — 输出轨道补全、MakeMKV 回绑匹配、mkvmerge 命令与处理路径等调试信息（测试使用，请勿开启）

💡 路径参数提示： 在使用 Docker 容器时，参数中的 -i /input、-o /output、-t /temp 通常不需要修改，因为它们指向的是容器内部的固定绝对路径。只需要在挂载配置（volumes）中修改对应的宿主机（本地）路径即可。临时目录不建议使用 /tmp，因为当前镜像已将 /tmp 用作 tmpfs 系统临时目录。

多段盘处理规则

单段盘

  • 单段播放列表直接走原始 mpls -> mkvmerge 流程。
  • --makemkv-mode 不作用于单段盘；即使传入 force 或 ask，也仍然保持原始 mpls -> mkvmerge 流程。

多段盘预检查

  • 脚本会先读取 mpls 对应的分段列表。
  • 预检查仅从 mkvmerge 视角验证每个 m2ts 分段能否识别到视频轨。
  • 只要任意分段在 mkvmerge 中找不到视频轨，就会直接判定为问题盘。

普通多段盘

  • 预检查通过后，仍然以播放列表作为基准时间轴进行封装。
  • 如果传入 --makemkv-mode ask，脚本只会在识别出“多段播放列表”后，询问当前盘使用 auto 还是 force。

问题盘

  • 问题盘指的是预检查未通过的多段盘，例如：
    • 某些分段缺少可被 mkvmerge 识别的视频轨。
    • 分段追加时出现 --append-to 轨道对不上的情况。
  • 问题盘会切换到 MakeMKV 兜底路径：
    • 异常跳过： 如果当前环境中 MakeMKV 不可用（如 Docker 容器内抓取 Key 失败、本地工具丢失/Key 过期），脚本将输出警告提示，并自动跳过该原盘，继续处理下一个。
    • 先用 makemkvcon -r info 读取原盘并按 TINFO:16 精确匹配目标 MPLS。
    • 再按配置文件导出对应标题为临时 MKV，并基于 mkvmerge -J 做轨道回绑。
    • 最终由 mkvmerge 以“单输入临时 MKV”完成封装。
  • 隐藏轨处理规则：
    • 初始工作集合会自动剔除隐藏轨（BDInfo * 或 hidden hint）。
    • 可在交互 all 视图中通过 add 手动加回。
    • 但问题盘 MakeMKV 路径会在最终回绑阶段再次忽略隐藏轨，避免匹配失败。
  • --keep-temp 未开启时，问题盘流程结束后会自动清理临时 MKV，以及空的临时目录。

--skip-interactive 选片规则

  • 静默模式下，会优先使用 BDInfo 中的 PLAYLIST 命中目标 mpls。
  • 如果 BDInfo 未能命中，脚本会退回到候选列表第一项，同时在日志中明确提示。
  • 静默模式下如果传入 --makemkv-mode ask，会自动退化为 auto 并打印提示。

--skip-interactive 参数退化规则

参数 传值 静默模式下实际行为
--commentary drop 剔除导评轨道
keep / ask / 不传 保留导评轨道（默认行为）
--best-audio yes 每种语言仅保留一条最高规格音轨
no / ask / 不传 不做最高规格音轨精简（默认行为）
--simplify-subs no 保留所有支持的外语字幕
yes / ask / 不传 精简外语字幕（英语/原语言仅保留一条最优）（默认行为）
--makemkv-mode
(注：单段盘均不参与)		 force 跳过 mkvmerge 预检查，强制使用 MakeMKV
auto / ask / 不传 按默认逻辑自动检测（默认行为）

💡 MakeMKV 可用性退化规则： 无论是否开启静默模式，如果脚本检测到当前环境 MakeMKV 工具不可用，且传入了 --makemkv-mode force 或 --makemkv-mode ask，脚本会自动将其退化为 auto 模式。在非静默模式下，脚本会额外弹出提示询问用户是否继续处理。

BDInfo 匹配与输入

匹配规则（按优先级）

  1. 统一目录优先 — 在 --bdinfo-dir 参数指定的目录下查找 {原盘名}.txt 或 {原盘名}_bdinfo.txt
  2. 原盘目录匹配 — 在原盘目录中查找 {原盘名}.txt、{原盘名}_bdinfo.txt 或 bdinfo.txt；如果原盘是文件夹，也支持查找同级的 {原盘名}.txt 或 {原盘名}_bdinfo.txt
  3. 控制台粘贴兜底 — 如果以上位置都没找到 BDInfo，脚本会在交互终端中提示你直接粘贴完整 BDInfo 文本，并缓存成临时 txt 继续处理

推荐方式：直接在控制台粘贴

正常情况下不再需要手动新建 txt 文件。

使用方式：

  1. 直接运行脚本或容器命令
  2. 如果脚本没有在本地找到匹配的 BDInfo 文本，会在控制台提示你粘贴完整 BDInfo
  3. 粘贴完成后，单独输入 EOF 结束
  4. 脚本会自动缓存为临时 txt，并继续后续处理

可选方式：手动新建 txt

如果你希望复用同一份 BDInfo，或者想避免重复粘贴，也仍然可以手动新建 txt 文件。

利用终端的 EOF 语法，可以一步到位新建 txt 文件并写入 BDInfo。

方式一：在当前目录下创建 如果已经 cd 进入了原盘所在目录，直接执行：

cat << 'EOF' > "原盘名称.txt"
[在这里粘贴 BDInfo 扫描文本内容，支持直接粘贴多行]
[支持多行...]
EOF

方式二：指定目标路径创建 如果不想切换目录，可以直接指定绝对或相对路径（⚠️ 注意：目标路径的文件夹必须已经存在，cat 不会自动创建目录）：

cat << 'EOF' > "/volume1/Media/BluRays/原盘名称.txt"
[在这里粘贴的 BDInfo 扫描文本内容，支持直接粘贴多行]
EOF

Docker 使用指南

镜像已发布至 GHCR，支持 linux/amd64 和 linux/arm64 架构：

docker pull ghcr.io/chen8945/bluray-remuxkit:latest
  • 镜像内已内置 makemkvcon、default.mmcp.xml 和 settings.conf。
  • 构建时会自动抓取官方论坛最新 MakeMKV beta key，容器启动时会再次校验。
  • 若 key 失效，容器会联网自动刷新抓取（默认包含 5 次重试机制）。
  • 无感降级： 建议保持网络畅通。如果在完全断网（如使用了 --network none）或多次抓取均失败的情况下，容器不会启动崩溃，而是会安全禁用 MakeMKV 兜底功能并继续启动。遇到需要 MakeMKV 兜底的问题盘时则会自动跳过。

前提条件

  • 宿主机必须是 Linux。
  • 已安装 Docker。
  • 如需容器内挂载 ISO，宿主机需存在 /dev/loop-control 及可用的 loop 设备。

💡 提示：Windows / macOS 用户建议直接跳转查看下方的 本地运行 使用单独的 Python 脚本。

不使用 Docker Compose

如果不想繁琐地配置 Compose 文件夹，直接在原盘目录下运行即可，这是最推荐的方式。

操作流：

  1. 在终端中 cd 进入包含蓝光原盘的目录（注意这里是指多个原盘的存放目录，而不是指单个原盘目录内部，也就是不要进入 BDMV 同级目录）。
  2. 直接粘贴执行以下命令：
  3. 如果运行过程中提示缺少 BDInfo，就把完整 BDInfo 文本粘贴进控制台，并在回车换行后单独输入大写 EOF 结束。

自动删除原盘

docker run --rm -it \
  --init \
  --security-opt apparmor:unconfined \
  --security-opt seccomp:unconfined \
  --cap-add SYS_ADMIN \
  --device /dev/loop-control:/dev/loop-control \
  --device /dev/loop0:/dev/loop0 \
  --device /dev/loop1:/dev/loop1 \
  --device /dev/loop2:/dev/loop2 \
  --device /dev/loop3:/dev/loop3 \
  --device /dev/loop4:/dev/loop4 \
  --device /dev/loop5:/dev/loop5 \
  --tmpfs /tmp:exec \
  -v "$PWD":/input \
  -v "$PWD/../Remux_Output":/output \
  -v "$PWD/../Remux_Temp":/temp \
  ghcr.io/chen8945/bluray-remuxkit:latest \
  -i /input \
  -o /output \
  -t /temp \
  --continue-on-error \
  --delete-source \
  --commentary drop \
  --best-audio yes \
  --simplify-subs yes

保留原盘

docker run --rm -it \
  --init \
  --security-opt apparmor:unconfined \
  --security-opt seccomp:unconfined \
  --cap-add SYS_ADMIN \
  --device /dev/loop-control:/dev/loop-control \
  --device /dev/loop0:/dev/loop0 \
  --device /dev/loop1:/dev/loop1 \
  --device /dev/loop2:/dev/loop2 \
  --device /dev/loop3:/dev/loop3 \
  --device /dev/loop4:/dev/loop4 \
  --device /dev/loop5:/dev/loop5 \
  --tmpfs /tmp:exec \
  -v "$PWD":/input:ro \
  -v "$PWD/../Remux_Output":/output \
  -v "$PWD/../Remux_Temp":/temp \
  ghcr.io/chen8945/bluray-remuxkit:latest \
  -i /input \
  -o /output \
  -t /temp \
  --continue-on-error \
  --commentary drop \
  --best-audio yes \
  --simplify-subs yes

巧妙的路径隔离：通过 -v "$PWD/../Remux_Output":/output 与 -v "$PWD/../Remux_Temp":/temp，可以把最终输出与问题盘临时文件分开存放在当前目录的上一级目录中。

使用 Docker Compose

如果更喜欢统一部署和管理，可以使用 Compose 模式。

如果需要自动删除原盘源文件，请自行添加 --delete-source 参数，并把 docker-compose.yaml 中的 ./input:/input:ro 改成可写挂载，例如 ./input:/input，否则容器内无法删除原盘源文件。

1. 准备目录结构：

BluRayRemuxKit/
├── docker-compose.yaml
├── input/          ← 放入蓝光原盘或 ISO
├── output/         ← Remux 输出目录
└── temp/           ← 问题盘临时目录

2. 🌟 推荐运行参数： 自动剔除导评、保留最高规格音轨并精简外语字幕、无报错中断：

docker compose run --rm remuxkit \
  -i /input \
  -o /output \
  -t /temp \
  --continue-on-error \
  --commentary drop \
  --best-audio yes \
  --simplify-subs yes

3. 交互模式（保留所有的手动确认和轨道编辑环节）：

docker compose run --rm remuxkit -i /input -o /output -t /temp

4. 全自动模式：

docker compose run --rm remuxkit -i /input -o /output -t /temp --skip-interactive

5. 极致精简模式（全自动+最高规格+无报错中断）：

docker compose run --rm remuxkit \
  -i /input \
  -o /output \
  -t /temp \
  --skip-interactive \
  --commentary drop \
  --best-audio yes \
  --simplify-subs yes \
  --continue-on-error

6. 边转边删模式（空间回收）（全自动+成功后立刻删除原盘，并删除当前任务匹配到的 BDInfo，适合小硬盘）：

docker compose run --rm remuxkit \
  -i /input \
  -o /output \
  -t /temp \
  --skip-interactive \
  --commentary drop \
  --best-audio yes \
  --simplify-subs yes \
  --continue-on-error \
  --delete-source

⚠️ 注意：请务必使用 docker compose run --rm 而非 docker compose up，因为本容器设计为一次性处理任务，--rm 能确保任务结束后自动清理容器。

调试建议：--keep-temp 与 --debug 仅用于测试场景，常规批处理请勿开启。若同时传入 --keep-temp 与 --delete-source，会以 --keep-temp 为准，强制保留源文件、BDInfo 与临时文件。

ISO 挂载排错说明

容器内 ISO 挂载需要特定的高级权限（docker-compose.yaml 及上方单行命令已预置）：

  • root 用户运行（user: 0:0）
  • SYS_ADMIN capability
  • loop 设备映射
  • apparmor:unconfined + seccomp:unconfined

如果 ISO 挂载失败，请检查：

  1. 宿主机物理机是否存在 /dev/loop-control 与若干 /dev/loopN 设备。
  2. Docker 服务是否允许容器访问这些底层设备。
  3. 系统中是否有其他进程（如其他挂载任务）占满了现有的 loop 设备。

本地运行

⚠️ 强烈建议：对于 Windows 和 macOS 用户，直接运行本地 Python 脚本效率极高。这不仅能直接调用系统本地的 mkvmerge 进行满速混流，更能彻底避开 Docker 在跨平台环境下的 loop 设备挂载限制与繁琐的权限配置。

依赖准备

  • 环境：Python 3.10+
  • 核心工具：
    • mkvmerge（MKVToolNix）
    • ffprobe（FFprobe，可单独安装，不要求完整 FFmpeg）
  • 问题盘兜底工具（仅问题盘路径需要）：
    • MakeMKV（makemkvcon）
    • MakeMKV 配置文件（未指定时使用脚本自带默认配置文件）
  • Python 库：rich、pycountry
  • 可选增强输入依赖：prompt_toolkit
    • 用于改善 SSH / Linux / Windows 下的交互输入体验，支持上下键历史、左右移动与更自然的命令行编辑
    • 未安装时，脚本会自动回退到原生 input()，不影响基本功能

安装依赖

pip install -r requirements.txt

requirements.txt 已包含 prompt_toolkit，安装后可直接获得增强交互输入体验；即使缺少该库，脚本仍会自动回退到原生 input()。

执行命令

python bluray_remux.py -i /path/to/BluRays -o /output

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

3 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages