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` 重要配置项： ```python # 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、视频播放器、关键词搜索等。 ## 性能参考 | 模型 | GPU显存 | 速度 | 质量 | |------|---------|------|------| | tiny | ~1GB | 16x | 一般 | | base | ~1GB | 8x | 尚可 | | small | ~2GB | 4x | 良好 | | medium | ~5GB | 2x | 优秀 ✓ | | large-v3 | ~10GB | 1x | 最佳 | ## 故障排除 ### 问题：遇到 412 错误 / 无法获取列表 **解决方案：** 1. 检查 `G:\cookies\bilibili.txt` 是否存在且有效 2. 重新从浏览器导出 Netscape 格式 cookies 3. 确保 B站账号处于登录状态 ### 问题：CUDA 显存不足 **解决方案：** 编辑 `config.py` 使用更小的模型： ```python WHISPER_MODEL = "small" # 或 base/tiny ``` ### 问题：下载速度慢 **说明：** 正常现象，B站服务器限流。可以分时段处理，工具支持断点续传。 ## 依赖 - Python 3.10+ - FFmpeg - CUDA 显卡（推荐，用于 Whisper 加速） - B站 cookies（Netscape 格式）