Bilibili Downloader

快速开始

通过 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'))
"

下载选项

视频清晰度

• 使用 qn 参数指定清晰度（127=8K，126=杜比，125=1080P+ 等）
• 默认自动选择当前可用的最高清晰度

音频下载

• 下载原始音轨：v.download_audious(output='./audio.mp3')
• 支持多种音频格式

字幕

• 获取可用字幕列表：v.get_subtitle()
• 下载字幕文件：sync(v.download_subtitle(output='./'))

封面与缩略图

• 获取封面 URL：v.get_cover()
• 下载封面：sync(v.download_cover(output='./cover.jpg'))

常见任务

下载单个视频

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

指定清晰度下载

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

下载整套播放列表

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'))

仅下载音频

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

身份认证

如需下载付费内容，请使用浏览器 Cookie：

1. 在浏览器中登录 Bilibili
2. 导出 SESSDATA Cookie 值
3. 设置环境变量：export BILIBILI_SESSDATA='your_cookie_value'

依赖要求

• bilibili-api-python：pip install bilibili-api-python
• ffmpeg：用于音视频处理
• Python 3.8+

资源目录

scripts/

包含常用下载操作的实用脚本。

references/

• bilibili-api 仓库提供的 API 文档
• 清晰度代码参考（qn 值说明）
• Cookie 配置指南

assets/

提供下载模板与配置示例文件。