back to home

nilaoda / BBDown

Bilibili Downloader. 一个命令行式哔哩哔哩下载器.

13,380 stars
1,569 forks
241 issues
C#Dockerfile
Chat with CodebaseArchitecture ScanSecurity AuditExplain Codebase

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing nilaoda/BBDown in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Click here to launch the interactive analysis workspace

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind-ai.vercel.app/repo/nilaoda/BBDown)
Preview:Analyzed by RepoMind

Repository Summary (README)

Preview

img img img img Build Latest

本项目仅供个人学习、研究和非商业性用途。用户在使用本工具时，需自行确保遵守相关法律法规，特别是与版权相关的法律条款。开发者不对因使用本工具而产生的任何版权纠纷或法律责任承担责任。请用户在使用时谨慎，确保其行为合法合规，并仅在有合法授权的情况下使用相关内容。

BBDown

一个命令行式哔哩哔哩下载器. Bilibili Downloader.

注意

本软件混流时需要外部程序：

  • 普通视频：ffmpeg ，或 mp4box
  • 杜比视界：ffmpeg5.0以上或新版mp4box.

快速开始

本软件已经以 Dotnet Tool 形式发布

如果你本地有dotnet环境，使用如下命令即可安装使用

dotnet tool install --global BBDown

如果需要更新bbdown，使用如下命令

dotnet tool update --global BBDown

下载

Release版本：https://github.com/nilaoda/BBDown/releases

自动构建的测试版本：https://github.com/nilaoda/BBDown/actions

开始使用

目前命令行参数支持情况

Description:
  BBDown是一个免费且便捷高效的哔哩哔哩下载/解析软件.

Usage:
  BBDown <url> [command] [options]

Arguments:
  <url>  视频地址 或 av|bv|BV|ep|ss

