🎯

bbdown-cli

🎯Skill

from xiangyu-cas/vision-skills

VibeIndex|
What it does

Downloads Bilibili videos via CLI, supporting 720p preference, authentication methods, and flexible output configuration.

πŸ“¦

Part of

xiangyu-cas/vision-skills(3 items)

bbdown-cli

Installation

git cloneClone repository
git clone https://github.com/Xiangyu-CAS/Vision-Skills.git
πŸ“– Extracted from docs: xiangyu-cas/vision-skills
1Installs
1
-
AddedFeb 4, 2026

Skill Details

SKILL.md

Install and use the BBDown CLI on Linux/macOS for Bilibili downloads, including login/cookies/access_token, downloading by URL, preferring 720p when available, and writing output under a local data/ directory.

Overview

# BBDown CLI

Quick start (data/ output, prefer 720p)

  • Prefer running from the repo root so data/ exists.
  • List available streams and the exact 720p label:

- BBDown --only-show-info

  • Download to data/ with 720p preference (use the label you saw above):

- BBDown --work-dir data -q "<720p label>"

  • If you are unsure about labels, use interactive selection:

- BBDown --work-dir data -ia

Install or update (Linux/macOS)

  • Install via .NET global tool:

- dotnet tool install --global BBDown

  • Update:

- dotnet tool update --global BBDown

  • Alternative: download a release binary and add it to PATH.

Dependencies

  • Install ffmpeg or mp4box for muxing.
  • For Dolby Vision muxing, use ffmpeg 5.0+ or a recent mp4box.
  • Optional: install aria2c if you plan to use -aria2.

Auth and cookies

  • Web QR login:

- BBDown login

  • TV QR login:

- BBDown logintv

  • Use a web cookie string when needed:

- BBDown -c "SESSDATA=..."

  • Use TV/APP access token:

- BBDown -tv -token "..."

Common download workflow

  • Basic download:

- BBDown --work-dir data

  • Prefer 720p and hide extra streams for cleaner output:

- BBDown --work-dir data -q "<720p label>" -hs

  • For multi-part videos, select pages:

- BBDown --work-dir data -p 1,3,5

Troubleshooting

  • If muxing fails, verify ffmpeg/mp4box availability or pass explicit paths:

- BBDown --ffmpeg-path --work-dir data

  • If member-only content fails, retry with -c cookie (web) or -token (TV/APP).