Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yutto-dev/bilili
:beers: bilibili video (including bangumi) and danmaku downloader | B站视频（含番剧）、弹幕下载器
https://github.com/yutto-dev/bilili
bilibili crawler danmaku download downloader multithread python3 requests spider subtitle video
Last synced: about 2 months ago
JSON representation
:beers: bilibili video (including bangumi) and danmaku downloader | B站视频（含番剧）、弹幕下载器
- Host: GitHub
- URL: https://github.com/yutto-dev/bilili
- Owner: yutto-dev
- License: gpl-3.0
- Created: 2019-08-17T18:53:11.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2024-04-12T15:57:47.000Z (8 months ago)
- Last Synced: 2024-04-12T23:10:02.950Z (8 months ago)
- Topics: bilibili, crawler, danmaku, download, downloader, multithread, python3, requests, spider, subtitle, video
- Language: Python
- Homepage: https://bilili.nyakku.moe
- Size: 1.57 MB
- Stars: 1,054
- Watchers: 12
- Forks: 84
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome - yutto-dev/bilili - :beers: bilibili video (including bangumi) and danmaku downloader | B站视频（含番剧）、弹幕下载器 (Python)
- awesome-bilibili-extra - Bilili - 哔哩哔哩视频、弹幕下载器.  (下载工具 / 直播脚本)
README
# 𝓫𝓲𝓵𝓲𝓵𝓲
🍻 𝓫𝓲𝓵𝓲𝓵𝓲，一个可以帮你快速下载 B 站投稿视频以及番剧视频的 CLI～～～
**文档戳这里啦 → [bilili の可愛い自己紹介](https://bilili.nyakku.moe)**
如果想要体验 v2 请戳这里 → [yutto2.0.0-beta](https://github.com/yutto-dev/yutto)
## 特性
- 支持投稿视频（也即原 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 请[手动下载](https://ffmpeg.org/download.html)并解压后，存放到任意文件夹下，之后将 `ffmpeg.exe` 所在文件夹**添加到环境变量**
而如果是 macOS 或者 Linux 发行版，这一步可以很方便地通过包管理器一键完成啦～
最后你可以通过直接在终端运行 `ffmpeg -version` 测试是否安装成功
### 安装 bilili
#### pip 安装
现在 bilili 支持通过 pip 一键安装
```bash
pip install bilili
```
#### 源码安装
此外你还可以从 GitHub 上下载最新的源码进行安装
```bash
git clone [email protected]:yutto-dev/bilili.git
cd bilili/
pip install .
```
### 运行
你只需要这样就可以运行 bilili 啦～
```bash
bilili
```
当然，你需要将 `` 替换为前面的视频主页 url
## 参数
bilili 还支持很多参数，但参数使用方法等内容此处不作赘述，详情请访问[文档](https://bilili.nyakku.moe/cli/)
- `-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` 禁用系统代理 「Beta」
- `--no-color` 不使用任何颜色
- `--debug` 开启 `debug` 模式
## 参与贡献
请阅读 [CONTRIBUTING.md](CONTRIBUTING.md)