MAD-Toolbox

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 兼容性、构建与安全说明
• Lite 版依赖安装
• Full 版打包和再分发规则
• 第三方软件署名和许可证
• 参与贡献
• 安全问题报告

许