How do I install BBDown CLI?

Install the .NET global tool with dotnet tool install --global BBDown or download a release binary and add it to PATH.

How do I login or provide cookies?

You can login with BBDown login, supply cookies with BBDown -c "SESSDATA=..." , or use TV/App tokens with BBDown -tv -token "..." .

What dependencies do I need for muxing and Dolby Vision?

Install ffmpeg or mp4box for muxing; for Dolby Vision use ffmpeg 5.0+ or a recent mp4box; aria2 can be enabled with -aria2 if you plan to use it.

bbdown-cli

Scanned

npx machina-cli add skill Xiangyu-CAS/Vision-Skills/bbdown-cli --openclaw

Files (1)

SKILL.md

1.8 KB

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 <url>
Download to data/ with 720p preference (use the label you saw above):
- BBDown --work-dir data -q "<720p label>" <url>
If you are unsure about labels, use interactive selection:
- BBDown --work-dir data -ia <url>

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=..." <url>
Use TV/APP access token:
- BBDown -tv -token "..." <url>

Common download workflow

Basic download:
- BBDown --work-dir data <url>
Prefer 720p and hide extra streams for cleaner output:
- BBDown --work-dir data -q "<720p label>" -hs <url>
For multi-part videos, select pages:
- BBDown --work-dir data -p 1,3,5 <url>

Troubleshooting

If muxing fails, verify ffmpeg/mp4box availability or pass explicit paths:
- BBDown --ffmpeg-path <path> --work-dir data <url>
If member-only content fails, retry with -c cookie (web) or -token (TV/APP).

Source

git clone https://github.com/Xiangyu-CAS/Vision-Skills/blob/main/skills/bbdown-cli/SKILL.mdView on GitHub

Overview

BBDown CLI lets you install and run BBDown on Linux/macOS to download Bilibili videos. It supports login via cookies or tokens, downloads by URL, and writes outputs under a local data/ directory with a preference for 720p when available. It also handles interactive label selection and multi-part videos to simplify complex downloads.

How This Skill Works

Install BBDown (via dotnet tool or release binary) and run commands from the repo root so data/ is created. Use --only-show-info to list streams and identify the exact 720p label, then download with --work-dir data -q "<720p label>" <url>; -ia provides interactive selection if you don’t know the label. For restricted content, authenticate with a cookie string (-c) or TV/app token (-tv -token).

When to Use It

Download a video by URL, preferring 720p when available, and save to data/.
List available streams to grab the exact 720p label with --only-show-info.
Interactively choose a stream if you’re unsure about the label (-ia).
Access member-only content by logging in with cookies or tokens (-c or -tv -token).
Download multi-part videos by specifying pages (e.g., -p 1,3,5).

Quick Start

Step 1: Ensure you’re in the repo root so data/ exists.
Step 2: List available streams and capture the 720p label: BBDown --only-show-info <url>.
Step 3: Download to data/ preferring 720p: BBDown --work-dir data -q "<720p label>" <url>.

Best Practices

Run from the repository root so the data/ directory is created and used consistently.
First list streams with --only-show-info to capture the exact 720p label before downloading.
Always specify --work-dir data and a -q "<720p label>" to enforce 720p and a clean output.
Install necessary muxing tools (ffmpeg or mp4box); ensure versions support Dolby Vision if needed.
Use -c or -tv -token for credentials and avoid exposing them in logs; prefer secure storage.

Example Use Cases

BBDown --work-dir data <url>
BBDown --work-dir data -q "720p labeled stream" <url>
BBDown --work-dir data -ia <url>
BBDown -c "SESSDATA=abcd" <url>
BBDown --work-dir data -p 1,3,5 <url>

Frequently Asked Questions

Add this skill to your agents