𝓫𝓲𝓵𝓲𝓵𝓲

<img src="https://yellow-cdn.veclightyear.com/0a4dffa0/229cec2b-6846-4b29-90b0-f50591433b6d.png" width="500px"> <a href="https://bilibili.com" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/7904f5c2-4dd5-4e53-9203-9fcfe07df3e0.svg?logo=bilibili&logoColor=white&style=flat-square" alt="Bilibili"></a> <a href="https://python.org/" target="_blank"><img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/bilili?logo=python&style=flat-square"></a> <a href="https://pypi.org/project/bilili/" target="_blank"><img src="https://img.shields.io/pypi/v/bilili?style=flat-square" alt="pypi"></a> <a href="https://pypi.org/project/bilili/" target="_blank"><img alt="PyPI - Downloads" src="https://img.shields.io/pypi/dm/bilili?style=flat-square"></a> <a href="https://actions-badge.atrox.dev/yutto-dev/bilili/goto?ref=main"><img alt="Build Status" src="https://yellow-cdn.veclightyear.com/0a4dffa0/be6cc1da-835c-44c3-9d49-ffd98bb28daa.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fyutto-dev%2Fbilili%2Fbadge%3Fref%3Dmain&label=API%20Test&style=flat-square" /></a> <a href="LICENSE"><img alt="LICENSE" src="https://img.shields.io/github/license/yutto-dev/bilili?style=flat-square"></a> <a href="https://gitmoji.dev"><img src="https://img.shields.io/badge/gitmoji-%20😜%20😍-FFDD67?style=flat-square" alt="Gitmoji"></a> 🍻 𝓫𝓲𝓵𝓲𝓵𝓲，一个可以帮你快速下载 <a href="https://www.bilibili.com">B站</a>投稿视频以及番剧视频的命令行工具～～～

文档请点击这里 → bilili的可爱自我介绍

如果想要体验 v2 请点击这里 → yutto2.0.0-beta

特性

支持投稿视频（即原AV号视频）和番剧下载
多线程 + 分块下载，总之就是很快
断点续传，即使一次没下载完也可以继续下载
弹幕支持，自动下载弹幕并可转换为ASS格式弹幕

快速开始

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
- https://www.bilibili.com/bangumi/play/ssxxxxxx
- https://b23.tv/ssxxxxxx
- https://www.bilibili.com/bangumi/play/epxxxxxx
- https://b23.tv/epxxxxxx

安装 FFmpeg

由于大多数格式需要合并，所以 bilili 依赖于 FFmpeg，你需要事先安装好它对于 Windows 系统，请手动下载并解压后，将文件存放到任意文件夹下，然后将包含 ffmpeg.exe 的文件夹添加到环境变量中。

如果是 macOS 或 Linux 发行版，这一步可以通过包管理器轻松完成。

最后，你可以在终端直接运行 ffmpeg -version 来测试是否安装成功。

安装 bilili

通过 pip 安装

现在可以通过 pip 一键安装 bilili：

pip install bilili

通过源码安装

你也可以从 GitHub 下载最新源码进行安装：

git clone git@github.com:yutto-dev/bilili.git
cd bilili/
pip install .

运行

只需这样就可以运行 bilili：

bilili <url>

注意，需要将 <url> 替换为之前提到的视频主页 url。

参数

bilili 支持多种参数，具体使用方法请查看文档，此处不再赘述。

-t/--type 选择下载类型（flv、dash 或 mp4），默认为 dash 类型。注意，此参数仅表示下载源格式，最终所有格式都会转为 mp4。
-d/--dir 指定存储目录，默认为项目根目录。
-q/--quality 指定清晰度，默认为 127（8K 超高清）。
-n/--num-threads 指定最大下载线程数，默认为 16。
-p/--episodes 选集，默认为 ^~$（全选）。
-s/--with-section 同时下载附加剧集（PV、预告及特别篇等专区内容）。
-w/--overwrite 强制覆盖已下载视频。
-c/--sess-data 传入 cookies 中的 SESSDATA。
-y/--yes 跳过下载询问。
--audio-quality 指定音频质量等级，默认为 30280（320kbps）。
--playlist-type 指定播放列表类型，支持 dpl 和 m3u，默认为 dpl。设置为 no 则不生成播放列表。
--danmaku 指定弹幕类型，支持 xml 和 ass。设置为 no 则不下载弹幕，默认为 xml 弹幕。
--block-size 分块下载器的块大小，单位为 MB，默认为 128MB。设置为 0 时禁用分块下载。
--abs-path 将播放列表路径类型改为绝对路径。
--use-mirrors 启用多镜像下载功能。
--disable-proxy 禁用系统代理（测试版）。
--no-color 不使用任何颜色。
--debug 开启 debug 模式。