快如闪电的bilibili下载工具

基于 Python 现代 Async 异步特性，高速批量下载整部动漫，电视剧，电影，up投稿…

特性 Features

高性能，高并发，Asynchronous everywhere，得益于Python对于协程的支持，以及现代 Async HTTP 框架 httpx ，和 anyio ：

• 单个媒体文件（音频/视频）的分段异步下载，以及备选服务器的同时利用
• 单个视频的音视频异步下载
• 多个视频的异步下载
• 断点续传
• 用户可控的并发量设置
• 与高并发配合的很好的进度条
• HTTP/2协议支持
• 异步文件I/O
• 异步视频合成进程

依赖环境 Environment

1. Python 相关依赖（需要python3.8及以上）

pip install 'httpx[http2]' rich json5

2. FFmpeg ：一个命令行视频工具，用于合成下载的音频和视频

   • macOS 下可以通过brew install ffmpeg进行安装。
   • Windows 下载请至官网 https://ffmpeg.org/download.html#build-windows ，安装好后需要配置环境变量。
   • 最终确保在命令行中可以调用ffmpeg命令即可。

快速上手 Quick Start

批量下载

批量下载整部动漫，电视剧，电影，up投稿…..只需要把命令中的url替换成你要下载的系列中任意一个视频的网页链接。
到 bilibili 上找一个来试试吧～，比如这个李宏毅老师的机器学习视频：链接

python bili_cmd.py get_series 'url'

会下载文件至当前目录的videos文件夹中，默认自动创建。

💡提示：在zsh终端中可能要用''将url包住，其他终端暂未测试。

• 目前支持的类型
  • 投稿视频
  • 番剧
  • 电视剧
  • 纪录片
  • 电影

get_series很强大，会自动识别系列所有视频并下载，如果该系列只有一个视频（比如单p投稿）也是可以正常下载的。

💡什么是一个系列：比如一个多p投稿的所有p，一部动漫的所有集。

单个下载

用户😨：我不想下载那么多，只想下载单个视频。没问题，试试这个，只需要提供那个视频的网页链接：

python bili_cmd.py get_video 'url'

下载特定up主的投稿

假设你是一个嘉心糖，想要下载嘉然小姐最新投稿的100个视频，那么你可以使用命令：

python bili_cmd.py get_up '672328094' -num 100

672328094是up主的id，在up空间首页的url中就可以找到哦，例如： https://space.bilibili.com/672328094

下载分区视频

假设你喜欢看舞蹈区👍，想要下载最近30天播放量最高的20个超级敏感宅舞视频，那么你可以使用

python bili_cmd.py get_cate 宅舞 -keyword 超级敏感 -order click -num 20 -days 30

get_cate支持大部分分区，可以使用排序，关键词搜索等，详细请参考python bili_cmd.py -h或代码注释

下载收藏夹视频

如果你需要下载自己或者其他人收藏夹中的视频，你可以使用get_favour方法

python bili_cmd.py get_favour '1445680654' -num 20

1445680654是收藏夹id，如果要知道一个收藏夹的id是什么，最简单的办法是在b站网页左侧列表中点击切换到该收藏夹，然后浏览器的url就会出现该收藏夹的id，例如 https://space.bilibili.com/11499954/favlist?fid=1445680654 ，其中url中的fid就是收藏夹id。

下载合集

如果你需要下载up主发布的合集，你可以使用get_collect方法

python bili_cmd.py get_collect '630'

630是合集id，如果要知道一个合集的id是什么，最简单的办法是在该合集详情页的url找到sid参数，例如 https://space.bilibili.com/369750017/channel/collectiondetail?sid=630

进阶使用 Advance Guide

请使用python bili_cmd.py -h查看更多参数提示，视频画面质量选择，包括并发量控制，下载目录等。

你是大会员？🥸

请在-cookie参数中填写浏览器缓存的SESSDATAcookie，填写后可以下载需要大会员的视频。

在 python 中调用

觉得命令行太麻烦，不够强大？想要直接调用模块？下面是一个小例子。

import asyncio
from lighting_downloader import Downloader


async def main():
    d = Downloader(video_concurrency=5, part_concurrency=10)
    cor1 = d.get_series(
        'https://www.bilibili.com/bangumi/play/ss28277?spm_id_from=333.337.0.0'
        , quality=999)
    cor2 = d.get_up_videos(mid='436482484')
    cor3 = d.get_video('https://www.bilibili.com/bangumi/play/ep477122?from_spmid=666.4.0.0')
    await asyncio.gather(cor1, cor2, cor3)
    await d.aclose()

asyncio.run(main())

Downloader类的下载方法都是异步的，所以你可以自由组合这些任务。同时我们把并发数调大，是时候挑战网速了。