Options:
  -tv, --use-tv-api                              使用TV端解析模式
  -app, --use-app-api                            使用APP端解析模式
  -intl, --use-intl-api                          使用国际版(东南亚视频)解析模式
  --use-mp4box                                   使用MP4Box来混流
  -e, --encoding-priority <encoding-priority>    视频编码的选择优先级, 用逗号分割 例: "hevc,av1,avc"
  -q, --dfn-priority <dfn-priority>              画质优先级,用逗号分隔 例: "8K 超高清, 1080P 高码率, HDR 真彩, 杜比视界"
  -info, --only-show-info                        仅解析而不进行下载
  --show-all                                     展示所有分P标题
  -aria2, --use-aria2c                           调用aria2c进行下载(你需要自行准备好二进制可执行文件)
  -ia, --interactive                             交互式选择清晰度
  -hs, --hide-streams                            不要显示所有可用音视频流
  -mt, --multi-thread                            使用多线程下载(默认开启)
  --video-only                                   仅下载视频
  --audio-only                                   仅下载音频
  --danmaku-only                                 仅下载弹幕
  --sub-only                                     仅下载字幕
  --cover-only                                   仅下载封面
  --debug                                        输出调试日志
  --skip-mux                                     跳过混流步骤
  --skip-subtitle                                跳过字幕下载
  --skip-cover                                   跳过封面下载
  --force-http                                   下载音视频时强制使用HTTP协议替换HTTPS(默认开启)
  -dd, --download-danmaku                        下载弹幕
  --skip-ai                                      跳过AI字幕下载(默认开启)
  --video-ascending                              视频升序(最小体积优先)
  --audio-ascending                              音频升序(最小体积优先)
  --allow-pcdn                                   不替换PCDN域名, 仅在正常情况与--upos-host均无法下载时使用
  -F, --file-pattern <file-pattern>              使用内置变量自定义单P存储文件名:
  
                                                 <videoTitle>: 视频主标题
                                                 <pageNumber>: 视频分P序号
                                                 <pageNumberWithZero>: 视频分P序号(前缀补零)
                                                 <pageTitle>: 视频分P标题
                                                 <bvid>: 视频BV号
                                                 <aid>: 视频aid
                                                 <cid>: 视频cid
                                                 <dfn>: 视频清晰度
                                                 <res>: 视频分辨率
                                                 <fps>: 视频帧率
                                                 <videoCodecs>: 视频编码
                                                 <videoBandwidth>: 视频码率
                                                 <audioCodecs>: 音频编码
                                                 <audioBandwidth>: 音频码率
                                                 <ownerName>: 上传者名称
                                                 <ownerMid>: 上传者mid
                                                 <publishDate>: 收藏夹/番剧/合集发布时间
                                                 <videoDate>: 视频发布时间(分p视频发布时间与<publishDate>相同)
                                                 <apiType>: API类型(TV/APP/INTL/WEB)
  
                                                 默认为: <videoTitle>
  -M, --multi-file-pattern <multi-file-pattern>  使用内置变量自定义多P存储文件名:
  
                                                 默认为: <videoTitle>/[P<pageNumberWithZero>]<pageTitle>
  -p, --select-page <select-page>                选择指定分p或分p范围: (-p 8 或 -p 1,2 或 -p 3-5 或 -p ALL 或 -p LAST 或 -p 3,5,LATEST)
  --language <language>                          设置混流的音频语言(代码), 如chi, jpn等
  -ua, --user-agent <user-agent>                 指定user-agent, 否则使用随机user-agent
  -c, --cookie <cookie>                          设置字符串cookie用以下载网页接口的会员内容
  -token, --access-token <access-token>          设置access_token用以下载TV/APP接口的会员内容
  --aria2c-args <aria2c-args>                    调用aria2c的附加参数(默认参数包含"-x16 -s16 -j16 -k 5M", 使用时注意字符串转义)
  --work-dir <work-dir>                          设置程序的工作目录
  --ffmpeg-path <ffmpeg-path>                    设置ffmpeg的路径
  --mp4box-path <mp4box-path>                    设置mp4box的路径
  --aria2c-path <aria2c-path>                    设置aria2c的路径
  --upos-host <upos-host>                        自定义upos服务器
  --force-replace-host                           强制替换下载服务器host(默认开启)
  --save-archives-to-file                        将下载过的视频记录到本地文件中, 用于后续跳过下载同个视频
  --delay-per-page <delay-per-page>              设置下载合集分P之间的下载间隔时间(单位: 秒, 默认无间隔)
  --host <host>                                  指定BiliPlus host(使用BiliPlus需要access_token, 不需要cookie, 解析服务器能够获取你账号的大部分权限!)
  --ep-host <ep-host>                            指定BiliPlus EP host(用于代理api.bilibili.com/pgc/view/web/season, 大部分解析服务器不支持代理该接口)
  --tv-host <tv-host>                            自定义tv端接口请求Host(用于代理api.snm0516.aisee.tv)
  --area <area>                                  (hk|tw|th) 使用BiliPlus时必选, 指定BiliPlus area
  --config-file <config-file>                    读取指定的BBDown本地配置文件(默认为: BBDown.config)
  --version                                      Show version information
  -?, -h, --help                                 Show help and usage information


Commands:
  login    通过APP扫描二维码以登录您的WEB账号
  logintv  通过APP扫描二维码以登录您的TV账号
  serve    以服务器模式运行

功能

  • 番剧下载(Web|TV|App)
  • 课程下载(Web)
  • 普通内容下载(Web|TV|App)
  • 合集/列表/收藏夹/个人空间解析
  • 多分P自动下载
  • 选择指定分P进行下载
  • 选择指定清晰度进行下载
  • 下载外挂字幕并转换为srt格式
  • 自动合并音频+视频流+字幕流+章节信息(使用ffmpeg或mp4box)
  • 单独下载视频/音频/字幕
  • 二维码登录账号
  • 多线程下载
  • 支持调用aria2c下载
  • 支持AVC/HEVC/AV1编码
  • 支持8K/HDR/杜比视界/杜比全景声下载
  • 自定义存储文件名

TODO

  • 自动刷新cookie
  • 支持更多自定义选项

使用教程

<details> <summary>配置文件 (NEW)</summary>

在1.4.9或更高版本中，BBDown支持读取本地配置文件以简化命令行的手动输入。

