[!info] related notes

• 相关主题: bilibili

BBDown

这是什么

BBDown 是一个开源的命令行哔哩哔哩下载/解析工具（Bilibili Downloader），以 .NET 编写，跨平台（Windows / macOS / Linux）。核心定位是“给一个视频地址或 av / BV / ep / ss 号，就能把音视频、字幕、弹幕、封面按需拉下来”。已发布为 Dotnet Tool，dotnet tool install --global BBDown 即可安装，也提供独立可执行文件。

适用平台与交互方式

• 运行平台：跨平台（.NET），本文以 Windows 为主要使用环境。
• 交互方式：
  • interface/cli：主用法，终端命令 BBDown <url> [options]。
  • interface/api：BBDown serve -l http://0.0.x.x:12450 以服务器模式运行，暴露 HTTP 接口，可被脚本或 AI agent 调用。
• 外部依赖：混流需要 ffmpeg 或 mp4box（杜比视界需 ffmpeg 5.0+ 或新版 mp4box）；可选调用 aria2c 做多线程下载。

核心特点 / 优势 / 局限

• 覆盖番剧、课程、普通视频，以及合集 / 列表 / 收藏夹 / 个人空间的解析下载。
• 多分P自动下载，-p 选择分P或范围（-p 1-10、-p ALL、-p LAST）。
• -q 选择清晰度，支持 8K / HDR / 杜比视界 / 杜比全景声；-e 指定 AVC / HEVC / AV1 编码优先级。
• 可单独下载视频 / 音频 / 字幕 / 弹幕 / 封面，外挂字幕转 srt。
• 二维码扫码登录 WEB / TV 账号，或用 cookie / access_token 下载会员内容。
• 局限：会员与高清片源需自备鉴权；cookie 无法自动刷新；混流依赖外部 ffmpeg / mp4box。

常见用途

• 下载普通视频：BBDown "https://www.bilibili.com/video/BV1qt4y1X7TW"
• 使用 TV 端解析模式：BBDown -tv "<url>"
• 下载番剧全集：BBDown -p ALL "https://www.bilibili.com/bangumi/play/ss33073"
• 仅解析不下载：BBDown -info "<url>"
• 服务器模式（供程序 / AI 调用）：BBDown serve -l http://0.0.x.x:12450

相关链接 / 官方入口

• 仓库与文档：https://github.com/nilaoda/BBDown
• 发布版本：https://github.com/nilaoda/BBDown/releases
• Dotnet Tool 包：https://www.nuget.org/packages/BBDown/