---

name: bilibili-downloader description: Download videos, audio, subtitles, and covers from Bilibili using bilibili-api. Use when working with Bilibili content for downloading videos in various qualities, extracting audio, getting subtitles and danmaku, downloading covers, and managing download preferences.

Bilibili Downloader

Quick Start

Download a video by URL:

pip install bilibili-api-python
python -c "
from bilibili_api import video, sync
v = video.Video(bvid='BV1xx411c7m2')
sync(v.download(output='./video.mp4'))
"

Download Options

Video Quality

• Specify quality with qn parameter (127=8K, 126=杜比, 125=1080P+, etc.)
• Default selects best available quality

Audio Download

• Download original soundtrack: v.download_audious(output='./audio.mp3')
• Supports various audio formats

Subtitles

• Get available subtitles: v.get_subtitle()
• Download subtitle files: sync(v.download_subtitle(output='./'))

Covers and Thumbnails

• Get cover URL: v.get_cover()
• Download cover: sync(v.download_cover(output='./cover.jpg'))

Common Tasks

Download Single Video

from bilibili_api import video, sync
v = video.Video(bvid='BV1xx411c7m2')
sync(v.download(output='./video.mp4'))

Download with Specific Quality

from bilibili_api import video, sync
v = video.Video(bvid='BV1xx411c7m2')
info = v.get_download_url(qn=127)  # 8K quality

Download Entire Playlist

from bilibili_api import video, sync
from bilibili_api import playlist

pl = playlist.Playlist(playlist_id='123456')
for v in sync(pl.get_videos()):
    sync(v.download(output=f'./playlist/{v["title"]}.mp4'))

Download Audio Only

from bilibili_api import video, sync
v = video.Video(bvid='BV1xx411c7m2')
sync(v.download_audio(output='./audio.mp3'))

Authentication

For premium content, use browser cookies:

1. Login to Bilibili in browser
2. Export SESSDATA cookie value
3. Set environment variable: export BILIBILI_SESSDATA='your_cookie_value'

Requirements

• bilibili-api-python: pip install bilibili-api-python
• ffmpeg: Required for video/audio processing
• Python 3.8+

Resources

scripts/

Utility scripts for common download operations.

references/

• API documentation from bilibili-api repo
• Quality codes reference (qn values)
• Cookie setup guide

assets/

Download templates and configuration examples.