Skip to content

Repository files navigation

MAD Toolbox 图标

MAD Toolbox

English · Checks · MIT License

"There are many toolboxes, but this one is for you, MADer."

MAD Toolbox 是一个面向 Windows 和 macOS 的开源媒体工具箱。它把表单和 GUI 选项转换为 BBDown、yt-dlp、FFmpeg、MediaInfo 等工具的参数数组,不 经过 Shell 执行;任务状态统一显示在任务中心,并可导出 CLI 原始任务日志。

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

主要功能

  • 哔哩哔哩下载:直接遵循 BBDown 的原始 CLI 行为;提供最高规格、音频、封面、 字幕等简易模式,同时尽量覆盖 BBDown 高级参数。支持扫码登录并使用当前 账号可用的下载规格。
  • 网络视频下载:使用 yt-dlp,自动测试 YouTube 连通性,提示开启全局代理或 填写 HTTP、HTTPS、SOCKS 代理,并提供格式、字幕、浏览器 Cookie 失败兜底等高级设置。
  • 媒体处理:支持文件和目录拖拽、中文 MediaInfo 信息、转换、重新封装、 视频/音频/字幕抽流、ASS/SRT、GIF、序列帧以及码率、帧率、尺寸、裁切、 旋转、速度、像素格式和音频参数。
  • PR 智能兼容:覆盖 FLV、WebM、MKV、AVI、MPEG、TS/MXF 等常见视频; 能复制时优先输出 MP4/MOV,否则回退到高质量 ProRes MOV。无损音频转 WAV,有损音频输出 MP3 或 AAC/M4A,常见文字字幕统一转 SRT。
  • 音乐下载:检测用户自行安装的 Python 3 和 musicdl 后启用,不在安装包内 捆绑 musicdl。
  • 任务中心:任务切换页面后继续运行,支持取消并为每个任务导出 CLI 原始日志。
  • 设置模板:每个功能支持多个模板并自动恢复上次设置,按原值保存在 WebView 的本机应用数据中。

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

Full 与 Lite

Full 版内置经过固定版本和 SHA-256 校验的 BBDown、FFmpeg/ffprobe、 MediaInfo CLI、yt-dlp 和 Deno,不需要用户另外安装这些命令行工具;Windows Full 安装包还内置 WebView2 离线安装程序,安装和启动不需要网络。

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

Windows Lite 不会内置或启动 WebView2 安装器,而是使用系统已有的 WebView2 Runtime;Windows 10 22H2 和 Windows 11 通常已经提供该 Runtime。若系统确实缺少 Runtime,Lite 需要先单独安装它,或者改用内置 WebView2 离线安装器的 Full 版。

macOS 可使用 Homebrew:

brew install ffmpeg yt-dlp media-info deno

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

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

本地开发与从源码构建

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

Windows x64:

npm ci
npm run tauri:dev

构建 Windows 安装包:

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

Apple Silicon macOS:

npm ci
npm run tauri:dev

构建 Apple Silicon macOS 安装包:

npm run tauri:build:lite
npm run tauri:build:full

Windows 构建脚本会校验随仓库分发的 BBDown,并在 Full 构建时下载、校验其余 Windows sidecar 及 Full 版的 WebView2 离线安装包,随后生成中英双语 NSIS 安装包;这些 网络访问发生在构建阶段,不是用户安装和启动阶段。Lite 构建不会下载或打包 WebView2 安装包。未签名安装包可能触发 SmartScreen 的“未知发布者”提示。

GitHub Actions 可手动运行 Windows 和 Apple Silicon macOS 的 Full/Lite 构建; 推送 v* 标签时也会自动执行,并将产物保留 30 天。详细构建与校验规则见下方文档。

文档

许可证

MAD Toolbox 源代码使用 MIT License。所有内置工具保留各自的许可证、 版权和署名,详见 THIRD_PARTY_NOTICES.md

About

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

Topics

Resources

Contributing

Security policy

Stars

8 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages