MAD-Producer/MAD-Toolbox

AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它将多个强大的命令行工具整合为美观的 GUI，避免通过 Shell 执行命令以提高安全性，并显示脱敏日志——让非命令行用户也能轻松完成高级媒体处理任务。

适合谁使用

偏好图形界面而非命令行的 Windows 和 macOS 用户
需要快速下载、转换、重新封装视频/音频的内容创作者
希望从 Bilibili 或 YouTube 等网站下载并处理媒体的媒体档案管理员
寻找内置已验证依赖的一站式媒体工具包的用户

典型使用场景

使用二维码登录后下载 Bilibili 视频，自动选择账号可用的最高规格
下载 YouTube 等网络视频，支持代理、格式选择和 Cookie 设置
转换、重新封装、抽取视频/音频/字幕流、生成 GIF，或批量处理媒体文件
进行 PR 兼容优化的转码，优先复制媒体流并输出 MP4

项目优势

Full 版内置固定版本并经过 SHA-256 校验的 CLI 工具，无需手动安装
命令不通过 Shell 执行，减少注入风险；日志经过脱敏处理
支持后台任务执行，可取消、显示彩色日志并导出诊断 ZIP
每个功能支持多模板，敏感字段通过系统凭据管理器加密存储

使用前须知

仅支持 x64 Windows 10/11 和 Apple Silicon macOS 12+，无 32 位或 ARM64 安装包
音乐下载功能依赖用户自行安装 Python 3 和 musicdl，未随软件分发
从源码构建需要 Node.js 22、Rust 和对应平台的原生构建工具

README 快速开始

MAD Toolbox

把常用媒体命令行工具变成简洁、清晰的桌面 GUI。

English · ·

MAD Toolbox 是一个面向 Windows 和 macOS 的开源媒体工具箱。它把表单和 GUI 选项转换为 BBDown、yt-dlp、FFmpeg、MediaInfo 等工具的参数数组，不经过 Shell 执行，并在独立的日志终端中显示经过脱敏的命令和运行输出。

当前支持 Windows 10 22H2 / Windows 11 x64，以及 macOS 12 以上的 Apple Silicon 设备。暂不提供 Windows 32 位和 ARM64 安装包。

主要功能

哔哩哔哩下载：必须先在软件内使用二维码登录；提供最高规格、音频、封面、字幕等简易模式，同时尽量覆盖 BBDown 高级参数。
网络视频下载：使用 yt-dlp，自动测试 YouTube 连通性，提示开启全局代理或填写 HTTP、HTTPS、SOCKS 代理，并提供格式、字幕、Cookie 等高级设置。
媒体处理：支持文件和目录拖拽、中文 MediaInfo 信息、转换、重新封装、视频/音频/字幕抽流、ASS/SRT、GIF、序列帧以及码率、帧率、尺寸、裁切、旋转、速度、像素格式和音频参数。
PR 智能兼容：优先输出 MP4，能直接复制媒体流时使用 -c copy，无法兼容时才转码；忽略作为封面的附加图片轨道。
音乐下载：检测用户自行安装的 Python 3 和 musicdl 后启用，不在安装包内捆绑 musicdl。
任务中心：任务切换页面后继续运行，支持取消、彩色日志，以及为每个任务导出经过脱敏的诊断 ZIP。
设置模板：每个功能支持多个模板并自动恢复上次设置；Cookie 等敏感字段使用系统凭据管理器和加密存储。

下载规格、会员内容、HDR、杜比视界和高码率资源取决于当前登录账号的会员、内容及地区权限。“最高规格”指该账号实际能够访问的最高规格。请仅下载自己拥有或获得授权的内容，本项目不会绕过 DRM。

Full 与 Lite

Full 版内置经过固定版本和 SHA-256 校验的 BBDown、FFmpeg/ffprobe、 MediaInfo CLI、yt-dlp 和 Deno，不需要用户另外安装这些命令行工具。

Lite 版只内置 BBDown。Windows 可通过 WinGet 安装其余依赖：

winget install --id Gyan.FFmpeg -e
winget install --id yt-dlp.yt-dlp -e
winget install --id MediaArea.MediaInfo.CLI -e
winget install --id DenoLand.Deno -e

macOS 可使用 Homebrew：

brew install ffmpeg yt-dlp media-info deno

Full 和 Lite 共用同一套功能页面。用户可以在设置中让每个工具优先使用内置版本、系统最新版或自定义路径。

musicdl 因许可证要求不随软件分发。安装方法、USTC/TUNA pip 镜像配置以及依赖检测均已放在音乐下载页面。

从源码构建

需要 Node.js 22、Rust stable 和对应平台的原生构建工具。

Windows x64：

npm install
npm run tauri:build:windows:lite
npm run tauri:build:windows:full

Apple Silicon macOS：

npm install
npm run tauri:build:lite
npm run verify:bundled
npm run tauri:build:full

Windows 构建脚本会下载 Git 仓库未保存的大型 sidecar，先校验压缩包及程序 SHA-256，再生成中英双语 NSIS 安装包。Windows 安装包可以不购买证书直接使用，但未签名版本可能触发 SmartScreen 的“未知发布者”提示。

GitHub Actions 也可以构建 Windows 安装包和 Apple Silicon macOS DMG。打开 Actions → Build Windows x64 → Run workflow 或 Actions → Build macOS Apple Silicon → Run workflow，即可同时构建 Full 和 Lite。两个工作流也会在推送 v* 标签时自动运行，并将不同版本作为保留 30 天的独立 artifact 上传。macOS 工作流会在 arm64 runner 上运行后端测试和内置工具校验，验证最终 DMG，并生成 SHA-256 校验文件。

文档

许

项目描述

面向 Windows 与 macOS 的开源媒体处理与下载 GUI 工具箱

MAD-Toolbox