yutto^2.0.0-beta

yutto，一个可爱且任性的 B 站下载器（CLI）

当前 yutto 尚处于 beta 阶段，有任何建议尽管在 Discussions 提出～～～

版本号为什么是 2.0

因为 yutto 是 bilili 的後輩呀～

从安装开始～

包管理器一键安装啦

目前 yutto 已经可以通过部分包管理器直接安装～

使用 Homebrew 的用户可以尝试下下面的命令：

brew tap siguremo/tap
brew install yutto

使用 paru（Arch 上的 AUR 包管理器）的用户可以尝试下这样的命令（感谢 @ouuan）：

paru -S yutto

使用 Docker

你也可以尝试使用 docker 直接运行 yutto（具体如何运行需要参考下后面的内容～）

docker run --rm -it -v /path/to/download:/app siguremo/yutto <url> [options]

与直接运行 yutto 不同的是，这里的下载目标路径是通过 -v <path>:/app 指定的，也就是说 docker 里的 yutto 会将内容下载到 docker 里的 /app 目录下，与之相对应的挂载点 <path> 就是下载路径。你也可以直接挂载到 $(pwd)，此时就和本机 yutto 的默认行为一致啦，也是下载到当前目录下～

pip/pipx/uv 安装

[!TIP]

在此之前请确保安装 Python3.9 及以上版本，并配置好 FFmpeg（参照 bilili 文档）

pip install --pre yutto

当然，你也可以通过 pipx/uv 来安装 yutto（当然，前提是你要自己先安装它）

pipx install yutto      # 使用 pipx
uv tool install yutto   # 或者使用 uv

pipx/uv 会类似 Homebrew 无感地为 yutto 创建一个虚拟环境，与其余环境隔离开，避免污染 pip 的环境，因此相对于 pip，pipx/uv 是更推荐的安装方式（uv 会比 pipx 更快些～）。

体验 main 分支最新特性

[!TIP]

这同样要求你自行配置 Python 和 FFmpeg 环境

有些时候有一些在 main 分支还没有发布的新特性或者 bugfix，你可以尝试直接安装 main 分支的代码，最快的方式仍然是通过 pip 安装，只不过需要使用 git 描述符

pip install git+https://github.com/yutto-dev/yutto@main                 # 通过 pip
pipx install git+https://github.com/yutto-dev/yutto@main                # 通过 pipx
uv tool install git+https://github.com/yutto-dev/yutto.git@main         # 通过 uv

主要功能

已支持的下载类型

[!NOTE]

标记「批量」的视频都必须通过 -b/--batch 参数来下载，否则会按照单个视频来解析下载

基本命令

yutto 的基本命令如下：

yutto <url>

你可以通过 yutto -h 查看详细命令参数。

如果你需要下载单个视频，只需要使用 yutto 加上这个视频的地址即可。它支持 av/BV 号以及相应带 p=n 参数的投稿视频页面，也支持 ep 号（episode_id）的番剧页面。

比如只需要这样你就可以下载《転スラ日記》第一话：

yutto https://www.bilibili.com/bangumi/play/ep395211

yutto 还支持直接使用能够唯一定位资源的 id 来作为 <url>，刚刚的功能与下面的简化后的命令功能是完全一样的

yutto ep395211

不过有时你可能想要批量下载很多剧集，因此 yutto 提供了用于批量下载的参数 -b/--batch，它不仅支持前面所说的单个视频所在页面地址（会解析该单个视频所在的系列视频），还支持一些明确用于表示系列视频的地址，比如 md 页面（media_id）、ss 页面（season_id）。

比如像下面这样就可以下载《転スラ日記》所有已更新的剧集：

yutto --batch https://www.bilibili.com/bangumi/play/ep395211

基础参数

yutto 支持一些基础参数，无论是批量下载还是单视频下载都适用。