README.md

minfo

minfo 是一个面向本地媒体资源的 Web 工具，支持生成 MediaInfo、BDInfo，以及截图和上传图床。

支持功能

• 输出 MediaInfo 信息
• 输出 BDInfo 信息，支持精简报告和完整报告，底层使用 tetrahydroc/BDInfoCLI
• 生成截图并打包为 ZIP 下载
• 生成截图后上传到 Pixhost
• 截图支持 PNG / JPG
• 色彩标准支持 SDR / HDR / Dolby Vision
• 截图数量支持 1 到 10 张
• 截图支持字幕自动选择或关闭字幕
• 支持外挂字幕、内封文字字幕、内封位图字幕
• 支持 ISO 挂载与 ISO:/path/to/file.iso!/inner/path 虚拟路径

支持媒体

• 普通视频文件
• 蓝光目录、BDMV 目录、STREAM 目录
• DVD 目录、VIDEO_TS 目录、IFO / BUP / VOB 文件
• 普通 ISO 文件
• 蓝光 ISO、DVD ISO
• ISO 内部虚拟路径

技术特性

1. 色彩映射 (Tone Mapping)

项目集成 libplacebo 渲染库，用于处理 HDR 及 杜比视界资源至 SDR 空间的色彩映射。

• 格式支持：完整支持 HDR10、HDR10+ 以及杜比视界 (Dolby Vision) Profile 5/7/8 格式，修正截图常见的发灰或紫绿偏色问题。
• 渲染机制：基于 Vulkan API 实现高质量色彩空间转换。

2. 截图压缩

为适配Pixhost图床的体积限制，项目内置 PNG 自动化处理策略，在保留 .png 格式的前提下优化文件体积。

• 无损压缩 (oxipng)
  • 属性：无损。
  • 原理：通过优化 Zlib 压缩字典及清理元数据减少体积。
• 有损量化 (pngquant)
  • 属性：有损。
  • 原理：将 24-bit 真彩色图像量化为 8-bit 索引色。
  • 逻辑：当无损压缩后体积仍超出图床限制时自动启用。在视觉损失较小的前提下大幅降低文件体积，确保 4K 截图正常上传。
• 处理策略：系统根据文件大小阈值自动调度压缩算法。

部署方式

直接使用已发布镜像 ghcr.io/mirrorb/minfo:latest。

示例 docker-compose.yml：

services:
  minfo:
    image: ghcr.io/mirrorb/minfo:latest
    container_name: minfo
    privileged: true
    ports:
      - "28080:28080"
    environment:
      PORT: "28080"
      REQUEST_TIMEOUT: "20m"
      FFMPEG_SSE_COMPAT: "0"
    volumes:
      - /lib/modules:/lib/modules:ro # 用于挂载 ISO，保持默认
      - /your/media/path1:/media_path1:ro
      - /your/media/path2:/media_path2:ro
    restart: unless-stopped

启动：

docker compose up -d

运行要求

• 支持AMD64和ARM64
• 需要以 privileged: true 运行容器，以便挂载 ISO 和处理相关系统能力
• 若需要挂载 ISO，请保留 /lib/modules:/lib/modules:ro
• 建议将媒体目录只读挂载进容器

配置项

• PORT：Web 服务监听端口，默认 28080
• REQUEST_TIMEOUT：单次请求超时时间，默认 20m
• FFMPEG_SSE_COMPAT：SSE兼容模式，默认关闭；需要时设为 1

许可证

本项目采用 MIT License。