𝓫𝓲𝓵𝓲𝓵𝓲

<p align="center"> <img src="./docs/.vuepress/public/logo.png" width="500px"> </p> <p align="center"> <a href="https://bilibili.com" target="_blank"><img src="https://img.shields.io/badge/bilibili-1eabc9.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://img.shields.io/endpoint.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> </p> <p align="center"><strong>🍻 𝓫𝓲𝓵𝓲𝓵𝓲，一个可以帮你快速下载 <a href="https://www.bilibili.com">B 站</a>投稿视频以及番剧视频的 CLI～～～</strong></p>

文档戳这里啦 → bilili の可愛い自己紹介

[!WARNING]

由于 B 站近期 API 的变动较大，导致 bilili 部分功能无法正常使用，相关问题已在 v2 版本（yutto）中修复，限于个人精力，无法同时维护两个版本，所以建议大家尽快迁移至 v2 版本，感谢大家一直以来对 bilili 的支持～

特性

• 支持投稿视频（也即原 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 安装

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

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 or dash or 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 模式

参与贡献

请阅读 CONTRIBUTING.md