如果用户没有指定--config-file，则默认读取程序同目录下的BBDown.config文件；若用户指定，则读取特定文件。

一个典型的配置文件:

#本文件是BBDown程序的配置文件
#以#开头的都会被程序忽略
#然后剩余非空白内容程序逐行读取，对于一个选项，其参数应当在下一行出现

#例如下面将设置输出文件名格式
--file-pattern
<videoTitle>[<dfn>]

--multi-file-pattern
<videoTitle>/[P<pageNumberWithZero>]<pageTitle>[<dfn>]

#下面设置下载多个分P时，每个分P的下载间隔为2秒
--delay-per-page
2

#开启弹幕下载功能
--download-danmaku
</details> <details> <summary>自定义输出文件名格式 (NEW)</summary>

在1.4.9或更高版本中，BBDown支持用户自定义合并时的文件名组成。

代码含义
<videoTitle>视频主标题
<pageNumber>视频分P序号
<pageNumberWithZero>视频分P序号(前缀补零)
<pageTitle>视频分P标题
<bvid>视频BV号
<aid>视频aid
<cid>视频cid
<dfn>视频清晰度
<res>视频分辨率
<fps>视频帧率
<videoCodecs>视频编码
<videoBandwidth>视频码率
<audioCodecs>音频编码
<audioBandwidth>音频码率
<ownerName>上传者名称(下载番剧时，该值为"")
<ownerMid>上传者mid(下载番剧时，该值为"")
<publishDate>发布时间(yyyy-MM-dd_HH-mm-ss)
<apiType>API类型（TV/APP/INTL/WEB）
</details> <details> <summary>WEB/TV鉴权</summary>

扫码登录网页账号：

BBDown login

然后按照提示操作

扫码登录云视听小电视账号：

BBDown logintv

然后按照提示操作

PS: 如果登录报错The type initializer for 'Gdip' threw an exception，请参考 #37 解决

手动加载网页cookie：

BBDown -c "SESSDATA=******" "https://www.bilibili.com/video/BV1qt4y1X7TW"

手动加载云视听小电视token：

BBDown -tv -token "******" "https://www.bilibili.com/video/BV1qt4y1X7TW"
</details> <details> <summary>APP鉴权</summary>

根据 #123 ，可以填写TV登录产生的access_token来给APP接口使用。可复制BBDownTV.data到BBDownApp.data使程序自动读取.

目前程序无法自动获取鉴权信息，推荐通过抓包来获取.

在请求Header中寻找键为authorization的项，其值形为identify_v1 5227************1，其中的5227************1就是token(access_key)

获取后手动通过-token命令加载, 或写入BBDownApp.data使程序自动读取.

BBDown -app -token "******" "https://www.bilibili.com/video/BV1qt4y1X7TW"
</details> <details> <summary>常用命令</summary>

下载普通视频：

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

使用TV接口下载(粉丝量大的UP主基本上是无水印片源)：

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

当分P过多时，默认会隐藏展示全部的分P信息，你可以使用如下命令来显示所有每一个分P。

BBDown --show-all "https://www.bilibili.com/video/BV1At41167aj"

选择下载某些分P的三种情况：

  • 单个分P：10
BBDown "https://www.bilibili.com/video/BV1At41167aj?p=10"
BBDown -p 10 "https://www.bilibili.com/video/BV1At41167aj"
  • 多个分P：1,2,10
BBDown -p 1,2,10 "https://www.bilibili.com/video/BV1At41167aj"
  • 范围分P：1-10
BBDown -p 1-10 "https://www.bilibili.com/video/BV1At41167aj"

下载番剧全集：

BBDown -p ALL "https://www.bilibili.com/bangumi/play/ss33073"
</details> <details> <summary>API服务器</summary>

启动服务器（自定义监听地址和端口）：

BBDown serve -l http://0.0.0.0:12450

API服务器不支持HTTPS配置，如果有需要请自行使用nginx等反向代理进行配置

API详细请参考json-api-doc.md

</details>

演示

1

下载完毕后在当前目录查看MP4文件：

2

致谢