𝓫𝓲𝓵𝓲𝓵𝓲

全新文档请访问 https://bilili.sigure.xyz

使用 Python 下载 B 站视频，ビリリ~

仅限个人学习和研究使用，切勿用于其他用途

特性

• 支持 ACG 视频（也即原 AV 号视频）和番剧下载
• 多线程 + 分块下载，轻松跑满你的带宽
• 断点续传，即便一次没下完也可以接着下载
• 弹幕支持，自动下载弹幕并转换为 ass 弹幕，本地播放器也可以体验 B 站的看视频体验
• 全清晰度支持，本地可以看任意在线看到的清晰度，而且本地播放不受限于带宽

快速开始

bilili 可以从以下两种视频主页获取视频

• 普通视频主页：
  • https://www.bilibili.com/video/avxxxxxx
  • https://b23.tv/avxxxxxx
  • https://www.bilibili.com/video/BVxxxxxx
  • https://b23.tv/BVxxxxxx
• 番剧视频主页（非播放页面，在播放页面点一下封面即可跳转）： https://www.bilibili.com/bangumi/media/mdxxxxxx

安装 FFmpeg

由于大多数格式需要合并，所以 bilili 依赖于 ffmpeg，你需要事先安装好它

Windows 请手动下载后，存放到任意目录下，并将 ffmpeg.exe 所在目录添加到环境变量

而如果是 *nix，可以很方便地通过包管理器一键完成

你可以通过直接在终端运行 ffmpeg -version 测试是否安装成功

安装 Bilili

pip 安装

现在 bilili 支持通过 pip 一键安装

pip install bilili

源码安装

此外你还可以从 GitHub 上下载最新的源码进行安装

git clone git@github.com:SigureMo/bilili.git
cd bilili/
python setup.py build
python setup.py install

运行

运行非常简单～

bilili <url>

当然，你需要将 <url> 替换为前面的视频主页 url

参数

bilili 还支持很多参数，具体如下

• -f/--format 选择下载格式（flv or m4s or mp4），默认为 m4s 格式，注意该参数仅代表下载源格式，所有格式最后均会转为 mp4
• -d/--dir 指定存储目录，默认为项目根目录
• -q/--quality 指定清晰度，默认为 120，对应关系如下

  code	清晰度
  120	超清 4K
  116	超清 1080P60
  112	高清 1080P+
  80	高清 1080P
  74	高清 720P60
  64	高清 720P
  32	清晰 480P
  16	流畅 360P
  6	极速 240P，MP4 格式专属，无法作为参数指定
  208	高清 1080P，MP4 格式专属，无法作为参数指定
  192	高清 720P，MP4 格式专属，无法作为参数指定

  如果不存在指定的清晰度，则会按照默认的清晰度搜索机制进行调节，比如指定清晰度为 80，首先会依次降清晰度搜索 74、64、32、16、6，如果依然找不到合适的则继续升清晰度搜索 112、116、120

• -t/--num-threads 指定最大下载线程数，默认为 30
• -p/--episodes 选集，可通过以下方式进行选择，默认为 all
  • <p1> 单独下某一剧集
  • <p1>,<p2>,<p3>,...,<pn> 即通过 , 分割，不要加空格
  • <p_start>~<p_end> 即通过 ~ 分隔，下载起始到终止的剧集
  • all 全部下载
  • 你甚至还可以通过混合的方式来选集，比如 1,3,7~9,13,15~17 选中了 1、3、7、8、9、13、15、16、17 话

    这里使用的序号是视频的顺序序号，而不是番剧所标注的第 n 话，因为有可能会出现 第 x.5 话 的情况，此时一定要按照顺序自行计数

• -w/--overwrite 强制覆盖已下载视频
• -c/--sess-data 传入 cookies 中的 SESSDATA
• -y/--yes 跳过下载询问
• --playlist-type 指定播放列表类型，支持 dpl 和 m3u ，默认为 dpl，设置为 no 即不生成播放列表
• --path-type 指定播放列表路径的类型（rp：相对路径，ap：绝对路径），默认为相对路径
• --danmaku 指定弹幕类型，支持 xml 和 ass，如果设置为 no 则不下载弹幕，默认为 xml 弹幕
• --block-size 分块下载器的块大小，单位为 MB，默认为 128MB，设置为 0 时禁用分块下载
• --disable-proxy 禁用系统代理 「Beta」
• --debug 开启 debug 模式

参数的使用

参数的使用很简单，比如修改格式为 flv，只需要

bilili <url> --format=flv
# 或者
bilili <url> -f flv

不需要指定具体值，只切换 True or False 的参数也不需要在命令中指定值，比如开启强制覆盖已下载视频选项

bilili <url> --overwrite
# 或者
bilili <url> -w

注意事项

视频格式

视频格式是指 bilibili 直接提供的资源格式，本程序最终都会转换成通用的 mp4 格式方便观看，不同格式在通用性、下载速度等方面的比较如下

	M4S	FLV	MP4
支持程度	中（少数视频不支持）	高	低（仅支持 acg_video）
下载速度	高	低	中
需要 FFmpeg 合并	是	是	否
清晰度支持	全面	中（部分较新的 4K 等清晰度无法获取）	极少（仅支持 1080P 及更低的清晰度，且无法选择）
我该怎么选	B 站当前使用的格式，拥有齐全的清晰度和最佳的下载速度	当 M4S 无法下载时的备用选项	除了不需要合并，一无是处

高清晰度下载

如果你想下载大会员才能看的清晰度，请先确保你是大会员，本程序不会帮助你去获取你没有权限获取的视频

而如果你已经是大会员，登录帐号后，在 B 站按 F12 开启控制台，切换到 Network 选项卡，刷新页面，在第一个资源（往往是 html）的 Header -> cookie 中找到 SESSDATA 字段，并通过相关参数传入程序即可

断点续传

下载器默认拥有着断点续传的机制，这保证了意外中断后重新下载能够接着原来的进度继续进行

但下载器不会去记录是采用什么格式采用何种分块进行下载的，断点续传一定会读取本地已有的文件大小，从该大小位置开始继续下载

这就导致了如果你在一次下载中途停止后，修改了 format、block-size、quality 参数再次启动程序的话，两次下载的内容将截然不同，但断点续传机制仍然会强制拼接在一起，为了避免该问题，请在修改相关参数时删除已下载部分，或者直接添加参数 overwrite 来自动完成该过程

分块下载

分块下载可以将 B 站的资源单元进一步分块，每个线程只下载一块，这样充分利用了多线程的优势，即便只有一两个资源，你也可以轻松跑满带宽

弹幕

默认会下载 XML 格式的弹幕，如果想使用 ASS 格式的弹幕（大多数播放器都支持，可以自动加载），可以加参数 --danmaku=ass 自动转换，或者手动在us-danmaku转换

另外，程序内自动转换依赖 danmaku2ass ，但是并没有将它存放在我的代码里，而是根据需要动态从 github 上下载并加载的

播放列表

默认生成相对路径类型的 PotPlayer 播放列表，如果你不想使用 PotPlayer 的话，可以通过参数来修改

视频无法下载

当出现某个视频无法下载的情况时，如果原因是 「啥都木有」，那么你只需要重新启动程序一般就可以解决

而原因是其他情况时，请针对该情况进行检查，如果该视频你确实没有获取权限，请利用选集参数跳过该视频，这样就可以下载其余视频了

参与贡献

请阅读 CONTRIBUTING.md

参考项目

1. Bilibili - 1033020837
2. BilibiliVideoDownload - blogwy
3. BiliUtil