explaingit

nilaoda/bbdown

13,873C#Audience · generalComplexity · 2/5Setup · moderate

TLDR

A free command-line tool for downloading videos, subtitles, and scrolling comments from Bilibili, supporting quality up to 8K, HDR, and Dolby Vision with multi-thread downloads and flexible format options.

Mindmap

mindmap
  root((repo))
    What it does
      Downloads Bilibili videos
      Saves subtitles
      Saves danmaku
    Quality options
      Up to 8K
      HDR and Dolby
      AVC HEVC AV1
    Features
      Multi thread download
      Interactive mode
      Login via QR code
    Tech Stack
      C#
      dotnet
      ffmpeg
    Setup
      dotnet tool install
      Prebuilt binaries
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Download a Bilibili drama series to watch offline, with subtitles automatically converted to SRT format.

USE CASE 2

Save a Bilibili course or lecture playlist to your computer for offline study.

USE CASE 3

Download a Bilibili video in 4K or HDR quality and merge audio and video into a single file using ffmpeg.

USE CASE 4

Archive an entire Bilibili creator channel to a local drive for backup or offline viewing.

Tech stack

C#.NETffmpegaria2c

Getting it running

Difficulty · moderate Time to first run · 30min

Merging separate audio and video streams requires ffmpeg or mp4box to be installed separately.

In plain English

BBDown is a free, command-line tool for downloading videos from Bilibili, the Chinese video platform. You run it by typing a command in your terminal and giving it a Bilibili video URL or ID, and it downloads the video to your computer. The README is written primarily in Chinese, reflecting its main audience. The tool supports a wide range of content types on Bilibili: regular videos, TV dramas, courses, playlists, collections, and personal channel archives. It can also download subtitles (converting them to the common SRT format), cover images, and danmaku, which are the scrolling audience comments Bilibili is known for. You can download just the video track, just the audio track, or the full merged file with everything combined. Quality options are extensive. BBDown supports standard resolutions up to 8K, as well as HDR and Dolby Vision formats. You can tell it which video encoding to prefer (AVC, HEVC, or AV1) and which quality level to prioritize, using a simple comma-separated list in the command. If you want to pick from available options interactively rather than specifying in advance, there is an interactive mode for that. For downloading, BBDown uses multiple threads by default to speed things up. It can also call an external tool called aria2c if you prefer that. Merging separate audio and video streams into a single file requires either ffmpeg or mp4box to be installed separately. You log in to your Bilibili account by scanning a QR code, which gives access to member-only content. A config file lets you store your preferred settings so you do not have to retype them every time. BBDown is available as a standard dotnet tool, so if you already have the .NET environment installed you can get it with a single install command. Pre-built binaries are also published on the GitHub releases page for those who do not want to build from source. The project states it is intended for personal learning, research, and non-commercial use only.

Copy-paste prompts

Prompt 1
Show me the BBDown command to download a Bilibili video URL in the best available quality, prefer HEVC encoding, merge audio and video with ffmpeg, and save the subtitle as SRT.
Prompt 2
I want to download an entire Bilibili playlist with BBDown. What command do I run and how do I set the preferred video quality to 1080p?
Prompt 3
How do I log in to my Bilibili account in BBDown using the QR code method so I can download member-only content?
Prompt 4
Write a shell script that reads a list of Bilibili video IDs from a text file and uses BBDown to batch-download each one to a specific output folder.
Open on GitHub → Explain another repo

← nilaoda on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.