Getting Started

快速上手 (Getting Started)

本章节介绍 BBDown 的安装获取、外部依赖工具准备以及最基本的使用示例。

---

1. 获取 BBDown

方式一：下载预编译可执行文件（推荐）

前往 GitHub Releases 页面下载适合你操作系统的压缩包：

• 正式发布版：Releases · aliveranme/BBDown
• CI 自动构建版：GitHub Actions 构建产物

解压后即可得到单文件可执行程序 BBDown（Windows 下为 BBDown.exe）。

方式二：从源码编译构建

需要安装 .NET 10 SDK：

# 克隆仓库
git clone https://github.com/aliveranme/BBDown.git
cd BBDown

# 编译主项目
dotnet build -c Release

# 运行
./BBDown/bin/Release/net10.0/BBDown --help

---

2. 外部依赖工具准备

BBDown 采用音视频分离下载方案（分别下载最高码率的视频流与音频流），下载完成后会自动调用外部混流工具合并为 .mp4 文件。

混流工具（二选一，必备）

工具	推荐用途	获取方式
FFmpeg（推荐）	普通视频、HDR、8K、杜比视界（需要 5.0+）混流	FFmpeg 官方下载 或 Gyan Builds (Windows)
MP4Box	杜比视界早期混流替代方案	GPAC 下载

配置建议：

1. 将 ffmpeg.exe（或 MP4Box.exe）所在目录添加到系统的环境变量 PATH 中。
2. 或者直接将 ffmpeg.exe 放在与 BBDown.exe 相同的目录下。
3. 若放置在自定义路径，可在运行时通过 --ffmpeg-path <path> 或 --mp4box-path <path> 手动指定。

下载加速工具（可选）

• aria2c：如需使用 aria2 代替内置的多线程下载引擎，可下载 aria2 并加入 PATH，运行时追加 --use-aria2c 参数。

---

3. 基础下载示例

下载单个普通视频

直接传入视频播放地址或 BV 号：

BBDown "https://www.bilibili.com/video/BV1qt4y1X7TW"
# 或直接传入 BV 号
BBDown BV1qt4y1X7TW

使用 TV 接口解析下载

TV 端接口通常对大 UP 主无视频水印，且部分源具备不同编码策略：

BBDown -t "https://www.bilibili.com/video/BV1qt4y1X7TW"

仅查看视频流与分 P 信息（不下载）

通过 -I（--only-show-info）查看视频详细参数与所有可用音视频轨道：

BBDown -I "https://www.bilibili.com/video/BV1qt4y1X7TW"

交互式选择画质与音轨

通过 -i（--interactive）在终端中列出所有可选清晰度与编码，输入序号确认：

BBDown -i "https://www.bilibili.com/video/BV1qt4y1X7TW"

下载番剧 / 电影全集

通过 -p ALL 下载番剧列表中的全部剧集：

BBDown -p ALL "https://www.bilibili.com/bangumi/play/ss33073"

---

4. 输出产物说明

在默认配置下，BBDown 在当前执行目录下生成以下文件：

• <标题>.mp4：合并了最佳视频轨、音频轨以及外挂字幕/章节信息的最终视频文件。
• <标题>.srt / <标题>.ass：若包含字幕且未跳过，字幕会自动嵌入 MP4 并额外保留一份转换好的文本字幕。
• <标题>.xml：若开启 -d（--download-danmaku），弹幕将保存为 XML 文件。