BBDown安装及常用下载命令
一、安装BBDown
安装前需要先下载.net8.0：
.net8.0下载地址：https://dotnetcli.azureedge.net/dotnet/SDK/8.0.100/dotnet-sdk-8.0.100-win-x64.exe
1、打开终端（命令提示符、PowerShell或终端）。
2、输入以下命令即可完成安装：dotnet tool install –global BBDown。
3、安装完成后，就可以在任何目录下直接使用 BBDown 命令了。
4、当需要更新软件时，只需运行：dotnet tool update –global BBDown。
为了方便在任何文件夹下直接调用 BBDown 命令，建议将 BBDown.exe 所在的目录路径，添加到系统的 PATH 环境变量中。
Windows：在“系统属性” -> “高级” -> “环境变量”中，找到系统变量中的 Path，点击“编辑”，然后“新建”并填入BBDown文件夹的路径即可。
macOS / Linux：在终端中编辑 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc），添加 export PATH=”$PATH:/你的BBDown路径”，然后执行 source 命令使其生效。
二、安装FFmpeg
Windows：从gyan.dev下载ffmpeg-release-full.7z并解压，然后将bin目录添加到系统环境变量PATH中。
macOS：在终端执行 brew install ffmpeg。
Linux (Debian/Ubuntu)：在终端执行 sudo apt update && sudo apt install ffmpeg
三、常用下载命令
安装好FFmpeg后，打开终端就可以用下面这些命令开始下载了。
- 下载单个视频（最简单用法）
在终端输入 BBDown，后跟视频链接，程序会自动选择最高画质进行下载。
BBDown “视频链接”
- 下载视频的同时下载弹幕
加上 –download-danmaku 参数，就可以把弹幕也保存下来。
BBDown –download-danmaku “视频链接”
🚀 进阶功能与命令参数
| 功能 | 命令示例 | 参数解释 |
|---|---|---|
| 批量下载 | BBDown -p ALL "视频或番剧链接" | 下载链接里的所有分P视频，适合下载整个番剧或合集 |
| 选集下载 | BBDown -p 3-5,7 "视频链接" | 下载第3到第5集，以及第7集 |
| 指定画质/编码 | BBDown -q "8K 超高清, HDR" "视频链接" | 使用 -q 参数按优先级选择画质。从列表中选你需要的，用逗号分隔即可常用画质选项： 4K 超高清, 1080P 高码率, HDR 真彩, 杜比视界-。 |
| 使用TV端接口 | BBDown -tv "视频链接" | 通过TV端接口下载，有概率去除B站水印，也可以解锁一些专属画质 |
| 交互式选择 | BBDown -ia "视频链接" | 如果你不清楚视频有哪些画质可选，加 -ia 参数会列出所有选项，让你手动挑选。 |
💡 更多实用参数一览
| 参数 | 功能说明 |
|---|---|
--audio-only | 只下载音频，不下载视频 |
--video-only | 只下载视频，不下载音频 |
--sub-only | 只下载字幕 |
--danmaku-only | 只下载弹幕 |
--cover-only | 只下载封面 |
-info | 仅解析视频信息，不进行下载，方便你查看详情 |
--use-aria2c | 调用aria2c进行多线程下载，可能需要提前配置好aria2c |
四、其他
1、开始解析后如果长时间没反应，重启命令行，重新输入指令
2、BBDown下载文件的保存位置，默认是执行命令时终端所在的文件夹。在下载命令中加上 –work-dir (或 -w) 参数，就能临时指定位置。
BBDown –work-dir “D:\Downloads\” “视频链接”
如果不想每次手动输入，可以在 BBDown.exe 同目录下创建 BBDown.config 文件。
在BBDown程序文件夹里，新建一个名为 BBDown.config 的文本文件。
用记事本打开，按每行一个参数的格式写入配置，比如永久固定下载路径到 D:\Videos：
#BBDown 配置文件
–work-dir
“D:\Videos”
之后每次运行命令，视频都会自动保存到这个文件夹里。
BBDown不会自动创建文件夹，如果填写的路径不存在，可能会因找不到位置而使用默认路径。最好提前创建好目标文件夹。
BBDown默认安装位置：C:\Users\用户名.dotnet\tools
3、登录 B 站账号（会员视频必须）
方法 A（推荐）
BBDown login
会弹出二维码，用 B 站手机客户端扫码即完成登录。
方法 B（手动 Cookie）
浏览器登录 B 站后 F12 → Network → 任意请求 → Request Headers → 复制 Cookie: 后面的整个字符串
使用时加上 -c “你的Cookie字符串”
或把 -c 写入 C:\Users\用户名.dotnet\tools\BBDown.config 文件永久生效。