跳到主要内容
BiliFlow.
文档/进阶与帮助

命令行 CLI

使用命令行解析、下载和配置个人归档流程。

适用版本 v0.8.0官网独立维护
本页内容

命令行准备

CLI 使用软件源码环境，先完成源码安装。查看全部参数：

bash
python -m bilibili_downloader --help
python -m bilibili_downloader download --help

解析与下载

只读取作品资料：

bash
python -m bilibili_downloader test BV1GJ411x7h7
python -m bilibili_downloader test ep123

保存视频、弹幕与字幕：

bash
python -m bilibili_downloader download BV1GJ411x7h7 \
  --quality 80 \
  --output ./downloads \
  --danmaku \
  --subtitle

示例编号与 URL 仅表示命令格式，请替换为有权保存的真实来源。

番剧与归档示例

默认只导入正片；包含 PV、特别篇与花絮时显式启用附加章节：

bash
python -m bilibili_downloader download \
  "https://www.bilibili.com/bangumi/play/ss123" \
  --include-extras \
  --metadata

按作者建立目录，保存全部分 P、封面与元数据：

bash
python -m bilibili_downloader download BV1GJ411x7h7 \
  --page all \
  --cover \
  --metadata \
  --path-template "{author}/{title}{part_suffix}"

常用参数

参数用途
-q, --quality画质代码，默认 80
-o, --output输出目录，省略时读取应用设置
-p, --page分 P 序号或 all，默认 1
-c, --codec7 为 AVC，12 为 HEVC，13 为 AV1
--audio-only仅保存音轨
--audio-quality音频规格代码
-d, --danmaku弹幕转为 ASS
-s, --subtitle字幕转为 SRT
--subtitle-language首选字幕语言，默认 zh-Hans
--all-subtitles保存全部可用字幕轨道
--cover / --metadata保存封面 / JSON 元数据
--path-template覆盖本次相对目录模板
--include-extras包含番剧非正片章节
--acknowledge-copyright非交互环境首次下载确认使用边界

画质代码

代码画质代码画质
6240P16360P
32480P64720P
801080P1121080P+
1161080P601204K
125HDR126Dolby Vision
1278K

请求的规格仍需作品和账号实际支持，无法绕过权限。

首次确认与自动化

交互终端首次下载时要求输入 yes。非交互终端必须显式传入 --acknowledge-copyright，否则以退出码 2 结束。确认版本保存后无需每次重复。

CLI 与 GUI 共享使用边界，请阅读隐私与版权。更多开发与构建信息请查看仓库文档。