yutto-dev/yutto

🧊 yutto, a cute and willful Bilibili video downloader (CLI)

The full static document is here → yutto

[! TIP]

If you encounter any issues during use, please report the correctness of the function and request via Issues. For other issues, please report them through Discussions~

What is yutto?

yutto is a Bilibili video downloader that helps you download submitted videos, anime series, courses, and other resources from Bilibili. It supports downloading individual videos and batch downloads, like this:

Start with installation~

One-click installation of package manager

Currently, yutto can be installed directly through some package managers~

Homebrew users can try the following command:

Arch Linux users can install from AUR (thanks to @ouuan) or archlinuxcn:

Using Docker

You can also try running yutto directly using Docker (see the details below for how to run it~).

Unlike running yutto directly, here the download destination path is specified via -v :/app, meaning the yutto in Docker downloads the content to the /app directory in Docker, and the corresponding mount point is the download path. You can also mount directly to $(pwd), which matches the default behavior of local yutto, also downloading to the current directory~

pip/pipx/uv installation

[! TIP]

Before this, please ensure Python 3.11 or above is installed and configured FFmpeg properly (refer to the yutto documentation for “FFmpeg Download and Configuration”)

Of course, you can also install yutto via pipx/uv (provided you install it yourself first).

pipx/uv creates a virtual environment for yutto like Homebrew, isolating it from other environments to avoid polluting pip. Therefore, compared to pip, pipx/uv is a more recommended installation method (UV is faster than pipx~).

Experience the latest features of the main branch

[! TIP]

This also requires you to configure your own Python and FFmpeg environments

Sometimes, if there are new features or bugfixes that haven’t been released in the main branch yet, you can try installing the main branch code directly. The fastest way is still to install via pip, but you need to use the git descriptor

Main Features

Basic commands

The basic command for yutto is as follows:

You can view detailed command parameters via yutto -h.

If you need to download a single video, just use yutto and add the video’s URL. It supports AV/BV numbers and corresponding submission video pages with the p=n parameter, as well as anime pages with ep (episode_id).

For example, just by doing this, you can download the first episode of ‘転스ラ日記’: