yang0/bilibili-downloader/bilibili-downloader

bilibili-downloader

概述

B站 UP 主视频批量下载 + 智能字幕生成工具。

• 🔐 风控绕过: 使用浏览器 cookies，解决 412 拦截问题
• 🎧 音频优先: 只下载音频（比视频快 3-5 倍，节省空间）
• 🤖 智能字幕: Faster-Whisper 本地 GPU 加速，中文语音识别
• ⏭️ 断点续传: 自动跳过已完成的视频
• 📊 多种排序: 按播放量/发布时间/收藏数排序

使用场景

1. 批量下载 UP 主的高播放量视频
2. 为视频生成精确的中文字幕（SRT 格式）
3. 导出视频链接列表供后续处理
4. 配合其他工具进行内容分析

快速开始

1. 获取 UP 主视频列表

<bilidl:list> <UP主ID> [数量]

示例：获取智先生 TOP 15 视频

bilidl:list 601367419 15

输出文件：output/videos.txt 和 output/up_xxx_videos.json

2. 批量下载 + 生成字幕

<bilidl:batch> <UP主ID> [数量]

示例：批量处理 TOP 10 视频

bilidl:batch 601367419 10

3. 处理单个视频

<bilidl:single> <URL或BV号>

示例：

bilidl:single BV1Fo5L6nE6m
bilidl:single https://www.bilibili.com/video/BV1Fo5L6nE6m

配置

默认配置文件：config.py

重要配置项：

# Cookies 文件路径 (必须是 Netscape 格式)
COOKIES_PATH = "G:\\cookies\\bilibili.txt"
# Whisper 模型 (tiny/base/small/medium/large-v3)
WHISPER_MODEL = "medium"
# 输出目录
OUTPUT_DIR = ".\\output"

典型工作流

1. 获取列表 → bilidl:list 601367419 30
2. 编辑 output/videos.txt，删除不需要的视频
3. 批量处理 → bilidl:batch --file output/videos.txt

输出文件

每个视频生成 2 个文件：

output/
├── 39万亿外债.mp3    # 音频文件（可删除）
├── 39万亿外债.srt    # 中文字幕（标准SRT格式）
└── ...

字幕可直接用于：剪映、PR、Final Cut Pro、视频播放器、关键词搜索等。

性能参考

故障排除

问题：遇到 412 错误 / 无法获取列表

解决方案：

1. 检查 G:\cookies\bilibili.txt 是否存在且有效
2. 重新从浏览器导出 Netscape 格式 cookies
3. 确保 B站账号处于登录状态

问题：CUDA 显存不足

解决方案： 编辑 config.py 使用更小的模型：

WHISPER_MODEL = "small"  # 或 base/tiny

问题：下载速度慢

说明： 正常现象，B站服务器限流。可以分时段处理，工具支持断点续传。

依赖

• Python 3.10+
• FFmpeg
• CUDA 显卡（推荐，用于 Whisper 加速）
• B站 cookies（Netscape 格式）